Comando mqsichangetrace - z/OS

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

Sintaxe

Comando do Console do z/OS

Rastreio do Usuário

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

Rastreio de Serviço

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

Nós Rastrear

Formato do diagrama de sintaxe      Diagrama de trilha      Decimal com pontos

Parâmetros

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

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; opcional para rastreio de serviço)

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

Este nome faz distinção entre maiúsculas e minúsculas; você deve incluir nomes entre aspas se eles contiverem caracteres compostos por letras maiúsculas e minúsculas.

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

Este nome faz distinção entre maiúsculas e minúsculas; você deve incluir nomes entre aspas se eles contiverem caracteres compostos por letras maiúsculas e minúsculas.

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

-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 Rastrear

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:
F MQP1BRK,ct U=YES, E='default', L=NORMAL, C=5000
e no membro BIPRELG do PDSE, configure a opção para mqsireadlog para
-u -e default -f
Para coletar e processar um rastreio de serviço para o fluxo f1 no grupo de execução padrão, utilize o comando:
F MQP1BRK,ct T=YES, E='default', F='F1', M=FAST, L=DEBUG
e no membro BIPRELG do PDSE, configure a opção para mqsireadlog para
 -t -e default -f
Para coletar e processar um rastreio de serviço para um agente, utilize o comando:
F MQP1BRK,ct T=YES ,B=YES ,M=FAST ,L=DEBUG
e no membro BIPRELG do PDSE, configure a opção para mqsireadlog para
-t -b agent -f
Para desativar nós Rastrear para o grupo de execução padrão, use o comando:
F MQP1BRK,ct n='off',e='default'
Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:39:55


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | an28110_