Comando mqsireadlog

Plataformas Suportadas

Finalidade

Utilize o comando para recuperar o log de rastreio para o componente especificado. Esse comando é válido para:
Rastreio do Usuário
Especifique a opção -u.
Rastreio de Serviço
Especifique a opção -t.Recomenda-se utilizar essa opção somente se instruído a fazer isso pela ação descrita em uma mensagem BIPxxxx ou pelo Centro de Suporte da IBM.

É possível especificar que a saída seja direcionada para um arquivo ou para stdout. Os registros de rastreio retornados por esse comando estão no formato XML e podem ser navegados com um navegador de XML. Se a saída for direcionada para um arquivo, os dados serão gravados na página de código utf-8. Portanto, o arquivo é independente de plataforma, e pode ser transferido para outros sistemas para navegação ou formatação utilizando o comando .

Se você transferir esse arquivo para outro sistema, 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).

Se você especificar um intermediário ou qualquer de seus recursos (grupo de execução ou ), deverá tê-los implementado antes que possa iniciar o rastreio e ler os arquivos de log.

Sintaxe

Rastreio do Usuário

Rastreio de Serviço

Parâmetros

componente
(Requerido) O nome do componente cujo log deve ser lido. Esse pode ser o nome de um intermediário ou os valores fixos ConfigMgr, UserNameServer, ou utility (todos fazem distinção entre maiúsculas e minúsculas em plataformas ).
-u
(Opcional) Ler o conteúdo do log a partir do log de rastreio de usuário. Isso é válido apenas se você selecionar o componente broker.
-e egroup
(Opcional) Especifique o rótulo do grupo de execução cujas informações de log devem ser lidas.
-o outputfilename
(Opcional) O nome do arquivo no qual os dados do log devem ser gravados. Se você especificar um nome de caminho completo, o arquivo será criado no diretório especificado. Se você especificar somente o nome do arquivo, este será criado no diretório de trabalho atual. O conteúdo do arquivo é gravado na página de códigos utf-8, que é independente de plataforma e preserva dados como caracteres DBCS.

É preciso especificar um nome de arquivo se você desejar formatar o log utilizando o comando . Se você não especificar um nome de arquivo, o conteúdo do log será gravado em stdout. Recomenda-se utilizar uma extensão de arquivo de .xml.

-f
(Opcional) Ler o arquivo de log diretamente do sistema de arquivo. Se essa opção não for especificada, o comando enviará uma mensagem XML ao componente para pedir o conteúdo do log. Se -t (rastreio de serviço) tiver sido especificado, esse sinalizador também deverá ser especificado. Detalhes adicionais são dados em Parâmetros Adicionais Exclusivos do Rastreio de Serviço.

Se essa opção for especificada, pare o rastreio (utilizando ) antes de utilizar o comando . Se o arquivo de log estiver em uso quando esse comando for emitido com esse sinalizador especificado, podem ser retornados registros XML parciais. Você pode reduzir o risco de isso acontecer especificando -m safe no comando . Se o próprio componente que está sendo rastreado tiver parado, não será preciso emitir um comando .

Se você não parar o rastreio antes de emitir esse comando, verifique o conteúdo do arquivo de log criado e remova quaisquer registros parciais do final utilizando um editor de texto antes de utilizar o comando , pois os registros parciais não podem ser lidos pelo comando de formatação.

Parâmetros Adicionais Exclusivos do Rastreio de Serviço

Utilize essas opções somente quando instruído a fazer isso pelo Centro de Suporte IBM ou por uma mensagem BIPxxxx.

-t
(Requerido) Ler o conteúdo do log a partir do log de rastreio de serviço.
-b qualifier
(Obrigatório) Leia o conteúdo do log do agente do intermediário, do agente do ou do agente do ou para o programa utilitário de comandos especificado. Essa opção será válida apenas se você tiver especificado -t (rastreio de serviço).

A seguinte tabela mostra as combinações válidas de qualifier e component para o rastreio de serviço.

Essa opção em geral é utilizada para rastrear os próprios comandos. Se desejar rastrear um determinado comando, execute esse comando com a variável de ambiente definida como debug ou normal antes de emitir o comando para ler a saída de rastreio gerada.

Digite esses valores exatamente como mostrado.

O rastreio de agente é iniciado quando se especifica o sinalizador -b no comando . Faça isso apenas quando instruído por uma mensagem de erro do ou pelo Centro de Suporte IBM.

-f
(Requerido) Ler o arquivo de log diretamente do sistema de arquivos. Quando utilizado com o rastreio de serviço, esse sinalizador tem as mesmas características que quando utilizado com o rastreio de usuário. Ele permanecerá opcional se o sinalizador -e for especificado. É preciso especificar essa opção se o sinalizador -b for especificado.
Qualificador Component= <broker_name> Component= ConfigMgr Component= UserNameServer Component= Component= utility
x        
  x      
x x x    
    x    
x        
x        
  x      
    x    
x        
  x      
    x    
1         x
  x      
2   x     x
mqpubsub x        
x x x   x
  x   x  
x x x    
x x x    
agent x x x    
      x  
Notes:
  1. Como esse comando não tem um parâmetro de componente, as informações de rastreio são gravadas e recuperadas dos arquivos de rastreio do componente utility. Para detalhes adicionais consulte Comando mqsichangetrace.
  2. Se esse comando tiver sido chamado sem um componente, as informações de rastreio serão gravadas e recuperadas dos arquivos de rastreio de utility além dos arquivos específicos do componente. Para detalhes adicionais consulte Comando mqsichangetrace.

Autorização

Em plataformas , o ID do usuário deve ser membro do grupo mqbrkrs. Se o sinalizador -f for especificado, o ID do usuário utilizado para chamar esse comando também deve ter acesso ao arquivo de rastreio.

Em plataformas , se o sinalizador -f for especificado, o ID do usuário utilizado para chamar esse comando deve ter acesso ao arquivo de rastreio. Se o sinalizador -f não for especificado, o ID do usuário utilizado para emitir o comando deverá ter autoridade mqbrkrs.

Respostas

  • BIP8020 Incapaz de acessar o banco de dados
  • BIP8029 Intermediário não configurado
  • BIP8032 Incapaz de conectar-se à fila
  • BIP8033 Incapaz de enviar mensagem XML
  • BIP8035 Resposta não recebida dentro do tempo limite
  • BIP8036 Resposta negativa recebida
  • BIP8037 Sinalizador não suportado selecionado
  • BIP8038 Opção de comando não suportada
  • BIP8039 Grupo de execução não disponível
  • BIP8040 Impossível conectar ao banco de dados
  • BIP8132 Qualificador inválido

Exemplos

Rastreio de usuário para o intermediário :


  -u -e default -o trace.xml

Rastreio de serviço para o componente ConfigMgr:

 ConfigMgr -t -b -f  -o trace.xml

Rastreio de serviço para o utilitário :


 utility -t -b -f  -o trace.xml

É possível formatar o arquivo de log (trace.xml nos exemplos acima) utilizando o comando , ou visualizá-lo utilizando um editor ou visualizador de XML.

Conceitos relacionados
Diagnóstico

Tarefas relacionadas
Utilizando Logs

Referências relacionadas
Preferência de Sintaxe
Comando mqsichangetrace
Comando mqsiformatlog
Comando mqsireporttrace