您必須啟用 Liberty 伺服器,才能使用最佳化本端配接器支援來接收入埠和出埠要求。適用於 z/OS® 的 WebSphere® 最佳化本端配接器 (WOLA)
是一組可呼叫的服務 (API),可讓 z/OS 原生應用程式能夠對應用程式伺服器 Enterprise Bean 進行入埠呼叫,並讓原生程式擔任伺服器,以及接受正在 WebSphere Liberty 伺服器中執行之應用程式的要求。
程序
- 配置或選取載入模組程式庫,以包含最佳化本端配接器載入模組。 這個程式庫供在 Liberty 伺服器外部執行的應用程式使用。此程式庫必須是 PDS-E,並且需要大約 40 個磁軌 (3390) 來保存最佳化本端配接器模組。
- 從 wlp/clients/zos/* 將最佳化本端配接器載入模組複製到載入模組程式庫。 下列範例顯示如何將載入模組複製到 $DSNAME 資料集中:
cp -Xv wlp/clients/zos/* "//'$DSNAME'"
- 如果要在 Liberty 伺服器上啟用最佳化本端配接器支援,請在 server.xml 檔中配置 zosLocalAdapters-1.0 特性。
- 如果要啟用特性,請將 zosLocalAdapters-1.0 特性新增至 server.xml 檔,如下列範例所示。
<featureManager>
<feature>zosLocalAdapters-1.0</feature>
</featureManager>
- 在 server.xml 檔案中,以三部分的 WOLA 群組名稱來配置 zosLocalAdapters 元素,以建立 WOLA 群組。 三段式 WOLA 群組名稱供用戶端用來連接 Liberty 伺服器。群組名稱的每一部分必須是 1 到 8 個英數字元。
註: 請勿在 WOLA 群組名稱中使用小寫字元。z/OS 安全子系統會將小寫字元轉換成大寫字元,如此可能導致與您的配置不相符。
<zosLocalAdapters wolaGroup="LIB1" wolaName2="LIB2" wolaName3="LIB3"/>
- 將 connectionFactory 元素新增至 server.xml 檔案,並且在 properties.ola 元素中指定其內容,以配置 Connection Factory。
<connectionFactory jndiName="eis/ola">
<properties.ola RegisterName="OLASERVER"/>
</connectionFactory>
如需 WOLA Connection Factory 內容的相關資訊,請參閱 Liberty 上最佳化本端配接器的 Connection Factory 內容。
- 為 z/OS 建立 SERVER 設定檔。
- 為最佳化本端配接器的授權服務建立 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)
- 為授權用戶端模組 BBGZSAFM 建立 SERVER 設定檔,並在設定檔中允許 Liberty 伺服器的「已啟動作業」使用者 ID。這個動作可讓 Liberty 伺服器載入 z/OS 授權用戶端服務。 如果要讓使用 WLPUSER1 執行身分的伺服器存取授權用戶端模組,請執行下列動作:
rdef server bbg.authmod.bbgzscfm uacc(none)
permit bbg.authmod.bbgzscfm class(server) access(read) id(wlpuser1)
- 為最佳化本端配接器的授權用戶端服務建立 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 授權服務。
- 如果您已在「系統授權機能 (SAF)」中啟用 CBIND,請授與存取權給將使用最佳化本端配接器的用戶端。
- 在 CBIND 類別中,為 Liberty 伺服器定義一個設定檔。 設定檔名稱是 BBG.WOLA.<WOLA1>.<WOLA2>.<WOLA3>,其中 WOLA1、WOLA2 和 WOLA3 是最佳化配接器群組名稱的三個部分,這三個部分指定在 server.xml 檔的 <zosLocalAdapters> 元素中。您可以使用
SAF RDEFINE TSO 指令來定義設定檔。 例如,下列指令會在 CBIND 類別中,為名稱是 LIB1.LIB2.LIB3 的 WOLA 群組建立設定檔:
rdef cbind bbg.wola.lib1.lib2.lib3 uacc(none)
- 允許對設定檔具備讀取權。 例如,下列指令允許 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 伺服器上,部署和啟動使用最佳化本端配接器的應用程式。
下一步
請確定使用最佳化本端配接器的所有外部連線,都是執行最新版本的最佳化本端配接器載入模組程式庫。
- 確定載入模組程式庫是最新層次。
- 確定使用最佳化本端配接器的所有外部位址空間都可以使用此程式庫。例如,請確定批次工作在 STEPLIB 中有可用的程式庫,或「客戶資訊控制系統 (CICS®)」的 DFHRPL 連結中有可用的程式庫。
如果您想要使用將最佳化本端配接器與 CICS 搭配使用,您必須在 CICS 中啟用配接器的支援。如需相關資訊,請參閱在 CICS 中啟用 Liberty 最佳化本端配接器支援。
如果您想要將最佳化本端配接器與 IMS 一起使用,您必須在 IMS 中啟用配接器的支援。
如果需要相關資訊,請參閱Enabling support for Liberty optimized local adapters in IMS。
如果您想要建立連線,請先向 Liberty 伺服器登錄外部位址空間。如需相關資訊,請參閱使用最佳化本端配接器,向本端 Liberty 伺服器登錄一個外部位址空間。