진단 도구

문제점을 해결하기 위해 Rational® Publishing Engine에서 사용 가능한 진단 도구(템플리트 검증 도구, 콘솔 보기, 문제점 보기 및 로그 파일 등)를 사용할 수 있습니다.

템플리트 검증 도구

템플리트 검증 도구를 실행하면 다음과 같은 문제점 목록이 제공됩니다.
  • 데이터 소스: 서로 다른 데이터 소스 구성 요소에서 동일한 데이터 소스가 사용되는 경우, 충돌이 발생할 수 있습니다.
  • 데이터 소스 구성 요소: 해당 요소가 구성되어야 합니다.
  • 중복 요소: 테이블 표, 목차, 그림 표 등의 요소는 한 템플리트에 각각 하나만 있을 수 있습니다.
  • 스크립트 표현식: 스크립트에서 사용된 이름이 특성에 적용되는지 확인하기 위해 마스터 페이지 및 스타일 이름 특성을 확인합니다.
  • 대소문자: 변수, 마스터 페이지, 데이터 소스 및 스타일 이름에서 대소문자가 일치하는지 확인합니다.
  • 영역 이름: 각 이름이 고유한지 확인하기 위해 검사합니다.

템플리트 검증 도구 사용 방법에 대한 자세한 정보는 템플리트 오류 확인의 내용을 참조하십시오.

데이터 미리보기

템플리트 또는 문서 스펙에서 데이터 소스를 지정한 경우, 문서가 생성될 때 포함될 데이터를 미리 볼 수 있습니다. 데이터를 미리 볼 수 있으므로 데이터 제공자 또는 템플리트 구조에서 출력 관련 문제가 발생할 것인지 여부를 판별할 수 있습니다.

자세한 정보는 데이터 소스 스키마 보기에서 데이터 미리보기 또는 문서 스펙 보기에서 데이터 미리보기를 참조하십시오.

콘솔 보기

콘솔 보기는 Rational Publishing Engine 프로세스가 발생할 때 이에 대한 간단한 요약을 제공합니다. 예를 들어, Rational Publishing Engine Document Studio를 시작하면 콘솔 보기에 다음과 같은 정보 메시지가 표시될 수 있습니다.

CRRPE0321I RPE 라이센스 - 라이센스가 확인되었습니다. 유효 기간이 300
남았습니다. CRRPE0282I Document Studio가 시작되었습니다.

문서가 생성되는 경우, 템플리트 요소 및 데이터 소스의 데이터 처리가 두 스레드에서 발생합니다. 첫 번째 스레드는 데이터를 읽는 입력 스레드이며 두 번째 스레드는 데이터를 처리하는 출력 스레드입니다. 입력 및 출력 스레드가 동시에 처리되므로 이러한 스레드 처리는 콘솔 보기 사이에 배치됩니다.
  • Processed x input elements: 첫 번째 스레드가 문서 생성에 필요한 명령을 생성합니다.
  • x publishing commands are processed. x publishing commands remain to be processed: 두 번째 스레드가 입력 스레드에 의해 생성된 명령을 공개합니다.
x는 처리되는 명령의 수를 표시합니다. 명령은 템플리트 요소의 세 부분(요소 처리를 시작하기 위한 명령 하나, 요소의 컨텐츠에 대한 명령 하나, 요소 처리를 종료하기 위한 명령 하나)과 데이터 소스의 데이터로 구성됩니다. 따라서 명령의 수는 항상 템플리트 내의 요소의 수의 세 배보다 많습니다.

Rational Publishing Engine이 한 번에 처리할 수 있는 가능한 한 많은 데이터를 읽도록 디자인되었으므로 입력 요소 및 공개 명령의 수는 문서 생성 동안 증가하고 감소합니다. 입력 스레드는 출력 스레드가 명령을 공개할 수 있는 것보다 빠르게 명령을 생성합니다. 첫 번째 스레드가 특정 수의 명령을 생성하는 경우, 출력 스레드가 계속 명령을 공개할 때까지 입력 스레드가 일시정지됩니다. 따라서 문서 생성이 진행되면서 수가 줄어들기만 할 것으로 예상할 수 있지만 수의 변동은 Rational Publishing Engine이 한 번에 둘 이상의 프로세스를 완료하고 있음을 나타내는 증거입니다.

콘솔 보기를 열려면 > 보기 표시 > 콘솔을 클릭하십시오.

표시되는 문자의 소를 조정하는 방법에 대한 정보는 예: 콘솔 보기 문자 한계 플래그 변경을 참조하십시오. 표시되는 메시지의 형식 변경과 같은 사용자 정의에 대한 정보는 콘솔 로그 사용자 정의를 참조하십시오.

문제점 보기

문제점 보기는 Rational Publishing Engine 오류가 발생할 때 오류 목록을 제공합니다. 예를 들어, 중앙 관리 컴포넌트에 연결하는 데 문제가 있는 경우, 문제점 보기에 다음 메시지가 표시될 수 있습니다.

중앙 관리 컴포넌트에 액세스하는 동안 너무 많은 오류가
발생했음을 표시하는 메시지

문제점 보기를 열려면 > 보기 표시 > 문제점을 클릭하십시오.

오류에 대한 자세한 정보를 보려면 마우스 오른쪽 단추로 오류를 클릭한 다음 특성을 선택하십시오. 오류에 대한 특성은 문제점 해결에 도움이 되는 자세한 정보(예: 오류가 발생한 요소)를 제공합니다.

로그 파일

Rational Publishing Engine에서는 두 가지 방법으로 로그 파일에서 프로세스 정보를 볼 수 있습니다. 이 로그 파일을 통해 문제를 식별할 수 있습니다. 첫 번째 방법은 사용자 인터페이스 로그 파일을 사용하는 것입니다. 템플리트 및 문서 스펙을 디자인하는 동안 발생하는 문제는 사용자 인터페이스 로그 파일에 나열됩니다. 두 번째 방법은 코어 로그를 사용하는 것입니다. 템플리트 및 문서 스펙에서 문서를 생성하는 동안 발생하는 문제는 코어 로그 파일에 나열됩니다. 코어 및 사용자 인터페이스 프로세스에 대한 로그 파일은 IBM® 지원 센터에서 문제점 해결을 돕는 데 필요합니다.
참고: 로깅 구성을 읽으려면 RPE_HOME 시스템 변수가 정의되어야 합니다.

코어 로그 파일

이 로그 파일은 템플리트 및 문서 스펙에서 문서를 생성하는 동안 발생하는 코어 엔진 관련 문제의 히스토리를 저장합니다. 디버깅 모드 환경 설정을 Yes로 설정한 경우, 코어 로그 파일에서 추가 정보를 볼 수 있습니다. 엔진 환경 설정의 설정을 참조하십시오.

로그 파일은 Document Studio 및 Launcher에 대한 기본 작업공간 디렉토리에 대한 임시 파일에 있습니다. 예: TEMP\RPE\rpe.log

로그 파일의 위치 변경과 같은 사용자 정의에 대한 정보는 코어 로그 파일 사용자 정의를 참조하십시오.

사용자 인터페이스 로그 파일

이 로그 파일은 Rational Publishing Engine Document Studio 및 Rational Publishing Engine Launcher를 사용하는 동안 발생하는 사용자 인터페이스 관련 문제의 히스토리를 저장합니다.
로그 파일은 Document Studio 및 Launcher에 대한 기본 작업공간 디렉토리에 대한 애플리케이션 데이터에 있습니다. 예:
  • APPDATA\IBM\Rational\RPE_date\Launcher\workspace\.metadata\.log
  • APPDATA\IBM\Rational\RPE_date\Studio\workspace\.metadata\.log

피드백