Interfaz de línea de mandatos para trabajos por lotes
La interfaz de línea de mandatos interactúa con el planificador de trabajos para someter y manipular un trabajo por lotes. Se encuentra en el directorio raíz_servidor_aplic/bin como el script lrcmd.sh o lrcmd.bat y se puede iniciar desde cualquier ubicación de la célula de WebSphere.
Utilice el script lrcmd para ejecutar los mandatos siguientes:
Mandato | Argumentos | Descripción | Información adicional |
---|---|---|---|
Mostrar información de uso de lrcmd. | ninguno | El mandato muestra la información de uso del mandato lrcmd. | Ejemplo: lrcmd |
Someter un trabajo al planificador de trabajos. |
|
Cuando se especifica un archivo de lenguaje de control de trabajos XML (xJCL), -xJCL=<nombre_archivo_xjcl>especifica la vía de acceso del xJCL que se va a someter desde el sistema de archivos y se va a guardar opcionalmente. Argumentos
opcionales:
Ambas variaciones del mandato devuelven un ID de trabajo para el trabajo sometido. |
Ejemplos:
|
Cancelar un trabajo sometido anteriormente. |
|
Este mandato cancela el inicio de un trabajo sometido anteriormente o cancela la ejecución de un trabajo en ejecución. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. Argumentos
opcionales:
|
Ejemplo: lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
Reiniciar un trabajo. |
|
Este mandato reinicia un trabajo cancelado. Sólo pueden reiniciarse los trabajos en el estado reiniciable. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. Argumentos
opcionales:
|
Sólo puede reiniciarse un trabajo por lotes
asociado a aplicaciones por lotes. Cuando un trabajo por lotes se cancela mediante el mandato -cmd=cancel, su estado cambia a reiniciable. Cuando se reinicia el trabajo, el proceso se reanuda a partir del último punto de control confirmado correctamente. Ejemplo: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
Depurar la información de trabajo. |
|
Este mandato depura la información de trabajo del planificador de trabajos y de los puntos finales de trabajos de larga duración. El planificador de trabajos mantiene información sobre un trabajo después de que se haya completado. El mandato purge suprime la información del trabajo de las bases de datos tanto del planificador de trabajos como de los puntos finales de los trabajos de larga duración. El mandato también depura el registro de trabajo del trabajo. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. Argumentos
opcionales:
|
El planificador de trabajos mantiene
información sobre un trabajo después de que éste se haya completado. El mandato purge suprime la información del trabajo de las bases de datos tanto del planificador de trabajos como de los punto final de trabajos de larga duración.
El mandato también depura el registro de trabajo del trabajo. Ejemplo: lrcmd -cmd=purge -jobid=myjob:2 |
Guarde un xJCL en el repositorio de trabajos. |
|
Este mandato guarda un documento xJCL en el repositorio
de trabajos para utilizarlo en mandatos -cmd=submit futuros.
Argumentos
opcionales:
|
Ejemplos:
|
Elimine el trabajo del repositorio de trabajos. |
|
Este mandato elimina un documento xJCL previamente
guardado del repositorio de trabajos. Utilice -job=<nombre_trabajo> para especificar el nombre asignado al trabajo cuando ha guardado anteriormente el archivo en el repositorio de trabajos.
|
Ejemplo: lrcmd -cmd=remove -jobid=myjob:2 -host=myhost -port=9083 |
Mostrar el estado de un trabajo por lotes. |
o bien
|
Este mandato muestra la información de estado sobre uno o más trabajos de la base de datos del planificador de trabajos. Argumento opcional: -job=<ID_trabajo>, si se especifica, indica que sólo se muestra la información del trabajo especificado. |
Ejemplos:
|
Suspender un trabajo. |
|
Este mandato suspende el inicio de un trabajo por lotes de trabajos de larga duración durante el número de segundos especificado. A
menos que se reanude manualmente (por ejemplo, con lrcmd -cmd=resume), la ejecución del trabajo se reanuda automáticamente después del
número de segundos
especificado. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. Argumentos opcionales: Utilice -seconds=<segundos> para indicar el número de segundos que se ha suspendido el inicio del trabajo. Si no se especifica, se utiliza el valor predeterminado es de 15 segundos. Si se especifica -seconds=0, el trabajo no se inicia hasta que se reanude manualmente.
|
Ejemplos: lrcmd -cmd=submit -xJCL=myxjcl.xml (devuelve el ID de trabajo myjob:23). Después de que el trabajo myjob:23 haya empezado a ejecutarse, puede suspenderse durante cinco minutos (por ejemplo), con: lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 -port=81 -host=myODRHost La ejecución del trabajo se puede reanudar antes de que transcurran los 5 minutos con: lrcmd -cmd=resume -jobid=myjob:23 |
Continuar el inicio de un trabajo suspendido anteriormente. |
|
Este mandato reanuda el inicio de un trabajo por lotes suspendido anteriormente. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. |
Consulte la descripción de -cmd=suspend. |
Visualizar la salida de un trabajo. |
|
Muestra la salida generada por el planificador de trabajos y punto final de trabajos de larga duración durante la ejecución del trabajo especificado. Utilice -jobid =<ID_trabajo> como ID que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. |
(ninguno) |
Visualizar el código de retorno de un trabajo por lotes. |
|
Muestra todo el código de retorno producido por un trabajo por lotes de trabajos de larga duración. Utilice -jobid =<ID_trabajo> como ID que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de
trabajo de un determinado trabajo.
|
(ninguno) |
Someter una solicitud de trabajo recurrente al planificador de trabajos. |
o bien
|
Somete un trabajo recurrente al planificador de trabajos.
El planificador de trabajos somete un trabajo por lotes con el
xJCL especificado a intervalos de tiempo indicados por los argumentos.
Argumentos opcionales:
|
Ejemplos:
|
Modifique una solicitud de trabajo recurrente. |
|
Argumentos:
Argumentos opcionales:
|
Ejemplos:
lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -xJCL=C:\\myNewXJCL -port=80 lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\myFebXJCL -port=80 |
Mandato | Argumentos | Descripción | Información adicional |
---|---|---|---|
Mostrar información de uso de lrcmd. | ninguno | Este mandato muestra la información de uso del mandato lrcmd. | Ejemplo: lrcmd |
Detener la ejecución de un trabajo sometido anteriormente. |
|
Este mandato detiene la ejecución de un trabajo sometido anteriormente cuando se produce un punto de control. Utilice -jobid =<ID_trabajo> como ID de trabajo que el planificador de trabajos ha asignado al trabajo. Argumentos
opcionales:
|
Ejemplos:
|
Muestra las variables simbólicas a las que se hace referencia en el xJCL de definición de trabajos. |
|
Este mandato muestra las variables simbólicas a las que se hace referencia en el xJCL de definición de trabajos. Utilice -jobid =<ID_trabajo> como ID de trabajo que el planificador de trabajos ha asignado al trabajo. Argumentos
opcionales:
|
Ejemplos:
|
Guardar el registro de trabajo. |
|
Este mandato guarda el registro de trabajo asociado al identificador de trabajo solicitado en el sistema de archivos local. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. Utilice -filename=<nombreArchivo> para indicar el nombre de un archivo del sistema de archivos local donde se deben guardar los datos del registro de trabajo comprimido. El archivo se sustituye si existe. El nombre de archivo <nombre de archivo> quizá no contenga espacios en blanco intercalados. Argumentos
opcionales:
|
Ejemplos:
|
Obtener las anotaciones de trabajo. |
|
Muestra el registro de trabajo asociado al identificador de trabajo solicitado. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. Argumentos
opcionales:
|
Ejemplos:
|
Depurar el registro de trabajo |
|
Elimina el registro de trabajo asociado con el identificador de trabajo solicitado y la indicación de fecha y hora del registro. Una entrada del registro de trabajo permanece en, por ejemplo: /opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log.
La entrada realiza un seguimiento de por qué se ha eliminado el registro de trabajo.
|
Ejemplos:
|
Visualizar los metadatos del registro de trabajo correspondientes al identificador de trabajo solicitado. |
|
Los metadatos del registro de trabajo indican las indicaciones de fecha y hora del registro asociadas con el identificador de trabajo solicitado. Los metadatos o la indicación de fecha y hora identifican una instancia del trabajo única. Pueden existir registros de varios trabajos distintos con el mismo número de trabajo. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. |
Ejemplos:
|
Mostrar la lista de componentes del registro de trabajo. |
|
Muestra la lista de componentes del registro de trabajo asociados al identificador de trabajo solicitado y la indicación de fecha y hora del registro. Utilice el mandato getLogMetaData para
que devuelva una indicación de fecha y hora que se va a utilizar con -logTimeStamp=<indicación_fecha_ora>. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. |
Ejemplos:
|
Mostrar el componente del registro de trabajo. |
|
Muestra el componente del registro de trabajo asociado al identificador de trabajo solicitado, la indicación de fecha y hora del registro y el componente del registro. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. Utilice -logtimestamp=<indicación_fecha_hora_registro> para indicar la indicación de fecha y hora (el nombre del subdirectorio) que identifica el registro de trabajo cuya información de lista de componentes se va a devolver. La indicación de fecha y hora la devuelve -cmd=getLogMetaData. Utilice -logpart=<componente_registro> para indicar la parte del registro asociada al identificador de trabajo solicitado y la indicación de fecha y hora que se devolverá. La información de parte de registro la devuelve -cmd=getLogPartList. |
Ejemplos:
|
Mostrar el tamaño del registro de trabajo asociado al identificador de trabajo solicitado. |
|
Este mandato devuelve el tamaño de los bytes de inicio de sesión del trabajo. Utilice -jobid =<ID_trabajo> como ID del trabajo que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. Utilice -logtimestamp=<indicación_fecha_hora_registro> para indicar la indicación de fecha y hora; es decir, el nombre del subdirectorio, que identifica el registro de trabajo cuya información de lista de componentes se va a devolver. La indicación de fecha y hora la devuelve -cmd=getLogMetaData. |
Ejemplos:
|
Devolver la antigüedad del registro de trabajo en segundos desde la última vez que se modificó. |
|
Muestra la antigüedad de
Utilice -jobid =<ID_trabajo> como ID que el planificador de trabajos ha asignado al trabajo. El ID de trabajo que devuelve el mandato lrcmd-submit que ha sometido inicialmente el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo. Utilice -logtimestamp=<indicación_fecha_hora_registro> para indicar la indicación de fecha y hora; es decir, el nombre del subdirectorio, que identifica el registro de trabajo cuya información de lista de componentes se va a devolver. La indicación de fecha y hora la devuelve -cmd=getLogMetaData. |
Ejemplos:
|
Ejemplo de recuperación de salida de un trabajo de proceso por lotes:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
Resultados del ejemplo:
CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63
CWLRB5000I: Mié 15 Jun 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : respuesta para salida
CWLRB1740I: [Mié 15 Jun 17:55:36 EDT 2005] El trabajo [mybatchjob:63] se encuentra
en proceso de configuración.
CWLRB1760I: [Mié 15 Jun 17:55:37 EDT 2005] El trabajo [mybatchjob:63] se ha enviado
para ejecución.
CWLRB2420I: [Mié 15 Jun 17:55:37 EDT 2005] El trabajo [mybatchjob:63] paso [paso1]
se encuentra en proceso de configuración.
CWLRB2440I: [Mié 15 Jun 17:55:38 EDT 2005] El trabajo [mybatchjob:63] paso [paso1]
se ha entregado.
CWLRB2460I: [Mié 15 Jun 17:55:38 EDT 2005] El trabajo [mybatchjob:63] paso [paso1]
se encuentra en proceso de desglose.
CWLRB2600I: [Mié 15 Jun 17:55:38 EDT 2005] El trabajo [mybatchjob:63] paso [paso1]
ha finalizado normalmente, código de retorno=0.
CWLRB2420I: [Mié 15 Jun 17:55:39 EDT 2005] El trabajo [mybatchjob:63] paso [paso2]
se encuentra en proceso de configuración.
CWLRB2440I: [Mié 15 Jun 17:55:39 EDT 2005] El trabajo [mybatchjob:63] paso [paso2]
se ha entregado.
CWLRB2460I: [Mié 15 Jun 17:55:40 EDT 2005] El trabajo [mybatchjob:63] paso [paso2]
se encuentra en proceso de desglose.
CWLRB2600I: [Mié 15 Jun 17:55:40 EDT 2005] El trabajo [mybatchjob:63] paso [paso2]
ha finalizado normalmente, código de retorno=4.
Fin