Mandato mqsichangetrace - z/OS

Utilice el mandato mqsireporttrace para mostrar las opciones de rastreo actualmente en vigor.

Sintaxis

Mandato de consola z/OS

RASTREO DE USUARIO

RASTREO DE SERVICIO

Parámetros

-u
(Necesario para rastreo de usuario sólo si el componente es un intermediario).

Especifica que se van a modificar opciones de rastreo de usuario. Esta opción sólo es válida si ha emitido este mandato en un intermediario, es decir no en un Gestor de configuración o Servidor de nombres de usuario.

-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). Esta opción sólo es válida para un intermediario.

Este nombre es sensible a las mayúsculas y minúsculas, y debe encerrar 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, y debe encerrar los nombres entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

-r

(Opcional) Esta opción indica que se restablezcan las anotaciones 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).

-l Nivel
(Opcional) Establezca el nivel del rastreo. Debe ser uno de los siguientes:
  • normal. Proporciona un nivel básico de información de rastreo.
  • none. Desactiva el rastreo.
  • debug. Proporciona un rastreo más completo.

Esto es válido para todos los componentes y cada componente se crea con un valor predeterminado de 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 componente se inicia con un valor predeterminado de safe. Si no especifica este parámetro, permanece el valor actual.
Este parámetro sólo es válido si el componente que ha especificado es:
  • Un intermediario. 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).
  • El Servidor de nombres de usuario. Si cambia este valor, esto afectará al rastreo de todo el componente. Esta segunda opción sólo es válida para el rastreo de servicio y, cuando haya cambiado satisfactoriamente este valor, es permanente.
-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 componente se inicia con un valor predeterminado de 4096 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 con el mandato mqsireadlog:
  • Si utiliza este mandato con la opción -f establecida, archivo de anotaciones 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 de las anotaciones 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.

Este parámetro sólo es válido si el componente que ha especificado es:
  • Un intermediario. 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).
  • El Servidor de nombres de usuario. Si cambia este valor, esto afectará al rastreo de todo el componente. Esta segunda opción sólo es válida para el rastreo de servicio.

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) Especifica que se van a modificar las opciones de rastreo de servicio.

-b

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

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
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 U=YES ,E='DEFAULT' ,F='F1' ,M=FAST
y en el miembro BIPRELG de PDSE, establezca la opción para mqsireadlog en
T=, E=DEFAULT, F=F1
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
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:55:50

an28110_