mqsichangeflowstats 명령

지원되는 플랫폼

  • Windows
  • Linux 및 UNIX 시스템
  • 변경 시작z/OS. 브로커 PDSE 컨텐츠 를 참조하여 BIPCHMS를 사용할 수도 있습니다.변경 끝

목적

mqsichangeflowstats 명령을 사용하여 다음을 수행할 수 있습니다.
  • 어카운팅 및 통계 스냅샷 publication을 설정 또는 해제하거나 레코드 출력을 아카이브합니다.
  • 명령이 특정 메시지 플로우 또는 실행 그룹의 모든 플로우나 브로커에 속하는 모든 실행 그룹에 적용되도록 지정합니다.
  • 표준 메시지 플로우의 어카운팅 및 통계 이외에 수집된 데이터의 세분화를 수정합니다. 이 추가 데이터에는 스레드 관련 데이터, 노드 관련 데이터, 노드 터미널 관련 데이터 또는 이러한 데이터가 혼합되어 포함될 수 있습니다.

이 명령을 사용하여 설정하는 옵션은 이후에 mqsichangeflowstats 명령으로 수정할 때까지 활성 상태를 유지합니다.

구문

Windows 플랫폼, Linux 및 UNIX 시스템

z/OS

동의어 cs

매개변수

brokername
(필수 -Windows 플랫폼, Linux 및 UNIX 시스템) 어카운팅 및 통계를 변경할 브로커의 레이블을 지정합니다.
-a
(필수) 명령이 아카이브 계정 및 통계 콜렉션을 수정하도록 지정합니다.
주: -a 또는 -s를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
-s
(필수) 명령이 스냅샷 계정 및 통계 콜렉션을 수정하도록 지정합니다.
주: -a 또는 -s를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
-e ExecutionGroupName
(필수) 어카운팅 및 통계 옵션을 변경할 실행 그룹의 이름을 지정하십시오.
주: -e 또는 -g를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
-f MessageFlow
(필수) 어카운팅 및 통계 옵션을 변경할 메시지 플로우의 레이블을 지정하십시오.
주: -f 또는 -j를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
-g
(필수) 명령이 브로커에 속하는 모든 실행 그룹에 적용되도록 지정합니다.
주: -e 또는 -g를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
-j
(필수) 명령이 실행 그룹에 속하는 모든 메시지 플로우에 적용되도록 지정합니다.
주:
  1. -f 또는 -j를 지정해야 합니다. 이러한 인수 중 하나를 지정하지 않으면 경고 메시지가 표시됩니다.
  2. 모든 실행 그룹에 대해 -j 옵션을 설정하는 경우, -f 대신 -h 옵션을 사용해야 합니다.
-c control
(선택사항) 스냅샷 또는 아카이브를 위해 계정 및 통계 콜렉션에 적용할 조치 레벨을 제어하는 문자열 값을 지정합니다. 가능한 값은 다음과 같습니다.
  • active - 스냅샷 또는 아카이브를 설정합니다.
  • inactive - 스냅샷 또는 아카이브를 해제합니다.
-t ThreadData
(선택사항) 메시지 플로우의 스레드 통계 데이터 콜렉션을 수정하기 위한 문자열 값을 지정합니다. 가능한 값은 다음과 같습니다.
  • none - 스레드 관련 데이터를 통계에서 제외시킵니다.
  • basic - 스레드 관련 데이터를 통계에 포함시킵니다.
-n NodeData
(선택사항) 메시지 플로우의 노드 통계 데이터 콜렉션을 수정하기 위한 문자열 값을 지정합니다. 가능한 값은 다음과 같습니다.
  • none - 노드 관련 데이터를 통계에서 제외시킵니다.
  • basic - 노드 관련 데이터를 통계에 포함시킵니다.
  • advanced - 노드 관련 데이터 및 터미널 관련 데이터를 통계에 포함시킵니다.
-r
(선택사항) 아카이브 데이터의 재설정이 필수임을 지정합니다.
주: 이 조치는 아카이브 데이터에 대해서만 사용할 수 있습니다.
이로 인해, 이 간격 동안 지금까지 누적된 계정 및 통계 데이터가 지워지고 이 지점부터 콜렉션을 재시작합니다. 실행 그룹의 모든 플로우에 대한 아카이브 데이터가 모두 재설정됩니다.

아카이브 간격 타이머는 mqsicreatebroker 또는 mqsichangebroker-v 옵션(통계 아카이브 간격)이 0이 아닌 경우에만 재설정됩니다. 즉, 간격 타이머는 z/OS의 ENF와 같은 외부 메소드가 아닌 내부 간격 공고 메커니즘을 사용하고 있는 경우에만 설정됩니다.

-b AccountingOrigin
(선택사항) 수집한 통계를 별개의 출력물과 분할하는 Broker.Accounting.Origin 환경 트리 경로를 지정하십시오. 가능한 값은 다음과 같습니다.
  • none - 원래 데이터 계산으로 통계를 분할하지 않음
  • basic - 원래 데이터 계산으로 통계를 분할함
-o OutputFormat
(선택사항) 통계 보고서에 대한 출력 목적지를 지정합니다. 가능한 값은 다음과 같습니다.
  • usertrace - 이 값은 디폴트이고 "bip" 메시지를 사용자 추적에 기록합니다. 이는 mqsireadlogmqsiformatlog 명령을 사용하여 일반 방식으로 사후 처리할 수 있습니다.
  • xml - 통계 보고서가 XML 문서로 생성되고 메시지 플로우를 실행하는 브로커에 의해 publish됩니다.
    데이터가 publish된 토픽은 다음 구조를 가집니다.
    $SYS/Broker/<brokerName>/StatisticsAccounting/<recordType>/<executionGroupLabel>/<messageFlowLabel>
    여기서, recordType은 Snapshot 또는 Archive로 설정되고, 브로커, 실행 그룹 및 메시지 플로우 이름은 subscriber의 요구사항에 따라 지정됩니다.
  • smf - (z/OS 전용). 통계 보고서는 SMF 유형 117 레코드와 같은 출력입니다.

권한 부여

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

응답

이 명령은 다음 응답을 리턴합니다.
  • 메시지 플로우 노드 ' '에서 속성을 변경하는 BIP2226 요청: 메시지 플로우가 존재하지 않음
  • BIP8004 선택한 플래그 및 인수가 올바르지 않음
  • BIP8013 구성요소가 존재하지 않습니다.
  • BIP8020 데이터베이스 테이블에 액세스할 수 없습니다.
  • BIP8029 브로커가 구성되지 않습니다.
  • BIP8033 XML 메시지를 송신할 수 없습니다.
  • BIP8038 지원되지 않는 명령 옵션입니다.
  • BIP8039 실행 그룹을 사용할 수 없습니다.
  • BIP8040 데이터베이스에 연결할 수 없습니다.

BrokerA의 모든 실행 그룹에서 "myFlow1" 메시지 플로우에 대한 스냅샷 통계를 켜고 데이터는 원본을 계산하여 수집되야 한다는 것을 지정합니다.
mqsichangeflowstats BrokerA -s -g -j -b none   
BrokerA의 실행 그룹 "EGRP2"에 있는 메시지 플로우 "MyFlow1"에 대해 아카이브 통계 콜렉션을 해제하고, 동시에 스레드 관련 데이터를 포함하도록 수집될(다음에 활성화될 때) 데이터의 세분화를 수정합니다.
 mqsichangeflowstats BrokerA -a -e "EGRP2" -f MyFlow1 -c inactive -t basic   
BrokerA의 모든 실행 그룹에 있는 모든 메시지 플로우에 대해 스냅샷 데이터를 해제합니다.
mqsichangeflowstats BrokerA -s -g -j -c inactive  
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an11770_