Sucesos de aplicación

Un suceso de aplicación es un tipo de suceso de negocio que es el resultado de la actividad del programa de aplicación y contiene datos de aplicación.

Puede especificar que un suceso se emita cuando la aplicación emita cualquiera de los mandatos EXEC CICS API habilitados para sucesos o cuando se inicie un programa de aplicación. Los mandatos EXEC CICS habilitados para sucesos se muestran en Puntos de captura. Un conjunto limitado de módulos CICS también se ha habilitado para sucesos con el fin de permitir capturar sucesos de, por ejemplo, mandatos de archivo y de almacenamiento temporal pertenecientes al soporte de Atom, mandatos EXEC CICS LINK emitidos por los programas puente de CICS WebSphere MQ y mandatos de los ejemplos de CICS y la transacción CECI.

La especificación de captura define los criterios para la emisión de sucesos utilizando filtros, como el ID de transacción, el nombre de programa o el valor de opción del mandato EXEC CICS. Esta especificación de captura se puede refinar más filtrando los datos de aplicación asociados al mandato. Por ejemplo, puede especificar que el campo de área de comunicación que contiene un valor de pedido sea superior a 10.000. La especificación de captura también define la ubicación de los datos que deben capturarse.

La ubicación del suceso en la lógica de la aplicación dependerá de cómo se haya especificado. Si una aplicación de CICS contiene dos instancias del mismo mandato EXEC CICS API y la especificación de filtro no distingue entre los dos mandatos, se emite un suceso cuando se lanzan los dos mandatos. Si se ejecuta el mismo mandato EXEC CICS API en dos aplicaciones y no hay ningún filtro para el ID de transacción o el nombre de programa, se emite un suceso cuando se ejecutan ambas aplicaciones.

Puntos de captura

Puede capturar sucesos al inicio del programa (PGMINIT) y los siguientes mandatos EXEC CICS API. En la tabla siguiente se muestran los puntos de captura que se pueden especificar:

Tabla 1. Puntos de captura de sucesos de la aplicación
Punto de captura Predicado primario Predicado de filtro Datos de captura
Contexto Opción de suceso Opción de suceso Datos de aplicación
CONVERSE Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta
EIBAID
EIBPOSN

Ninguno

FROM
INTO-SET

Ninguno
DELETE FILE FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILE FILE RIDFLD
DELETEQ TD QUEUE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QUEUE QUEUE Ninguno
DELETEQ TS QNAME

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QNAME QNAME Ninguno
INVOKE SERVICE SERVICE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

SERVICEOPERATIONURICHANNELURIMAP

SERVICEOPERATIONURI CHANNEL
URIMAP

CHANNELSCOPE

LINK PROGRAM PROGRAM

ID de transacción
Programa actual
ID de usuario
Código de respuesta

PROGRAMCHANNEL

PROGRAMCHANNEL

COMMAREA
CHANNEL

PROGRAM INIT PROGRAM

ID de transacción
ID de usuario
Código de respuesta

PROGRAMCHANNEL

Ninguno

COMMAREA
CHANNEL

PUT CONTAINER CONTAINER

ID de transacción
Programa actual
ID de usuario
Código de respuesta

CONTAINERCHANNEL

CONTAINERCHANNEL

FROM
READ FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILEUPDATE

FILE

RIDFLD
INTO-SET

READNEXT FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILEUPDATE

FILE

RIDFLD
INTO-SET

READPREV FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILEUPDATE

FILE

RIDFLD
INTO-SET

READQ TD QUEUE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QUEUE QUEUE INTO-SET
READQ TS QNAME

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QNAME QNAME INTO-SET
RECEIVE Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta
EIBAID
EIBPOSN

NONE NONE INTO-SET
RECEIVE MAP MAP

ID de transacción
Programa actual
ID de usuario
Código de respuesta
EIBAID
EIBPOSN

MAPMAPSET

MAPMAPSET

INTO-SET
RETRIEVE Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

NONE NONE INTO-SET
RETURN Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

TRANSIDCHANNEL

TRANSIDCHANNEL

COMMAREA
CHANNEL

REWRITE FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILE FILE FROM
SEND Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

NONE NONE FROM
SEND MAP MAP

ID de transacción
Programa actual
ID de usuario
Código de respuesta

MAPMAPSETALARM

MAPMAPSET

FROM
SEND TEXT Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

ALARM NONE FROM
SIGNAL EVENT 1 EVENT

ID de transacción
Programa actual
ID de usuario
Código de respuesta

EVENTFROMCHANNEL

EVENTFROMCHANNEL

FROM
FROMCHANNEL

START TRANSID

ID de transacción
Programa actual
ID de usuario
Código de respuesta

TRANSIDCHANNEL

TRANSIDCHANNEL

FROM
CHANNEL

WEB READ

FORMFIELD
HTTPHEADER
QUERYPARM

Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

NONE NONE

FORMFIELD
INTO-SET
VALUE

WEB READNEXT

FORMFIELD
HTTPHEADER
QUERYPARM

Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

NONE NONE

FORMFIELD
VALUE

WRITE FILE FILE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

FILE FILE RIDFLD FROM
WRITE OPERATOR Ninguno

ID de transacción
Programa actual
ID de usuario
Código de respuesta

NONE NONE TEXT 2
WRITEQ TD QUEUE

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QUEUE QUEUE FROM
WRITEQ TS QNAME

ID de transacción
Programa actual
ID de usuario
Código de respuesta

QNAME QNAME FROM
XCTL PROGRAM

ID de transacción
Programa actual
ID de usuario
Código de respuesta

PROGRAMCHANNEL

PROGRAMCHANNEL

COMMAREA
CHANNEL

Todos los puntos de captura definen los mismos elementos de captura de contexto, PROGRAM, TRANSID y USERID.

Nota: 1 El único propósito del mandato SIGNAL EVENT API es proporcionar datos para un suceso. Un suceso sólo se emite si hay una especificación de captura coincidente habilitada en el sistema CICS.
Nota: 2 Una longitud de 0 cuando especifica datos de aplicación en las pestañas de fuentes de información significa capturar la totalidad del área de datos o contenedor. Este valor es útil cuando desea emitir el contenido de un EXEC CICS WRITE OPERATOR. Para obtener más información, consulte La pestaña Fuentes de información.
Para obtener más información sobre los puntos de captura que puede seleccionar, consulte los apartados La pestaña Punto de captura y La pestaña Fuentes de información en el editor de enlaces de sucesos de CICS.