定义 z/OS Connect 服务

z/OS® Connect 服务定义提供了使用 REST 调用来访问 z/OS 应用程序资产的机制。要启用 z/OS Connect 服务,您必须使用元素名称 zosConnectService 以及名称和服务提供者引用元素名称将 z/OS Connect 服务定义添加到 Liberty server.xml 文件。

关于此任务

由配置元素 zosConnectService 来定义 z/OS Connect 服务。此元素包含可能已全局定义等效件的属性定义。可以通过 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 service definitions --> 
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaCreateService"/> 
    有关与 zosConnectService 元素相关联的可配置属性定义的更多信息,请参阅 z/OS Connect 功能部件的文档。
  2. (可选)将 zosConnectManager 配置元素添加至 server.xml 文件。

    此元素是 server.xml 配置中的单实例,它包含适用于为服务器定义的所有 z/OS Connect 服务的全局值。该元素可以包含适用于服务器中的所有服务的 z/OS Connect 拦截器或者数据变换提供者配置元素的名称。

    以下示例描述了一个 zosConnectManager 配置元素,此元素在 globalOperationsGroup 项下定义操作组名 Operator1。这是在允许发出 z/OS Connect 操作请求(例如,action=start|stop|status)之前,发出请求的客户机用户标识需要处于的安全(SAF 或 LDAP)组的名称。此组适用于 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 连接工厂名称、注册名称和服务名称。z/OS Connect 的配置遵循 Liberty 约定,只需要指定最低限度的参数。请注意,当您配置 WOLA 连接工厂以进行 z/OS Connect 交互时,必须使用容器作为认证机制。未指定 containerAuthDataRef 属性的 WOLA 连接工厂不受支持。以下是一个示例:
    <!-- Local adapters connection factory definition --> 
    <authData id="cauth1" user="user1" password="{xor}LDo8Ki02KyY="/> 
    <connectionFactory id="wolaCF" jndiName="eis/ola"        
    	containerAuthDataRef="cauth1"  >       
    	<properties.ola/> 
    </connectionFactory>     
    
    <!-- Local adapters config --> 
    <zosLocalAdapters wolaGroup="LIBERTY" wolaName2="LIBERTY"         
    	wolaName3="LIBERTY" /> 
    
    <!-- WOLA Connect service and z/OS Connect service definitions --> 
    <localAdaptersConnectService id="wolaOpsCreate"             
    	registerName="BATCH01"   
    	serviceName="COBLPGM1"   
    	connectionFactoryRef="wolaCF"/> 
    
    <zosConnectService id="zcs1" serviceName="recordOpsCreate"    
    	serviceRef="wolaOpsCreate"   
    	runGlobalInterceptors="true"    
    	interceptorsRef="serviceInterceptorList"/> 

    允许 z/OS Connect 请求通过 WebSphere 优化本地适配器 (WOLA) 与 z/OS 资产进行交互的 z/OS Connect 服务实现可能需要数据变换器。如果全局配置了数据变换器或者在服务级别配置了数据变换器,那么会使用所配置的数据变换器来转换输入和输出有效内容。如果未配置数据变换器,并且请求中包含 JSON 有效内容,那么该服务假定后端程序将处理数据转换。该服务使用请求头中所指定的编码或者使用缺省 JSON 编码 UTF-8 将 JSON 有效内容按原样转换为字节阵列。同样,如果资产返回有效内容,并且未配置数据变换器,那么 WOLA 服务实现期望以字节阵列形式接收 JSON 有效内容,该 JSON 有效内容将遵循用于将 JSON 请求有效内容转换为字节阵列的相同编码规则来转换为 JSON 响应有效内容。

    WOLA 服务提供者实现允许在其 localAdaptersConnectService 配置元素中指定许多其他 WOLA 连接工厂定义。下表是 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"

    连接工厂元素的名称和要使用的 WOLA 资源适配器连接工厂的 JNDI 名称。有关更多信息,请参阅 Liberty WOLA 资源适配器文档。

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    等待与注册名称相匹配的外部地址空间应用程序发出“WOLA 接收请求”或“主机服务”API 并且变为活动状态的秒数。有关更多信息,请参阅 Liberty WOLA 资源适配器文档。

    linkTaskTranID

    required="false"

    type="String"

    指定 WOLA CICS 链接服务器链接调用任务事务标识的名称。有关更多信息,请参阅 Liberty WOLA 资源适配器文档。

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    使用 WOLA CICS 链接服务器时,表明是将有效内容传入 CICS 应用程序的单个 CICS 容器还是 COMMAREA。有关更多信息,请参阅 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=CHAR, 1=BIT)。有关更多信息,请参阅 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=CHAR, 1=BIT)。有关更多信息,请参阅 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=CHAR, 1=BIT)。有关更多信息,请参阅 Liberty WOLA 资源适配器文档。

用于指示主题类型的图标 任务主题



时间戳记图标 最近一次更新时间: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
文件名:twlp_zconnect_srvcdef.html