WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

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.

Para habilitar el servicio de rastreo de las aplicaciones CMP, realice uno de los pasos siguientes:
  • Llame al método BrokerProxy.enableAdministrationAPITracing(Serie nombre_archivo).
  • Antes de ejecutar la aplicación CMP, establezca la variable de entorno MQSI_CMP_TRACE en el nombre del archivo al que se envía el rastreo.

Sintaxis

Rastreo de usuario

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsireadlog--Componente-- -u --+--------------+--+------+---->
                                  '- -e --GrupoE-'  '- -f -'   

>--+---------------------------+-------------------------------><
   '- -o --nombrearchivosalida-'   

Rastreo de servicio

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-mqsireadlog--Componente-- -t --+- -b --Calificador-+-- -f --->
                                  +- -e --GrupoE------+         
                                  '- -x --EgroupUuid--'         

>--+---------------------------+-------------------------------><
   '- -o --nombrearchivosalida-'   

Parámetros comunes al rastreo de usuario y rastreo de servicio

Componente
(Necesario) El nombre del intermediario para el que se va a leer el registro. Todos los nombres son sensibles a las mayúsculas y las minúsculas en Linux y sistemas UNIX.
-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ó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 dar formato a las anotaciones utilizando el mandato mqsiformatlog. Si no especifica un nombre de archivo, el contenido de las anotaciones se escriben en stdout. Utilice la extensión de archivo .xml, que representa el formato de los datos.

-f
(Opcional para Rastreo de usuario; necesario para Rastreo de servicio). Leer el archivo de registro 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 distintivo.

Si especifica esta opción, detenga el rastreo (utilizando el mandato mqsichangetrace) antes de ejecutar el mandato mqsireadlog. Si el archivo de registro está utilizándose al emitir este mandato con este distintivo, es posible que se devuelvan registros XML parciales. Especifique -m safe en el mandato mqsichangetrace para reducir el riesgo de registros parciales. 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 registro creado y elimine todos los registros parciales del final con un editor de texto antes de ejecutar el mandato mqsiformatlog, ya que el mandato de formateo no puede leer los registros parciales.

Parámetro adicional exclusivo del rastreo de usuario

-u
(Necesario) Leer el contenido del resgistro de rastreo de usuario. Esta opción sólo es válida si se selecciona el componente intermediario.

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 del registro de rastreo de servicio.
-b calificador
(Necesario) Leer el contenido de las anotaciones para el agente intermediario 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 distintivo -b en el mandato mqsichangetrace. Haga esto sólo cuando así se lo indique un mensaje de error de WebSphere Message Broker, o cuando se lo indique el centro de soporte de IBM.

El rastreo de servicio se inicia cuando se especifica el distintivo -b en el mandato mqsichangetrace. El formato del mandato es:
mqsireadlog nombreintermediario -t -b service -f -o service.xml
Ejecute este mandato sólo cuando se lo indique un mensaje de error de WebSphere Message Broker, o cuando se lo indique el centro de soporte de IBM.
-xEgroupUuid
(Opcional) Lea el contenido del registro para el grupo de ejecución UUID (Universally Unique Identifier).

Esta opción sólo es válida si se ha especificado -t (rastreo de servicio).

Utilice esta opción si la etiqueta del grupo de ejecución no está disponible. El UUID del grupo de ejecución se puede obtener del mensaje BIP2201I o BIP2208I que se escribe en las anotaciones del sistema cuando se inicia el grupo de ejecución.

El formato del mandato es:
mqsireadlog nombreintermediario -t
    -x ce40b73e-2701-0000-0080-85557ff4a8ad -f -o service.xml
Calificador Component= nombre_intermediario Component= WebSphere Message Broker Toolkit Component= programa de utilidad
mqsichangebroker x    
mqsichangeflowmonitoring x    
mqsichangeflowstats x    
mqsichangeflowuserexits x    
mqsichangeproperties x    
mqsichangetrace x    
mqsicreatebroker x    
mqsicreateconfigurableservice x    
mqsicvp x    
mqsideletebroker x    
mqsideleteconfigurableservice x    
mqsideploy x    
mqsiformatlog1     x
mqsimigratecomponents x    
mqsireadlog x   x
mqsireload x    
mqsireloadsecurity x    
mqsireportbroker x    
mqsireportflowmonitoring x    
mqsireportflowstats x    
mqsireportflowuserexits x    
mqsireportproperties x    
mqsireporttrace x    
mqsisetdbparms x    
mqsistart x    
mqsistop x    
agent x    
servicio x    
WebSphere Message Broker Toolkit   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.

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

Ejemplos

Recuperar el rastreo de usuario para el intermediario MB8BROKER:

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

Recuperar rastreo de servicio para el programa de utilidad mqsiformatlog:

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

Puede dar formato al archivo de registro (trace.xml en los ejemplos anteriores) utilizando el mandato mqsiformatlog, o verlo utilizando un editor o visor XML.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:06


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an07300_