[z/OS]

최적화된 로컬 어댑터에 추적 사용

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로 설정하여 등록이 수행될 때 프로그램 연결의 수명에 대해 추적을 설정할 수 있습니다.

이 태스크 정보

프로시저

  1. 추적 레벨을 미리 정의하십시오. 추적 레벨을 사전 정의하면 이미 최적화된 로컬 어댑터 초기화 시 등록 및 연결 추적 데이터를 캡처할 준비가 완료됩니다. 또한 아직 등록되지 않는 연결에 대해 다음 활동에 대한 준비도 완료됩니다. 표시된 등록이 수행될 때 추적이 자동으로 발생합니다. 다음과 같이 추적 레벨을 사전 정의하십시오.
    1. 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 명령은 시스템 기본값이 아닌 다른 등록에 대해 처리된 추적 정의 수를 표시하는 응답 메시지를 발행합니다.
    2. 관리 콘솔에서 WAS_DAEMON_ONLY_ola_trace_settings_file 환경 변수를 작성하십시오.
    3. HFS에서 추적 특성 파일의 완전한 경로 및 파일 이름에 대한 문자열로 변수를 설정하고 변수를 활성화하십시오.
      이 환경 변수가 설정되고 WebSphere Application Server 구성에 저장되면, 특성 파일은 서버 초기화에 처리됩니다. 추적 특성 파일을 업데이트하고, modify SETOLATRACEPROPS 명령을 실행하여 새 정의를 활성화할 수 있습니다. 새 추적 특성은 새 등록에 영향을 줍니다. 구문은 다음과 같습니다.
      F daemonname,SETOLATRACEPROPS 
      주의: 추적 설정 특성 파일을 활성화하면 현재 활성 추적 특성도 비활성화됩니다.
  2. 기존 연결에 대해 추적 설정을 수정하십시오. 최적화된 로컬 어댑터를 사용하는 현재 연결에 대해, 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 명령은 영향을 받는 등록 수를 나타내는 응답 메시지를 표시합니다.

  3. 등록 시 추적 설정을 지정하십시오. 최적화된 로컬 어댑터에 대한 등록을 작성하기 위해 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"로 설정된 상태로 유지하면 사전 정의 또는 기본값의 설정에 관계없이 추적은 강제로 사용되지 않습니다.


주제 유형을 표시하는 아이콘 태스크 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_usetraceinfoola
파일 이름:tdat_usetraceinfoola.html