Mandato mqsichangetrace - sistemas Windows, Linux y UNIX

Sintaxis

Rastreo de usuario

Rastreo de servicio

Parámetros

Componente
(Necesario) Este puede ser el nombre de un intermediario, o 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).

Las palabras clave entorno de trabajo y utility están reservadas y no deben utilizarse para los nombres de componentes.

-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 especificado un nombre de intermediario como nombre del componente.

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

-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).

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

En HP-UX, establezca el valor de tamaño por debajo de 500 MB.

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:
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 predeterminado, utilice el mandato:
mqsichangetrace WBRK_BROKER -t -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
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Reservados todos los derechos.
Última actualización : 2009-02-16 14:31:14

an28100_