CICS에 웹 서비스 요청자 배치
z/OS® CICS®에서 실행되고 웹 서비스에 액세스하는 논리 파트를 생성하고 배치할 수 있습니다.
전제조건
- 액세스할 서비스에 대한 인터페이스 세부사항을 제공하는 WSDL(Web Services Description Language) 파일, EGL 배치 디스크립터 및 EGL 프로젝트를 가지고 있어야 합니다.
- EGL 생성 COBOL 코드가 웹 서비스를 요청하고 HTTP 기본 인증을 사용하는
경우(즉, serviceLib.setHTTPBasicAuthentication() 시스템
함수를 사용하는 경우) CICS 시스템 관리자는
다음과 같은 명령문을 요청자 파이프라인 CONFIGFILE에 추가하여 CICS에 대해
전송 핸들러 ELAWSHBA를 정의해야 합니다.
<transport> <default_http_transport_handler_list> <handler> <program> ELAWSHBA </program> </handler> </default_http_transport_handler_list> </transport>전송 핸들러 ELAWSHBA는 EGL COBOL 런타임 제품과 함께 제공됩니다.
CICS에 웹 서비스 요청자를 배치하려면 다음을 수행하십시오.
- 웹 서비스 바인딩 정보를 추가하십시오. 자세한 정보는 "배치 디스크립터에 SOAP 서비스 바인딩 추가"를 참조하십시오.
- 웹 서비스를 사용하는 프로그램 파트를 작성하십시오.
- 프로젝트의 빌드 디스크립터에서 다음과 같은 빌드 디스크립터 옵션을
설정하십시오.
- deploymentDescriptor
- 바인딩 정보를 추가한 EGL 배치 디스크립터의 이름입니다.
- destDirectory
- 생성된 웹 서비스 바인딩 파일 및 WSDL 파일을 수신하는 폴더가 포함된
루트 HFS 디렉토리입니다. 예제 destDirectory 값은
/u/myname/requesters입니다. CICS는
이 디렉토리에 대해 읽고 쓸 수 있는 권한을 가지고 있어야 합니다.
런타임 시 SOAP 메시지를 COBOL로 변환하려면 웹 서비스 바인딩 파일이 필요합니다.
- destHost
- 빌드 서버가 상주하는 대상 시스템의 이름 또는 숫자 TCP/IP 주소를 지정하십시오.
- destPassword
- EGL이 배치를 위해 출력을 준비할 원격 빌드 서버에 로그온하기 위해 사용하는 비밀번호를 지정합니다.
- destPort
- 원격 빌드 서버가 빌드 요청을 청취 중인 포트를 지정하십시오.
- destUserID
- EGL이 준비가 발생하는 원격 빌드 서버에 로그온하는 데 사용하는 사용자 ID를 지정합니다.
- genDirectory
- EGL이 생성된 출력, 제어 파일 및 결과 파일을 배치하는 디렉토리의 완전한 경로를 지정합니다.
- prep
- prep를 YES로 설정하십시오.
- serverType
- serverType을 CICS3.1로 설정하십시오.
- system
- system을 ZOSCICS로 설정하십시오.
- 프로그램 및 배치 디스크립터를 생성하십시오.
- 웹 서비스 PIPELINE을 정의하십시오.
- 요청자를 위해 PIPELINE을 작성해야 하는 경우에는 다음 명령을 입력하십시오.
name에 대해 새 PIPELINE의 이름을 사용하고 group에 대해 그룹의 이름을 사용하십시오.CEDA DEF PIPELINE(name) GROUP(group) - CONFIGFILE에 대해 /u/cicsts31/pipelines/basicsoap11requester.xml을 지정하십시오. 코드에서 HTTP 기본 인증을 사용하는 경우 CONFIGFILE이 이 주제에서 이전에 언급한 다시 링크된 전송 핸들러 ELAWSHBA를 참조하는지 확인하십시오.
- SHELF에 대해 destDirectory/requester/shelf를 지정하십시오. 여기서 destDirectory는 destDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
- WSDIR에 대해 destDirectory/requester를 지정하십시오. 여기서 destDirectory는 destDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
- 요청자를 위해 PIPELINE을 작성해야 하는 경우에는 다음 명령을 입력하십시오.
- 다음 명령을 입력하여 요청자를 위해 PROGRAM를 작성하십시오.
name에 대해 프로그램 이름을 사용하고 group에 대해 그룹 이름을 사용하십시오.CEDA DEFINE PROGRAM(name) GROUP(group) LANGUAGE(COBOL) - 다음 명령을 입력하여 요청자를 위해 TRANSACTION을 작성하십시오.
name에 대해 트랜잭션 이름을 사용하고 group에 대해 그룹 이름을 사용하고 programName에 대해 프로그램 이름을 사용하십시오.CEDA DEFINE TRANSACTION(name) GROUP(group) PROGRAM(programName) TWASIZE(1024) - 다음 명령을 입력하여 그룹을 설치하십시오.
group에 대해 그룹의 이름을 사용하십시오.CEDA INSTALL GROUP(group) - 트랜잭션을 실행하십시오.