
配置 batchManagerZos 客户机实用程序
可通过使用 batchManagerZos 客户机实用程序管理在 z/OS 上的 Liberty 中运行的批处理作业。
关于此任务
batchManagerZos 客户机实用程序是 batchManager 命令行实用程序的本地编译版本,batchManager 命令行实用程序用于管理在 Liberty for z/OS 上运行的批处理作业。它是一个本地程序,不需要 JVM。该实用程序是 batchManagement-1.0 功能部件随附的。
batchManagerZos 客户机实用程序支持 batchManager 命令行实用程序支持的命令和选项的一部分。请使用 $batchManagerZos help 命令查看命令和选项列表。
batchManagerZos 客户机实用程序使用优化本地适配器连接至本地环境中运行的 Liberty 服务器。batchManagerZos 客户机实用程序无法连接至远程服务器。
- 安全注意事项
- batchManagerZos 客户机实用程序的安全行为取决于 Liberty 服务器是否使用 SAF 注册表。
- 如果此服务器正在使用 SAF 用户注册表,那么 batchManagerZos 客户机实用程序身份设置为批处理请求的请求者身份(JEE RunAs 主体集)。
- 如果此服务器未在使用 SAF 用户注册表,那么 batchManagerZos 客户机实用程序身份被忽略。在此情况下,EVERYONE 特殊主体集设置为批处理请求的请求者身份。
- 基于批处理角色的授权
-
如果在服务器中启用了 appSecurity,那么必须对该请求者身份分配该请求所需的相应批处理安全角色。有效批处理安全角色为 batchAdmin、batchSubmitter 和 batchMonitor。如果未对该身份分配所需角色,那么该请求失败并产生安全性异常。
权限由安全性授权提供者管理。如果服务器正在使用 SAF 授权,那么 SAF 授权提供者将通过检查请求者身份对 EJBROLE 类中定义的 SAF 资源概要文件的访问权来确定请求者身份的权限。缺省情况下,以下资源概要文件与批处理角色相关联。
请求者身份必须被授予对相应资源概要文件的 READ 访问权,才能被授予相应批处理角色。batchAdmin: BBGZDFLT.com.ibm.ws.batch.batchAdmin batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter batchMonitor: BBGZDFLT.com.ibm.ws.batch.batchMonitor以下示例说明用于向客户机身份 bob 授予 batchAdmin 角色权限的 RACF 命令。
RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE) PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
- 返回码
- batchManagerZos 客户机实用程序输出以下返回码:
代码 描述 0 任务正常完成。 20 未指定必需的自变量。 21 指定了无法识别的自变量。 22 指定了无效自变量值。 255 发生未知错误。 注: 如果您指定 --wait 自变量,那么该实用程序输出以下返回码以指示您正在等待的作业的状态。代码 描述 33 该作业已停止。 34 该作业未成功完成。 35 该作业已成功完成。 36 该作业已被放弃。 注: 如果通过运行 BPXBATCH 来运行 batchManagerZos,那么 BPXBATCH 的返回码与 batchManagerZos 的返回码不匹配。BPXBATCH 采用 batchManagerZos 返回码并使其上移一个字节。例如,如果 batchManagerZos 返回 1,那么 BPXBATCH 返回 256,即十六进制值 0x01(使 0x100 上移一个字节)。如果通过 JCL STEP 调用 BPXBATCH,那么 STEP 返回码被截断为 BPXBATCH 返回码的后三位十六进制字符。例如,如果 batchManagerZos 返回 35(即十六进制格式的 0x23),那么 BPXBATCH 将返回 0x2300。JCL STEP 将返回码截断为 0x0300 或 768。
- Limitations
-
batchManagerZos 客户机实用程序当前不支持对作业日志进行检索或流式传输。
batchManagerZos 客户机实用程序 stop 命令必须定向到正在运行该作业的批处理执行程序。如果 batchManagerZos 客户机实用程序连接至所指定批处理分派器而不是正在运行该作业的批处理执行程序,那么多服务器环境中的 stop 命令可能失败并产生 BatchJobNotLocalException。批处理分派器通常接收提交请求并将它们分发至下游批处理执行程序。
任务主题