WebSphere Extended Deployment, Version 6.0.x     Sistemas operativos: AIX, HP-UX, Linux, Solaris, Windows, z/OS

Interfaz de línea de mandatos

La interfaz de línea de mandatos interactúa con el Scheduler de larga ejecución para someter y manipular trabajos de larga ejecución. Se encuentra en raíz_was/bin como el script lrcmd.sh o lrcmd.bat, y se puede invocar desde cualquier ubicación en la célula de WebSphere.

El script lrcmd puede realizar los siguientes mandatos:

Table 1. mandatos lrcmd
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
Someter un trabajo al Scheduler de larga ejecución -cmd=submit -xJCL=<nombre_archivo_xjcl> [-job= <nombre_trabajo>(-add | -replace)][-startDate=<fechaInicio> -startTime=<horaInicio>] [-host=<sistppal>] [-port=<puerto>], o -cmd=submit -job=<nombre_trabajo> [-startDate=<fechaInicio> - startTime=<horaInicio>] [-host=<sistppal>] [-port=<puerto>]
Cuando se especifica un archivo 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:
  • -job=<nombre_trabajo>, el nombre que se va a utilizar al guardar el xJCL en el depósito del xJCL de trabajo. Consulte -cmd=save, que aparece más abajo, para obtener información adicional.
  • -add añade el xJCL al depósito del xJCL del trabajo utilizando el nombre de trabajo especificado.
  • -replace sustituye el xJCL en el depósito del xJCL del trabajo o lo añade a él utilizando el nombre de trabajo especificado.
  • -startDate=<fechaInicio>, la fecha en la que debe someterse el trabajo a ejecución, donde el formato necesario de startDate es aaaa-MM-dd. Requiere que el parámetro -startTime esté definido.
  • startTime=<horaInicio>, la hora a la que debe someterse el trabajo a ejecución, donde el formato requerido de startTime es HH:mm:ss. Este parámetro requiere que el parámetro -startDate esté definido también.
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.

Ambas variaciones del mandato devuelven un ID de trabajo para el trabajo sometido.

Ejemplos:
  • lrcmd -cmd=submit -xJCL=myxjcl.xml–host=myhost -port=81
  • lrcmd -cmd=submit -xJCL=myxjcl.xml -add -job=myjob
  • lrcmd -cmd=submit -job=myjob
  • lrcmd -cmd=submit -xJCL=C:\\myXJCL -add -job=MyJob -port=80 -startDate=2005-11-25-startTime=23:59:00
  • lrcmd -cmd=submit -job=MyJob -startDate=2005-11-25 -startTime=23:59:00
Cancelar un trabajo sometido anteriormente -cmd=cancel -jobid=<ID_trabajo>[-<sistppal>] [-port=<puerto>] Este mandato cancela la ejecución de un trabajo sometido anteriormente.

-jobid=<ID_trabajo> es el ID de trabajo que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido un trabajo devuelve el ID de trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.

Argumentos opcionales:
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.
Ejemplo:

lrcmd –cmd=cancel –jobid=myjob:2 –host=myLRShost –port=9083

Reiniciar un trabajo. -cmd=restart -jobid=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato reinicia la ejecución de un trabajo. Sólo los trabajo en el estado reiniciable pueden reiniciarse.

-jobid=<ID_trabajo> es el ID de trabajo que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido un trabajo devuelve el ID de trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.

Argumentos opcionales:
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.
Sólo los trabajos de larga ejecución asociados con las aplicaciones de proceso por lotes pueden reiniciarse. Cuando un trabajo por lotes se cancela mediante el mandato -cmd=cancel, el estado cambia a reiniciable.

Cuando se reinicia el trabajo, el proceso continúa a partir del último punto de control sometido correctamente.

Ejemplo:

lrcmd –cmd=restart –jobid=myjob:2 –host=myLRShost –port=9081

Depurar la información de trabajo -cmd=purge -job=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato depura la información de trabajo del Scheduler de larga ejecución y de los entornos de ejecución.

-jobid=<ID_trabajo> es el ID de trabajo que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido un trabajo devuelve el ID de trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.

Argumentos opcionales:
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.
El Scheduler de larga ejecución 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 Scheduler de larga ejecución como de los entornos de ejecución.

Ejemplo:

lrcmd –cmd=purge –jobid=myjob:2

Guardar xJCL en el depósito de trabajos -cmd=save -xJCL=<nombre_archivo_xjcl> -job=<nombre_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato guarda un documento xJCL en el depósito de trabajos para que lo puedan utilizar otros mandatos -cmd=submit en el futuro.
  • -xJCL=<nombre_archivo_xjcl> especifica el nombre de archivo del xJCL que se vaya a guardar.
  • -job=<nombre_trabajo> especifica el nombre que se va a utilizar al guardar el xJCL en el depósito del xJCL de trabajo. El nombre de trabajo puede utilizarse en mandatos
  • -cmd=submit futuros para hacer referencia al xJCL guardado.
Argumentos opcionales:
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.

Ejemplos:

  • lrcmd -cmd=save -xJCL=myxjcl.xml -job=myjob –host=myODRHost –port=82
  • lrcmd -cmd=submit -job=myjob
Eliminar un trabajo del depósito de trabajos -cmd=remove -job=<nombre_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato elimina un documento xJCL previamente guardado del depósito de trabajos.

-job=<nombre_trabajo> especifica el nombre asignado al trabajo al guardarse previamente en el depósito de trabajos.

  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.
Ejemplo:

lrcmd –cmd=remove –jobid=myjob:2 –host=myhost –port=9083

Mostrar xJCL almacenado en el depósito de trabajos -cmd=show -job=<nombre_trabajo> Este mandato muestra el xJCL almacenado en el depósito de trabajos.

-job=<nombre_trabajo> especifica el nombre asignado al trabajo al guardarse en el depósito de trabajos.

Ejemplos:
  • lrcmd -cmd=save -xJCL=myxjcl.xml -job=myjob
  • lrcmd -cmd=show -job=myjob
Mostrar el estado de trabajos de larga ejecución -cmd=status, o -cmd=status -jobid=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato muestra la información de estado sobre uno o más trabajos de la base de datos del Scheduler de larga ejecución.

Argumento opcional: -job=<ID_trabajo>, si se especifica, indica que sólo debe visualizarse la información de trabajo del trabajo especificado.

Ejemplos:
  • lrcmd -cmd=status host=myODRHost –port=83
  • lrcmd -cmd=submit -xJCL=myxjcl.xml (devuelve el ID de trabajo LongRunningScheduler:17)
  • lrcmd -cmd=status -jobid=LongRunningScheduler:17
Suspender un trabajo -cmd=suspend -jobid=<ID_trabajo> -seconds=<segundos>[-host=<sistppal>] [-port=<puerto>] Este mandato suspende la ejecución de un trabajo por lotes de larga ejecución para el número de segundos especificado. A menos que se continúe manualmente (por ejemplo, con lrcmd -cmd=resume), el trabajo continúa ejecutándose automáticamente después del número de segundos especificado.

-jobid=<ID_trabajo> es el ID de trabajo que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido el trabajo devuelve el ID de trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.

Argumentos opcionales:

-seconds=<segundos> indica durante cuántos segundos debe suspenderse la ejecución del trabajo. Si no se especifica, se utiliza el valor por omisión de 15 segundos. Si se especifica -seconds=0, el trabajo no continúa la ejecución hasta que se haga manualmente.

  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.

Ejemplos:

lrcmd -cmd=submit -xJCL=myxjcl.xml (devuelve el ID de trabajo myjob:23) Una vez que el trabajo myjob:23 ha empezado a ejecutarse, puede suspenderse durante cinco minutos (por ejemplo), con: lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 –port=81 –host=myODRHost

Se puede continuar la ejecución del trabajo antes de que caduquen los cinco minutos con: lrcmd -cmd=resume -jobid=myjob:23

Continuar la ejecución de un trabajo suspendido anteriormente -cmd=resume -jobid=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Este mandato continúa la ejecución de un trabajo por lotes suspendido anteriormente.

-jobid=<ID_trabajo> es el ID de trabajo que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido el trabajo devuelve el ID de 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 -cmd=output -jobid=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Muestra la salida generada por el Scheduler de larga ejecución y el entorno de ejecución durante la ejecución del trabajo especificado.

-jobid=<ID_trabajo> es el ID que el Scheduler de trabajos de larga ejecución asigna al trabajo. El mandato lrcmd -cmd=submit que inicialmente ha sometido el trabajo devuelve el ID de trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.

 
Visualizar el código de retorno de un trabajo por lotes -cmd=getBatchJobRC -jobid=<ID_trabajo> [-host=<sistppal>] [-port=<puerto>] Visualiza todo el código de retorno producido por un trabajo por lotes de larga ejecución.
-jobid=<ID_trabajo> es el ID que el Scheduler de trabajos de larga ejecución asigna al trabajo. El ID de trabajo que devuelve el mandato lrcmd -cmd=submit que inicialmente ha sometido el trabajo. El mandato -cmd=status también puede utilizarse para identificar el ID de trabajo de un determinado trabajo.
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.
 
Someter una petición de trabajo recurrente al Scheduler de larga ejecución -cmd=submitRecurringRequest -xJCL=<nombre de archivo XML> -request=<nombre de petición> -startDate=<fecha en la que se somete el primer trabajo>-startTime=<hora a la que se somete el trabajo>-interval=<período de tiempo entre envíos de trabajos>[-host=<sistppal>] [-port=<puerto>] O BIEN

-cmd=submitRecurringRequestjo b=<nombre_trabajo> -request=<nombre de petición> -startDate=<fecha en la que se somete el primer trabajo>-startTime=<hora a la que se somete el trabajo>-interval=<período de tiempo entre envíos de trabajos>[-host=<sistppal>] [-port=<puerto>]

Somete una petición de trabajo recurrente al Scheduler. Scheduler somete trabajos de larga ejecución con el xJCL especificado en intervalos de tiempo indicados por los argumentos.
  • 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.
  • -request=<nombre de petición>, el nombre exclusivo de la petición que se utiliza para identificar esta petición de envío de trabajo recurrente. -startDate=<fecha en la que se somete el primer trabajo>, la fecha en la que debe someterse el primer trabajo a ejecución, donde el formato necesario de startDate es aaaa-MM-dd. Requiere que el parámetro -startTime esté también definido.
  • -startTime=<hora a la que se somete el trabajo>, la hora a la que debe someterse a ejecución el primer trabajo y todos los trabajos recurrentes posteriores, donde el formato necesario de startTime es HH:mm:ss. Observe que este parámetro requiere que el parámetro -startDate esté definido también.
  • -interval=<periodo de tiempo entre envíos de trabajos>, el periodo de tiempo entre dos envíos de trabajo para esta petición de trabajo recurrente, donde los periodos de tiempo soportados son diariamente, semanalmente y mensualmente.
Argumentos opcionales:
  • El nombre de un XJCL guardado en el depósito de xJCL. Consulte -cmd=save para obtener más información.
  • -host=<sistppal>, el nombre de sistema principal de ODR o el nombre del sistema principal del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es localhost.
  • -port=<puerto> La dirección del proxy HTTP de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución. Si no se especifica, el valor por omisión es 80.

Ejemplos:

  • lrcmd :-cmd=submitRecurringRequest-xJCL=C:\\myXJCL -port=81 -request=MyMonthlyReport -interval=monthly -startDate=2006-01-02 -startTime=23:59:00
  • lrcmd -cmd=submitRecurringRequest -job=WeeklyJob -request=MyWeeklyReport -interval=weekly -startDate=2006-01-02 -startTime=23:59:00
Modificar una petición de trabajo recurrente existente lrcmd -cmd=modifyRecurringRequest -request=<nombre de petición> -xJCL=<nombre de archivo XML> -interval=<periodo de tiempo entre envíos de trabajos>-startDate=<fecha en al que se somete el primer trabajo> -startTime=<hora a la que se somete el trabajo>
  • <nombre de petición>, el nombre exclusivo de la petición que se utiliza para identificar esta modificación de la petición de envío de trabajo recurrente.
  • <nombre de archivo XML>, el nombre del archivo XML que describe el trabajo de larga ejecución que se planifica para su ejecución.
  • <periodo de tiempo entre envíos de trabajos>, el periodo de tiempo entre dos envíos de trabajo para esta petición de trabajo recurrente, donde los periodos de tiempo soportados son diariamente, semanalmente y mensualmente.
  • <fecha en la que se somete el primer trabajo>, la fecha en la que debe someterse el primer trabajo a ejecución, donde el formato necesario de startDate es aaaa-MM-dd. Requiere que el parámetro -startTime esté también definido.
  • <hora a la que se somete el trabajo>, la hora a la que debe someterse a ejecución el primer trabajo y todos los trabajos recurrentes posteriores, donde el formato necesario de startTime es HH:mm:ss. Requiere que el parámetro -startDate esté también definido.
Uno de los siguientes parámetros debe definirse para este mandato: -xJCL, -interval (-startDate y -startTime).

Argumentos opcionales:

  • -port: la dirección HTTP del proxy de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución; el valor por omisión es 80.
  • -host: el sistema principal del ODR o el sistema principal del Scheduler de larga ejecución; el valor por omisión es localhost.
Ejemplos:

lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -xJCL=C:\\myNewXJCL -port=81

lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\myFebXJCL -port=81

Cancelar una petición de trabajo recurrente existente  
  • <nombre de petición> es el nombre exclusivo de la petición que se utiliza para identificar esta petición de envío de trabajo recurrente.
Ejemplo: lrcmd-cmd=getRecurringRequestDetails-request=MyWeeklyReport-port=81
Mostrar los detalles de una petición de trabajo recurrente existente lrcmd -cmd=getRecurringRequestDetails-request=<nombre de petición>

<nombre de petición> es el nombre exclusivo de la petición que se utiliza para identificar esta petición de envío de trabajo recurrente.

Argumentos opcionales:
  • -port: la dirección HTTP del proxy de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución (el valor por omisión es 80).
  • -host: el sistema principal del ODR o el sistema principal del Scheduler de larga ejecución (el valor por omisión es localhost).
Ejemplo: lrcmd -cmd=getRecurringRequestDetails -request=MyWeeklyReport-port=81
Listar todas las peticiones de trabajos recurrentes existentes lrcmd -cmd=showAllRecurringRequests   Ejemplo: lrcmd -cmd=showAllRecurringRequests -port=81
Mostrar todos los trabajos recurrentes de una petición lrcmd -cmd=showRecurringJobs-request=<nombre de petición> <nombre de petición> es el nombre exclusivo de la petición que se utiliza para identificar esta petición de envío de trabajo recurrente.
Argumentos opcionales:
  • -port: la dirección HTTP del proxy de ODR o el puerto HTTP del servidor de Scheduler de larga ejecución (el valor por omisión es 80).
  • -host: el sistema principal del ODR o el sistema principal del Scheduler de larga ejecución (el valor por omisión es localhost).
Ejemplos: lrcmd -cmd=showRecurringJobs -request=MyWeeklyReport -port=81 lrcmd -cmd=status -jobid=<job identifier>-port=80 -host=myodrhost.com lrcmd -cmd=status -port=80-host=myodrhost.com

Ejemplo

Ejemplo de recuperación de salida de un trabajo de proceso por lotes:

lrcmd -cmd=output -jobid=mybatchjob:63 –host=myLRSHost –port=9081

CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63

CWLRB5000I: CWLRB1740I: Mié 15 Jun  17:55:36 EDT 2005 :  El trabajo [LongRunningScheduler:63] se encuentra en proceso de configuración.
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



Related concepts
Gestión de las aplicaciones de larga ejecución

Tema de referencia    

Condiciones de uso | Comentarios Última actualización: Mar 14, 2006 11:03:53 AM EST
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r0/index.jsp?topic=?topic=/com.ibm.websphere.xd.doc/info/scheduler/cbgcommd.html

© Copyright IBM 2005, 2006. Reservados todos los derechos.
Este centro de información se ha realizado con tecnología de Eclipse. (http://www.eclipse.org)