适用于 z/OS 平台

配置 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 资源概要文件的访问权来确定请求者身份的权限。缺省情况下,以下资源概要文件与批处理角色相关联。
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
请求者身份必须被授予对相应资源概要文件的 READ 访问权,才能被授予相应批处理角色。

以下示例说明用于向客户机身份 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。批处理分派器通常接收提交请求并将它们分发至下游批处理执行程序。

过程

  1. 在 server.xml 文件中启用 batchManagement-1.0 和 zosLocalAdapters-1.0 功能部件。
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. 配置 zosLocalAdapters-1.0 端点。 以下示例说明 zosLocalAdapters-1.0 端点配置。
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. 允许 batchManagerZos 客户机实用程序连接至 zosLocalAdapters 端点。 为使 batchManagerZos 客户机通过优化本地适配器连接至服务器,客户机的 userId 必须有权使用与 zosLocalAdapters 端点相关联的 CBIND SAF 资源。在 CBIND 类中,与该端点相关联的资源名为 BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3}。要绑定名为 LIBERTY BATCH MANAGER 的 zosLocalAdapters 端点,您必须对 batchManagerZos userID 授予对类 CBIND 中的资源 BBG.WOLA.LIBERTY.BATCH.MANAGER 的读访问权。以下示例说明授予对该资源的读访问权时必须使用的 RACF 命令。
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    注: 在此示例中,bob 是运行 batchManagerZos 的用户。
  4. 如果您希望 batchManagerZos 请求在服务器上以客户机身份运行,那么必须授权服务器使用 SAFCRED z/OS 授权资源。 以下示例说明允许服务器使用 SAFCRED z/OS 授权资源时必须使用的 RACF 命令。
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. 启动 Angel 地址空间。
  6. 启动 Liberty 服务器。
  7. 使用 ping 命令测试 batchManagerZos 客户机与 Liberty 服务器之间的连接。
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    如果 ping 操作成功,那么客户机退出并产生返回码 0。如果 ping 操作失败,那么系统发出错误消息。

  8. 要进行故障诊断,您可以通过设置 $ export batchManagerZosTrace=1 环境变量以在客户机中启用额外跟踪。
  9. 可选:将 batchManagerZos 客户机实用程序配置为等待批处理作业事件退出而不是通过使用轮询进行等待。

    必须配置批处理服务器以允许发布使用 WebSphere MQ 消息传递提供者的与作业相关的事件。请参阅启用批处理作业事件发布文档。

    以下示例说明如何提交作业并等待作业结束事件完成该作业:
    $ batchManagerZos submit  
    --batchManager=LIBERTY+BATCH+MANAGER  
    --applicationName=[application name used when packaging the batch app]
    --jobXMLName=[job XML file basename in the app's batch-jobs dir]
    --wait--queueManagerName=[name of MQ queue manager]
    batchManagerZos 客户机将等待接收一个(共 3 个)表示作业实例已结束状态的事件:
    batch/jobs/instance/stopped 
    batch/jobs/instance/failed 
    batch/jobs/instance/completed

用于指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
文件名:twlp_batchManagerZos.html