START TRACE (iniciar rastreo) en z/OS

Utilice el mandato START TRACE de MQSC para iniciar rastreos.

Utilización de mandatos MQSC en z/OS

Para obtener información sobre cómo utilizar los mandatos MQSC en z/OS®, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM® MQ for z/OS.

Puede emitir este mandato desde los orígenes 12CR. Para obtener una explicación de los símbolos de origen, consulte Orígenes desde los que puede emitir mandatos MQSC y PCF en IBM MQ for z/OS.

Diagrama de sintaxis
Notas de uso
Descripciones de parámetros para START TRACE
Bloque de destino
Bloque de restricción

Sinónimo: STA TRACE

START TRACE

Bloque de destino

Bloque de restricción

Notas:

¹ Sólo es válido cuando el gestor de colas es miembro de un grupo de compartición de colas.
² Para el rastreo de STAT
³ Para rastreos GLOBAL, ACCTG y CHINIT

Notas de uso

Al emitir este mandato, se devuelve un número de rastreo en el número de mensaje CSQW130I. Puede utilizar este número de rastreo (TNO) en los mandatos ALTER TRACE, DISPLAY TRACE y STOP TRACE.

Descripciones de parámetros para START TRACE

Si no especifica que se inicie un tipo de rastreo, se inicia el rastreo por omisión (GLOBAL). Los tipos son:

ACTG

Habilita los datos de contabilidad que proporcionan información sobre cómo las aplicaciones interactúan con el gestor de colas en forma de registros SMF 116. El sinónimo es A.

Nota: Los datos de contabilidad se pueden perder si el rastreo de contabilidad se inicia o se detiene mientras se ejecutan las aplicaciones. Para obtener información sobre las condiciones que deben cumplirse para una recopilación correcta de datos de contabilidad, consulte Utilización del rastreo de IBM MQ.

CHINIT

Esto incluye datos del iniciador de canal. El sinónimo es CHI o DQM. Si se inicia el rastreo para el iniciador de canal, se detiene si se detiene el iniciador de canal.

Tenga en cuenta que no puede emitir START TRACE (CHINIT) si el servidor de mandatos o el iniciador de canal no se está ejecutando.

GLOBAL

Esto incluye datos de todo el gestor de colas excepto el iniciador de canal. El sinónimo es G.

stat

Habilita las estadísticas de alto nivel sobre el estado del gestor de colas en forma de registros SMF 115. El sinónimo es S.

CMDSCOPE

Este parámetro especifica cómo se ejecuta el mandato cuando el gestor de colas es miembro de un grupo de compartición de colas.

CMDSCOPE no se puede utilizar para mandatos emitidos desde el primer conjunto de datos de entrada de inicialización CSQINP1.

' ': El mandato se ejecuta en el gestor de colas en el que se ha especificado. Éste es el valor predeterminado.
nombre-gestcolas: El mandato se ejecuta en el gestor de colas que especifique, siempre que el gestor de colas esté activo dentro del grupo de compartición de colas.
Puede especificar un nombre de gestor de colas, que no sea el gestor de colas en el que se ha especificado el mandato, sólo si está utilizando un entorno de grupo de compartición de colas y si el servidor de mandatos está habilitado.

COMMENT ( serie )

Especifica un comentario que se reproduce en el registro de salida de rastreo (excepto en las tablas de rastreo residentes). Se puede utilizar para registrar por qué se ha emitido el mandato.

string es cualquier serie de caracteres. Debe estar entre comillas simples si incluye un espacio en blanco, una coma o un carácter especial.

Bloque de destino

DEST

Especifica dónde se va a registrar la salida de rastreo. Se puede especificar más de un valor, pero no utilice el mismo valor dos veces.

El significado de cada valor es el siguiente:

GTF: z/OS Generalized Trace Facility (GTF). Si se utiliza, el GTF debe iniciarse y aceptar registros de usuario (USR) antes de emitir el mandato START TRACE.
RES: Una tabla de acomodación que reside en ECSA, o un espacio de datos para CHINIT.
SMF: Recurso de gestión del sistema (SMF). Si se utiliza, SMF debe estar funcionando antes de que se emita el mandato START TRACE. Los números de registro SMF utilizados por IBM MQ son 115 y 116. Para el tipo de registro SMF 115, se proporcionan los subtipos 1, 2 y 215 para el rastreo de estadísticas de rendimiento.
SRV: Una rutina de servicio reservada sólo para uso de IBM ; no para uso general.
Nota: Si el centro de soporte de IBM necesita que utilice este destino para los datos de rastreo, le proporcionarán el módulo CSQWVSER. Si intenta utilizar el SRV de destino sin CSQWVSER, se genera un mensaje de error en la consola de IBM cuando emite el mandato START TRACE.

Los valores permitidos y el valor predeterminado dependen del tipo de rastreo iniciado, tal como se muestra en la tabla siguiente:

Tabla 1. Destinos permitidos para cada tipo de rastreo
Tipo	GTF	RES	SMF	SRV
GLOBAL	Permitido	Valor predeterminado	No	Permitido
stat	No	No	Valor predeterminado	Permitido
ACTG	Permitido	No	Valor predeterminado	Permitido
CHINIT	No	Valor predeterminado	No	Permitido

Bloque de restricción

El bloque de restricciones coloca restricciones opcionales en los tipos de datos recopilados por el rastreo. Las restricciones permitidas dependen del tipo de rastreo iniciado, tal como se muestra en la tabla siguiente:

Tabla 2. Restricciones permitidas para cada tipo de rastreo
Tipo	CLASS	IFCID	Identificador de gestor de recursos	USERID
GLOBAL	Permitido	Permitido	Permitido	Permitido
stat	Permitido	No	No	No
ACTG	Permitido	No	No	No
CHINIT	Permitido	Permitido	No	No

CLASS

Introduce una lista de clases de datos recopilados. Las clases permitidas, y su significado, dependen del tipo de rastreo iniciado:

(*)

Para rastreos GLOBAL y CHINIT, inicia rastreos para todas las clases de datos.

[MQ 9.3.0 Jul 2022] Para rastreos ACCTG y STAT, inicia rastreos para las clases 1 a 3. Las estadísticas del iniciador de canal y los datos de contabilidad de canal no se inician con CLASS (*) y deben iniciarse con CLASS (4). Las estadísticas de cola no se inician con CLASS (*) y deben iniciarse con CLASS (5).

Atención: Puede especificar una lista separada por comas de clases, por ejemplo TRACE (ACCTG) CLASS (01,03,04); no hay CLASS2. Para detener estas clases que ha iniciado, debe especificar CLASS (01,03,04) en el mandato STOP. Es decir, debe especificar el rango completo de clases que están activas en el mandato STOP antes de poder reiniciar las clases que necesite.

( entero )

Cualquier número de la columna de clase de la tabla siguiente. Puede utilizar más de una de las clases permitidas para el tipo de rastreo iniciado. Un rango de clases se puede especificar como m: n (por ejemplo, CLASS (01:03)). Si no especifica una clase, el valor predeterminado es iniciar la clase 1, excepto cuando se utiliza el mandato START TRACE(STAT) sin ninguna clase donde el valor predeterminado es iniciar la clase 1 y 2.

Tabla 3. Descripciones de sucesos de rastreo y clases
Clase	Descripción
	rastreo global
01	Reservado para el servicio IBM
02	Se ha detectado un error de parámetro de usuario en un bloque de control
03	Se ha detectado un error de parámetro de usuario en la entrada a MQI
	Se ha detectado un error de parámetro de usuario al salir de MQI
	Se ha detectado un error de parámetro de usuario en un bloque de control
04	Reservado para el servicio IBM
	Rastreo de estadísticas
01	Estadísticas de subsistema
	Estadística gestor de colas
02	Estadísticas de resumen de almacenamiento del gestor de colas. Las estadísticas de clase 1 también deben estar habilitadas para recopilar esta clase de datos.
03	Resumen de detalles de almacenamiento del gestor de colas. Las estadísticas de clase 1 también deben estar habilitadas para recopilar esta clase de datos.
04	Estadísticas de iniciador de canal
05	Estadísticas de la cola
	Rastreo de contabilidad
01	El tiempo de procesador empleado en procesar llamadas MQI y un recuento de llamadas MQPUT, MQPUT1 y MQGET
03	Datos estadísticos y de contabilidad mejorados
04	Datos de contabilidad de canal
	Rastreo de CHINIT
01	Reservado para el servicio IBM
04	Reservado para el servicio IBM

IFCID

Reservado para el servicio IBM .

Identificador de gestor de recursos

Introduce una lista de gestores de recursos específicos para los que se recopila información de rastreo. No puede utilizar esta opción para rastreos STAT, ACCTG o CHINIT.

(*): Inicia un rastreo para todos los gestores de recursos.
Este es el valor predeterminado.
( entero ): El número de identificación de cualquier gestor de recursos en la tabla siguiente. Puede utilizar hasta 8 de los identificadores de gestor de recursos permitidos; no utilice el mismo dos veces.

Tabla 4. Identificadores de Resource Manager permitidos
Identificador de gestor de recursos	Gestor de recursos
1	Procedimientos de inicialización
2	Gestión de servicios de agente
3	Gestión de recuperación
4	Gestión de registros de recuperación
6	Gestión del almacenamiento
7	Soporte de subsistema para memorias aliadas
8	Soporte de subsistema para funciones de interfaz de subsistema (SSI)
12	Gestión de parámetros del sistema
16	Mandatos de instrumentación, rastreo y servicios de volcado
23	Proceso de mandatos generales
24	Generador de mensajes
26	Contabilidad y estadísticas de instrumentación
148	Gestor de conexiones
163	Gestor de temas
197	Gestor de CF
199	Recuperación funcional
200	Gestión de la seguridad
201	Gestión de datos
211	Gestión de bloqueos
212	Gestión de mensajes
213	Servidor de mandatos
215	Gestión de almacenamiento intermedio
242	IBM MQ IMS -puente
245	Gestor de Db2®

TDATOS

Reservado para el servicio IBM .

USERID

Introduce una lista de ID de usuario específicos para los que se recopila información de rastreo. No puede utilizar esta opción para rastreos STAT, ACCTG o CHINIT.

(*): Inicia un rastreo para todos los ID de usuario. Este es el valor predeterminado.
( ID_usuario ): Nombra un ID de usuario. Puede utilizar hasta 8 ID de usuario; se inicia un rastreo independiente para cada uno. El ID de usuario es el ID de autorización primario de la tarea, utilizado por IBM MQ dentro del gestor de colas. Es el ID de usuario que muestra el mandato MQSC DISPLAY CONN.