z/OS 호스트에서 DL/I 디버그 서버 시작
z/OS®에서 디버그 서버가 IMS™ DLI를 디버그하도록 구성할 수 있습니다.
구문
z/OS JCL 명령을 사용하여 디버그 서버를 시작합니다. 매개변수 행의 구문은 다음과 같습니다.
![Syntax: // PARM= '-p <portno> [-V ...] [-a {2|1|0} [-n <n>] [-q <q>] [-t]'](../images/pegl_core_debug_server_imsdli.gif)
- 클라이언트와 통신하는 데 서버가 청취하는 포트 번호(portno)를 지정합니다. 값은 1024와 65535 사이여야 합니다.
- 서버의 상세 레벨을 지정합니다. 이 매개변수를 최대 3회(최대 상세)까지 지정할 수 있습니다.
- 인증 모드를 지정합니다.
- 0
- 서버 상태: A 또는 U(권한 없음). U인 경우 APF 권한 부여된 빌드 프로그램이 실패합니다. TSO 사용자 ID 및 비밀번호를 지정하는 경우 서버는 이를 무시하고 빌드 트랜잭션이 빌드 서버 작업에 지정된 사용자 ID의 권한 및 액세스에서 수행됩니다.
- 동시 디버그 세션의 이름을 지정합니다. 기본값은 1입니다. 허용하려는 동시 디버그 세션의 수와 같은 n을 설정하십시오. n 수의 동시 디버그 세션이 실행 중이면, 디버그 서버가 임의의 추가 요청을 큐에 입력하고 기타 디버그 세션이 완료되면 선도착 선처리(first come first served) 방식으로 이를 제출합니다. 최적의 성능을 위해 n을 q와 동일한 값으로 설정하십시오.
- 클라이언트에 대해 큐(q)의 크기를 지정합니다. 기본값은 10입니다. 큐에 입력된 각 클라이언트는 TCP/IP 소켓을 사용합니다. 따라서 이를 너무 높게 설정하면 사용 가능한 수보다 더 많은 소켓이 필요하여 예상치 못한 결과를 초래할 수 있습니다. 큐가 가득 찬 경우 후속 클라이언트가 서버에서 거부됩니다. 그러나 그러한 경우 빌드 클라이언트는 빌드를 재시도합니다. 최적의 성능을 위해 n을 q와 동일한 값으로 설정하십시오.
- 이 서버 작업의 추적을 시작하고 STDOUT에 출력을 씁니다. 이 매개변수는 일반적으로 디버깅에서만 사용됩니다.
프로시저
시스템 구성에 맞게 프록시 작업 JCL을 수정하십시오.
호스트에서 프록시를 시작하기 위한 JCL이
EZEDBGPX.JCL이라는 파일에 포함됩니다. 시스템 구성에 맞게 JCL의 STEPLIB 부분을
수정해야 합니다. 사용자가 생성한 DRA 시작 테이블이 포함된
PDS가(DRA 시작 테이블 작성 참조)
STEPLIB에 포함되는지 확인하십시오.
//jobcard
//RUNPGM EXEC PGM=EZEDBPXY,DYNAMNBR=30,TIME=NOLIMIT,
// PARM='&PARM ,7,0000,,0,,N,0,T,IVP7,,N,,,N'
//* Avoid changing the PARM statement. The &PARM keyword will
//* be replaced by parameters.
//STEPLIB DD DISP=SHR,DSN=ELA.V6R0M1.SELALMD
// DD DISP=SHR,DSN=ELA.V6R0M1.SELADBGL
// DD DISP=SHR,DSN=IMS.SDFSRESL
// DD DISP=SHR,DSN=IMS.PGMLIB
// DD DISP=SHR,DSN=CEE.SCEERUN
//DFSRESLB DD DISP=SHR,DSN=IMS.SDFSRESL
//IMS DD DISP=SHR,DSN=IMS.PSBLIB
// DD DISP=SHR,DSN=IMS.DBDLIB
//IEFRDER DD DUMMY
//DFSVSAMP DD DISP=SHR,DSN=ELA.V6R0M1.ELASAMP(ELAVSAMP)
//*
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//CCUBLOG DD SYSOUT=*
z/OS 디버그 서버를 시작하려면
ELADBGRN.JCL로 다음 단계를 완료하십시오.
- 작업 카드를 추가하십시오.
- STEPLIB, DFSRESLB 및 IMS DD 명령문을 수정하여 IMS 환경 및 빌드 서버 로드 모듈이 포함된 데이터 세트를 가리키십시오. 이 라이브러리에는 원격 빌드 서버를 구성하는 모든 로드 모듈이 포함됩니다.
- ELADBGP DD 명령문을 수정하여 개별 디버그 프록시 작업을 실행하기 위한 JCL이 포함된 데이터 세트를 가리키십시오.
- 작업에 적합하도록 매개변수(PARM=) 명령문을 수정하십시오(아래 예제 참조).
- 작업을 제출하십시오.
예제
다음 샘플 JCL이
IMS 디버깅에 대해 일괄처리 프로그램으로 디버그 서버를 시작합니다.
//jobcard
//*------------------------------------------------------
//RUNPGM EXEC PGM=ELAMAIN,REGION=7400K,
// PARM='-p 5527 -a 0 -n 10 '
//STEPLIB DD DSN=ELA.V6R0M1.SELALMD,DISP=SHR
//ELADBGP DD DISP=SHR,DSN=ELA.V6R0M1.SELAJCL(ELADBGPX)
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//CCUBLOG DD SYSOUT=*
디버깅에 대한 특수 고려사항
APF 권한 부여된 라이브러리에서 z/OS의 서버를 시작하는 경우(이는 모드 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
- 관련된 언어에 대한 코드이며, 이전의 표에 나열된 코드 중 하나입니다.