批处理返回码
通过使用 getBatchJobRC EJB 接口、get BatchJobRC Web 服务接口或 lrcmd getBatchJobRC 命令选项检索批处理作业返回码。
下表列出批处理环境使用的系统批处理作业返回码。不要将批处理返回码与作业状态常量(请参阅 com.ibm.websphere.longrun.JobStatusConstants API)或作业调度程序常量(请参阅 com.ibm.websphere.longrun.JobSchedulerConstants API)混淆。JobStatusConstants 表示作业的状态,例如已提交、已结束、可重新启动、已取消或执行失败。
可以通过使用 getJobStatus EJB 接口、getJobStatus Web 服务接口或通过作业管理控制台获取作业状态。JobSchedulerConstants 表示作业调度程序针对涉及多个作业的请求返回的操作条件。 例如:
int[] cancelJob( String[] jobid ))
这些条件包含:
- 作业不存在
- 作业处于无效状态
- 发生数据库异常。
| 返回码 | 说明 |
|---|---|
| 0 | 作业已正常结束 |
| -1 | 内部协议错误 - WSGrid 实用程序 |
| -2 | 输入参数错误 - WSGrid 实用程序 |
| -4 | 作业已暂挂 |
| -8 | 作业已取消 |
| -10 | 作业已强制取消(仅 z/OS®) |
| -12 | 作业已失败,且处于可重新启动状态 |
| -14 | 作业已失败,且处于执行失败状态** |
| -16 | 灾难性失败 - WSGrid 实用程序 |
避免故障: 尽管应用程序可以为作业返回码设置值,但仅当该作业正常完成时才会返回该值。如果该作业失败并且状态为执行失败或可重新启动,那么返回的值是上表中所述的其中一个运行时设置的负返回码。gotcha在批处理应用程序中,有以下两个选项用来报告错误:
- 应用程序的第一个选项为遇到错误时生成异常。这会导致作业终止,且批处理作业返回码为 -12,批处理作业状态为可重新启动。可采用批处理 API 的任何方法抛出该异常。
- 应用程序的第二个选项为从 processJobStep 方法返回 BatchConstants.STEP_COMPLETE_EXECUTION_FAILED 返回码(请参阅 com.ibm.websphere.batch.BatchConstants API),从 destroyJobStep 方法返回特定于应用程序的错误返回码。这会导致作业终止,且批处理作业状态为执行失败。destroyJobStep 方法中的步骤返回码集会传递到作业步骤上指定的任何结果算法,且用于影响作业的返回码以指示失败的具体原因。
概念主题