定義 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 用戶端服務的相關說明文件。

程序

  1. 針對您 server.xml 配置中的每一項服務,各新增一個 zosConnectService 配置元素。 您必須至少配置 serviceRef 和 serviceName 屬性。serviceRef 元素指向服務提供者配置元素。serviceName 屬性是指服務提供者要如何向 z/OS Connect 識別其本身,同時也是作為指向特定服務之 z/OS Connect 要求 URL 一部分的名稱。服務名稱必須是唯一的。以下是範例 server.xml 檔,顯示如果要新增稱為 recordOpsCreate 的 z/OS Connect 服務時,需要提供哪些項目:
    <!-- z/OS Connect 服務定義 --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaCreateService"/> 
    如需 zosConnectService 元素相關聯的可配置屬性定義的相關資訊,請參閱 z/OS Connect 特性的說明文件。
  2. (選用)在 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 特性說明文件。
  3. 如果在 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