É 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 mqsiformatlog.
No HP-UX, é recomendável configurar o parâmetro size do comando mqsichangetrace para menos de 500 MB. Observe que o tamanho dos arquivos XML gerados é freqüentemente metade do arquivo de rastreio original e configurar o valor do parâmetro size para mais de 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 intermediário 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.
É preciso especificar um nome de arquivo se você desejar formatar o registro utilizando o comando mqsiformatlog. Se você não especificar um nome de arquivo, o conteúdo do registro será gravado em stdout. Recomenda-se utilizar uma extensão de arquivo de .xml.
Se você especificar essa opção, pare o rastreio (utilizando mqsichangetrace) antes de utilizar 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. Você pode reduzir o risco de isso acontecer especificando -m safe no comando mqsichangetrace. 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 esse comando, verifique o conteúdo do arquivo de registro criado e remova quaisquer registros parciais do final utilizando um editor de texto antes de utilizar o comando mqsiformatlog, pois os registros parciais não podem ser lidos pelo comando de formatação.
Utilize essas opções somente quando instruído a fazer isso pelo Centro de Suporte IBM ou por uma mensagem BIPxxxx.
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 agente é iniciado quando se especifica o sinalizador -b no comando mqsichangetrace.Faça isso apenas quando instruído por uma mensagem de erro do WebSphere Message Broker ou pelo Centro de Suporte IBM.
mqsireadlog <nome_do_intermediário> -t -b service -f -o service.xmlFaça isso apenas quando instruído por uma mensagem de erro do WebSphere Message Broker ou pelo Centro de Suporte IBM.
Qualificador | Component= <nome_do_intermediário> | Component= ConfigMgr_name | Component= UserNameServer | Component= workbench | Component= utility |
---|---|---|---|---|---|
mqsichangebroker | x | ||||
mqsichangeconfigmgr | x | ||||
mqsichangetrace | x | x | x | ||
mqsichangeusernameserver | x | ||||
mqsiclearmqpubsub | x | ||||
mqsicreateaclentry | x | ||||
mqsicreatebroker | x | ||||
mqsicreateconfigmgr | x | ||||
mqsicreateusernameserver | x | ||||
mqsideleteaclentry | x | ||||
mqsideletebroker | x | ||||
mqsideleteconfigmgr | x | ||||
mqsideleteusernameserver | x | ||||
mqsiformatlog1 | x | ||||
mqsijoinmqpubsub | x | ||||
mqsilist2 | x | x | |||
mqsilist | x | ||||
mqsilistaclentry | x | ||||
mqsireadlog | x | x | x | x | |
mqsireporttrace | x | x | |||
mqsistart | x | x | x | ||
mqsistop | x | x | x | ||
agent | x | x | x | ||
serviço | x | x | x | ||
workbench | x | ||||
httplistener | x |
Em plataformas UNIX, 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 Windows, 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.
Rastreio de usuário para o intermediário WBRK_BROKER:
mqsireadlog WBRK_BROKER -u -e default -o trace.xml
Rastreio de serviço para o componente ConfigMgr:
mqsireadlog ConfigMgr -t -b agent -f -o trace.xml
Rastreio de serviço para o utilitário mqsiformatlog:
mqsireadlog utility -t -b agent -f -o trace.xml
É possível formatar o arquivo de registro (trace.xml nos exemplos acima) utilizando o comando mqsiformatlog, ou visualizá-lo utilizando um editor ou visualizador de XML.