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 - Sistemas Windows, Linux e UNIX

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

Sintaxe

Rastreio do Usuário

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsichangetrace--brokerName-- -e --egName-- -u -------------->

>--+---------------+--+-------------------+--------------------->
   '- -c --tamanho-'  '- -f --messageFlow-'   

>--+----------------------+--+-------------+--+------------+---->
   '- -k -applicationName-'  '- -l --nível-'  '- -m --modo-'   

>--+------+--+------------------+------------------------------><
   '- -r -'  '- -y -libraryName-'   

Rastreio de Serviço

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsichangetrace--brokerName-- -t ---------------------------->

>--+- -b --------------------------------------------+---------->
   '- -e -- egName--+--------------------+--+------+-'   
                    '- -f -- messageFlow-'  '- -r -'     

>--+---------------+--+----------------------+------------------>
   '- -c --tamanho-'  '- -k -applicationName-'   

>--+-------------+--+------------+--+------------------+-------><
   '- -l --nível-'  '- -m --modo-'  '- -y -libraryName-'   

Nós Trace

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>-mqsichangetrace--brokerName-- -n --switch-- -e --egName------>

>--+-------------------+--+----------------------+-------------->
   '- -f --messageFlow-'  '- -k -applicationName-'   

>--+------------------+----------------------------------------><
   '- -y -libraryName-'   

Parâmetros

brokerName
(Obrigatório) Especifica o nome do broker que deseja rastrear. Todos os nomes fazem distinção entre maiúsculas e minúsculas no Linux e no UNIX.
-c size

(Opcional) O tamanho do arquivo de rastreio em KB (kilobytes). Se esse parâmetro não for especificado, o valor atual não será alterado.

Cada broker começa com um valor padrão de 102400 KB. Especifique essa opção para reconfigurar o valor. O valor máximo que você pode especificar depende de como você pretende ler subsequentemente o log, usando o comando mqsireadlog;
  • Se você utilizar esse comando com a opção -f configurada, o arquivo de log será lido diretamente do sistema de arquivo. Neste caso, o valor máximo que pode ser especificado é 2097151, que permite que um arquivo de rastreio de até 2 GB (gigabytes) seja criado.
  • Se você utilizar esse comando sem configurar a opção -f, uma mensagem do WebSphere MQ será enviada ao intermediário para recuperar o log. Neste caso, não permita que o arquivo de rastreio exceda 70 MB (megabytes). O valor máximo que pode ser configurado é 70000.

No HP-UX, configure o valor de tamanho abaixo de 500 MB.

Por qualquer meio que você pretende recuperar o arquivo de rastreio, talvez deseje manter seu tamanho pequeno, seja usando um valor baixo para este parâmetro, seja usando a opção de reconfiguração (-r) neste comando para limpar o log 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 esse valor, ele afetará o rastreio para o grupo de execução (se você tiver especificado um) ou para o componente do agente (se você não tiver especificado um grupo de execução).

-e egName
(Necessário para rastreio do usuário; necessário para rastreio de serviço se você não especificar o sinalizador -b)

Identifica o grupo de execução para o qual as opções de rastreio devem ser modificadas (por exemplo, iniciado ou parado).

-f messageFlow

(Opcional) Identifica o fluxo de mensagens para o qual as opções de rastreio devem ser modificadas. Essa opção é válida somente se você tiver especificado um grupo de execução (sinalizador -e).

-k applicationName
(Opcional) Esse parâmetro especifica o nome do aplicativo que contém o fluxo de mensagens para o qual as opções de rastreio devem ser modificadas.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens). Para alterar opções de rastreio de um fluxo de mensagens nomeado em um aplicativo específico, configure os parâmetros -k e -f.

É possível usar esse parâmetro com o parâmetro -y (nome da biblioteca) para especificar que o fluxo de mensagens está contido em uma biblioteca referenciada pelo aplicativo.

-l level
(Opcional) Definir o nível do rastreio. As seguintes opções são suportadas:
  • normal. Esta opção fornece um nível básico de informações de rastreio.
  • none. Esta opção desativa o rastreio.
  • debug. Esta opção fornece um rastreio mais abrangente.

Cada broker é criado com um valor padrão de none. Se esse parâmetro não for especificado, o valor atual não será alterado. Quando você tiver alterado com êxito este valor, ele será persistente.

-m mode
(Opcional) Indicar a maneira como as informações de rastreio devem ser colocadas em buffer:
  • safe. Esse modo faz com que as entradas de rastreio sejam gravadas no arquivo quando forem geradas.
  • fast. Este modo faz com que as entradas de rastreio sejam colocadas em buffer e gravadas no arquivo em lotes.
Cada broker começa com um valor padrão de safe. Se esse parâmetro não for especificado, o valor atual não será alterado.

Se você alterar esse valor, ele afetará o rastreio para o grupo de execução (se você tiver especificado um) ou para o componente do agente (se você não tiver especificado um grupo de execução).

-r

(Opcional) Essa opção pede que o registro de rastreio seja reconfigurado: ou seja, que todos os registros atuais sejam descartados. Utilize essa opção quando iniciar um novo rastreio para assegurar que todos os registros no registro serão exclusivos do novo rastreio.

Essa opção é válida somente se você tiver especificado um grupo de execução (sinalizador -e).

-u
(Necessário para rastreio do usuário)

Especifica que as opções de rastreio do usuário devem ser modificadas.

-y libraryName
(Opcional) Esse parâmetro especifica o nome da biblioteca que contém o fluxo de mensagens para o qual as opções de rastreio devem ser modificadas.

Ao configurar esse parâmetro, você também deve configurar o parâmetro -f (fluxo de mensagens). Para alterar opções de rastreio de um fluxo de mensagens nomeado em uma biblioteca específica, configure os parâmetros -y e -f.

Parâmetros Adicionais Exclusivos do Rastreio de Serviço

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

-b

(Necessário) Especifica que as opções de rastreio de serviço do subcomponente agente do broker especificado devem ser modificadas (por exemplo, iniciado ou parado). Você poderá especificar esse sinalizador somente se -t também for especificado.

É necessário especificar o sinalizador -b ou o sinalizador -e, mas não ambos.

-m mode
(Opcional) Além dos modos safe e fast disponíveis para rastreio do usuário, há um terceiro modo temp disponível apenas com o rastreio de serviço do grupo de execução:
  • temp. Esse modo é igual ao modo safe, mas o rastreio é alternado automaticamente quando o componente é reiniciado. Não será possível especificar um modo de temp se -f também for especificado.
-t

(Obrigatório) Especifica se as opções de rastreio de serviço devem ser modificadas.

Parâmetros Adicionais Exclusivos para Nós Trace

-n switch
(Obrigatório) Especifica o modo para o fluxo de rastreio. Os valores válidos são on e off.

Exemplos

Para coletar e processar um rastreio do usuário para o grupo de execução padrão, utilize o comando:
mqsichangetrace MB8BROKER -u -e default -l normal -c 5000
Para coletar e processar um rastreio de serviço para o fluxo f1 no grupo de execução padrão, utilize o comando:
mqsichangetrace MB8BROKER -t -e default -m fast
Para coletar e processar um rastreio de serviço para um agente, utilize o comando:
mqsichangetrace
MB8BROKER -t -b -m -l
normal
Para desativar nós Trace no grupo de execução padrão, use o comando:
mqsichangetrace MB8BROKER –n off -e default
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:10


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