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.
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 (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.
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. Haga esto sólo cuando así se lo indique un mensaje de error de WebSphere Message Broker o el centro de soporte de IBM.
mqsireadlog <nombreintermediario> -t -b service -f -o service.xmlHaga esto sólo cuando así se lo indique un mensaje de error de WebSphere Message 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 |
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 -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.