メッセージをJP1/IM - Managerへ送付するのにメッセージ制御機能を利用するには，バッチジョブ実行システムのジョブステップとして実行されている必要がある。ジョブステップとして実行されていない場合，COBOL2002で作成したアプリケーションのメッセージの入出力では，従来どおりstdin/stdoutを使用する。

• COBOL2002で作成したアプリケーションプログラムの場合
  日本語メッセージを表示したい場合は，シフトJISで作成する必要がある。ACCEPT文およびCBLTYPEサービスルーチンで受け取ることができる文字コードは，ASCII文字コード（制御文字を除く）の範囲だけである。
  DISPLAY文およびCBLTYPEサービスルーチンを使用してメッセージを出力する場合には，JP1/IM - View側に出力されるメッセージにIDは付与されないため，JP1/IM - Managerの運用時にメッセージが識別できるように十分に検討して，プログラミングする必要がある。
  

メッセージを出力する条件を次に示す。

表3-29　JP1/IM - Managerへ送付するメッセージの出力条件

プログラム，コマンドまたはカタログドプロシジャ	出力数	種別
DISPLAY UPON CONSOLE文	2件/秒より少ない。	通常メッセージ
ACCEPT FROM CONSOLE文	1件/分より少ない。	応答要求メッセージ
STOP文（定数指定）
CBLTYPEサービスルーチン

メッセージ制御機能でエラーが発生した場合，COBOL2002ではKCCC2060R-Sメッセージが出力される。KCCC2060R-Sメッセージに表示される戻り値と意味を次の表に示す。戻り値とともに表示されるエラー番号の意味については，「付録D　メッセージ制御機能のエラー情報」を参照のこと。

表3-30　KCCC2060R-Sメッセージに出力される戻り値と意味

戻り値	意味	考えられる主な原因	対処
1	環境が不正である。	JP1/AJS，またはバッチジョブ実行システムを利用して呼び出していない可能性がある。	該当するプログラムをJP1/AJSからバッチジョブ実行システムを通して呼び出すように変更して再実行する。
2	共有メモリまたは実行ログの操作でエラーが発生した。	BjexSvcサービスが起動していない。 bjexchmsgコマンドで応答状態を強制的に解除した。	BjexSvcサービスが起動していることを確認する。
3	システムコールでエラーが発生した。	スプールディレクトリにアクセス権がないため，ジョブログに出力できない。	スプールディレクトリに，実行ユーザの書き込み権限を与える。
4	JP1イベント送信時に通信エラーが発生した。	JP1/IM - Managerが稼働するホストに接続できない。	ネットワークの問題を解決する。
5	JP1イベント送信時に通信以外のエラーが発生した。	JP1/Baseのライブラリが見つからない。	JP1/Baseをインストールする。

• メッセージを作成する場合，メッセージテキストによって運用側で判断ができるように設計すること。
• JP1IM_MANAGER_HOSTパラメータで指定したJP1/IM - Managerに接続したJP1/IM - View以外から応答はできない（バッチジョブ実行システムが提供するbjexlsmsgおよびbjexchmsgコマンドでの応答はできる）。
• JP1/IM - Managerが滞留できる応答待ちイベント数には上限があるため，これを超えない運用を設計すること。
• 応答入力ができる文字コードは，ASCII文字コード（制御文字を除く）の範囲だけである。この範囲以外の文字コードを入力した場合は，エラーメッセージが表示されるので，範囲内の文字コードで再入力すること。
• JP1イベントの送信処理で，一時的な通信エラーまたはリソース不足などの時間を空ければ回復の見込みのあるエラーが発生した場合は，3秒間隔でリトライを繰り返す。そのため，回復の見込みのあるエラーが発生し続ける場合は，エラーを回復しないかぎり，メッセージ制御機能が終了しなくなる。
  また，リトライする場合は，JP1IM_MANAGER_HOSTパラメータで指定したホストに対して，JP1/BaseがTCP/IPのコネクションの切断と新たなポートでの接続を繰り返す。コネクションが使用していたポートは，OSのMSL（Maximum Segment Lifetime）×2（秒）の間使用できなくなるため，MSLの値が大きいまたはポート数が少ない場合には，リトライによってポートが枯渇する可能性がある。そのため，MSL×2（秒）の間にメッセージ制御機能によって出力するメッセージ数，MSL，およびポート数は，次に示す条件を満たすようにすること。
  

  n×MSL×2/3＜ポート数

  n：MSL×2（秒）の間にメッセージ制御機能によって出力するメッセージ数

• メッセージ制御機能を使用してメッセージを出力するCOBOLアプリケーションは，SJISまたはASCII文字を前提としており，それ以外では日本語メッセージが文字化けすることがある。
• 作成するメッセージ中に'\0'など画面に表示できない文字が含まれていると，COBOLアプリケーションの実行時にエラーとなる場合があるため，表示不可能文字をメッセージに含めないこと。