ハンドラーにより検出されるエラー

ハンドラーは、エラーを検出した場合、エラー状態を RPG プログラムに通知する必要があります。

ハンドラーは例外メッセージをその呼び出し元に送信するか、またはハンドラー・パラメーターの rpgStatus サブフィールドに有効な RPG I/O 状況コードを設定します。

状況コード 1299 は一般入出力エラーを示します。この状況コードはすべての命令に使用できます。

ハンドラーが例外メッセージを送信するか、または未処理例外で失敗する場合、通常 RPG は状況コードを 1299 に設定します。 OPEN 命令と CLOSE 命令の場合、RPG は状況コードを 1216 (明示的な OPEN または CLOSE 命令でのエラー) または 1217 (暗黙の OPEN または CLOSE 命令でのエラー) に設定します。

ヒント: RPG プログラムにエラー状態を伝達する手法として、例外メッセージを送信する方法が推奨されます。このメッセージはジョブ・ログに記録されるため、プログラムの完了後にこのメッセージの情報を使用できます。ハンドラーは、予期しないエラーの理由を判別する上で必要となる十分な詳細情報をメッセージに組み込むことができます。