付録B. 推奨事項

• サブディレクトリ jar に jar ファイルのバックアップ・コピーを作成しないでください。JSMが開始すると、jarディレクトリ内のファイルはすべてJavaクラスパスに含まれます。Javaクラスパス内の目的のjarファイルよりも先に、バックアップ・ファイルが表示されることがあります。このため、目的のjarファイル内のクラスではなく、バックアップ・ファイル内のクラスが使用されてしまいます。
• サービス・プロパティ・ファイルの LANSA スタジオのセクション内のエントリーを修正しないでください。ただし、これらのファイルの下部に独自のセクションを追加することは構いません。プロパティ・ファイルのすべてのエントリーは、studio-projectセクション内にあります。アップグレード・プロセスでは、セクションの外部にあるエントリーは、studio-project id="00000000-000000" name="unassigned"セクションに配置されます。これらは別のセクションに割り当てられるか、削除されます。
• Java サービスに関連しない LANSA ファンクション・フィールドの接頭辞は JSM にしてください。これにより、ファンクションとJavaサービス間で転送されるデータ量が少なくなります。この推奨事項を示すために、一部のLANSA Integratorの例では、フィールド#JSMSTS、#JSMMSG、#JSMCMDが使用されています。
• MQSeries プログラム利用時は、メッセージと相関 ID を受信するフィールドの接頭辞を JSM にしてください。これらのフィールドは、英数字範囲外で24バイトのデータを受信できます。つまり、ネイティブからUnicodeへの変換が失敗するため、データをJavaサービスに送信できません。

これはスタイルの問題ですが、コマンド・キーワード値が静的である場合、文字列連結を使用してコマンドを生成するサブルーチンを使用しないでください。コマンド文字列にキーワードを直接入れてください。