mqsireadlog 명령

지원되는 플랫폼

  • Windows
  • Linux 및 UNIX 시스템
  • BIPRELG 유틸리티를 사용하는 z/OS는 브로커 PDSE 컨텐츠를 참조하십시오.

목적

mqsireadlog 명령을 사용하여 지정된 구성요소에 대한 추적 로그를 검색할 수 있습니다. 이 명령은 다음에 대해 사용할 수 있습니다.
사용자 추적
-u 옵션을 지정하십시오.
서비스 추적
-t 옵션을 지정하십시오. BIPxxxx 메시지에 설명된 조치 또는 IBM 지원 센터가 지시한 경우에만 이 옵션을 사용하도록 권장됩니다.

출력이 파일 또는 표준 출력으로 전달되도록 지정할 수 있습니다. 이 명령에 의해 리턴되는 레코드는 XML 형식이므로 XML 브라우저를 사용하여 찾아볼 수 있습니다. 출력을 파일로 전달하는 경우, 데이터는 utf-8 코드 페이지로 기록됩니다. 파일은 플랫폼에 종속되지 않으므로, 다른 시스템으로 전송한 후 mqsiformatlog 명령을 사용하여 찾아보거나 형식화할 수 있습니다.

HP-UX에서 mqsichangetrace명령의 size 매개변수를 500MB 미만으로 설정해야 합니다. XML 생성 파일 크기는 원본 추적 파일의 50%이상 크기 때문에 size 매개변수 값을 500MB 이상으로 설정하면 문제가 발생할 수 있습니다.

이 파일을 다른 시스템으로 전송하는 경우, 데이터를 변환하지 않는 파일 전송 프로그램을 사용하는지 확인하십시오(예를 들면, 2진 전송 옵션 지정).

브로커 또는 브로커의 자원(실행 그룹 또는 메시지 플로우)을 지정하는 경우, 추적을 시작하여 로그 파일을 읽기 전에 이를 전개해야 합니다.

구문

사용자 추적

서비스 추적

매개변수

구성요소
(필수) 로그를 읽을 구성요소의 이름. 브로커 이름 또는 구성 관리자 이름 또는 고정값 , UserNameServer, Workbench 또는 utility가 될 수 있습니다(모두 Linux 시스템, UNIX 시스템 및 z/OS에서 대소문자가 구분됨).
-u
(선택사항) 사용자 추적 로그에서 로그 내용을 읽습니다. 이 매개변수는 broker 구성요소를 선택하는 경우에만 유효합니다.
-e egroup
(선택사항) 로그 정보를 읽을 실행 그룹의 레이블
-o outputfilename
(선택사항) 로그 데이터를 기록할 파일의 이름. 전체 경로 이름을 지정하면, 파일이 지정한 디렉토리에 작성됩니다. 파일 이름만 지정하면, 파일이 현재 작업 디렉토리에 작성됩니다. 파일의 컨텐츠는 플랫폼에 종속되지 않는 utf-8 코드 페이지로 기록되며, 이는 DBCS 문자와 같은 데이터를 보존할 수 있습니다.

mqsiformatlog 명령을 사용하여 로그를 형식화하려면 파일 이름을 지정해야 합니다. 파일 이름을 지정하지 않으면, 로그 컨텐츠가 표준 출력에 기록됩니다. 파일 확장자로 .xml을 사용하도록 권장됩니다.

-f
(사용자 추적에는 선택: 서비스 추적에는 필수). 파일 시스템에서 직접 로그 파일을 읽습니다. 이 옵션을 지정하지 않으면, 명령이 구성요소로 XML 메시지를 송신하여 로그 컨텐츠를 요청합니다. -t(서비스 추적)를 지정한 경우, 대개 이 플래그도 지정해야 합니다. 자세한 내용은 서비스 추적에만 사용되는 추가 매개변수에 제공되어 있습니다.

이 옵션을 지정하는 경우, mqsireadlog 명령을 사용하기 전에 추적을 정지하십시오(mqsichangetrace 사용). 이 플래그를 지정하여 명령을 발행할 때 로그 파일이 사용 중이면, XML 레코드의 일부가 리턴될 수 있습니다. mqsichangetrace 명령에서 -m safe를 지정하면 이러한 일이 발생하는 위험을 줄일 수 있습니다. 추적 중인 구성요소가 자동으로 정지되면, mqsichangetrace 명령을 실행할 필요가 없습니다.

이 명령을 실행하기 전에 추적을 정지하지 않는 경우, 형식화 명령으로 부분 레코드를 읽을 수 없으므로 mqsiformatlog 명령을 사용하기 전에 작성된 로그 파일의 컨텐츠를 점검한 후 텍스트 편집기를 사용하여 끝에서 부분 레코드를 제거하십시오.

서비스 추적에만 사용되는 추가 매개변수

IBM 지원 센터 또는 BIPxxxx 메시지에 의해 지시된 경우에만 이러한 옵션을 사용하십시오.

-t
(필수) 서비스 추적 로그에서 로그 컨텐츠를 읽습니다.
-b qualifier
(필수) 브로커 agent, 구성 관리자 agent 또는 사용자 이름 서버 agent 또는 지정한 명령 유틸리티 프로그램에 대한 로그 컨텐츠를 읽습니다. 이 옵션은 -t(서비스 추적)를 지저한 경우에만 유효합니다.

다음 표에서는 서비스 추적에 대한 qualifiercomponent의 올바른 결합을 보여줍니다.

일반적으로, 이 옵션은 명령 자체를 추적하는 데 사용됩니다. 특정 명령을 추적하려면, 명령을 실행하여 생성된 추적 출력을 읽기 전에 환경 변수 MQSI_UTILITY_TRACE디버그 또는 정상으로 설정하여 해당 명령을 실행하십시오.

표시된 대로 값을 입력하십시오.

에이전트 추적은 mqsichangetrace 명령에 -b 플래그를 지정할 때 시작됩니다. WebSphere Message Broker 오류 메시지 또는 IBM 지원 센터가 지시한 경우에만 이를 수행하십시오.

서비스 추적은 mqsichangetrace 명령에 -b 플래그를 지정할 때 시작됩니다. 명령의 형식은 다음과 같습니다.
mqsireadlog <brokername> -t -b service -f -o service.xml
WebSphere Message Broker 오류 메시지 또는 IBM 지원 센터가 지시한 경우에만 이를 수행하십시오.
-f
(필수) 파일 시스템에서 직접 로그 파일을 읽습니다. 이 플래그를 서비스 추적과 함께 사용하는 경우, 사용자 추적과 함께 사용할 때와 특성이 같습니다. -e 플래그를 지정하는 경우에는 선택적이지만 -b 플래그를 지정하는 경우에는 이 옵션을 지정해야 합니다.
Qualifier 구성요소= <broker_name> 구성요소= ConfigMgr_name 구성요소= UserNameServer 구성요소= Workbench 구성요소= utility
mqsichangebroker x        
mqsichangeconfigmgr   x      
mqsichangetrace x x x    
mqsichangeusernameserver     x    
mqsiclearmqpubsub x        
mqsicreateaclentry         x
mqsicreatebroker x        
mqsicreateconfigmgr   x      
mqsicreateusernameserver     x    
mqsideleteaclentry         x
mqsideletebroker x        
mqsideleteconfigmgr   x      
mqsideleteusernameserver     x    
mqsiformatlog1         x
mqsijoinmqpubsub   x      
mqsilist2   x     x
mqsilist x        
mqsilistaclentry         x
mqsireadlog x x x   x
mqsireporttrace   x   x  
mqsistart x x x    
mqsistop x x x    
agent x x x    
서비스 x x x    
Workbench       x  
httplistener x        
주:
  1. 이 명령에는 구성요소 매개변수가 없으므로, 추적 정보는 유틸리티 구성요소 추적 파일에 기록되고 이 파일에서 검색됩니다. 자세한 내용은 mqsichangetrace 명령을 참조하십시오.
  2. 이 명령을 구성요소 없이 호출하면, 추적 정보는 구성요소 특정 파일 이외에 유틸리티 추적 파일에 기록되고 이 파일에서 검색됩니다. 자세한 내용은 mqsichangetrace 명령을 참조하십시오.

권한 부여

UNIX 플랫폼에서 사용자 ID는 mqbrkrs 그룹의 구성원이어야 합니다. -f 플래그를 지정하는 경우, 이 명령을 호출하는 데 사용되는 사용자 ID에는 추적 파일의 액세스 권한도 있어야 합니다.

Windows 플랫폼에서 -f 플래그를 지정하는 경우, 이 명령을 호출하는 데 사용되는 사용자 ID에는 추적 파일의 액세스 권한이 있어야 합니다. -f 플래그를 지정하지 않으면, 이 명령을 발행하는 데 사용되는 사용자 ID는 mqbrkrs 권한을 가져야 합니다.

응답

  • BIP8020 데이터베이스에 액세스할 수 없습니다.
  • BIP8029 브로커 구성이 아직 전개되지 않았습니다.
  • BIP8032 큐에 연결할 수 없습니다.
  • BIP8033 XML 메시지를 송신할 수 없습니다.
  • BIP8035 시간 종료 전에 응답이 수신되지 않았습니다.
  • BIP8036 부정적 응답이 수신되었습니다.
  • BIP8037 지원되지 않는 플래그가 선택되었습니다.
  • BIP8038 지원되지 않는 명령 옵션입니다.
  • BIP8039 실행 그룹을 사용할 수 없습니다.
  • BIP8040 데이터베이스에 연결할 수 없습니다.
  • BIP8132 올바르지 않은 규정자입니다.

WBRK_BROKER 브로커에 대한 사용자 추적:

mqsireadlog WBRK_BROKER -u -e default -o trace.xml

ConfigMgr 구성요소에 대한 서비스 추적:

mqsireadlog ConfigMgr -t -b agent -f -o trace.xml

mqsiformatlog 유틸리티에 대한 서비스 추적:

mqsireadlog utility -t -b agent -f -o trace.xml

mqsiformatlog 명령을 사용하여 로그 파일(위의 예에서 trace.xml)을 형식화하거나, XML 편집기 또는 표시기를 사용하여 이 파일을 볼 수 있습니다.

관련 태스크
로그 사용
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an07300_