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. Se recomienda utilizar esta opción sólo si se le instruye que lo haga la acción descrita en un mensaje BIPxxxx o el centro de soporte de IBM.

Puede especificar 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 puede consultarse con un navegador XML. Si dirige la salida a un archivo, los datos se graban en la página de códigos utf-8. Por lo tanto el archivo es independiente de la plataforma y puede transferirse a otros sistema para su consulta o formateo con el mandato mqsiformatlog.

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

Si especifica un intermediario o alguno de sus recursos (grupo de ejecución o flujo de mensajes), se deben haber desplegado antes de empezar el rastreo y leer los archivos de anotaciones.

Sintaxis

Rastreo de usuario

Rastreo de servicio

Parámetros

componente
(Necesario) Nombre del componente para el que se van a leer las anotaciones. Puede ser el nombre de un intermediario o el nombre de un Gestor de configuración, o los valores fijos , ServidorNombresUsuarios, el área de trabajo o un programa de utilidad (todos son sensibles a las mayúsculas y minúsculas en sistemas Linux y UNIX).
-u
(Opcional) Lee el contenido de las anotaciones de las anotaciones de rastreo de usuario. Sólo es válido si se selecciona el componente intermediario.
-e grupoe
(Opcional) Etiqueta del grupo de ejecución para el que se va a leer la información de anotaciones.
-o nombrearchivosalida
(Opcional) El nombre del archivo en el que se van a grabar los datos de las anotaciones. Si especifica un nombre de vía de acceso completo, el archivo se crea en el directorio especificado. Si sólo especifica el nombre de archivo, el archivo se crea en el directorio de trabajo actual. El contenido del archivo se escribe en la página de códigosutf-8, que es independiente de la plataforma y que conserva datos como los caracteres DBCS.

Si desea formatear las anotaciones con el mandato mqsiformatlog, debe especificar un nombre de archivo. Si no especifica un nombre de archivo, el contenido de las anotaciones se escriben en stdout. Se recomienda utilizar la extensión de archivo .xml.

-f
(Opcional) Lee el archivo de anotaciones directamente del sistema de archivo. 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 indicador. Encontrará información más detallada en Parámetros adicionales exclusivos del rastreo de servicio.

Si especifica esta opción, detenga el rastreo (con mqsichangetrace) antes de utilizar el mandato mqsireadlog. Si el archivo de anotaciones está utilizándose al emitir este mandato con este indicador, es posible que se devuelvan registros XML parciales. Para reducir el riesgo de que esto suceda, especifique -m safe en el mandato mqsichangetrace. Si el componente del que se está efectuando el rastreo se ha detenido a sí mismo, no es necesario emitir un mandato mqsichangetrace.

Si no detiene el rastreo antes de emitir este mandato, compruebe el contenido del archivo de anotaciones creado y elimine todos los registros parciales a partir del final con el editor de texto antes de utilizar el mandato mqsiformatlog ya que el mandato de formateo no puede leer los registros parciales.

Parámetros adicionales exclusivos del rastreo de servicio

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

-t
(Necesario) Lee el contenido de las anotaciones de las anotaciones de rastreo de servicio.
-b calificador
(Necesario) Lee el contenido de las anotaciones para el intermediario agente, Gestor de configuración agente o Servidor de nombres de usuarios agente o para el programa de utilidad de mandato especificado. Esta opción sólo es válida si se ha especificado -t (rastreo de servicio).

En la siguiente tabla se muestran las combinaciones válidas de calificador ycomponente para el rastreo de servicio.

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

Especifique estos valores exactamente igual a como aparecen.

El rastreo de agente se inicia al especificar el indicador -b en el mandato mqsichangetrace. Hágalo sólo si se le instruye que lo haga un mensaje de error de WebSphere Event Broker o el centro de soporte de IBM.

El rastreo de servicio se inicia al especificar el indicador -b en el mandato mqsichangetrace. El formato del mandato es:
mqsireadlog <nombreintermediario> -t -b service -f -o service.xml
Hágalo sólo si se le instruye que lo haga un mensaje de error de WebSphere Event Broker o el centro de soporte de IBM.
-f
(Necesario) Lee el archivo de anotaciones directamente del sistemas de archivos. Cuando se utiliza con el rastreo de servicio, este indicador tiene las mismas características que cuando se utiliza con el rastreo de usuario. Si se especifica el indicador -e será opcional. Debe especificar esta opción si especifica el indicador -b.
Calificador Component= <nombre_intermediario Component= nombre_GestConfig Component= ServidorNombresUsuarios Component= área de trabajo Component= programa de utilidad
mqsichangebroker x        
mqsichangeconfigmgr   x      
mqsichangetrace x x x    
mqsichangeusernameserver     x    
mqsiclearmqpubsub x        
mqsicreateaclentry         x
mqsicreatebroker x        
mqsicreateconfigmgr   x      
mqsicreateusernameserver     x    
mqsideleteaclentry         x
mqsideletebroker x        
mqsideleteconfigmgr   x      
mqsideleteusernameserver     x    
mqsiformatlog1         x
mqsijoinmqpubsub   x      
mqsilist2   x     x
mqsilistmqpubsub x        
mqsilistaclentry         x
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
agente x x x    
servicio x x x    
área de trabajo       x  
Notas:
  1. Puesto que este mandato no tiene un parámetro de componente, la información de rastreo se registra y se recupera de los archivos de rastreo del componente programa de utilidad. Si desea ver más información, consulte Mandato mqsichangetrace.
  2. Si este mandato se invoca sin un componente, la información de rastreo se registra y se recupera de los archivos de rastreo del programa de utilidad además de los archivos específicos del componente. Si desea ver más información, consulte Mandato mqsichangetrace.

Autorización

En las plataformas UNIX, el ID de usuario debe ser un miembro del grupo mqbrkrs. Si se especifica el indicador -f, el ID de usuario utilizado para invocar este mandato también debe tener acceso al archivo de rastreo.

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

Respuestas

  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 El intermediario no está configurado
  • BIP8032 No se ha podido efectuar la conexión a la cola
  • BIP8033 No se ha podido enviar el mensaje XML
  • BIP8035 No se ha recibido una respuesta durante el tiempo de espera
  • BIP8036 Se ha recibido una respuesta negativa
  • BIP8037 Se ha seleccionado un indicador que no tiene soporte.
  • BIP8038 Opción de mandato no soportada
  • BIP8039 El grupo de ejecución no está disponible
  • BIP8040 No se ha podido efectuar la conexión 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

Rastreo de servicio para el componente GestConfig:

mqsireadlog GestConfig -t -b agent -f mqsicreateconfigmgr -o trace.xml

Rastreo de servicio para el programa de utilidad mqsiformatlog:

mqsireadlog programa de utilidad -t -b agent -f mqsiformatlog -o trace.xml

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

Tareas relacionadas
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2005 Última actualización: 07/11/2005
an07300_