使用最佳化本端配接器,向本端 Liberty 伺服器登錄外部位址空間

如果要讓 WebSphere 最佳化本端配接器 (WOLA) 對您的最佳化本端配接器群組進行出埠呼叫,或是對 Liberty 伺服器進行入埠呼叫,您必須將現有的位址空間連結至 Liberty 伺服器,並使用「登錄 API」建立連線屬性。

開始之前

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

Liberty 伺服器在發出登錄要求的相同 z/OS 映像檔上必須處於作用中。

如果您使用「客戶資訊控制系統 (CICS®)」,請在 CICS 中啟用最佳化本端配接器支援。如需相關資訊,請參閱在 CICS 中啟用 Liberty 最佳化本端配接器支援。在 CICS 與 Liberty 伺服器之間建立連線之前,請先啟動「作業相關使用者結束程式 (TRUE)」。

程序

  1. 在您使用「登錄 API」(BBOA1REG) 登錄位址空間時,請決定所要使用的參數。
    API 接受下列項目的參數:
    • 您在 server.xml 檔中新增特性時所指定的 WOLA 群組名稱(有三個部分)
    • 登錄名稱
    • 起始連線數下限
    • 連線數上限
    • 用來指定追蹤行為的登錄旗標單字

    如果是入埠呼叫 Liberty 伺服器,一律會將含有發出要求之位址空間使用者 ID 的安全環境定義,傳播到 Liberty 伺服器。若為 CICS,reg_flag_C2Wprop 登錄旗標會傳播 CICS 作業的使用者 ID,而不是傳播位址空間中的使用者 ID。

    如果是從 Liberty 伺服器進行出埠呼叫,reg_flag_W2Cprop 登錄旗標會告知 Liberty 伺服器,將使用者 ID 傳播到 CICS。接著,CICS 會嘗試使用該使用者 ID 啟動目標程式。

    如需 API 參數的相關資訊,請參閱 Liberty for z/OS 上的最佳化本端配接器 API維護 Liberty for z/OS 上的最佳化本端配接器的安全

  2. 驗證這個位址空間所連接的另一個最佳化本端配接器群組,尚未使用選取的登錄名稱。 如果另一個最佳化本端配接器群組使用該登錄名稱,會傳回錯誤回覆碼,且登錄要求失敗。
  3. 從用戶端位址空間中的原生語言應用程式,使用您選取的參數,為您的呼叫端呼叫「登錄 API」。

    0 回覆碼和原因碼表示用戶端位址空間現在連結至 Liberty 伺服器。

結果

所傳遞的登錄名稱字串會保留在現行位址空間中。不會使用這個記號發出其他登錄呼叫,直到為它接收「取消登錄 API」呼叫為止。
重要: 如果您在這項呼叫中使用連線數下限設定,其結果會是一個連線儲存區,其中含有預先建立的目標伺服器連線,且會等待要求。
也會建立登錄項目環境定義或控制區塊,並與登錄名稱字串相關聯。每一個唯一的登錄名稱都有登錄環境定義。若有多個登錄名稱具有相同的位址空間和執行緒,它們可以與一或多個 Liberty 最佳化本端配接器群組連結。

下一步

您可以使用登錄,在 Liberty 環境與外部位址空間之間進行入埠和出埠呼叫。如需相關資訊,請參閱開發使用 Liberty 最佳化本端配接器的應用程式

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

檔名:twlp_dat_register.html