Comando mqsireporttrace

Plataformas Suportadas

  • Windows
  • Sistemas Linux e 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, 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 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 sistemas Linux e 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 Impossível conectar-se à fila (apenas plataformas Windows e sistemas Linux 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 sistemas Linux e UNIX:
mqsireporttrace BrokerA -t -e "exgrp1"
z/OS:
F MQP1BRK,reporttrace t=yes,e='exgrp1'
Tarefas relacionadas
Utilizando o Rastreio
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
an07310_