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