WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Comando mqsireadlog

Utilize o comando mqsireadlog para recuperar registros de rastreio para o componente especificado.

Plataformas Suportadas

Finalidade

O comando mqsireadlog é válido para:
Rastreio do Usuário
Especifique a opção -u.
Rastreio de Serviço
Especifique a opção -t. Recomenda-se usar essa opção somente se instruído a fazer isso pela ação descrita em uma mensagem BIPxxxx ou pelo Centro de Suporte IBM®.

É possível especificar a saída que será direcionada para o 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 mqsiformatlog.

No HP-UX, configure o parâmetro tamanho do comando mqsichangetrace para que ele tenha menos do que 500 MB, pois o tamanho dos arquivos gerados pelo XML geralmente é no máximo a metade do arquivo de rastreio original e configurar o valor do parâmetro tamanho para que seja maior do que 500 MB pode causar problemas.

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 broker ou qualquer de seus recursos (grupo de execução ou fluxo de mensagens), deverá tê-los implementado antes que possa iniciar o rastreio e ler os arquivos de registro.

Para ativar o rastreio de serviço de seus aplicativos CMP, execute uma das etapas a seguir:
  • Chame o método BrokerProxy.enableAdministrationAPITracing(String filename).
  • Antes de executar o aplicativo CMP, defina a variável de ambiente MQSI_CMP_TRACE para o nome do arquivo para o qual o rastreio é enviado.

Sintaxe

Rastreio do Usuário

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsireadlog--Componente-- -u --+--------------+--+------+---->
                                  '- -e --Egroup-'  '- -f -'   

>--+----------------------+------------------------------------><
   '- -o --Outputfilename-'   

Rastreio de Serviço

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsireadlog--Componente-- -t --+- -b --Qualificador-+-------->
                                  +- -e --Egroup-------+   
                                  '- -x --EgroupUuid---'   

>-- -f --+----------------------+------------------------------><
         '- -o --Outputfilename-'   

Parâmetros comuns para rastreio do usuário e rastreio de serviço

Componente
(Obrigatório) O nome do broker para o qual o log deve ser lido. Todos os nomes fazem distinção entre maiúsculas e minúsculas no Linux e no UNIX.
-e Egroup
(Opcional) Especifique o rótulo do grupo de execução cujas informações de registro devem ser lidas.
-o Outputfilename
(Opcional) O nome do arquivo no qual os dados do registro devem ser gravados. Se você especificar um nome do 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.

É necessário especificar um nome do arquivo se você desejar formatar o log usando o comando mqsiformatlog. Se você não especificar um nome de arquivo, o conteúdo do registro será gravado em stdout. Use uma extensão do arquivo igual a .xml, que representa o formato dos dados.

-f
(Opcional para Rastreio de Usuário; obrigatório para Rastreio de Serviço). Ler o arquivo de registro diretamente do sistema de arquivos. Se essa opção não for especificada, o comando enviará uma mensagem XML ao componente para pedir o conteúdo do registro. Se -t (rastreio de serviço) tiver sido especificado, esse sinalizador também deverá ser especificado.

Se você especificar esta opção, pare o rastreio (usando mqsichangetrace) antes de executar o comando mqsireadlog. Se o arquivo de registro estiver em uso quando esse comando for emitido com esse sinalizador especificado, podem ser retornados registros XML parciais. Especifique -m safe no comando mqsichangetrace para reduzir o risco de registros parciais. Se o próprio componente que está sendo rastreado tiver parado, não será preciso emitir um comando mqsichangetrace.

Se você não parar o rastreio antes de emitir este comando, verifique o conteúdo do arquivo de log criado e remova qualquer registro parcial do final usando um editor de texto antes de executar o comando mqsiformatlog, pois os registros parciais não podem ser lidos pelo comando de formatação.

Parâmetro adicional exclusivo para rastreio do usuário

-u
(Necessário) Ler o conteúdo do log do log de rastreio do usuário. Esta opção é válida somente se você selecionar o componente intermediário.

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 registro a partir do registro de rastreio de serviço.
-b Qualificador
(Necessário) Leia o conteúdo do log do agente do broker, ou do programa utilitário do comando 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 MQSI_UTILITY_TRACE 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 agent é iniciado quando você especifica o sinalizador -b no comando mqsichangetrace. Faça isso apenas quando direcionado por uma mensagem de erro do WebSphere Message Broker ou quando instruído peloIBM Support Center.

O rastreio de service é iniciado quando você especifica o sinalizador -b no comando mqsichangetrace. O formato do comando é:
mqsireadlog brokername -t -b service -f -o service.xml
Execute esse comando apenas quando direcionado por uma mensagem de erro do WebSphere Message Broker ou quando instruído peloIBM Support Center.
-xEgroupUuid
(Opcional) Leia o conteúdo do log para o grupo de execução UUID (Identificador Exclusivo Universal).

Essa opção será válida apenas se você tiver especificado -t (rastreio de serviço).

Use esta opção quando o rótulo do grupo de execução não estiver disponível. O grupo de execução UUID pode ser obtido a partir da mensagem BIP2201I ou BIP2208I que é gravada no log do sistema quando o grupo de execução é inicializado.

O formato do comando é:
mqsireadlog brokername -t 
    -x ce40b73e-2701-0000-0080-85557ff4a8ad -f -o service.xml
Qualificador Component= nome_do_intermediário Component= WebSphere Message Broker Toolkit Component= utility
mqsichangebroker x    
mqsichangeflowmonitoring x    
mqsichangeflowstats x    
mqsichangeflowuserexits x    
mqsichangeproperties x    
mqsichangetrace x    
mqsicreatebroker x    
mqsicreateconfigurableservice x    
mqsicvp x    
mqsideletebroker x    
mqsideleteconfigurableservice x    
mqsideploy x    
mqsiformatlog1     x
mqsimigratecomponents x    
mqsireadlog x   x
mqsireload x    
mqsireloadsecurity x    
mqsireportbroker x    
mqsireportflowmonitoring x    
mqsireportflowstats x    
mqsireportflowuserexits x    
mqsireportproperties x    
mqsireporttrace x    
mqsisetdbparms x    
mqsistart x    
mqsistop x    
agent x    
serviço x    
WebSphere Message Broker Toolkit   x  
httplistener x    
Notas:
  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 obter detalhes adicionais, consulte o comando mqsichangetrace.

Autorização

Para obter informações sobre autorizações específicas da plataforma, consulte os tópicos a seguir: Se você tiver ativado a segurança de administração do broker, também deverá configurar a autoridade detalhada em Tarefas e Autorizações para Segurança de Administração.

Exemplos

Recupere o rastreio do usuário para o intermediário MB8BROKER:

mqsireadlog MB8BROKER -u -e default -o trace.xml

Recupere o rastreio de serviço para o utilitário mqsiformatlog:

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

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

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:05


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | an07300_