A interface da linha de comandos interage com o planejador de tarefa para submeter e manipular uma tarefa de Compute Grid. Ela está localizada no diretório was_root/bin como o script lrcmd.sh ou lrcmd.bat e pode ser chamada de qualquer local na célula do WebSphere.
Utilize o script lrcmd para 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 tarefa. | -cmd=submit -xJCL=<xjcl_filename> [-job= <job_name> (-add | -replace)] [-startDate=<startDate> -startTime=<startTime>] [-host=<host>] [-port=<port>], ou -cmd=submit -job=<job_name> [-startDate=<startDate> -startTime=<startTime>] [-host=<host>] [-port=<port>] |
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. | -cmd=cancel -jobid=<id_da_tarefa> [-<host>] [-port=<porta>] |
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. | -cmd=restart -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
Esse comando reinicia o início de uma tarefa. 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 de Compute Grid
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. | -cmd=purge -job=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
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 elimina 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 elimina o log da tarefa. Exemplo: lrcmd -cmd=purge -jobid=myjob:2 |
Salvar um xJCL no repositório de tarefas. | -cmd=save -xJCL=<xjcl_filename> -job=<job_name> [-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 de tarefas. | -cmd=remove -job=<job_name> [-host=<host>] [-port=<porta>] |
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 xJCL armazenado no repositório de tarefas. | -cmd=show -job=<job_name> |
Este comando exibe o xJCL armazenado no repositório da tarefa. Utilize -job=<nome_da_tarefa> para especificar o nome designado à tarefa quando ela foi salva no repositório de tarefas. |
Exemplos:
|
Mostrar o status de uma tarefa de Compute Grid. | -cmd=statusou -cmd=status -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
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. | -cmd=suspend -jobid=<id_da_tarefa> -seconds=<segundos> [-host=<host>] [-port=<porta>] |
Esse comando suspende o início de uma tarefa em lote da grade
durante o número especificado de segundos. A menos que seja retomado manualmente (com lrcmd
-cmd=resume, por exemplo), a tarefa será retomada automaticamente depois do 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 inicialmente a tarefa. 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) Depois de iniciada a execução da tarefa myjob:23, 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 que os cinco minutos expirem com: lrcmd -cmd=resume -jobid=myjob:23 |
Retomar o início de uma tarefa suspensa anteriormente. | -cmd=resume -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
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. | -cmd=output -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
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)) |
Exibir o código de retorno de uma tarefa em lote. | -cmd=getBatchJobRC -jobid=<id_da_tarefa> [-host=<host>] [-port=<porta>] |
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)) |
Enviar um pedido de tarefa recorrente para o planejador de tarefa. | -cmd=submitRecurringRequest -xJCL=<nome do arquivo XML> -request=<nome do pedido> -startDate=<data em que a primeira tarefa foi submetida> -startTime=<hora de submissão da tarefa> -interval=<período de tempo entre as submissões de tarefa> [-host=<host>] [-port=<porta>]ou -cmd=submitRecurringRequestjo b=<job_name> -request=<nome do pedido> -startDate=<data em que a primeira tarefa foi submetida> -startTime=<hora de submissão da tarefa> -interval=<período de tempo entre as submissões de tarefa> [-host=<host>] [-port=<porta>] |
Envia um pedido de tarefa recorrente ao planejador de tarefa. O planejador de tarefa envia uma tarefa de Compute Grid 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 as submissões de tarefa> -startDate=<data em que a primeira tarefa foi submetida> -startTime=<hora de submissão da tarefa> |
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 |
Cancelar um pedido de tarefa recorrente existente. | -cmd=cancelRecurringRequest -request=<id_da_tarefa> [-<host>] [-port=<porta>] (nenhum(a)) |
Argumentos:
|
Exemplo: lrcmd-cmd=cancelRecurringRequest -request=MyWeeklyReport -port=80 |
Mostrar detalhes de um pedido de tarefa recorrente existente. | lrcmd -cmd=getRecurringRequestDetails -request=<nome do pedido> |
Utilize <nome do pedido> como o nome exclusivo do pedido utilizado para identificar este pedido de envio de tarefa recorrente. Argumentos
opcionais:
|
Exemplo: lrcmd -cmd=getRecurringRequestDetails -request=MyWeeklyReport-port=80 |
Listar todos os pedidos de tarefas recorrentes existentes. | lrcmd -cmd=showAllRecurringRequests |
Nenhum | Exemplo: lrcmd -cmd=showAllRecurringRequests -port=80 |
Mostrar todas as tarefas recorrentes de um pedido. | lrcmd -cmd=showRecurringJobs -request=<nome do pedido> |
Utilize <nome do pedido> como o nome exclusivo do pedido
utilizado para identificar este pedido de envio de tarefa recorrente. Argumentos
opcionais:
|
Exemplos: lrcmd -cmd=showRecurringJobs -request=MyWeeklyReport -port=81lrcmd -cmd=status -jobid=<identificador da tarefa>-port=80 -host=myodrhost.comlrcmd -cmd=status -port=80-host=myodrhost.com |
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 |
Pára a execução de uma tarefa enviada anteriormente. | -cmd=stop [-jobid=<ida_da_tarefa> [-host=<host>] [-port=<port>] |
Esse comando pára 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:
|
Mostra as variáveis simbólicas utilizadas como referência no xJCL da definição de tarefa. | -cmd=getSymbolicVariables -xJCL=<xjcl_file> [-<host>] [-port=<porta>] |
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:
|
Salvar o log da tarefa. | -cmd=saveJobLog -jobid=<id_da_tarefa> [-host=<host>] [-fileName=<Nome_do_arquivo>] |
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. A seção Utilize -fileName=<Nome_do_arquivo> 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 será 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. | -cmd=getJobLog -jobid=<id_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 |
-cmd=getJobLog -jobid=<ida_da_tarefa> -logTimeStamp=<registro_de_data_e_hora_do_log> |
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:
|
Exibe os metadados do log da tarefa para o identificador da tarefa solicitado. | -cmd=getLogMetaData -jobid=<id_da_tarefa> |
Os metadados do log da tarefa indicam o(s) registro(s) de
data e hora associado(s) ao identificador da 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:
|
Exibe a lista de partes do log da tarefa. | -cmd=getLogPartList -jobid=<id_da_tarefa> -logTimeStamp=<logTimeStamp> |
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:
|
Exibe a parte do log da tarefa. | -cmd=getLogPart -jobid=<id_da_tarefa> -logTimeStamp=<registro_de_data_e_hora_do_log> -logPart=<parte_do_log> |
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. Utilize -logTimeStamp=<registro_de_data_e_hora_do_log> 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:
|
Exibe informações da(s) tarefa(s) associada(s) à classe de job solicitada. | -cmd=getJobsByClass -class=<classe> |
As informações retornadas contêm a estrutura de diretórios
da tarefa. Por exemplo,job_directory/time_stamp_directory
Por exemplo, MyApp_1/20102006_155529 Utilize -class=<classe> para indicar o nome da classe de tarefa cujos identificadores de tarefas devem ser retornados. |
Exemplos:
|
Exibe o tamanho do log da tarefa associado ao identificador da tarefa solicitado. | -cmd=getLogSize -jobid=<id_da_tarefa> -logTimeStamp=<registro_de_data_e_hora_do_log> |
Esse comando retorna o tamanho do log da tarefa em bytes. 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. Utilize -logTimeStamp=<registro_de_data_e_hora_do_log> para indicar o registro de data e hora, isto é, o nome do subdiretório, que identifica o log de tarefa cujas informações da lista devem ser retornadas. O registro de data e hora é retornado por -cmd=getLogMetaData. |
Exemplos:
|
O comando retorna a idade do arquivo de log em segundos desde que foi modificado pela última vez. | -cmd=getLogAge -jobid=<id_da_tarefa> -logTimeStamp=<logTimeStamp> |
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. Utilize -logTimeStamp=<registro_de_data_e_hora_do_log> para indicar o registro de data e hora, isto é, o nome do subdiretório, que identifica o log de tarefa cujas informações da lista 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
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