mqsichangetrace 명령

지원되는 플랫폼

  • Windows
  • Linux 및 UNIX 시스템
  • z/OS

목적

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

브로커에 대한 사용자 추적을 시작, 수정 또는 종료하거나, 브로커, 구성 관리자 또는 사용자 이름 서버(구성요소 이름으로 식별됨)에 대한 서비스 추적을 시작, 수정 또는 종료할 수 있습니다. 이 명령을 사용하여 Workbench에 대한 서비스 추적을 시작할 수는 없습니다.

Windows 플랫폼, Linux 및 UNIX 시스템에서는 Workbench의 기능을 사용하여 실행 그룹 및 메시지 플로우에 대한 추적 활동을 시작하고 정지할 수도 있습니다. 자세한 정보는 사용자 추적을 참조하십시오.

z/OS에서 콘솔 명령을 사용하거나 Workbench의 기능을 사용하여 추적을 시작, 수정 또는 정지할 수도 있습니다.

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

이러한 명령에 의해 생성된 추적 출력은 log 서브디렉토리의 추적 파일에 기록됩니다. 추적할 작업이 완료되면, mqsireadlog를 사용하여 로그를 XML 형식 파일로 검색하십시오. mqsiformatlog(형식화된 파일 생성) 또는 XML 브라우저를 사용하여 XML 레코드를 보십시오.

추적을 설정하면, 추적할 구성요소의 모든 작동에 대해 추가 처리가 실행됩니다. 추적이 활성화되면 성능에 어느 정도의 영향을 미칩니다.

명령 프로세스 자체를 추적하려면, 추적을 시작하기 전에 MQSI_UTILITY_TRACE and MQSI_UTILITY_TRACESIZE 환경 변수를 설정하십시오.

선택된 명령을 위한 추적이 완료되면 이 변수를 재설정해야 합니다. 재설정하지 않으면, 이후에 실행하는 모든 명령도 추적되며 성능이 저하됩니다.

구문

Windows 플랫폼, Linux 및 UNIX 시스템

사용자 추적

서비스 추적

z/OS

사용자 추적

서비스 추적

매개변수

구성요소
(필수 - Windows 플랫폼, Linux 및 UNIX 시스템) 추적 매개변수를 변경할 구성요소의 이름. 브로커 이름 또는 구성 관리자, 도는 고정 값, UserNameServer (모두 UNIX 시스템 및 Linux에서 대소문자 구분됨).

변경 시작키워드 Workbenchutility가 예약되며, 구성요소 이름으로 사용하지 않아야 합니다.변경 끝

-u
변경 시작(구성요소가 브로커인 경우 사용자 추적에만 필요) 사용자 추적 옵션이 수정되도록 지정합니다. 이 옵션은 다음을 수행한 경우에만 사용할 수 있습니다.
  • Windows 플랫폼, Linux 및 UNIX 시스템에서 브로커 이름을 구성요소 이름으로 지정했습니다.
  • z/OS에서 브로커에 대해 이 명령을 실행했습니다(즉, 구성 관리자 또는 사용자 이름 서버가 아님).
.변경 끝
-e egName
변경 시작(사용자 추적에 대해서는 필수; 서비스 추적에 대해서는 선택사항) 추적 옵션을 수정할 실행 그룹을 식별합니다(예: 시작 또는 정지). 이 옵션은 브로커에 대해서만 사용할 수 있습니다.

z/OS에서, 이 이름은 대소문자가 구분되므로 이름에 대소문자가 혼용되어 있는 경우에는 이름을 작은 따옴표로 묶어야 합니다.

변경 끝
-f messageflow
(선택사항) 추적 옵션을 수정할 메시지 플로우를 식별합니다. 이 옵션은 실행 그룹(플래그 -e)을 지정한 경우에만 사용할 수 있습니다.

z/OS에서, 이 이름은 대소문자가 구분되므로 이름에 대소문자가 혼용되어 있는 경우에는 이름을 작은 따옴표로 묶어야 합니다.

-r
(선택사항) 이 옵션은 추적 로그를 재설정하도록 요청합니다. 즉, 현재 레코드가 모두 제거됩니다. 새 추적을 시작할 때 이 옵션을 사용하여 로그의 모든 레코드가 새 추적에 대해 고유한지 확인하십시오.

이 옵션은 실행 그룹(플래그 -e)을 지정한 경우에만 사용할 수 있습니다.

-l level
(선택사항) 추적 레벨을 설정하십시오. 레벨은 다음 중 하나여야 합니다.
  • 정상. 기본 레벨의 추적 정보를 제공합니다.
  • 없음. 추적을 해제합니다.
  • 디버그. 더 포괄적인 추적 정보를 제공합니다.

각 구성요소는 디폴트 값 없음으로 작성됩니다. 이 매개변수를 지정하지 않으면 현재 값이 변경되지 않습니다. 이 값이 성공적으로 변경되면 지속적으로 사용됩니다.

이 옵션은 모든 구성요소에 대해 사용할 수 있습니다.

-m mode
(선택사항) 추적 정보의 버퍼링 방법을 나타냅니다.
  • safe. 이 모드에서는 추적 항목이 생성될 때 파일에 기록됩니다.
  • fast. 이 모드에서는 추적 항목이 버퍼링되고 배치로 파일에만 기록됩니다.

각 구성요소는 디폴트 값 safe로 시작됩니다. 이 매개변수를 지정하지 않으면 현재 값이 변경되지 않습니다.

이 옵션은 지정한 구성요소가 다음인 경우에만 사용할 수 있습니다.
  • 브로커. 이 값을 변경하면, 실행 그룹(지정한 경우) 또는 에이전트 구성요소(실행 그룹을 지정하지 않은 경우)의 추적에 영향을 미칩니다.
  • 사용자 이름 서버. 이 값을 변경하면 전체 구성요소의 추적에 영향을 미칩니다. (서비스 추적에 대해서만 사용할 수 있습니다.) 이 값이 성공적으로 변경되면 지속적으로 사용됩니다.
-c size
(선택사항) 추적 파일 크기(KB 단위). 이 매개변수를 지정하지 않으면 현재 값이 변경되지 않습니다. 각 구성요소는 디폴트 값 4096KB로 시작됩니다. 이 옵션을 지정하여 값을 재설정하십시오. 지정할 수 있는 최대값은 이후에 mqsireadlog 명령을 사용하여 로그를 읽는 방식에 따라 다릅니다.

HP-UX에서 이 값은 500MB 미만으로 설정하도록 권장됩니다.

  • -f 옵션을 설정하여 mqsireadlog 명령을 사용하면, 파일 시스템에서 직접 로그 파일을 읽습니다. 이 경우, 여기에 지정할 수 있는 최대값은 2097151이고, 이 값에 따라 추적 파일을 최고 2GB(기가바이트)까지 작성할 수 있습니다.
  • -f 옵션을 설정하지 않고 mqsireadlog 명령을 사용하면, 로그를 검색하기 위해 WebSphere MQ 메시지가 브로커로 송신됩니다. 이 경우, 추적 파일의 크기는 70MB(메가바이트)를 초과하면 안 됩니다. 여기에 설정할 수 있는 최대값은 분명히 70000보다 커서는 안 됩니다.

그러나, 추적 파일을 검색하려는 경우, 이 매개변수에 작은 값을 사용하거나 이 명령에서 재설정(-r) 옵션을 사용하여 파일 크기를 가능한 한 작게 유지하여 추적 로그를 지우도록 권장됩니다. 이 방법을 사용하는 경우의 이점은 포맷팅 프로세스(mqsiformatlog)가 훨씬 빠르므로 이 작업을 수행하기 위한 자원이 덜 필요하다는 점입니다.

이 옵션은 지정한 구성요소가 다음인 경우에만 사용할 수 있습니다.
  • 브로커. 이 값을 변경하면, 실행 그룹(지정한 경우) 또는 에이전트 구성요소(실행 그룹을 지정하지 않은 경우)의 추적에 영향을 미칩니다.
  • 사용자 이름 서버. 이 값을 변경하면 전체 구성요소의 추적에 영향을 미칩니다. (서비스 추적에 대해서만 사용할 수 있습니다.)

추적 크기를 변경하면 브로커 또는 사용자 이름 서버를 재시작할 때 새 값이 지속적으로 사용됩니다.

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

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

-t
변경 시작(필수) 서비스 추적 옵션을 수정하도록 지정합니다.변경 끝
-b
변경 시작(필수) 지정된 구성요소의 에이전트 하위 구성요소에 대한 서비스 추적 옵션을 수정하도록 지정합니다(예: 시작 또는 정지). -t를 지정한 경우에도 이 플래그만 지정할 수 있습니다.변경 끝

권한 부여

이 명령을 실행하는 데 사용되는 사용자 ID에는 mqbrkrs 권한이 있어야 합니다.

응답

이 명령은 다음 응답을 리턴합니다.
  • BIP2595 '...' 문자열을 정수로 캐스트하는 중에 오류가 발생했습니다(z/OS에만 해당).
  • BIP8002 선택한 플래그가 호환되지 않았습니다(z/OS에만 해당).
  • BIP8003 중복 플래그가 발견되었습니다(z/OS에만 해당).
  • BIP8013 구성요소가 존재하지 않습니다.
  • BIP8020 데이터베이스에 액세스할 수 없습니다.
  • BIP8029 브로커 구성이 아직 전개되지 않았습니다.
  • BIP8031 올바르지 않은 플래그가 제공되었습니다.
  • BIP8032 큐에 연결할 수 없습니다.
  • BIP8033 메시지를 송신할 수 없습니다.
  • BIP8035 시간 종료 전에 응답이 수신되지 않았습니다.
  • BIP8036 부정적 응답이 수신되었습니다.
  • BIP8037 지원되지 않는 플래그입니다.
  • BIP8039 실행 그룹을 사용할 수 없습니다.
  • BIP8040 데이터베이스에 연결할 수 없습니다.
  • BIP8045 메시지 플로우가 없습니다.
  • BIP8068 정수 인수가 필요합니다.
  • BIP8158 명령에 올바르지 않은 형식입니다(z/OS에만 해당).
  • BIP8159 "..." 매개변수를 알 수 없습니다(z/OS에만 해당).

Windows 플랫폼, Linux 및 UNIX 시스템:

디폴트 실행 그룹에 대한 사용자 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
mqsichangetrace WBRK_BROKER -u -e default -l normal -c 5000
디폴트 실행 그룹의 플로우 f1에 대한 서비스 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
mqsichangetrace WBRK_BROKER -u -e default -m fast
에이전트에 대한 서비스 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
mqsichangetrace WBRK_BROKER -t -b -m -l normal

z/OS:

디폴트 실행 그룹에 대한 사용자 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
F MQP1BRK,ct u=yes,e='default',l=normal,c=5000
PDSE 구성원 BIPJLOG에서 mqsireadlog의 옵션을 다음으로 설정하십시오.
-u -e default
디폴트 실행 그룹의 플로우 f1에 대한 서비스 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
F MQP1BRK,ct u=yes,e='default',f='f1',m=fast
PDSE 구성원 BIPJLOG에서 mqsireadlog의 옵션을 다음으로 설정하십시오.
-t -e default -f f1-
에이전트에 대한 서비스 추적을 수집 및 처리하려면 다음 명령을 사용하십시오.
F MQP1BRK,ct t=yes,b=yes,m=fast,l=debug
PDSE 구성원 BIPJLOG에서 mqsireadlog의 옵션을 다음으로 설정하십시오.
-t -b agent
관련 태스크
추적 사용
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an07260_