이 주제는 로컬 프리프로세서에 대해 설정 가능한 옵션을 설명합니다.
시작하기 전에
로컬 또는 원격 시스템에 특성 그룹이 정의되어 있어야
합니다.
이 태스크 정보
로컬 프리프로세서 지원은 다음 컴파일 또는 구문 검사 오퍼레이션에
사용 가능합니다.
System z®용 Rational® Developer는
Linux® 플랫폼에서
로컬 COBOL 또는 PL/I 빌드, 구문 검사, 종속성 표시 기능을 지원하지 않습니다.
프로시저
로컬 프리프로세서에 대한 옵션을 정의하려면 다음을 수행하십시오.
- 특성 그룹 편집기에서 특성 그룹을 여십시오.
- 로컬 COBOL 설정 또는 로컬
PLI 설정 페이지의 로컬 프리프로세서 탭을
탐색하십시오. 이 페이지에는 두 개의 섹션이 포함되며,
프리프로세서 섹션은 특성 그룹에 추가된
모든 프리프로세서를 표시합니다. 다음과 같이 이 목록을 작업하는
두 가지 방법이 있습니다.
- 컴파일 또는 구문 검사 오퍼레이션 이전에 프리프로세서가 실행되도록
하려면 프리프로세서 이름 옆의 선택란을 선택합니다.
이 조치를 "프리프로세서 선택"이라고 합니다. 선택란이 선택된 경우에만
프리프로세서가 활성화됩니다.
- 목록에서 프리프로세서 이름을 선택하면 프리프로세서에 대한 옵션이
프리프로세서 옵션 섹션에 표시됩니다.
이 조치를 "프리프로세서 강조표시"라고 합니다.
프리프로세서 옵션 섹션은
선택된 프리프로세서에 대한 옵션을 표시합니다.
- 프리프로세서 설명
- 설명을 입력하십시오. 예를 들면 "프리프로세서 포함"입니다.
- 프리프로세서 이름(완전한 이름)
- 포함 프리프로세서에 대한 전체 경로 이름을 입력하십시오. ${INSTDIR} 변수를 사용하여
System z용 Rational Developer 설치 디렉토리를 가리킬 수 있습니다. 이 변수는
포함 프리프로세서를 찾는 데 사용됩니다.
- 프리프로세서 인수
- 프리프로세서에 전달할 인수를 입력하십시오.
이러한 인수는 명령 프롬프트에서 프리프로세서로 전달되는 것처럼
입력됩니다. 인수에는 프리프로세스할 파일의
완전한 경로가 포함될 수도 있습니다. 인수가
프리프로세서에서 처리할 XML 파일 또는 출력 파일의 완전한 이름을 포함하는 경우,
XML 파일 및 출력 파일이 로컬 프로젝트의
BuildOutput 폴더에 작성되어
있어야 합니다.
- 프리프로세서 출력 파일 이름
- 프리프로세서가 생성할 확장 파일의 이름을
입력하십시오. 이 파일 이름은 불완전한 이름이어야 합니다. 출력 파일은
로컬 프로젝트의 BuildOutput 폴더에
생성되어야 합니다.
- 오류 피드백 지원
- 프리프로세서에 의해 생성된 오류를 로그하려면 이 선택란을 선택하십시오.
이 선택란을 선택하면 오류 피드백 XML 파일 이름 필드가
사용 가능합니다. 이 옵션은 기본적으로 사용으로 설정됩니다.
- 오류 피드백 XML 파일 이름
- 오류 피드백에 생성할 XML 파일의 이름을 지정하십시오.
이 XML 파일은 로컬 프로젝트의 BuildOutput 폴더에
작성되어야 하므로 불완전한 이름이어야 합니다.
- 환경 변수(명령문 설정)
- 프리프로세서에 전달할 환경 변수를 지정하십시오.
이 필드는 SYSLIB에 대한 값을 포함하지만, 포함 파일이 있는 폴더를
가리키도록 값을 변경해야 합니다.
다음 변수를 프로젝트 빌드 일반화에 도움이 되는 입력 필드에서
사용할 수도 있습니다.
- ${project_loc}
- 프로젝트 위치입니다. 프로젝트의 디스크에서의 위치를 추가하는 데 사용할 수
있습니다. 프로젝트의 폴더 이름을 프리프로세서에 전달해야 하는 경우
${project_loc}\folder1로 지정할 수 있습니다.
프리프로세서 호출 시 ${project_loc}가 대체됩니다.
- ${rdz_cache_home}
- 프리프로세서를 원격 파일에 사용하는 경우, 루트 캐시 위치에
도달해야 할 수도 있습니다. 이 위치는 ${rdz_cache_sysn} 변수 설명에서 기술된 System z용 Rational Developer
캐시 위치입니다. 이 변수는
"FttRemoteTempFiles"\RSE Connection Name 서브폴더를 포함하지 않습니다.
원격 파일의 로컬 구문 검사용 BuildOutput 폴더는
${rdz_cache_home} 위치에 있습니다. 이 폴더는
로컬 프리프로세서가 호출되는 폴더입니다.
- ${rdz_cache_sysn}
- 프리프로세서를 원격 파일에 사용하는 경우, System z용
Rational Developer 다운로드 위치의 파일을 가리킬 수 있어야 할 수도 있습니다. 이 위치는
작업공간 위치에 따라 달라집니다. System z용 Rational Developer가
원격 파일의 로컬 구문 검사에 대한 컴파일 종속 항목을 다운로드합니다. 다운로드 위치는
System z용
Rational Developer 캐시 위치입니다.
원격 파일의 로컬 구문 검사 수행 시 원격 시스템에서
프리프로세서가 실행 중이어야 합니다. 원격 시스템에서
프리프로세스 및 컴파일 조합이 수행되고,
빌드 종속 항목의 목록이 작성됩니다. 이 목록은 파일에 대한
종속성 표시 오퍼레이션을 수행할 때 표시되는
파일 목록과 동일합니다. 이는 구문 검사 >
로컬 조치에서 종속성
검사 대화 상자의 종속 파일을 클릭하면 표시되는
파일 목록과 동일합니다. 이러한 파일은 캐시 위치에
다운로드됩니다. ${rdz_cache_sysn} 변수를 사용하여 파일 또는 폴더를 가리켜야 할 수도
있습니다. 데이터 세트 멤버 USERID.A001.COPYLIB(MEM1)가
종속 파일 중 하나인 경우, 예를 들면 로컬 프리프로세서가 이용하는
해당 파일의 캐시 위치를 가리켜야 하는 경우입니다.
이를 가리키는 한 가지 방법은 다운로드한 멤버가 들어 있는 폴더로
환경 변수를 설정하는 것입니다. 프리프로세서 환경 변수 입력 필드
SET SYSLIB=${rdz_cache_sysn}\USERID\USERID.A001.COPYLIB에서 설정할 수 있습니다. 데이터 세트에
해당하는 폴더의 상위는 멤버를 포함한 데이터 세트 이름의
상위 레벨 규정자입니다. ${rdz_cache_sysn} 변수가
System z용 Rational Developer 캐시 위치 "FttRemoteTempFiles"\RSE
연결 이름으로 대체됩니다.
- ${resource_fn}
- 프리프로세스할 현재 자원의 불완전한 파일 이름입니다.
프로젝트 빌드를 수행 중이었고, 프로젝트에 3개의 COBOL 파일
RED.cbl, WHITE.cbl 및 BLUE.cbl이 있는 경우
프로젝트 빌드 중 각각의 프리프로세스에 대해 해당 변수에 값이
지정됩니다. 값은 RED, WHITE 또는 BLUE입니다. 이 변수의 값은
프로젝트에 대한 프리프로세서 값을 지정할 때의
값입니다. 예를 들어, 프리프로세서 출력 파일 이름 입력 필드에서
${resource_fn}_PP1.dek를 지정하면
BuildOutput 폴더에 출력 파일 RED_PP1.dek,
WHITE_PP1.dek 및 BLUE_PP1.dek가 있습니다.
- ${resource_loc}
- 프리프로세스할 자원의 디스크에서의 위치입니다.
프리프로세서에서 프리프로세스하기 위해 디스크에서의 정확한 파일 위치가
필요한 경우, 이 변수를 사용하면 호출 시 디스크에서의
자원 위치 값이 대체됩니다. 원격 파일의
로컬 구문 검사를 수행할 경우, 로컬 프리프로세서 옵션의
${resource_loc} 값은 System z용
Rational Developer 캐시에 있는
파일의 위치입니다.
- ${INSTDIR}
- System z용
Rational Developer의 설치 디렉토리입니다.
로컬 프리프로세서가 구문 검사, 빌드 또는 종속성 표시 조치에서
호출될 때 이 조치의 현재 디렉토리는
로컬 프로젝트의 BuildOutput
폴더입니다. 프리프로세서가 작성하는 XML 파일 및 확장 소스 파일이
이 폴더에 작성됩니다.
- 특성 그룹을 저장하고 변경사항을 저장하십시오.