バッチ・ジョブの戻りコードは、getBatchJobRC EJB インターフェース、getBatchJobRC Web サービス、または、lrcmd getBatchJobRC cmd オプションを使用して取得されます。
以下の表は、Compute Grid によって使用されるシステム・バッチ・ジョブ戻りコードをリストしています。バッチ・ジョブの戻りコードは、 JobStatusConstants (com.ibm.websphere.longrun.JobStatusConstants API を参照) または JobSchedulerConstants (com.ibm.websphere.longrun.JobSchedulerConstants API を参照) と混同しないでください。JobStatusConstants は、サブミット、終了、再始動可能、取り消し済み、または、実行失敗などのジョブの状況を表します。
戻りコード | 説明 |
---|---|
0 | ジョブが正常に終了 |
-1 | 内部プロトコル・エラー - WSGrid ユーティリティー |
-2 | 入力パラメーター・エラー - WSGrid ユーティリティー |
-4 | ジョブが中断 |
-8 | ジョブは取り消された |
-10 | ジョブは強制的に取り消された (z/OS のみ) |
-12 | ジョブが失敗し、再始動可能な状態にある |
-14 | ジョブが失敗し、実行失敗の状態** |
-16 | 深刻な失敗 - WSGrid ユーティリティー |
バッチ・アプリケーションでのエラー報告には、2 つのオプションが使用されます。最初のオプションは、エラーが検出された場合にアプリケーションが例外をスローするものです。この場合、バッチ・ジョブの戻りコードが -12 でジョブは終了となり、バッチ・ジョブの状況は、再始動可能 になります。2 番目のオプションは、アプリケーションが processJobStep メソッドから BatchConstants.STEP_COMPLETE_EXECUTION_FAILED 戻りコード (com.ibm.websphere.batch.BatchConstants API を参照) を返し、destroyJobStep メソッドからアプリケーション固有の戻りコードを返すものです。この場合、ジョブは終了となり、バッチ・ジョブの状況は、実行失敗 になります。destroyJobStep メソッドで設定されたステップ戻りコードは、ジョブ・ステップに指定されたあらゆる結果アルゴリズムに渡され、ジョブの戻りコードに作用するために使用されて、失敗の特定の原因を示します。