Comando mqsichangetrace

Plataformas Suportadas

  • Plataformas 2000, XP
  • z/OS

Finalidade

Utilize o comando 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 ou o (identificados por nome de componente). Não é possível utilizar esse comando para iniciar rastreio de serviço para o .

Em plataformas e , também é possível iniciar e parar a atividade de rastreio para grupos de execução e utilizando os recursos do . 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 .

Se você especificar um intermediário ou qualquer de seus recursos (grupo de execução ou ), 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 para recuperar o log como um arquivo de formato XML. Utilize (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 e 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 e ) 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 ).
-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 e .
  • Emitido esse comando em relação a um intermediário (ou seja, não a um ) 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 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 . 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 .
  • Se você utilizar 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 sem definir a opção -f, uma mensagem do 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 () 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 . 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 .

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

  -u -e default -l normal -c 5000
  -u -e "exg1" -m fast
 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