Comando mqsichangetrace

Plataformas Suportadas

  • Plataformas Windows 2000, Windows XP
  • 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, o Configuration Manager ou o Servidor de Nome de Usuário (identificados por nome de componente). Não é possível utilizar esse comando para iniciar rastreio de serviço para o workbench.

Em plataformas Windows e UNIX, também é possível 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. Depois de concluir o trabalho que deseja rastrear, utilize mqsireadlog para recuperar o log 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 desejar rastrear os próprios executáveis de comandos, defina as variáveis de ambiente MQSI_UTILITY_TRACE e MQSI_UTILITY_TRACESIZE antes de iniciar seus 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 e plataformas 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 UNIX) O nome do componente para o qual os parâmetros de rastreio deverão ser alterados. Esse pode ser o nome de um intermediário ou os valores fixos ConfigMgr ou UserNameServer (todos fazem distinção entre maiúsculas e minúsculas em UNIX).
-u
(Opcional) Especifica que as opções de rastreio de usuário devem ser modificadas. Essa opção somente é válida se você tiver:
  • Especificado um nome do intermediário como o nome do componente em plataformas Windows e UNIX.
  • Emitido esse comando em relação a um intermediário (ou seja, não a um Servidor de Nome de Usuário) no z/OS.
.
-e egroup
(Opcional) 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.

-fmflow
(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 log 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 log 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 log posteriormente utilizando o comando mqsireadlog.
  • Se você utilizar mqsireadlog com a opção -f definida, o arquivo de log 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 log. 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 log de rastreio. O benefício de adotar esta abordagem é que o processo de formatação (mqsiformatlog) será muito mais rápido e exigirá menos recursos para realizar 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
(Opcional) Especifica que as opções de rastreio de serviço devem ser modificadas.
-b
(Opcional) Especifica que as opções de rastreio de serviço para o subcomponente do agente do componente especificado devem ser modificadas (por exemplo, iniciado ou parado). Esse sinalizador somente pode ser especificado se -t também for especificado.

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 Plataformas UNIX:

mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
mqsichangetrace WBRK_BROKER -u -e "exg1" -m fast
mqsichangetrace UserNameServer -t -b -l normal
z/OS:
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000

MODIFY MQP1BRK,changetrace u=yes,e='exg1',m=fast

F MQP1UNS,ct t=yes,b=yes,l=normal

Tarefas relacionadas
Utilizando o Rastreio

Referências relacionadas
Rastreio do Usuário
Rastreio de Serviço
Preferência de Sintaxe
Comando mqsiformatlog
Comando mqsireadlog
Comando mqsireporttrace