z/OS Connect 서비스 정의

z/OS® Connect 서비스 정의는 REST 호출을 사용하여 z/OS 애플리케이션 자산에 도달하기 위한 메커니즘을 제공합니다. z/OS Connect 서비스를 사용하려면, 이름 및 서비스 제공자 참조 요소 이름과 함께 요소 이름 zosConnectServiceLiberty server.xml 파일에 z/OS Connect 서비스 정의를 추가해야 합니다.

이 태스크 정보

z/OS Connect 서비스는 zosConnectService 구성 요소로 정의됩니다. 이 요소는 글로벌로 정의된 대응 파트가 있을 수 있는 속성 정의를 포함합니다. 속성은 zosConnectManager 요소를 통해 글로벌로 정의될 수 있습니다. 이러한 속성이 정의되면 모든 서비스에 적용됩니다. 글로벌 및 서비스 레벨 속성이 둘 다 구성된 경우, zosConnectService 레벨에 정의된 값이 사용됩니다.

z/OS Connect는 z/OS Connect가 WebSphere Optimized Local Adapters(WOLA)를 통해 z/OS 자산과의 상호작용을 요청하도록 허용하는 서비스 구현을 제공합니다. 이 서비스는 zosConnect-1.0zosLocalAdapters-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의 파트로 사용되는 이름이기도 합니다. 서비스 이름은 고유해야 합니다. 다음은 recordOpsCreate라고 하는 z/OS Connect 서비스를 추가하기 위해 무엇이 필요한지를 보여주는 샘플 server.xml 파일입니다. 참고로, 보다 복잡한 예제는 3단계에 나와 있습니다.
    <!-- z/OS Connect service definitions -->
    <zosConnectService id="zcs1"  
    	serviceName="recordOpsCreate"  
    	serviceRef="wolaOpsCreate"/> 
    zosConnectService 요소와 연관된 구성 가능한 속성 정의에 대한 자세한 정보는 z/OS Connect 기능에 대한 문서를 참조하십시오.
  2. (선택사항) zosConnectManager 구성 요소를 server.xml 파일에 추가하십시오.

    이 요소는 server.xml 구성에서 싱글톤이며 서버에 대해 정의된 모든 z/OS Connect 서비스에 적용되는 글로벌 값을 포함합니다. 이 요소에는 서버에 있는 모든 서비스에 적용되는 z/OS Connect 인터셉터 또는 데이터 변환 제공자 구성 요소의 이름이 포함될 수 있습니다.

    다음 예는 globalOperationsGroup 항목 아래에 조작 그룹 이름 Operator1을 정의하는 zosConnectManager 구성 요소를 설명합니다. 이는 action=start|stop|status와 같은 z/OS Connect 조작 요청이 허용되기 전에 요청하는 클라이언트 사용자 ID가 속해야 하는 보안(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. WOLA가 Liberty에서 구성된 경우, 요청에 대한 구성은 server.xml 파일의 localAdaptersConnectService 구성 요소를 요구합니다. 이 구성은 대상 WOLA 연결 팩토리 이름, 레지스터 이름 및 서비스 이름의 최소한으로 구성됩니다. z/OS Connect의 구성은 최소 매개변수의 지정만 요구함으로써 Liberty 규칙을 따릅니다. z/OS Connect 상호작용을 위해 WOLA 연결 팩토리를 구성하는 경우, 컨테이너를 인증 메커니즘으로서 사용해야 합니다. 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"
            dataXformRef="zconXform"/> 
    
    <!-- z/OS Connect data transformer --> 
    <zosConnectDataXform id="zconXform"          
    	bindFileLoc="/zosConnect/bind" 
            bindFileSuffix=".bnd"   
    	requestSchemaLoc="/zosConnect/schema"  
    	responseSchemaLoc="/zosConnect/schema"
    	requestSchemaSuffix=".json"
    	responseSchemaSuffix=".json">
    </zosConnectDataXform> 

    z/OS Connect가 WebSphere Optimized Local Adapters(WOLA)를 통해 z/OS 자산과의 상호작용을 요청하도록 허용하는 z/OS Connect 서비스 구현에는 데이터 변환기가 필요할 수 있습니다. 글로벌 또는 서비스 레벨에서 데이터 변환기가 구성된 경우, 입력 및 출력 페이로드는 구성된 데이터 변환기를 사용하여 변환됩니다. 데이터 변환기가 구성되지 않은 경우 요청에 JSON 페이로드가 포함되면 서비스는 백엔드 프로그램이 데이터 변환을 처리한다고 가정합니다. 서비스는 요청 헤더에 지정된 인코딩 또는 기본 JSON 인코딩인 UTF-8을 사용하여 JSON 페이로드를 바이트 배열로 변환합니다. 마찬가지로, 자산이 페이로드를 리턴하고 데이터 변환기가 구성되지 않은 경우, WOLA 서비스 구현은 바이트 배열 형식의 JSON 페이로드를 수신할 것으로 예상하며, 이는 JSON 요청 페이로드를 바이트 배열로 변환하는 데 사용된 것과 동일한 인코딩 규칙에 따라 JSON 응답 페이로드로 변환됩니다.

    linkTaskChanIDlocalAdaptersConnectService 요소 아래에서 useCICSContainer=true와 함께 구성된 경우, 페이로드 컨테이너 및 컨텍스트 컨테이너의 세트는 대상 프로그램으로 전송됩니다. 다음 목록에서는 컨텍스트 컨테이너의 이름과 설명을 제공합니다.
    ZCONReqURL
    ZCONRegURL 컨텍스트 컨테이너에는 HTTP 요청 URL이 포함되어 있습니다. 예를 들어, 조회 매개변수 country=USA/banking/depositinvokeURI 정의를 사용하는 경우에 URL은 https//localhost:port/banking/deposit?country=USA입니다.
    ZCONReqQParms
    ZCONReqQParms 컨텍스트 컨테이너에는 HTTP 요청 조회 매개변수가 포함되어 있습니다. 예를 들어, 요청 URL https//localhost:port//banking/deposit?country=USA에서 조회 매개변수는 country=USA입니다.
    ZCONReqMethod
    ZCONReqMethod 컨텍스트 컨테이너에는 HTTP 요청 메소드가 포함되어 있습니다. 예: GET.
    ZCONHTTPHeaders
    ZCONHTTPHeaders 컨텍스트 컨테이너에는 localAdaptersConnectService 요소 아래에서 linkTaskChanCtxContHttpHeaders 속성을 사용하여 구성된 HTTP 헤더 이름/값 쌍의 JSON 형식화된 세트가 포함되어 있습니다.
    linkTaskChanCtxContHttpHeaders 속성은 ZCONHTTPHeaders 컨테이너의 대상 프로그램에 전달되는 헤더 이름을 표시하는 쉼표로 구분된 대소문자 구분 문자열의 목록을 허용합니다. 이 컨텍스트 컨테이너에 포함된 정보는 JSON 형식입니다(예: {httpHeaders:{"header1":"header1Value", ...,"headerN":"headerNValue"}}). 요청에 동일 이름의 여러 헤더가 포함된 경우, 사용된 값은 요청의 첫 번째 헤더의 값입니다.

    사용자는 localAdaptersConnectService 아래의 linkTaskChanCtxContEncoding 구성 속성을 사용하여 모든 컨텍스트 컨테이너에 포함된 데이터의 기본 인코딩(cp819)을 수정할 수 있습니다.

    linkTaskChanIDlocalAdaptersConnectService 요소 아래에서 useCICSContainer=true와 함께 구성된 경우에는 linkTaskChanReqContIDlinkTaskChanRespContID 속성을 사용하여 입력 및 출력 컨테이너 페이로드 이름을 사용자 정의할 수 있습니다. 이러한 속성이 정의되지 않은 경우, 기본 이름은 ZCONReqDataZCONRespData입니다. 다음 예제는 적합한 구성을 보여줍니다.
    <localAdaptersConnectService id="wolaOpsCreate"             
            registerName="OLASERVER"
            serviceName="ZCONMC5"
            connectionFactoryRef="wolaCF"
            linkTaskChanID="ZCONCHANNEL"
            linkTaskChanType="1"
            useCICSContainer="true"
            linkTaskChanCtxContHttpHeaders="Connection, CustomHeader1, CustomHeader2, CustomHeader3"
            linkTaskChanReqContID="wolaOpsReqData"
            linkTaskChanRespContID="wolaOpsRespData"
            linkTaskChanCtxContEncoding="cp037"/>

    다음 표는 localAdaptersConnectService 속성 정의의 목록과 각각에 대한 설명입니다.

    속성 정의 설명

    serviceName

    required="true"

    type="String"

    WOLA 대상 서비스의 이름입니다. serviceName은 외부 주소 공간 애플리케이션이 WOLA Receive Request 또는 Host Service API 호출에서 서비스 이름에 사용 중인 이름이나 WOLA CICS 링크 서버에서 SVC에 사용되는 프로그램 이름과 일치해야 합니다.

    registerName

    required="true"

    type="String"

    WOLA 대상 등록의 이름입니다. 이 이름은 외부 주소 공간 애플리케이션이 WOLA 등록 API 호출에서 레지스터 이름에 사용 중인 이름이나 WOLA CICS 링크 서버 사용 시 RGN에 사용되는 이름과 일치해야 합니다. registerName은 1 - 12자까지의 영숫자 문자열일 수 있습니다.

    connectionFactoryRef

    required="true"

    type="String"

    구성된 WOLA 자원 어댑터 연결 팩토리에 대한 참조입니다.

    connectionWaitTimeout

    required="false"

    type="Integer"

    min="0"

    max="2147483647"

    등록 이름과 일치하는 외부 주소 공간 애플리케이션이 WOLA Receive Request 또는 Host Service API를 발행하고 활성화될 때까지 대기하는 시간(초)입니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 ConnectionWaitTimeout 특성을 정의합니다. 값이 지정되지 않은 경우에는 특성의 기본값이 사용됩니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskTranID

    required="false"

    type="String"

    WOLA CICS 링크 서버 링크 호출 태스크 트랜잭션 ID의 이름(4자 문자열)을 정의합니다. CICS 링크 서버를 사용하는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 LinkTaskTranID 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    useCICSContainer

    required="false"

    type="Boolean"

    default="false"

    데이터 전파에 사용할 메커니즘을 정의합니다. true로 설정하면 페이로드는 CICS 컨테이너를 사용하여 대상 CICS 애플리케이션 프로그램으로 전달됩니다. false(기본값)로 설정하면 페이로드는 COMMAREA를 사용하여 대상 CICS 애플리케이션 프로그램으로 전달됩니다. CICS 링크 서버를 사용하는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 useCICSContainer 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskReqContType

    type="Integer"

    min="0"

    default="0"

    요청 컨테이너의 유형(0=CHAR, 1=BIT)을 정의합니다. CICS 링크 서버를 사용하고 linkTaskReqContID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 linkTaskReqContType 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskRspContID

    required="false"

    type="String"

    응답 또는 출력 컨테이너의 이름(CICS에 대해 정의된 컨테이너 이름과 일치하는 1 - 16자의 문자열)을 정의합니다. CICS 링크 서버를 사용하고 linkTaskReqContID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 linkTaskRspContID 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskRspContType

    type="Integer"

    min="0"

    default="0"

    응답 컨테이너의 유형(0=CHAR, 1=BIT)을 정의합니다. CICS 링크 서버를 사용하고 linkTaskRspContID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 linkTaskRspContType 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskChanID

    required="false"

    type="String"

    CICS에 대해 정의된 채널 이름과 일치하는 1 - 16자의 문자열을 사용하여 CICS 컨테이너를 사용한 페이로드의 전달과 수신에 사용되는 CICS 채널 이름을 정의합니다. CICS 링크 서버를 사용하고 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 linkTaskChanID 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskChanType

    required="false"

    type="Integer"

    min="0"

    default="0"

    구성된 채널 ID와 연관될 CICS 컨테이너의 유형(0=CHAR, 1=BIT)을 정의합니다. 0=CHAR(기본값)로 설정하면 입출력(I/O) 컨테이너에 있는 문자 데이터의 인코딩은 ASCII(CCSID 819)로 예상되거나 리턴되고 데이터는 대상 프로그램으로 전송되거나 대상 프로그램에서 전송되기 전 또는 후에 EBCDIC(cp037)으로 변환되거나 EBCDIC(cp037)에서 변환됩니다. 데이터 유형 및 인코딩 예상을 피하려면 BIT 유형을 사용하십시오. CICS 링크 서버를 사용하고 linkTaskChanID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다. 이 속성은 최적화 로컬 어댑터 연결 팩토리의 linkTaskChanType 특성을 정의합니다. 자세한 정보는 Liberty 문서에서 최적화 로컬 어댑터에 대한 연결 팩토리 특성을 참조하십시오.

    linkTaskChanReqContID

    required="false"

    default="ZCONReqData"

    type="String"

    CICS에 대해 정의된 컨테이너 이름과 일치하는 1 - 16자의 문자열을 사용하여 요청 컨테이너의 이름을 정의합니다. CICS 링크 서버를 사용하고 linkTaskChanID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다.

    linkTaskChanRespContID

    required="false"

    default="ZCONRespData"

    type="String"

    CICS에 대해 정의된 컨테이너 이름과 일치하는 1 - 16자의 문자열을 사용하여 응답 컨테이너의 이름을 정의합니다. CICS 링크 서버를 사용하고 linkTaskChanID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다.

    linkTaskChanCtxContEncoding

    required="false"

    type="String"

    default="cp819"

    대상 프로그램으로 전송되는 모든 컨텍스트 컨테이너에 있는 데이터의 인코딩을 정의합니다. CICS 링크 서버를 사용하고 linkTaskChanID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다.

    linkTaskChanCtxContHttpHeaders

    required="false"

    type="String"

    ZCONHTTPHeaders의 이름으로 컨텍스트 컨테이너를 사용하여 대상 프로그램에 전달되는 쉼표로 구분된 HTTP 헤더 이름의 목록 또는 HTTP 헤더 이름을 정의합니다. 이 컨텍스트 컨테이너에 포함된 정보는 다음과 같은 JSON 형식입니다. {httpHeaders:{"header1":"header1Value", ...,"headerN":"headerNValue"}}). CICS 링크 서버를 사용하고 linkTaskChanID 및 useCICSContainer(true) 속성도 구성되어 있는 경우 이 속성을 사용합니다.


주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_zconnect_srvcdef.html