z/OS에서 빌드 서버 시작

z/OS®에서는 z/OS 또는 USS 빌드를 수행하도록 빌드 서버를 구성할 수 있습니다. 두 빌드가 모두 필요한 경우에는 고유 TCP/IP 포트에서 각 유형에 대해 각각 청취하는 두 개의 서버를 시작해야 합니다.

구문

z/OS JCL 명령을 사용하여 빌드 서버를 시작합니다. 매개변수 행에 대한 구문은 다음과 같습니다.

Syntax: // PARM= '-p <portno> [-V ...] [-a {2|1|0} [-n <n>] [-q <q>] [-t]'
여기서
-p
클라이언트와 통신하기 위해 서버가 청취하는 포트 번호(portno)를 지정합니다.
-V
서버의 상세 레벨을 지정합니다. 3회(최대 상세)까지 이 매개변수를 지정할 수 있습니다.
-a
인증 모드를 지정합니다.
2
서버 상태: A(권한 부여됨). 서버 코드가 APF 권한 부여된 라이브러리에 설치되었습니다. 원격 빌드 클라이언트를 사용하여 빌드를 시작하는 경우에는 올바른 TSO 사용자 ID를 가진 destUserID 및 올바른 TSO 비밀번호를 가진 destPassword 빌드 디스크립터 옵션을 지정해야 합니다. 서버는 이 사용자 ID의 액세스 및 권한 하에서 빌드 트랜잭션을 수행합니다. 모드 2가 기본값입니다.
1
서버 상태: A. 올바른 TSO 사용자 ID 및 비밀번호를 제공할 수 있습니다. 서버는 이 사용자의 액세스 및 권한 하에서 빌드 트랜잭션을 수행합니다. 사용자 ID 및 비밀번호를 제공하지 않는 경우 빌드 트랜잭션은 빌드 서버 작업에 지정된 사용자 ID의 액세스 및 권한 하에서 수행됩니다.
0
서버 상태: A 또는 U(권한 없음). U인 경우 APF 권한 부여된 빌드 프로그램이 실패합니다. TSO 사용자 ID 및 비밀번호를 지정하는 경우 서버는 해당 사용자 ID 및 비밀번호를 무시하며 빌드 트랜잭션은 빌드 서버 작업에 지정된 사용자 ID의 액세스 및 권한 하에서 수행됩니다.
서버 로드 모듈이 APF 권한 부여된 라이브러리에서 실행되는 경우에만 모드 1 및 2를 사용할 수 있습니다.
-n
동시 빌드의 수를 지정합니다. 기본값은 1입니다. 허용할 동시 빌드 수와 동일한 값으로 n을 설정하십시오. n개의 동시 빌드가 실행 중이면 빌드 서버는 추가적인 요청을 큐에 대기시킨 후 빌드가 완료될 때 선착순으로 제출합니다.
-q
클라이언트에 대한 큐의 크기(q)를 지정합니다. 기본값은 10입니다. 각각의 큐에 대기된 클라이언트는 TCP/IP 소켓을 사용합니다. 따라서 이 값을 너무 높게 설정하면 사용 가능한 것보다 많은 소켓이 필요하게 되어 예측할 수 없는 결과가 발생할 수 있습니다. 큐가 가득 차면 후속 클라이언트는 서버에 의해 거부됩니다. 하지만 해당 경우에 빌드 클라이언트는 빌드를 재시도합니다.
-t
이 서버 작업의 추적을 시작하고 출력을 STDOUT에 기록합니다. 이 매개변수는 일반적으로 디버깅용으로만 사용됩니다.

프로시저

z/OS 빌드 서버를 시작하려면 CCURUN.JCL(z/OS의 경우) 또는 CCURUNU.JCL(USS의 경우)을 사용하여 다음의 단계를 완료하십시오.
  1. 작업 카드를 추가하십시오.
  2. 필요에 따라 EXEC 카드의 PARM문에서 매개변수를 수정하십시오. (위의 매개변수 목록을 참조하십시오.)
  3. 빌드 서버 로드 모듈이 포함된 데이터 세트를 가리키도록 STEPLIB DD문을 수정하십시오. 이 라이브러리에는 원격 빌드 서버를 구성하는 모든 로드 모듈이 포함되어 있습니다.
  4. 개별 빌드 작업을 실행하는 데 필요한 JCL이 포함된 데이터 세트를 가리키도록 CCUWJCL DD문을 수정하십시오. 이는 CCUMVS.JCL(z/OS 빌드의 경우) 또는 CCUUSS.JCL(USS 빌드의 경우)의 수정된 버전이어야 합니다.
  5. CCUBLOG를 순차 데이터 세트로 지정하십시오. 여기서 빌드 서버의 로그가 기록됩니다.
  6. 작업에 적합하게 매개변수(PARM=) 명령문을 수정하십시오(아래 예제 참조).
  7. 작업을 제출하십시오.

예제

z/OS 빌드에 대한 일괄처리 프로그램으로 빌드 서버를 시작하는 JCL의 예제는 다음과 같습니다.
//jobcard
//*------------------------------------------------------
//RUNPGM  EXEC PGM=CCUMAIN,DYNAMNBR=30,REGION=7400K,TIME=NOLIMIT,
// PARM='-p 2604 -a 2 -n 3 -q 20'
//STEPLIB  DD DSN=CCUBLD.LOADLIB,DISP=SHR
//CCUWJCL  DD DISP=SHR,DSN=CCUBLD.JCL(CCUMVS)  for z/OS builds
//*CCUWJCL DD DISP=SHR,DSN=CCUBLD.JCL(CCUUSS)  for USS builds
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//CCUBLOG  DD SYSOUT=*
USS 빌드용 JCL을 수정하려면 주석 표시기(//*CCUWJCL*)를 이전 행의 // 뒤로 이동하십시오.

z/OS 빌드에 대한 특수 고려사항

z/OS에서 APF 권한 부여된 라이브러리로부터 서버를 시작하는 경우(모드 1 및 2에서는 필수이지만 모드 0에서는 선택사항임) 빌드 스크립트는 APF 권한 부여된 프로그램을 실행 파일로 지정할 수 있습니다.

참고: 이 경우 빌드 스크립트는 비APF 권한 부여된 프로그램도 지정할 수 있습니다. 하지만 다단계 JCL 스크립트에서는 권한 부여된 프로그램을 권한이 없는 프로그램 뒤에 실행할 수 없습니다.

서버가 APF 권한 부여된 라이브러리에서 시작되지 않는 경우 빌드 스크립트는 비APF 권한 부여된 프로그램만 실행 파일로 지정할 수 있습니다.

빌드 서버에서 리턴된 메시지의 언어 설정

z/OS의 빌드 서버는 다음 표에 나열된 언어로 된 메시지를 리턴합니다. 영어가 기본값입니다.

언어 코드
포르투갈어(브라질) ptb
중국어 chs
대만어 cht
영어(미국) enu
프랑스어 fra
독일어 deu
이탈리아어 ita
일본어 jpn
한국어 kor
스페인어 esp

빌드 서버 메시지를 영어 이외의 언어로 리턴하려면 클라이언트 시스템에서 환경 변수 CCU_LANG의 설정을 변경하십시오. 이 변수에는 이전 표에 나열된 언어 코드 중 하나가 포함되어 있습니다. 예를 들어, 프랑스어로 메시지를 리턴하려면 CCU_LANG를 fra로 설정하십시오.

또한 빌드 서버와의 통신에 실패하는 경우에는 빌드 서버를 호출하는 컴포넌트가 메시지를 발행해야 할 수 있습니다. 해당 메시지를 영어 이외의 언어로 리턴하려면 클라이언트 시스템에서 환경 변수 CCU_CATALOG의 설정을 변경하십시오. CCU_CATALOG의 값은 다음과 같은 문자열입니다(한 행에 있음).
  shared_resources\eclipse\plugins
  \com.ibm.etools.egl.distributedbuild_version\executables\ccu.cat.xxx
shared_resources
제품의 공유 자원 디렉토리(예: Windows 시스템의 C:\Program Files\IBM\SDP70Shared 또는 Linux 시스템의 /opt/IBM/SDP70Shared)입니다. 현재 제품을 설치하기 전에 EGL이 포함된 이전 버전의 IBM® 제품을 설치하고 유지한 경우 이전 설치에서 설정된 공유 자원 디렉토리를 지정해야 할 수도 있습니다.
version
설치된 플러그인 버전입니다. 두 개 이상이 있는 경우 이전 버전을 사용해야 하는 이유가 없으면 최신 버전 번호의 플러그인을 사용하십시오.
xxx
관심 있는 언어에 대한 코드입니다(이전의 표에 나열된 코드 중 하나).

마지막으로 빌드 서버가 USS에서 실행될 때 사용자가 영어 이외의 언어로 메시지를 리턴하려는 경우 사용자는 쉘 스크립트 ccubldw.sh의 컨텐츠도 변경해야 합니다. 해당 스크립트는 USS 빌드 서버 컴포넌트가 설치될 때 사용자 정의됩니다.

USS에서 둘 이상의 언어를 지원하려면 각 언어에 대해 다른 USS 빌드 서버 컴포넌트를 시작하십시오(각 컴포넌트는 다른 포트에서 청취하며 다른 버전의 스크립트를 사용함).

USS 쉘 스크립트 ccubldw.sh를 특정 언어로 설정하려면 다음과 비슷한 명령문을 추가하십시오(한 행에 있음).
  export CCU_CATALOG=
    /installationDir/usr/lpp/EnterpriseDeveloper
    /BuildServer/ccu.cat.xxx
installationDir
USS 빌드 서버 컴포넌트가 설치되는 디렉토리
xxx
스크립트에서 지원하는 언어에 대한 코드(이전의 표에 나열된 소문자 코드 중 하나)

빌드 서버 구성에 대한 추가 세부사항

빌드 서버를 구성하는 방법에 대한 추가 세부사항은 IBM Rational® COBOL Runtime for z/Series 프로그램 디렉토리(GI10-3242)를 참조하십시오.