Programa de utilidad de cliente de línea de mandatos batchManager
El programa de utilidad de cliente de línea de mandatos batchManager proporciona una interfaz de línea de mandatos para gestionar los trabajos por lotes que se ejecutan en Liberty.
El programa de utilidad de cliente de línea de mandatos batchManager interactúa con el gestor de proceso por lotes a través de la API REST del gestor de proceso por lotes.Para utilizar el programa de utilidad de cliente de línea de mandatos batchManager, el gestor de proceso por lotes debe ejecutarse en el servidor de Liberty. Utilice la característica de gestión de proceso por lotes para instalar y habilitar el gestor de proceso por lotes de Liberty.
Configuración SSL
El programa de utilidad de cliente de línea de mandatos batchManager se comunica con el gestor de proceso por lotes a través de una conexión SSL. Para facilitar la comunicación SSL con un gestor de proceso por lotes que se ejecuta en un servidor de Liberty, el programa de utilidad debe poder verificar el certificado SSL del servidor de Liberty.
Si el certificado SSL está firmado por una entidad emisora de certificados (CA) conocida, el programa de utilidad puede verificar el certificado mediante la CA. No es necesaria ninguna configuración adicional.
- Especifique la opción --trustSslCertificates, que configura el programa de utilidad para confiar en todos los certificados SSL.
- Incluya el certificado SSL del servidor en el almacén de confianza del programa de utilidad.
Si elige especificar la opción --trustSslCertificates, el programa de utilidad confía en todos los certificados SSL que recibe y no es necesaria configuración adicional.
Si elige la opción de incluir el certificado SSL del servidor en el almacén de confianza del programa de utilidad, también debe configurar el programa de utilidad para que pueda encontrar su almacén de confianza. El programa de utilidad es un principal Java autónomo. Para configurar SSL, utilice propiedades del sistema como, por ejemplo, javax.net.ssl.truststore.
$ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/server/keystore.jks"
$ batchManager submit ...
$ keytool -export -alias default -file server.crt -keystore [server-dir]/resources/security/key.jks -storepass Liberty
$ keytool -import -alias server_crt -file server.crt -keystore /path/to/truststore.jks -storepass passw0rd
$ export JVM_ARGS="-Djavax.net.ssl.trustStore=/path/to/truststore.jks"
$ batchManager submit ...
Uso de los mandatos
El programa de utilidad de cliente de línea de mandatos batchManager proporciona mandatos para enviar, detener, reiniciar y comprobar el estado de los trabajos.
Para el uso general del programa de utilidad:
$ batchManager [command] [options]
Para ver una lista de los mandatos disponibles:
$ batchManager help
Para ver la descripción y las opciones de un mandato específico:
$ batchManager help [command]
El siguiente ejemplo muestra cómo enviar un trabajo y esperar a su finalización:
$ batchManager submit \
--batchManager=<host>:<port>
--user=[credenciales para iniciar una sesión en el gestor de proceso por lotes]
--password=[credenciales para iniciar una sesión en el gestor de proceso por lotes]
--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
jobParametersFile y jobPropertiesFile
jobParametersFile=filePath1,filePath2,filePath3
jobPropertiesFile=filePath1,filePath2,filePath3
Por ejemplo, --jobParametersFile=<filepath1> alterará temporalmente
--jobParametersFile=<filepath1>,<filepath2> en el archivos de propiedades de control.
El parámetro resultante es --jobParametersFile=<filepath1>. 
Programa de utilidad de cliente de línea de mandatos batchManager en z/OS con un conjunto de claves SAF
Para utilizar el conjunto de claves de SAF (System Authorization Facility) del servidor WebSphere Application Server Liberty con el programa de utilidad de cliente de línea de mandatos batchManager, debe establecer los valores java.environment, y un ID de usuario especificado en la llamada del programa de utilidad de cliente de línea de mandatos batchManager que tenga autorización para leer el conjunto de claves SAF.
Los siguientes mandatos autorizan al usuario para leer el conjunto de claves SAF.
PermitRingOwnerId.RingName.LST CLASS(RDATALIB)ID(userId)ACCESS(UPDATE)
SETROPTS RACLIST(RDATALIB) GENERIC(RDATALIB) REFRESH
Para obtener más información, consulte z/OS Security Server RACF Command Language Reference de WebSphere Application Server.
El siguiente ejemplo define la variable de entorno JVM_ARGS.
export JVM_ARGS="-Djavax.net.ssl.trustStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.trustStoreType=JCERACFKS -Djavax.net.ssl.keyStore=safkeyring://ringOwnerId/ringName
-Djavax.net.ssl.keyStoreType=JCERACFKS -Dcom.ibm.ssl.keyStoreFileBased=false -Dcom.ibm.ssl.trustStoreFileBased=false
-Djava.protocol.handler.pkgs=com.ibm.crypto.provider -Djavax.net.ssl.keyStorePassword=password"
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. |
| 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. |

Tema de concepto