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에 웹 서비스 요청자를 배치하려면 다음을 수행하십시오.

  1. 웹 서비스 바인딩 정보를 추가하십시오. 자세한 정보는 "배치 디스크립터에 SOAP 서비스 바인딩 추가"를 참조하십시오.
  2. 웹 서비스를 사용하는 프로그램 파트를 작성하십시오.
  3. 프로젝트의 빌드 디스크립터에서 다음과 같은 빌드 디스크립터 옵션을 설정하십시오.
    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로 설정하십시오.
  4. 프로그램 및 배치 디스크립터를 생성하십시오.
  5. 웹 서비스 PIPELINE을 정의하십시오.
    1. 요청자를 위해 PIPELINE을 작성해야 하는 경우에는 다음 명령을 입력하십시오.
      CEDA DEF PIPELINE(name) GROUP(group)
      name에 대해 새 PIPELINE의 이름을 사용하고 group에 대해 그룹의 이름을 사용하십시오.
    2. CONFIGFILE에 대해 /u/cicsts31/pipelines/basicsoap11requester.xml을 지정하십시오. 코드에서 HTTP 기본 인증을 사용하는 경우 CONFIGFILE이 이 주제에서 이전에 언급한 다시 링크된 전송 핸들러 ELAWSHBA를 참조하는지 확인하십시오.
    3. SHELF에 대해 destDirectory/requester/shelf를 지정하십시오. 여기서 destDirectorydestDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
    4. WSDIR에 대해 destDirectory/requester를 지정하십시오. 여기서 destDirectorydestDirectory 빌드 디스크립터 옵션에 사용한 값입니다.
  6. 다음 명령을 입력하여 요청자를 위해 PROGRAM를 작성하십시오.
    CEDA DEFINE PROGRAM(name) GROUP(group) LANGUAGE(COBOL)
    name에 대해 프로그램 이름을 사용하고 group에 대해 그룹 이름을 사용하십시오.
  7. 다음 명령을 입력하여 요청자를 위해 TRANSACTION을 작성하십시오.
    CEDA DEFINE TRANSACTION(name) GROUP(group) PROGRAM(programName) TWASIZE(1024)
    name에 대해 트랜잭션 이름을 사용하고 group에 대해 그룹 이름을 사용하고 programName에 대해 프로그램 이름을 사용하십시오.
  8. 다음 명령을 입력하여 그룹을 설치하십시오.
    CEDA INSTALL GROUP(group)
    group에 대해 그룹의 이름을 사용하십시오.
  9. 트랜잭션을 실행하십시오.