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.
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 :
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 |
Aucun | FROM |
Aucun |
DELETE FILE | FILE | ID transaction |
FILE | FILE | RIDFLD |
DELETEQ TD | QUEUE | ID transaction |
QUEUE | QUEUE | Aucun |
DELETEQ TS | QNAME | ID transaction |
QNAME | QNAME | Aucun |
INVOKE SERVICE | SERVICE | ID transaction |
SERVICE |
SERVICE |
CHANNEL |
LINK PROGRAM | PROGRAM | ID transaction |
PROGRAM |
PROGRAM |
COMMAREA |
PROGRAM INIT | PROGRAM | ID transaction |
PROGRAM |
Aucun | COMMAREA |
PUT CONTAINER | CONTAINER | ID transaction |
CONTAINER |
CONTAINER |
FROM |
READ | FILE | ID transaction |
FILE |
FILE | RIDFLD |
READNEXT | FILE | ID transaction |
FILE |
FILE | RIDFLD |
READPREV | FILE | ID transaction |
FILE |
FILE | RIDFLD |
READQ TD | QUEUE | ID transaction |
QUEUE | QUEUE | INTO-SET |
READQ TS | QNAME | ID transaction |
QNAME | QNAME | INTO-SET |
RECEIVE | Aucun | ID transaction |
NONE | NONE | INTO-SET |
RECEIVE MAP | MAP | ID transaction |
MAP |
MAP |
INTO-SET |
RETRIEVE | Aucun | ID transaction |
NONE | NONE | INTO-SET |
RETURN | Aucun | ID transaction |
TRANSID |
TRANSID |
COMMAREA |
REWRITE | FILE | ID transaction |
FILE | FILE | FROM |
SEND | Aucun | ID transaction |
NONE | NONE | FROM |
SEND MAP | MAP | ID transaction |
MAP |
MAP |
FROM |
SEND TEXT | Aucun | ID transaction |
ALARM | NONE | FROM |
SIGNAL EVENT 1 | EVENT | ID transaction |
EVENT |
EVENT |
FROM |
START | TRANSID | ID transaction |
TRANSID |
TRANSID |
FROM |
WEB READ | Aucun | ID transaction |
NONE | NONE | FORMFIELD |
WEB READNEXT | Aucun | ID transaction |
NONE | NONE | FORMFIELD |
WRITE FILE | FILE | ID transaction |
FILE | FILE | RIDFLD FROM |
WRITE OPERATOR | Aucun | ID transaction |
NONE | NONE | TEXT 2 |
WRITEQ TD | QUEUE | ID transaction |
QUEUE | QUEUE | FROM |
WRITEQ TS | QNAME | ID transaction |
QNAME | QNAME | FROM |
XCTL | PROGRAM | ID transaction |
PROGRAM |
PROGRAM |
COMMAREA |
Tous les points de capture définissent les mêmes éléments de capture de contexte, PROGRAM, TRANSID et USERID.