EXTRACT STATISTICS

Descripción

El mandato EXTRACT STATISTICS devuelve a la aplicación que realiza la invocación las estadísticas actuales de un recurso determinado o las estadísticas globales de los recursos de un tipo determinado.

Las estadísticas que CICS devuelve son las que se han acumulado después de la caducidad del último intervalo de extracción de estadísticas, la caducidad de fin de día o el restablecimiento solicitado. No se puede acceder a las estadísticas ya grabadas en el conjunto de datos SMF. El mandato EXTRACT STATISTICS no hace que se restablezcan los contadores de estadísticas.

CICS obtiene suficiente almacenamiento para los datos devueltos por este mandato y devuelve un puntero a esta área. Los dos primeros bytes del área contienen su longitud. Este almacenamiento lo pueden reutilizar los mandatos EXTRACT STATISTICS subsiguientes, por lo que debe almacenar en otro lugar los datos que sean necesarios más allá de la siguiente emisión del mandato. CICS libera este almacenamiento al finalizar la tarea.

Para los tipos de recursos que están soportados como recursos privados para aplicaciones desplegadas en plataformas, se escriben diferentes registros de estadísticas para recursos públicos y para recursos privados, cada uno correlacionado por un libro de copias diferente o DSECT. Los tipos de recursos LIBRARY, JVMPROGRAM, PROGRAM y PROGRAMDEF están soportados como recursos privados. Si un recurso es un recurso público, se utiliza el libro de copias público para correlacionar sus datos, y si un recurso es un recurso privado, se utiliza el libro de copias privado para correlacionar sus datos.

Cuando se utiliza el mandato EXEC CICS EXTRACT STATISTICS o EXEC CICS COLLECT STATISTICS para devolver estadísticas para un programa especificado declarado como punto de entrada de aplicación, sólo se devuelve un registro de estadísticas. Si el comando se emite en o para un contexto de aplicación, y el programa se definió como un recurso privado para la aplicación, se utiliza el DSECT para recursos privados para dar formato a los datos, incluso si el programa se ha promocionado actualmente a programa público para que el punto de entrada de la aplicación esté disponible.

Se facilitan copybooks en ASSEMBLER, C®, COBOL, y PL/I.

Los nombres de los libros de copias son los mismos en cada idioma. Puede encontrarlos en las bibliotecas siguientes. Tenga en cuenta que en la tabla siguiente, CICSTSnn es el release de CICS .

Para obtener más información sobre estos libros de copias, consulte Introducción a las estadísticas de CICS.

Opciones

APPLICATION(valor-datos)

Especifica el elemento de nombre de aplicación del contexto de aplicación. El nombre de aplicación puede tener una longitud máxima de 64 caracteres.

Especifique el contexto de aplicación para devolver estadísticas para un recurso privado que forma parte de una aplicación desplegada en una plataforma. Las estadísticas para recursos privados sólo se pueden devolver como estadísticas específicas, o de recursos, para un recurso con nombre de los tipos de recurso JVMPROGRAM, LIBRARY, PROGRAM o PROGRAMDEF, que están soportados como recursos privados. Debe especificar un contexto de aplicación completo, incluido el nombre de plataforma, el nombre de aplicación y el número de versión completo de la aplicación. Si el recurso privado que ha especificado en la opción RESID no se encuentra en el contexto de aplicación especificado, no se devolverá ninguna estadística.

No es necesario especificar un contexto de aplicación si el mandato se emite desde un programa que forma parte de la aplicación relevante. De forma predeterminada, CICS devuelve estadísticas para un recurso privado de la aplicación donde se emite el mandato, o estadísticas para un recurso público si no se puede encontrar ningún recurso privado.

APPLMAJORVER(valor-datos)

Especifica el elemento de versión principal de la aplicación del contexto de la aplicación, en formato binario de palabra completa.

APPLMINORVER(valor-datos)

Especifica el elemento de versión menor de aplicación del contexto de aplicación, en formato binario de palabra completa.

APPLXX_ENCODE_CASE_ONE microver(valor-datos)

Especifica el elemento de micro versión de aplicación del contexto de aplicación, en formato binario de palabra completa.

LASTRESET (área-datos)

Devuelve un campo decimal empaquetado de 4 bytes que indica la hora a la que se restablecieron por última vez los contadores para las estadísticas solicitadas. Esta hora suele ser cuando ha caducado el último intervalo. La hora del último restablecimiento siempre se devuelve en la hora local.

La hora de restablecimiento tiene dos formatos:

• Un formato compuesto (formato decimal empaquetado 0hhmmss+), que se obtiene utilizando la opción LASTRESET.
• Separe las horas, minutos y segundos, que obtendrá especificando las opciones LASTRESETHRS, LASTRESETMIN y LASTRESETSEC respectivamente.

LASTRESESEPARADORES (área-datos)

Devuelve un campo decimal empaquetado de 8 bytes que indica la hora a la que se restablecieron por última vez los contadores para las estadísticas solicitadas. El valor devuelto está en formato ABSTIME. ABSTIME especifica el número de milisegundos desde las 00:00 del 1 de enero de 1900, que se conoce como hora absoluta.

Puede utilizar FORMATTIME para cambiar los datos a otros formatos familiares.

El formato de área-datos es:

COBOL:  PIC S9(15) COMP-3
C:      char data_area[8];
PL/I:   FIXED DEC(15)
ASM:    PL8

LASTRESETHRS (área-datos)

Devuelve un campo binario de palabra completa que proporciona el componente de horas de la hora en la que se restablecieron por última vez los contadores para las estadísticas solicitadas (consulte la opción LASTRESET).

LASTRESETMIN (área-datos)

Devuelve un campo binario de palabra completa que proporciona el componente de minutos de la hora en la que se restablecieron por última vez los contadores para las estadísticas solicitadas (consulte la opción LASTRESET).

LASTRESETSEC (área-datos)

Devuelve un campo binario de palabra completa que proporciona el componente de segundos de la hora en la que se restablecieron por última vez los contadores para las estadísticas solicitadas (consulte la opción LASTRESET).

PLATFORM(valor-datos)

Especifica el elemento de nombre de plataforma del contexto de aplicación. El nombre de plataforma puede tener hasta 64 caracteres de longitud.

RESTYPE (cvda)

Solicita estadísticas para un tipo de recurso determinado en función del valor CVDA proporcionado. Los valores CVDA válidos son los siguientes:

ASYNCSERVICE

Solicitar estadísticas globales para el dominio de servicios asíncronos.

ATOMSERVICE

Solicitar estadísticas para un recurso ATOMSERVICE; RESID identifica la definición de recurso ATOMSERVICE en particular.

BUNDLE

Solicitar estadísticas para un recurso BUNDLE; RESID identifica la definición de recurso BUNDLE en particular.

DB2CONN

Estadísticas de solicitud para la conexión CICS-Db2® incluyendo información para hebras de agrupación y hebras de mandato.

DB2ENTRY

Solicitar estadísticas para un DB2ENTRY; RESID identifica el DB2ENTRYconcreto.

DISPATCHER

Solicitar estadísticas para el dominio del asignador.

DOCTEMPLATE

Solicitar estadísticas para una plantilla de documento; RESID identifica la definición de recurso DOCTEMPLATE en particular.

ENQUEUE

Estadísticas de solicitud para solicitudes de puesta en cola.

EPADAPTER

Solicitar estadísticas para un recurso EPADAPTER; RESID identifica la definición de recurso EPADAPTER en particular.

EVENTBINDING

Estadísticas de solicitud para un recurso EVENTBINDING en particular; RESID identifica la definición de recurso EVENTBINDING en particular.

PROCESOSUCESOS

Solicitar estadísticas globales en el dominio de proceso de sucesos.

FILE

Solicitar estadísticas para un archivo. RESID identifica la definición de archivo en particular.

IPCONN

Estadísticas de solicitud para un recurso IPCONN; RESID identifica la definición de recurso IPCONN en particular.

JOURNALNAME

Solicitar estadísticas para un diario de CICS . RESID identifica el diario en particular. Para recopilar estadísticas para los diarios definidos utilizando el convenio de numeración de diario (por ejemplo, para los diarios automáticos definidos en las definiciones de recursos de archivo), especifique el nombre como DFHJnn, donde nn es el número de diario en el rango 01-99.

Nota: al especificar DFHJ01 se devuelven las estadísticas escritas en un diario de usuario con ese nombre, no en el registro del sistema.

PROGRAMAJVM

Solicitar estadísticas para un programa Java™ . RESID identifica la definición de recurso PROGRAM en particular.

JVMSERVER

Estadísticas de solicitud para un recurso JVMSERVER; RESID identifica la definición de recurso JVMSERVER en particular.

LIBRARY

Solicitar estadísticas para un recurso LIBRARY; RESID identifica la definición de recurso LIBRARY en particular.

LSRPOOL

Estadísticas de solicitud en una agrupación LSR de VSAM; RESID identifica la agrupación en particular, en el rango 1-255, en formato binario de palabra completa.

MONITOR

Solicitar estadísticas para el dominio de supervisión. RESID identifica una tarea determinada, en formato decimal empaquetado de 4 bytes, para la que se van a devolver estadísticas de clase de rendimiento.

MQCONN

Solicitar estadísticas para una conexión IBM® MQ .

MQMONITOR

Solicitar estadísticas para un supervisor MQ . RESID identifica un supervisor MQ determinado.

MVSTCB

Estadísticas de solicitud para TCB de z/OS® . RESID identifica la dirección de un TCB determinado.

PIPELINE

Estadísticas de solicitud para un recurso PIPELINE; RESID identifica la definición de recurso PIPELINE en particular.

POLICY

Combinado con POLICYRULE, solicitar estadísticas para una regla de política. RESID identifica la definición de recurso POLICY concreta que contiene la regla de política.

Nota: Debe especificarse POLICY y POLICYRULE en la solicitud; si falta alguna, la solicitud fallará con la condición INVREQ.

PROGRAMA

Solicitar estadísticas sobre las definiciones de programa instaladas automáticamente.

programa

Solicitar estadísticas para programas no Java. RESID identifica un programa determinado.

PROGRAMDEF

Solicitar estadísticas sobre una definición de programa. RESID identifica un programa determinado.

RECOVERY

Solicitar estadísticas para el dominio del gestor de recuperación.

SECURITY

Solicitar estadísticas para el dominio de seguridad.

ESTADÍSTICAS

Solicitar estadísticas en el dominio de estadísticas.

STORAGE

Solicitar estadísticas para un dominio de almacenamiento. Un RESID especifica las estadísticas que deben devolverse para una subagrupación de dominio de almacenamiento determinada. Una lista completa de los posibles nombres de subagrupación se documenta en las subagrupaciones CICS en ECDSA.

SUBPOOL

Solicitar estadísticas para una subagrupación de dominio de gestor de almacenamiento. El RESID especifica la subagrupación de dominio de almacenamiento en particular. Una lista completa de los posibles nombres de subagrupación se documenta en las subagrupaciones CICS en ECDSA.

STREAMNAME

Solicite estadísticas para el dominio del gestor de registros de CICS , o si se especifica RESID en una secuencia de registros determinada.

SYSDUMPCODE

Solicite estadísticas sobre vuelcos del sistema, o si se ha especificado RESID en un código de vuelco del sistema determinado.

SUBGRUPO DE TAREAS

Solicitar estadísticas para una subagrupación de tareas del gestor de almacenamiento.

TCPIP

Solicitar estadísticas para sockets IP.

TCPIPSERVICE

Solicitar estadísticas para un servicio TCP/IP; RESID identifica el servicio TCP/IP en particular.

SUBGRUPO DE TAREAS

Solicitar estadísticas para una subagrupación de tareas del gestor de almacenamiento.

TDQUEUE

Solicita estadísticas para datos transitorios, o si se especifica un RESID, una cola de datos transitorios determinada.

TRANCLASS

Solicitar estadísticas para una clase de transacción. RESID identifica la definición de TRANCLASS en particular.

TRANDUMPCODE

Solicite estadísticas sobre volcados de transacción o, si se especifica RESID, un código de volcado de transacción determinado.

TRANSACTION

Solicitar estadísticas sobre transacciones, o si se especifica RESID, una transacción determinada.

TSQUEUE

Solicitar estadísticas sobre el almacenamiento temporal.

URIMAP

Solicitar estadísticas para un recurso URIMAP; RESID identifica la definición de recurso URIMAP en particular.

USER

Solicitar estadísticas para el dominio de usuario.

WEBSERVICE

Estadísticas de solicitud para un recurso WEBSERVICE; RESID identifica la definición de recurso WEBSERVICE en particular.

XMLTRANSFORM

Estadísticas de solicitud para un recurso XMLTRANSFORM; RESID identifica la definición de recurso XMLTRANSFORM en particular.

RESID (área-datos)

Especifica el nombre de un recurso determinado para el que se van a devolver estadísticas. La ausencia de esta palabra clave significa que se van a extraer las estadísticas globales. RESID es un campo de caracteres.

Si se especifica RESID, la comprobación de seguridad de recursos se realizará en el recurso CICS . Por lo tanto, el usuario que emite EXTRACT STATISTICS necesita acceso READ al recurso.

RESIDLEN (valor-datos)

Especifica la longitud del área de datos RESID. Si se omite, el valor por defecto es la longitud indicada en la Tabla 1.

SET (ref-ptr)

Especifica una referencia de puntero que debe establecerse en la dirección del área de datos que contiene las estadísticas devueltas. Los 2 primeros bytes del área de datos contienen la longitud del área de datos en formato binario de media palabra.

SUBRESTYPE (cvda)

Solicita estadísticas para un tipo de recurso determinado en función del valor CVDA proporcionado. Para su uso, véase el Cuadro 1. Los valores CVDA válidos son los siguientes:

CAPTURESPEC

Solicitar estadísticas para una especificación de captura. Este parámetro subrestype es opcional.

REGLA de política

Solicitar estadísticas para una regla de política que está contenida en un recurso POLICY determinado. Este parámetro subrestype es obligatorio. Consulte Nota.

SUBRESID (área-datos)

Especifica el nombre del recurso concreto para el que se están extrayendo las estadísticas. La ausencia de esta palabra clave significa que se deben extraer las estadísticas para el RESTYPE especificado. SUBRESID es un campo de caracteres.

Si se especifica SUBRESID, la comprobación de seguridad de recursos se realizará en el recurso CICS . Por lo tanto, el usuario que emite EXTRACT STATISTICS necesita acceso READ al recurso.

SUBRESIDLEN (valor-datos)

Especifica la longitud del área de datos SUBRESID. Si se omite, el valor por defecto es la longitud indicada en la Tabla 1.

Condiciones

APLICACIÓN NO ENCONTRADA

Valores de RESP2:

1

El mandato se ha emitido especificando un contexto de aplicación, pero no se ha encontrado la aplicación especificada.

INVREQ

Valores de RESP2:

5

Se ha especificado un RESTYPE no válido. Los tipos válidos se enumeran en la Tabla 1.

6

No se ha especificado un RESID obligatorio para el RESTYPE solicitado.

8

Se ha especificado un SUBRESTYPE no válido. Los tipos válidos se enumeran en la Tabla 1.

9

No se ha especificado un SUBRESID obligatorio para el SUBRESTYPE solicitado.

11

Se ha especificado una combinación RESTYPE y SUBRESTYPE no válida. Los tipos válidos se enumeran en la Tabla 1.

IOERR

Valores de RESP2:

3

El área de estadísticas solicitada no funcionaba. Este problema se produce si, por ejemplo, se sobrescriben los bloques de control de estadísticas.

LENGERR

Valores de RESP2:

7

Se ha proporcionado un RESIDLEN no válido para el RESID solicitado.

10

Se ha proporcionado un SUBRESIDLEN no válido para el SUBRESID solicitado.

NOTAUTH

Valores de RESP2:

100

El usuario asociado con la tarea emisora no está autorizado a utilizar este mandato.

101

El usuario asociado con la tarea emisora no tiene autorización para acceder a este recurso concreto de la forma que requiere este mandato.

NOTFND

Valores de RESP2:

1

No se puede encontrar el recurso solicitado.

2

El tipo de recurso no está definido en el sistema CICS ; por ejemplo, si se solicitan estadísticas FEPI con POOL o NODE cuando el parámetro de inicialización del sistema FEPI especifica NO.

6.2 y más tarde 3

Los datos de clase de rendimiento para la tarea no están disponibles. En el momento en que se inicializa la tarea, la supervisión se desactiva o la clase de rendimiento de supervisión no está activa.