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:
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:
Ambas as variações do comando retornam um ID de tarefa para a tarefa enviada. |
Exemplos:
|
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:
|
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:
|
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:
|
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.
Argumentos
opcionais:
|
Exemplos:
|
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.
|
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:
|
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:
|
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.
|
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.
|
|
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.
Argumentos
opcionais:
|
Exemplos:
|
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> |
Argumentos opcionais:
|
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 |
|
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:
|
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:
|
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 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