-DISPLAY TRACE comando (Db2)

Medio ambiente para -DISPLAY TRACE

Este comando puede emitirse desde una consola de z/OS®, una sesión de DSN, un DB2I panel ( DB2 COMMANDS), un terminal IMS o CICS®, o un programa que utilice la interfaz de la función de instrumentación (IFI).

Ámbito de uso compartido de datos: Grupo o miembro

Autorización para -DISPLAY TRACE

Db2 los comandos que se emiten desde una consola de z/OS o TSO SDSF con sesión iniciada pueden comprobarse mediante una autorización de Db2 utilizando ID de autorización principal y secundaria. Debe definirse un ID de usuario de z/OS conectado en RACF o un servidor de seguridad similar.

Descripciones de opciones para -DISPLAY TRACE

-DISPLAY TRACE (PERFM) CLASS (1,2)

( * )

No limita la lista de rastros. El valor predeterminado es ( * ).

La opción CLASS no puede utilizarse con DISPLAY TRACE (*).

Cada una de las siguientes palabras clave limita la lista a rastros del tipo correspondiente.

Tipo (abreviatura)

Descripción

PERFM (P)

Registros de rendimiento de eventos específicos

ACCTG (A)

Registros contables de cada transacción

STAT (S)

Datos estadísticos

AUDITORÍA (AU)

Datos de auditoría

MONITOR (MON)

Supervisar datos

DETAIL (tipo de salida )

Limita la información que muestra un rastreo en función del tipo de salida especificado entre paréntesis.

Los posibles valores para output-type son:

1

Mostrar información de seguimiento resumida: NÚMERO DE SEGUIMIENTO, TIPO, CLASE, DESTINO

2

Mostrar información de seguimiento de calificación: NÚMERO DE SEGUIMIENTO, AUTHID, UBICACIÓN, PAQUETE, PLAN, TXACT, USERID, ESTACIÓN DE TRABAJO

1,2

Mostrar tanto el resumen como la información de calificación

*

Mostrar tanto el resumen como la información de calificación

Si no hay ningún parámetro después de DETAIL, se muestra la información de seguimiento de tipo 1.

También se muestra una columna adicional, QUAL, que indica si el rastreo está calificado. Parte de la información de seguimiento resumida, la columna QUAL puede utilizarse para determinar si hay más información de cualificación disponible para el seguimiento. Esta información puede obtenerse especificando DETALLE (2) o DETALLE (*). Un valor de columna QUAL de SÍ indica que existe información adicional para este rastreo en particular en la información de rastreo de calificación; un valor de NO indica que no existe información adicional para este rastreo.

COMMENT (cadena)

Especifica que el comentario « cadena » aparece en la salida de rastreo, excepto en la salida de las tablas de rastreo residentes.

cadena es cualquier cadena de caracteres; debe estar entre apóstrofos si incluye un espacio en blanco, una coma o un carácter especial. El comentario no aparece en la pantalla; puede registrarse en la salida de seguimiento, pero solo si se están rastreando comandos.

SCOPE

Especifica el alcance del comando.

( LOCAL )

Muestra el rastro solo para el miembro local.

(GRUPO)

Muestra el rastro de todos los miembros del grupo de intercambio de datos.

DEST

Limita la lista a los rastreos que se iniciaron para destinos concretos. Se puede especificar más de un valor, pero no utilice el mismo valor dos veces. Si no especifica un valor para DEST, Db2 no utiliza el destino donde se registra la salida de seguimiento para limitar la lista de seguimientos mostrados.

Abreviatura : D

Los valores posibles y sus significados son:

valor

Rastrear destino

GTF

z/OS generalized trace facility (GTF).

SMF

z/OS System Management Facilities (SMF)

SRV

Una salida a una rutina escrita por el usuario

OP n

Un destino específico. n puede ser un valor de 1 a 8.

RMID

Especifica el identificador del administrador de recursos. Puede especificar hasta 8 RMID válidos, que son identificadores de uno o dos dígitos. No puede especificar RMID para rastreos contables o estadísticos.

ASID(x' dd dd')

Especifica que se mostrará la información sobre el rastreo de un espacio de direcciones.

dddd es un identificador de espacio de direcciones hexadecimal de cuatro bytes (ASID).

CLASS (entero,...)

Limita la lista a rastros que se iniciaron para clases particulares.

El valor predeterminado es CLASS( * ), lo que no limita la lista.

TNO (entero,...)

Limita la lista a rastros concretos, identificados por sus números de rastro (1 a 32, 01 a 09). Se pueden utilizar hasta ocho números de seguimiento. Si se utiliza más de un número, solo se puede utilizar un valor para PLAN, AUTHID y LOCATION.

El valor predeterminado es TNO( * ), lo que no limita la lista.

PLAN( plan-name , …) o XPLAN( plan-name , …)

Presenta una lista de planes específicos para los que se recopila información de seguimiento. Utilice PLAN para restringir el rastreo a los planes especificados o XPLAN para excluir los planes especificados. No puede utilizar esta opción para un seguimiento STAT.

El valor predeterminado es PLAN( * ).

( * )

Muestra un seguimiento de todos los planes.

nombre del plan

El nombre de un plan de aplicación. Puede utilizar hasta ocho nombres. Si utiliza más de un nombre, puede usar solo un valor para AUTHID y LOCATION.

PKGLOC o XPKGLOC

Especifica el nombre de la ubicación donde se vincula el paquete. Utilice PKGLOC para restringir el rastreo a las ubicaciones especificadas o XPKGLOC para excluir las ubicaciones especificadas.

PKGCOL o XPKGCOL

Especifica el nombre de la recogida de paquetes. Utilice PKGCOL para restringir el rastreo a las colecciones especificadas o XPKGCOL para excluir las colecciones especificadas.

PKGPROG o XPKGPROG

Especifica el DBRM o el nombre del programa. Utilice PKGPROG para restringir el seguimiento a los programas especificados o XPKGPROG para excluir los programas especificados.

AUTHID( authorization-id , …) o XAUTHID( id_autorización , …)

Presenta una lista de identificaciones de autorización específicas para las que se recopila información de seguimiento. Utilice AUTHID para restringir el rastreo a los ID de autorización especificados o XAUTHID para excluir los ID de autorización especificados. Los ID de autorización especificados deben ser los ID de autorización principales. No puede utilizar esta opción para un seguimiento STAT.

El valor predeterminado es AUTHID( * ).

( * )

Muestra un rastro de todos los ID de autorización.

identificación de autorización

Especifica un ID de autorización. Puede utilizar hasta ocho identificadores. Si utiliza más de un identificador, puede utilizar solo un valor para PLAN y LOCATION.

LOCATION (nombre de la ubicación,...) o XLOC (nombre de la ubicación,...)

Especifica una lista de nombres de ubicaciones para las que se recopila información de seguimiento. Utilice LOCATION para restringir el rastreo a las ubicaciones especificadas o XLOC para excluir las ubicaciones especificadas. El uso de la opción LOCATION o XLOC impide el rastreo de hilos que no tienen una relación de datos distribuidos.

nombre-ubicación

Identifica los subsistemas de Db2 cuyos subprocesos distribuidos desea rastrear. Activa el rastreo de la dirección de red ( Db2 ) para la ubicación remota TCP/IP o SNA que especifique por nombre de ubicación.

Puede especificar hasta ocho ubicaciones. Solo puede especificar una ubicación si utiliza más de un nombre de plan o ID de autorización.

<luname>

Activa el rastreo de Db2 para los clientes remotos que están conectados a DDF a través del nombre SNA LU remoto que especificó en luname.

ipaddr

Activa el seguimiento de la dirección de destino ( Db2 ) para los clientes remotos que están conectados a DDF a través del host TCP/IP remoto. ipaddr es la dirección IP.

(*)

Indica que desea mostrar los eventos de seguimiento que se producen en subprocesos distribuidos, independientemente de la ubicación a la que estén conectados. Especificar el nombre de la ubicación local equivale a especificar LOCATION(*).

Clientes que no sean Db2 for z/OS: Db2 for z/OS no recibe un nombre de ubicación de clientes que no sean subsistemas de Db2 for z/OS . Para mostrar un rastreo de un cliente que no sea un subsistema de Db2 for z/OS , introduzca su LUNAME o dirección IP. Incluya el LUNAME entre los símbolos menor que (<) y mayor que (>). Introduzca la dirección IP en el formulario nnn.nnn.nnn.nnn. Por ejemplo, para mostrar un rastreo de un cliente con el LUNAME de LULA, introduzca el siguiente comando:

-DISPLAY TRACE (*) LOCATION (<LULA>)

Para mostrar un rastreo de un cliente con la dirección IP 123.34.101.98, introduzca el siguiente comando:

-DISPLAY TRACE (*) LOCATION (::FFFF:123.34.101.98)

USERID o XUSERID

Especifica el ID de usuario. Utilice USERID para restringir el rastreo a los ID de usuario especificados o XUSERID para excluir los ID de usuario especificados. Puede especificar varios valores y valores comodín como se describe en Notas de uso.

USERID y XUSERID puede tener hasta 16 caracteres.

APPNAME o XAPPNAME

Especifica el nombre de la aplicación. Utilice APPNAME para restringir el rastreo a las aplicaciones especificadas o XAPPNAME excluir las aplicaciones especificadas. Puede especificar varios valores y valores comodín como se describe en Notas de uso.

APPNAME y XAPPNAME puede tener hasta 32 caracteres.

WRKSTN o XWRKSTN

Especifica el nombre de la estación de trabajo. Utilice WRKSTN para restringir el rastreo a las estaciones de trabajo especificadas o XWRKSTN excluir las estaciones de trabajo especificadas. Puede especificar varios valores y valores comodín como se describe en Notas de uso.

WRKSTN y XWRKSTN puede tener hasta 18 caracteres.

CONNID o XCONNID

Especifica el ID de conexión. Utilice CONNID para restringir el rastreo a las conexiones especificadas o XCONNID para excluir las conexiones especificadas.

CORRID o XCORRID

Especifica el ID de correlación. Utilice CORRID para restringir el rastreo a los ID de correlación especificados o XCORRID para excluir los ID de correlación especificados.

ROLE o XROLE

Especifica las funciones de conexión. Utilice ROLE para restringir el rastreo a los roles especificados o XROLE para excluir los roles especificados.

AUDTPLCY

Un área de 128 bytes que contiene el nombre de la política. Puede especificar hasta ocho nombres de políticas de auditoría. AUDTPLCY se aplica al tipo de rastreo AUDIT. No puede especificar CLASS o IFCID con AUDTPLCY.

Notas de uso para -DISPLAY TRACE

Mostrar hilos trazados usando el comodín *

Puede utilizar el sufijo comodín «*» para filtrar los hilos que desea mostrar. Por ejemplo, si especifica "-DISPLAY TRACE PLAN (A,B,C*)", Db2 mostrará los rastreos A, B, CDE, CDEFG, CDEFGH, etc. Mostrará los hilos trazados «A», «B» y todos los hilos que comiencen por «C».

Visualización de hilos trazados utilizando el comodín posicional (_)

Puede utilizar el comodín posicional, que se representa con el carácter «_», para mostrar hilos trazados cuando desee que el comodín esté en el medio, o cuando desee trazar hilos de una longitud específica. Por ejemplo, si especifica "-DISPLAY TRACE PLAN (A_B)", se mostrarán todos los hilos trazados que tengan "A" como primer carácter, cualquier carácter para el "_" y "C" como filtro de plan.

Visualización de varios hilos trazados a la vez mediante comodines

También tiene la opción de mostrar varios hilos trazados basados en varias calificaciones de trazado. Por ejemplo, puede especificar «-DISPLAY TRACE PLAN (A*, B*, C*)» para mostrar simultáneamente todos los hilos trazados para el plan que comienzan con «A», «B» y «C». El carácter comodín, «*», mostrará todos los hilos trazados. Puede especificar combinaciones más complejas como, «-DISPLAY TRACE PLAN (A_B*, C*, AND C/_D*)», que devolverá todos los hilos que:

• comienzan con “A”, tienen un comodín de un carácter como segundo carácter en el hilo, tienen una “B” como tercer carácter en el hilo y terminan con cualquier tipo o número de caracteres ( A D B IOP, A O B TYJDP,)
• comienzan con «C» y terminan con cualquier combinación de caracteres (CDE, CGHKO )
• comienzan con “C_D” y terminan con cualquier tipo de combinación de caracteres ( C_D EFGH, C_D lMNOP)

Todas las posibles combinaciones de hilos enumeradas anteriormente se devolverán con el comando anterior.

Tiene la posibilidad de filtrar varios hilos al mismo tiempo, estableciendo criterios específicos para el seguimiento. Por ejemplo, puede especificar «-DISPLAY TRACE PLAN (A) USERID (B)» Esto mostrará todos los hilos trazados donde el hilo del plano es «A» y el ID de usuario es «B» Nota : Al mostrar hilos trazados, solo puede especificar un criterio de hilo para cada filtro para el comando de visualización de trazado. Por ejemplo, puede especificar «-DISPLAY TRACE PLAN(A,B) USERID (B) WRKSTN (E)», pero no puede especificar «-DISPLAY TRACE PLAN(A, B) USERID(A, B) WRKSTN(E) porque, en este ejemplo, dos de las calificaciones del filtro tienen dos elementos definidos para ser rastreados, y « Db2 » solo permite que un atributo tenga más de un elemento de rastreo definido por rastreo.

Filtrar los hilos trazados que desea mostrar utilizando la funcionalidad de exclusión

Cuando especifica una «X» con cualquier palabra clave de restricción, como «XPLAN», cuando filtra hilos, está utilizando la funcionalidad de exclusión para el comando de visualización de rastreo. Tiene la opción de excluir tipos específicos de hilos que desea mostrar cuando ejecute comandos de rastreo. Puede utilizar el carácter «X» para excluir combinaciones específicas de caracteres cuando ejecute un comando de rastreo de pantalla. Por ejemplo, puede especificar «-DISPLAY TRACE XPLAN(A)», para mostrar todos los hilos trazados EXCEPTO «A». En este caso, B, BCD, BCDE o CD podrían ser devueltos.

También tiene la opción de excluir varios tipos de hilos de su rastreo. Por ejemplo, puede especificar «-DISPLAY TRACE XPLAN (A*, B*)» para mostrar todos los hilos trazados EXCEPTO los que empiezan por «A», con cualquier combinación de caracteres después de «A», y todos los que empiezan por «B», con cualquier combinación de caracteres después de «B». Nota: Especificar XPLAN (*) excluirá todos los hilos de su búsqueda y no está permitido. Tampoco puede utilizar el comodín en medio de un comando de rastreo de visualización con funcionalidad de exclusión, como «-DISPLAY TRACE XPLAN (A*C)» Sin embargo, puede especificar «-DISPLAY TRACE XPLAN (A_ _ C *)», que devolverá todos los hilos EXCEPTO los que empiezan por «A», una variedad de DOS caracteres a continuación, una «C» en el cuarto espacio y una variedad de caracteres al final. El símbolo comodín no puede colocarse en medio de los criterios de rastreo.

Tiene la posibilidad de mostrar dos trazados a la vez, para ayudarle a optimizar sus capacidades de trazado. Por ejemplo, puede especificar (-DISPLAY TRACE XPLAN (A, B, C) USERID (D))». Esto le indica a Db2 que muestre todos los hilos que se están rastreando para el «plan» EXCEPTO los hilos «A», «B» o «C», solo cuando el ID de usuario = «D».

Puede introducir comodines en sus comandos de seguimiento de pantalla para añadir más personalización a sus seguimientos. Por ejemplo, puede especificar «-DISPLAY TRACE PLAN (C*) USERID (Z, X) XPLAN (C, D, E)». En este ejemplo, para que el hilo se pueda rastrear, el plan debe comenzar con «C», el ID de usuario debe ser igual a «Z» o a «X», y el plan no puede ser «C», «D» o «E» Por lo tanto, un plan de «CB», con un ID de usuario de «Z», pasaría y se mostraría el hilo que se está rastreando, pero el plan C con un ID de usuario de «X» fallaría porque el comando especifica que no se rastreen hilos en los que el plan sea «C», sin caracteres adicionales en el hilo.

Combinación de calificadores de rastreo

Puede personalizar los hilos que calca ordenando a Db2 que calque hilos específicos, excluyendo otros hilos específicos. Por ejemplo, puede especificar «-DISPLAY TRACE USERID(A,B) XPLAN (C)». Este criterio solo rastrea hilos en los que el ID de usuario es igual a «A» o «B», y el plan NO es igual a «C». En este ejemplo, un hilo en el que el ID de usuario es «A» y el plan es igual a «D» pasaría y se rastrearía, pero un hilo en el que el ID de usuario es «A» y el plan es «C» no pasaría y no se rastrearía.

MOSTRA EL CÓDIGO DE DEVOLUCIÓN DE TRACE cuando no haya trazas activas

Si ejecuta DISPLAY TRACE en un entorno por lotes y no hay rastros activos, el código de retorno para el paso del trabajo es 12.

Información de seguimiento para comandos emitidos con alcance de grupo

Si este comando se emite con opciones que especifican el ámbito de grupo en un miembro de intercambio de datos de e Db2 , también se ejecuta en todos los demás miembros activos. Los registros de seguimiento de IFICID 090 para otros miembros del grupo pueden mostrar que el mismo comando fue emitido por el ID de autorización SYSOPR desde el ID de correlación de la red de área local ( 016.TLPKN5F ), además de los registros de seguimiento del miembro donde se emitió el comando original. Véase el alcance del comando en el intercambio de datos de Db2.

Salida para -DISPLAY TRACE

El DSNW127I mensaje muestra el resultado del comando DISPLAY TRACE. El formato de la salida depende del valor de la opción DETALLE que se especificó en el comando.

DSNW127I  CURRENT TRACE ACTIVITY IS -                
TNO           TYPE        CLASS       DEST         QUAL      IFCID                    
trace-number  trace-type  type-class  destination  qualified ifcid
trace-number  trace-type  type-class  destination  qualified ifcid
*********END OF DISPLAY TRACE SUMMARY DATA*********                       

DSNW143I  CURRENT TRACE QUALIFICATIONS ARE -
DSNW152I  BEGIN TNO trace-number QUALIFICATIONS   
NO QUALIFICATIONS
END TNO trace-number QUALIFICATIONS
DSNW185I BEGIN TNO trace-number AUDIT POLICIES
NO AUDIT POLICIES ACTIVE
END TNO trace-number AUDIT POLICIES

DSNW152I  BEGIN TNO trace-number QUALIFICATIONS   
PLAN: plan-qualification
AUTHID: authid-qualification
LOCATION: location-qualification
USERID: userid-qualification
APPLICATION/TRANSACTION NAME: application/transaction-name-qualification
WORKSTATION: workstation-qualification
PACKAGE LOCATION: package-location-qualification
PACKAGE COLLECTION ID: package-collection-ID-qualification
PACKAGE PROGRAM NAME: package-program-name-qualification
ROLE: role-qualification
RMID: rmid-qualifications
CONNECTION ID: connection-ID-qualification
CORRELATION ID: correlation-ID-qualification
EXCLUDE PLAN: xplan qual1,xplan qual2,...,xplan qual8
EXCLUDE AUTHID: xauthid qual1,xauthid qual2,...,authid qual8
EXCLUDE LOCATION: xloc qual1,xloc qual2,...,xloc qual8 
EXCLUDE USERID: xuserid qual1,xuserid qual2,...,xuserid qual8
EXCLUDE APP/TXACT NAME: xappname qual1,xappname qual2,...,xappname qual8 
EXCLUDE WORKSTATION: xwrkstn qual1,xwrkstn qual2,...,xwrkstn qual8
EXCLUDE PACKAGE LOC: xpkgloc qual1,xpkgloc qual2,...,xpkgloc qual8
EXCLUDE PACKAGE COLLID: xpkgcol qual1,xpkgcol qual2,...,xpkgcol qual8
EXCLUDE PACKAGE PROGNAME: xpkgprog qual1,xpkgprog qual2,...,xpkgprog qual8
EXCLUDE CONNECTION ID: xconnid qual1,xconnid qual2,...,xconnid qual8
EXCLUDE CORRELATION ID: xcorrid qual1,xcorrid qual2,...,xcorrid qual8
EXCLUDE ROLE: xrole qual1,xrole qual2,...,xrole qual8
END TNO trace-number QUALIFICATIONS
DSNW185I BEGIN TNO trace-number AUDIT POLICIES
AUDIT POLICY: policy-name
END TNO trace-number AUDIT POLICIES

DSNW148I  ******END OF DISPLAY TRACE QUALIFICATION

DSNW198I DISPLAY TRACE OUTPUT TO BE CONTINUED (CMDID=command-id)

DSNW199I DISPLAY TRACE OUTPUT CONTINUED (CMDID=command-id)

DSN9022I  '-DISPLAY TRACE' NORMAL COMPLETION