您可以指定當應用程式發出任何事件啟用的 EXEC CICS API 指令時,或當起始應用程式時,發出事件。事件啟用的 EXEC CICS® 指令會顯示在擷取點中。有一組有限的 CICS 模組也已啟用事件,使您可以從中擷取事件,例如:來自 Atom 支援的檔案和暫時儲存體指令;由 CICS WebSphere® MQ 橋接器程式發出的 EXEC CICS LINK 指令;來自 CICS 範例和 CECI 交易的指令。
擷取規格會利用過濾器(例如交易 ID、程式名稱或 EXEC CICS 指令選項值),來定義事件發出的準則。可以過濾與指令相關聯的應用程式資料,進一步精簡這個擷取規格。 例如,您可以指定包含訂單值的 COMMAREA 欄位必須大於 10,000。擷取規格也會定義要擷取的資料位置。
應用程式邏輯中的事件位置視如何指定它而定。如果 CICS 應用程式包含相同 EXEC CICS API 指令的兩個實例,而且過濾器規格無法在兩個指令之間區分,則在發出這兩個指令時會發出事件。如果在兩個應用程式中發生相同的 EXEC CICS API 指令,且未過濾交易 ID 或程式名稱,則當這兩個應用程式執行時,就會發出事件。
您可以在程式起始 (PGMINIT) 處和下列 EXEC CICS API 指令上擷取事件。可指定的擷取點如下表所示:
擷取點 | 主要述詞 | 過濾述詞 | 擷取資料 | ||
---|---|---|---|---|---|
環境定義 | 事件選項 | 事件選項 | 應用程式資料 | ||
CONVERSE | 無 | 交易 ID |
無 | FROM |
無 |
DELETE FILE | FILE | 交易 ID |
FILE | FILE | RIDFLD |
DELETEQ TD | QUEUE | 交易 ID |
QUEUE | QUEUE | 無 |
DELETEQ TS | QNAME | 交易 ID |
QNAME | QNAME | 無 |
INVOKE SERVICE | SERVICE | 交易 ID |
SERVICEOPERATIONURICHANNELURIMAP |
SERVICEOPERATIONURICHANNEL |
CHANNELSCOPE |
LINK PROGRAM | PROGRAM | 交易 ID |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
PROGRAM INIT | PROGRAM | 交易 ID |
PROGRAMCHANNEL |
無 | COMMAREA |
PUT CONTAINER | CONTAINER | 交易 ID |
CONTAINERCHANNEL |
CONTAINERCHANNEL |
FROM |
READ | FILE | 交易 ID |
FILEUPDATE |
FILE | RIDFLD |
READNEXT | FILE | 交易 ID |
FILEUPDATE |
FILE | RIDFLD |
READPREV | FILE | 交易 ID |
FILEUPDATE |
FILE | RIDFLD |
READQ TD | QUEUE | 交易 ID |
QUEUE | QUEUE | INTO-SET |
READQ TS | QNAME | 交易 ID |
QNAME | QNAME | INTO-SET |
RECEIVE | 無 | 交易 ID |
NONE | NONE | INTO-SET |
RECEIVE MAP | MAP | 交易 ID |
MAPMAPSET |
MAPMAPSET |
INTO-SET |
RETRIEVE | 無 | 交易 ID |
NONE | NONE | INTO-SET |
RETURN | 無 | 交易 ID |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
COMMAREA |
REWRITE | FILE | 交易 ID |
FILE | FILE | FROM |
SEND | 無 | 交易 ID |
NONE | NONE | FROM |
SEND MAP | MAP | 交易 ID |
MAPMAPSETALARM |
MAPMAPSET |
FROM |
SEND TEXT | 無 | 交易 ID |
ALARM | NONE | FROM |
SIGNAL EVENT 1 | EVENT | 交易 ID |
EVENTFROMCHANNEL |
EVENTFROMCHANNEL |
FROM |
START | TRANSID | 交易 ID |
TRANSIDCHANNEL |
TRANSIDCHANNEL |
FROM |
WEB READ | 無 | 交易 ID |
NONE | NONE | FORMFIELD |
WEB READNEXT | 無 | 交易 ID |
NONE | NONE | FORMFIELD |
WRITE FILE | FILE | 交易 ID |
FILE | FILE | RIDFLD FROM |
WRITE OPERATOR | 無 | 交易 ID |
NONE | NONE | TEXT 2 |
WRITEQ TD | QUEUE | 交易 ID |
QUEUE | QUEUE | FROM |
WRITEQ TS | QNAME | 交易 ID |
QNAME | QNAME | FROM |
XCTL | PROGRAM | 交易 ID |
PROGRAMCHANNEL |
PROGRAMCHANNEL |
COMMAREA |
所有擷取點都會定義相同的環境定義擷取項目,即 PROGRAM、TRANSID 與 USERID。