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 mqsichangetrace

Utilice el mandato mqsichangetrace para establecer las características de rastreo para un intermediario.

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX
  • z/OS - como mandato de consola

Finalidad

Este mandato es válido para:
  • Rastreo de usuario. Especifique la opción -u.
  • Rastreo de servicio. Especifique la opción -t. Utilice esta opción sólo si se le instruye que lo haga la acción descrita en un mensaje BIPxxxx o el centro de soporte de IBM®.
  • Nodos de Trace. Especifique la opción -n para activar o desactivar los nodos de rastreo. Puede mejorar de forma significativa el rendimiento de un flujo desactivando los nodos de Trace.

Puede iniciar, modificar o finalizar el rastreo de usuarios (o servicio) para un intermediario.

Puede activar y desactivar los nodos de Trace para un intermediario, pero no puede utilizar este mandato para iniciar el rastreo de servicio para el WebSphere Message Broker Toolkit.

Si especifica un intermediario o alguno de sus recursos (grupo de ejecución o flujo de mensajes), debe haberlos desplegado antes de empezar el rastreo. Si desea utilizar el mandato mqsichangetrace para iniciar o detener el rastreo de usuarios, debe asegurarse de que el intermediario esté en funcionamiento. Pero para el rastreo de servicios, también puede utilizar el mandato mqsichangetrace para habilitar o inhabilitar el rastreo cuando el intermediario se encuentra en un estado apagado. Esto le permite rastrear el inicio de los componente de intermediario.

La salida del rastreo de servicio y usuario generado por estos mandatos se graba en archivos de rastreo en el subdirectorio log. Cuando haya llevado a cabo el trabajo que desea rastrear, utilice el mandato mqsireadlog para recuperar las anotaciones como un archivo de formato XML. Utilice el mandato mqsiformatlog (para generar un archivo con formato) o un navegador XML para ver los registros XML.

Al activar el rastreo, se genera un proceso adicional que debe ejecutarse para cada actividad del intermediario que se rastrea. Se prevé que el rendimiento se vea afectado cuando el rastreo está activo.

Si desea rastrear los propios procesos de mandato, establezca las variables de entorno MQSI_UTILITY_TRACE y MQSI_UTILITY_TRACESIZE antes de iniciar el rastreo.

Puede establecer MQSI_UTILITY_TRACE en normal o depurar, en función de si desea un rastreo normal o de depuración, y debe establecer MQSI_UTILITY_TRACESIZE en el tamaño máximo del archivo de rastreo que necesite en kilobytes (KB); el valor predeterminado es 102400 (100MB).

Asegúrese de restablecer estas variables cuando haya finalizado el rastreo para el mandato seleccionado. Si no lo hace, también se efectúa el rastreo de todos los mandatos subsiguientes y disminuye su rendimiento. Para obtener más información sobre MQSI_UTILITY_TRACE y MQSI_UTILITY_TRACESIZE, consulte Inicio del rastreo de servicio.

También puede iniciar y detener la actividad de rastreo para grupos de ejecución y flujos de mensajes utilizando los recursos del WebSphere Message Broker Toolkit. Para obtener más información, consulte Rastreo de usuario.

Si desea ver las opciones de rastreo que están actualmente en vigor, utilice el mandato mqsireporttrace.

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.
Seleccione el enlace adecuado para obtener información detallada de este mandato en la plataforma, o plataformas, que su empresa utiliza:

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.
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:05


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