過濾標籤
每一個述詞都包括用來識別述詞、運算子及值的資訊。您可以視需要的數量來指定述詞,以識別您要此擷取點發出事件的狀況。您可以指定三種類型的述詞,其為環境定義、事件選項和應用程式資料。
某些擷取點有主要述詞。您為一個述詞選取了 Equals 作為運算子設定,並提供一個值以避免在擷取點中新增更多擷取規格時影響效能,該述詞即為主要述詞。

環境定義
擷取規格中的述詞是用於過濾擷取點的環境定義。
每一個擷取點都具有您可為其指定述詞的環境定義項目。例如,交易 ID。所有可用的環境定義述詞都會顯示在過濾標籤中。環境定義述詞是選用項目;不過,您通常會指定交易 ID 或現行程式,以從特定應用程式發出事件。
「環境定義」區域是用來設定事件的過濾選項。根據您在 事件連結編輯器中提供的其他資訊,並非所有欄位都適用;可用的環境定義述詞會視擷取點而定。您可能要指定的述詞有:交易 ID、現行程式和使用者 ID。
- 交易 ID
- 所有擷取點的運算子選項:
- All
- Equals
- Does Not Equal
- Does Not Start With
- Starts With
應用程式擷取點的其他選項:- Less Than
- Not Less Than
- Greater Than
- Not Greater Than
- 現行程式
- 所有擷取點的運算子選項:
- All
- Equals
- Does Not Equal
- Does Not Start With
- Starts With
- Less Than
- Not Less Than
- Greater Than
- Not Greater Than
- 使用者 ID
- 所有擷取點的運算子選項:
- All
- Equals
- Does Not Equal
- Does Not Start With
- Starts With
應用程式擷取點的其他選項:- Less Than
- Not Less Than
- Greater Than
- Not Greater Than
- 回應碼
- 運算子選項:
- All
- Equals
- Equals 運算子的值包括:
- Ok
- Not Ok
事件選項
擷取規格中的述詞會用來過濾 CICS 指令或系統事件的事件選項值。
每一個擷取點都具有您可為其指定述詞的事件選項。部分指令沒有事件選項。事件選項會對應於特定 EXEC CICS 指令或系統事件的選項。SEND MAP 指令的範例為 MAP 名稱。DB2® 連線狀態事件的範例為 FROM_CONNECTST 狀態。擷取點的所有可用的固定資料值,都會顯示在過濾標籤中。CICS 可識別事件選項的格式。
- 名稱
- 擷取規格的名稱。
- 運算子
- 所有擷取點的運算子選項:
- All
- Equals
- Does Not Equal
- Does Not Start With
- Starts With
應用程式擷取點的其他選項:- All
- Equals
- Does Not Equal
- Does Not Start With
- Starts with
系統擷取點的其他選項:- Goes Higher Than
- Goes Lower Than
- 值
- 您針對述詞所指定的值。
- 應用程式指令選項述詞的限制會視 CICS API 而有所不同。例如,TRANSID 為 4 個字元;CHANNEL 則為 16 個字元。事件連結編輯器會針對每一種類型動態調整,而且如果述詞值太長或太短,會顯示一則訊息。
如需 CICS API 呼叫之事件選項的相關資訊,請參閱應用程式事件(CICS TS 5.4.0 版產品說明文件)。
如需系統事件之事件選項的相關資訊,請參閱系統事件(CICS TS 5.4.0 版產品說明文件)與資訊來源標籤。
應用程式資料
擷取規格中的述詞是用於過濾 CICS 指令中所指定的應用程式資料。
應用程式擷取點可以具有您可為其指定述詞的可變長度資料值。應用程式資料會對應於特定 EXEC CICS 指令的選項。SEND MAP 指令的範例為 FROM 欄位。該擷取點之 EXEC CICS 指令的所有可用變數資料值,都會顯示在過濾標籤中。
CICS 會依指定的順序來處理應用程式資料述詞;亦即,先處理第一個述詞,接著處理第二個述詞,依此類推。
- 位置
- 「位置」欄位的值視 CICS API 呼叫而定。
- 範例:
- 對於 EXEC CICS WRITE FILE(EXMPCAT) 指令,「位置」欄位的選項有 FROM 及 RIDFLD。
- 對於 EXEC CICS INVOKE SERVICE(name) 指令,「位置」欄位的選項有 CHANNEL 及 SCOPE。
- 儲存器
- 指定 CICS 通道儲存器。只有當應用程式資料指定了通道時,才能選取儲存器欄位。在所有其他狀況下,會停用此欄位。
- 偏移
- 指定從頭(資料開始處)開始的距離。偏移 0 表示欄位開頭。
- 長度
- 欄位的長度(以位元組為單位)。長度 0 表示過濾整個資料區或儲存器。舉例來說,在過濾儲存器的內容而不考慮其長度時,這會很有用。
- 運算子
- 運算子選項:
- All
- Exists
- Equals
- Does Not Equal
- Does Not Exist
- Starts With
- Does Not Start With
- Less Than
- Not Less Than
- Greater Than
- Not Greater Than
- 值
- 您針對述詞所指定的值。
- 長度會視資料類型而定;例如,character 類型的長度上限為 255 個字元,而 unsigned halfword 類型的長度上限則是 5 個字元,且值的範圍為 0 到 65535。