Interface da linha de comandos para tarefas em lote
A interface da linha de comandos interage com o planejador de tarefa para enviar e manipular um tarefa em lote. Ela está localizada no diretório app_server_root/bin como o script lrcmd.sh ou lrcmd.bat e pode ser iniciada de qualquer local da célula do WebSphere.
Use o script lrcmd para executar os seguintes comandos:
Command | Argumentos | Description | Informações Adicionais |
---|---|---|---|
Exibir informações de uso para lrcmd. | Nenhuma. | O comando exibe informações de uso para o comando lrcmd. | Exemplo: lrcmd |
Enviar uma tarefa para o planejador de tarefa. |
|
Quando um arquivo xJCL (XML Job Control Language) é especificado, -xJCL=<xjcl_filename> especifica
o caminho do xJCL a ser enviado sistema de arquivo e opcionalmente salvo. Argumentos
opcionais:
Ambas as variações do comando retornam um ID de tarefa para a tarefa enviada. |
Exemplos:
|
Cancelar uma tarefa enviada anteriormente. |
|
Esse comando cancela o início de uma tarefa enviada anteriormente ou cancela a execução de uma
tarefa em execução. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. 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:
|
Exemplo: lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
Reiniciar uma tarefa. |
|
Esse comando reinicia uma tarefa cancelada. Somente tarefas no
estado reiniciável podem ser reiniciadas. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. 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:
|
Somente uma tarefa em lote
associada a aplicativos em lote pode ser reiniciada. 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. Exemplo: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
Limpar informações da tarefa. |
|
Esse comando limpa as informações de tarefa do
planejador de tarefa e dos
terminais de grade. O planejador de tarefa 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 tarefa e dos bancos do grid endpoint. O comando também limpa o log da tarefa. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. 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:
|
O planejador de tarefa mantém
informações sobre uma tarefa após sua conclusão. O comando purge
exclui permanentemente as informações de tarefa dos bancos de dados planejador de tarefa e terminal de grade.
O comando também limpa o log da tarefa. Exemplo: lrcmd -cmd=purge -jobid=myjob:2 |
Salvar um xJCL no repositório de tarefas. |
|
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 de tarefas. |
|
Esse comando remove um documento xJCL salvo anteriormente
no repositório de tarefas. Utilize -job=<nome_da_tarefa> para especificar o nome designado à tarefa quando o arquivo foi salvo anteriormente no repositório de tarefas.
|
Exemplo: lrcmd -cmd=remove -jobid=myjob:2 -host=myhost -port=9083 |
Mostrar o status de uma tarefa em lote. |
ou
|
Esse comando exibe informações de status sobre uma ou mais tarefas
no banco de dados do planejador de tarefa. Argumento opcional: -job=<id_da_tarefa>, se especificado, indica que apenas as informações da tarefa especificada serão exibidas. |
Exemplos:
|
Suspenda uma tarefa. |
|
Esse comando suspende o início de uma tarefa em lote da grade
durante o número especificado de segundos. A menos que retomada manualmente (com lrcmd -cmd=resume, por
exemplo), a tarefa continua automaticamente a execução após o número especificado de segundos. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. 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: Utilize -seconds=<segundos> para indicar o número de segundos de suspensão do início da tarefa. Se não for especificado, o valor padrão de 15 será utilizado. Se -seconds=0 for especificado, a tarefa não será iniciada até que seja retomada manualmente.
|
Exemplos: lrcmd -cmd=submit -xJCL=myxjcl.xml (retorna o ID da tarefa myjob:23). Após a tarefa myjob:23 iniciar a execução, ela pode 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 dos 5 minutos expirarem com: lrcmd -cmd=resume -jobid=myjob:23 |
Retomar o início de uma tarefa suspensa anteriormente. |
|
Esse comando retoma o início de uma tarefa em lote suspensa
anteriormente. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. 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 de uma tarefa. |
|
Exibe a saída gerada pelo
planejador de tarefa e pelo
terminal de grade durante a execução da tarefa
especificada. Utilize -jobid=<id_da_tarefa> como o ID designado à tarefa pelo planejador de tarefa. 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. |
(nenhum(a)) |
Exiba o código de retorno de uma tarefa em lote. |
|
Exibe o código de retorno geral produzido por uma tarefa em
lote da grade. Utilize -jobid=<id_da_tarefa> como o ID designado à
tarefa pelo planejador de tarefa. 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.
|
(nenhum(a)) |
Envie uma solicitação de tarefa recorrente para o planejador de tarefa. |
ou
|
Envia um pedido de tarefa recorrente ao planejador de tarefa.
O planejador de tarefa envia uma tarefa em lote ao
xJCL especificado nos intervalos de tempo indicados pelos argumentos.
Argumentos
opcionais:
|
Exemplos:
|
Modificar um pedido de tarefa recorrente existente. |
|
Argumentos:
Argumentos opcionais:
|
Exemplos: 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 |
Command | Argumentos | Description | Informações adicionais |
---|---|---|---|
Exibir informações de uso para lrcmd. | Nenhuma. | Este comando exibe informações de uso do comando lrcmd. | Exemplo: lrcmd |
Pare a execução de uma tarefa enviada anteriormente. |
|
Esse comando para a execução de uma tarefa enviada anteriormente quando ocorre um ponto de
verificação. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa Argumentos
opcionais:
|
Exemplos:
|
Mostrar as variáveis simbólicas usadas como referência no xJCL da definição de tarefa. |
|
Esse comando mostra as variáveis simbólicas utilizadas como referência no xJCL da definição de tarefa. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa Argumentos
opcionais:
|
Exemplos:
|
Salve o log da tarefa. |
|
Esse comando salva o log da tarefa associado ao
identificador da tarefa solicitado no sistema de arquivos local. Utilize -jobid=<job_id> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. Use -fileName=<fileName> para indicar o nome de um arquivo no sistema de arquivos local em que os dados compactados do log da tarefa devem ser salvos. O arquivo é substituído, se existir. O nome do arquivo <Nome_do_arquivo> não pode conter espaços em branco integrados. Argumentos
opcionais:
|
Exemplos:
|
Obter o log da tarefa. |
|
Exibe o log da tarefa associado ao identificador
da tarefa solicitado. Utilize -jobid=<job_id> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. Argumentos
opcionais:
|
Exemplos:
|
Limpar o log de tarefa |
|
Remove o log de tarefa associado ao identificador
de tarefa solicitado e ao registro de data e hora do log. Uma entrada de log de tarefa permanece, por exemplo:
/opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log.
A entrada rastreia o motivo pelo qual o log de tarefa foi removido.
|
Exemplos:
|
Exiba os metadados do log de tarefa para o identificador de tarefa solicitado. |
|
Os metadados do log da tarefa indica os registros de data e hora do log associado ao identificador
de tarefa solicitado. Os metadados ou registros de data e hora
identificam uma instância exclusiva da tarefa. É possível existir logs de diversas
tarefas diferentes com o mesmo número de tarefa. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. |
Exemplos:
|
Exiba a lista de partes do log da tarefa. |
|
Exibe a lista de partes do log da tarefa associada ao identificador
da tarefa solicitado e ao registro de data e hora do log. Utilize o comando getLogMetaData para
retornar um registro de data e hora a ser utilizado com -logTimeStamp=<registro de data e hora>. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. |
Exemplos:
|
Exiba a parte do log da tarefa. |
|
Exibe a parte do log da tarefa associada ao identificador
da tarefa solicitado, ao registro de data e hora do log e à parte do log. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. Use -logTimeStamp=<logTimeStamp> para indicar o registro de data e hora (o nome do subdiretório), que identifica o log de tarefa cujas informações da lista de partes devem ser retornadas. O registro de data e hora é retornado por -cmd=getLogMetaData. Utilize -logPart=<parte_do_log> para indicar a parte do log de tarefa associado ao identificador de tarefa e registro de data e hora solicitados a serem retornados. As informações de parte do log são retornadas por -cmd=getLogPartList. |
Exemplos:
|
Exiba o tamanho do log de tarefa associado ao identificador da tarefa solicitado. |
|
Este comando retorna o tamanho em bytes do login da tarefa. Utilize -jobid=<id_da_tarefa> como o ID de tarefa designado à tarefa pelo planejador de tarefa. O ID da tarefa é retornado pelo comando lrcmd -cmd=submit que enviou a tarefa inicialmente. Use -logTimeStamp=<logTimeStamp> para indicar o registro de data e hora; ou seja, o nome do subdiretório, que identifica o log de tarefa cujas informações da lista de partes devem ser retornadas. O registro de data e hora é retornado por -cmd=getLogMetaData. |
Exemplos:
|
Retorne a idade do log de tarefa em segundos desde que foi modificado pela última vez. |
|
Exibe a idade do
Utilize -jobid=<id_da_tarefa> como o ID designado à tarefa pelo planejador de tarefa. 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. Use -logTimeStamp=<logTimeStamp> para indicar o registro de data e hora; ou seja, o nome do subdiretório, que identifica o log de tarefa cujas informações da lista de partes devem ser retornadas. O registro de data e hora é retornado por -cmd=getLogMetaData. |
Exemplos:
|
Exemplo de recuperação de saída de uma tarefa do batch:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
Exemplo de resultados:
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