適用於 z/OS 平台

在 CICS 中啟用 Liberty 最佳化本端配接器支援

您必須啟用「客戶資訊控制系統 (CICS®)」環境,以使用 WebSphere® 最佳化本端配接器 (WOLA) 來接收入埠和出埠要求。

開始之前

Liberty 伺服器環境能夠使用最佳化本端配接器。如需相關資訊,請參閱讓 Liberty 伺服器環境使用最佳化本端配接器

程序

  1. 將最佳化本端配接器的 CICS 資源定義,新增至主要的 CICS 系統定義 (CSD) 檔 DFHCSD。 您可以手動將定義新增至 CICS,或下載並執行 CSUPDAT 範例。
    • 在 CICS 中,使用 CEDA 交易或對等的交易,將定義新增至 DFHCSD。如需必要的定義,請參閱 CICS 最佳化本端配接器定義
    • 使用 CICS 離線 CSD 更新程式 DFHCSDUP,將定義新增至 DFHCSD。如需 DFHCSDUP 程式的相關資訊,請參閱您 CICS 版本的說明文件。如需必要的定義,請參閱 CICS 最佳化本端配接器定義
    • 執行 CSDUPDAT.jclsamp 範例工作,來更新定義。
      1. 下載最佳化本端配接器範例。如需下載和安裝範例的相關資訊,請參閱 Liberty 的最佳化本端配接器範例
      2. 將範例和 CSDUPDAT 成員複製到資料集。
      3. 自訂您環境的 CSDUPDAT.jclsamp 範例工作。例如,在範例工作中,輸入 CSD 所在資料集的名稱。
      4. 執行 CSDUPDAT.jclsamp 範例工作。
  2. 將 CICS 所需的載入模組和 DLL 檔案,從 Liberty 伺服器的階層式檔案系統 (HFS) 或 zSeries 檔案系統 (zFS),複製到分割資料集,以便在 CICS 之下使用。 下列範例顯示如何將載入模組複製到 $DSNAME 資料集中:
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. 將資料集放在 CICS DFHRPL 連結中。
  4. 在 CICS 區域中設定 Liberty 訊息型錄。 最佳化本端配接器程式會從 Liberty 隨附的訊息型錄中發出訊息。對於要發出訊息的程式,CICS 區域中的 NLSPATH 環境變數必須指向包含該訊息型錄的目錄。這個目錄是 wlp/lib/native/zos/s390x/nls/%N.cat,其中 wlpLiberty 伺服器的安裝目錄。

    如果要設定環境變數,請使用 Language Environment 的 ENVAR 選項,您可以藉由編輯 CICS 區域所使用的 CEEROPT CSECT 來設定這個選項。編輯 CSECT 之後,您可以建置、編譯、鏈結和複製 CSECT 到 DFHRPL 資料集。如需 Language Environment 選項其他設定方法的相關資訊,請參閱您 CICS 版本的說明文件。

    註: 在設定 Language Environment 選項時,如果所用的方法涉及編輯應用程式原始碼或重新鏈結應用程式,則不支援該方法,因為最佳化本端配接器程式無法重新編譯或重新鏈結。
    下列範例顯示 CEEROPT CSECT,它為安裝在 /u/MSTONE1/wlp 中的 Liberty 伺服器,定義 NLSPATH 環境變數。請注意,定義跨了兩行,且欄 72 包含接續字元 X
    CEEROPT CSECT
    CEEROPT AMODE ANY
    CEEROPT RMODE ANY
    *****************************************************************
    *
    * Utility: CEEROPT
    * Purpose: Set default LE runtime options for CICS region.
    *
    *****************************************************************
            CEEXOPT ENVAR=(('NLSPATH=/u/MSTONE1/wlp/lib/native/zos/s390x/nlX
                   s/%N.cat'),OVR)
            END
  5. 執行下列動作,來維護最佳化本端配接器連線的安全:
    • 為 z/OS 建立 SERVER 設定檔。
    • 如果您已在「系統授權機能 (SAF)」中啟用 CBIND,請授與存取權給將使用最佳化本端配接器的用戶端。

    如需相關資訊,請參閱針對 Liberty for z/OS 上的入埠支援,維護最佳化本端配接器的安全

  6. 啟動最佳化本端配接器的「作業相關的使用者結束程式 (TRUE)」。

    您可以使用 BBOC 來啟動 TRUE 程式,BBOC 是 CICS 的最佳化本端配接器交易。您可以使用這項交易,來啟動、停止、啟用和停用 TRUE 模組的追蹤。TRUE 程式的名稱是 BBOATRUE,是使用設有 START_TRUE 參數的 BBOC 交易來啟動。

    當啟用 CICS 安全時,執行 BBOC START_TRUE 和 STOP_TRUE 參數時使用的使用者 ID 必須具備權限,才能發出 EXEC CICS ENABLE PROGRAM(BBOATRUE) 和 DISABLE PROGRAM(BBOATRUE) EXITALL 指令。CICS 之下的 Liberty 伺服器所發出的訊息,會遞送至 BBOQ 額外分割區暫時資料佇列 (TDQ),這個佇列配置在 CICS 區域中的 DD BBOOUT 之下。

    如需相關資訊,請參閱CICS 的 Liberty 伺服器交易:BBOC、BBO$ 和 BBO#

  7. 選擇性的: 如果您想使用 CICS 鏈結伺服器,請在 CICS 工作站上發出 BBOC_START_SRVR 指令,來啟動最佳化本端配接器 CICS 鏈結伺服器作業。 如需相關資訊,請參閱CICS 的 Liberty 伺服器交易:BBOC、BBO$ 和 BBO#

下一步

如果您想要建立連線,請先向 Liberty 伺服器登錄外部位址空間。如需相關資訊,請參閱使用最佳化本端配接器,向本端 Liberty 伺服器登錄外部位址空間


指示主題類型的圖示 作業主題

檔名:twlp_dat_enableconnectorcics.html