É possível iniciar, modificar ou encerrar o rastreio de usuário para um intermediário ou iniciar, modificar ou encerrar o rastreio de serviço para um intermediário, um Configuration Manager ou o Servidor de Nome de Usuário (identificado pelo nome do componente). Não é possível utilizar esse comando para iniciar rastreio de serviço para o workbench.
Em plataformas Windows, em sistemas Linux e UNIX, você também pode iniciar e parar a atividade de rastreio para grupos de execução e fluxos de mensagens utilizando os recursos do workbench. Consulte a seção Rastreio do Usuário para obter informações adicionais.
No z/OS, também é possível iniciar, modificar ou parar um rastreio utilizando os comandos do console ou os recursos do workbench.
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.
A saída de rastreio gerada por esses comandos é gravada em arquivos de rastreio no subdiretório log. Quando tiver concluído o trabalho que deseja rastrear, utilize mqsireadlog para recuperar o registro como um arquivo de formato XML. Utilize mqsiformatlog (para produzir um arquivo formatado) ou um navegador XML para exibir os registros do XML.
Quando você ativa o rastreio, provoca um processamento adicional a ser executado para cada atividade no componente que está rastreando. Espere ver algum impacto no desempenho quando o rastreio estiver ativado.
Se quiser rastrear os processos de comando em si, configure as variáveis de ambiente MQSI_UTILITY_TRACE e MQSI_UTILITY_TRACESIZE antes de iniciar o rastreio.
Verifique se as variáveis foram reconfiguradas quando o rastreio do comando selecionado for concluído. Se isso não for feito, todos os comandos subseqüentes também serão rastreados e o desempenho será degradado.
As palavras-chave workbench e utility são reservadas
e não devem ser utilizadas como um nome de componente.
No z/OS, esse nome faz distinção entre maiúsculas e minúsculas e você deve delimitar os nomes com aspas simples se eles contiverem caracteres maiúsculos e minúsculos.
No z/OS, esse nome faz distinção entre maiúsculas e minúsculas e você deve delimitar os nomes com aspas simples se eles contiverem caracteres maiúsculos e minúsculos.
Essa opção somente é válida se você tiver especificado um grupo de execução (sinalizador -e).
Cada componente é criado com um valor padrão de none. Se esse parâmetro não for especificado, o valor atual não será alterado. Depois que esse valor é alterado com êxito, ele é persistente.
Isso é válido para todos os componentes.
Cada componente começa com um valor padrão de safe. Se esse parâmetro não for especificado, o valor atual não será alterado.
No HP-UX, é recomendável configurar esse valor abaixo de 500 MB.
Independente da forma como você pretenda recuperar o arquivo de rastreio, recomenda-se manter seu tamanho o menor possível, seja utilizando um valor baixo para esse parâmetro, seja utilizando a opção de zerar (-r) nesse comando para limpar o registro de rastreio. O benefício de adotar essa abordagem é que o processo de formatação (mqsiformatlog) é muito mais rápido e requer menos recursos para executar sua tarefa.
Se você alterar o tamanho do rastreio, o novo valor será persistente em um reinício do intermediário ou do Servidor de Nome de Usuário.
Utilize essas opções somente quando instruído a fazer isso pelo Centro de Suporte IBM ou por uma mensagem BIPxxxx.
Plataformas Windows e sistemas Linux e UNIX:
mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
mqsichangetrace WBRK_BROKER -u -e default -m fast
mqsichangetrace WBRK_BROKER -t -b -m -l normal
z/OS:
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000e no PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-u -e default
F MQP1BRK,ct u=yes,e='default',f='f1',m=faste no PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-t -e default -f f1-
F MQP1BRK,ct t=yes,b=yes,m=fast,l=debuge no PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-t -b agent