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í se 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 registro.

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 --UuidgrupoE--'         

>--+---------------------------+-------------------------------><
   '- -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 registro.
-o nombrearchivosalida
(Opcional) El nombre del archivo en el que se van a grabar los datos de registro. 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 al registro utilizando el mandato mqsiformatlog. Si no especifica un nombre de archivo, el contenido del registro se escribe 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 del registro. 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 ejecutar el mandato mqsireadlog. Si el archivo de registro está utilizándose al emitir este mandato con este indicador, 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 de las anotaciones del registro cronológico 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 de las anotaciones del registro cronológico 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 indicador -b en el mandato mqsichangetrace. Do this only when directed to do so by a WebSphere Message Broker error message, or when instructed to do so by your IBM Support Center.

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
Run this command only when directed to do so by a WebSphere Message Broker error message, or when instructed to do so by your IBM Support Center.
-xUuidgrupoE
(Opcional) Leer el contenido del registro del UUID (Universally Unique Identifier) del grupo de ejecución.

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

Utilice esta opción cuando 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 el registro del mensaje 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, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-09-23 03:02:07


Tema de referenciaTema de referencia | Version 8.0.0.3 | an07300_