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.
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.
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.
Utilice estas opciones sólo cuando se lo indique el centro de soporte de IBM o un mensaje BIPxxxx.
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.
mqsireadlog <nombreintermediario> -t -b service -f -o service.xmlHá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.
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 |
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.
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.