CICS에서 웹 서비스 생성 및 배치
이 주제에서는 z/OS® CICS®에서 웹 서비스를 생성하고 배치하는 방법에 대해 설명합니다. 관련 EGL 빌드 파트를 설정하는 것 외에도 CICS 정의 TRANSACTION, TCPIPSERVICE 및 PIPELINE을 설정해야 합니다.
z/OS CICS에서 EGL 또는 웹 서비스의 요구사항에 대한 세부사항은 "z/OS CICS 환경에서 EGL 또는 웹 서비스 생성을 위한 특수 고려사항"을 참조하십시오.
다음의 단계를 수행하여 웹 서비스를 생성하여 z/OS CICS에 배치하십시오.
- EGL 서비스 파트를 작성하십시오.
- EGL 배치 디스크립터에서 CICSWS 유형의 공유 가능한 프로토콜을 추가하십시오. 키 입력 세부사항은 "공유 가능한 프로토콜 작성 및 사용"을 참조하십시오.
- 공유 가능한 프로토콜에서 다음과 같은 속성을 설정하십시오.
- transaction
- 웹 서비스를 실행할 트랜잭션의 이름입니다(최소 TWA(Transaction Work Area)는 1024바이트임). 나중에 CPIH 트랜잭션을 복사하고 TWA를 1024바이트로 설정하여 이 트랜잭션을 작성합니다.
- userID
- 웹 서비스를 실행할 사용자 ID입니다(선택사항).
- EGL 배치 디스크립터 편집기의 웹 서비스 배치 페이지에서 서비스 파트를 추가하여 웹 서비스로 생성하십시오. 키 입력 세부사항은 "배치 디스크립터에 웹 서비스 배치 정보 추가"를 참조하십시오.
- 배치 디스크립터의 프로토콜 필드를 CICSWS 공유 가능한 프로토콜로 설정하십시오.
- 배치 디스크립터의 URI 필드를 서비스를 배치할 상대 경로로 설정하십시오. 기본값은 /services/ServicePartName입니다. 여기서 ServicePartName은 서비스 파트의 이름입니다.
- 프로젝트의 빌드 디스크립터에서 다음과 같은 빌드 디스크립터 옵션을
설정하십시오.
- deploymentDescriptor
- 공유 가능한 프로토콜 및 서비스 파트를 추가한 EGL 배치 디스크립터의 이름입니다.
- destDirectory
- 생성된 웹 서비스 바인딩 파일 및 WSDL 파일을 수신할 폴더가 포함된
루트 HFS 디렉토리입니다. 예제 destDirectory 값은
/u/username/clients입니다. CICS는
이 디렉토리에 대해 읽고 쓸 수 있는 권한을 가지고 있어야 합니다.
런타임 시 SOAP 메시지를 COBOL로 변환하려면 웹 서비스 바인딩 파일이 필요합니다.
- destHost
- 빌드 서버가 상주하는 대상 시스템의 이름 또는 숫자 TCP/IP 주소를 지정하십시오.
- destPassword
- EGL이 배치를 위해 출력을 준비할 원격 빌드 서버에 로그온하기 위해 사용하는 비밀번호를 지정합니다.
- destPort
- 원격 빌드 서버가 빌드 요청을 청취 중인 포트를 지정하십시오.
- destUserID
- EGL이 준비가 발생하는 원격 빌드 서버에 로그온하는 데 사용하는 사용자 ID를 지정합니다.
- genDirectory
- EGL이 생성된 출력, 제어 파일 및 결과 파일을 배치하는 디렉토리의 완전한 경로를 지정합니다.
- prep
- prep를 YES로 설정하십시오.
- serverType
- serverType을 CICS3.1로 설정하십시오.
- system
- system을 ZOSCICS로 설정하십시오.
- 두 서비스 파트를 모두 생성하십시오. "EGL 생성 및 배치 소개"에 설명된 대로 배치 디스크립터를 생성하거나 배치할 수 있습니다.
- CICS 시스템에서 CICSWS
공유 가능한 프로토콜에서 지정된 이름을 사용하여 웹 서비스 TRANSACTION을
정의하십시오.
- 다음과 같은 명령을 사용하여 CPIH 트랜잭션의 사본을 작성하십시오.
newName에 대해 트랜잭션의 이름을 사용하고 group에 대해 그룹의 이름을 사용하십시오.CEDA COPY TRANSACTION(CPIH) GROUP(DFHPIPE) AS(newName) TO(group) - 트랜잭션의 사본을 편집하고 TWA 크기를 1024바이트로 설정하십시오.
- 다음과 같은 명령을 사용하여 CPIH 트랜잭션의 사본을 작성하십시오.
- TCPIPSERVICE를 정의하십시오.
- 다음과 같은 명령을 사용하여 새 TCPIPSERVICE를 작성하십시오.
name에 대해 새 TCPIPSERVICE의 이름을 사용하고 group에 대해 그룹의 이름을 사용하십시오.CEDA DEF TCPIPSERVICE(name) GROUP(group) - Portnumber 필드를 2001과 65535 사이의 숫자로 설정하십시오.
- 다음과 같은 명령을 사용하여 새 TCPIPSERVICE를 작성하십시오.
- 웹 서비스 PIPELINE을 정의하십시오.
- 서비스에 대해 새 PIPELINE을 작성해야 하는 경우 다음 명령을 사용하십시오.
name에 대해 새 PIPELINE의 이름을 사용하고 group에 대해 그룹의 이름을 사용하십시오.CEDA DEF PIPELINE(name) GROUP(group) - Configfile 필드를 /u/cicsts31/pipelines/basicsoap11provider.xml로 설정하십시오.
- Shelf 필드를 destDirectory/provider/shelf로 설정하십시오. 여기서 destDirectory는 destDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
- Wsdir 필드를 destDirectory/provider로 설정하십시오. 여기서 destDirectory는 destDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
- 서비스에 대해 새 PIPELINE을 작성해야 하는 경우 다음 명령을 사용하십시오.
- 다음 명령을 사용하여 그룹을 설치하십시오.
group에 대해 그룹의 이름을 사용하십시오.CEDA INSTALL GROUP(group)