TRACE CT, mandato

Utilice el mandato z/OS® TRACE CT para iniciar, detener o modificar un rastreo de diagnóstico IRLM .

IRLM no da soporte a todas las opciones disponibles en el mandato TRACE CT .

Subsecciones:

Sintaxis

Leer diagrama de sintaxisOmitir diagrama de sintaxis visualTRACECT,WTRSTART= parmlibmem, WRAP, NOWRAPWTRSTOP= jobnameON,COMP= irlmnm, SUB = (DBMEXPINTSLMXCFXIT)1OFF
Notas:
  • 1 El mismo tipo de rastreo sólo se puede especificar una vez.

Palabras clave

Se pueden especificar las palabras clave siguientes para el mandato TRACE CT .
CT
Especifica el rastreo de componente (en lugar de las otras opciones de rastreo disponibles en el mandato TRACE de z/OS ).
WTRSTART =parmlibmem
Identifica el nombre del miembro que contiene el JCL de origen que invoca el grabador externo y define el conjunto de datos en el que el grabador externo escribe los almacenamientos intermedios de rastreo. El miembro puede ser un SYS1.PROCLIB o un trabajo. Muchas instalaciones utilizan un procedimiento catalogado en SYS1.PROCLIB.
Después de especificar un mandato TRACE CT, WTRSTART, active el rastreo y conecte el transcriptor utilizando el parámetro WTR en la respuesta para un mandato TRACE CT .
WRAP
Especifica que cuando el sistema alcanza el final del conjunto de datos o grupo de conjuntos de datos, graba sobre los datos más antiguos al principio del conjunto de datos o al principio del primer conjunto de datos del grupo. Se utilizan las extensiones primarias del conjunto de datos.
NOWRAP
Especifica que el sistema deja de grabar en el conjunto o conjuntos de datos cuando están llenos. Se utilizan las extensiones primaria y secundaria de los conjuntos de datos.
WTRSTOP=nombre_trabajo
Identifica el nombre de trabajo de un transcriptor externo de rastreo de componente que se debe detener. Los conjuntos de datos que ha utilizado el transcriptor están cerrados.
El nombre del trabajo es:
  • Un nombre de miembro, si el JCL de origen es un procedimiento.
  • El nombre de una sentencia JOB dentro del JCL de origen.
ON
Activa el rastreo.
COMP=rlmssnm
El nombre del subsistema IRLM .
SUB=subnombre
Identifica el tipo de rastreo de subnivel deseado. Este parámetro puede ser cualquiera de los valores siguientes:
DBM
Rastrear interacciones con el DBMS identificado.
EXP
Rastrear cualquier condición de excepción. EXP se activa automáticamente cuando se inicia la ejecución de IRLM y se activa de forma permanente.
ENT
Rastrear sucesos de miembros y grupos fuera de la actividad de bloqueo normal. INT se activa automáticamente cuando IRLM empieza a ejecutarse y se activa de forma permanente.
Slm
Rastrear interacciones con el componente de bloqueo de z/OS .
XCF
Rastrear todas las interacciones con los servicios de acoplamiento entre sistemas z/OS .
XIT
Rastrear sólo interacciones asíncronas con el componente de bloqueo de z/OS . XIT se activa automáticamente cuando se inicia la ejecución de IRLM , pero se puede desactivar utilizando el mandato z/OS TRACE CT .
OFF
Desactiva el rastreo. Si IRLM está conectado a un grabador externo de rastreo de componentes, el sistema fuerza una desconexión implícita.

En el caso de los rastreos de subnivel EXP e INT, el parámetro OFF impide que los rastreos graben en el transcriptor externo. Sin embargo, siguen grabando en almacenamientos intermedios. Estos rastreos los utiliza IMS con fines de depuración.

Procedimiento de grabador externo de ejemplo

A continuación se muestra un procedimiento de ejemplo para el grabador externo IRLM :
//CTWTR    PROC
//         EXEC PGM=ITTTRCWR
//TRCOUT01 DD   DSNAME=SYS1.WTR1,DISP=OLD
//TRCOUT02 DD   DSNAME=SYS1.WTR2,DISP=OLD

Notas de uso

El impacto de establecer TRACE CT ON es que cada tipo de subnombre activo requiere un máximo de 0,7 MB de ECSA. Puesto que IRLM inicializa sus propios rastreos cuando se inicia, el mandato DISPLAY TRACE muestra que todos los rastreos están desactivados. Después de emitir el mandato TRACE ON , los informes son precisos excepto para los dos tipos de subnombre, INT y EXT, que no se pueden desactivar.

Este mandato sólo se puede especificar desde la consola maestra. El mandato requiere un nivel adecuado de autorización z/OS .

Puesto que este mandato utiliza servicios de rastreo de componentes de z/OS , asegúrese de que el módulo de carga de inicio y detención de IRLM , DXRRL183, esté en la lista de enlaces de z/OS .

Ejemplos

A continuación se muestran algunos ejemplos del uso del mandato TRACE CT .

Ejemplo 1 para el mandato TRACE CT

A continuación se muestra una secuencia de mandatos de ejemplo para iniciar y detener un rastreo de IRLM DBM. En este ejemplo, los datos de rastreo se graban en un conjunto de datos de transcriptor externo identificado en el procedimiento CTWTR:
TRACE CT,WTRSTART=CTWTR
TRACE CT,ON,COMP=IRLM,SUB=(DBM)
⋮
  (z/OS asks for a reply.)
⋮
R 15,WTR=CTWTR,END
TRACE CT,OFF,COMP=IRLM,SUB=(DBM)
⋮
  (Wait a while to make sure trace buffers are externalized.)
TRACE CT,WTRSTOP=CTWTR

Ejemplo 2 para el mandato TRACE CT

A continuación se muestra un procedimiento de ejemplo para iniciar y detener rastreos en modalidad de envolvimiento. Los rastreos capturados en este procedimiento se guardan en un número limitado de almacenamientos intermedios proporcionados por IRLM. Cada almacenamiento intermedio se reutiliza cuando se llena el almacenamiento intermedio anterior.
TRACE CT,ON,COMP=IRLM
⋮
  (z/OS asks for a reply.)
⋮
R 15,END
TRACE CT,OFF,COMP=IRLM