指定 EP 配接器及分派器資訊

您可以在事件連結中指定資訊,控制 CICS® 如何發出事件連結所產生的事件。

關於這項作業

您可以使用分派器資訊,來定義此連結所建立的事件將發生什麼情況。您可以選取要發出事件的 EP 配接器,然後選取與該 EP 配接器相關的選項。

程序

  1. 按一下 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 配接器集資源

  2. 選擇性的: 您可以在此事件連結中匯出一或多個事件規格。
    若要匯出事件規格,請輸入預先定義的 EPADAPTER 資源名稱,或是選取您選擇的配接器:
    • 使用 TSQ EP 配接器或 WebSphere® MQ EP 配接器, 並選擇 CFE 格式以二進位形式發出事件,以便提供 COBOL 記錄定義檔 (.cpy)。
    • 使用任何其他 EP 配接器及格式,來提供 XML 綱目定義 (.xsd)。
    註: 如果您是使用「交易啟動」配接器,則不支援匯出「事件規格」。如需 CICS 儲存器型事件格式的詳細資料,請參閱 CICS TS 5.1 資訊中心中的事件處理格式
    1. 按一下匯出事件規格 若您是使用 EPADAPTER 資源,且工作區包含多個同名的配接器,則系統會要求您從清單中選擇一個配接器。 畫面上會顯示「匯出事件規格」視窗。
    2. 選取您要匯出的事件規格。
    3. 若要匯出事件規格,請在目標目錄欄位中指定目錄。
    4. 如果您使用的預先定義 EPADAPTER 資源不在工作區中,則必須為資料格式欄位選取合適的值。
    5. 按一下匯出
    對於每一個您選取的事件規格,會在指定的目錄中建立檔案。
    以下是部分範例規格:
    • 若您指定 WebSphere MQ EP 配接器 及「共用基本事件」格式,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 XML 綱目檔(example1_CBE.xsdexample2_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.xsdexample2_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.xsdexample2_CBE.xsd)。 您可以將這些綱目檔匯入至任何接受共用基本事件格式的消費者,以協助定義入埠事件。
    • 如果您指定「TS 佇列」EP 配接器,並選取兩個事件規格(名稱為 example1 及 example2),則會建立兩個 COBOL 記錄定義檔(example1.cpyexample2.cpy)。 您可以使用這些記錄定義檔,來處理自己的事件消費者程式中的資料。

    請注意,若您匯出事件規格,然後將相同的事件規格再次匯出至相同的目錄,則 CICS 事件連結編輯器會提示您改寫現有檔案或取消匯出作業。

  3. 配接器清單中選擇 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 EventsIBM Business Monitor 等產品使用。
    HTTP EP 配接器不支援確保發出交易式事件。
  4. 對您選擇的 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 標準伺服器。
  5. 選擇性的: 指定任何必要的進階分派器選項。 這些選項是針對進階使用者,且會控制 EP 配接器在 CICS 系統中的執行方式。
    註: 通常,讓 CICS 在分派器執行緒下執行 EP 配接器會比較有效率。不過,您可能需要 EP 配接器以個別交易執行;例如,若您需要利用有權寫入 WebSphere MQ 佇列的特定使用者 ID 來執行它,或是您要使用 TRANCLASS 設定來控制並行 EP 配接器作業的數目。
    1. 指定發出模式。 您可以指定 ASYNCSYNC,來指定如何發出事件。請指定同步的發出模式,以確保事件發出。當發出模式為同步時,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 屬性。
    2. 指定分派優先順序。 您可以指定 NormalHigh 優先順序,來控制事件分派器如何處理與此事件連結相關聯的事件。根據事件為交易式設定,一旦可以使用高優先順序事件,即會發出這些事件。根據事件為交易式設定,一旦可以使用正常優先順序事件,即會發出這些事件,但在任何未解決的高優先順序事件之後。
      註: 此選項不適用於同步的發出模式。
    3. 指定交易 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 連接至此配接器。
      註: 這兩個選項不適用於同步發出模式。
    4. 指定事件是否為交易式。 若您要 CICS 只在與事件相關聯的商業工作單元 (UOW) 順利完成時擷取事件,請選取事件為交易式勾選框。
      註: 請仔細考量從無法回復的動作中擷取的事件是否應指定為交易式。 比方說,若您從 WEB SEND 指令擷取交易式事件,然後工作單元遭到取消,則事件會遭到取消,但是 WEB SEND 指令可能已導致 HTTP 訊息傳送出去。

      若要 CICS 在交易外處理與此事件連結相關聯的事件,請清除事件為交易式勾選框。 事件會在發出時發出。

結果

事件連結的配接器及分派器資訊現在已完成。