指定 EP 配接器及分派器資訊
您可以在事件連結中指定資訊,以控制 CICS® 如何發出事件連結所產生的事件。
關於這項作業
程序
- 按一下 事件連結編輯器中的配接器標籤,然後選取使用這裡定義的配接器選項,以指定要用於此事件連結的 EP 配接器配置、EP 配接器的參數,以及任何進階資訊。
或者,您可以選擇使用預先定義的 EPADAPTER 資源或 EPADAPTERSET 資源。如需預先定義的 EPADAPTER 資源的相關資訊,請參閱事件處理 (EP) 配接器配置編輯器。如需預先定義的 EPADAPTERSET 資源的相關資訊,請參閱事件處理 (EP) 配接器集編輯器。
如果您指定預先定義的 EPADAPTER 或 EPADAPTERSET 資源,請在名稱欄位中輸入名稱,或者按一下選擇以選擇資源。如需選擇配接器資源的相關資訊,請參閱選擇 EP 配接器資源及選擇 EP 配接器集資源。
- 選擇性的: 您可以在此事件連結中匯出一個以上的事件規格。
- 從配接器清單中選擇 EP 配接器類型。 您可以指定下列 EP 配接器類型:
- IBM® MQ 佇列
- 將事件以 XML 格式發出至 IBM MQ 訊息佇列,以供 IBM Operational Decision Manager 或 IBM Business Monitor 使用,或者以二進位 CICS 壓縮事件 (CFE) 格式發出,直接從 IBM MQ 使用。
- 針對確保事件發出,搭配使用「IBM MQ MQ 佇列」EP 配接器與持續 IBM MQ 訊息佇列,便可確保遞送事件。
- 交易啟動
- 將事件發出至指定 CICS 交易。資料會以儲存器型事件格式傳遞至交易。您可以指定 CICS 系統來執行交易。如果不需要事件資料,便可使用現有的交易。交易啟動 EP 配接器不支援確保發出事件。
- TS 佇列
- 以其中一個 XML 格式(「共用基本事件」、「共用基本事件 REST」、Decision Server Insights Event 或 WebSphere® Business Events)或非 XML (CFE) 格式,將事件發出至指定的 CICS TS 佇列。請使用此 EP 配接器來驗證是否正在以正確的資料擷取正確的事件,並將事件發出至任何從 TS 佇列讀取的消費者。
- 若要確保事件發出,同步交易式事件需要可回復的 TS 佇列;同步非交易式事件需要不可回復的佇列。TS 佇列是否為可回復的佇列視相符 TSMODEL 的設定而定;只在有一個相符的 TSMODEL 時,TS 佇列才會是可回復的佇列。當您對同步的交易式事件使用 TS 佇列配接器時,在擷取事件的工作單元中,您無法對事件 TS 佇列發出 DELETEQ TS 指令。
- TD 佇列
- 以下列其中一個格式,將事件發出至指定的 CICS 暫時資料佇列:共用基本事件、共用基本事件 REST、CICS 壓縮事件 (CFE)、Decision Server Insights Event 及 WebSphere Business Event。在開發及測試事件規格來驗證是否正在以正確的資料擷取正確的事件,以及將事件發出至從 TD 佇列讀取的任何消費者時,請使用此 EP 配接器。
- 若要同步發出事件,對於交易式事件,TD 佇列必須是可回復的內部分割區佇列;對於非交易式事件,TD 佇列必須是不可回復的內部分割區佇列或外部分割區佇列。TDQ EP 配接器可用於測試和除錯以及正式作業。
- 自訂(使用者撰寫)
- 以任何您所需的格式發出事件。自訂 EP 配接器是您所撰寫的 CICS 程式,用來提供隨附的 EP 配接器所不支援之事件的格式化和遞送組合。自訂 EP 配接器不得執行任何其他處理(例如,使用事件)。
- 若要確保事件發出,自訂 EP 配接器必須符合事件的可回復性需求。請參閱自訂 EP 配接器的文件,以查看其支援交易式或非交易式同步事件。
- HTTP
- 以 XML 格式,使用 HTTP POST 將事件發出至 HTTP 1.1 相容伺服器,以供 IBM Operational Decision Manager 或 IBM Business Monitor 之類的產品使用。HTTP EP 配接器不支援確保發出交易式事件。
- 對您選擇的 EP 配接器類型指定選項:
- 為「IBM MQ 佇列」EP 配接器指定下列選項:
- 指定 IBM MQ 佇列的佇列名稱,此事件連結所發出的事件會放置在該佇列上。您必須指定佇列名稱。
- 指定訊息是否為持續的。請從持續清單中選取下列其中一個值。
- 否
- 由「IBM MQ 佇列」EP 配接器放置在佇列上的訊息不會持續。
- 是
- 由「IBM MQ 佇列」EP 配接器放置在佇列上的訊息會持續。
- 佇列預設值
- 放置在佇列上的訊息會繼承指定佇列的預設持續性。
- 指定訊息優先順序。您可以選取佇列預設值,或在優先順序欄位中,為 IBM MQ 訊息優先順序鍵入一值(從 0 到 9)。
- 指定到期時間。您可以選取永不到期,或在到期時間欄位中,為 IBM MQ 訊息期限鍵入一值。此時間是以十分之一秒來表示。如果在經歷這段期間之前,未從目的地佇列中移除訊息,則該訊息會變成可以捨棄。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- CICS 壓縮事件(二進位)
- 事件資料是以非 XML 格式表示。
- 共用基本事件 (XML)
- 訊息會以 IBM Business Monitor 所需的共用基本事件格式放置在佇列上。
- WebSphere Business Events (XML)
- 訊息會以 IBM Operational Decision Manager 的 Decision Server Events 元件 所需的 XML 格式放置在佇列上。
- Decision Server Insights Event (XML)
- 訊息會以 IBM Operational Decision Manager 的 Decision Server Insights 元件 所需的 XML 格式放置在佇列上。事件資料是以 XML 格式表示。
- 為「交易啟動」EP 配接器指定下列選項:
- 指定由於事件而執行的 CICS 應用程式的交易 ID。您必須指定交易 ID。
- 指定交易使用者 ID。由交易啟動 EP 配接器啟動的交易會使用此使用者 ID 來執行。
- 指定只適用於交易 EP 配接器的系統 ID。EP 配接器交易會使用此系統 ID,在 CICS 系統上執行。
- 為「TS 佇列」EP 配接器指定下列選項:
- 指定 CICS 佇列名稱。您必須指定佇列名稱。
- 如果您的目標佇列為遠端佇列,請指定系統 ID。
- 必要的話,請選取使用輔助暫時儲存體。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- CICS 壓縮事件(二進位)
- 事件資料是以非 XML 格式表示。
- 共用基本事件 (XML)
- 事件資料是以 XML 格式表示。
- 共用基本事件 REST (XML)
- 事件資料是以 XML 格式表示。
- WebSphere Business Events (XML)
- 事件資料是以 XML 格式表示。
- Decision Server Insights Event (XML)
- 事件資料是以 XML 格式表示。
- 為「TD 佇列」EP 配接器指定下列選項:
- 指定 CICS 佇列名稱。您必須指定佇列名稱。
- 如果您的目標佇列為遠端佇列,請指定系統 ID。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- CICS 壓縮事件(二進位)
- 事件資料是以非 XML 格式表示。
- 共用基本事件 (XML)
- 事件資料是以 XML 格式表示。
- 共用基本事件 REST (XML)
- 事件資料是以 XML 格式表示。
- WebSphere Business Events (XML)
- 事件資料是以 XML 格式表示。
- Decision Server Insights Event (XML)
- 事件資料是以 XML 格式表示。
- 為「自訂」(使用者撰寫的)EP 配接器指定下列選項:
- 請指定下列其中一項:
- 如果發出模式為非同步,則指定為了格式化、遞送及發出事件而由使用者撰寫之 CICS 應用程式的交易 ID。您必須指定交易 ID,自訂 EP 配接器才能進行非同步發出。
- 如果發出模式為同步,則指定為了格式化、遞送及發出事件而由使用者撰寫之 CICS 應用程式的名稱。您必須指定程式 ID,自訂 EP 配接器才能進行同步發出。
- 撰寫要傳遞至「自訂」EP 配接器的資料。您的「自訂」EP 配接器會處理此資料。
- 請指定下列其中一項:
- 為 HTTP EP 配接器指定下列選項:
- 指定 URIMAP。代表 HTTP 1.1 標準伺服器之連線的 URIMAP 資源名稱。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- 共用基本事件 (XML)
- 事件會以支援「共用事件基礎架構」之任何產品可使用的共用基本事件格式,傳送至 HTTP 1.1 標準伺服器。
- 共用基本事件 REST (XML)
- 事件會以 IBM Business Monitor 所需的 XML 格式傳送至 HTTP 1.1 標準伺服器。
- WebSphere Business Events (XML)
- 事件會以 IBM Operational Decision Manager 的 Decision Server Events 元件 所需的 XML 格式傳送至 HTTP 1.1 標準伺服器。
- Decision Server Insights Event (XML)
- 事件會以 IBM Operational Decision Manager 的 Decision Server Insights 元件 所需的 XML 格式傳送至 HTTP 1.1 標準伺服器。
- 為「IBM MQ 佇列」EP 配接器指定下列選項:
- 選擇性的: 指定任何必要的進階分派器選項。 這些選項適用於進階使用者,而且可控制 EP 配接器在 CICS 系統中的執行方式。註: 通常,讓 CICS 在分派器執行緒下執行 EP 配接器會比較有效率。不過,您可能需要 EP 配接器以個別交易執行;例如,如果您需要利用有權寫入 IBM MQ 佇列的特定使用者 ID 來執行它,或是您想要使用 TRANCLASS 設定來控制並行 EP 配接器作業的數目。
- 指定發出模式。 您可以指定 ASYNC 或 SYNC,來指定如何發出事件。若要確保事件發出,請指定同步發出模式。當發出模式為同步時,「IBM MQ 佇列」EP 配接器會發出下列事件:
- 交易式事件(使用 MQPMO_SYNCPOINT 選項)。IBM MQ 訊息可在擷取交易的工作單元中回復。
- 非交易式事件(使用 MQPMO_NO_SYNCPOINT 選項)。
當發出模式為非同步時,「IBM MQ 佇列」EP 配接器會使用 MQPMO_NO_SYNCPOINT 選項來發出事件。
附註:- 若為同步事件(確保事件發出),則事件擷取應用程式需要事件發出傳輸的寫入權限。若為非同步事件,則 EP 配接器需要寫入權限。
- 對 HTTP EP 配接器指定 SYNC NONTRANS 時,會讓擷取交易成為可能必須相應地重新配置的 Web 應用程式。
- 對於任何可能透過 HTTP EP 配接器來發出同步事件的交易,設定 TRANSACTION 定義的 DTIMOUT 屬性。
- 指定分派優先順序。 您可以指定正常或高優先順序,來控制事件分派器如何處理與此事件連結相關聯的事件。 根據事件為交易式設定,一旦可以使用高優先順序事件,即會發出這些事件。根據事件為交易式設定,一旦可以使用正常優先順序事件,即會發出這些事件,但在任何未解決的高優先順序事件之後。註: 此選項不適用於同步的發出模式。
- 指定交易 ID 及使用者 ID。 配接器會以指定的交易 ID 及使用者 ID 來起始。交易 ID 與「自訂」EP 配接器類型無關,而是設定在「配接器」區段中。根據交易 ID 及使用者 ID 的設定,EP 分派器作業會啟動或鏈結至 EP 配接器程式。如果 IBM MQ 佇列、TD 佇列、TS 佇列或要啟動的交易位於遠端,請參閱交互通訊的安全,以取得安全設定的相關資訊。
表 1. 「IBM MQ 佇列」EP 配接器、「TD 佇列」EP 配接器、「TS 佇列」EP 配接器及「交易啟動」EP 配接器的交易 ID 與使用者 ID 已指定交易 ID 已指定使用者 ID 使用環境定義使用者 ID EP 配接器為 執行 EP 配接器的身分 EP 配接器交易 ID 為 x x 已連接 指定的使用者 ID 指定的交易 ID x x 已連接 環境定義使用者 ID 指定的交易 ID x 已連接 指定的使用者 ID 「IBM MQ 佇列」EP 配接器的 CEPQ 「TD 佇列」EP 配接器的 CEPR「TS 佇列」EP 配接器的 CEPT
「交易啟動」EP 配接器的 CEPSx 已連接 環境定義使用者 ID IBM MQ EP 配接器的 CEPQ 「TD 佇列」EP 配接器的 CEPR「TS 佇列」EP 配接器的 CEPT
「交易啟動」EP 配接器的 CEPSx 已連接 CICS 預設使用者 ID 指定的交易 ID 已鏈結 CICS 區域使用者 ID 不適用 表 2. HTTP EP 配接器的交易 ID 及使用者 ID 已指定交易 ID 已指定使用者 ID 使用環境定義使用者 ID EP 配接器為 執行 EP 配接器的身分 EP 配接器交易 ID 為 x x 已連接 指定的使用者 ID 指定的交易 ID x x 已連接 環境定義使用者 ID 指定的交易 ID x 已連接 指定的使用者 ID CEPH x 已連接 環境定義使用者 ID CEPH x 已連接 CICS 預設使用者 ID 指定的交易 ID 已連接 CICS 預設使用者 ID CEPH 對於具有交易 ID 及非同步發出模式的「自訂(使用者撰寫的)」EP 配接器,EP 分派器作業一律會以指定的使用者 ID、環境定義使用者 ID 或 CICS 預設使用者 ID 連接至此配接器。註: 這兩個選項不適用於同步發出模式。 - 指定事件是否為交易式。 如果您想要 CICS 只在與事件相關聯的商業工作單元 (UOW) 順利完成時擷取事件,請選取事件為交易式勾選框。
註: 請仔細考量從無法回復的動作中擷取的事件是否應指定為交易式。例如,如果您從 WEB SEND 指令擷取交易式事件,然後工作單位遭到取消,則事件會遭到取消,但是 WEB SEND 指令可能已導致 HTTP 訊息傳送出去。
如果想要 CICS 在交易外處理與此事件連結相關聯的事件,請清除事件為交易式勾選框。事件會在產生時發出。
- 指定發出模式。 您可以指定 ASYNC 或 SYNC,來指定如何發出事件。若要確保事件發出,請指定同步發出模式。當發出模式為同步時,「IBM MQ 佇列」EP 配接器會發出下列事件:
結果
上層主題: 使用事件