명령 유틸리티(imqcmd)는 브로커, 연결 서비스, 연결, 물리적 대상, 영구 가입 및 트랜잭션을 관리하는 데 사용됩니다.
모든 imqcmd 명령은 하위 명령을 포함해야 합니다. 단, -v 또는 -h 옵션을 사용하여 제품 버전 정보 또는 사용 도움말을 표시하는 경우는 제외됩니다. 다음은 사용 가능한 하위 명령 목록이며 각각의 하위 명령에 대해서는 다음 절에서 자세히 설명합니다. 모든 경우에 하위 명령에서 브로커 주소(-b 옵션)를 받으며 호스트 이름 또는 포트 번호가 지정되지 않으면 값 localhost 및 7676을 기본값으로 간주합니다.
shutdown bkr |
브로커 종료 |
restart bkr |
브로커 다시 작동 |
pause bkr |
브로커 일시 중지 |
resume bkr |
브로커 다시 시작 |
update bkr |
브로커 등록 정보 설정 |
reload cls |
클러스터 구성 다시 로드 |
query bkr |
브로커 등록 정보 값 나열 |
metrics bkr |
브로커 메트릭 표시 |
pause svc |
연결 서비스 일시 중지 |
resume svc |
연결 서비스 다시 시작 |
update svc |
연결 서비스 등록 정보 설정 |
list svc |
브로커에서 사용할 수 있는 연결 서비스 나열 |
query svc |
연결 서비스 등록 정보 값 나열 |
metrics svc |
연결 서비스 메트릭 표시 |
list cxn |
브로커 연결 나열 |
query cxn |
연결 정보 표시 |
create dst |
물리적 대상 작성 |
destroy dst |
물리적 대상 완전 삭제 |
pause dst |
물리적 대상에 대한 메시지 전달 일시 중지 |
resume dst |
물리적 대상에 대한 메시지 전달 다시 시작 |
update dst |
물리적 대상 등록 정보 설정 |
purge dst |
물리적 대상에서 모든 메시지 제거 |
compact dst |
물리적 대상 압축 |
list dst |
물리적 대상 나열 |
query dst |
물리적 대상 등록 정보 값 나열 |
metrics dst |
물리적 대상 메트릭 표시 |
destroy dur |
영구 가입 완전 삭제 |
purge dur |
영구 가입에 대한 모든 메시지 제거 |
list dur |
주제에대한 영구 가입 나열 |
commit txn |
트랜잭션 완결 |
rollback txn |
트랜잭션 롤백 |
list txn |
브로커에서 추적 중인 트랜잭션 나열 |
query txn |
트랜잭션 정보 표시 |
명령 유틸리티를 사용하여 브로커를 시작할 수 없습니다. 대신, 브로커 유틸리티(imqbrokerd)를 사용하십시오. 브로커가 시작된 후에는 표 13–2에 나열된 imqcmd 하위 명령을 사용하여 브로커를 관리 및 제어할 수 있습니다.
표 13–2 브로커 관리에 대한 명령 유틸리티 하위 명령
구문 |
설명 |
---|---|
shutdown bkr [-b hostName :portNumber] | |
restart bkr [-b hostName :portNumber] |
브로커를 종료하고 처음 시작했을 때 지정했던 것과 동일한 옵션을 사용하여 다시 시작합니다. |
pause bkr [-b hostName :portNumber] |
자세한 내용은 브로커 일시 중지를 참조하십시오. |
resume bkr [-b hostName :portNumber] | |
update bkr [-b hostName :portNumber] -o property1= value1 [ [-o property2 =value2] … ] |
브로커 등록 정보 설정 브로커 등록 정보에 대한 자세한 내용은 14 장, 브로커 등록 정보 참조을 참조하십시오. |
reload cls |
모든 지속성 정보를 최신 상태로 유지합니다. |
query bkr -b hostName :portNumber |
브로커 등록 정보 값 나열 또한 클러스터 내 지정된 브로커에 연결된 모든 실행 중인 브로커를 나열합니다. |
metrics bkr [-b hostName :portNumber] [-m metricType] [-int interval] [-msp numSamples] |
브로커 메트릭 표시 -m 옵션은 표시할 메트릭 유형을 지정합니다. ttl: 브로커에 유입 및 유출되는 메시지와 패킷 rts: 브로커에 유입 및 유출되는 메시지와 패킷의 초당 속도 cxn: 연결, 가상 메모리 힙 및 스레드 기본값: ttl -int 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: 5 -msp 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음) |
표 13–3에서는 연결 서비스를 관리하기 위한 imqcmd 하위 명령을 나열합니다.
표 13–3 연결 서비스 관리에 대한 명령 유틸리티 하위 명령
구문 |
설명 |
---|---|
pause svc -n serviceName [-b hostName: portNumber] |
admin 연결 서비스는 일시 중지할 수 없습니다. |
resume svc -n serviceName [-b hostName: portNumber] | |
update svc -n serviceName [-b hostName: portNumber] -o property1= value1 [ [-o property2 =value2] … ] |
연결 서비스 등록 정보 설정 연결 서비스 등록 정보에 대한 자세한 내용은 연결 등록 정보를 참조하십시오. |
list svc [-b hostName :portNumber] |
브로커에서 사용할 수 있는 연결 서비스 나열 |
query svc -n serviceName [-b hostName: portNumber] |
연결 서비스 등록 정보 값 나열 |
metrics svc -n serviceName [-b hostName: portNumber] [-m metricType] [-int interval] [-msp numSamples] |
연결 서비스 메트릭 표시 -m 옵션은 표시할 메트릭 유형을 지정합니다. ttl: 브로커에 유입 및 유출되는 메시지와 패킷의 메트릭을 지정된 연결 서비스를 통해 표시 rts: 브로커에 메시지와 패킷이 유입 및 유출되는 초당 속도를 지정된 연결 방식으로 표시 cxn: 연결, 가상 메모리 힙 및 스레드 기본값: ttl -int 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: 5 -msp 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음) |
표 13–4에서는 연결을 관리하기 위한 imqcmd 하위 명령을 나열합니다.
표 13–4 연결 서비스 관리에 대한 명령 유틸리티 하위 명령
구문 |
설명 |
---|---|
list cxn [-svn serviceName] [-b hostName: portNumber] |
지정된 연결 서비스에 대한 브로커의 모든 연결을 나열합니다. 연결 서비스를 지정하지 않는 경우 모든 연결이 나열됩니다. |
query cxn -n connectionID [-b hostName: portNumber] |
표 13–5에서는 물리적 대상을 관리하기 위한 imqcmd 하위 명령을 나열합니다. -t(대상 유형) 옵션은 언제나 두 가지 값 중 하나를 사용할 수 있습니다.
q: 대기열 대상
t: 주제 대상
구문 |
설명 |
---|---|
create dst -t destType -n destName [-o property1 =value1] [ [ -o property2 =value2] … ] |
물리적 대상 작성 [마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 수행할 수 없습니다.] 대상 이름 destName에는 영숫자 문자(공백 없음)만 사용할 수 있으며 영문자, 밑줄 문자(_) 또는 달러 기호($) 문자로 시작해야 합니다. 대상 이름은 mq로 시작할 수 없습니다. |
destroy dst -t destType -n destName |
물리적 대상 완전 삭제 이 작업은 사용 불능 메시지 대기열처럼 시스템에서 생성된 대상에는 적용할 수 없습니다. |
pause dst [-t destType -n destName] [-pst pauseType] |
-t 및 -n 옵션에서 지정한 물리적 대상에 대해 메시지 전달을 일시 중지합니다. 이 옵션을 지정하지 않으면 모든 대상이 일시 중지됩니다. -pst 옵션은 일시 중지할 메시지 전달의 유형을 지정합니다. CONSUMERS: 메시지 사용자로의 전달 일시 중지 PRODUCERS: 메시지 생성자로의 전달 일시 중지 ALL: 모든 메시지 전달 일시 중지 기본값: ALL |
resume dst [-t destType -ndestName] |
물리적 대상에 대한 메시지 전달 다시 시작 -t 및 -n 옵션을 통해 지정한 물리적 대상에 대해 메시지 전달을 다시 시작합니다. 이 옵션을 지정하지 않을 경우 모든 대상이 다시 시작됩니다. |
update dst -t destType -n destName -o property1= value1 [ [ -o property2 =value2] … ] |
물리적 대상 등록 정보에 대한 자세한 내용은 15 장, 물리적 대상 등록 정보 참조을 참조하십시오. |
purge dst -t destType -n destName | |
compact dst [-t destType -n destName] |
-t 및 -n 옵션을 통해 지정하는 물리적 대상에 대한 파일 기반 영구 데이터 저장소를 압축합니다. 이 옵션을 지정하지 않을 경우 모든 대상이 압축됩니다. 대상을 압축하려면 먼저 대상을 일시 중지해야 합니다. |
list dst [-t destType] [-tmp] |
물리적 대상 나열 -t 옵션을 통해 지정된 유형의 모든 물리적 대상을 나열합니다. 대상 유형을 지정하지 않을 경우 대기열 및 주제 대상이 모두 나열됩니다. -tmp 옵션을 지정하는 경우 임시 대상도 나열됩니다. |
query dst -t destType -n destName | |
metrics dst -t destType -n destName [-m metricType] [-int interval] [-msp numSamples] |
물리적 대상 메트릭 표시 -m 옵션은 표시할 메트릭 유형을 지정합니다. ttl: 대상에 유입 및 유출되고 메모리에 있는 메시지와 패킷 rts: 브로커에 유입 및 유출되는 메시지와 패킷의 초당 속도(기타 속도 정보와 함께 표시) con: 메시지 사용자 관련 메트릭 dsk: 디스크 사용량 기본값: ttl -int 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: 5 -msp 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음) |
표 13–6에서는 영구 가입을 관리하기 위한 imqcmd 하위 명령을 나열합니다.
표 13–6 영구 가입 관리에 대한 명령 유틸리티 하위 명령
구문 |
설명 |
---|---|
destroy dur -c clientID -n subscriberName | |
purge dur -c clientID -n subscriberName | |
list dur -d topicName |
표 13–7에서는 트랜잭션을 관리하기 위한 imqcmd 하위 명령을 나열합니다.
표 13–7 트랜잭션 관리에 대한 명령 유틸리티 하위 명령
구문 |
설명 |
---|---|
commit txn -n transactionID | |
rollback txn -n transactionID | |
list txn | |
query txn -n transactionID |
표 13–8에 나열된 추가 옵션은 imqcmd 명령의 모든 하위 명령에 적용할 수 있습니다.
표 13–8 일반 명령 유틸리티 옵션
옵션 |
설명 |
---|---|
-secure | |
-u userName |
인증에 사용되는 사용자 이름 이 옵션을 생략하면 명령 유틸리티에서 대화식으로 사용자 이름을 묻는 메시지를 표시합니다. |
-p password |
인증에 사용되는 비밀번호 [이 옵션은 더 이상 사용되지 않으며 추후에 제거될 것입니다. 비밀번호를 생략하거나(대화식으로 비밀번호를 묻는 메시지 표시) -passfile 옵션을 사용하여 비밀번호를 포함하는 파일을 지정합니다. ] |
-passfile path |
비밀번호 파일의 위치 자세한 내용은 비밀번호 파일을 참조하십시오. |
-rtm timeoutInterval |
초기 시간 초과 간격(초) 요청을 다시 시도하기 전에 명령 유틸리티가 브로커로부터 응답을 기다리는 초기 시간 길이입니다. 각 후속 재시도에서는 이 초기 간격의 배수가 되는 시간 초과 간격을 사용합니다. 기본값: 10 |
-rtr numRetries |
브로커 요청 시간이 초과된 후 시도할 재시도 횟수 기본값: 5 |
-javahome path |
기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다. |
-f |
사용자 확인 없이 작업 수행 |
-s |
자동 모드(출력이 표시되지 않음) |
-v |
버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ] , [사용자 이름과 비밀번호가 필요하지 않음] |
-h | |
-H |
속성 목록과 예를 포함하여 자세한 사용 도움말을 표시합니다., |