Mandato mqsichangetrace

Plataformas soportadas

  • Windows
  • Sistemas Linux y UNIX
  • z/OS

Finalidad

Utilice el mandato mqsichangetrace para establecer las características de rastreo para un componente. Este mandato es válido para:
  • Rastreo de usuario. Especifique la opción -u.
  • Rastreo de servicio. Especifique la opción -t. Se recomienda utilizar 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.

Puede iniciar, modificar o terminar el rastreo de usuarios para un intermediario o iniciar, modificar o terminar el rastreo de servicio para un intermediario, el Gestor de configuración o el Servidor de nombres de usuario (identificado por el nombre de componente). No puede utilizar este mandato para iniciar el rastreo de servicio para el entorno de trabajo.

En plataformas Windows y sistemas Linux y UNIX, también puede iniciar y detener la actividad de rastreo para grupos de ejecución y flujos de mensajes utilizando los recursos del entorno de trabajo. Para más información, consulte Rastreo de usuario.

En z/OS, también puede iniciar, modificar o detener un rastreo con los mandatos de consola o utilizando los recursos del entorno de trabajo.

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.

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

Al activar el rastreo, se genera un proceso adicional que debe ejecutarse para cada actividad del componente que se rastrea. Cuando el rastreo está activo, debe contar con que se notará un impacto en el rendimiento.

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.

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.

Sintaxis

Plataformas Windows, y sistemas Linux y UNIX

Rastreo de usuario

Rastreo de servicio

z/OS

Rastreo de usuario

Rastreo de servicio

Parámetros

componente
(Necesario - Plataformas Windows, y sistemas Linux y UNIX) El nombre del componente para el que se deben cambiar los parámetros de rastreo. Puede ser el nombre de un intermediario, de un Gestor de configuración, o el valor fijo, ServidorNombresUsuario (todos son sensibles a las mayúsculas y minúsculas en sistemas UNIX y en Linux).

Inicio del cambioLas palabras clave entorno de trabajo y utility están reservadas y no deben utilizarse para los nombres de componentes.Fin del cambio

-u
Inicio del cambio(Obligatorio para rastreo de usuario sólo si el componente es un intermediario) Especifica que se deben modificar opciones de rastreo de usuario. Esta opción sólo es válida si se ha:
  • Especificado un nombre de intermediario como nombre de componente en las plataformasWindows, y los sistemas Linux y UNIX.
  • Emitido este mandato para un intermediario (es decir, no un Gestor de configuración o Servidor de nombres de usuario) en z/OS.
.Fin del cambio
-e nombreGe
Inicio del cambio(Obligatorio para rastreo de usuario, opcional para rastreo de servicio) Identifica el grupo de ejecución para el que se deben modificar las opciones de rastreo (por ejemplo, iniciado o detenido). Esta opción sólo es válida para un intermediario.

En z/OS, este nombre es sensible a las mayúsculas y minúsculas y los nombres se deben indicar entre comillas simples si contienen caracteres en mayúsculas y minúsculas mezclados.

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

En z/OS, este nombre es sensible a las mayúsculas y minúsculas y los nombres se deben indicar 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 al iniciar un nuevo rastreo y asegurarse de que todos los registros incluidos en las anotaciones son exclusivos para el nuevo rastreo.

Esta opción sólo es válida si se 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.

Cada componente se crea con un valor por omisión de none. Si no especifica este parámetro, permanece el valor actual. Una vez que ha cambiado satisfactoriamente este valor, éste permanece.

Es válido para todos los componentes.

-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 sólo se escriben en un archivo en lotes.

Cada componente se inicia con un valor por omisión de safe. Si no especifica este parámetro, permanece el valor actual.

Esta opción sólo es válida si el componente 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. (Sólo es válido para el rastreo de servicio). Una vez que ha cambiado satisfactoriamente este valor, éste permanece.
-c tamaño
(Opcional) El tamaño del archivo de rastreo en KB (kilobytes). Si no especifica este parámetro, se deja el valor actual. Cada componente se inicia con un valor por omisión de 4096 KB. Especifique esta opción para restablecer el valor. El valor máximo que puede especificar depende de cómo se pretendan leer posteriormente las anotaciones con el mandato mqsireadlog.

En HP-UX se recomienda que establezca este valor por debajo de 500 MB.

  • Si utiliza mqsireadlog con la opción -f establecida, el archivo de anotaciones se lee directamente del sistema de archivos. En este caso, el valor máximo que puede especificarse aquí es 2097151, lo que permite crear un archivo de rastreo de hasta 2 GB (gigabytes).
  • Si utiliza mqsireadlog sin establecer la opción -f, se envía un mensaje WebSphere MQ al intermediario para que recupere las anotaciones. En este caso, el tamaño del archivo de rastreo no debe exceder 70 MB (megabytes). El valor máximo que se puede establecer aquí no debe ser apreciablemente superior a 70000.

Comoquiera que se recupere el archivo de rastreo, se recomienda mantenerlo lo más pequeño posible, utilizando un valor bajo para este parámetro o utilizando la opción para restablecer (-r) de este mandato para borrar el contenido de las anotaciones de rastreo. La ventaja de este método es que el proceso de formateo (mqsiformatlog) es mucho más rápido y requiere menos recursos para llevar a cabo la tarea.

Esta opción sólo es válida si el componente 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. (Sólo es válido para el rastreo de servicio).

Si cambia el archivo de rastreo, el nuevo valor es constante después de un reinicio del intermediario o del Servidor de nombres de usuario.

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
Inicio del cambio(Obligatorio) Especifica que deben modificarse las opciones de rastreo de servicio.Fin del cambio
-b
Inicio del cambio(Obligatorio) Especifica que deben modificarse las opciones de rastreo de servicio para el subcomponente agent del componente especificado (por ejemplo, iniciado o detenido). Sólo puede especificar este indicador si también se especifica -t.Fin del cambio

Autorización

ID de usuario utilizado para emitir el mandato debe tener autorización mqbrkrs.

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP2595 Error al convertir la serie de caracteres '...' a un entero (sólo z/OS)
  • BIP8002 Los indicadores seleccionados son incompatibles (sólo z/OS)
  • BIP8003 Se ha detectado un indicador duplicado (sólo z/OS)
  • BIP8013 Este componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 El intermediario no está configurado
  • BIP8031 Se ha proporcionado un indicador no válido
  • BIP8032 No se ha podido efectuar la conexión a la cola
  • BIP8033 Anomalía en el envío de mensajes
  • BIP8035 No se ha recibido una respuesta antes del tiempo de espera
  • BIP8036 Se ha recibido una respuesta negativa
  • BIP8037 Indicador no soportado
  • BIP8039 El grupo de ejecución no está disponible
  • BIP8040 No se ha podido efectuar la conexión con la base de datos
  • BIP8045 No se ha encontrado el flujo de mensajes
  • BIP8068 Es necesario un argumento entero
  • BIP8158 Formato no válido para el mandato (sólo z/OS)
  • BIP8159 Parámetro "..." desconocido (sólo z/OS)

Ejemplos

Plataformas Windows, y sistemas Linux y UNIX:

Para recopilar y procesar un rastreo de usuario para el grupo de ejecución por omisión, utilice el mandato:
mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
Para recopilar y procesar un rastreo de servicio para el flujo f1 en el grupo de ejecución por omisión, utilice el mandato:
mqsichangetrace WBRK_BROKER -u -e default -m fast
Para recopilar y procesar un rastreo de servicio para un agente, utilice el mandato:
mqsichangetrace WBRK_BROKER -t -b -m -l normal

z/OS:

Para recopilar y procesar un rastreo de usuario para el grupo de ejecución por omisión, utilice el mandato:
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000
y en el miembro BIPJLOG 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 por omisión, utilice el mandato:
F MQP1BRK,ct u=yes,e='default',f='f1',m=fast
y en el miembro BIPJLOG 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 BIPJLOG de PDSE, establezca la opción para mqsireadlog en
-t -b agent
Tareas relacionadas
Utilización del rastreo
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
an07260_