-START TRACE comando (Db2)

Medio ambiente para -START 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).

Autorización para -START 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.

Sintaxis para -START TRACE

bloqueo de restricciones

Notas:

• ¹ No especifique CLASS o IFCID con AUDTPLCY. AUDTPLCY se aplica al tipo de rastreo AUDIT.
• ² Al especificar múltiples trazas AUDTPLCY con diferentes criterios de filtrado, el filtrado se convierte en una UNIÓN entre todas las trazas AUDTPLCY.

bloque de filtrado

Descripciones de opciones para -START TRACE

Debe especificar un tipo de seguimiento.

Los bloques de restricción y filtrado

Los bloques de restricción y filtrado imponen límites opcionales a los tipos de datos que recoge el rastreo. Las opciones de filtrado son equivalentes excluyentes a las opciones de restricción correspondientes.

Un comando START TRACE para un seguimiento de estadísticas solo permite la opción de restricción CLASS. Un comando START TRACE para cualquier otro tipo de seguimiento permite cualquier opción de restricción u opción de filtro. Sin embargo, Db2 no utiliza ningún filtro o restricción que usted especifique cuando inicia un rastreo para cualquiera de los siguientes IFCID:

Un comando START TRACE puede contener múltiples opciones de restricción, múltiples opciones de filtrado o una combinación de ambas. Una restricción o una opción de filtrado puede contener varios valores. Sin embargo, el comando no debe contener múltiples opciones de restricción que contengan cada una múltiples valores. Una opción de restricción única que tiene varios valores se puede especificar con:

• Múltiples opciones de restricción, cada una de las cuales tiene un único valor
• Múltiples opciones de filtrado, cada una de las cuales tiene un valor único o múltiples valores

Se emite un mensaje de error si el comando START TRACE contiene dos o más opciones de restricción que tienen cada una múltiples opciones.

El significado de cada opción es el siguiente. Las opciones de filtrado se describen con sus correspondientes opciones de restricción.

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

( * )

Inicia un seguimiento para todos los planes.

nombre del plan

Es el nombre de un plan de aplicación. Puede utilizar hasta ocho nombres; se inicia un seguimiento independiente para cada nombre. 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( * ).

( * )

Inicia un rastreo de todos los ID de autorización.

identificación de autorización

Especifica un ID de autorización. Puede utilizar hasta ocho identificadores; se inicia un seguimiento independiente para cada identificador. 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. No se puede especificar LOCATION o XLOC cuando se desea iniciar un seguimiento de estadísticas.

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; se inicia un seguimiento independiente para cada una. 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.

El formato de la dirección IP depende de si la pila TCP/IP se ha configurado como una pila de protocolo de control de transmisión/protocolo de Internet ( IPv4-only ) o como una pila de modo dual. Una pila de protocolos de aplicación ( IPv4 ) solo admite el protocolo de transferencia de archivos ( IPv4 ). Una pila de modo dual admite los protocolos IPv4 y IPv6.

• Para una pila de protocolos de Internet ( IPv4-only ), introduzca la dirección IP en formato IPv4 :

  x.x.x.x

• Para un apilamiento de modo dual:
  • Introduce una dirección IPv6 en formato IPv6 :

    y:y:y:y:y:y

  • Introduce una dirección IPv4 en formato dual IPv6 y IPv4, con ::FFFF: como parte de la dirección ( IPv6 ):

    ::FFFF:x.x.x.x

(*)

Indica que desea iniciar el seguimiento de eventos 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 iniciar 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 formato nnn.nnn.nnn.nnn. Por ejemplo, para iniciar un rastreo de un cliente con el LUNAME de LULA, introduzca el siguiente comando:

-START TRACE (PERFM) CLASS (*) LOCATION (<LULA>)

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

-START TRACE (PERFM) CLASS (*) 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.

El valor CONNID o XCONNID es uno de los siguientes valores:

Valor CONNID	Tipo de conexión a Db2
BATCH	Despliegue
TSO	TSO
DB2CALL	QMF
Programa de utilidad	Db2 programa de utilidad
id-subsistema	Db2 interno
nombre de la conexión cics	CICS
nombre-conexión-ims	IMS
RRSAF	RRSAF
nombre-conexión	Una conexión de un solicitante de Db2 for z/OS encia remota. Este valor es el nombre de conexión del hilo en la ubicación solicitante.
SERVIDOR	Una conexión de un solicitante remoto que no es Db2 for z/OS.

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.

CLASS( entero , …)

Presenta una lista de las clases de datos recopilados. Las clases permitidas y su significado dependen del tipo de traza iniciada.

Abreviatura: C

Cuando se omite la opción " CLASS ", se activan las clases predeterminadas dentro del tipo de rastreo. Las clases predeterminadas se identifican en la columna Descripción de las siguientes tablas.

( * )

Inicia un rastreo para todas las clases del tipo de rastreo.

entero

Cualquier número de la siguiente tabla. Puede utilizar cualquier número de clases que estén permitidas para el tipo de seguimiento iniciado.

Consejo : Los números IFCID se presentan a menudo en el Db2 y su documentación con tres o cuatro dígitos y ceros a la izquierda. Por ejemplo, puede encontrar: «IFCID 1», «IFCID 001» o «IFCID 0001» Sin embargo, puede asumir que cada una de estas referencias tiene el mismo significado.

Seguimiento contable (ACCTG)

Tabla 2. Clases para el seguimiento contable de Db2

Clase	Descripción de la clase	IFCID activados
1	Datos contables estándar. La clase 1 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento contable.	3, 106, 200, 239
2	Señalización de entrada o salida de un evento de Db2 .	232
3	Tiempo de espera transcurrido en Db2.	6, 7, 8, 9, 32, 33, 44, 45, 117, 118, 127, 128, 170, 171, 174, 0175, 213, 214, 215, 216, 226, 227, 242, 243, 321, 322, 329, 378, 379, 382, 383, 413, 414
4	Registro contable definido por la instalación.	151
5	Tiempo empleado en el procesamiento de las solicitudes IFI.	187
6	Reservado.
7	Contabilidad a nivel de paquete en tiempo inDb2 .	200, 232, 239, 240
8	Tiempo de espera de contabilidad a nivel de paquete en Db2.	6, 7, 8, 9, 32, 33, 44, 45, 117, 118, 127, 128, 170, 171, 174, 175, 213, 214, 215, 216, 226, 227, 239, 241, 242, 243, 321, 322, 378, 379, 382, 383, 413, 414
10	Detalle del paquete. También debe activarse uno de los siguientes rastros antes de que se escriban los registros IFCID 239: Clase contable 7 Clase contable 8 Clase de supervisor 7 Clase de supervisor 8	239
11	Información de contabilidad de nivel de planificación. La clase 11 se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento de la contabilidad. Inicie un rastreo para la clase contable 11 en lugar de la clase contable 1 si no desea que se devuelvan los registros IFCID 239.	3.200
12-29	Reservado.
30-32	Disponible para uso local.

Rastreo de auditoría (AUDIT)

Tabla 3. Clases para la auditorí Db2 a rastrear

Clase	Descripción de la clase	IFCID activados
1	Intentos de acceso denegados debido a una autorización inadecuada. La clase 1 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento de auditoría.	140
2	GRANT y REVOKE explícito.	141
3	Operaciones CREATE, ALTER y DROP contra las tablas auditadas.	142
4	Primer cambio del objeto auditado.	143
5	Primera lectura del objeto auditado.	144
6	Vincular la información del tiempo acerca de las sentencias SQL que implican objetos auditados.	145
7	Asignación o cambio de ID de autorización.	55, 83, 87, 169, 319
8	Programas de utilidad.	23, 24, 25, 219, 220
9	Registro de auditoría definido por la instalación.	146 392
10	Información de contexto fiable.	269, 270
11	Auditorías de acceso satisfactorio.	3 6 11
12-29	Reservado.
30-32	Disponible para uso local.
Notas: Si se inicia IFCID 361 a través de START TRACE, se rastrean todos los accesos correctos. Si se inicia IFCID 361 porque la categoría de política de auditoría SYSADMIN está activada, solo se rastrea el acceso correcto utilizando la autoridad administrativa SYSADMIN. Si se inicia IFCID 361 porque la categoría de política de auditoría DBADMIN está activada, solo se rastrea el acceso correcto utilizando la autoridad administrativa DBADMIN.

Rastreo estadístico (STAT)

Tabla 4. Clases para el seguimiento de estadísticas de Db2

Clase	Descripción de la clase	IFCID activados
1	Información sobre los servicios del sistema, estadísticas de la base de datos, estadísticas del espacio de direcciones de los servicios de la base de datos (ssnmDBM1), estadísticas agregadas de la CPU y del tiempo de espera por tipo de conexión, e información sobre los parámetros del sistema que estaban en vigor cuando se inició el seguimiento. La clase 1 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento de estadísticas.	1, 2, 105, 106, 202, 225, 369
2	Registro estadístico definido por la instalación	152
3	Punto muerto, escalamiento del bloqueo, agrupación de almacenamiento intermedio del grupo, información de la extensión del conjunto de datos e indicaciones de lecturas no comprometidas a largo plazo e insuficiencias de espacio de registro activo.	172, 196, 250, 258, 261, 262, 313, 330, 335, 337
4	Db2 condiciones excepcionales.	173, 191, 192, 193, 194, 195, 203, 204, 205, 206, 207, 208, 209, 210, 235, 236, 238, 267, 268, 334, 343, 402
5	Db2 estadísticas de intercambio de datos.	230, 254
6	Estadísticas de almacenamiento para el subsistema de Db2 .	225
7	Estadísticas de ubicación de DRDA.	365
8	Estadísticas de E/S del conjunto de datos.	199 , 389
9	Estadísticas agregadas de CPU y tiempo de espera por tipo de conexión.	369
10	Estadísticas de la aplicación remota DRDA basadas en el registro especial CURRENT CLIENT_APPLNAME. Información de inventario del cliente.	411
11	Estadísticas de usuario remoto DRDA basadas en el registro especial CURRENT CLIENT_USERID. Información de inventario del cliente.	412
12-29	Reservado.
30-32	Disponible para uso local.

Rastreo de rendimiento (PERFM)

Tabla 5. Clases para el seguimiento del rendimiento de la e Db2

Clase	Descripción de la clase	IFCID activados
1	Sucesos de fondo. La clase 1 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento del rendimiento.	1, 2, 31, 42, 43, 76, 77, 78, 79, 102, 103, 105, 106, 107, 153
2	Sucesos del subsistema. La clase 2 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento del rendimiento.	3, 68-75, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 106, 174, 175
3	Sucesos SQL. La clase 3 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento del rendimiento.	22, 53, 55, 58, 59, 60, 61, 62, 63, 64, 65, 66, 92, 95, 96, 97, 106, 112, 173, 177, 233, 237, 250, 272, 273, 325
4	Lee y graba desde el almacenamiento intermedio y las agrupaciones EDM.	6, 7, 8, 9, 10, 29, 30, 105-107, 127, 128, 226, 227, 321, 322, 477
5	Escribir en el registro, archivar el registro.	32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 104, 106, 114, 115, 116, 117, 118, 119, 120, 228, 229
6	Información de bloqueo de resumen.	20, 44, 45, 105, 106, 107, 172, 196, 213, 214, 218, 337
7	Información de bloqueo detallado.	21, 105, 106, 107, 223
8	Detalle de exploración de datos.	13-18, 105, 106, 107, 125, 221, 222, 231, 305, 311, 363
9	Ordenar detalle.	26, 27, 28, 95, 96, 106
10	BIND, mandatos y detalle de programas de utilidad.	23, 24, 25, 90, 91, 0105, 106, 107, 108, 109, 110, 111, 201, 256
11	Conmutador de la unidad de ejecución y contenciones del mecanismo de cierre.	46-52, 56, 57, 93, 94, 106, 113
12	Gestor de almacenamiento.	98, 99, 100, 101, 106
13	Salidas de validación y edición.	11, 12, 19, 105, 106, 107
14	Entrada y salida a una aplicación.	67, 106, 121, 122
15	Registro de rendimiento definido por la instalación.	154
16	Procesamiento distribuido.	157, 158, 159, 163, 167, 183
17	Información de reclamo y drenaje.	211, 212, 213, 214, 215, 216
18	Mensajes de la consola basados en sucesos.	197
19	Actividad de abertura y cierre del conjunto de datos.	370, 371
20	Resumen de coherencia de intercambio de datos.	249, 251, 256, 257, 261, 262, 267, 268
21	Detalle de coherencia de intercambio de datos.	255, 259, 263
22	Parámetros de salida de autorización.	314
23	Diagnóstico de tiempo de ejecución del entorno de lenguaje.	327
24	Detalle del procedimiento almacenado.	380, 499
25-29	Reservado.
30-32	Disponible para uso local.

Rastreo de supervisor (MONITOR)

Tabla 6. Clases para los tipos de monitores Db2

Clase	Descripción de la clase	IFCID activados
1	Datos contables estándar. La clase 1 también se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento del monitor.	200
2	Señalización de entrada o salida de un evento de Db2 .	232
3	Db2 tiempo de espera para E/S, bloqueos; información de uso de recursos.	6, 7, 8, 9, 32, 33, 44, 45, 117, 118, 127, 128, 170, 171, 174, 175, 213, 214, 215, 216, 226, 227, 242, 243, 321, 322, 378, 379, 382, 383, 413, 414
4	Registro supervisor definido por la instalación.	155
5	Tiempo empleado en el procesamiento de las solicitudes IFI.	187
6	Cambios a las tablas creadas con DATA CAPTURE CHANGES.	185
7	Entrada o salida de un evento de Db2 , señalización para la contabilidad de paquetes. Los datos rastrean la cantidad de tiempo que un agente ha pasado en Db2 para procesar cada paquete.	200, 232, 240
8	Tiempo de espera para un paquete.	6, 7, 8. 9, 32, 33, 44, 45, 51, 52, 56, 57, 117, 118, 127, 128, 170, 171, 174, 175, 213, 214, 215, 216, 226, 227, 239, 241, 242, 243, 321, 322, 378, 379, 382, 383, 413, 414
9	Habilita la contabilidad del nivel de sentencia.	124
10	Detalle del paquete para el gestor de almacenamiento intermedio, gestor de bloqueo y estadísticas de SQL. También debe activarse uno de los siguientes rastros antes de que se escriban los registros IFCID 239: Clase contable 7 Clase contable 8 Clase de supervisor 7 Clase de supervisor 8	239
11	Información de contabilidad de nivel de planificación. La clase 11 se activa cuando omite la palabra clave " CLASS " del comando START TRACE al iniciar el seguimiento del monitor.	3.200
12-28	Reservado.
29	Controla la colección a nivel del subsistema de las estadísticas de las sentencias SQL.	316, 318, 400, 401
30-32	Disponible para uso local.

IFCID ( ifcid, …)

Especifica qué otros IFCID (eventos de rastreo), además de los IFCID contenidos en las clases especificadas en la opción CLASS, deben iniciarse. Para iniciar solo los IFCID especificados en la opción IFCID, utilice las clases de seguimiento 30, 31 o 32. Estas clases no tienen IFCID predefinidos y están disponibles para que las utilice una ubicación. Para ver un ejemplo de activación solo de los eventos de seguimiento especificados en la opción IFCID, consulte Ejemplo: seguimiento del rendimiento de subprocesos con actividad remota.

Si no especifica la opción IFCID, solo se iniciarán aquellos IFCID contenidos en las clases de seguimiento activadas.

El número máximo de IFCID es 156. El rango de valores válidos para la opción IFCID es 1-511, con las siguientes excepciones: 4, 5, 185, 187, 217, 232, 234, 240, 241 y 362. Estas excepciones son valores no válidos para la opción IFCID. Los IFCID 4 y 5 siempre están activos de forma automática.

Consejo : Los números IFCID se presentan a menudo en el Db2 y su documentación con tres o cuatro dígitos y ceros a la izquierda. Por ejemplo, puede encontrar: «IFCID 1», «IFCID 001» o «IFCID 0001» Sin embargo, puede asumir que cada una de estas referencias tiene el mismo significado.

IFCID 362 se inicia automáticamente si especifica la opción AUDTPLCY. Algunos de los otros IFCID no válidos solo pueden activarse mediante determinadas clases de rastreo. Los valores no válidos para la opción IFCID que solo pueden ser iniciados por clases de seguimiento son:

Para empezar...

Iniciar...

FIDC 185

monitorizar clase de rastreo 6

FIDC 232

monitor de seguimiento de clase 2 o 7, o de seguimiento de contabilidad de clase 2 o 7

IFCID 240

monitor trace class 7 o accounting trace 7

FIDC 241

monitor trace class 8 o accounting trace 8

El valor predeterminado es IFCID( * ).

BUFSIZE ( k_bytes, …)

Especifica el tamaño de un búfer gestionado por IFC que recibe los datos de seguimiento. Puede especificar esta opción solo si especificó un destino de OP n .

k_bytes puede variar entre 256 KB y 65536 KB. El número debe ser divisible por 4. Si especifica un valor fuera de este rango, se utilizará el límite de rango más cercano al valor especificado. Para asignar un tamaño de búfer de 256 KB, debe especificar BUFSIZE(256).

El valor predeterminado es BUFSIZE ( * ), que es el tamaño establecido cuando se instaló Db2 .

AUDTPLCY( nombre-de-la-política, …)

Presenta una lista de hasta ocho nombres de políticas de auditoría para las que se recopila información de seguimiento. Esta opción inicia los IFCID que corresponden a las categorías especificadas en las políticas de auditoría enumeradas e inicia un rastreo para el IFCID 0362.

AUDTPLCY se aplica al tipo de rastreo AUDIT. No puede especificar AUDTPLCY con CLASS o IFCID.

TDATA

Especifica los encabezados de las secciones de productos que se colocarán en la sección de productos de cada registro de seguimiento. Si no especifica TDATA, el tipo de seguimiento determina el tipo de encabezado de sección del producto. La sección de productos de un registro de seguimiento puede contener varios encabezados.

Todos los registros de IFC tienen un encabezado IFC estándar. El encabezado de correlación se añade para los registros de contabilidad, rendimiento, auditoría y supervisión. El encabezado de rastreo se añade para los registros de mantenimiento.

CORRELATION

Coloca un encabezado de correlación en el registro.

Abreviatura: COR

TRACE

Coloca un encabezado de rastreo en el registro.

Abreviatura: TRA

CPU

Coloca un encabezado de CPU en el registro. El encabezado de la CPU contiene el tiempo de procesador actual para la ejecución de la TCB o SRB de la e z/OS.

DISTRIBUTED

Coloca un encabezado distribuido en el registro.

Abreviatura: DIST

Notas de uso para -START TRACE

Encontrar descripciones de campos de rastreo (IFCID)

Puede encontrar descripciones de registros de rastreo en el archivo sin formato IFCID (DSNWMSGS). La versión más actual de DSNWMSGS solo está disponible para clientes que tengan licencias de Db2 12 for z/OS . La información se encuentra en un archivo PDF. Para localizar esta información, consulte el archivo plano IFCID (DSNWMSGS) Db2 12 for z/OS .

Políticas de auditoría

Pueden estar activas hasta 32 políticas de auditoría simultáneamente. Si especifica varias políticas de auditoría para iniciar y algunas de esas políticas no se inician correctamente, se devuelve el mensaje de advertencia DSNW196I. Se inician las demás políticas de auditoría.

Recomendación : FL 509 Inicie todas las políticas de auditoría a prueba de manipulaciones en un comando START TRACE, que las asigna a un número de seguimiento. Hacerlo ayuda a evitar la posibilidad de que los números de seguimiento no coincidan entre los miembros que comparten datos si se utiliza la opción SCOPE(GROUP) para detener una política de auditoría a prueba de manipulaciones.

Número de rastros

Si utiliza uno o ningún valor para PLAN, AUTHID o LOCATION, el comando START TRACE inicia un único seguimiento. Si utiliza varios valores para PLAN, AUTHID o LOCATION, el comando inicia un rastreo para cada plan, ID de autorización o ubicación.

Pueden estar activas hasta 32 pistas simultáneamente.

Si se ingresa un comando START TRACE desde la consola o desde los paneles DB2I a un destino OP n u OPX, se emite el mensaje DSNW133I para indicar que se perdieron los datos de seguimiento.

El uso de las opciones PLAN, AUTHID o LOCATION al iniciar la clase de seguimiento de monitor 1 no tiene ningún efecto en la cantidad de datos devueltos en las solicitudes IFI READS.

El uso de las opciones PLAN, AUTHID o LOCATION no tiene ningún efecto al iniciar las clases de seguimiento de contabilidad o monitor 2, 5 o 7.

detener e iniciar Db2

Si se detiene e inicia Db2 después de haber iniciado un rastreo, este no se reinicia automáticamente.

Especificación del ÁMBITO (GRUPO)

Cuando se emite START TRACE con SCOPE(GROUP), Db2 emite un comando START TRACE en cada miembro del grupo de intercambio de datos. Los datos van al destino tal y como se define para cada miembro del grupo de intercambio de datos. Si desea recopilar datos de seguimiento de todos los miembros del grupo de intercambio de datos en un solo lugar, utilice un programa de monitorización con llamadas IFI READA o READS para recopilar los datos.

FL 509 Si utiliza la opción ÁMBITO (GRUPO) para especificar varias políticas de auditoría para iniciar, las políticas de auditoría se envían a todos los miembros del grupo de intercambio de datos. Sin embargo, si una de las políticas de auditoría especificadas es una política de auditoría a prueba de manipulaciones, la política de auditoría a prueba de manipulaciones se bloquea para todos los miembros del grupo de intercambio de datos. No puede utilizar SCOPE(GROUP) para iniciar políticas de auditoría a prueba de manipulaciones.

Si se inicia un seguimiento con SCOPE(GROUP) y un nuevo miembro se une al grupo de intercambio de datos después de que se inicie el seguimiento, el nuevo miembro también escribe los datos de seguimiento especificados por el comando START TRACE.

Iniciar un seguimiento con SCOPE(GROUP) puede generar grandes cantidades de datos de seguimiento, por lo que es posible que tenga que aumentar el tamaño del área de retorno en su programa de monitorización para contener los datos adicionales.

Rastrear hilos utilizando el comodín * en un nombre o dirección parcial

En un nombre o dirección parcial, puede utilizar el sufijo comodín, «*» para filtrar los hilos. Por ejemplo, si especifica "-START TRACE PLAN (A,B,C*)", Db2 rastreará y luego devolverá A, B, CDE, CDEFG, CDEFGH, y así sucesivamente. Rastreará los hilos «A», «B» y todos los hilos que comiencen por «C».

No puede incluir el carácter comodín en medio de un nombre o dirección parcial.

Rastrear hilos utilizando el comodín posicional (_) en un nombre o dirección parcial

En un nombre o dirección parcial, puede utilizar el comodín posicional, que se representa con el carácter «_», para rastrear hilos cuando desee que el comodín esté en el medio o cuando desee rastrear hilos de una longitud específica. Por ejemplo, si especifica «-START TRACE PLAN (A_C)», se rastrearán todos los hilos que tengan tres caracteres que tengan «A» como primer carácter y «C» como tercero. Este comando devolvería «ABC», «ADC», «AEC», etc. Si desea rastrear el hilo «A_C», puede especificar «-START TRACE PLAN (A/_C)». El "/" antes del "_" le indica a Db2 que busque el guión bajo en la búsqueda, en lugar de tratarlo como un comodín. La misma lógica se aplica si está intentando rastrear un hilo que incluye un carácter "/" o "*". Dado que el carácter «/» es un carácter de escape, si intenta rastrear un hilo que contiene un carácter «/», puede especificar, por ejemplo, «-START TRACE PLAN (A//C)» para rastrear el hilo «A/C». También puede especificar «-START TRACE PLAN (A/*C)» para rastrear el hilo «A*C».

Rastrear varios hilos a la vez utilizando comodines

También tiene la opción de rastrear varios hilos basados en múltiples calificaciones de rastreo. Por ejemplo, puede especificar «-START TRACE PLAN (A*, B*, C*)» para rastrear simultáneamente TODOS los hilos del plan que comiencen por «A», «B» y «C». El carácter comodín, «*», rastreará todos los hilos. Puede especificar combinaciones más complejas como, «-START TRACE PLAN (A_B*, C*, AND C/_D*)», que devolverá todos los hilos que:

• Comience con “A”, tenga un comodín de un carácter como segundo carácter en el hilo, tenga una “B” como tercer carácter en el hilo y termine 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 hilo enumeradas anteriormente se devolverán con el comando anterior.

Especificar criterios de filtrado para hilos

Puede controlar el conjunto de hilos para los que se escriben registros de seguimiento estableciendo criterios de filtrado específicos en el comando -START TRACE. Las siguientes reglas se aplican a todos los filtros de rastreo:

• Db2 aplica filtros de rastreo cuando se escribe un registro de rastreo externo. El estado de un hilo en ese momento determina si un hilo se escribe en su totalidad o se elimina por completo. Por ejemplo, si se especifica la opción PKGPROG(ABC), los registros de seguimiento se escriben para los subprocesos que ejecutan el paquete ABC solo si el paquete ABC está activo durante el evento SQL que hace que los registros de seguimiento se externalicen.
• Los filtros de rastreo no alteran el contenido de un registro de rastreo.
• Las clases de rastreo o IFCID que no están asociadas con registros de rastreo específicos, como las clases contables 2, 3, 7, 8 y 10, o el IFCID 318, no se ven afectadas por el filtrado. Por ejemplo, el siguiente comando no da lugar a un filtrado porque las clases contables 7 u 8 no escriben registros externos:

  -START TRACE(ACCTG) CLASS(7,8) DEST(SMF) PKGPROG(ABC)

• Db2 permite que solo una opción de filtrado tenga más de un valor en un comando -START TRACE. Por ejemplo, el mandato siguiente es válido:

  -START TRACE PLAN(A,B) USERID(B) WRKSTN(E)

  El siguiente comando no es válido:

  -START TRACE PLAN(A,B) USERID(A,B) WRKSTN(E)

Filtrado de hilos mediante la función 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 –START TRACE. Tienes la opción de excluir tipos específicos de hilos cuando ejecutes comandos de rastreo. Puede utilizar el carácter «X» para excluir combinaciones específicas de caracteres cuando esté realizando un seguimiento. Por ejemplo, puede especificar este comando para rastrear todos los hilos excepto «A»:

-START TRACE XPLAN(A)

En este caso, se podrían devolver b, bcd, bcde o cd.

También puede excluir varios tipos de hilos de su rastreo. Por ejemplo, puede especificar este comando para iniciar un seguimiento de todos los hilos excepto los hilos de los planes que empiezan por «A», con cualquier combinación de caracteres después de «A», y todos aquellos caracteres que empiezan por «B», con cualquier combinación de caracteres después de «B»:

-START TRACE XPLAN(A*, B*)

Especificar XPLAN (*) excluye todos los hilos de su búsqueda y no está permitido. Tampoco puede utilizar el comodín * en medio de criterios de seguimiento con la función de exclusión, como por ejemplo: «-START TRACE XPLAN (A*C)» Sin embargo, puede especificar este comando para que devuelva todos los hilos excepto los de los planes que empiezan por «A», dos caracteres cualquiera a continuación, una «C» en el cuarto espacio y cualquier carácter al final.

-START TRACE XPLAN (A_ _ C *)

Puede iniciar dos seguimientos a la vez, para ayudarle a optimizar sus capacidades de seguimiento. Por ejemplo, puede especificar este comando:

-START TRACE XPLAN (A, B, C) USERID(D)

Este comando le indica a Db2 que comience a rastrear hilos para todos los planes excepto los planes «A», «B» o «C», y solo donde el ID de usuario = «D».

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 «-START TRACE USERID (A,B) XPLAN (C)». Este criterio solo rastrea hilos donde 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 sería rastreado, pero un hilo en el que el ID de usuario es «A» y el plan es «C» no pasaría y no sería rastreado.

Puede introducir varios comodines en sus comandos de seguimiento de inicio para añadir más personalización a sus seguimientos. Por ejemplo, puede especificar «-START TRACE PLAN (C*) USERID (Z, X) XPLAN (C, D, E)». En este ejemplo, para que el hilo se pueda trazar, 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 el hilo se rastrearía, pero el plan C con un ID de usuario de X fallaría porque el comando especifica no rastrear hilos donde el plan es «C», sin caracteres adicionales en el hilo.

Rastrear prioridad de destino

Si un IFCID está asociado a una clase y usted especifica ese IFCID en la palabra clave IFCID, el destino de la clase tiene prioridad. Esta regla afecta a los IFCID en las clases contables 2, 3, 5, 7, 8 y en las clases de supervisión 1, 2, 3, 5, 7, 8 porque estas clases tienen destinos preestablecidos para los IFCID.

Por ejemplo, el siguiente comando «-START TRACE(ACCTG) CLASS (1,2,3) IFCID(6,7) DEST SMF», no escribirá los IFCID 6 y 7 en SMF porque forman parte de la clase contable 3, que tiene un destino preestablecido. Para escribir IFCID 6 y 7 en SMF, debe iniciar el rastreo de la siguiente manera:

-START TRACE(ACCTG) CLASS(1,2,3) DEST(SMF)
-START TRACE(ACCTG) CLASS(30) IFCID(6,7) DEST(SMF)

IFCID para uso local

Db2 no utiliza los códigos IFCID del 1000 al 1999, que están disponibles para uso local.

Ejemplos de -START TRACE

Ejemplo: seguimiento del rendimiento de hilos con actividad remota

Iniciar un seguimiento de rendimiento para hilos con actividad remota en la ubicación USIBMSTODB21. Activar solo los IFCID 0044 (bloqueo suspendido) y 0045 (bloqueo reanudado). La clase de trazas 30 está disponible para su uso en instalaciones.

-START TRACE (PERFM)
  DEST(GTF)
  LOCATION(USIBMSTODB21)
  CLASS(30)
  IFCID(44,45)

Ejemplo: seguimiento contable de un plan

Iniciar un seguimiento contable para el plan DSN8BC81. Escribir registros en SMF (esto ocurrirá de forma predeterminada). Incluya un comentario para identificar el rastro.

-START TRACE (ACCTG)
  PLAN (DSN8BC81)
  COMMENT ('ACCTG TRACE FOR DSN8BC81')

Ejemplo: seguimiento de estadísticas

Iniciar el seguimiento de estadísticas. Escribir registros en SMF (por defecto).

-START TRACE=S

Ejemplo: iniciar seguimiento de monitor

Iniciar el seguimiento de monitor (normalmente realizado por un programa de aplicación) en el grupo de intercambio de datos. Escribir registros en OPX (por defecto).

-START TRACE(MON) SCOPE(GROUP)

Ejemplo: registros de seguimiento de rendimiento para subprocesos que están ejecutando el paquete

Utilice la opción PKGPROG para escribir registros de seguimiento de rendimiento solo para subprocesos que estén ejecutando el paquete ABC durante el evento SQL que provoca la externalización del registro de seguimiento.

-START TRACE(PERFM) CLASS(3) DEST(SMF) PKGPROG(ABC)

Ejemplo: seguimiento contable para activar la contabilidad a nivel de paquete

Iniciar un seguimiento contable para activar la contabilidad a nivel de paquete y recopilar datos externalizados por IFCID 3 e IFCID 239. Utilice la opción PKGPROG para externalizar la información contable que se escribe cuando se registran los datos contables del paquete ABC.

-START TRACE(ACCTG) CLASS(1,2,3,7,8) DEST(SMF) PKGPROG(ABC)

Los registros externalizados contienen información de todos los paquetes que se ejecutan durante el intervalo de contabilidad.

Ejemplo: proporcionar filtrado de exclusión de IFC para ID de correlación

START TRACE (A) XCORRID (*)
- 10.46.05 STC00051  DSNW150I  ) EXCLUDE FOR ALL CORRID VALUES IS NOT       
-  ALLOWED                                                                  
- 10.46.05 STC00051  DSN9023I  ) DSNWVCM1 '-START TRACE' ABNORMAL COMPLETION

Ejemplo de seguimiento de auditoría utilizando la política de auditoría

Iniciar un seguimiento de auditoría utilizando la política de auditoría AUDITADMIN.

-STA TRACE(AUDIT) DEST(GTF) AUDTPLCY(AUDITADMIN)

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.