Para plataformas z/OS

Configuración del programa de utilidad de cliente batchManagerZos

Puede gestionar los trabajos por lotes que se ejecutan en Liberty en z/OS utilizando el programa de utilidad de cliente batchManagerZos.

Acerca de esta tarea

El programa de utilidad de cliente batchManagerZos es una versión compilada de forma nativa del programa de utilidad de línea de mandatos batchManager para gestionar los trabajos por lotes que se ejecutan en Liberty for z/OS. Se trata de un programa nativo y no requiere una JVM. El programa de utilidad se incluye con la característica batchManagement-1.0.

El programa de utilidad de cliente batchManagerZos da soporte a un subconjunto de los mandatos y opciones que están soportados por el programa de utilidad de línea de mandatos batchManager. Utilice el mandato $ batchManagerZos help para ver la lista de los mandatos y las opciones.

El programa de utilidad de cliente batchManagerZos utiliza adaptadores locales optimizados para conectarse a un servidor de Liberty que se está ejecutando en un entorno local. El programa de utilidad de cliente batchManagerZos no puede conectarse a servidores remotos.

Consideraciones sobre la seguridad
El comportamiento de la seguridad del programa de utilidad de cliente batchManagerZos depende de si el servidor de Liberty utiliza un registro SAF.
  • Si el servidor utiliza un registro de usuarios SAF, la identidad del programa de utilidad de cliente batchManagerZos se establece como la identidad del solicitante (el sujeto RunAs JEE) para la solicitud de proceso por lotes.
  • Si el servidor no utiliza un registro de usuarios de SAF, la identidad del programa de utilidad de cliente batchManagerZos se ignora. En este caso, el sujeto especial EVERYONE se establece como la identidad del solicitante para la solicitud por lotes.
Autorización basada en roles por lotes

Si se habilita appSecurity en el servidor, debe asignar la identidad del solicitante al rol de seguridad por lotes correspondiente que requiere la solicitud. Los roles de seguridad por lotes válidos son batchAdmin, batchSubmitter y batchMonitor. Si no se asigna la identidad al rol necesario, la solicitud falla con una excepción de seguridad.

La autorización la gestiona el proveedor de autorización de seguridad. Si el servidor utiliza autorización SAF, el proveedor de autorización SAF determina la autorización de la identidad del solicitante comprobando el acceso de la identidad a los perfiles de recursos SAF definidos en la clase EJBROLE. De forma predeterminada, los siguientes perfiles de recursos están asociados con los roles por lotes.
    batchAdmin:     BBGZDFLT.com.ibm.ws.batch.batchAdmin
    batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter
    batchMonitor:   BBGZDFLT.com.ibm.ws.batch.batchMonitor
Se debe otorgar a la identidad del solicitante acceso READ al perfil de recursos adecuado para que tenga autorización al rol por lotes correspondiente.

El siguiente ejemplo ilustra los mandatos RACF para otorgar a la identidad del cliente, bob, autorización para el rol batchAdmin.

    RDEFINE EJBROLE BBGZDFLT.com.ibm.ws.batch.batchAdmin UACC(NONE)
    PERMIT BBGZDFLT.com.ibm.ws.batch.batchAdmin CLASS(EJBROLE) ID(bob) ACCESS(READ)
Códigos de retorno
El programa de utilidad de cliente batchManagerZos genera los siguientes códigos de retorno:
Código Descripción
0 La tarea se ha completado con normalidad.
20 No se ha especificado un argumento obligatorio.
21 Se ha especificado un argumento no reconocido.
22 Se ha especificado un valor de argumento no válido.
255 Se ha producido un error desconocido.
Nota: Si especifica el argumento --wait, el programa de utilidad genera los siguientes códigos de retorno sobre el estado del trabajo que está esperando.
Código Descripción
33 El trabajo se ha detenido.
34 El trabajo no se ha completado correctamente.
35 El trabajo se ha completado satisfactoriamente.
36 El trabajo se ha abandonado.
Nota: Si ejecuta batchManagerZos a través de BPXBATCH, el código de retorno de BPXBATCH no coincidirá con el código de retorno de batchManagerZos. BPXBATCH toma el código de retorno batchManagerZos y lo desplaza hacia arriba un byte. Por ejemplo, si batchManagerZos devuelve un 1, BPXBATCH devuelve 256, que es el valor hexadecimal 0x01, desplazado hacia arriba un byte a 0x100.

Si invoca BPXBATCH desde un JCL STEP, el código de retorno de STEP se truncará en los siguientes tres caracteres hexadecimales inferiores del código de retorno de BPXBATCH. Por ejemplo, si batchManagerZos devuelve 35, que es el carácter hexadecimal 0x23, BPXBATCH devolverá 0x2300. El JCL STEP trunca el código de retorno a 0x0300 o 768.

Limitaciones

El programa de utilidad de cliente batchManagerZos no soporta actualmente la recopilación ni la modalidad continua de los registros de trabajo.

Los mandatos stop del programa de utilidad de cliente batchManagerZos se deben dirigir al ejecutor por lotes donde se está ejecutando el trabajo. Los mandatos stop en un entorno de varios servidores podrían fallar con una BatchJobNotLocalException si el programa de utilidad de cliente batchManagerZos se conecta a un asignador por lotes designado en lugar de al ejecutor por lotes donde se está ejecutando el trabajo. Los asignadores por lotes normalmente reciben solicitudes de envío y las distribuyen a ejecutores por lotes en sentido descendente.

Procedimiento

  1. Habilite las características batchManagement-1.0 y zosLocalAdapters-1.0 en el archivo server.xml.
    <featureManager>
    	<feature>batchManagement-1.0</feature>
    	<feature>zosLocalAdapters-1.0</feature>
    </featureManager>
  2. Configure un punto final zosLocalAdapters-1.0. En el ejemplo siguiente se muestra una configuración de punto final zosLocalAdapters-1.0.
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="BATCH" wolaName3="MANAGER"/>
  3. Permita que el programa de utilidad de cliente batchManagerZos se conecte al punto final zosLocalAdapters. Para que el cliente batchManagerZos pueda conectarse al servidor a través de adaptadores locales optimizados, el ID_usuario del cliente debe estar autorizado para el recurso SAF CBIND asociado con el punto final zosLocalAdapters. El recurso que está asociado con el punto final se denomina BBG.WOLA.{wolaGroup}.{wolaName2}.{wolaName3} en la clase CBIND. Para enlazar el punto final zosLocalAdapters denominado LIBERTY BATCH MANAGER, debe otorgar acceso de lectura al recurso BBG.WOLA.LIBERTY.BATCH.MANAGER en la clase CBIND para el ID de usuario de batchManagerZos. En el ejemplo siguiente se muestran los mandatos RACF que debe utilizar para otorgar acceso de lectura al recurso.
        RDEFINE CBIND BBG.WOLA.LIBERTY.BATCH.MANAGER UACC(NONE)   
        PERMIT BBG.WOLA.LIBERTY.BATCH.MANAGER CLASS(CBIND) ACCESS(READ) ID(bob)
    Nota: En este ejemplo, bob es el usuario que ejecuta batchManagerZos.
  4. Si desea que las solicitudes de batchManagerZos se ejecuten en el servidor con la identidad del cliente, debe autorizar al servidor para utilizar los recursos autorizados de SAFCRED z/OS. En el ejemplo siguiente se muestran los mandatos RACF que debe utilizar para habilitar el servidor para que utilice los recursos autorizados de SAFCRED z/OS.
        RDEFINE SERVER BBG.AUTHMOD.BBGZSAFM.SAFCRED UACC(NONE)   
        PERMIT BBG.AUTHMOD.BBGZSAFM.SAFCRED CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
  5. Inicie el espacio de direcciones Angel.
  6. Inicie el servidor de Liberty.
  7. Utilice el mandato ping para probar la conectividad entre el cliente batchManagerZos y el servidor de Liberty.
    $ batchManagerZos ping '--batchManager=LIBERTY BATCH MANAGER'

    Si el mandato ping es satisfactorio, el cliente sale con un código de retorno 0. Si el mandato ping no es satisfactorio, se emite un mensaje de error.

  8. Para resolver problemas, puede habilitar un rastreo adicional en el cliente estableciendo la variable de entorno $ export batchManagerZosTrace=1.
  9. Opcional: Configure el programa de utilidad de cliente batchManagerZos para que espere a que salga un suceso de trabajo por lotes, en lugar de esperar utilizando el sondeo,

    Debe configurar el servidor de proceso por lotes para habilitar la publicación de sucesos relacionados con el trabajo que utilizan el proveedor de mensajería WebSphere MQ. Consulte la documentación para Habilitación de publicación de sucesos de trabajo por lotes

    El ejemplo siguiente muestra cómo enviar un trabajo y esperar a su finalización mediante un suceso de finalización de trabajo:
    $ batchManagerZos submit
    --batchManager=LIBERTY+BATCH+MANAGER
    --applicationName=[nombre de aplicación utilizado al empaquetar la aplicación por lotes]
    --jobXMLName=[nombre base del archivo XML del trabajo en el directorio batch-jobs de la aplicación]
    --wait--queueManagerName=[nombre del gestor de colas MQ] 
    El cliente batchManagerZos espera recibir 1 de 3 sucesos que representa un estado finalizado de instancia de trabajo:
    batch/jobs/instance/stopped
    batch/jobs/instance/failed
    batch/jobs/instance/completed

Icono que indica el tipo de tema Tema de tarea



Icono de indicación de fecha y hora Última actualización: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_batchManagerZos
Nombre de archivo:twlp_batchManagerZos.html