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 examinador 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.

En HP-UX se recomienda que establezca el parámetro tamaño del mandato mqsichangetrace en un valor inferior a 500 MB. Tenga en cuenta que el tamaño de los archivos XML generados es a menudo un 50 por ciento superior al del archivo de rastreo original, y establecer el valor del parámetro tamaño en más de 500 MB puede ocasionar problemas.

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 , de un Gestor de configuración, o los valores fijos , ServidorNombresUsuario, entorno de trabajo o programa_utilidad (todos son sensibles a las mayúsculas y minúsculas en sistemas Linux y UNIX y en z/OS).
-u
(Opcional) Leer 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 para Rastreo de usuario; necesario para Rastreo de servicio). Leer el archivo de anotaciones directamente desde el 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 indicador. Encontrará información más detallada en 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 al emitir este mandato con este indicador, es posible que se devuelvan registros XML parciales. 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 por sí mismo, no necesitará 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 un 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) Leer el contenido de las anotaciones de las anotaciones de rastreo de servicio.
-b calificador
(Necesario) Leer el contenido de las anotaciones para el intermediario agente, Gestor de configuración agente o Servidor de nombres de usuario 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. Haga esto sólo cuando así se lo indique un mensaje de error de WebSphere Message Broker o el centro de soporte de IBM.

El rastreo de servicio (service) se inicia cuando se especifica el indicador -b en el mandato mqsichangetrace. El formato del mandato es:
mqsireadlog <nombreintermediario> -t -b service -f -o service.xml
Haga esto sólo cuando así se lo indique un mensaje de error de WebSphere Message Broker o el centro de soporte de IBM.
-f
(Necesario) Leer el archivo de anotaciones directamente desde el sistema 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= ServidorNombresUsuario Component= entorno 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
mqsilist x        
mqsilistaclentry         x
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
agent x x x    
servicio x x x    
entorno de trabajo       x  
httplistener x        
Notas:
  1. Puesto que este mandato no tiene un parámetro de componente, la información de rastreo se registra en, y se recupera de, los archivos de rastreo del componente programa de utilidad. Para más información, consulte el mandato mqsichangetrace.
  2. Si este mandato se invoca sin un componente, la información de rastreo se registra en, y se recupera de, los archivos de rastreo del programa de utilidad además de los archivos específicos del componente. Para más información, consulte el 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 -o trace.xml

Rastreo de servicio para el programa de utilidad mqsiformatlog:

mqsireadlog utility -t -b agent -f -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
Utilización de anotaciones
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an07300_