批处理返回码

通过使用 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 ))
这些条件包含:
  1. 作业不存在
  2. 作业处于无效状态
  3. 发生数据库异常。
表 1. 批处理作业返回码. 此表包含各个返回码以及说明。
返回码 说明
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 方法中的步骤返回码集会传递到作业步骤上指定的任何结果算法,且用于影响作业的返回码以指示失败的具体原因。

指示主题类型的图标 概念主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cgrid_cgreturncodes
文件名:cgrid_cgreturncodes.html