-DISPLAY FUNCTION SPECIFIC comando (Db2)

El comando -DISPLAY FUNCTION SPECIFIC muestra estadísticas sobre funciones externas definidas por el usuario a las que acceden las aplicaciones de Db2 .

Abreviatura : -DIS FUNC SPEC

Medio ambiente para -DISPLAY FUNCTION SPECIFIC

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

Ámbito de uso compartido de datos: Grupo o miembro

Autorización para -DISPLAY FUNCTION SPECIFIC

Para ejecutar este comando, debe utilizar un conjunto de privilegios del proceso que incluya una de las siguientes autoridades para cada función:
  • Privilegio de VISUALIZACIÓN
  • Autorización DBADM del sistema
  • autorización SYSOPR
  • Autorización SYSCTRL
  • Autorización SYSADM
Si especifica FUNCIÓN DE VISUALIZACIÓN ESPECÍFICA *.* o schema.partial-name *, debe utilizar un conjunto de privilegios del proceso que incluya una de las siguientes autorizaciones:
  • autorización SYSOPR
  • Autorización SYSCTRL
  • Autorización SYSADM

Db2 los comandos que se emiten desde una consola de z/OS conectada o desde TSO SDSF pueden comprobarse mediante la autorización de Db2 utilizando ID de autorización principal y secundaria. Inicio del cambioDebe definirse un ID de usuario de z/OS conectado en RACF o un servidor de seguridad similar.fin del cambio

Si utiliza un producto de seguridad externo para autorizar el uso de DISPLAY FUNCTION SPECIFIC, defina SYSOPR como usuario del producto de seguridad externo para aquellos casos en los que DISPLAY FUNCTION SPECIFIC SCOPE(GROUP) se ejecute en un sistema remoto y SYSOPR se utilice como ID de autorización.

Sintaxis para -DISPLAY FUNCTION SPECIFIC

Leer diagrama de sintaxisOmitir el diagrama de sintaxis visualDISPLAY FUNCTION SPECIFIC( *.*)(,schema.specific-function-nameschema.partial-name*)SCOPE(LOCALGROUP)

Descripciones de opciones para -DISPLAY FUNCTION SPECIFIC

schema.specific-function-name
Muestra información para la función específica nombrada en el esquema especificado. No puede especificar un nombre de función como puede hacer en SQL; debe utilizar el nombre específico. Si no se especificó un nombre específico en la declaración CREATE FUNCTION, consulte SYSIBM.SYSROUTINES para obtener el nombre específico correcto:
SELECT SPECIFICNAME, PARM_COUNT
  FROM SYSIBM.SYSROUTINES
   WHERE NAME='function_name'
    AND SCHEMA='schema_name';
Para funciones sobrecargadas, esta consulta puede devolver varias filas.
schema.partial-name*
Muestra información para un conjunto de funciones en el esquema especificado.

Los nombres específicos de todas las funciones del conjunto comienzan con nombre-parcial y pueden terminar con cualquier cadena, incluida la cadena vacía. Por ejemplo, schema1.ABC* muestra información de todas las funciones con nombres específicos que empiezan por ABC en schema1.

(*.*)
Muestra información de todas las funciones a las que han accedido las aplicaciones de Db2 desde que se inició el subsistema Db2 .
SCOPE
Especifica el alcance del comando.
( LOCAL )
Especifica que la pantalla incluye información solo del miembro local.
(GRUPO)
Especifica que la pantalla incluye información de todos los miembros del grupo de intercambio de datos.

Notas de uso para -DISPLAY FUNCTION SPECIFIC

Mostrar información de todas las funciones
Si no especifica un nombre de función parcial o específico, Db2 muestra información de todas las funciones a las que han accedido las aplicaciones Db2 desde que se inició el subsistema Db2 .
Funciones integradas o funciones definidas por el usuario que se obtienen de otra función
Este comando no se aplica a las funciones integradas ni a las funciones definidas por el usuario que se originan en otra función.
Visualización de funciones SQL

Las funciones SQL se muestran en la salida DISPLAY FUNCTION SPECIFIC solo si invoca la función en modo depuración. En ese caso, la columna de entorno WLM en la salida contiene el entorno WLM que especificó para la depuración cuando creó la función SQL.

La salida de la FUNCIÓN DE VISUALIZACIÓN muestra las estadísticas de una función SQL como «0» si la función está bajo el efecto de un comando de DETENCIÓN DE FUNCIÓN.

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 ámbito de aplicación de Command en el intercambio de datos de Db2.

Salida para -DISPLAY FUNCTION SPECIFIC

El DSNX975I mensaje muestra el resultado del comando DISPLAY FUNCTION SPECIFIC . El resultado de este comando tiene la siguiente estructura general:

DSNX975I csect-name - DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-

------ SCHEMA = schema
FUNCTION STATUS ACTIVE QUED  MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env


------ SCHEMA = schema
csect-name ALL FUNCTIONS STARTED FOR THIS SCHEMA.
FUNCTION STATUS ACTIVE QUED  MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env


------ SCHEMA = schema
FUNCTION STATUS ACTIVE QUED  MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
 FUNCTIONS begin - end STOP (act)
...

csect-name ALL OTHER FUNCTIONS IN OTHER SCHEMAS STOPPED act

DISPLAY FUNCTION SPECIFIC REPORT COMPLETE

El resultado que se muestra varía en función de las funciones externas definidas por el usuario que cumplan los requisitos. Los mensajes de error también pueden incluirse en el resultado.

La siguiente información puede proporcionarse en el resultado:

nombre-csect
El nombre de la sección de control que ha emitido el mensaje.
SCHEMA = esquema
El nombre del esquema para las funciones que se incluyen en la salida.

El nombre del esquema y las líneas que siguen se repiten tantas veces como sea necesario para satisfacer la solicitud de FUNCIÓN DE VISUALIZACIÓN ESPECÍFICA.

FUNCIÓN función
El nombre de la función externa.

Se incluye una línea de salida para cada función solicitada.

STATUS estado
El estado de la función. El estado puede ser cualquiera de los siguientes valores:
INICIADO
La función puede aceptar solicitudes de instrucciones SQL.
STOPABN
La función se detuvo debido a una finalización anormal previa de la aplicación de la función. Las solicitudes de instrucciones SQL para la función son rechazadas.
STOPQUE
La función se ha detenido. Las solicitudes de instrucciones SQL para la función se ponen en cola hasta que se inicia la función o hasta que expira el intervalo de tiempo de espera definido por el parámetro del subsistema STORTIME.
STOPREJ
La función se colocó en este estado mediante el comando DETENER FUNCIÓN ESPECÍFICA con la opción ACCIÓN (RECHAZAR). Las solicitudes de instrucciones SQL para la función son rechazadas.

Si la función se encuentra en alguno de los estados detenidos, puede utilizar el comando INICIAR FUNCIÓN ESPECÍFICA para iniciar la función.

ACTIVO activo
El número de agentes de Db2 que actualmente ejecutan esta función.
QUEDAR QUEDADO
El número de agentes de ventas ( Db2 ) que están esperando actualmente a que se programe esta función.
MAXQ maxq
El número máximo de agentes de Db2 que han esperado a que se programe esta función desde que se emitió el último comando START SPECIFIC FUNCTION para esta función.
TIEMPO DE ESPERA tiempo de espera
El número de veces que una instrucción SQL ha agotado el tiempo de espera mientras esperaba a que se programara la función desde que se emitió el último comando START SPECIFIC FUNCTION para esta función.

Una sentencia SQL puede agotar el tiempo de espera si la función se detiene mediante el comando DETENER FUNCIÓN ESPECÍFICA con la opción ACCIÓN (COLA). Esta especificación provoca que las solicitudes de la función agoten el tiempo de espera después de que se exceda el intervalo definido por el parámetro del subsistema STORTIME.

FALLO fallar
El número de veces que esta función se ha desactivado desde la última vez que se inició.
WLM_ENV wlm_env
El nombre del entorno MVS Workload Manager para esta función.
TODAS LAS FUNCIONES INICIADAS PARA ESTE ESQUEMA.
Esta línea se muestra cuando se cumplen las dos condiciones siguientes:
  • Una operación de comando ESPECÍFICO DE FUNCIÓN DE PARADA (*.*) estaba en vigor cuando se emitió ESPECÍFICO DE FUNCIÓN DE VISUALIZACIÓN.
  • Todas las funciones se inician para el esquema identificado en una línea anterior en la salida.
FUNCIONES: inicio - fin STOP (acción )
Esta línea se muestra cuando un comando DETENER FUNCIÓN ESPECÍFICA ha provocado la detención de una serie de funciones. Esta situación puede ocurrir cuando el comando se emitió con un asterisco (*) en el nombre de la función.
begin
El primer nombre de función en el rango de funciones que están actualmente detenidas.
end
El último nombre de función en el rango de funciones que están actualmente detenidas.
act
La acción que se especificó en el comando DETENER FUNCIÓN ESPECÍFICA.
TODAS LAS DEMÁS FUNCIONES EN OTROS ESQUEMAS DETENIDAS act
Esta línea se muestra cuando se cumplen las dos condiciones siguientes:
  • Una operación de comando ESPECÍFICO DE FUNCIÓN DE PARADA (*.*) estaba en vigor cuando se emitió el comando ESPECÍFICO DE FUNCIÓN DE PANTALLA.
  • Se detienen todas las funciones que no estén ya enumeradas en esta salida FUNCIÓN DE VISUALIZACIÓN ESPECÍFICA.

act indica la acción que se especificó en el comando DETENER FUNCIÓN.

VISUALIZAR FUNCIÓN INFORME ESPECÍFICO COMPLETAR
El informe se ha completado correctamente.

Mensajes de ERROR para - FUNCIÓN DE VISUALIZACIÓN ESPECÍFICA

Los siguientes mensajes en la salida DISPLAY FUNCTION SPECIFIC indican que se ha producido un error:

csect-name NO SE HA ACCEDIDO A LA FUNCIÓN O NO ESTÁ DEFINIDA
El nombre de rutina que se proporcionó en el comando DISPLAY FUNCTION SPECIFIC no existe o no se ha accedido a él desde que se inició Db2 . Es posible que el nombre de la función específica no esté en la tabla de catálogos de SYSIBM.SYSROUTINES.

El procesamiento continúa para cualquier nombre de rutina adicional que se haya proporcionado en el comando.

VISTA TERMINADA CON MÁX. LÍNEAS
El informe FUNCIÓN DE VISUALIZACIÓN ESPECÍFICA se ha truncado. El informe se generó en respuesta a un comando de una consola MVS, y se generaron más de 254 mensajes. Solo se devuelven 254 mensajes.

El procesamiento del comando se ha completado. El informe truncado se escribe en la consola MVS.

Vuelva a emitir el comando DISPLAY FUNCTION SPECIFIC y especifique un número menor de rutinas. Especifique una lista de rutinas, un calificador de esquema o un nombre parcial de rutina en el comando DISPLAY en lugar del valor predeterminado (*.*). Como alternativa, vuelva a emitir el comando desde el panel DB2 Commands de DB2I o desde un trabajo por lotes en lugar de hacerlo desde la consola MVS.

DSNX994I EL MANDO DE ÁMBITO (GRUPO) NO PUEDE PROCESARSE DEBIDO A QUE EL MANDO YA ESTÁ EN CURSO
Ver DSNX994I.

Ejemplos para -DISPLAY FUNCTION SPECIFIC

Ejemplo: Mostrar información sobre todas las funciones definidas por el usuario en un esquema
El siguiente comando muestra información sobre todas las funciones en el esquema PAYROLL y el esquema HRPROD.
-DISPLAY FUNCTION SPECIFIC(PAYROLL.*, HRPROD.*)

El resultado es similar al siguiente resultado:

DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-

------ SCHEMA=PAYROLL
FUNCTION        STATUS      ACTIVE   QUED   MAXQ   TIMEOUT   FAIL    WLM_ENV
PAYRFNC1        STARTED       0       0       1       0       0      WLMENV1
PAYRFNC2        STOPQUE       0       5       5       3       0      WLMENV1
PAYRFNC3        STARTED       2       0       6       0       0      WLMENV1
USERFNC4        STOPREJ       0       0       1       0       0      WLMENV3
 
------ SCHEMA=HRPROD
FUNCTION        STATUS      ACTIVE   QUED   MAXQ   TIMEOUT   FAIL    WLM_ENV
HRFNC1          STARTED       0       0       1       0       0      WLMENV2
HRFNC2          STOPREJ       0       0       1       0       0      WLMENV2
DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE
DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION
Ejemplo: Mostrar información sobre funciones definidas por el usuario seleccionadas en un esquema
El siguiente comando muestra información sobre las funciones USERFNC2 y USERFNC4 en el esquema PAYROLL.
-DISPLAY FUNCTION SPECIFIC(PAYROLL.USERFNC2,PAYROLL.USERFNC4)

El resultado es similar al siguiente resultado:

DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-
 
------ SCHEMA=PAYROLL
FUNCTION        STATUS      ACTIVE   QUED   MAXQ   TIMEOUT   FAIL    WLM_ENV
USERFNC2        STOPQUE       0       5       5       3       0      WLMENV3
USERFNC4        STOPREJ       0       0       1       0       0      WLMENV3
DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE
DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION
Ejemplo: Mostrar información sobre funciones definidas por el usuario detenidas
Supongamos que emite los siguientes comandos:
-STOP FUNCTION SPECIFIC(SYSADM.FN*) ACTION(QUEUE)
-DISPLAY FUNCTION SPECIFIC(SYSADM.*)

El resultado es similar al siguiente:

DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-
 
------ SCHEMA=SYSADM
FUNCTION       STATUS    ACTIVE   QUED  MAXQ  TIMEOUT  FAIL   WLM_ENV
FNC1           STOPQUE     0       0     0       0      0     WLMENV1
FNC2           STOPQUE     0       0     0       0      0     WLMENV3
DSNX9DIS FUNCTIONS FN - FN* STOP QUEUE
DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE
DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION