定義 z/OS Connect 服務
z/OS® Connect 服務定義提供使用 REST 呼叫,來呼叫到 z/OS 應用程式資產的機制。如果要啟用 z/OS Connect 服務,您必須在 Liberty server.xml 檔中,使用 zosConnectService 元素名稱,以及一個名稱和服務提供者參照元素名稱,來新增 z/OS Connect 服務定義。
關於這項作業
z/OS Connect 服務是用 zosConnectService 配置元素來定義。這個元素所包含的屬性定義,可能具有廣域定義的對應項目。您可以透過 zosConnectManager 元素來廣域定義屬性。若有定義這些屬性,則會套用至所有服務。如果同時配置了廣域和服務層次的屬性,會使用在 zosConnectService 層次定義的值。
z/OS Connect 提供服務實作,以容許 z/OS Connect 要求透過「WebSphere 最佳化本端配接器 (WOLA)」,來與 z/OS 資產互動。如果同時配置了 zosConnect-1.0 和 zosLocalAdapters-1.0 特性,會自動啟用服務。這項服務實例可以透過 localAdaptersConnectService 配置元素來定義。
z/OS Connect 也提供服務實作,以容許 z/OS Connect 要求連接遠端 REST 端點。當配置 zosConnect-1.2 特性時,就能使用此服務。這項服務實例可以透過 zosConnectServiceRestClient 配置元素來定義。如需相關資訊,請參閱 z/OS Connect REST 用戶端服務的相關說明文件。
程序
- 針對您 server.xml 配置中的每一項服務,各新增一個 zosConnectService 配置元素。 您必須至少配置 serviceRef 和 serviceName 屬性。serviceRef 元素指向服務提供者配置元素。serviceName 屬性是指服務提供者要如何向 z/OS Connect 識別其本身,同時也是作為指向特定服務之 z/OS Connect 要求 URL 一部分的名稱。服務名稱必須是唯一的。以下是範例 server.xml 檔,顯示如果要新增稱為 recordOpsCreate 的 z/OS Connect 服務時,需要提供哪些項目:
如需 zosConnectService 元素相關聯的可配置屬性定義的相關資訊,請參閱 z/OS Connect 特性的說明文件。<!-- z/OS Connect 服務定義 --> <zosConnectService id="zcs1" serviceName="recordOpsCreate" serviceRef="wolaCreateService"/> - (選用)在 server.xml 檔中新增 zosConnectManager 配置元素。
這個元素在 server.xml 配置中是單態,所包含的廣域值會套用至定義給伺服器的所有 z/OS Connect 服務。這個元素可以包含 z/OS Connect 攔截程式或資料轉換提供者配置元素的名稱,並且是套用至伺服器中的所有服務。
下列範例說明 zosConnectManager 配置元素,它在 globalOperationsGroup 項目之下定義了作業群組名稱 Operator1。這是安全(SAF 或 LDAP)群組的名稱,要求端用戶端的使用者 ID 必須在這個群組中,才允許其發出 z/OS Connect 作業要求,例如 action=start|stop|status。這個群組會套用至 z/OS Connect 配置中的所有服務。dataxform 項目用來定義元素名稱,讓 z/OS Connect 可從中找到資料轉換提供者。在 zosConnect 元素中提供 dataxform,表示這是一項轉換提供者實作,用於配置中還沒有自己的資料轉換元素參照的所有服務。interceptors 項目是配置中的元素名稱,用來說明一組會套用至配置中所有服務的 z/OS Connect 攔截程式。
<zosConnectManager id="zosConnectGlobals" globalOperationsGroup="Operator1" globalDataxformRef="XformJSON2Byte" globalInterceptorsRef="GlobalInterceptors"/>如需 zosConnectManager 元素相關聯的可配置屬性定義的相關資訊,請參閱 z/OS Connect 特性的說明文件。
如需每一個屬性的相關資訊,請參閱 Liberty 特性說明文件。 - 如果在 Liberty 中配置了 WOLA,要求的配置需要在 server.xml 檔中提供 localAdaptersConnectService 配置元素。 這項配置至少需由目標 WOLA Connection Factory 名稱、登錄名稱和服務名稱組成。配置 z/OS Connect 時,只需要指定最基本的參數,就足以遵循 Liberty 使用慣例。請注意,當您配置 WOLA Connection Factory,以便與 z/OS Connect 互動時,您必須使用儲存器來作為鑑別機制。不支援沒有指定 containerAuthDataRef 屬性的 WOLA Connection Factory。範例如下:
<!-- 本端配接器 Connection Factory 定義 --> <authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/> <connectionFactory id="wolaCF" jndiName="eis/ola" containerAuthDataRef="cauth1" > <properties.ola/> </connectionFactory> <!-- 本端配接器配置 --> <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY" wolaName3="LIBERTY" /> <!-- WOLA Connect 服務和 z/OS Connect 服務定義 --> <localAdaptersConnectService id="wolaOpsCreate" registerName="BATCH01" serviceName="COBLPGM1" connectionFactoryRef="wolaCF"/> <zosConnectService id="zcs1" serviceName="recordOpsCreate" serviceRef="wolaOpsCreate" runGlobalInterceptors="true" interceptorsRef="serviceInterceptorList"/>如果 z/OS Connect 服務實作容許 z/OS Connect 要求透過「WebSphere 最佳化本端配接器 (WOLA)」,來與 z/OS 資產互動,其可能需要資料轉換器。如果配置了資料轉換器,不論是廣域或是在服務層次,都會使用所配置的資料轉換器,來轉換輸入及輸出內容。如果沒有配置資料轉換器,且要求含有 JSON 內容,服務會假設後端程式將處理資料轉換。服務會使用要求標頭中指定的編碼,或使用預設 JSON 編碼 UTF-8,將 JSON 內容依現狀轉換成位元組陣列。同樣地,如果資產傳回內容,卻沒有配置資料轉換器,WOLA 服務實作會預期將收到位元組陣列格式的 JSON 內容,其會遵循將 JSON 要求內容轉換成位元組陣列時所用的相同編碼規則,來轉換成 JSON 回應內容。
WOLA 服務提供者實作容許將其他的一些 WOLA Connection Factory 定義,指定在其 localAdaptersConnectService 配置元素中。下表是 localAdaptersConnectService 屬性定義清單,以及每一項定義的說明。
屬性定義 說明 serviceName
required="true"
type="String"
WOLA 目標服務的名稱。這個服務名稱必須符合外部位址空間應用程式在 WOLA 的「接收要求」或「主機服務」API 呼叫中所用的名稱,或符合具備「WOLA CICS 鏈結伺服器」之 SVC 所用的程式名稱。 registerName
required="true"
type="String"
WOLA 目標登錄的名稱。這項目標登錄必須符合外部位址空間應用程式在 WOLA 的「登錄」API 呼叫中所用的名稱,或符合具備「WOLA CICS 鏈結伺服器」之 RGN 所用的名稱。 connectionFactoryRef
required="true"
type="String"
要使用的 Connection Factory 元素名稱以及 WOLA 資源配接器 Connection Factory 的 JNDI 名稱。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 connectionWaitTimeout
required="false"
type="Integer"
min="0"
max="2147483647"
等待符合登錄名稱的外部位址空間應用程式,發出 WOLA「接收要求」或「主機服務」API 並且變成作用中的秒數。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskTranID
required="false"
type="String"
指定「WOLA CICS 鏈結伺服器」鏈結呼叫作業交易 ID 的名稱。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 useCICSContainer
required="false"
type="Boolean"
default="false"
當使用「WOLA CICS 鏈結伺服器」時,指出要將內容放到單一 CICS 儲存器或 COMMAREA 中,來傳遞給 CICS 目標應用程式。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskTranID
required="false"
type="String"
當使用「WOLA CICS 鏈結伺服器」,且 useCICSContainer 旗標設為 true 時,則指定 CICS 目標要求儲存器的名稱。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskReqContType
type="Integer"
min="0"
default="0"
當使用「WOLA CICS 鏈結伺服器」,且 useCICSContainer 旗標設為 true 時,則指定 CICS 目標要求儲存器的類型(0=字元,1=位元)。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskRspContID
required="false"
type="String"
當使用「WOLA CICS 鏈結伺服器」,且 useCICSContainer 旗標設為 true 時,則指定 CICS 目標回應儲存器的名稱。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskRspContType
type="Integer"
min="0"
default="0"
當使用「WOLA CICS 鏈結伺服器」,且 useCICSContainer 旗標設為 true 時,則指定 CICS 目標回應儲存器的類型(0=字元,1=位元)。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskChanID
required="false"
type="String"
當使用「WOLA CICS 鏈結伺服器」時,則指定當使用 CICS 儲存器來遞送訊息和所接收的回應訊息時,要使用的 CICS 通道名稱。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。 linkTaskChanType
required="false"
type="Integer"
min="0"
default="0"
當使用「WOLA CICS 鏈結伺服器」,並且指定了 linkTaskChanID 通道名稱時,則指定與該通道相關聯之 CICS 目標儲存器的類型(0=字元,1=位元)。如需相關資訊,請參閱 Liberty WOLA 資源配接器說明文件。
作業主題
前次更新: 2016 年 6 月 3 日http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
檔名:twlp_zconnect_srvcdef.html
