FFDC(First Failure Data Capture) 레코드는 XMS에서 발생할 수 있는 문제점을 진단하는 데 도움이 되는 정보를 제공합니다. 오류의 원인을 찾는 데 추가 정보가 필요한 경우 IBM Support Center에서 추적을 생성할 것인지 물을 수 있습니다.
XMS 아래에서 설명하는 바와 같이 XMS 환경 변수를 구성하여 대체 위치를 지정하지 않은 경우 현재 작업 디렉토리에 FFDC 레코드와 추적 파일을 작성합니다. FFDC 레코드는 사람이 읽을 수 있는 텍스트 파일에 접두부 xmsffdc로 시작되는 이름으로 저장됩니다. 추적 파일은 2진이며 형식화될 수 있습니다. 추적 파일 이름은 접두부 xms로 시작됩니다.
XMS C 또는 C++ 응용프로그램에 대한 추적을 구성하려면 응용프로그램을 실행하기 전에 다음 XMS 환경 변수를 설정하십시오.
환경 변수 | 기본값 | 설정 | 의미 |
---|---|---|---|
XMS_TRACE_ON | 적용 불가능 | 표준 | 선택된 구성요소가 추적됩니다. |
전체 | 모든 구성요소가 추적됩니다. | ||
부분 | 추적할 구성요소 ID의 쉼표 구분 목록. 예를 들어 "partial,osa,cal"은 XMS 구성요소 gxiosa와 gxical만 추적합니다. 추적할 수 있는 구성요소를 표시하려면 전체 추적을 사용하십시오. | ||
XMS_TRACE_FILE_PATH | 현재 작업 디렉토리 | /dirpath/ | 추적과 FFDC 레코드가 쓰여지는 디렉토리 경로. XMS XMS FFDC와 추적 파일을 작성할 디렉토리의 완전한 경로 이름으로 환경 변수 XMS_TRACE_FILE_PATH를 설정하여 대체 위치를 지정하지 않는 한, 현재 작업 디렉토리에 FFDC와 추적 파일을 작성합니다. 이 환경 변수는 추적할 응용프로그램을 시작하기 전에 설정해야 하므로 응용프로그램이 실행되는 사용자 ID에 XMS FFDC와 추적 파일을 작성하는 디렉토리에 쓸 수 있는 권한이 있는지 확인해야 합니다. |
XMS_TRACE_FILE_SIZE | 200000 | 정수 | XMS 제품 추적이 늘어날 수 있는 최대 크기(킬로바이트), 10은 10,000바이트를 표시합니다. |
XMS_TRACE_FILE_NUMBER | 4 | 정수 | 추적 레코드를 저장하는 데 사용할 수 있는 파일 수. (200000 / 4 = 파일당 50000바이트) |
추적을 동적으로 구성하려면 실행 파일 gxisc를 사용하십시오. gxisc를 사용하여 실행 중인 XMS C 또는 C++ 응용프로그램에서 추적을 사용 가능 및 사용 불가능하게 할 수 있으며 추적 크기를 수정할 수 있습니다. gxisc는 XMS 응용프로그램과 같은 시스템에서 실행해야 합니다.
gxisc를 호출하려면 아래 예에 표시된 것처럼 추적 구성을 변경할 XMS 응용프로그램의 프로세스 ID를 사용하십시오.
gxisc 1234 <enter> display all <enter> alter trace(enabled) tracesize(100) <enter> help <enter> alter trace(disabled) <enter> alter <enter> end gxisc <enter> alter pid(1234) trace(enabled) <enter> end cat a.file <enter> alter pid(1234) trace(enabled) end cat a.file | gxisc <enter> cat b.file <enter> alter trace(disabled) tracesize(1000) end cat b.file | gxisc 1234 <enter>
런타임에 처리와 디스크 오버헤드를 최소화하기 위해 XMS 2진 형식의 추적을 확장자가 .trc인 하나 이상의 추적 파일로 출력합니다. 다음 예에 표시된 것처럼 실행 파일 gxitrcfmt를 사용하여 추적 파일을 형식화할 수 있습니다.
gxitrcfmt xms01234.trc
형식화된 파일에는 접미부 txt가 있습니다. 예를 들면 다음과 같습니다.
cat xms01234.trc.txt
각 추적 라인에는 다음이 포함됩니다.
추적 레코드는 함수 시작점(‘{'으로 표시), 함수 종료점(‘}'으로 표시) 또는 함수 데이터 포인트입니다.