
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.
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.batchAdmin: BBGZDFLT.com.ibm.ws.batch.batchAdmin batchSubmitter: BBGZDFLT.com.ibm.ws.batch.batchSubmitter batchMonitor: BBGZDFLT.com.ibm.ws.batch.batchMonitorEl 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.
Tema de tarea