z/OS 로그스트림

z/OS® 시스템 로거는 로그스트림이라 불리는 데이터 집합을 제공하며, 이는 로컬 저장소 버퍼에 기록된 후 장기 저장을 위해 시스템 복합체 결합 시설(sysplex coupling facility) 또는 시스템 복합체 저장소( DASD )로 전송됩니다. 로그 스트림은 특정 애플리케이션에 대해 고성능 로깅을 제공할 수 있습니다.

로그스트림에 대한 일반적인 정보는 z/OS 를 참조하십시오. Sysplex 설정( SA22-7625 ).

WebSphere® Application Server for z/OS 다음 유형의 데이터에 대해 로그스트림을 사용할 수 있습니다:
  • WebSphere Application Server 의 오류 로그 데이터는 인쇄 데이터셋 대신 로그스트림으로 라우팅될 수 있습니다
  • WebSphere Application Server 의 트랜잭션 로그 데이터는 계층적 파일 시스템(HFS) 데이터셋 대신 로그스트림으로 라우팅될 수 있습니다
  • WebSphere Application Server 세션 개시 프로토콜(SIP) 복구 로그의 데이터는 로그스트림으로 라우팅됩니다

WebSphere Application Server 오류 로그

WebSphere Application Server 오류 로그는 자세한 런타임 오류 및 상태 메시지를 기록하는 데 사용됩니다. ras_log_logstreamName 변수가 설정된 경우, 오류 로그 메시지는 지정된 z/OS 로그 스트림에 기록됩니다. ras_log_logstreamName 변수를 설정하지 않았거나 이름 지정된 로그 스트림이 없는 경우, STDERR에 오류 로그 레코드가 작성됩니다.

WebSphere Application Server 의 오류 로그를 z/OS 로그스트림으로 전송하는 주요 이점은 여러 서버 및 서번트 지역의 오류 로그를 통합할 수 있다는 점입니다. 오류 로그 스트림을 결합 기능에 배치하는 경우에도 동일한 Sysplex에 있는 서로 다른 시스템의 오류 로그를 통합할 수 있습니다.

WebSphere Application Server for z/OS는 오류 로그 스트림을 작성할 수 있도록 다음과 같은 샘플 작업을 제공합니다.
BBOERRLC
WebSphere Application Server 오류 로그용 커플링 시설 로그스트림 생성
BBOERRLD
WebSphere Application Server 오류 로그 전용으로 DASD 로그 스트림 생성
copyZOS.sh 스크립트를 사용하여 이러한 작업을 파티션된 데이터 세트에 기록하십시오.

로그 스트림을 작성한 후, 스크립트 또는 관리 콘솔을 사용하여 ras_log_logstreamName 변수를 출력이 새로 작성된 로그 스트림으로 이동하는 모든 서버의 로그 스트림 이름으로 설정하십시오.

오류 로그를 보려면 SBBOEXEC 프로파일 데이터 세트의 BBORBLOG 스크립트를 사용하십시오. 자세한 정보는 로그 찾아보기 유틸리티를 사용하여 오류 로그 내용 보기 주제를 읽으십시오.

트랜잭션 XA 상대 로그

WebSphere Application Server 트랜잭션 XA 상대 로그는 트랜잭션(JTA) 정보를 기록하는 데 사용됩니다. 이 정보는 특정 서버의 트랜잭션 디렉터리 파일 설정에 따라 HFS 파일 또는 z/OS 로그스트림에 기록됩니다:
  • 트랜잭션 디렉토리 값이 dir://directory_name인 경우, 이름 지정된 파일 시스템 디렉토리에 트랜잭션 정보가 저장됩니다.
  • 트랜잭션 디렉토리 값이 logstream://logstream_name인 경우, 이름 지정된 로그 스트림에 트랜잭션 정보가 작성됩니다.
기본값은 dir://app_server_root/tranlog/server_name입니다.

z/OS 로그스트림을 WebSphere Application Server 트랜잭션 로그에 사용하고 해당 로그스트림을 커플링 시설에 배치함으로써, 시스템 간 재시작 작업의 성능을 향상시킬 수 있습니다.

WebSphere Application Server for z/OS SBBOJCL 제품 데이터셋에서 트랜잭션 로그스트림을 생성하기 위한 다음 샘플 작업을 제공합니다:
BBOTXALC
WebSphere Application Server 트랜잭션 로그에 대한 결합 기능 로그스트림 생성
BBOTXALD
WebSphere Application Server 트랜잭션 로그 전용으로 DASD 로그스트림 생성
copyZOS.sh 스크립트를 사용하여 이러한 작업을 파티션된 데이터 세트에 기록하십시오.

로그 스트림을 작성한 후, 관리 콘솔을 사용하여 개별 서버의 트랜잭션 로그를 서버의 트랜잭션 서비스 설정의 구성 탭에 있는 logstream://logstream_name으로 설정(서버 > 서버 유형 > WebSphere Application Server > server_name > 컨테이너 서비스 > 트랜잭션 서비스)한 후 서버를 다시 시작하십시오. 자세한 정보는 트랜잭션 서비스 설정 주제를 읽으십시오.

참고: 애플리케이션 서버가 네트워크 배포 셀에 연동될 때 기존 트랜잭션 오류를 모두 제거해야 합니다. z/OS 로그스트림에 트랜잭션 로깅이 수행 중인 경우, 애플리케이션 서버를 종료한 후 서버의 트랜잭션 로그스트림을 삭제하고 새로 연동된 애플리케이션 서버를 시작하기 전에 이를 다시 생성하십시오.

SIP 복구 로그 스트림 작성

Network Deployment 셀 구성에 여러 LPAR의 복제 파트너가 포함되는 경우 SIP 복구 로그 스트림이 연결 기능에 상주해야 합니다. DASD 복구 로그 스트림은 모든 복제 파트너가 동일한 LPAR에 있는 경우에만 사용할 수 있습니다.

SIP 로그 스트림은 이름에 대한 매우 구체적인 패턴을 따라야 합니다(CELL_NAME.SERVER_NAME.D 및 CELL_NAME.SERVER_NAME.M).

로그 스트림이 가득 차 있거나 손상되었음을 나타내는 오류가 발생할 수 있습니다. 이 경우, 로그 스트림을 삭제한 후 재정의해야 할 수도 있습니다. 다음 예에서는 이러한 조치를 수행하기 위해 사용할 수 있는 작업을 보여줍니다.

로그스트림 삭제:
//DEFLOGA  JOB MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M 
//*                            
//LOGDEFN  EXEC PGM=IXCMIAPU,REGION=4M      
//SYSPRINT DD   SYSOUT=*       
//*                            
//SYSIN    DD   *              
     DATA TYPE(LOGR)           
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S000.M)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S000.D)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S001.M)   
     DELETE LOGSTREAM          
     NAME(WT0CELL.WT0S001.D)
/*
로그스트림 재구성:
//DEFLOGA  JOB MSGLEVEL=(1,1),MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M  
//*                                
//LOGDEFN  EXEC PGM=IXCMIAPU,REGION=4M             
//SYSPRINT DD   SYSOUT=*           
//*                                
//SYSIN    DD   *
     DATA TYPE(LOGR)
     DEFINE LOGSTREAM 
     NAME(WT0CELL.WT0S000.M)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60)
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S000.D)     
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60) 
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S001.M)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60) 
     HIGHOFFLOAD(80)
     DEFINE LOGSTREAM
     NAME(WT0CELL.WT0S001.D)
     DASDONLY(YES)
     HLQ(LOCAL) MODEL(NO)
     LS_SIZE(2048)
     STG_SIZE(2048)
     LOWOFFLOAD(60)    
     HIGHOFFLOAD(80)       
/*     
//