출력이 파일 또는 표준 출력으로 전달되도록 지정할 수 있습니다. 이 명령에 의해 리턴되는 레코드는 XML 형식이므로 XML 브라우저를 사용하여 찾아볼 수 있습니다. 출력을 파일로 전달하는 경우, 데이터는 utf-8 코드 페이지로 기록됩니다. 파일은 플랫폼에 종속되지 않으므로, 다른 시스템으로 전송한 후 mqsiformatlog 명령을 사용하여 찾아보거나 형식화할 수 있습니다.
HP-UX에서 mqsichangetrace명령의 size 매개변수를 500MB 미만으로 설정해야 합니다. XML 생성 파일 크기는 원본 추적 파일의 50%이상 크기 때문에 size 매개변수 값을 500MB 이상으로 설정하면 문제가 발생할 수 있습니다.
이 파일을 다른 시스템으로 전송하는 경우, 데이터를 변환하지 않는 파일 전송 프로그램을 사용하는지 확인하십시오(예를 들면, 2진 전송 옵션 지정).
브로커 또는 브로커의 자원(실행 그룹 또는 메시지 플로우)을 지정하는 경우, 추적을 시작하여 로그 파일을 읽기 전에 이를 전개해야 합니다.
mqsiformatlog 명령을 사용하여 로그를 형식화하려면 파일 이름을 지정해야 합니다. 파일 이름을 지정하지 않으면, 로그 컨텐츠가 표준 출력에 기록됩니다. 파일 확장자로 .xml을 사용하도록 권장됩니다.
이 옵션을 지정하는 경우, mqsireadlog 명령을 사용하기 전에 추적을 정지하십시오(mqsichangetrace 사용). 이 플래그를 지정하여 명령을 발행할 때 로그 파일이 사용 중이면, XML 레코드의 일부가 리턴될 수 있습니다. mqsichangetrace 명령에서 -m safe를 지정하면 이러한 일이 발생하는 위험을 줄일 수 있습니다. 추적 중인 구성요소가 자동으로 정지되면, mqsichangetrace 명령을 실행할 필요가 없습니다.
이 명령을 실행하기 전에 추적을 정지하지 않는 경우, 형식화 명령으로 부분 레코드를 읽을 수 없으므로 mqsiformatlog 명령을 사용하기 전에 작성된 로그 파일의 컨텐츠를 점검한 후 텍스트 편집기를 사용하여 끝에서 부분 레코드를 제거하십시오.
IBM 지원 센터 또는 BIPxxxx 메시지에 의해 지시된 경우에만 이러한 옵션을 사용하십시오.
다음 표에서는 서비스 추적에 대한 qualifier와 component의 올바른 결합을 보여줍니다.
일반적으로, 이 옵션은 명령 자체를 추적하는 데 사용됩니다. 특정 명령을 추적하려면, 명령을 실행하여 생성된 추적 출력을 읽기 전에 환경 변수 MQSI_UTILITY_TRACE를 디버그 또는 정상으로 설정하여 해당 명령을 실행하십시오.
표시된 대로 값을 입력하십시오.
에이전트 추적은 mqsichangetrace 명령에 -b 플래그를 지정할 때 시작됩니다. WebSphere Message Broker 오류 메시지 또는 IBM 지원 센터가 지시한 경우에만 이를 수행하십시오.
mqsireadlog <brokername> -t -b service -f -o service.xmlWebSphere Message Broker 오류 메시지 또는 IBM 지원 센터가 지시한 경우에만 이를 수행하십시오.
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 |
UNIX 플랫폼에서 사용자 ID는 mqbrkrs 그룹의 구성원이어야 합니다. -f 플래그를 지정하는 경우, 이 명령을 호출하는 데 사용되는 사용자 ID에는 추적 파일의 액세스 권한도 있어야 합니다.
Windows 플랫폼에서 -f 플래그를 지정하는 경우, 이 명령을 호출하는 데 사용되는 사용자 ID에는 추적 파일의 액세스 권한이 있어야 합니다. -f 플래그를 지정하지 않으면, 이 명령을 발행하는 데 사용되는 사용자 ID는 mqbrkrs 권한을 가져야 합니다.
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 편집기 또는 표시기를 사용하여 이 파일을 볼 수 있습니다.