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

Interface da Linha de Comandos

A interface da linha de comandos interage com o planejador de execução longa para enviar e manipular tarefas de execução longa. Ela está localizada em was_root/bin como o script lrcmd.sh ou lrcmd.bat e pode ser chamada a partir de qualquer local na célula do WebSphere.

O script lrcmd pode desempenhar os seguintes comandos:

Table 1. Comandos lrcmd
Comando Argumentos Descrição Informações adicionais
Exibir informações de uso para lrcmd Nenhum Este comando exibe informações de uso do comando lrcmd. Exemplo: lrcmd
Enviar uma tarefa para o planejador de execução longa -cmd=submit -xJCL=<nome_do_arquivo_xjcl> [-job= <nome_da_tarefa>(-add | -replace)][-startDate=<Data_de_início> -startTime=<Hora_de_início>] [-host=<host>] [-port=<porta>], ou -cmd=submit -job=<nome_da_tarefa> [-startDate=<Data_de_início> - startTime=<Hora_de_início>] [-host=<host>] [-port=<porta>]
Quando um arquivo xJCL for especificado: -xJCL=<nome_do_arquivo_xjcl> especifica o caminho para o xJCL a ser enviado do sistema de arquivos e, opcionalmente, salvo. Argumentos opcionais:
  • -job=<nome_da_tarefa> é o nome de um XJCL salvo no repositório xJCL e especifica o nome a ser utilizado ao salvar o xJCL no repositório de xJCL da tarefa. Consulte -cmd=save abaixo para obter informações adicionais.
  • -add inclui o xJCL no repositório da tarefa xJCL utilizando o nome da tarefa especificado.
  • -replace substitui ou inclui o xJCL no repositório da tarefa xJCL utilizando o nome da tarefa especificado.
  • -startDate=<Data_de_início> a data na qual a tarefa deve ser enviada para execução, em que o formato requerido de Data_de_início é aaaa-MM-dd. Requer que o parâmetro -startTime seja definido.
  • -startTime=<Hora_de_início> o horário no qual a tarefa deve ser enviada para execução, em que o formato requerido de Hora_de_início é HH:mm:ss. Este parâmetro requer que o parâmetro -startDate também seja definido.
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.

Ambas as variações do comando retornam um ID de tarefa para a tarefa enviada.

Exemplos:
  • 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 uma Tarefa Anteriormente Enviada -cmd=cancel -jobid=<id_da_tarefa>[-<host>] [-port=<porta>] Esse comando cancela a execução de uma tarefa enviada anteriormente.

-jobid=<id_da_tarefa> é o ID da tarefa designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando do lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

Argumentos opcionais:
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.
Por exemplo:

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

Reiniciar uma tarefa -cmd=restart -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] Esse comando reinicia a execução de uma tarefa. Somente tarefas no estado reiniciável podem ser reiniciadas.

-jobid=<id_da_tarefa> é o ID da tarefa designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando do lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

Argumentos opcionais:
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.
Apenas as tarefas de longa execução associadas aos aplicativos de batch podem ser reiniciadas. Quando uma tarefa do batch é cancelada utilizando o comando -cmd=cancel, o seu estado é alterado para reinicializável.

Quando a tarefa é reiniciada, o processamento é retomado a partir do último ponto de verificação confirmado com êxito.

Por exemplo:

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

Limpar Informações de Tarefa -cmd=purge -job=<id_da_tarefa> [-host=<host>] [-port=<porta>] Esse comando limpa as informações de tarefa do planejador de longa execução e ambientes de execução.

-jobid=<id_da_tarefa> é o ID da tarefa designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando do lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

Argumentos opcionais:
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.
O planejador de longa execução mantém informações sobre uma tarefa depois que ela é concluída. O comando de limpeza exclui permanentemente as informações de tarefa do planejador de longa execução e os bancos de dados do ambiente de execução.

Por exemplo:

lrcmd –cmd=purge –jobid=myjob:2

Salvar xJCL no Repositório de Tarefa -cmd=save -xJCL=<nome_do_arquivo_xjcl> -job=<nome_da_tarefa> [-host=<host>] [-port=<porta>] Esse comando salva um documento xJCL no repositório de tarefa para uso pelos futuros comandos -cmd=submit.
  • -xJCL=<nome_do_arquivo_xjcl> especifica o nome do arquivo do xJCL a ser salvo.
  • O -job=<nome_da_tarefa> especifica o nome a ser utilizado ao salvar o xJCL no repositório da tarefa xJCL. O nome da tarefa pode ser utilizado em futuros comandos
  • -cmd=submit para referenciar o xJCL salvo.
Argumentos opcionais:
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.

Exemplos:

  • lrcmd -cmd=save -xJCL=myxjcl.xml -job=myjob –host=myODRHost –port=82
  • lrcmd -cmd=submit -job=myjob
Remover uma Tarefa do Repositório da Tarefa -cmd=remove -job=<nome_da_tarefa>[-host=<host>] [-port=<porta>] Este comando remove um documento xJCL anteriormente salvo do repositório da tarefa.

-job=<nome_da_tarefa> especifica o nome atribuído à tarefa quando foi salva anteriormente no repositório da tarefa.

  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.
Por exemplo:

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

Mostrar xJCL armazenado no repositório da tarefa -cmd=show -job=<nome_da_tarefa> Este comando exibe o xJCL armazenado no repositório da tarefa.

y-job=<nome_da_tarefa> especifica o nome designado à tarefa quando ela foi salva no repositório de tarefas.

Exemplos:
  • lrcmd -cmd=save -xJCL=myxjcl.xml -job=myjob
  • lrcmd -cmd=show -job=myjob
Mostrar status das tarefas de longa execução -cmd=status, ou -cmd=status -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] Este comando exibe as informações de status sobre uma ou mais tarefas no banco de dados do planejador de longa execução.

Argumento opcional: -job=<id_da_tarefa>, se especificado, indica que somente informações de tarefa da tarefa especificada devem ser exibidas.

Exemplos:
  • lrcmd -cmd=status host=myODRHost –port=83
  • lrcmd -cmd=submit -xJCL=myxjcl.xml (retorna o ID da tarefa LongRunningScheduler:17)
  • lrcmd -cmd=status -jobid=LongRunningScheduler:17
Suspender uma Tarefa -cmd=suspend -jobid=<id_da_tarefa> -seconds=<segundos>[-host=<host>] [-port=<porta>] Este comando suspende a execução de uma tarefa de batch de execução longa pelo número especificado de segundos. A menos que seja retomado manualmente (com lrcmd -cmd=resume, por exemplo), a tarefa será retomada automaticamente após o número especificado de segundos.

-jobid=<id_da_tarefa> o ID da tarefa designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

Argumentos opcionais:

-seconds=<segundos> indica em quantos segundos a execução da tarefa deve ser suspensa. Se não for especificado, o valor padrão de 15 será utilizado. Se -seconds=0 for especificado a tarefa não retomará a execução até que seja retomada manualmente.

  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.

Exemplos:

lrcmd -cmd=submit -xJCL=myxjcl.xml (retorna id da tarefa myjob:23) Depois que a tarefa myjob:23 começar a executar, ela poderá ser suspensa por cinco minutos (por exemplo) com: lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 –port=81 –host=myODRHost

A execução da tarefa pode ser retomada antes que os cinco minutos expirem com: lrcmd -cmd=resume -jobid=myjob:23

Retomar a execução de uma tarefa anteriormente suspensa -cmd=resume -jobid=<id_da_tarefa>[-host=<host>] [-port=<porta>] Este comando retoma a execução de uma tarefa do batch suspensa anteriormente.

-jobid=<id_da_tarefa> é o ID da tarefa designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

Consulte a descrição de -cmd=suspend.
Exibir a saída para uma tarefa -cmd=output -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] Exibe a saída gerada pelo planejador de execução longa e pelo ambiente de execução durante a execução da tarefa especificada.

-jobid=<id_da_tarefa> é o ID designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.

 
Exibe o código de retorno de uma tarefa do batch -cmd=getBatchJobRC -jobid=<id_da_tarefa>[-host=<host>] [-port=<porta>] Exibe o código de retorno geral através uma tarefa do batch de longa execução.
-jobid=<id_da_tarefa> é o ID designado para a tarefa pelo planejador de tarefa de execução longa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. O comando -cmd=status também pode ser utilizado para identificar o ID da tarefa para uma determinada tarefa.
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.
 
Enviar um pedido de tarefa recorrente ao Planejador de Execução Longa -cmd=submitRecurringRequest -xJCL=<nome do arquivo XML> -request=<nome do pedido> -startDate=<data em que a primeira tarefa é enviada>-startTime=<hora em que a primeira tarefa é enviada>-interval=<período de tempo entre envios de tarefas>[-host=<host>] [-port=<porta>] OU

-cmd=submitRecurringRequestjo b=<nome_da_tarefa> -request=<nome do pedido> -startDate=<data em que a primeira tarefa é enviada>-startTime=<hora em que a tarefa é enviada>-interval=<período de tempo entre envios de tarefas>[-host=<host>] [-port=<porta>]

Envia o pedido de tarefa recorrente ao planejador. O planejador envia tarefas de execução longa em relação ao xJCL especificado nos intervalos de tempo indicados pelos argumentos.
  • xJCL=<nome_do_arquivo_xjcl> especifica o caminho do xJCL a ser enviado do sistema de arquivos e, opcionalmente, salvo.
  • -request=<nome do pedido> o nome exclusivo do pedido utilizado para identificar este pedido de envio de tarefa recorrente-startDate=<data em que a primeira tarefa é enviada a data na qual a primeira tarefa é enviada para execução, em que o formato requerido de startTime é aaaa-MM-dd. Requer que o parâmetro -startTime também seja definido.
  • -startTime=<hora em que a tarefa é enviada> o horário em que a primeira tarefa e todas as tarefas recorrentes subseqüentes são enviadas para execução, em que o formato requerido de startTime é HH:mm:ss. Observe que este parâmetro requer que o parâmetro -startDate também seja definido.
  • -interval=<período de tempo entre envios de jobs> o período de tempo entre dois envios de tarefas para este pedido de tarefa recorrente em que os períodos de tempo suportados são diário, semanal e mensal.
Argumentos opcionais:
  • O nome de um xJCL salvo no repositório de xJCL. Consulte -cmd=save para obter informações adicionais.
  • -host=<host> O nome do host do ODR ou o nome do host do servidor do planejador de execução longa. Se não for especificado, o padrão é localhost.
  • -port=<porta> O endereço do Proxy HTTP do ODR ou a porta HTTP do servidor do planejador de execução longa. Se não for especificado, o padrão é 80.

Exemplos:

  • 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 um pedido de tarefa recorrente existente lrcmd -cmd=modifyRecurringRequest -request=<nome do pedido> -xJCL=< nome do arquivo XML> -interval=<período de tempo entre envios de jobs>-startDate=<data em que o primeiro pedido é enviado> -startTime=<hora em que a tarefa é enviada>
  • <nome do pedido> o nome exclusivo do pedido utilizado para identificar esta modificação de pedido de envio de tarefa recorrente.
  • <nome do arquivo XML> o nome do arquivo XML que descreve a tarefa de execução longa a ser planejada para execução.
  • <período de tempo entre envios de tarefas> o período de tempo entre dois envios de tarefas para este pedido de tarefa recorrente em que os períodos de tempo suportados são diário, semanal e mensal.
  • <data em que a primeiro tarefa é enviada> a data em que a primeiro tarefa é enviada para execução, em que o formato exigido de startDate é aaaa-MM-dd. Requer que o parâmetro -startTime também seja definido.
  • <hora em que a tarefa é enviada> o horário em que a primeira tarefa e todos as tarefas recorrentes subseqüentes são enviados para execução, em que o formato exigido de startTime é HH:mm:ss. Requer que o parâmetro -startDate também seja definido.
Um dos seguintes parâmetros deve ser definido para este comando: -xJCL, -interval (-startDate e -startTime).

Argumentos opcionais:

  • -port: Endereço HTTP do proxy ODR ou porta HTTP do servidor do planejador de execução longa, o padrão é 80.
  • -host: host do ODR ou host do planejador de execução longa, o padrão é localhost.
Exemplos:

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 um pedido de tarefa recorrente existente  
  • <nome do pedido> é o nome exclusivo do pedido utilizado para identificar este pedido de envio de tarefa recorrente.
Exemplo: lrcmd-cmd=getRecurringRequestDetails-request=MyWeeklyReport-port=81
Mostrar detalhes de um pedido de tarefa recorrente existente lrcmd -cmd=getRecurringRequestDetails-request=<nome do pedido>

<nome do pedido> é o nome exclusivo do pedido utilizado para identificar este pedido de envio de tarefa recorrente.

Argumentos opcionais:
  • -port: Endereço HTTP do proxy ODR ou porta HTTP do servidor do planejador de execução longa (o padrão é 80).
  • -host: host do ODR ou host do planejador de execução longa (o padrão é localhost).
Exemplo: lrcmd -cmd=getRecurringRequestDetails -request=MyWeeklyReport-port=81
Listar todos os pedidos de tarefas recorrentes existentes lrcmd -cmd=showAllRecurringRequests   Exemplo: lrcmd -cmd=showAllRecurringRequests -port=81
Mostrar todas as tarefas recorrentes de um pedido lrcmd -cmd=showRecurringJobs-request=<nome do pedido> <nome do pedido> é o nome exclusivo do pedido utilizado para identificar este pedido de envio de tarefa recorrente.
Argumentos opcionais:
  • -port: Endereço HTTP do proxy ODR ou porta HTTP do servidor do planejador de execução longa (o padrão é 80).
  • -host: host do ODR ou host do planejador de execução longa (o padrão é localhost).
Exemplos: lrcmd -cmd=showRecurringJobs -request=MyWeeklyReport -port=81 lrcmd -cmd=status -jobid=<identificador da tarefa>-port=80 -host=myodrhost.com lrcmd -cmd=status -port=80-host=myodrhost.com

Exemplo:

Exemplo de recuperação de saída de uma tarefa do batch:

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

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

CWLRB5000I: Wed Jun 15 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : resposta à saída

CWLRB1740I: [Qua 15 Jun 17:55:36 EDT 2005] Tarefa [mybatchjob:63] está na configuração da tarefa.
CWLRB1760I: [Qua 15 Jun 17:55:37 EDT 2005] Tarefa [mybatchjob:63] foi enviada para execução.
CWLRB2420I: [Qua 15 Jun 17:55:37 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa1] está na configuração da etapa.
CWLRB2440I: [Qua 15 Jun 17:55:38 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa1] foi despachado.
CWLRB2460I: [Qua 15 Jun 17:55:38 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa1] está na decomposição da etapa.
CWLRB2600I: [Qua 15 Jun 17:55:38 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa1] concluiu normalmente rc=0.
CWLRB2420I: [Qua 15 Jun 17:55:39 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa2] está na configuração da etapa.
CWLRB2440I: [Qua 15 Jun 17:55:39 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa2] foi despachado.
CWLRB2460I: [Qua 15 Jun 17:55:40 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa2] está na decomposição da etapa.
CWLRB2600I: [Qua 15 Jun 17:55:40 EDT 2005] Tarefa [mybatchjob:63] Etapa [Etapa2] concluiu normalmente rc=4.
Fim



Related concepts
Gerenciando Aplicativos de Longa Execução

Tópico de Referência    

Termos de Uso | Feedback Última atualização: Mar 21, 2006 12:48:50 PM 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. Todos os Direitos Reservados.
Este centro de informações é desenvolvido em tecnologia Eclipse. (http://www.eclipse.org)