z/OS Connect 서비스 정의
z/OS® Connect 서비스 정의는 REST 호출을 사용하여 z/OS 애플리케이션 자산에 도달하기 위한 메커니즘을 제공합니다. z/OS Connect 서비스를 사용하려면 Liberty server.xml 파일에 z/OS Connect 서비스 정의를 요소 이름 zosConnectService, 이름 및 서비스 제공자 참조 요소 이름과 함께 추가해야 합니다.
이 태스크 정보
z/OS Connect 서비스는 zosConnectService 구성 요소로 정의됩니다. 이 요소는 글로벌로 정의된 대응 파트가 있을 수 있는 속성 정의를 포함합니다. 속성은 zosConnectManager 요소를 통해 글로벌로 정의될 수 있습니다. 이러한 속성이 정의되면 모든 서비스에 적용됩니다. 글로벌 및 서비스 레벨 속성이 둘 다 구성된 경우, zosConnectService 레벨에 정의된 값이 사용됩니다.
z/OS Connect는 z/OS Connect가 WOLA(WebSphere Optimized Local Adapters)를 통해 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의 파트로
사용되는 이름이기도 합니다. 서비스 이름은 고유해야 합니다. 다음은 recordOpsCreate라는
z/OS Connect 서비스를 추가하는 데 필요한 내용을 보여주는 샘플 server.xml 파일입니다.
zosConnectService 요소와 연관된 구성 가능한 속성 정의에 대한 자세한 정보는 z/OS Connect 기능에 대한 문서를 참조하십시오.<!-- z/OS Connect service definitions --> <zosConnectService id="zcs1" serviceName="recordOpsCreate" serviceRef="wolaCreateService"/> - (선택사항) 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 기능 문서를 참조하십시오. - Liberty에서 WOLA가 구성된 경우, 요청에 대한 구성에서는
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"/>z/OS Connect가 WOLA(WebSphere Optimized Local Adapters)를 통해 z/OS 자산과의 상호작용을 요청하도록 허용하는 z/OS Connect 서비스 구현에는 데이터 변환기가 필요할 수 있습니다. 글로벌 또는 서비스 레벨에서 데이터 변환기가 구성된 경우, 입력 및 출력 페이로드는 구성된 데이터 변환기를 사용하여 변환됩니다. 데이터 변환기가 구성되지 않은 경우 요청에 JSON 페이로드가 포함되면 서비스는 백엔드 프로그램이 데이터 변환을 처리한다고 가정합니다. 서비스는 요청 헤더에 지정된 인코딩 또는 기본 JSON 인코딩인 UTF-8을 사용하여 JSON 페이로드를 바이트 배열로 변환합니다. 마찬가지로, 자산이 페이로드를 리턴하고 데이터 변환기가 구성되지 않은 경우, WOLA 서비스 구현은 바이트 배열 형식의 JSON 페이로드를 수신할 것으로 예상하며, 이는 JSON 요청 페이로드를 바이트 배열로 변환하는 데 사용된 것과 동일한 인코딩 규칙에 따라 JSON 응답 페이로드로 변환됩니다.
WOLA 서비스 제공자 구현을 사용하면 많은 다른 WOLA 연결 팩토리 정의를 localAdaptersConnectService 구성 요소에 지정할 수 있습니다. 다음 표는 localAdaptersConnectService 속성 정의의 목록과 각각에 대한 설명입니다.
속성 정의 설명 serviceName
required="true"
type="String"
WOLA 대상 서비스의 이름입니다. 이 서비스 이름은 외부 주소 공간 애플리케이션이 WOLA 요청 수신 또는 호스트 서비스 API 호출에서 서비스 이름에 사용하는 이름 또는 WOLA CICS Link Server에 대한 SVC에 사용되는 프로그램 이름과 일치해야 합니다. registerName
required="true"
type="String"
WOLA 대상 등록의 이름입니다. 이 대상 등록은 외부 주소 공간 애플리케이션이 WOLA 등록 API 호출에서 등록 이름에 사용하는 이름 또는 WOLA CICS Link Server에 대한 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 Link Server 링크 호출 태스크 트랜잭션 ID의 이름을 지정합니다. 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. useCICSContainer
required="false"
type="Boolean"
default="false"
WOLA CICS Link Server를 사용하는 경우, 페이로드가 단일 CICS 컨테이너 또는 COMMAREA 중 어느 방법으로 대상 CICS 애플리케이션 프로그램에 전달되었는지를 표시합니다. 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskTranID
required="false"
type="String"
WOLA CICS Link Server를 사용하고 useCICSContainer 플래그가 true로 설정된 경우, 대상 CICS 요청 컨테이너의 이름을 지정합니다. 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskReqContType
type="Integer"
min="0"
default="0"
WOLA CICS Link Server를 사용하고 useCICSContainer 플래그가 true로 설정된 경우, 대상 CICS 요청 컨테이너의 유형을 지정합니다(0=CHAR, 1=BIT). 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskRspContID
required="false"
type="String"
WOLA CICS Link Server를 사용하고 useCICSContainer 플래그가 true로 설정된 경우, 대상 CICS 응답 컨테이너의 이름을 지정합니다. 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskRspContType
type="Integer"
min="0"
default="0"
WOLA CICS Link Server를 사용하고 useCICSContainer 플래그가 true로 설정된 경우, 대상 CICS 응답 컨테이너의 유형을 지정합니다(0=CHAR, 1=BIT). 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskChanID
required="false"
type="String"
WOLA CICS Link Server를 사용하는 경우, CICS 컨테이너를 사용하여 전달 메시지 및 수신된 응답 메시지에 사용할 CICS 채널 이름을 지정합니다. 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오. linkTaskChanType
required="false"
type="Integer"
min="0"
default="0"
WOLA CICS Link Server를 사용하고 linkTaskChanID 채널 이름을 지정하는 경우, 해당 채널과 연관된 대상 CICS 컨테이너의 유형을 지정합니다(0=CHAR, 1=BIT). 자세한 정보는 Liberty WOLA 자원 어댑터 문서를 참조하십시오.
태스크 주제
마지막 업데이트 날짜: Friday, 16 September 2016http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=twlp_zconnect_srvcdef
파일 이름: twlp_zconnect_srvcdef.html
