Sie können angeben, dass ein Ereignis ausgegeben wird, wenn Ihre Anwendung einen ereignisorientierten EXEC CICS-API-Befehl ausgibt oder wenn ein Anwendungsprogramm gestartet wird. Die ereignisorientierten EXEC CICS-Befehle sind im Abschnitt Erfassungspunkte aufgeführt. Bestimmte CICS-Module wurden ebenfalls mit der Möglichkeit der Ereignisausgabe ausgestattet, sodass Sie Ereignisse zum Beispiel aus Befehlen der Atom-Unterstützung, die sich auf Dateien und temporären Speicher beziehen, aus EXEC CICS LINK-Befehlen, die vom CICS-Brückenprogramm WebSphere MQ ausgegeben wurden, aus Befehlen von den CICS-Mustern und von der Transaktion CECI erfassen können.
Die Erfassungsspezifikation definiert die Kriterien für die Ereignisausgabe mithilfe von Filtern, wie zum Beispiel die Transaktions-ID, der Programmname oder der Wert der Option zum EXEC CICS-Befehl. Durch Filterung der Anwendungsdaten zum Befehl kann diese Erfassungsspezifikation dann weiter optimiert werden. Zum Beispiel können Sie angeben, dass der Wert in einem Feld im Kommunikationsbereich (COMMAREA), das einen Auftragswert enthält, größer als 10.000 sein muss. Weiterhin definiert die Erfassungsspezifikation die Position der Daten, die erfasst werden sollen.
Die Position des Ereignisses in der Anwendungslogik hängt davon ab, wie dieses angegeben wurde. Wenn eine CICS-Anwendung zwei Instanzen desselben EXEC CICS-API-Befehls enthält und die Filterspezifikation nicht zwischen diesen beiden Befehlen unterscheidet, wird bei beiden Befehlen ein Ereignis ausgegeben. Wenn derselbe EXEC CICS-API-Befehl in zwei Anwendungen auftritt und kein Filter nach der Transaktions-ID oder dem Programmnamen vorhanden ist, wird ein Ereignis ausgegeben, wenn beide Anwendungen ausgeführt werden.
Sie können Ereignisse beim Programmstart (PGMINIT) und an den folgenden EXEC CICS-API-Befehlen erfassen. Erfassungspunkte, die angegeben werden können, sind in der folgenden Tabelle enthalten:
Erfassungspunkt | Primäres Prädikat | Filterprädikat | Daten erfassen | ||
---|---|---|---|---|---|
Kontext | Ereignisoption | Ereignisoption | Anwendungsdaten | ||
CONVERSE | Kein | Transaktions-ID |
Kein | FROMINTO-SET |
Kein |
DELETE FILE | FILE | Transaktions-ID |
FILE | FILE | RIDFLD |
DELETEQ TD | QUEUE | Transaktions-ID |
QUEUE | QUEUE | Kein |
DELETEQ TS | QNAME | Transaktions-ID |
QNAME | QNAME | Kein |
INVOKE SERVICE | SERVICE | Transaktions-ID |
SERVICEOPERATIONURICHANNELURIMAP |
SERVICEOPERATIONURI CHANNEL |
CHANNELSCOPE |
LINK PROGRAM | PROGRAM | Transaktions-ID |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
PROGRAM INIT | PROGRAM | Transaktions-ID |
PROGRAMCHANNEL |
Kein | COMMAREA |
PUT CONTAINER | CONTAINER | Transaktions-ID |
CONTAINERCHANNEL |
CONTAINERCHANNEL |
FROM |
READ | FILE | Transaktions-ID |
FILEUPDATE |
FILE | RIDFLD |
READNEXT | FILE | Transaktions-ID |
FILEUPDATE |
FILE | RIDFLD |
READPREV | FILE | Transaktions-ID |
FILEUPDATE |
FILE | RIDFLD |
READQ TD | QUEUE | Transaktions-ID |
QUEUE | QUEUE | INTO-SET |
READQ TS | QNAME | Transaktions-ID |
QNAME | QNAME | INTO-SET |
RECEIVE | Kein | Transaktions-ID |
KEIN | KEIN | INTO-SET |
RECEIVE MAP | MAP | Transaktions-ID |
MAPMAPSET |
MAPMAPSET |
INTO-SET |
RETRIEVE | Kein | Transaktions-ID |
KEIN | KEIN | INTO-SET |
RETURN | Kein | Transaktions-ID |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
COMMAREA |
REWRITE | FILE | Transaktions-ID |
FILE | FILE | FROM |
SEND | Kein | Transaktions-ID |
KEIN | KEIN | FROM |
SEND MAP | MAP | Transaktions-ID |
MAPMAPSETALARM |
MAPMAPSET |
FROM |
SEND TEXT | Kein | Transaktions-ID |
ALARM | KEIN | FROM |
SIGNAL EVENT 1 | EVENT | Transaktions-ID |
EVENTFROMCHANNEL |
EVENTFROMCHANNEL |
FROMFROMCHANNEL |
START | TRANSID | Transaktions-ID |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
FROMCHANNEL |
WEB READ | Kein | Transaktions-ID |
KEIN | KEIN | FORMFIELD |
WEB READNEXT | Kein | Transaktions-ID |
KEIN | KEIN | FORMFIELD |
WRITE FILE | FILE | Transaktions-ID |
FILE | FILE | RIDFLD FROM |
WRITE OPERATOR | Kein | Transaktions-ID |
KEIN | KEIN | TEXT 2 |
WRITEQ TD | QUEUE | Transaktions-ID |
QUEUE | QUEUE | FROM |
WRITEQ TS | QNAME | Transaktions-ID |
QNAME | QNAME | FROM |
XCTL | PROGRAM | Transaktions-ID |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
Alle Erfassungspunkte definieren dieselben Kontexterfassungselemente PROGRAM, TRANSID und USERID.