Mandato mqsichangetrace

Plataformas soportadas

  • Windows 2000, Windows XP
  • Plataformas 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. Es aconsejable utilizar esta opción únicamente si así lo indica la acción descrita en un mensaje BIPxxxx o el centro de soporte de IBM.

Puede iniciar, modificar o terminar el rastreo de usuario 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 usuarios (identificado por el nombre de componente). Este mandato no puede utilizarse para iniciar el rastreo de servicio para el área de trabajo.

En plataformas Windows y plataformas UNIX, también se puede iniciar y detener la actividad del rastreo para grupos de ejecución y flujos de mensajes utilizando los recursos del área de trabajo. Consulte el apartado Rastreo de usuario para más información.

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

Si especifica un intermediario o cualquiera de sus recursos (grupo de ejecución o flujo de mensajes), ha de haberlos difundido antes para poder iniciar el rastreo.

La salida del rastreo generada por estos mandatos se graba en archivos de rastreo en el subdirectorio log. Cuando haya terminado el trabajo que desee rastrear, utilice mqsireadlog para recuperar las anotaciones como un archivo con formato XML. Utilice mqsiformatlog (para crear un archivo formateado) o un navegador XML par ver los registros XML.

Cuando se activa el rastreo, se produce un proceso adicional en todas las actividades del componente que esté rastreando. Dé por sentado que notará alguna repercusión sobre el rendimiento mientras el rastreo esté activo.

Si desea rastrear los ejecutables de mandatos propiamente dichos, establezca las variables de entorno MQSI_UTILITY_TRACE y MQSI_UTILITY_TRACESIZE antes de iniciar el rastreo.

Asegúrese de que restablece las variables cuando el rastreo del mandato seleccionado haya terminado. Si no lo hace, todos los mandatos subsiguientes se rastrearán y su rendimiento se degradará.

Sintaxis

Plataformas Windows y plataformas UNIX

Rastreo de usuario

Rastreo de servicio

z/OS

Rastreo de usuario

Rastreo de servicio

Parámetros

component
(Necesario - Plataformas Windows y plataformas UNIX) El nombre del componente para el que van a cambiarse los parámetros de rastreo. Puede ser el nombre de un intermediario o los valores fijos ConfigMgr o UserNameServer (todos son sensibles a las mayúsculas y minúsculas en UNIX sistemas).
-u
(Opcional) Especifica que las opciones de rastreo de usuario han de modificarse. Esta opción sólo es válida si ha:
  • Especificado un nombre de intermediario como nombre de componente en plataformas Windows y en plataformas UNIX.
  • Emitido este mandato para un intermediario (es decir, no para un Servidor de nombres de usuarios) en z/OS.
.
-e grupoejecución
(Opcional) Identifica el grupo de ejecución para el que van a modificarse las opciones de rastreo (por ejemplo, iniciarse o detenerse). 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 debe incluir los nombres entre comillas simples si contienen caracteres en mayúsculas y minúsculas.

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

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

-r
(Opcional) Esta opción solicita el restablecimiento de las anotaciones, es decir que se descartan todos los registros actuales. Utilice esta opción cuando inicie un nuevo rastreo para asegurarse de que todos los registros de las anotaciones son exclusivos del nuevo rastreo.

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

-l nivel
(Opcional) Establece el nivel del rastreo. Ha de ser uno de estos:
  • normal. Proporciona un nivel básico de información de rastreo.
  • ninguno. Desactiva el rastreo.
  • depurar. Proporciona un rastreo más amplio.

Cada componente se crea con el valor por omisión ninguno. Si no especifica este parámetro, el valor actual no cambiará. Cuando haya cambiado correctamente este valor, será permanente.

Esto es válido para todos los componentes.

-m modalidad
(Opcional) Indica la forma en que la información de rastreo debe transferirse al almacenamiento intermedio:
  • safe. Esta modalidad hace que las entradas del rastreo se graben en un archivo cuando se generan.
  • fast. Esta modalidad hace que las entradas del rastreo vayan al almacenamiento intermedio y sólo se escriban en un archivo por lotes.

Cada componente se crea con el valor por omisión safe. Si no especifica este parámetro, el valor actual no cambiará.

Esta opción sólo es válida 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 alguno), o al componente agente (si no ha especificado un grupo de ejecución).
  • El Servidor de nombres de usuarios. Si cambia este valor, esto afectará al rastreo de todo el componente. (Lo anterior sólo es válido para el rastreo de servicio.) trace.) Cuando haya cambiado correctamente este valor, será 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 cambiará. Cada componente se crea 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 piensa leer posteriormente las anotaciones utilizando el mandato mqsireadlog.
  • Si utiliza mqsireadlog con la opción -f establecida, el archivo de anotaciones se lee directamente del sistema de archivos. En ese caso, el valor máximo que puede especificarse es 2097151, lo que permitiría la creación de un archivo de rastreo de hasta 2 GB (gigabyte).
  • Si utiliza mqsireadlog sin establecer la opción -f, se enviará un mensaje de WebSphere MQ al intermediario para recuperar las anotaciones. En ese caso, el tamaño del archivo de rastreo no debería sobrepasar los 70 MB (megabytes). El valor máximo que se puede definir aquí no ha de ser mucho más de 70000.

Sin embargo, se va recuperar el archivo de rastreo, es aconsejable que conserve su tamaño tan reducido como sea posible, utilizando un valor bajo para este parámetro o utilizando la opción de restablecer (-r) en este mandato para borrar las anotaciones de rastreo. La ventaja de adoptar este método es que el proceso de formateo (mqsiformatlog) es mucho más rápido y requiere menos recursos para llevar a cabo esta tarea.

Esta opción sólo es válida 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 alguno), o al componente agente (si no ha especificado un grupo de ejecución).
  • El Servidor de nombres de usuarios. Si cambia este valor, esto afectará al rastreo de todo el componente. (Lo anterior sólo es válido para el rastreo de servicio.) trace.)

Si cambia el tamaño del rastreo, el nuevo valor persistirá después de un reinicio del intermediario o del Servidor de nombres de usuarios.

Parámetros adicionales exclusivos del rastreo de servicio

Utilice estas opciones únicamente cuando se lo indique el centro de soporte de IBM o un mensaje BIPxxxx.

-t
(Opcional) Especifica que las opciones de rastreo de servicio han de modificarse.
-b
(Opcional) Especifica que las opciones de rastreo de servicio del subcomponente agent del componente especificado han de modificarse (por ejemplo, iniciarse o detenerse). Este distintivo sólo puede especificarse si también se ha especificado -t.

Autorización

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

Respuestas

Este mandato devuelve las siguientes respuestas:
  • BIP2595 Error al transformar la serie de caracteres '...' en un entero (sólo z/OS)
  • BIP8002 Los distintivos seleccionados son incompatibles (sólo z/OS)
  • BIP8003 Se ha detectado un distintivo duplicado (sólo z/OS)
  • BIP8013 El componente no existe
  • BIP8020 No se ha podido acceder a la base de datos
  • BIP8029 Intermediario no configurado
  • BIP8031 Se ha facilitado un distintivo no válido
  • BIP8032 No se ha podido conectar con la cola
  • BIP8033 Error de envío de mensaje
  • BIP8035 Respuesta no recibida antes del tiempo de espera excedido
  • BIP8036 Se ha recibido una respuesta negativa
  • BIP8037 Distintivo no soportado
  • BIP8039 Grupo de ejecución no disponible
  • BIP8040 No se ha podido conectar con la base de datos
  • BIP8045 No se ha encontrado el flujo de mensajes
  • BIP8068 Se requiere un argumento de 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 plataformas UNIX:

mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000

mqsichangetrace WBRK_BROKER -u -e "exg1" -m fast

mqsichangetrace UserNameServer -t -b -l normal
z/OS:
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000

MODIFY MQP1BRK,changetrace u=yes,e='exg1',m=fast

F MQP1UNS,ct t=yes,b=yes,l=normal

Tareas relacionadas
Utilización del rastreo

Referencia relacionada
Rastreo de usuario
Rastreo de servicio
Preferencia de sintaxis
Mandato mqsiformatlog
Mandato mqsireadlog
Mandato mqsireporttrace