부록A. Debug Tool에 사용되는 데이터셋

Debug Tool은 다음과 같은 데이터셋을 사용합니다.

C 및 C++ 소스
이 데이터셋은 컴파일러의 입력으로 사용되며 영구 PDS 멤버, 순차 파일 또는 HFS 파일에 보관되어야 합니다. 이 데이터셋은 파일의 연결이 아니라 단일 파일이어야 합니다. Debug Tool은 이 데이터셋을 사용하여 실행 중인 프로그램을 표시합니다.

C 및 C++ 컴파일러는 소스 데이터셋명을 로드 모듈 안에 저장합니다. Debug Tool은 이 데이터셋명을 사용하여 소스에 액세스합니다.

이 데이터셋은 원본 소스가 아닐 수 있습니다. 예를 들어, 해당 프로그램이 CICS® 변환기에 의해 사전 처리되었을 수 있습니다. 프리프로세서를 사용하려면 나중에 Debug Tool에서 사용할 수 있도록 컴파일러의 데이터셋 입력을 영구 데이터셋에 보관해야 합니다.

이 데이터셋을 Debug Tool이 여러 번 읽을 수 있으므로 다음 중 하나를 수행하는 것이 좋습니다.

데이터셋을 할당할 때 SUBSYS=ssss 매개변수를 지정하도록 요청하는 라이브러리 시스템을 사용하여 소스 코드를 관리하려면 사용자 또는 사용자 사이트에서 ssss에 대한 값을 제공하는 EQAOPTS SUBSYS 명령을 지정해야 합니다. CICS에서 프로그램을 디버깅할 때 이 지원은 사용 가능하지 않습니다. EQAOPTS 명령을 지정하는 방법에 대해 학습하려면 Debug Tool Reference and Messages 또는 Debug Tool Customization Guide의 『EQAOPTS 명령』 주제를 참조하십시오.

다음 조건이 사용자의 상황에 적용되는 경우, .mdbg 파일에 소스 사본이 있기 때문에 소스에 액세스하지 않아도 됩니다.

COBOL 목록
이 데이터셋은 컴파일러에 의해 작성되며 영구 PDS 멤버, 순차 파일 또는 HFS 파일에 보관되어야 합니다. Debug Tool은 이 데이터셋을 사용하여 실행 중인 프로그램을 표시합니다.

COBOL 컴파일러는 목록 데이터셋명을 로드 모듈 안에 저장합니다. Debug Tool은 이 데이터셋명을 사용하여 목록에 액세스합니다.

Debug Tool은 COBOL LIST 컴파일러 옵션에 의해 작성된 출력을 사용하지 않습니다.

SEPARATE 하위 옵션으로 컴파일한 COBOL 프로그램은 목록 파일을 저장할 필요가 없습니다. 대신, 별도의 디버그 파일 SYSDEBUG를 저장해야 합니다.

VS COBOL II 컴파일러는 목록 데이터셋명을 저장하지 않습니다. Debug Tool은 userid.cuname.LIST 양식으로 이름을 작성하고 이 이름을 사용하여 목록을 찾습니다.

이 데이터셋을 Debug Tool이 여러 번 읽을 수 있으므로 다음 중 하나를 수행하는 것이 좋습니다.

EQALANGX 파일
Debug Tool은 이 데이터셋을 사용하여 어셈블러 및 비Language Environment COBOL 소스 파일에 대한 디버그 정보를 얻습니다. 이 파일은 영구 PDS 멤버 또는 순차 파일일 수 있습니다. Debug Tool을 시작하기 전에 작성해야 합니다. EQALANGX 프로그램을 사용하여 작성할 수 있습니다. EQALANGX 프로그램에 대한 입력으로 상위 레벨 어셈블러에서 SYSADATA 출력을 사용하거나 IBM® OS/VS COBOL 또는 IBM VS COBOL II 컴파일러에서 목록을 사용하십시오.
PL/I 소스(Enterprise PL/I 전용)
이 데이터셋은 컴파일러의 입력으로 사용되며 영구 PDS 멤버, 순차 파일 또는 HFS 파일에 보관되어야 합니다. Debug Tool은 이 데이터셋을 사용하여 실행 중인 프로그램을 표시합니다.

Enterprise PL/I 컴파일러는 소스 데이터셋명을 로드 모듈 안에 저장합니다. Debug Tool은 이 데이터셋명을 사용하여 소스에 액세스합니다.

이 데이터셋은 원본 소스가 아닐 수 있습니다. 예를 들어, 해당 프로그램이 CICS 변환기에 의해 사전 처리되었을 수 있습니다. 프리프로세서를 사용하려면 나중에 Debug Tool에서 사용할 수 있도록 컴파일러의 데이터셋 입력을 영구 데이터셋에 보관해야 합니다.

이 데이터셋을 Debug Tool이 여러 번 읽을 수 있으므로 다음 중 하나를 수행하는 것이 좋습니다.

데이터셋을 할당할 때 SUBSYS=ssss 매개변수를 지정하도록 요청하는 라이브러리 시스템을 사용하여 소스 코드를 관리하려면 사용자 또는 사용자 사이트에서 ssss에 대한 값을 제공하는 EQAOPTS SUBSYS 명령을 지정해야 합니다. CICS에서 프로그램을 디버깅할 때 이 지원은 사용 가능하지 않습니다. EQAOPTS 명령을 지정하는 방법에 대해 학습하려면 Debug Tool Reference and Messages 또는 Debug Tool Customization Guide의 『EQAOPTS 명령』 주제를 참조하십시오.

PL/I 목록(PL/I 컴파일러의 기타 모든 버전)
이 데이터셋은 컴파일러에 의해 작성되며 영구 파일에 보관되어야 합니다. Debug Tool은 이 데이터셋을 사용하여 실행 중인 프로그램을 표시합니다.

PL/I 컴파일러는 목록 데이터셋명을 저장하지 않습니다. Debug Tool은 userid.cuname.LIST 양식의 이름을 가진 데이터셋에서 목록을 찾습니다.

Debug Tool은 PL/I 컴파일러 LIST 옵션으로 작성한 출력을 사용하지 않습니다. NOLIST를 지정하면 성능이 향상됩니다.

이 데이터셋을 Debug Tool이 여러 번 읽을 수 있으므로 다음 중 하나를 수행하는 것이 좋습니다.

별도의 디버그 파일
이 데이터셋은 컴파일러에 의해 생성되며 Debug Tool에서 사용된 정보를 저장합니다. 이 파일을 생성하려면 다음 컴파일러 옵션으로 프로그램을 컴파일해야 합니다.

다음 형식 중 하나로 파일을 저장하십시오.

컴파일러는 별도의 디버그 파일의 데이터셋명을 로드 모듈 안에 저장합니다. Debug Tool은 사용자가 부록B. Debug Tool이 소스, 목록 또는 별도의 디버그 파일을 찾는 방법의 설명대로 다른 데이터셋명을 제공하지 않는 한, 이 데이터셋명을 사용하여 디버그 정보에 액세스합니다.

이 데이터셋을 Debug Tool이 여러 번 읽을 수 있으므로 효율성을 높이려면 다음 단계 중 하나를 수행하십시오.

.mdbg 파일
dbgld 명령 또는 CDADBGLD 유틸리티로 .mdbg 파일을 작성합니다. 이 파일에는 로드 모듈 또는 DLL의 모든 프로그램에 맞는 .dbg 파일이 모두 포함됩니다. z/OS XL C/C++, 버전 1.10을 시작하면, Debug Tool이 소스 파일을 저장(캡처)하는 경우 이 파일에서 정보를 얻을 수 있습니다. -c 옵션으로 dbgld 명령을 사용하거나 CAPSRC 옵션으로 CDADBGLD 유틸리티를 사용하여 캡처된 소스로 .mbdg 파일을 작성하십시오.

이러한 명령 사용 방법에 대해 학습하려면 z/OS XL C/C++ User’s Guide를 참조하십시오.

환경 설정 파일

이 데이터셋에는 해당 세션을 사용자 정의하는 Debug Tool 명령이 있습니다. 예를 들어, 이 데이터셋은 Debug Tool이 설정한 기본 화면 색상을 변경하는 데 사용할 수 있습니다. 이 파일을 영구 PDS 멤버 또는 순차 파일에 저장하십시오.

환경 설정 파일을 직접(예: TEST 런타임 옵션을 통해) 지정하거나 EQAOPTS PREFERENCESDSN 명령을 통해 지정할 수 있습니다. 지시사항은 환경 설정 파일 작성을 참조하십시오.

CICS 리젼에는 환경 설정 파일에 대한 읽기 승인이 있어야 합니다.

글로벌 환경 설정 파일

이는 일반적으로 모든 사용자에게 사용할 수 있는 환경 설정 파일입니다. 이는 EQAOPTS GPFDSN 명령을 통해 지정됩니다. EQAOPTS 명령을 지정하는 방법에 대해 학습하려면 Debug Tool Reference and Messages 또는 Debug Tool Customization Guide의 『EQAOPTS 명령』 주제를 참조하십시오. 글로벌 환경 설정 파일이 있는 경우 Debug Tool은 글로벌 환경 설정 파일의 명령을 환경 설정 파일의 명령보다 먼저 실행합니다.

CICS 리젼에는 글로벌 환경 설정 파일에 대한 읽기 승인이 있어야 합니다.

명령 파일

이 데이터셋에는 디버그 세션을 제어하는 Debug Tool 명령이 있습니다. 예를 들어 이 데이터셋은 중단점을 설정하거나 공통 변수의 모니터를 설정하는 데 사용할 수 있습니다. 영구 PDS 멤버 또는 순차 파일에 이를 저장하십시오.

환경 설정 파일을 지정하는 경우 Debug Tool은 명령 파일의 명령을 환경 설정 파일에 지정된 명령 다음에 실행합니다.

명령 파일을 직접(예: TEST 런타임 옵션을 통해) 지정하거나 EQAOPTS COMMANDSDSN 명령을 통해 지정할 수 있습니다. EQAOPTS COMANDSDSN 명령을 통해 지정된 경우 이는 PDS 또는 PDSE에 있어야 하고 멤버명은 첫 번째 enclave의 초기 로드 모듈명과 일치해야 합니다. 명령 파일 작성에 대한 지시사항은 명령 파일 작성을 참조하십시오.

CICS 리젼에는 명령 파일에 대한 읽기 승인이 있어야 합니다.

EQAOPTS 파일
이 데이터셋에는 디버그 세션에 대한 옵션 및 초기 설정값을 제어하는 EQAOPTS 명령이 있습니다. 영구 PDS 멤버 또는 순차 파일에 이를 저장하십시오. EQAOPTS 명령을 지정하는 방법에 대해 학습하려면 Debug Tool Reference and Messages 또는 Debug Tool Customization Guide의 『EQAOPTS 명령』 주제를 참조하십시오.

레코드 형식은 F 또는 FB 중 하나여야 하고 논리적 레코드 길이는 80이어야 합니다.

CICS 리젼에는 EQAOPTS 파일에 대한 읽기 승인이 있어야 합니다.

로그 파일

Debug Tool은 이 파일을 사용하여 디버깅 세션의 진행상태를 기록합니다. Debug Tool은 명령 실행 결과와 함께 입력한 명령 사본을 저장합니다. 결과는 주석으로 저장됩니다. 그러므로 로그 파일을 후속 디버깅 세션에서 명령 파일로 사용할 수 있습니다. 영구 PDS 멤버 또는 순차 파일에 로그 파일을 저장하십시오. Debug Tool이 이 데이터셋에 작성하므로 로그 파일을 순차 파일로 저장해서 이 파일에 대한 모든 경합을 줄이십시오.

Debug Tool은 원격 디버그 모드에서 로그 파일을 사용할 수 없습니다.

로그 파일 스펙은 다음 옵션 중 하나여야 합니다.

로그 파일을 직접(예: INSPLOG DD 또는 SET LOG 명령) 지정하거나 EQAOPTS LOGDSN 명령을 통해 지정할 수 있습니다. 지시사항은 로그 파일 작성을 참조하십시오.

DB2® 스토어드 프로시저의 경우 여러 사용자가 동일한 로그를 사용하려고 시도하는 것을 방지하려면 EQAOPTS LOGDSN 명령을 사용하지 마십시오.

CICS의 경우 CICS에서 디버깅하는 경우 제한사항에 설명된 특수 환경을 검토하십시오.

설정값 파일 저장(SAVESETS)
Debug Tool은 이 파일을 사용하여 Debug Tool 세션 사이에서 SET 명령의 설정을 저장하고 복원합니다. VB의 RECFM과 LRECL>=3204의 순차 파일이 사용되어야 합니다.

이 데이터셋의 기본 이름은 userid.DBGTOOL.SAVESETS입니다. 그러나 EQAOPTS SAVESETDSN 명령을 사용하여 이 기본값을 변경할 수 있습니다.비대화식 모드(전용 터미널을 사용하지 않는 MVS Batch 모드)에서 이 파일을 찾는 데 사용되는 DD명은 INSPSAFE입니다.

중단점 및 모니터 스펙 정보를 저장하는 샘플 파일에 설정값 정보를 저장할 수 없습니다.

설정값 파일 저장은 원격 디버그 세션에 사용되지 않습니다.

설정값의 복원 및 자동 저장은 현재 사용자가 로그인되지 않거나 기본 사용자 ID로 로그인된 경우 CICS에 지원되지 않습니다. CICS에서 실행 중인 경우 CICS 리젼에 설정값 파일 저장에 대한 갱신 승인이 있어야 합니다.

설정 파일 저장은 DB2 스토어드 프로시저를 디버그할 때 자동으로 지원되지는 않습니다.

사용자 또는 사용자 사이트는 Debug Tool이 이 파일을 작성하고 EQAOPTS SAVESETDSNALLOC 명령을 통해 설정값을 저장하고 복원할 수 있도록 합니다. 지시사항은 설정, 중단점 및 모니터 스펙 저장 및 복원을 참조하십시오.

중단점 및 모니터 스펙 파일(SAVEBPS) 저장
Debug Tool은 이 파일을 사용하여 Debug Tool 세션 사이에서 중단점, 모니터 스펙 및 LDD 스펙을 저장하고 복원합니다. VB의 RECFM 및 LRECL >= 3204의 PDSE 또는 PDS 데이터셋이 사용되어야 합니다. (PDSE를 사용할 것을 권장합니다.)

이 데이터셋의 기본 이름은 userid.DBGTOOL.SAVEBPS입니다. 그러나 EQAOPTS SAVEBPDSN 명령을 사용하여 이 기본값을 변경할 수 있습니다. 비대화식 모드(전용 터미널을 사용하지 않는 MVS Batch 모드)에서 이 파일을 찾는 데 사용되는 DD명은 INSPSAFE입니다.

설정값 정보를 저장하는 동일한 파일에 중단점 및 모니터 스펙 정보를 저장할 수 없습니다.

중단점 및 모니터 스펙 파일 저장은 원격 디버그 세션에 사용되지 않습니다.

현재 사용자가 로그인되지 않았거나 기본 사용자 ID로 로그인된 경우 중단점과 모니터 스펙의 자동 저장 및 복원은 CICS에 지원되지 않습니다. CICS에서 실행하는 경우, CICS 리젼에 중단점 및 모니터 스펙 파일 저장에 대한 갱신 승인이 있어야 합니다.

중단점 및 모니터 스펙 파일 저장은 DB2 스토어드 프로시저를 디버그할 때 자동으로 지원되지는 않습니다.

사용자 또는 사용자 사이트는 Debug Tool이 이 파일을 작성하고 EQAOPTS SAVEBPDSNALLOC 명령을 통해 중단점 및 모니터 스펙을 저장하고 복원할 수 있도록 합니다. 지시사항은 설정, 중단점 및 모니터 스펙 저장 및 복원을 참조하십시오.


9.
환경 변수를 지정할 수 있는 상황에서 환경 변수 EQA_USE_MDBG를 YES 또는 NO로 설정할 수 있으며, EQAOPTS MDBG 명령의 설정(기본 설정 포함)을 대체합니다.