使用 CICS® 事件連結編輯器中的過濾標籤,可以定義用於擷取事件的準則(稱為述詞)。
若未提供任何述詞,每當您選擇的擷取點在目標 CICS 系統中執行時,即會發出事件。
每一個述詞都包括用來識別述詞、運算子及值的資訊。
您可以視需要的數量來指定述詞,以識別您要此擷取點發出事件的狀況。您可以指定三種類型的述詞,其為環境定義、事件選項和應用程式資料。
某些擷取點有主要述詞。您為一個述詞選取了 Equals 作為運算子,並提供一個值以避免在擷取點中新增更多擷取規格時影響效能,該述詞即為主要述詞。
註: CICS 模組名稱可以變更;因此,請勿在擷取規格中包括含有 DFH* 模組名稱的過濾器。CICS 事件連結編輯器在現行程式過濾器上編碼大部分 DFH* 模組的名稱時,都會驗證使用者輸入。使用者只能編碼 DFH£*、DFH0*、DFHW2FI、DFHW2TS、DFHMQBP0 或 DFHECID。此外,DFHMIRR 和 DFHMIRS 也可以編碼用於 LINK PROGRAM 應用程式事件。
環境定義
擷取規格中的述詞會用於過濾擷取點的環境定義。
每一個擷取點都具有您可為其指定述詞的環境定義項目。例如,交易 ID。所有可用的環境定義述詞都會顯示在過濾標籤中。
環境定義述詞是選用的;不過,您通常會指定交易 ID 或現行程式,以從特定應用程式發出事件。
「環境定義」區域是用來設定事件的過濾選項。
根據您在 CICS 事件連結編輯器中提供的其他資訊,並非所有欄位都適用;可用的環境定義述詞會視擷取點而定。您可能要指定的述詞有:交易 ID、現行程式和使用者ID。
- 交易 ID
- 所有擷取點的運算子選項:
- 現行程式
- 所有擷取點的運算子選項:
- 全部
- 等於
- 不等於
- 開頭不是
- 開頭是
- 小於
- 不小於
- 大於
- 不大於
- 使用者 ID
- 所有擷取點的運算子選項:
- 回應碼
- 運算子選項:
- Equals 運算子的值包括:
事件選項
擷取規格中的述詞會用來過濾 CICS 指令或系統事件的事件選項值。
每一個擷取點皆具有您可為其指定述詞的事件選項。部分指令沒有事件選項。事件選項會對應於特定 EXEC CICS 指令或系統事件的選項。SEND MAP 指令的範例為 MAP 名稱。DB2 CONNECTION STATUS 事件的範例為 FROM_CONNECTST 狀態。擷取點的所有可用的固定資料值,都會顯示在過濾標籤中。
CICS 可識別事件選項的格式。
- 名稱
- 擷取規格的名稱。
- 運算子
- 所有擷取點的運算子選項:
- 值
- 您針對述詞指定的值。
- 應用程式指令選項述詞的限制會視 CICS API 而定。例如,TRANSID 為 4 個字元;CHANNEL 則為 16 個字元。CICS 事件連結編輯器會針對每一種類型動態調整,且如果述詞值太長或太短,會顯示一則訊息。
如需 CICS API 呼叫之事件選項的相關資訊,請參閱 CICS TS 5.1 資訊中心中的應用程式事件。
如需系統事件之事件選項的相關資訊,請參閱 CICS TS 5.1 資訊中心中的系統事件與 CICS TS 5.1 資訊中心中的資訊來源標籤。
應用程式資料
擷取規格中的述詞會用於過濾 CICS 指令中指定的應用程式資料。
註: 如果對擷取規格定義了擷取點 DELETEQ TD 或 DELETEQ TS,則無法新增應用程式資料。
應用程式擷取點可以有您可為其指定述詞的可變長度資料值。應用程式資料對應於特定 EXEC CICS 指令的選項。SEND MAP 指令的範例為 FROM 欄位。
該擷取點之 EXEC CICS 指令的所有可用變數資料值,都會顯示在過濾標籤中。
CICS 會依指定的順序來處理應用程式資料述詞;亦即,先處理第一個述詞,接著處理第二個述詞,依此類推。
應用程式資料會用於在 CICS 指令中作為選項傳遞的儲存區(如 COMMAREA)或儲存器。CICS 無法識別這些區域的格式,但應用程式可以識別。您可能具有可以匯入以說明格式的程式碼語言說明。
註: 系統事件不會使用應用程式資料。
- 位置
- 「位置」欄位的值會視 CICS API 呼叫而定。
- 範例:
- 針對 EXEC CICS WRITE FILE(EXMPCAT) 指令,「位置」欄位的選項有 FROM 和 RIDFLD。
- 針對 EXEC CICS INVOKE SERVICE(name) 指令,「位置」欄位的選項有 CHANNEL 和 SCOPE。
- 儲存器
- 指定 CICS 通道儲存器。只有當應用程式資料指定了通道時,才能選取儲存器欄位。在所有其他情況下,此欄位會停用。
- 偏移
- 指定從頭(資料開始處)開始的距離。
偏移 0 表示欄位開頭。
- 長度
- 欄位的長度(以位元組為單位)。長度 0 表示過濾整個資料區或儲存器。舉例來說,在過濾儲存器的內容而不考慮其長度時,這會很有用。
- 運算子
- 運算子選項:
- 全部
- 存在
- 等於
- 不等於
- 不存在
- 開頭是
- 開頭不是
- 小於
- 不小於
- 大於
- 不大於
- 值
- 您針對述詞指定的值。
- 長度會視資料類型而定;例如,character 類型的長度上限為 255 個字元,而 unsigned halfword 類型的長度上限則是 5 個字元,且值的範圍為 0 到 65535。