Sun Java System Message Queue 3.7 UR1 관리 설명서

명령 유틸리티

명령 유틸리티(imqcmd)는 브로커, 연결 서비스, 연결, 물리적 대상, 영구 가입 및 트랜잭션을 관리하는 데 사용됩니다.

모든 imqcmd 명령은 하위 명령을 포함해야 합니다. 단, -v 또는 -h 옵션을 사용하여 제품 버전 정보 또는 사용 도움말을 표시하는 경우는 제외됩니다. 다음은 사용 가능한 하위 명령 목록이며 각각의 하위 명령에 대해서는 다음 절에서 자세히 설명합니다. 모든 경우에 하위 명령에서 브로커 주소(-b 옵션)를 받으며 호스트 이름 또는 포트 번호가 지정되지 않으면 값 localhost7676을 기본값으로 간주합니다.

브로커 관리

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(대상 유형) 옵션은 언제나 두 가지 값 중 하나를 사용할 수 있습니다.

표 13–5 물리적 대상 관리에 대한 명령 유틸리티 하위 명령

구문 

설명 

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

ssladmin 연결 서비스를 사용하는 브로커에 보안 연결 사용

-u userName

인증에 사용되는 사용자 이름 

이 옵션을 생략하면 명령 유틸리티에서 대화식으로 사용자 이름을 묻는 메시지를 표시합니다.  

-p password

인증에 사용되는 비밀번호 [이 옵션은 더 이상 사용되지 않으며 추후에 제거될 것입니다. 비밀번호를 생략하거나(대화식으로 비밀번호를 묻는 메시지 표시) -passfile 옵션을 사용하여 비밀번호를 포함하는 파일을 지정합니다. ]

-passfile path

비밀번호 파일의 위치 

자세한 내용은 비밀번호 파일을 참조하십시오.

-rtm timeoutInterval

초기 시간 초과 간격(초) 

요청을 다시 시도하기 전에 명령 유틸리티가 브로커로부터 응답을 기다리는 초기 시간 길이입니다. 각 후속 재시도에서는 이 초기 간격의 배수가 되는 시간 초과 간격을 사용합니다.  

기본값: 10

-rtr numRetries

브로커 요청 시간이 초과된 후 시도할 재시도 횟수 

기본값: 5

-javahome path

대체 Java Runtime 위치

기본 동작: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.

-f

사용자 확인 없이 작업 수행 

-s

자동 모드(출력이 표시되지 않음) 

-v

버전 정보 표시 [명령줄에 지정된 다른 옵션은 무시됩니다. ] , [사용자 이름과 비밀번호가 필요하지 않음]

-h

사용 도움말 표시,

-H

속성 목록과 예를 포함하여 자세한 사용 도움말을 표시합니다.,