新增擷取規格

您可以新增擷取規格至事件規格,以在 CICS® 中建立擷取點。

關於這項作業

CICS 事件連結編輯器會引導您建立一個或多個擷取規格。這些規格會識別下列項目:

例如,您可以指定任何 READQ TS(暫時儲存體 READ)指令為潛在事件。 然後,您可以新增要截取的指令之可用類型的述詞,來限定產生事件所依據的條件。

您可以定義三種類型的述詞:
環境定義

擷取規格中的述詞會用於過濾擷取點的環境定義。

每一個擷取點都具有您可為其指定述詞的環境定義項目。例如,交易 ID。所有可用的環境定義述詞都會顯示在過濾標籤中。 環境定義述詞是選用的;不過,您通常會指定交易 ID 或現行程式,以從特定應用程式發出事件。

「環境定義」區域是用來設定事件的過濾選項。 根據您在 CICS 事件連結編輯器中提供的其他資訊,並非所有欄位都適用;可用的環境定義述詞會視擷取點而定。您可能要指定的述詞有:交易 ID、現行程式和使用者ID。

事件選項

擷取規格中的述詞會用來過濾 CICS 指令或系統事件的事件選項值。

每一個擷取點皆具有您可為其指定述詞的事件選項。部分指令沒有事件選項。事件選項會對應於特定 EXEC CICS 指令或系統事件的選項。SEND MAP 指令的範例為 MAP 名稱。DB2 CONNECTION STATUS 事件的範例為 FROM_CONNECTST 狀態。擷取點的所有可用的固定資料值,都會顯示在過濾標籤中。 CICS 可識別事件選項的格式。

應用程式資料

擷取規格中的述詞會用於過濾 CICS 指令中指定的應用程式資料。

註: 如果對擷取規格定義了擷取點 DELETEQ TD 或 DELETEQ TS,則無法新增應用程式資料。

應用程式擷取點可以有您可為其指定述詞的可變長度資料值。應用程式資料對應於特定 EXEC CICS 指令的選項。SEND MAP 指令的範例為 FROM 欄位。 該擷取點之 EXEC CICS 指令的所有可用變數資料值,都會顯示在過濾標籤中。

CICS 會依指定的順序來處理應用程式資料述詞;亦即,先處理第一個述詞,接著處理第二個述詞,依此類推。

應用程式資料會用於在 CICS 指令中作為選項傳遞的儲存區(如 COMMAREA)或儲存器。CICS 無法識別這些區域的格式,但應用程式可以識別。您可能具有可以匯入以說明格式的程式碼語言說明。
註: 系統事件不會使用應用程式資料。

基本事件連結資訊(在事件連結的高階定義期間由業務經理所輸入)包括事件規格。 此事件連結資訊所識別的資料,已知是要進行進一步處理時所必需的,但是沒有提供其位置的詳細資料。 您可以指定資訊來源以提供這些詳細資料。

CICS 事件連結編輯器為了協助您,會在資訊來源標籤中呈現符合商業規格所需的資訊表格。 該表格會顯示事件規格中的商業資訊。 針對表格中的每一個項目,您必須定義這個擷取規格的資訊來源。

程序

  1. 規格標籤中,按一下事件規格。 右窗格顯示已強調顯示之事件規格的詳細資料。
  2. 按一下新增擷取規格 畫面上會顯示「新增擷取規格」視窗。
  3. 輸入新擷取規格的名稱。 可接受的字元包含:A-Z、a-z、0-9 及 _。不允許前導及內嵌空白字元。 字串的開頭不得為 0-9、_ 或任何大小寫表示的 "xml";例如 "Xml" 或 "xMl"。
  4. 選擇性的: 輸入新擷取規格的說明。
  5. 按一下確定 即會建立新的擷取規格。右編輯器窗格中會開啟三個標籤:擷取點過濾資訊來源。請使用每一個標籤來提供資訊,以說明新的擷取規格。
  6. 按一下擷取點標籤。 執行下列步驟來新增擷取點資訊:
    1. 選取您要新增擷取點的 EXEC CICS 指令,或從擷取點清單中選取程式起始 程式起始是與 CICS 程式啟動相關聯的擷取點。
    2. 按一下擷取前擷取後 您可以指定擷取點位於部分 EXEC CICS 指令的前面或後面。對於這些 EXEC CICS 指令的子集,會停用此選項。
  7. 按一下過濾標籤。 如果想要新增擷取述詞資訊,請執行下列步驟:
    1. 選擇性的: 定義擷取規格的應用程式環境定義。 畫面上會顯示可供您選擇之擷取點使用的應用程式環境定義述詞。選取運算子的選項,並提供值來指定述詞。運算子 All 指定不在相關聯的述詞上進行任何過濾。 您以大寫方式輸入交易 ID現行程式使用者 ID 的值。
    2. 選擇性的: 定義擷取規格的應用程式選項。 畫面上會顯示可供您選擇之擷取點使用的應用程式選項。選取運算子的選項,並提供值來指定述詞。運算子 All 指定不在相關聯的述詞上進行任何過濾。

      可以是主要述詞的應用程式選項會以星號 (*) 標示。 您必須選取 Equals作為運算子 並指定主要述詞的值,以維持 CICS 效能。例如,對於 PUT CONTAINER 擷取點,您可以對可用的應用程式選項 CONTAINER* 指定一個值。

    3. 選擇性的: 定義擷取規格的應用程式資料。 若要新增應用程式資料述詞,請按一下新增。畫面上會顯示「應用程式資料述詞」視窗。

      選取運算子的選項,並輸入述詞的值。運算子 All 指定不在相關聯的述詞上進行任何過濾。

      定義您要利用述詞來測試的變數。您可以按一下從匯入的語言結構中選取,然後遵循從匯入的原始碼選取變數中的指示,或者可以選取位置類型的選項,然後使用畫面中的作用中欄位,進一步定義變數。只有您選取的類型所需的那些欄位才會作用中。例如,若您選取字元類型,則只有偏移長度字碼頁欄位是作用中欄位。

  8. 按一下資訊來源標籤。 在表格中的每一個資訊來源上執行下列步驟,將資訊來源對映至可用的資料項目。如果未在事件上擷取任何商業資料,則此表格可能沒有包含任何資訊來源。

    如果不需要資料,則您不必擷取資料。

    1. 按兩下資訊來源,或選取它並按一下編輯 畫面上會顯示「事件資訊來源」視窗。
    2. 環境定義資料值可變長度資料中選取可用的資料項目。 如果選取可變長度資料項目,則您可以按一下從匯入的語言結構中選取,然後遵循從匯入的原始碼選取變數中的指示,或者可以選取位置類型的選項,然後使用畫面中的作用中欄位,進一步定義變數。只有您選取的類型所需的那些欄位才會作用中。例如,若您選取字元類型,則只有偏移長度字碼頁欄位是作用中欄位。

      資訊來源的長度不必與發出的商業資訊項目相同。 CICS 會視需要填補或截斷值。

結果

您已建立擷取規格。您也可以按一下擷取點標籤中的移除擷取規格,並按一下加以確認,來移除擷取規格。