Comando mqsireporttrace

Plataformas Suportadas

  • Plataformas Windows 2000, Windows XP
  • UNIX
  • z/OS

Finalidade

Utilize o comando mqsireporttrace para exibir as opções de rastreio em efeito atualmente. Esse comando é válido para:
  • Rastreio de usuário. Especifique a opção -u.

    No z/OS, o rastreio de usuário é executado em relação a um grupo de execução específico para um intermediário. Você pode restringir ainda mais o comando para rastrear um fluxo de mensagens específico.

  • Rastreio de serviço. Especifique a opção -t. Utilize 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.

    No z/OS, o rastreio de serviço pode ser executado para um grupo de execução específico (como o rastreio de usuário). Diferentemente do rastreio de usuário, o rastreio de serviço também pode ser executado em relação a um agente ativo (ou seja, um intermediário ou Servidor de Nome de Usuário).

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 consultar as definições de rastreio.

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 intermediário para o qual as opções são relatadas ou o valor fixo UserNameServer. Ambos os valores fazem distinção entre maiúsculas e minúsculas em plataformas UNIX.
-u
(Requerido para rastreio de usuário) Derivar as informações do relatório do rastreio de usuário.
-e egroup
(Obrigatório para rastreio de usuário, caso contrário, opcional) O nível do grupo de execução para o qual um relatório é requerido. É válido somente se você tiver especificado um intermediário como o componente.

No z/OS, esse nome faz distinção entre maiúsculas e minúsculas. Delimite o nome com aspas se ele contiver caracteres maiúsculos e minúsculos.

-fmflow
(Opcional) O nível do fluxo de mensagens para o qual é requerido um relatório. É válido somente se você tiver especificado um intermediário como o componente e um grupo de execução.

No z/OS, esse nome faz distinção entre maiúsculas e minúsculas. Delimite o nome com aspas se ele contiver caracteres maiúsculos e minúsculos.

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
(Requerido para rastreio de serviço) Derivar as informações do relatório do rastreio de serviço.
-b
(Alternativa para -e em todas as plataformas) Pedir um relatório para a função de agente.

Autorização

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

Respostas

  • 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
  • BIP8032 Incapaz de conectar-se à fila (somente plataformas Windows e UNIX)
  • BIP8033 Incapaz de enviar mensagem XML
  • BIP8035 Resposta não recebida dentro do tempo limite
  • BIP8036 Resposta negativa recebida
  • BIP8037 Sinalizador não suportado selecionado
  • BIP8038 Opção de comando não suportada
  • BIP8039 Grupo de execução não disponível
  • BIP8040 Impossível conectar ao banco de dados
  • BIP8045 Fluxo de mensagens não disponível
  • BIP8158 Formato inválido para o comando (somente z/OS)
  • BIP8159 Parâmetro desconhecido "..." (somente z/OS)

Exemplos

Plataformas Windows e Plataformas UNIX:

mqsireporttrace BrokerA -t -e "exgrp1"
z/OS:
F MQP1BRK,reporttrace t=yes,e='exgrp1'

Tarefas relacionadas
Utilizando o Rastreio

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