Mandato mqsireporttrace

Plataformas soportadas

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

Finalidad

Utilice el mandato mqsireporttrace para visualizar las opciones de rastreo que están en vigor actualmente. Este mandato es válido para:
  • Rastreo de usuario. Especifique la opción -u.

    En z/OS, el rastreo de usuario se ejecuta para un grupo de ejecución específico de un intermediario. Puede restringir más este mandato para rastrear un flujo de mensajes específico.

  • Rastreo de servicio. Especifique la opción -t. Utilice esta opción únicamente si así lo indica la acción descrita en un mensaje BIPxxxx o el centro de soporte de IBM.

    En z/OS, el rastreo de servicio puede ejecutarse para un grupo de ejecución específico (como en el rastreo de usuario). A diferencia del rastreo de usuario, el rastreo de servicio también puede ejecutarse en un agente activo (es decir, un intermediario o un Servidor de nombres de usuarios).

Si especifica un intermediario o cualquiera de sus recursos (grupo de ejecución o flujo de mensajes), ha de haberlos difundido antes para poder consultar los valores del rastreo.

Sintaxis

Plataformas Windows y plataformas UNIX

Rastreo de usuario

Rastreo de servicio

z/OS

Rastreo de usuario

Rastreo de servicio

Parámetros

component
(Necesario) - Plataformas Windows y plataformas UNIX) El nombre del intermediario para el que se informa de las opciones o el valor fijo UserNameServer. Ambos valores son sensibles a las mayúsculas y minúsculas en plataformas UNIX.
-u
(Necesario para el rastreo de usuario) Deduce la información del informe del rastreo de usuario.
-e grupoejecución
(Necesario para el rastreo de usuario, de lo contrario, opcional) La etiqueta del grupo de ejecución para el que se requiere un informe. Esto sólo es válido si ha especificado un como componente.

En z/OS este nombre es sensible a las mayúsculas y minúsculas. Incluya el nombre entre comillas simples si contiene caracteres en mayúsculas y minúsculas.

-f flujom
(Opcional) la etiqueta del flujo de mensajes para el que se requiere un informe. Esto sólo es válido si ha especificado como componentes un intermediario y un grupo de ejecución.

En z/OS este nombre es sensible a las mayúsculas y minúsculas. Incluya el nombre entre comillas simples si contiene caracteres en mayúsculas y minúsculas.

Parámetros adicionales exclusivos del rastreo de servicio

Utilice estas opciones únicamente cuando se lo indique el centro de soporte de IBM o un mensaje BIPxxxx.

-t
(Necesario para el rastreo de servicio) Deduce la información del informe del rastreo de servicio.
-b
(Alternativa de -e en todas las plataformas) Solicitar un informe para la función agent.

Autorización

El ID de usuario utilizado para emitir el mandato ha tener autorización de mqbrkrs.

Respuestas

  • BIP8002 Los distintivos seleccionados son incompatibles (sólo z/OS)
  • BIP8003 Se ha detectado un distintivo duplicado (sólo z/OS)
  • BIP8013 El componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 Intermediario no configurado
  • BIP8032 No se ha podido conectar con la cola (sólo plataformas Windows y plataformas UNIX
  • BIP8033 No se ha podido enviar un mensaje XML
  • BIP8035 Respuesta no recibida dentro del tiempo de espera
  • BIP8036 Se ha recibido una respuesta negativa
  • BIP8037 Se ha seleccionado un distintivo no soportado
  • BIP8038 Opción de mandato no soportada
  • BIP8039 Grupo de ejecución no disponible
  • BIP8040 No se ha podido conectar con la base de datos
  • BIP8045 Flujo de mensajes no disponible
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 Parámetro desconocido "..." (sólo z/OS)

Ejemplos

Plataformas Windows y plataformas UNIX:

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

Tareas relacionadas
Utilización del rastreo

Referencia relacionada
Rastreo de usuario
Rastreo de servicio
Preferencia de sintaxis
Mandato mqsichangetrace
Mandato mqsiformatlog
Mandato mqsireadlog