從原則匯出事件規格

如果原則的規則動作是發出事件,則可將該事件的事件規格匯出為綱目或記錄定義檔以供他處使用。

開始之前

您必須具有其規則動作定義為發出事件的 CICS® 原則。如需指示,請參閱在 CICS 組合專案中建立及部署原則

關於這項作業

匯出的檔案會包含事件資料格式,有助於您使用自己的程式或資料處理引擎來處理擷取的資料。

選定 EP 配接器或選定 EP 配接器集中的 EP 配接器所指定的資料格式,會決定匯出的檔案是綱目還是記錄定義檔:
  • 若為 XML 格式(如共用基本事件、共用基本事件 REST、Decision Server Insights Event 或 WebSphere® Business Events),則匯出的檔案為 XML 綱目定義 (.xsd) 檔案。下列配接器可發出 XML 字元格式的事件:
    • HTTP 配接器
    • TD 佇列配接器
    • TS 佇列配接器
    • IBM® MQ 佇列配接器
  • 若為非 XML 格式(亦即 CICS 壓縮事件格式),則匯出的檔案為 COBOL 記錄定義檔 (.cpy)。下列配接器可發出 CICS 壓縮事件格式的事件:
    • TD 佇列配接器
    • TS 佇列配接器
    • IBM MQ 佇列配接器
註: 您無法匯出「交易啟動」配接器或自訂配接器的事件規格。

程序

  1. 在原則定義編輯器的規則標籤上,導覽至「動作」區段。
    原則定義編輯器「規則」標籤上的「動作」標籤
  2. 請確保在選取發出事件動作時指定 EP 配接器或 EP 配接器集。
  3. 按一下匯出事件規格
  4. 在下列任何情況下,將會提示您選擇配接器或配接器集:
    • 在工作區中,多個 EP 配接器的名稱與指定配接器相同,或與指定 EP 配接器集中的配接器相同。
      「選擇 EP 配接器」視窗
    • 在工作區中,多個 EP 配接器集具有指定的配接器集名稱。
      「選擇 EP 配接器集」視窗
  5. 在「匯出規則的事件規格」視窗中,確定已在下列對應欄位中指定正確的資訊: 「匯出規則的事件規格」視窗
    匯出
    要為其匯出事件規格的原則規則。
    目標目錄
    要將匯出的事件規格儲存至其中的本端目錄。
    資料格式

    在 EP 配接器或 EP 配接器集內的 EP 配接器中指定的資料格式。

    在 CICS Explorer® 因 EP 配接器、EP 配接器集或 EP 配接器集內的 EP 配接器不在您的工作區中而無法判斷資料格式時,將會顯示此欄位。

    註: 請確保資料格式資訊符合在 EP 配接器中指定的資訊,否則在您使用匯出的檔案進行資料處理時,它可能會失敗。
    版本

    將要發出事件的 CICS 區域(亦即要將原則部署至其中的區域)之版本。

    在原則規則套用至 CICS TS 5.3 及較舊版本時,將會顯示此欄位。

  6. 按一下確定
  7. 如果指定的目錄中已存在相同名稱的匯出事件規格,將提示您是要改寫現有檔案還是取消匯出。

結果

在原則規則的指定目錄中,將會建立一個以上的檔案。下表中的範例顯示針對不同事件(未指定事件名稱)所建立的檔案。

如果指定事件名稱,則使用它作為所匯出檔名的字首。比方說,如果在第一個範例中指定事件名稱 event_name,則輸出檔會命名為 event_name_dsie_CICS_54.xsd。如需定義事件名稱的指示,請參閱在 CICS 組合專案中建立及部署原則
表 1. 不同事件的匯出事件規格檔案
EP 配接器或配接器集 原則規則 版本 資料格式 匯出的事件規格
IBM MQ 佇列配接器 檔案開啟狀態系統規則 第 54 版 Decision Server Insights Event (XML) 格式 名為 fileEnable_rule_dsie_CICS_54.xsd 的 XML 綱目檔,可供您在 IBM Operational Decision Manager Insight Designer 工具中用來協助定義事件。
TD 或 TS 佇列配接器 儲存體要求作業規則 第 51 - 53 版 共用基本事件 REST (XML) 格式 名為 cics_policy_event_payload_cbe_CICS_51-53.xsd 的 XML 綱目檔,您可以將其匯入 IBM Business Monitor 以定義入埠事件。
第 54 版 名為 task_rules_payload_cbe_CICS_54.xsd 的 XML 綱目檔,您可以將其匯入 IBM Business Monitor 以定義入埠事件。
IBM MQ 佇列配接器 檔案開啟狀態系統規則 第 54 版 CICS 壓縮事件格式 名為 DFHMPFEO_CICS_54.cpy 的 COBOL 記錄定義檔,可供您在自己的事件消費者程式中用來處理資料。
具有下列配接器的 EP 配接器集:
  • TD 或 TS 佇列配接器(CICS 壓縮事件格式)
  • IBM MQ 佇列配接器(WebSphere Business Events (XML) 格式
檔案開啟狀態系統規則 第 54 版

CICS 壓縮事件格式 WebSphere Business Events (XML) 格式

名為 DFHMPFEO_CICS_54.cpyfileEnable_rule_wbe_CICS_54.xsd 的兩個檔案,可供您在自己的程式以及 IBM Operational Decision Manager Event Designer 工具中使用。