適用於 z/OS 平台

Liberty 伺服器環境使用最佳化本端配接器

您必須讓 Liberty 伺服器能夠使用最佳化本端配接器支援,來接收入埠和出埠要求。適用於 z/OS® 的 WebSphere® 最佳化本端配接器 (WOLA) 是一組可呼叫的服務 (API),可讓 z/OS 原生應用程式能夠對應用程式伺服器 Enterprise Bean 進行入埠呼叫,並讓原生程式作為伺服器,以及接受 Liberty 伺服器中執行之應用程式所提出的要求。

開始之前

將 zosLocalAdapters-1.0 特性安裝在您的 Liberty 環境中。如需相關資訊,請參閱安裝 Liberty Repository 資產

程序

  1. 配置或選取載入模組程式庫,以包含最佳化本端配接器載入模組。 這個程式庫供在 Liberty 伺服器外部執行的應用程式使用。此程式庫必須是 PDS-E,並且需要大約 40 個磁軌 (3390) 來保存最佳化本端配接器模組。
  2. wlp/clients/zos/* 將最佳化本端配接器載入模組複製到載入模組程式庫。 下列範例顯示如何將載入模組複製到 $DSNAME 資料集中:
    cp -Xv wlp/clients/zos/* "//'$DSNAME'" 
  3. 如果要在 Liberty 伺服器上啟用最佳化本端配接器支援,請在 server.xml 檔中配置 zosLocalAdapters-1.0 特性。
    1. 如果要啟用特性,請將 zosLocalAdapters-1.0 特性新增至 server.xml 檔,如下列範例所示。
      <featureManager>
        <feature>zosLocalAdapters-1.0</feature>
      </featureManager>
    2. server.xml 檔案中,以三部分的 WOLA 群組名稱來配置 zosLocalAdapters 元素,以建立 WOLA 群組。 三段式 WOLA 群組名稱供用戶端用來連接 Liberty 伺服器。群組名稱的每一部分必須是 1 到 8 個英數字元。
      註: 請勿在 WOLA 群組名稱中使用小寫字元。z/OS 安全子系統會將小寫字元轉換成大寫,如此可能造成與您的配置不符。
      <zosLocalAdapters wolaGroup="LIB1" wolaName2="LIB2" wolaName3="LIB3"/>
  4. connectionFactory 元素新增至 server.xml 檔案,並且在 properties.ola 元素中指定其內容,以配置 Connection Factory。
    <connectionFactory jndiName="eis/ola">
     <properties.ola RegisterName="OLASERVER"/>
    </connectionFactory>
    如需 WOLA Connection Factory 內容的相關資訊,請參閱 Liberty 上最佳化本端配接器的 Connection Factory 內容
  5. 為 z/OS 建立 SERVER 設定檔。
    1. 為最佳化本端配接器的授權服務建立 SERVER 設定檔。 請使用下列「分時選項 (TSO)」指令:
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.LOCALCOM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.LOCALCOM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
      RDEF SERVER BBG.AUTHMOD.BBGZSAFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSAFM.WOLA CLASS(SERVER)ACCESS(READ) ID(wlpuser1)
    2. 建立授權用戶端模組 BBGZSCFM 的 SERVER 設定檔,並允許 Liberty 伺服器的「已啟動作業」使用者 ID 存取此設定檔。 這個動作可讓 Liberty 伺服器載入 z/OS 授權用戶端服務。 如果要讓以 WLPUSER1 身分執行的伺服器存取授權用戶端模組,請執行下列動作:
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    3. 為最佳化本端配接器的授權用戶端服務建立 SERVER 設定檔。 使用下列 TSO 指令:
      RDEF SERVER BBG.AUTHMOD.BBGZSCFM.WOLA UACC(NONE)
      PERMIT BBG.AUTHMOD.BBGZSCFM.WOLA CLASS(SERVER) ACCESS(READ) ID(wlpuser1)
    如需相關資訊,請參閱在 Liberty for z/OS 上啟用 z/OS 授權服務
  6. 如果您已在「系統授權機能 (SAF)」中啟用 CBIND,請授與存取權給將使用最佳化本端配接器的用戶端。
    1. 在 CBIND 類別中,為 Liberty 伺服器定義一個設定檔。 設定檔名稱是 BBG.WOLA.<WOLA1>.<WOLA2>.<WOLA3>,其中 WOLA1WOLA2WOLA3 是最佳化配接器群組名稱的三個部分,這三個部分指定在 server.xml 檔的 <zosLocalAdapters> 元素中。您可以使用 SAF RDEFINE TSO 指令來定義設定檔。 例如,下列指令會在 CBIND 類別中,為名稱是 LIB1.LIB2.LIB3 的 WOLA 群組建立設定檔:
      RDEF CBIND BBG.WOLA.LIB1.LIB2.LIB3 UACC(NONE)
    2. 允許對設定檔具備讀取權。 例如,下列指令允許 username 使用者名稱對 bbg.wola.lib1.lib2.lib3 設定檔具備讀取權:
      PERMIT BBG.WOLA.LIB1.LIB2.LIB3 CLASS(CBIND) ACCESS(READ) ID(username)
      您可以使用星號,允許使用者具備多個設定檔的存取權。下列範例允許 username 使用者對 CBIND 類別中開頭是 bbg.wola 的所有設定檔,具備 READ 存取權:
      RDEF CBIND BBG.WOLA.* UACC(NONE)
      PERMIT BBG.WOLA.* CLASS(CBIND) ACCESS(READ) ID(username)
    如需 SAF 指令和語法的相關資訊,請參閱您 z/OS 版本的說明文件。

結果

現在,您可以在 Liberty 伺服器上,部署和啟動使用最佳化本端配接器的應用程式。

下一步

請確定使用最佳化本端配接器的所有外部連線,都是執行最新版本的最佳化本端配接器載入模組程式庫。用戶端(例如 WOLA 鏈結伺服器)所使用的程式庫應該來自可能與它連接的最新 Liberty 安裝。 此外,用戶端(例如 WOLA 鏈結伺服器)與舊版的 WOLA 用戶端程式庫相容,除非 IBM® 另有指示。
  1. 確定載入模組程式庫是最新層次。
  2. 確定使用最佳化本端配接器的所有外部位址空間都可以使用此程式庫。例如,請確定批次工作在 STEPLIB 中有可用的程式庫,或在「客戶資訊控制系統 (CICS®)」的 DFHRPL 連結中有可用的程式庫。

如果您想要使用將最佳化本端配接器與 CICS 搭配使用,您必須在 CICS 中啟用配接器的支援。如需相關資訊,請參閱在 CICS 中啟用 Liberty 最佳化本端配接器支援

如果您想要將最佳化本端配接器與 IMS™ 搭配使用,您必須在 IMS 中啟用配接器的支援。如需相關資訊,請參閱在 IMS 中啟用 Liberty 最佳化本端配接器支援

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


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

檔名:twlp_dat_enableconnector.html