您可以在事件連結中指定資訊,控制 CICS® 如何發出事件連結所產生的事件。
關於這項作業
您可以使用分派器資訊,來定義此連結所建立的事件將發生什麼情況。您可以選取要發出事件的 EP 配接器,然後選取與該 EP 配接器相關的選項。
程序
- 按一下 CICS 事件連結編輯器中的配接器標籤,然後選取使用定義於此處的配接器選項,以指定要用於此事件連結的 EP 配接器配置、EP 配接器的參數,以及任何進階資訊。
您可以選擇要使用預先定義的 EPADAPTER 資源還是 EPADAPTERSET 資源。如需預先定義的 EPADAPTER 資源的相關資訊,請參閱 CICS TS 5.1 資訊中心中的事件處理 (EP) 配接器配置編輯器。如需預先定義的 EPADAPTERSET 資源的相關資訊,請參閱 CICS TS 5.1 資訊中心中的事件處理 (EP) 配接器集編輯器。
如果您指定預先定義的 EPADAPTER 或 EPADAPTERSET 資源,則必須在名稱欄位中輸入名稱,或按一下選擇以選擇資源。如需選擇配接器資源的相關資訊,請參閱CICS TS 5.1 資訊中心中的選擇 EP 配接器資源及CICS TS 5.1 資訊中心中的選擇 EP 配接器集資源。
- 選擇性的: 您可以在此事件連結中匯出一或多個事件規格。
若要匯出事件規格,請輸入預先定義的 EPADAPTER 資源名稱,或是選取您選擇的配接器:
- 使用 TSQ EP 配接器或 WebSphere® MQ
EP 配接器,
並選擇 CFE 格式以二進位形式發出事件,以便提供 COBOL 記錄定義檔 (.cpy)。
- 使用任何其他 EP 配接器及格式,來提供 XML 綱目定義 (.xsd)。
- 按一下匯出事件規格。 若您是使用 EPADAPTER 資源,且工作區包含多個同名的配接器,則系統會要求您從清單中選擇一個配接器。 畫面上會顯示「匯出事件規格」視窗。
- 選取您要匯出的事件規格。
- 若要匯出事件規格,請在目標目錄欄位中指定目錄。
- 如果您使用的預先定義 EPADAPTER 資源不在工作區中,則必須為資料格式欄位選取合適的值。
- 按一下匯出。
對於每一個您選取的事件規格,會在指定的目錄中建立檔案。
以下是部分範例規格:
- 若您指定 WebSphere MQ
EP 配接器
及「共用基本事件」格式,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 XML 綱目檔(example1_CBE.xsd 及 example2_CBE.xsd)。
您可以將這些綱目檔匯入 IBM® Business Monitor,以協助定義入埠事件。
- 若您指定 WebSphere MQ
EP 配接器
及 WebSphere Business Events (XML) 格式,並選取名稱為 example1 的事件規格,則會建立 XML 綱目檔 (example1_WBE.xsd)。
您可以在 WebSphere Business Events 的「設計資料」工具中使用此綱目檔,以利定義事件。
- 如果您指定 HTTP EP 配接器及「共用基本事件 REST」格式,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 XML 綱目檔(example1_CBER.xsd 及 example2_CBER.xsd)。
您可以將這些綱目檔匯入 IBM Business Monitor,以協助定義入埠事件。
- 如果您指定 HTTP EP 配接器及 WebSphere Business Events (XML) 格式,並選取名稱為 example1 的事件規格,則會建立 XML 綱目檔 (example1_WBE.xsd)。
您可以在 WebSphere Business Events 的「設計資料」工具中使用此綱目檔,來協助定義入埠事件。
- 如果您指定 HTTP EP 配接器及「共用基本事件」格式,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 XML 綱目檔(example1_CBE.xsd 及 example2_CBE.xsd)。
您可以將這些綱目檔匯入至任何接受共用基本事件格式的消費者,以協助定義入埠事件。
- 如果您指定「TS 佇列」EP 配接器,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 COBOL 記錄定義檔(example1.cpy 及 example2.cpy)。
您可以使用這些記錄定義檔,來處理自己的事件消費者程式中的資料。
請注意,若您匯出事件規格,然後將相同的事件規格再次匯出至相同的目錄,則 CICS 事件連結編輯器會提示您改寫現有檔案或取消匯出作業。
- 從配接器清單中選擇 EP 配接器類型。 您可以指定下列 EP 配接器類型:
- TS 佇列
- 以其中一種 XML 格式(「共用基本事件」、「共用基本事件
REST」或 WebSphere Business Events
(WBE)),或以非 XML (CFE) 格式,將事件發出至指定的 CICS TS 佇列。請使用此 EP 配接器來驗證是否正在以正確的資料擷取正確的事件,並將事件發出至任何從 TS 佇列讀取的消費端。
- 針對確保事件發出,同步交易式事件需要可復原的 TS 佇列;同步非交易式事件需要無法復原的佇列。
TS 佇列是否為可復原的佇列視相符 TSMODEL 的設定而定;只在有一個相符的 TSMODEL 時,TS 佇列才能是可復原的佇列。當您對同步的交易式事件使用 TS 佇列配接器時,在擷取事件的工作單元中,您無法對事件 TS 佇列發出 DELETEQ TS 指令。
- 交易啟動
- 將事件發出至指定 CICS 交易。
資料會以儲存器型事件格式傳遞至交易。您可以指定 CICS 系統來執行交易。如果不需要事件資料,則可以使用現有交易。
- +交易啟動 EP 配接器不支援確保事件發出。
- 自訂(使用者撰寫)
- 以任何您需要的格式發出事件。自訂 EP 配接器是您所撰寫的 CICS 程式,用來提供隨附的 EP 配接器所不支援之事件的格式化和遞送組合。
自訂 EP 配接器不可執行任何其他處理,例如,使用事件。
- 針對確保事件發出,自訂 EP 配接器必須符合事件的可回復性需求。
請參閱自訂 EP 配接器的文件,以查看它是支援交易式或非交易式同步事件。
- WebSphere Message Queue
- 以 XML 格式(供 WebSphere Business Events 使用)、「共用基本事件」格式(供 IBM Business Monitor 使用)或非 XML 格式,將事件發出至 WebSphere 訊息佇列。
- 針對確保事件發出,結合 WebSphere MQ EP 配接器與持續 WebSphere 訊息佇列一起使用,可以確保遞送事件。
- HTTP
- 使用 HTTP POST 以 XML 格式將事件發出至 HTTP 1.1 標準伺服器,供 WebSphere Business Events 與 IBM Business Monitor 等產品使用。
- HTTP EP 配接器不支援確保發出交易式事件。
- 對您選擇的 EP 配接器類型指定選項:
- 對「TS 佇列」的 EP 配接器指定下列選項:
- 指定 CICS 佇列名稱。您必須指定佇列名稱。
- 如果您的目標佇列為遠端佇列,請指定系統 ID。
- 如果需要的話,請選取使用輔助暫時儲存體。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- CICS 壓縮事件(二進位)
- 事件資料是以非 XML 格式表示。
- WebSphere Business Events (XML)
- 事件資料是以 XML 格式表示。
- 共用基本事件 (XML)
- 事件資料是以 XML 格式表示。
- 共用基本事件 REST (XML)
- 事件資料是以 XML 格式表示。
- 對「交易啟動」EP 配接器指定下列選項:
- 指定由於事件而執行的 CICS 應用程式的交易 ID。您必須指定交易 ID。
- 指定交易使用者 ID。由交易啟動 EP 配接器啟動的交易會使用此使用者 ID 來執行。
- 指定只適用於交易 EP 配接器的系統 ID。EP 配接器會使用此系統 ID,在 CICS 系統上執行。
- 對自訂(使用者撰寫的)EP 配接器指定下列選項:
- 指定下列其中一項:
- 如果發出模式為非同步,則指定為了格式化、遞送及發出事件而由使用者撰寫之 CICS 應用程式的交易 ID。您必須指定交易 ID,自訂 EP 配接器才能進行非同步發出。
- 如果發出模式為同步,則指定為了格式化、遞送及發出事件而由使用者撰寫之 CICS 應用程式的名稱。
您必須指定程式 ID,自訂 EP 配接器才能進行同步發出。
- 撰寫要傳遞至自訂 EP 配接器的資料。您的自訂 EP 配接器會處理此資料。
- 對 WebSphere MQ EP 配接器指定下列選項:
- 指定 WebSphere MQ 佇列的佇列名稱,此事件連結所發出的事件會放置在該佇列上。您必須指定佇列名稱。
- 指定訊息是否為持續的。請從持續清單中選取下列其中一個值。
- 否
- 由 WebSphere MQ EP 配接器放置在佇列上的訊息
是非持續的。
- 是
- 由 WebSphere MQ EP 配接器放置在佇列上的訊息
是持續的。
- 佇列預設值
- 放置在佇列上的訊息會繼承指定佇列的預設持續性。
- 指定訊息優先順序。您可以選取佇列預設值,或在優先順序欄位中,對 WebSphere MQ 訊息優先順序鍵入一值(從 0 到 9)。
- 指定期限時間。您可以選取永不到期,或在期限時間欄位中,對 WebSphere MQ 訊息期限鍵入一值。此時間是以十分之一秒來表示。
如果在經歷這段期間之前,未從目的地佇列中移除訊息,則該訊息會變成可以捨棄。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- CICS 壓縮事件(二進位)
- 事件資料是以非 XML 格式表示。
- WebSphere Business Events (XML)
- 訊息會放置在佇列上,並以 WebSphere Business Events 所需的 XML 格式表示。
- 共用基本事件 (XML)
- 訊息會以 IBM Business Monitor 所需的共用基本事件格式放置在佇列上。
- 對 HTTP EP 配接器指定下列選項:
- 指定 URIMAP。代表 HTTP 1.1 標準伺服器之連線的 URIMAP 資源名稱。
- 指定事件的資料格式。請從資料格式清單中選取下列其中一個值:
- 共用基本事件 REST (XML)
- 事件會傳送至 HTTP 1.1 標準伺服器,並以 IBM Business Monitor 所需的 XML 格式表示。
- WebSphere Business Events (XML)
- 事件會傳送至 HTTP 1.1 標準伺服器,並以 WebSphere Business Events 所需的 XML 格式表示。
- 共用基本事件 (XML)
- 事件會以支援「共用事件基礎架構」之任何產品可使用的共用基本事件格式,傳送至 HTTP 1.1 標準伺服器。
- 選擇性的: 指定任何必要的進階分派器選項。 這些選項是針對進階使用者,且會控制 EP 配接器在 CICS 系統中的執行方式。
註: 通常,讓 CICS 在分派器執行緒下執行 EP 配接器會比較有效率。不過,您可能需要 EP 配接器以個別交易執行;例如,若您需要利用有權寫入 WebSphere MQ 佇列的特定使用者 ID 來執行它,或是您要使用 TRANCLASS 設定來控制並行 EP 配接器作業的數目。
- 指定發出模式。 您可以指定 ASYNC 或 SYNC,來指定如何發出事件。請指定同步的發出模式,以確保事件發出。當發出模式為同步時,WebSphere MQ EP 配接器會發出下列事件:
- 使用 MQPMO_SYNCPOINT 選項的交易式事件。WebSphere MQ 訊息可在擷取交易的工作單元中回復。
- 使用 MQPMO_NO_SYNCPOINT 選項的非交易式事件。
當發出模式為非同步時,WebSphere MQ EP 配接器會使用 MQPMO_NO_SYNCPOINT 選項來發出事件。
附註: - 若為同步事件(確保事件發出),則事件擷取應用程式需要事件發出傳輸的寫入權限。若為非同步事件,則 EP 配接器需要寫入權限。
- 對 HTTP EP 配接器指定 SYNC NONTRANS 時,會讓擷取交易成為可能必須相應重新配置的 Web 應用程式。
- 對於任何可能透過 HTTP EP 配接器來發出同步事件的交易,設定 TRANSACTION 定義的 DTIMOUT 屬性。
- 指定分派優先順序。 您可以指定 Normal 或 High 優先順序,來控制事件分派器如何處理與此事件連結相關聯的事件。根據事件為交易式設定,一旦可以使用高優先順序事件,即會發出這些事件。根據事件為交易式設定,一旦可以使用正常優先順序事件,即會發出這些事件,但在任何未解決的高優先順序事件之後。
註: 此選項不適用於同步的發出模式。
- 指定交易 ID 及使用者 ID。 配接器會以指定的交易 ID 及使用者 ID 來起始。交易 ID 與「自訂」EP 配接器類型無關,而是設定在「配接器」區段中。根據交易 ID 及使用者 ID 的設定,EP 分派器作業會啟動或鏈結至 EP 配接器程式。
表 1. WebSphere MQ EP 配接器、「TS 佇列」EP 配接器及「交易啟動」EP 配接器的交易 ID 與使用者 ID已指定交易 ID |
已指定使用者 ID |
使用環境定義使用者 ID |
EP 配接器為 |
執行 EP 配接器的身分 |
EP 配接器交易 ID 為 |
x |
x |
|
已連接 |
指定的使用者 ID |
指定的交易 ID |
x |
|
x |
已連接 |
環境定義使用者 ID |
指定的交易 ID |
|
x |
|
已連接 |
指定的使用者 ID |
WebSphere MQ EP 配接器的 CEPQ
「TS 佇列」EP 配接器的 CEPT
「交易啟動」EP 配接器的 CEPS
|
|
|
x |
已連接 |
環境定義使用者 ID |
WebSphere MQ EP 配接器的 CEPQ
「TS 佇列」EP 配接器的 CEPT
「交易啟動」EP 配接器的 CEPS
|
x |
|
|
已連接 |
CICS 預設使用者 ID |
指定的交易 ID |
|
|
|
已鏈結 |
CICS 區域使用者 ID |
不適用 |
如果 WebSphere MQ 佇列、TS 佇列或要啟動的交易位於遠端,請參閱
,以取得安全設定的相關資訊。
表 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 在交易外處理與此事件連結相關聯的事件,請清除事件為交易式勾選框。
事件會在發出時發出。