批处理返回码
通过使用 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 实用程序 |

在批处理应用程序中,有以下两个选项用来报告错误:
- 应用程序的第一个选项为遇到错误时生成异常。这会导致作业终止,且批处理作业返回码为 -12,批处理作业状态为可重新启动。可采用批处理 API 的任何方法抛出该异常。
- 应用程序的第二个选项为从 processJobStep 方法返回 BatchConstants.STEP_COMPLETE_EXECUTION_FAILED 返回码(请参阅 com.ibm.websphere.batch.BatchConstants API),从 destroyJobStep 方法返回特定于应用程序的错误返回码。这会导致作业终止,且批处理作业状态为执行失败。destroyJobStep 方法中的步骤返回码集会传递到作业步骤上指定的任何结果算法,且用于影响作业的返回码以指示失败的具体原因。