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 User Name Server).

Se você especificar um intermediário ou qualquer de seus recursos (grupo de execução ou message flow), 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 message flow 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
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
an07310_