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 mqsichangetrace

Use o comando mqsichangetrace para configurar as características de rastreio de um broker.

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS - como um comando do console

Finalidade

Esse comando é válido para:
  • Rastreio de usuário. Especifique a opção -u.
  • Rastreio de serviço. Especifique a opção -t. Use essa opção somente se instruído a fazer isso pela ação descrita em uma mensagem BIPxxxx ou pelo Centro de Suporte IBM®.
  • Nós Trace. Especifique a opção -n para ativar ou desativar os nós Rastreio. É possível melhorar significativamente o desempenho de um fluxo desativando nós Trace.

É possível iniciar, modificar ou finalizar o rastreio do usuário (ou serviço) para um broker.

É possível ativar e desativar nós Trace para um broker, mas não é possível usar este comando para iniciar o rastreio de serviço para o WebSphere Message Broker Toolkit.

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. Se você quiser usar o comando mqsichangetrace para iniciar ou parar o rastreio do usuário, assegure-se de que o broker esteja em execução. Mas, para o rastreio de serviço, também é possível usar o comando mqsichangetrace para ativar ou desativar o rastreio quando o broker está em um estado de encerramento. Isso permite rastrear a inicialização dos componentes do broker.

A saída para o serviço e o rastreio do usuário gerado por esses comandos é escrita para rastrear os arquivos no subdiretório log. Quando você tiver concluído o trabalho que deseja rastrear, use o comando mqsireadlog para recuperar o log como um arquivo de formato XML. Use o comando mqsiformatlog (para produzir um arquivo formatado) ou um navegador XML para visualizar os registros XML.

Ao ativar o rastreio, você provoca um processamento adicional a ser executado para cada atividade no broker que está sendo rastreado. Espere que o desempenho seja afetado quando o rastreio estiver ativo.

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.

Você pode configurar MQSI_UTILITY_TRACE como normal ou debug, se quiser rastreio normal ou de depuração, e deve configurar MQSI_UTILITY_TRACESIZE como o tamanho máximo do arquivo de rastreio que você precisa em kilobytes (KB), o padrão sendo 102400 (100 MB).

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. Para obter mais informações sobre o MQSI_UTILITY_TRACE e MQSI_UTILITY_TRACESIZE, consulte Iniciando Rastreio de Serviço.

Você também pode iniciar e parar a atividade de rastreio para grupos de execução e fluxos de mensagens utilizando os recursos do WebSphere Message Broker Toolkit. Consulte a seção Rastreio do Usuário para obter informações adicionais.

Se você desejar visualizar as opções de rastreio que estão atualmente em efeito, use o comando mqsireporttrace.

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.
Selecione o link apropriado para obter detalhes desse comando na plataforma, ou plataformas, que a sua empresa utiliza:

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.
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 | an07260_