Mandato mqsireadlog

Plataformas soportadas

Finalidad

Utilice el mandato mqsireadlog para recuperar las anotaciones de rastreo para el componente especificado. Este mandato es válido para:
Rastreo de usuario
Especifique la opción -u.
Rastreo de servicio
Especifique la opción -t. Es aconsejable utilizar esta opción únicamente si así lo indica la acción descrita en un mensaje BIPxxxx o el centro de soporte de IBM.

Puede indicar que la salida se dirija a un archivo o a stdout. Los registros de rastreo devueltos por este mandato están en formato XML y pueden examinarse con un navegador XML. Si dirige la salida a un archivo, los datos se grabarán con la página de códigos utf-8. Por lo tanto, el archivo será independiente de la plataforma y podrá transferirse a otros sistemas para examinarlos o darles formato utilizando el mandato mqsiformatlog.

Si transfiere este archivo a otro sistema, asegúrese de que utiliza un programa de transferencia de archivos que no convierta los datos (por ejemplo, especificando una opción de transferencia binaria).

Si especifica un intermediario o cualquiera de sus recursos (grupo de ejecución o flujo de mensajes), ha de haberlos difundido antes para poder iniciar el rastreo y leer los archivos de anotaciones.

Sintaxis

Rastreo de usuario

Rastreo de servicio

Parámetros

component
(Necesario) Es el nombre del componente para el que han de leerse las anotaciones. Puede ser el nombre de un intermediario o los valores fijos ConfigMgr, UserNameServer, área de trabajo o utility (todos son sensibles a las mayúsculas y minúsculas en plataformas UNIX).
-u
(Opcional) Leer el contenido de las anotaciones desde las anotaciones de rastreo de usuario. Esto sólo es válido si selecciona el componente broker.
-e grupoejecución
(Opcional) La etiqueta del grupo de ejecución para el que va a leerse información de las anotaciones.
-o NombArchSalida
(Opcional) El nombre del archivo en el que se grabarán los datos de las anotaciones. Si especifica una vía de acceso completa, el archivo se creará en el directorio especificado. Si sólo especifica el nombre del archivo, éste se creará en el directorio de trabajo actual. El contenido del archivo se graba con la página de códigos utf-8, que es independiente de la plataforma y conserva datos como, por ejemplo, caracteres DBCS.

Ha de especificar un nombre de archivo si desea formatear las anotaciones usando el mandato mqsiformatlog. Si no especifica ningún nombre de archivo, el contenido de las anotaciones se graba en stdout. Es aconsejable utilizar la extensión de archivo .xml.

-f
(Opcional) Leer el archivo de anotaciones directamente del sistema de archivos. Si no especifica esta opción, el mandato envía un mensaje XML al componente para solicitar el contenido de las anotaciones. Si ha especificado -t (rastreo de servicio), también deberá especificar este distintivo. Encontrará información más detallada en el apartado Parámetros adicionales exclusivos del rastreo de servicio.

Si especifica esta opción, detenga el rastreo (utilizando mqsichangetrace) antes de utilizar el mandato mqsireadlog . Si el archivo de anotaciones está utilizándose cuando emita este mandato con este distintivo especificado, es posible que se devuelvan algunos registros XML. Puede reducir el riesgo de que esto suceda especificando -m safe en el mandato mqsichangetrace. Si el componente que se está rastreando se ha detenido solo, no es necesario que emita un mandato mqsichangetrace.

Si no detiene el rastreo antes de emitir este mandato, compruebe el contenido del archivo de anotaciones que se ha creado y elimine todos los registros parciales que haya, utilizando un editor de textos antes de emitir el mandato mqsiformatlog, ya que el mandato de formato no puede leer los registros parciales.

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) Leer el contenido de las anotaciones desde las anotaciones de rastreo de servicio.
-b calificador
(Necesario) Leer el contenido de las anotaciones para el agent del intermediario, el agent del Gestor de configuración o el agent del Servidor de nombres de usuarios, o para el programa de utilidad del mandato especificado. Esta opción sólo es válida si ha especificado -t (rastreo de servicio).

La siguiente tabla muestra las combinaciones válidas del qualifier y el component para el rastreo de servicio.

Normalmente, esta opción se utiliza para rastrear los mandatos propiamente dichos. Si desea rastrear un mandato determinado, ejecútelo con la variable de entorno MQSI_UTILITY_TRACE establecida en debug o normal antes de emitir este mandato para leer la salida del rastreo generada.

Entre estos valores exactamente tal como se indica.

El rastreo del agent se inicia cuando se especifica el distintivo -b en el mandato mqsichangetrace. Realice esta acción cuando se le indique mediante un mensaje de error de WebSphere Business Integration Event Broker o cuando el centro de soporte de IBM se lo pida.

-f
(Necesario) Leer el archivo de anotaciones directamente del sistema de archivos. Cuando se utiliza con el rastreo de servicio, este distintivo tiene las mismas características que cuando se utiliza con el rastreo de usuario. Sigue siendo opcional si se especifica el distintivo -e. Ha de especificar esta opción si especifica el distintivo -b.
Calificador Componente= <nombre_intermediario> Componente= GestConfig Componente= ServidorNombresUsuarios Componente= área de trabajo Componente= programa de utilidad
mqsichangebroker x        
mqsichangeconfigmgr   x      
mqsichangetrace x x x    
mqsichangeusernameserver     x    
mqsiclearmqpubsub x        
mqsicreatebroker x        
mqsicreateconfigmgr   x      
mqsicreateusernameserver     x    
mqsideletebroker x        
mqsideleteconfigmgr   x      
mqsideleteusernameserver     x    
mqsiformatlog1         x
mqsijoinmqpubsub   x      
mqsilist2   x     x
mqsilistmqpubsub x        
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
agent x x x    
área de trabajo       x  
Notes:
  1. Como este mandato no tiene ningún parámetro de componente, la información de rastreo se registra (y se recupera) en los archivos de rastreo del componente programa de utilidad. Si desea ver información más detallada consulte lo referente al Mandato mqsichangetrace.
  2. Si este mandato se invoca sin ningún componente, la información del rastreo se registra (y se recupera) en los archivos de rastreo del programa de utilidad además de en archivos específicos del componente. Si desea ver información más detallada consulte lo referente al Mandato mqsichangetrace.

Autorización

En plataformas UNIX, el ID de usuario ha de ser miembro del grupo mqbrkrs. Si se especifica el distintivo -f, el ID de usuario usado para invocar este mandato también ha de tener acceso al archivo de rastreo.

En plataformas Windows, si se especifica el distintivo -f, el ID de usuario empleado para invocar este mandato ha de tener acceso al archivo de rastreo. Si no se especifica el distintivo -f, el ID de usuario empleado para emitir el mandato ha de tener autorización de mqbrkrs.

Respuestas

  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 Intermediario no configurado
  • BIP8032 No se ha podido conectar con la cola
  • 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
  • BIP8132 Calificador no válido

Ejemplos

Rastreo de usuario para el intermediario WBRK_BROKER:


mqsireadlog
WBRK_BROKER -u -e default -o trace.xml

Servicio de rastreo para el componente ConfigMgr:


mqsireadlog ConfigMgr -t -b -f
mqsicreateconfigmgr -o trace.xml

Servicio de rastreo para el programa de utilidad mqsiformatlog:


mqsireadlog utility -t -b -f
mqsiformatlog -o trace.xml

Puede formatear el archivo de anotaciones (trace.xml en los ejemplos anteriores) utilizando el mandato mqsiformatlog, o verlo utilizando un editor o un visor XML.

Conceptos relacionados
Diagnósticos

Tareas relacionadas
Utilización de las anotaciones

Referencia relacionada
Preferencia de sintaxis
Mandato mqsichangetrace
Mandato mqsiformatlog
Mandato mqsireporttrace