Comando mqsichangetrace

Plataformas Suportadas

  • Windows
  • Sistemas Linux e UNIX
  • z/OS

Finalidade

Utilize o comando mqsichangetrace para definir as características de rastreio para um componente. Esse comando é válido para:
  • Rastreio de usuário. Especifique a opção -u.
  • Rastreio de serviço. Especifique a opção -t. Recomenda-se utilizar essa opção somente se instruído a fazer isso pela ação descrita em uma mensagem BIPxxxx ou pelo Centro de Suporte da IBM.

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

Sintaxe

Plataformas Windows, Sistemas Linux e UNIX

Rastreio do Usuário

Rastreio de Serviço

z/OS

Rastreio do Usuário

Rastreio de Serviço

Parâmetros

componente
(Obrigatório - Plataformas Windows e sistemas Linux e UNIX) O nome do componente para o qual os parâmetros de rastreio devem ser alterados. Esse pode ser o nome de um intermediário, ou de um Gerenciador de Configuração ou o valor fixo UserNameServer (todos fazem distinção entre maiúsculas e minúsculas no UNIX e no Linux).

Início da mudançaAs palavras-chave workbench e utility são reservadas e não devem ser utilizadas como um nome de componente.Fim da mudança

-u
Início da mudança(Obrigatório para o rastreio do usuário somente se o componente for um intermediário) Especifica se as opções de rastreio do usuário devem ser modificadas. Essa opção somente é válida se você tiver:
  • Especificado um nome de intermediário como o nome do componente em plataformas Windows e sistemas Linux e UNIX.
  • Emitido esse comando em relação a um intermediário (ou seja, não um Configuration Manager ou Servidor de Nome de Usuário) no z/OS.
.Fim da mudança
-e egName
Início da mudança(Obrigatório para o rastreio do usuário; opcional para o 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). Essa opção não é válida para um intermediário.

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.

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

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.

-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 somente é válida se você tiver especificado um grupo de execução (sinalizador -e).

-l level
(Opcional) Definir o nível do rastreio. Esse deve ser um dos seguintes:
  • normal. Fornece um nível básico de informações de rastreio.
  • none. Desliga o rastreio.
  • debug. Fornece um rastreio mais abrangente.

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.

-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. Esse modo faz com que as entradas de rastreio sejam colocadas em buffer, e somente gravadas no arquivo em batches.

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.

Essa opção somente é válida se o componente especificado for:
  • Um intermediário. 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).
  • O Servidor de Nome de Usuário. Se você alterar esse valor, ele afetará o rastreio para o componente inteiro. (Isso é válido somente para o rastreio de serviço). Depois que esse valor é alterado com êxito, ele é persistente.
-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 componente começa com um valor padrão de 4096 KB. Especifique essa opção para reconfigurar o valor. O valor máximo que pode ser especificado depende de como você pretende ler o registro posteriormente utilizando o comando mqsireadlog.

No HP-UX, é recomendável configurar esse valor abaixo de 500 MB.

  • Se você utilizar mqsireadlog com a opção -f definida, o arquivo de registro será lido diretamente do sistema de arquivos. Nesse caso, o valor máximo que pode ser especificado aqui é 2097151, que permitirá a criação de um arquivo de rastreio de até 2 GB (gigabytes).
  • Se você utilizar mqsireadlog sem definir a opção -f, uma mensagem do WebSphere MQ será enviada ao intermediário para recuperar o registro. Nesse caso, o tamanho do arquivo de rastreio não deve exceder 70 MB (megabytes). O valor máximo que pode ser definido aqui não deve ser consideravelmente maior que 70000.

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.

Essa opção somente é válida se o componente especificado for:
  • Um intermediário. 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).
  • O Servidor de Nome de Usuário. Se você alterar esse valor, ele afetará o rastreio para o componente inteiro. (Isso é válido somente para o rastreio de serviço).

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.

Parâmetros Adicionais Exclusivos do Rastreio de Serviço

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

-t
Início da mudança(Obrigatório) Especifica se as opções de rastreio de serviço devem ser modificadas.Fim da mudança
-b
Início da mudança(Obrigatório) Especifica se as opções de rastreio de serviço para o subcomponente agent do componente especificado devem ser modificadas (por exemplo, iniciado ou parado). Esse sinalizador somente pode ser especificado se -t também for especificado.Fim da mudança

Autorização

O ID do usuário utilizado para emitir o comando deve ter autoridade mqbrkrs.

Respostas

Esse comando retorna as seguintes respostas:
  • BIP2595 Erro ao atribuir a cadeia de caracteres '...' a um inteiro (somente z/OS)
  • BIP8002 Sinalizadores selecionados incompatíveis (somente z/OS)
  • BIP8003 Sinalizador duplicado detectado (somente z/OS)
  • BIP8013 O componente não existe
  • BIP8020 Incapaz de acessar o banco de dados
  • BIP8029 Intermediário não configurado
  • BIP8031 Sinalizador inválido fornecido
  • BIP8032 Incapaz de conectar-se à fila
  • BIP8033 Falha no envio de mensagem
  • BIP8035 Resposta não recebida antes do tempo limite
  • BIP8036 Resposta negativa recebida
  • BIP8037 Sinalizador não suportado
  • BIP8039 Grupo de execução não disponível
  • BIP8040 Impossível conectar ao banco de dados
  • BIP8045 Fluxo de mensagens não encontrado
  • BIP8068 Argumento inteiro requerido
  • BIP8158 Formato inválido para o comando (somente z/OS)
  • BIP8159 Parâmetro desconhecido "..." (somente z/OS)

Exemplos

Plataformas Windows e sistemas Linux e UNIX:

Para coletar e processar um rastreio do usuário para o grupo de execução padrão, utilize o comando:
mqsichangetrace WBRK_BROKER -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
WBRK_BROKER -u -e
default -m fast
Para coletar e processar um rastreio de serviço para um agente, utilize o comando:
mqsichangetrace
WBRK_BROKER -t -b -m -l
normal

z/OS:

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 PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-u -e default
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 u=yes,e='default',f='f1',m=fast
e no PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-t -e default -f f1-
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 PDSE membro BIPJLOG, configure a opção para mqsireadlog para
-t -b agent
Tarefas relacionadas
Utilizando o Rastreio
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07260_