WebSphere® Application
Server for z/OS®는 최적화된 로컬 어댑터 추적 레벨 설정을 위한 지원을 제공하여 애플리케이션, 연결
또는 서버 진단을 보조합니다. 추적 레벨은 자세한 데이터, 대략적인 데이터 또는 추적이 없는 데이터를 캡처하기 위한
세 가지 레벨로 설정할 수 있습니다. 이 레벨은 추적 레벨 2, 1, 0으로 지정됩니다.
시작하기 전에
최적화된 로컬 어댑터에서의 동적 추적 지원은 서버를 다시 시작하지 않고
기존 추적 레벨을 설정하거나 변경할 다음과 같은 몇 가지 방법을 제공합니다.
- 특성 파일에서 서버 전반의 추적을 사전에 정의합니다. 그러면
최적화된 로컬 어댑터 처리가 추적이 사용되는 상태에서 즉시 준비 완료되도록,
서버 시작 시 추적 세트가 정의됩니다. WebSphere Application
Server for z/OS 관리 콘솔 및 system modify SETOLATRACEPROPS 명령을 사용하여 특성 파일을 지정하고 활성화할 수 있습니다.
- 추적 레벨을 정의합니다. 최적화된 로컬 어댑터에 아직 등록되지 않은 연결에 대해
서버 전반의 기본 추적 레벨과 개별적인 추적 레벨을 지정하기 위해
추적 특성 파일을 사용할 수 있습니다. 추적 레벨은 특성 파일에서 항목마다
0, 1 또는 2로 설정할 수 있습니다.
- z/OS operator modify
SETOLATRACE 명령을 사용하여 기존 등록을 위한 특정 추적 레벨을 설정하십시오.
이 명령은 서버 제어 스토리지에서 등록 이름, 작업 이름 또는 특정
등록 항목 제어 블록(RGE)에 대한 추적 레벨도 설정할 수 있습니다.
- 여러 연결 그룹에 대한 설정을 표시하기 위해 추적 특성 파일과
SETOLATRACE modify 명령 둘 다에서 와일드카드 문자로 별표(*) 기호를 사용합니다.
와일드카드 기능은 특성 파일 또는 시스템 기본값에서 여러 등록 이름을 지정할 수 있고,
modify SETOLATRCE 명령에서 여러 등록 이름과 작업 이름을 설정할 수 있습니다.
- 또한 최적화된 로컬 어댑터를 사용하는 애플리케이션의 개발자가
호출에서 추적 플래그를 BBOA1REG로 설정하여 등록이 수행될 때
프로그램 연결의 수명에 대해 추적을 설정할 수 있습니다.
프로시저
- 추적 레벨을 미리 정의하십시오. 추적 레벨을 사전 정의하면
이미 최적화된 로컬 어댑터 초기화 시 등록 및 연결 추적 데이터를
캡처할 준비가 완료됩니다. 또한 아직 등록되지 않는 연결에 대해 다음 활동에 대한 준비도 완료됩니다.
표시된 등록이 수행될 때 추적이 자동으로 발생합니다.
다음과 같이 추적 레벨을 사전 정의하십시오.
- HFS에서 추적 특성 파일을 작성하십시오. 이 파일은 z/OS용 WebSphere Application Server 디먼에 의해
액세스 가능하고 EBCDIC으로 되어 있어야 합니다.
추적 특성 파일 구문은
<
keyword>=<
parameter>의
WebSphere Application
Server 특성 파일 구문을 따릅니다.
이 경우 특성 구문은 다음과 같습니다.
<registration_name>=<trace_level>
여기서:
<registration_name>은 영숫자 문자열입니다.
<trace_level>은 0, 1 또는 2입니다.
명료성을 위해, 등록 이름을 표시할 때 작은따옴표나 큰따옴표 스타일 구문을
사용할 수 있습니다. 예를 들면 다음과 같습니다.
MYREGNAME=1 "CICSREG"=2 'SHORTREG'=0
또한 와일드카드 문자로
별표를 사용하여 이름이 유사한 등록을 하나의 행으로 그룹화할 수도 있습니다. 예를 들면 다음과 같습니다.
REGNAME*=1 *NAME=2 "REG*NAME"=0
선행 # 문자는
따옴표 문자열 내에 없으면 주석의 시작을 표시합니다.
중요사항: - 올바르지 않은 추적 레벨은 0으로 처리됩니다. 예를 들어 REGNAME=ALL은
추적 레벨 0으로 처리됩니다.
- "*"의 등록 이름은 기본 추적 레벨로 처리됩니다.
예를 들어, *=1이 지정된 경우 새 등록에 대한 기본값은 추적의
대략적(coarse) 레벨입니다.
- 특성 파일은 최대 1,024개 추적 스펙을 보유할 수 있습니다.
SETOLATRACEPROPS 명령은 시스템 기본값이 아닌 다른 등록에 대해
처리된 추적 정의 수를 표시하는 응답 메시지를 발행합니다.
- 관리 콘솔에서 WAS_DAEMON_ONLY_ola_trace_settings_file 환경 변수를
작성하십시오.
- HFS에서 추적 특성 파일의 완전한 경로 및 파일 이름에 대한 문자열로
변수를 설정하고 변수를 활성화하십시오.
이 환경 변수가 설정되고
WebSphere Application Server 구성에 저장되면,
특성 파일은 서버 초기화에 처리됩니다.
추적 특성 파일을 업데이트하고, modify SETOLATRACEPROPS 명령을 실행하여
새 정의를 활성화할 수 있습니다. 새 추적 특성은 새 등록에 영향을 줍니다.
구문은 다음과 같습니다.
F daemonname,SETOLATRACEPROPS
주의: 추적 설정 특성 파일을 활성화하면 현재 활성 추적 특성도
비활성화됩니다.
- 기존 연결에 대해 추적 설정을 수정하십시오. 최적화된 로컬 어댑터를
사용하는 현재 연결에 대해, modify SETOLATRACE 명령으로 추적을 켜거나
끌 수 있습니다. 명령 양식은
다음과 같습니다.
F servername,SETOLATRACE=tracelevel,REGNAME=namestring
F servername,SETOLATRACE=tracelevel,JOBNAME=namestring
F servername,SETOLATRACE=tracelevel,RGE=hexaddress
추적 레벨은
0, 1 또는 2이며, 순서대로 추적 없음, 대략적인 추적 및 상세 추적입니다.Namestring은 수정할 기존 등록의 작업 이름이나 등록 이름을 지정합니다.
namestring은 일치하는 작은따옴표나 큰따옴표로 구분할 수 있습니다.
마찬가지로, 유사하게 이름 지정된 두 개 이상의 작업 또는 등록을
수정하기 위해 와일드카드 문자로 별표를 사용할 수 있습니다. 단독 별표는
기존의 모든 등록에 영향을 줍니다. 다음 명령 중 하나를 사용하여
현재 등록의 모든 추적을 끌 수 있습니다.
F servername,SETOLATRACE=0,REGNAME=*
F servername,SETOLATRACE=0,JOBNAME=*
서버 제어 스토리지에서 RGE의 주소에 의해
특정 등록을 대상으로 지정할 경우, 명령의 RGE=hexaddress 양식을 사용할 수 있습니다. 16진 주소는 따옴표로 묶이지 않은 16진 문자열입니다. 이 방법은 IBM® 지원 센터 팀이 사용자에게 사용하도록 지시할 수 있는 방법입니다.
SETOLATRACE 명령은
영향을 받는 등록 수를 나타내는 응답 메시지를 표시합니다.
- 등록 시 추적 설정을 지정하십시오. 최적화된 로컬 어댑터에 대한
등록을 작성하기 위해 BBOA1REG API를 호출하는 코드로 추적을 요청할 수 있습니다.
BBOA1REG와의 인터페이스에는 registerflags 매개변수가 포함됩니다.
등록을 위한 추적 레벨 설정은 registerflags 매개변수로 다음 값 중 하나 이상을 설정하여
수정될 수 있습니다.
reg_flag_trcmod EQU X'80000000' modify trace level
reg_flag_trcmore EQU X'40000000' trace level=2
reg_flag_trcsome EQU X'20000000' trace level=1
등록에 대한 추적 설정을
수정하려는 경우 reg_flag_trcmod를 설정하십시오. 이 플래그를 설정하지 않으면,
추적 설정의 어떤 변경사항도 작성되지 않고 등록 이름이나 작업 이름에 적용되는 사전 정의된 추적 설정이나
시스템 기본값이 사용됩니다.
자세한 추적이나 대략적 레벨 추적을 원하면
reg_flag_trcmore 또는 reg_flag_trcsome을 설정하십시오.
두 레벨 모두를 "off"로 설정된 상태로 유지하면
사전 정의 또는 기본값의 설정에 관계없이 추적은 강제로 사용되지 않습니다.