Eclipse IDE에서 IMS 격리를 사용하여 IMS 애플리케이션에 대한 디버그 프로파일 작성

개인 IMS 리젼에서 디버거를 시작하여 다른 사용자로부터 디버그 세션을 분리하기 위해 IMS 격리 프로파일을 작성한 후 활성화할 수 있습니다. 하나의 개인 리젼만 시작할 수 있으며 한 번에 하나의 IMS 격리 또는 비CICS 프로파일을 활성화할 수 있습니다.

태스크 정보

IMS 격리 프로파일에는 다음과 같은 정보가 포함되어 있습니다.
  • 디버거에 의해 구성되는 개인 리젼 및 트랜잭션 세부사항입니다. 개인 리젼 옵션은 Eclipse 작업공간에만 저장되며 코드 적용 범위를 디버깅하거나 실행하기 전에 트랜잭션을 구성하고 개인 리젼을 시작하는 데 사용됩니다.
  • 디버거 및 다른 디버거 구성 옵션을 트리거하는 필터입니다. 디버거를 트리거하는 필터는 비CICS 프로파일과 같은 EQAUOPTS 파일이라는 시퀀스 데이터 세트에 저장됩니다.
참고: IMS 격리 프로파일은 IBM® Developer for z/OS® Enterprise Edition에서만 사용 가능합니다.

프로시저

  1. z/OS 의 디버거 프로파일 보기를 엽니다.
  2. IMS 격리 프로파일을 작성하려면 다음 방법 중 하나로 디버그 프로파일 편집기 를 여십시오.
    • 뷰 툴바에서 격리 프로필 생성( IMS Isolation Profile) 아이콘(IMS 격리 프로파일 작성 아이콘)을 클릭합니다.
    • 보기에서 마우스 오른쪽 단추로 클릭한 후 IMS 격리 프로파일 작성을 선택하십시오.
  3. 디버그 프로파일 편집기에서 적절한 값을 지정하십시오. 필드로 이동하려면 빠른 개요를 사용할 수도 있습니다.
    힌트 표시/숨기기
    이 링크를 클릭하여 섹션에 대한 설명을 표시하거나 숨기십시오.
    프로파일 이름
    프로파일 이름을 지정하십시오. 새 프로파일을 작성할 때 이름이 자동으로 생성됩니다. 이 이름을 사용하거나 다른 이름을 지정할 수 있지만 이름은 고유해야 합니다.
    선택사항: 설명
    프로파일에 대한 설명을 지정하십시오. 설명은 로컬에 저장되며 z/OS Debugger 프로파일 보기에 표시되어 프로파일을 식별하는 데 도움을 줍니다.
    연결
    프로파일이 활성 상태인 원격 시스템 탐색기 z/OS 연결을 선택하십시오. 사용 가능한 연결이 없는 경우 새로 작성을 클릭하여 새 z/OS 연결을 작성하십시오.
    위치
    프로파일의 위치를 지정하십시오.
    • 디버그 프로파일 서비스 API를 지원하는 원격 시스템 탐색기 z/OS 연결에 연결하는 경우 위치 이름은 API에서 자동으로 검색되며 수정할 수 없습니다.
    • 디버그 프로파일 서비스 API 또는 디버그 프로파일 서비스 가 실행 중이지 않은 원격 시스템 탐색기 z/OS 연결에 연결하는 경우, IMS 격리 프로파일이 저장되는 EQAUOPTS 파일의 이름을 지정해야 합니다. 이 필드는 IBM에서 제공하는 기본 EQAUOPTS 파일로 미리 채워지지만 시스템 프로그래머가 파일을 변경했을 수 있습니다. 시스템 프로그래머에게 문의하여 올바른 값을 확인하십시오.
    IMS 격리 구성
    IMS 시스템 ID
    호스트에서 검색된 목록에서 IMS 시스템 ID를 선택하십시오. 트랜잭션을 추가하려면 시스템 ID를 선택해야 합니다.
    리젼 이름
    개인 리젼의 리젼 이름을 지정하십시오. 이 옵션은 디버그 프로필 서비스가 z/OS 디버거 16.0.0 이상과 함께 선택한 RSE 연결에서 실행 중인 경우에만 지정할 수 있습니다. 그렇지 않으면 기본값은 @&USER 이며, 여기서 &USER 은 거래를 등록하거나 비공개 리전을 시작하거나 프로필을 활성화할 때 원격 시스템 탐색기를 통해 인증된 사용자 ID로 대체됩니다.
    작업 클래스
    격리된 영역의 작업 클래스로 사용할 문자를 지정하십시오. 유효한 문자는 A-Z, 0-9입니다. 기본 작업 클래스를 사용하려면 필드를 공백으로 두십시오. 이 필드는 IMS 격리 지원이 디버그 프로파일 서비스를 통해 제공되는 경우에만 사용 가능합니다.
    트랜잭션
    IMS 격리 프로파일에서 등록에 대해 하나 이상의 트랜잭션을 추가하고 선택해야 합니다. 선택된 트랜잭션은 IMS Transaction Isolation Facility를 사용하여 디버깅하기 위해 등록됩니다. 다음 단추를 사용하여 트랜잭션 테이블을 업데이트하십시오.
    추가
    프로파일에 추가할 하나 이상의 트랜잭션을 선택할 수 있는 트랜잭션 대화 상자를 여십시오. 디버그 프로파일 서비스를 사용 중인 경우, 필터를 지정하고 Enter를 누르거나 새로 고치기 를 클릭하여 선택하기 전에 트랜잭션 목록을 검색하십시오.
    주: 정확한 트랜잭션 이름을 지정하거나 와일드카드 (*) 를 사용하여 패턴과 일치하는 트랜잭션 목록을 가져와야 합니다.
    제거
    선택한 트랜잭션을 테이블에서 제거합니다.
    패턴 설정
    라우팅 패턴 수정 창을 열어 다음 트랜잭션 라우팅 패턴 정보를 지정하십시오.
    사용자 ID
    라우팅 패턴과 일치할 사용자 ID. 기본 사용자 ID는 현재 RSE 연결에 인증된 사용자 ID입니다.
    메시지
    패턴 일치 메시지 텍스트입니다. 최대 길이는 32바이트입니다.
    범위 시작
    메시지 텍스트 일치를 시작해야 하는 인덱스를 지정하십시오. 최대 길이는 32767입니다.
    범위 길이
    메시지 텍스트 일치 중에 검색할 패턴 길이를 지정하십시오. 최대 길이는 32767입니다.
    대소문자 구분
    패턴 일치 메시지 텍스트가 대소문자를 구분함을 나타냅니다.
    메시지가 16진수입니다.
    패턴 일치 메시지 텍스트가 16진수임을 나타냅니다.
    리젼 시작/중지
    선택한 트랜잭션의 개인 리젼 상태에 따라 이 단추를 클릭하면 트랜잭션과 연관된 리젼이 시작되거나 중지됩니다.
    새로 고치기
    IMS 트랜잭션 격리 기능 에 연결하고 테이블에서 트랜잭션 정보를 새로 고치십시오.
    STEPLIB
    입력 필드를 사용하여 개인 리젼을 작성하는 JES 작업의 STEPLIB에 추가될 라이브러리 목록에 사용자 라이브러리를 추가하십시오. 다음 단추를 사용하여 목록을 업데이트할 수 있습니다.
    추가
    입력 필드의 라이브러리를 목록에 추가합니다.
    찾아보기
    원격 시스템 탐색기를 사용하여 추가할 라이브러리를 찾으십시오.
    제거
    선택한 라이브러리를 목록에서 제거합니다.
    위로 이동
    선택한 라이브러리를 목록에서 위로 이동합니다.
    아래로 이동
    선택한 라이브러리를 목록에서 아래로 이동합니다.
    필터
    로드 모듈, DLL/프로그램 또는 C 함수
    최소 1개에서 최대 8개의 로드 모듈, DLL 및 프로그램 또는 C 함수 쌍을 지정하십시오. 항목을 추가하거나 수정하려면 테이블에서 두 번 클릭하거나 Enter를 누르십시오.
    참고: 모든 애플리케이션을 디버그하지 않으려면 동일한 쌍의 로드 모듈 또는 DLL및 프로그램 또는 C 함수 모두에 와일드카드 (*) 만 사용하지 마십시오.
    선택사항: 디버거 옵션
    테스트 레벨
    TEST 런타임 옵션 목록에서 TEST 또는 NOTEST를 선택하십시오.
    테스트
    지정된 옵션에 따라 z/OS Debugger 제어를 제공하려면 이 옵션을 사용하십시오.
    • z/OS Debugger 가 CEETEST, PLITEST또는 __ctest()로 시작되면 디버그 프로파일의 옵션이 사용됩니다.
    • CALL CEETEST 또는 이와 동등한 항목을 사용하여 z/OS 디버거를 시작한 경우, z/OS 디버거를 시작한 프로그램에서 돌아온 후에는 상위 레벨이 아닌 Language Environment® 프로그램을 디버깅하거나 상위 레벨 프로그램에서 발생하는 Language Environment 이벤트가 아닌 것을 가로챌 수 없습니다.
    NOTEST
    z/OS Debugger 가 프로그램 초기화 시 시작되지 않도록 하려면 이 옵션을 사용하십시오. 그러나 여전히 CEETEST, PLITEST 또는 __ctest() 함수를 사용하여 z/OS Debugger를 시작할 수 있습니다. 이 경우 NOTEST 로 지정된 하위 옵션은 z/OS Debugger 가 시작될 때 사용됩니다.
    오류 레벨
    TEST 런타임 하위 옵션 목록에서 ALL, ERROR 또는 NONE을 선택하십시오.
    모두
    해당 조건에 대해 중단점이 정의되어 있는지 여부에 관계없이 다음 발생으로 인해 z/OS Debugger 가 제어를 획득하도록 지정합니다.
    • 주의 인터럽트
    • 프로그램 이상 종료
    • 심각도 1 이상의 프로그램 또는 언어 환경 조건
    오류
    다음 조건만 z/OS Debugger 가 사용자 정의 중단점 없이 제어할 수 있도록 지정합니다.
    • C 및 C++의 경우: 주의 인터럽트, 프로그램 종료, 심각도 2 이상의 사전 정의된 언어 환경 조건, SIGUSR1, SIGUSR2, SIGINT 또는 SIGTERM 이외의 모든 C 및 C++ 조건
    • COBOL의 경우: 주의 인터럽트, 프로그램 종료, 심각도 2 이상의 사전 정의된 언어 환경 조건
    • PL/I의 경우: 주의 인터럽트, 프로그램 종료, 심각도 2 이상의 사전 정의된 언어 환경 조건
    없음
    z/OS Debugger 가 해당 조건에 대해 중단점이 정의된 경우에만 조건에서 제어를 획득하도록 지정합니다.
    프롬프트 레벨
    TEST 런타임 하위 옵션 목록에서 PROMPT 또는 NOPROMPT를 선택하십시오.
    PROMPT
    Language Environment 초기화 후 z/OS 디버거를 즉시 시작하도록 설정합니다. 환경 설정 파일에서 명령을 읽은 후 지정된 기본 명령 파일에서 명령을 읽습니다. 파일이 모두 없으면 터미널 또는 워크스테이션에서 명령을 읽습니다.
    NOPROMPT
    Language Environment 초기화 후 z/OS 디버거가 즉시 시작되지 않도록 설정합니다. 대신 애플리케이션이 실행됩니다.
    NOPROMPT 하위 옵션을 지정하면 z/OS 디버거를 시작한 프로그램에서 돌아온 후 상위 레벨이 아닌 Language Environment 프로그램을 디버깅하거나 상위 레벨 프로그램에서 발생하는 Language Environment 이벤트가 아닌 이벤트를 가로챌 수 없습니다.
    z/OS 디버거가 Language Environment 런타임을 사용하지 않고 실행 중인 경우 EQANMDBG, NOPROMPT 옵션은 무시되고 PROMPT 가 항상 적용됩니다.
    명령 데이터 세트
    디버그 세션이 시작될 때 실행할 초기 디버거 명령이 포함된 올바르고 완전한 데이터 세트 이름을 지정하거나 찾아보기를 클릭하여 데이터 세트를 선택하십시오. 올바른 VADSCPnnnnn 항목도 허용됩니다.
    주: 모든 명령이 원격 디버그 세션에서 허용되는 것은 아닙니다. 이러한 명령이 명령 데이터 세트에 포함된 경우 디버그 콘솔 보기에 오류가 표시될 수 있습니다.
    환경 설정 데이터 세트
    디버그 세션을 사용자 정의하는 디버거 명령이 포함된 올바르고 완전한 데이터 세트 이름을 지정하거나 찾아보기를 클릭하여 데이터 세트를 선택하십시오.
    주: 모든 명령이 원격 디버그 세션에서 허용되는 것은 아닙니다. 이러한 명령이 환경 설정 데이터 세트에 포함된 경우 디버그 콘솔 보기에 오류가 표시될 수 있습니다.
    EQAOPTS 파일
    디버그 세션에 대한 EQAOPTS 명령이 포함된 데이터 세트의 이름을 지정하거나 찾아보기를 클릭하여 파일을 선택하십시오.
    언어 환경 옵션
    프로그램에서 충족해야 하는 추가 언어 환경(LE) 옵션을 지정하십시오. STACK 옵션을 제외하고 사이트가 대체하도록 허용한 언어 환경 옵션을 변경할 수 있습니다. CICS® 프로필이 아닌 경우에는 이 옵션을 사용할 수 없습니다.
    선택사항: 고급 연결 옵션
    명령행 모드 코드 적용범위의 경우와 같이 현재 클라이언트가 아닌 클라이언트에 연결하거나 디버그 세션을 다른 사용자의 클라이언트에 전송하려면 이러한 옵션을 지정하십시오.
    특정 클라이언트 정보를 사용하여 연결
    디버그 프로파일이 사용자가 지정한 연결 정보를 사용하도록 강제 실행하려면 이 옵션을 선택하십시오. IP와 포트, 또는 사용자 ID를 지정하십시오.
    IP
    디버그 또는 코드 적용범위 세션이 트리거될 때 연결할 IP 이름 또는 주소를 지정하십시오.
    포트
    디버그 디먼 또는 명령행 모드 코드 적용범위 콜렉터가 수신 세션을 청취하는 TCP/IP 포트를 지정하십시오.
    사용자 ID
    디버그 관리자 가 실행 중이고 디버그 세션을 다른 사용자의 클라이언트로 전송하려는 경우 이 옵션을 사용하십시오. 해당 사용자는 원격 시스템 탐색기에 로그인해야 합니다.
    인증 인증서 파일
    TCP /IP 인증을 위한 인증서 파일의 경로를 지정하십시오. MVS 순차 데이터셋 또는 절대 경로( z/OSUnix )를 입력하거나, 찾아보기를 클릭하여 파일을 선택하십시오. 자세한 내용은 수신 TCP /IP 연결에 대한 인증 활성화 항목을 참조하십시오.
    주:
    • TCP 디버그 프로파일용 IP 인증 지원은 z/OS 디버거 호스트 버전 17.0.2 이상에서 사용할 수 있습니다.
    • 이 옵션의 글자 수 제한은 254자입니다. 경로가 이 제한을 초과하면 경로가 잘립니다.
  4. 활성화하지 않고 저장 아이콘(저장 아이콘)을 클릭하여 프로필을 활성화하지 않고 저장하거나, 편집기 도구 모음의 디버그용 저장 및 활성화 아이콘(디버그를 위해 저장 및 활성화 아이콘) 또는 컴파일된 코드 커버리지용 저장 및 활성화 아이콘(준수 코드 적용 범위 아이콘에 대한 저장 및 활성화)을 클릭하여 원격 연결에서 프로필을 저장하고 활성화합니다.
    선택적으로 M1+Sa를 눌러 활성화하지 않고 저장하거나, M1+Da를 눌러 디버그에 대해 저장하고 활성화하거나, M1+M2+Ca를 눌러 코드 적용 범위에 대해 저장하고 활성화하십시오.
    1. M1은 macOS에서 COMMAND 키이고 대부분의 다른 플랫폼에서는 Ctrl 키입니다. M2는 SHIFT 키입니다.