Comando mqsiformatlog

Plataformas Suportadas

Finalidade

Utilize o comando mqsiformatlog para processar o registro XML criado por mqsireadlog. O comando recupera e formata as mensagens contidas no registro XML em um formato adequado para o código do idioma do usuário que chamou o comando.

Esse comando interpreta um arquivo de registro de entrada que foi criado em qualquer sistema em uma página de código independente de plataforma, utf-8. Ele pode ser utilizado para produzir saída formatada a partir de arquivos de registro de entrada transferidos de outros sistemas para o sistema no qual o comando é emitido. Se você utilizar esse recurso, utilize um programa de transferência de arquivos que não converta os dados (por exemplo, especificando uma opção de transferência binária).

Você pode direcionar a saída para um arquivo ou para o shell de comandos.

Sintaxe

Parâmetros

-i inputfilename
(Requerido) O nome do arquivo de registro XML que deve ser formatado. Esse arquivo é criado pelo comando mqsireadlog. Ele é codificado em utf-8.
-o outputfilename
(Opcional) O nome do arquivo no qual a saída formatada do registro deve ser gravada. Se não for especificado, os dados de registro formatados serão gravados em stdout.

A saída gravada por esse comando (em arquivo ou stdout) é gravada em uma página de código adequada ao código do idioma do usuário atual.

Autorização

O ID do usuário utilizado para chamar esse comando deve ter acesso de leitura ao arquivo de entrada e acesso de gravação ao arquivo de saída.

Em sistemas Linux e UNIX, o ID do usuário deve ser um membro do grupo mqbrkrs.

Respostas

  • BIP8041 Incapaz de abrir o arquivo
  • BIP8042 Memória insuficiente
  • BIP8043 Arquivo de rastreio inválido
  • BIP8046 Incapaz de inicializar XML
  • BIP8047 Incapaz de analisar os dados
  • BIP8069 Incapaz de localizar a mensagem
  • BIP8079 Incapaz de localizar a função XML
  • BIP8080 Incapaz de carregar o recurso
  • BIP8081 Erro ao processar o comando

Exemplos

mqsiformatlog -i trace.xml -o formattrace.log

O trecho a seguir ilustra a saída gerada por esse comando:

As datas e horas são
formatadas no horário local, o horário local é GMT.
.
.
.
2003-02-12 12:57:21.895999    388  UserTrace   BIP2638E:
MQPUT para a fila 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' no gerenciador
de filas
'WBRK_QM': MQCC=0, MQRC=0; nó
ConfigurationMessageFlow.outputNode'. O nó 'ConfigurationMessageFlow.outputNode' tentou
gravar uma mensagem na fila especificada
'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
conectada ao gerenciador de filas 'WBRK_QM'. O MQCC foi 0 e o MQRC foi 0.
Nenhuma ação do usuário é necessária.

2003-02-12 12:57:21.895999    388  UserTrace   BIP2622I:
Saída de mensagem com êxito pelo nó output
'ConfigurationMessageFlow.outputNode'
para a fila 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY' no gerenciador de
filas
'WBRK_QM'. O nó output ConfigurationMessageFlow.outputNode' do WebSphere MQ
gravou com êxito uma mensagem de saída na fila especificada
SYSTEM.BROKER.EXECUTIONGROUP.REPLY conectada ao gerenciador de filas
WBRK_QM. Nenhuma ação do usuário é necessária.
.
.
.
Encadeamentos encontrados neste rastreio:  335  388
Tarefas relacionadas
Utilizando Registros
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07270_