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.
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:
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 |
Ninguno | FROM |
Ninguno |
DELETE FILE | FILE | ID de transacción |
FILE | FILE | RIDFLD |
DELETEQ TD | QUEUE | ID de transacción |
QUEUE | QUEUE | Ninguno |
DELETEQ TS | QNAME | ID de transacción |
QNAME | QNAME | Ninguno |
INVOKE SERVICE | SERVICE | ID de transacción |
SERVICEOPERATIONURICHANNELURIMAP |
SERVICEOPERATIONURI CHANNEL |
CHANNELSCOPE |
LINK PROGRAM | PROGRAM | ID de transacción |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
PROGRAM INIT | PROGRAM | ID de transacción |
PROGRAMCHANNEL |
Ninguno | COMMAREA |
PUT CONTAINER | CONTAINER | ID de transacción |
CONTAINERCHANNEL |
CONTAINERCHANNEL |
FROM |
READ | FILE | ID de transacción |
FILEUPDATE |
FILE | RIDFLD |
READNEXT | FILE | ID de transacción |
FILEUPDATE |
FILE | RIDFLD |
READPREV | FILE | ID de transacción |
FILEUPDATE |
FILE | RIDFLD |
READQ TD | QUEUE | ID de transacción |
QUEUE | QUEUE | INTO-SET |
READQ TS | QNAME | ID de transacción |
QNAME | QNAME | INTO-SET |
RECEIVE | Ninguno | ID de transacción |
NONE | NONE | INTO-SET |
RECEIVE MAP | MAP | ID de transacción |
MAPMAPSET |
MAPMAPSET |
INTO-SET |
RETRIEVE | Ninguno | ID de transacción |
NONE | NONE | INTO-SET |
RETURN | Ninguno | ID de transacción |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
COMMAREA |
REWRITE | FILE | ID de transacción |
FILE | FILE | FROM |
SEND | Ninguno | ID de transacción |
NONE | NONE | FROM |
SEND MAP | MAP | ID de transacción |
MAPMAPSETALARM |
MAPMAPSET |
FROM |
SEND TEXT | Ninguno | ID de transacción |
ALARM | NONE | FROM |
SIGNAL EVENT 1 | EVENT | ID de transacción |
EVENTFROMCHANNEL |
EVENTFROMCHANNEL |
FROM |
START | TRANSID | ID de transacción |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
FROM |
WEB READ | Ninguno | ID de transacción |
NONE | NONE | FORMFIELD |
WEB READNEXT | Ninguno | ID de transacción |
NONE | NONE | FORMFIELD |
WRITE FILE | FILE | ID de transacción |
FILE | FILE | RIDFLD FROM |
WRITE OPERATOR | Ninguno | ID de transacción |
NONE | NONE | TEXT 2 |
WRITEQ TD | QUEUE | ID de transacción |
QUEUE | QUEUE | FROM |
WRITEQ TS | QNAME | ID de transacción |
QNAME | QNAME | FROM |
XCTL | PROGRAM | ID de transacción |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
Todos los puntos de captura definen los mismos elementos de captura de contexto, PROGRAM, TRANSID y USERID.