-START DYNQUERYCAPTURE comando (Db2)

El comando -START DYNQUERYCAPTURE estabiliza las rutas de acceso para consultas dinámicas en caché calificadas. Este mandato también puede iniciar opcionalmente la supervisión de las consultas dinámicas almacenadas en la memoria caché que cumplen los requisitos de un ámbito pero no llegan al umbral de ejecución especificado para la estabilización.

Todas las declaraciones en la caché de declaraciones dinámicas están calificadas para su captura, con las siguientes excepciones:

Consultas que se prepararon con la opción de enlace REOPT(AUTO)
Consultas que se prepararon con la opción CONCENTRATE STATEMENT WITH LITERALS bind
Las consultas que se transformaron porque hacen referencia a tablas de transparencia temporales del sistema, temporales de la aplicación o archivadas y uno o más de los siguientes ajustes utilizan un valor no predeterminado:
- SISTEMA ACTUAL HORA TEMPORAL registro especial
- NEGOCIO ACTUAL HORA TEMPORAL registro especial
- Variable global GET_ARCHIVE

Abreviatura : -STA DYNQUERY

Medio ambiente para -START DYNQUERYCAPTURE

Este comando puede emitirse desde la consola de z/OS®, a través de un trabajo por lotes o la interfaz de la instalación de instrumentación (IFI).

Ámbito de uso compartido de datos : Miembro

Autorización para -START DYNQUERYCAPTURE

Para ejecutar este mandato, debe utilizar un conjunto de privilegios del proceso que incluya una de las autorizaciones siguientes:

Autorización SQLADM
Autorización DBADM del sistema
autorización SYSOPR
Autorización SYSCTRL
Autorización SYSADM

Sintaxis para -START DYNQUERYCAPTURE

cache-snap-spec

Descripciones de opciones para -START DYNQUERYCAPTURE

STBLGRP

Nombre de grupo de estabilización proporcionado por un usuario. Puede utilizar el grupo de estabilización para asociar lógicamente un conjunto de consultas. El nombre del grupo de estabilización se puede utilizar como entrada para un comando FREE para liberar todas las consultas de un grupo de estabilización.

THRESHOLD

El umbral para estabilizar las sentencias SQL dinámicas. Cuando el número de ejecuciones de una sentencia cualificada es igual o mayor que el valor entero constante, la sentencia se programa para su estabilización.

Inicio del cambio Las ejecuciones de extractos solo se cuentan cuando IFCID 316 e IFCID 318 están activados. De lo contrario, el recuento de ejecuciones permanece en 0. fin del cambio

El valor por omisión es 2.

STMTID

Estabilizar una sentencia individual que tiene el valor STMTID especificado en la caché de sentencias dinámicas.

STMTTKN

Estabilizar una declaración individual que tenga el valor STMTTKN especificado.

CURSQLID

Especifica el alcance de las declaraciones capturadas:

*: Capturar todas las sentencias SQL dinámicas. Es el valor por omisión.
SQLID: El alcance de las sentencias SQL dinámicas capturadas se limita a las sentencias que tienen el valor CURRENT SQLID.

MONITOR

Especifica si se deben procesar las sentencias en la caché de sentencias y detener, o si se deben procesar las sentencias en la caché de sentencias y habilitar la supervisión de consultas que cumplen los requisitos del ámbito, pero que no han alcanzado el valor UMBRAL.

NEE: Programar la estabilización de las sentencias cualificadas dentro de la caché que superen el umbral de ejecución.
YES: Programar la estabilización de las declaraciones cualificadas que superen el umbral de ejecución y la supervisión de las declaraciones cualificadas que no hayan alcanzado el umbral de ejecución.
Si una declaración es elegible para su captura en más de un monitor, se aplica el monitor con el umbral más bajo. Si varios monitores elegibles tienen el mismo umbral, se aplica el monitor que se inició primero.

SCOPE

Especifica el alcance del comando.

LOCAL: Inicia la captura solo en el sistema de Db2 local.
GROUP: Inicia la captura en todos los miembros del grupo de intercambio de datos.

Notas de uso para -START DYNQUERYCAPTURE

detener e iniciar Db2: Si se detiene e inicia Db2 después de haber iniciado un DYNQUERY CAPTURE MONITOR, el monitor no se reinicia automáticamente.
Especificación del ÁMBITO (GRUPO): Si un monitor se inicia con SCOPE(GROUP), y un nuevo miembro se une al grupo de intercambio de datos después de que se inicie el monitor, el monitor no se inicia automáticamente en el nuevo miembro.

Ejemplos para -START DYNQUERYCAPTURE

Estabilizar consultas en la caché dinámica con CURRENT SQLID de ADMF001 y que se hayan ejecutado al menos 50 veces

Usted emite el siguiente comando:

-STA DYNQUERYCAPTURE STBLGRP(ABC) THRESHLD(50) CURSQLID(ADMF001)

La salida es similar a la del ejemplo siguiente:

DSNX221I -DB2A DSNXESTC DYNAMIC QUERY CAPTURE FOR
COMMAND NUMBER 3 STARTED SUCCESSFULLY.
DSNX222I -DB2A DSNXESC1 DYNAMIC QUERY CAPTURE
COMPLETED FOR COMMAND NUMBER 3 WITH 20 STATEMENTS SCHEDULED,
20 STATEMENTS STABILIZED, AND 0 STATEMENTS ALREADY STABILIZED.

Estabilizar todas las consultas en la caché dinámica de cada miembro del grupo de intercambio de datos que se hayan ejecutado al menos 200 veces

Usted emite el siguiente comando:

-STA DYNQUERYCAPTURE STBLGRP(DEF) THRESHLD(200) SCOPE(GROUP)

El resultado es similar al siguiente ejemplo. Los números en el resultado se acumulan de todos los miembros en el grupo de intercambio de datos:

DSNX221I -DB2A DSNXESTC DYNAMIC QUERY CAPTURE FOR
COMMAND NUMBER 2 STARTED SUCCESSFULLY.
DSNX222I -DB2A DSNXESC1 DYNAMIC QUERY CAPTURE
COMPLETED FOR COMMAND NUMBER 2 WITH 50 STATEMENTS SCHEDULED,
50 STATEMENTS STABILIZED, AND 3 STATEMENTS ALREADY STABILIZED.

Salida para -START DYNQUERYCAPTURE

Mensaje DSNX221I se emite cuando el comando START DYNQUERYCAPTURE no contiene errores de sintaxis.

Mensaje DSNX222I se emite al finalizar el procesamiento del comando START DYNQUERYCAPTURE.

Mensaje DSNX223I se emite si un comando START DYNQUERYCAPTURE anterior especificó el mismo SQLID.