Evénements d'application

Un événement d'application est un type d'événement métier résultant de l'activité d'un programme d'application et contenant les données de l'application.

Vous pouvez spécifier l'émission d'un événement lorsque l'application exécute l'une des commandes EXEC CICS API activées suite à un événement ou lorsqu'un programme d'application est initié. Les commandes EXEC CICS activées par les événements sont présentées dans Points de capture. Un jeu limité de modules CICS a également été activé par événement et vous pouvez capturer des événements à partir de ce dernier, par exemple à partir de commandes de fichier et de stockage temporaire provenant du support Atom, de commandes EXEC CICS LINK exécutées par les programmes de liaison MQ CICS WebSphere ou de commandes provenant d'exemples CICS et de la transaction CECI.

La spécification de capture définit les critères d'émission d'événement à l'aide de filtres, tels que l'ID de transaction, le nom du programme ou la valeur de l'option de commande EXEC CICS. Cette spécification peut encore être affinée en filtrant les données d'application associées à la commande. Par exemple, vous pouvez spécifier que la zone COMMAREA contenant la valeur d'ordre doit être supérieure à 10 000. La spécification de capture définit également l'emplacement des données à capturer.

L'emplacement de l'événement dans la logique de l'application dépend de la façon dont il est spécifié. Si une application CICS contient deux instances de la même commande EXEC CICS API et que la spécification de filtrage ne fait aucune différence entre les deux commandes, un événement est émis lorsque les deux commandes sont exécutées. Si une même commande EXEC CICS API intervient dans deux applications et qu'aucun filtre n'est définit pour l'ID de transaction ou le nom du programme, un événement est émis lorsque les deux applications sont exécutées.

Points de capture

Vous pouvez capturer des événements lors de l'initiation du programme (PGMINIT) et les commandes d'API EXEC CICS. Les points de capture qui peuvent être indiqués sont présentés dans le tableau suivant :

Tableau 1. Points de capture pour les événements d'application
Point de capture Prédicat primaire Prédicat de filtre Données de capture
Contexte Option d'événement Option d'événement Données d'application
CONVERSE Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse
EIBAID
EIBPOSN

Aucun

FROM
INTO-SET

Aucun
DELETE FILE FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE FILE RIDFLD
DELETEQ TD QUEUE

ID transaction
Programme en cours
ID utilisateur
Code réponse

QUEUE QUEUE Aucun
DELETEQ TS QNAME

ID transaction
Programme en cours
ID utilisateur
Code réponse

QNAME QNAME Aucun
INVOKE SERVICE SERVICE

ID transaction
Programme en cours
ID utilisateur
Code réponse

SERVICE
OPERATION
URI
CHANNEL
URIMAP

SERVICE
OPERATION
URI
CHANNEL
URIMAP

CHANNEL
SCOPE

LINK PROGRAM PROGRAM

ID transaction
Programme en cours
ID utilisateur
Code réponse

PROGRAM
CHANNEL

PROGRAM
CHANNEL

COMMAREA
CHANNEL

PROGRAM INIT PROGRAM

ID transaction
ID utilisateur
Code réponse

PROGRAM
CHANNEL

Aucun

COMMAREA
CHANNEL

PUT CONTAINER CONTAINER

ID transaction
Programme en cours
ID utilisateur
Code réponse

CONTAINER
CHANNEL

CONTAINER
CHANNEL

FROM
READ FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READNEXT FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READPREV FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE
UPDATE

FILE

RIDFLD
INTO-SET

READQ TD QUEUE

ID transaction
Programme en cours
ID utilisateur
Code réponse

QUEUE QUEUE INTO-SET
READQ TS QNAME

ID transaction
Programme en cours
ID utilisateur
Code réponse

QNAME QNAME INTO-SET
RECEIVE Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse
EIBAID
EIBPOSN

NONE NONE INTO-SET
RECEIVE MAP MAP

ID transaction
Programme en cours
ID utilisateur
Code réponse
EIBAID
EIBPOSN

MAP
MAPSET

MAP
MAPSET

INTO-SET
RETRIEVE Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

NONE NONE INTO-SET
RETURN Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

TRANSID
CHANNEL

TRANSID
CHANNEL

COMMAREA
CHANNEL

REWRITE FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE FILE FROM
SEND Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

NONE NONE FROM
SEND MAP MAP

ID transaction
Programme en cours
ID utilisateur
Code réponse

MAP
MAPSET
ALARM

MAP
MAPSET

FROM
SEND TEXT Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

ALARM NONE FROM
SIGNAL EVENT 1 EVENT

ID transaction
Programme en cours
ID utilisateur
Code réponse

EVENT
FROMCHANNEL

EVENT
FROMCHANNEL

FROM
FROMCHANNEL

START TRANSID

ID transaction
Programme en cours
ID utilisateur
Code réponse

TRANSID
CHANNEL

TRANSID
CHANNEL

FROM
CHANNEL

WEB READ

FORMFIELD
HTTPHEADER
QUERYPARM

Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

NONE NONE

FORMFIELD
INTO-SET
VALUE

WEB READNEXT

FORMFIELD
HTTPHEADER
QUERYPARM

Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

NONE NONE

FORMFIELD
VALUE

WRITE FILE FILE

ID transaction
Programme en cours
ID utilisateur
Code réponse

FILE FILE RIDFLD FROM
WRITE OPERATOR Aucun

ID transaction
Programme en cours
ID utilisateur
Code réponse

NONE NONE TEXT 2
WRITEQ TD QUEUE

ID transaction
Programme en cours
ID utilisateur
Code réponse

QUEUE QUEUE FROM
WRITEQ TS QNAME

ID transaction
Programme en cours
ID utilisateur
Code réponse

QNAME QNAME FROM
XCTL PROGRAM

ID transaction
Programme en cours
ID utilisateur
Code réponse

PROGRAM
CHANNEL

PROGRAM
CHANNEL

COMMAREA
CHANNEL

Tous les points de capture définissent les mêmes éléments de capture de contexte, PROGRAM, TRANSID et USERID.

Remarque : 1 L'objectif de la commande SIGNAL EVENT API est de fournir des données pour un événement. Un événement n'est émis que s'il existe une spécification de capture correspondante activée dans le système CICS.
Remarque : 2 Une longueur égale à 0 lors de l'indication de données d'application dans l'onglet des sources d'information signifie que la capture effectuée couvre l'intégralité de la zone de données ou du conteneur. Cette valeur est utile pour émettre le contenu de EXEC CICS WRITE OPERATOR. Pour plus d'informations, se reporter à la page des sources d'information.
Pour plus d'informations sur les points de capture que vous pouvez sélectionner, reportez-vous à la page du point de capture et à la page des sources d'information dans l'éditeur de liaison d'événements CICS.