使用 WebSphere 最佳化本端配接器 (WOLA) 的「呼叫 API」,從外部位址空間呼叫部署在適用於 z/OS® 的本端 Liberty 伺服器上的 Stateless Session Bean。
開始之前
如果要將 Enterprise Bean 識別為最佳化本端配接器呼叫的潛在目標,您的 Enterprise JavaBean (EJB) 應用程式必須將 com.ibm.websphere.ola.ExecuteLocalBusiness 介面當成本端商業介面來實作。此介面位於
wlp/dev/api/ibm/com.ibm.websphere.appserver.api.zosLocalAdapters_1.0.0.jar 檔。
Liberty 伺服器在發出登錄要求的相同 z/OS 映像檔上必須處於作用中。請確定現行位址空間已登錄,並且已使用「登錄 API」連結至目標最佳化本端配接器群組。如需登錄外部位址空間的相關資訊,請參閱使用最佳化本端配接器,向本端 Liberty 伺服器登錄外部位址空間。
關於這項作業
在您呼叫 Enterprise Bean 之前,如果您知道回應區域的長度,這種呼叫 Bean 的方法,可提供簡化的途徑。如果您不知道回應區域的長度,或者希望在呼叫 Bean 時能有更大的彈性,請參閱
使用 Liberty 最佳化本端配接器 API,從外部位址空間呼叫 Enterprise Bean。
程序
- 在您使用「呼叫 API」(BBOA1INV) 來呼叫 Bean 時,請決定要使用的參數。
API 接受下列項目的參數:
- 您在呼叫「登錄 API」時所指定的登錄名稱
- 要求類型,必須設為 1,代表本端 EJB 工作要求
- 要呼叫的服務名稱,必須為 Stateless Session Bean 的 Java™ 命名和目錄介面 (JNDI) 本端商業介面路徑名稱
- 服務名稱的長度
- 指向要傳送之要求資料開頭的位址的指標
- 要傳送之要求資料的長度
- 指向回應資料區域開頭的位址的指標
- 要傳送之回應資料的長度
- 連線逾時之前的秒數
如需 API 參數的相關資訊,請參閱Liberty for z/OS 上的最佳化本端配接器 API。
- 從用戶端位址空間中的原生語言應用程式,使用您選取的參數,為您的呼叫端呼叫「呼叫 API」。 在目標 Enterprise JavaBeans (EJB) 應用程式中,執行方法會執行然後啟動所需要的任何商業邏輯,之後再將回應資料當成序列化位元組陣列,傳回給原生語言呼叫端。
- 檢閱回應資料。 0 回覆碼和原因碼表示用戶端的「呼叫 API」呼叫順利完成,且回應資料和回應資料長度儲存在呼叫端指定的區域中。
- 用戶端應用程式使用相同的登錄名稱呼叫,重複這些步驟,以根據所需的數目和頻率來呼叫 Stateless Session Bean。
小心: 利用「呼叫 API」,三個基本函數 Send_Request、Receive_RespLen 和 Get_Data 皆已完成。會封鎖呼叫端執行緒,直到收到回應資料,並複製到回應區域為止。
結果
用戶端使用最佳化本端配接器的「呼叫 API」,從
Liberty 伺服器啟動 Stateless Session Bean。