Rational Developer for System z

로컬 포함 프리프로세서 사용

System z®용 Rational® Developer는 PL/I 지시문 %INCLUDE 또는 COBOL COPY 명령문 외에 포함 지시문을 사용하여 외부 소스 파일을 프로그램으로 통합할 수 있게 하는 로컬 포함 프리프로세서를 제공합니다.

시작하기 전에

로컬 포함 프리프로세서를 사용하기 전에, 로컬 특성 그룹을 작성하여 로컬 PL/I 소스 파일 또는 로컬 프로젝트와 연관시켜야 합니다.

이 태스크 정보

로컬 포함 프리프로세서는 System z용 Rational Developer 설치 경로의 bin 디렉토리에 있습니다. Windows®에서 파일 이름은 PPINCL01.EXE입니다. Linux®에서 파일 이름은 PPINCL01입니다.
개별 PL/I 프로그램이나 하나 이상의 PL/I 프로그램을 포함하는 로컬 z/OS® 프로젝트에 로컬 포함 프리프로세서를 사용할 수 있습니다. 또한 독립적으로 사용하거나 다중 프리프로세서 빌드 오퍼레이션의 일부로 사용할 수도 있습니다.
  • 포함 프리프로세서가 컴파일 이전에 호출되는 유일한 프리프로세서인 경우, 입력 파일은 구문 검사 또는 종속성 표시 오퍼레이션에 선택된 COBOL 또는 PL/I 프로그램입니다.
  • 포함 프로세서가 프로젝트 빌드에 대해 호출되는 경우, 프로젝트의 각 COBOL 또는 PL/I 프로그램이 처리된 후 컴파일됩니다. 이 경우의 입력 파일은 처리할 현재 COBOL 또는 PL/I 소스입니다.
  • 포함 프리프로세서가 다중 프리프로세서 오퍼레이션의 일부로 호출되고 이전 프리프로세서 이후에 호출되는 경우, 포함 프리프로세서에 대한 입력 파일은 이전 활성 프리프로세서의 출력 파일입니다. 이 파일은 이전 활성 프리프로세서의 프리프로세서 출력 파일 이름 입력 필드에 나열되어 있습니다. 다중 프리프로세서 오퍼레이션 설정에 대한 자세한 정보는 여러 로컬 프리프로세서 사용을 참조하십시오.

로컬 포함 프리프로세서를 사용하려면 다음을 수행하십시오.

프로시저

  1. 자원 또는 프로젝트와 연관된 특성 그룹에 대한 특성 그룹 편집기를 열고 PL/I 페이지를 탐색하십시오.
  2. 왼쪽 목록에서 로컬 프리프로세서를 클릭하여 로컬 프리프로세서 페이지를 여십시오.
  3. 특성 그룹에 새 로컬 프리프로세서를 추가하려면 새로 작성을 클릭하십시오.
  4. 로컬 프리프로세서 페이지의 프리프로세서 옵션 섹션에 있는 필드를 입력하십시오.
    프리프로세서 설명
    설명을 입력하십시오. 예를 들면 "프리프로세서 포함"입니다.
    프리프로세서 이름(완전한 이름)
    포함 프리프로세서에 대한 전체 경로 이름을 입력하십시오. ${INSTDIR} 변수를 사용하여 System z용 Rational Developer 설치 디렉토리를 가리킬 수 있습니다. 이 변수는 포함 프리프로세서를 찾는 데 사용됩니다.
    프리프로세서 인수
    포함 프리프로세서는 다음 인수를 사용할 수 있습니다.
    • TRACE(ON|OFF) 워크스테이션에서, 이 옵션은 TPF 원격 콘솔에 추가 출력을 제공합니다. 390 시스템에서, 이 옵션은 추가 JES 출력을 제공합니다. 이 출력은 IBM® 기술 지원 담당자가 사용하기 위한 것이며, 불필요한 출력의 양이 증가하면 성능이 저하될 수 있기 때문에 일반 개발 과정 중에는 사용하지 않아야 합니다. 문제점 판별을 위해 IBM 기술 지원 담당자에게 문의해야 하는 경우, 이 출력을 해당 담당자에 복사할 수 있습니다. 이 옵션의 기본값은 TRACE(OFF)입니다. 옵션을 지정하지 않으면 기본값이 사용됩니다.
    • FORMAT(ON|OFF) 워크스테이션과 390 시스템에서, 이 옵션은 오류 메시지에 대해 생성된 XML의 가독성을 변경합니다. FORMAT(ON)은 XML 파일을 읽기 쉽게 명령문 테이블이 6개 열로 작성됩니다. 이 옵션을 설정하면 오퍼레이션이 더 오래 걸리므로 XML 파일 구문 분석의 성능이 약간 저하될 수 있습니다. 이 옵션의 기본값은 FORMAT(OFF)입니다. 옵션을 지정하지 않으면 기본값이 사용됩니다.
    • NOCOPY (ON|OFF) 소스에 COPY REPLACE 명령문이 포함되어 있는 경우, 포함 프리프로세서는 COPY REPLACE 명령문 처리를 지원하지 않습니다. 프리프로세서는 사본 파일에서 문자열 바꾸기를 수행하지 않거나, COPY REPLACE 명령문에 지정된 멤버 이름을 찾지 않습니다. 이 문제점을 예방하려면 NOCOPY(ON) 프리프로세서 옵션을 사용하십시오. 이 옵션은 -INC 및 ++INCLUDE 명령문이 처리되게 하지만, COPY 명령문 및 %INCLUDE 명령문은 포함 프리프로세서에 의해 처리되지 않습니다. 프리프로세서 이후 컴파일러가 이러한 명령문을 처리합니다.

      소스에 멤버 이름을 따옴표 또는 어포스트로피로 묶은 COPY 명령문이 포함되어 있는 경우, 포함 프리프로세서는 이러한 명령문 처리를 지원하지 않습니다. 이 문제점을 예방하려면 NOCOPY(ON) 프리프로세서 옵션을 사용하십시오. 이 옵션은 -INC 및 ++INCLUDE 명령문이 처리되게 하지만, COPY 명령문 및 %INCLUDE 명령문은 포함 프리프로세서에 의해 처리되지 않습니다. 프리프로세서 이후 컴파일러가 이러한 명령문을 처리합니다.

    Linux 특정
정보 Linux 플랫폼에서는, TRACE{ON} 및 FORMAT{ON}과 같이 소괄호 대신 중괄호 { }를 사용하여 프리프로세서 옵션을 지정하십시오.

    프리프로세서 출력 파일 이름
    프리프로세서 출력에 사용할 파일 이름을 지정하십시오. 이 옵션을 생략하면 출력 파일 이름이 생성됩니다.
    오류 피드백 지원
    프리프로세서에 의해 생성된 오류를 로그하려면 이 선택란을 선택하십시오. 이 선택란을 선택하면 오류 피드백 XML 파일 이름 필드가 사용 가능합니다. 이 옵션은 기본적으로 사용으로 설정됩니다.
    오류 피드백 XML 파일 이름
    오류 피드백에 생성할 XML 파일의 불완전한 이름을 지정하십시오. 이 옵션을 생략하면 오류 피드백 XML 파일 이름이 생성됩니다.
    환경 변수(명령문 설정)
    프리프로세서에 전달할 환경 변수를 지정하십시오. 이 필드는 SYSLIB에 대한 값을 포함하지만, 포함 파일이 있는 폴더를 가리키도록 값을 변경해야 합니다. SYSLIB 환경 변수의 경로 길이는 4K로 제한됩니다. 길이가 4K를 초과해도 오류 메시지가 표시되지 않지만 SYSLIB 문이 4K를 초과할 경우, 포함 프리프로세서 프로그램에서 구문 검사 조작이 비정상적으로 종료됩니다.

    Linux Linux에서, 내보내기 명령문을 사용하여 환경 변수를 설정하십시오(예: export SYSLIB=/root/project1/includes).


이용 약관 | 피드백

이 Information Center는 Eclipse 기술로 구현됩니다. (http://www.eclipse.org 웹사이트 참조)