Mandato mqsireadlog

Utilice el mandato mqsireadlog para recuperar registros de rastreo para el componente especificado.

Plataformas soportadas

Finalidad

El mandato mqsireadlog es válido para:
Rastreo de usuario
Especifique la opción -u.
Rastreo de servicio
Especifique la opción -t. Se recomienda que utilice esta opción sólo si así lo indica 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. El archivo es, por lo tanto, independiente de la plataforma y puede transferirse a otros sistema para su consulta o formateo con el mandato mqsiformatlog.

En HP-UX, establezca que el parámetro size del mandato mqsichangetrace sea inferior a 500 MB porque 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 causar 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 comunes al rastreo de usuario y rastreo de servicio

Componente
(Necesario) El nombre del componente para el que se van a leer las anotaciones. Puede ser un nombre de intermediario o un nombre de Gestor de configuración, o los valores fijos ServidorNombresUsuario, entorno de trabajo o utility (todos son sensibles a las mayúsculas y minúsculas en sistemas Linux y UNIX y en z/OS).
-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 una vía de acceso completa, 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ódigos utf-8, que es independiente de la plataforma y que conserva datos como los caracteres DBCS.

Debe especificar un nombre de archivo si desea formatear las anotaciones utilizando el mandato mqsiformatlog. 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.

Si especifica esta opción, detenga el rastreo (utilizando el mandato 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 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.

Inicio del cambio

Parámetro adicional exclusivo del rastreo de usuario

-u
(Necesario) Leer el contenido de las anotaciones de las anotaciones de rastreo de usuario. Sólo es válido si se selecciona el componente intermediario.
Fin del cambio

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 y componente 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 cuando se especifica el indicador -b en el mandato mqsichangetrace. Haga esto sólo cuando así se lo indique un mensaje de error de WebSphere Event Broker o el centro de soporte de IBM.

El rastreo de servicio 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 Event Broker o el centro de soporte de IBM.
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 todas 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 ejecutar el mandato debe ser miembro del grupo mqbrkrs

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

Ejemplos

Recuperar el rastreo de usuario para el intermediario WBRK_BROKER:

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

Recuperar el rastreo de servicio para el componente ConfigMgr:

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

Recuperar 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) utilizando el mandato mqsiformatlog, o verlo utilizando un editor o visor XML.

Tareas relacionadas
Utilización de anotaciones
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Reservados todos los derechos.
Última actualización : 2009-02-16 14:31:09

an07300_