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 - z/OS

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

Sintaxis

Mandato de consola z/OS

Rastreo de usuario

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-+-changetrace-+--, e=NombreGe--u=yes--+------------+--------->
   '- ct --------'                       '-, c=Tamaño-'   

>--+-------------------+--+----------------------+-------------->
   '-, f=FlujoMensajes-'  '-, k=nombreAplicación-'   

>--+-----------+--+---------------+--+--------+----------------->
   '-, l=Nivel-'  '-, m=Modalidad-'  '-, r=sí-'   

>--+----------------------+------------------------------------><
   '-, y=nombreBiblioteca-'   

Rastreo de servicio

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-+-changetrace-+--t=yes--------------------------------------->
   '-ct----------'          

>--+-, b=sí------------------------------------------+---------->
   '-, e=NombreGe--+-------------------+--+--------+-'   
                   '-, f=FlujoMensajes-'  '-, r=sí-'     

>--+------------+--+----------------------+--+-----------+------>
   '-, c=Tamaño-'  '-, k=nombreAplicación-'  '-, l=Nivel-'   

>--+---------------+--+----------------------+-----------------><
   '-, m=Modalidad-'  '-, y=nombreBiblioteca-'   

Nodos Trace

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
>>-+-changetrace-+--n=Conmutador--, e=NombreGe------------------>
   '- ct --------'                               

>--+-------------------+--+----------------------+-------------->
   '-, f=FlujoMensajes-'  '-, k=nombreAplicación-'   

>--+----------------------+------------------------------------><
   '-, y=nombreBiblioteca-'   

Parámetros

-c tamaño

(Opcional) El tamaño del archivo de rastreo en KB (kilobytes). Si no especifica este parámetro, el valor actual no cambia.

Cada intermediario se inicia con un valor predeterminado de 102400 KB. Especifique esta opción para restablecer el valor. El valor máximo que puede especificar depende de cómo tenga pensado leer posteriormente las anotaciones cronológicas con el mandato mqsireadlog;
  • Si utiliza este mandato con la opción -f establecida, archivo de registro se lee directamente del sistema de archivos. En este caso, el valor máximo que puede especificar es 2097151, que permite crear un archivo de rastreo de hasta 2 GB (gigabytes).
  • Si utiliza este mandato sin establecer la opción -f, se envía un mensaje de WebSphere MQ al intermediario para que recupere las anotaciones. En este caso, no permita que el tamaño del archivo de rastreo exceda de 70 MB (megabytes). El valor máximo que puede establecer es 70000.

Sea cual sea la manera en que piense recuperar el archivo de rastreo, tal vez desee mantenerlo con un tamaño pequeño, ya sea utilizando un valor bajo para este parámetro o utilizando la opción restablecer (-r) de este mandato para borrar el contenido del registro de rastreo. La ventaja de adoptar este método es que el proceso de formato (mqsiformatlog) es mucho más rápido y requiere menos recursos para llevar a cabo su tarea.

Si cambia este valor, esto afectará al rastreo del grupo de ejecución (si ha especificado uno) o del componente de agente (si no ha especificado un grupo de ejecución).

-e nombreGe
(Necesario para rastreo de usuario; opcional para rastreo de servicio)

Identifica el grupo de ejecución para el que se van a modificar las opciones de rastreo (por ejemplo, iniciado o detenido).

Este nombre es sensible a las mayúsculas y minúsculas; debe incluir los nombres entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

-f flujoMensajes

(Opcional) Identifica el flujo de mensajes para el que se van a modificar las opciones de rastreo. Esta opción sólo es válida si ha especificado un grupo de ejecución (indicador -e).

Este nombre es sensible a las mayúsculas y minúsculas; debe incluir los nombres entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

-k nombreAplicación
(Opcional) Este parámetro especifica el nombre de la aplicación que contiene el flujo de mensajes para el que se van a modificar las opciones de rastreo.

Cuando establece este parámetro, también debe establecer el parámetro -f (flujo de mensajes). Para cambiar las opciones de rastreo para un flujo de mensajes designado en una aplicación específica, establezca los parámetros -k y -f.

Puede utilizar este parámetro con el parámetro -y (nombre de biblioteca) para especificar que el flujo de mensajes se incluya en una biblioteca referenciada por la aplicación.

-l nivel
(Opcional) Establezca el nivel del rastreo. Se soportan las opciones siguientes:
  • normal. Esta opción proporciona un nivel básico de información de rastreo.
  • none. Esta opción desactiva el rastreo.
  • debug. Esta opción proporciona un rastreo más completo.

Cada intermediario se crea con un valor predeterminado none. Si no especifica este parámetro, el valor actual no cambia. Cuando haya cambiado correctamente este valor, es permanente.

-m modalidad
(Opcional) Indique la forma en que se va a almacenar en el almacenamiento intermedio la información de rastreo.
  • safe. Esta modalidad hace que las entradas de rastreo se escriban en el archivo cuando se generan.
  • fast. Esta modalidad hace que las entradas se almacenen en el almacenamiento intermedio y se escriban en el archivo en lotes.
Cada intermediario se inicia con un valor predeterminado safe. Si no especifica este parámetro, permanece el valor actual.

Si cambia este valor, esto afectará al rastreo del grupo de ejecución (si ha especificado uno) o del componente de agente (si no ha especificado un grupo de ejecución).

-r

(Opcional) Esta opción indica que se restablezca el registro de rastreo; es decir, que se descarten todos los registros actuales. Utilice esta opción cuando inicie un nuevo rastreo para asegurarse de que todos los registros existentes en las anotaciones sean exclusivos para el nuevo rastreo.

Esta opción sólo es válida si ha especificado un grupo de ejecución (indicador -e).

-u
(Necesario para rastreo de usuario)

Especifica que se van a modificar opciones de rastreo de usuario.

-y nombreBiblioteca
(Opcional) Este parámetro especifica el nombre de la biblioteca que contiene el flujo de mensajes para el que se van a modificar las opciones de rastreo.

Cuando establece este parámetro, también debe establecer el parámetro -f (flujo de mensajes). Para cambiar las opciones de rastreo para un flujo de mensajes designado en una biblioteca específica, establezca los parámetros -y y -f.

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.

-b

(Necesario) Especifica que se van a modificar las opciones de rastreo de servicio para el subcomponente agent del intermediario especificado (por ejemplo, iniciado o detenido). Puede especificar este indicador sólo si también se especifica -t.

-m modalidad
(Opcional) Además de las modalidades disponibles safe y fast para el rastreo de usuario, hay una tercera modalidad temp disponible sólo con el rastreo de servicio de grupo de ejecución:
  • temp. Esta modalidad es la misma que "safe" pero el rastreo se desactiva automáticamente cuando se reinicia el componente. No puede especificar una modalidad temp si también se especifica -f.
-t

(Necesario) Especifica que se van a modificar las opciones de rastreo de servicio.

Parámetros adicionales exclusivos de los nodos de Trace

n=Conmutador
(Necesario) Especifica la modalidad para el flujo de rastreo. Los valores válidos son on y off.

Ejemplos

Para recopilar y procesar un rastreo de usuario para el grupo de ejecución predeterminado, utilice el mandato:
F MQP1BRK,ct U=YES, E='default', L=NORMAL, C=5000
y en el miembro BIPRELG de PDSE, establezca la opción para mqsireadlog en
-u -e default -f
Para recopilar y procesar un rastreo de servicio para el flujo f1 en el grupo de ejecución predeterminado, utilice el mandato:
F MQP1BRK,ct T=YES, E='default', F='F1', M=FAST, L=DEBUG
y en el miembro BIPRELG de PDSE, establezca la opción para mqsireadlog en
 -t -e default -f
Para recopilar y procesar un rastreo de servicio para un agente, utilice el mandato:
F MQP1BRK,ct T=YES ,B=YES ,M=FAST ,L=DEBUG
y en el miembro BIPRELG de PDSE, establezca la opción para mqsireadlog en
-t -b agent -f
Para conmutar los nodos de Trace para el grupo de ejecución predeterminado, utilice el mandato:
F MQP1BRK,ct n='off',e='default'
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:10


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