| |
| Sun Java System Message Queue 3 2005Q1 관리 설명서 | |
13장
명령 참조이 장에서는 공통 명령줄 구문에 대한 설명과 각 Message Queue 명령에 대한 참조 정보를 제공합니다. 이 장은 다음 내용으로 구성되어 있습니다.
명령줄 구문Message Queue 명령줄 유틸리티는 쉘 명령입니다. 유틸리티 이름이 명령이고 하위 명령 또는 옵션은 해당 명령에 전달되는 인수입니다. 따라서 유틸리티를 시작하거나 종료하는 명령은 없으며 필요하지도 않습니다.
모든 명령줄 유틸리티는 다음과 같은 명령 구문을 공유합니다.
Utility_Name [subcommand] [argument] [[-option_name [-option_argument]]...]
Utility_Name은 Message Queue 유틸리티의 이름(예: imqcmd, imqobjmgr, imqusermgr 등)을 지정합니다.
명령 입력 규칙
다음은 명령 입력을 위한 일반 규칙입니다.
명령줄 예
다음은 하위 명령절이 없는 명령줄의 예입니다. 이 명령은 기본 브로커를 시작합니다.
imqbrokerd
다음 명령은 좀 더 복잡합니다. 이 명령은 myQueue라는 이름의 queue 유형의 대상을 완전 삭제합니다. 인증은 사용자 admin을 기반으로 수행되고 명령에서는 사용자의 비밀번호를 묻는 메시지를 표시합니다. -f 옵션은 확인이 없음을 지정하고 -s 옵션은 명령이 자동 모드로 실행됨을 지정합니다.
imqcmd destroy dst -t q -n myQueue -u admin -f -s
공통 명령 옵션
표 13-1은 모든 Message Queue 관리 유틸리티에서 공통적으로 사용하는 옵션을 설명합니다. 이러한 옵션은 명령줄에서 하위 명령의 뒤에 지정해야 합니다. 옵션을 입력하는 순서는 상관이 없습니다.
imqbrokerdimqbrokerd 명령은 브로커를 시작합니다. 명령줄 옵션은 현재 브로커 세션에 대해서만 브로커 구성 파일의 값을 무시합니다.
구문
명령 옵션
표 13-2에는 imqbrokerd 명령의 옵션과 각 옵션에 영향을 받는 구성 등록 정보(있는 경우)에 대한 설명이 나와 있습니다.
표 13-2 imqbrokerd 옵션
옵션
영향을 받는 등록 정보
설명
-backup fileName
없음
브로커 클러스터에만 적용됩니다. 마스터 브로커의 구성 변경 기록을 지정된 파일에 백업합니다. 구성 변경 기록 관리를 참조하십시오.
-cluster”broker1]
[[,broker2]...]”
여기서 broker는 다음 중 하나입니다.imq.cluster.brokerlist를 연결할 브로커의 목록으로 대체합니다.
브로커 클러스터에만 적용됩니다. 지정된 호스트 및 포트의 모든 브로커에 연결합니다. 이 목록은 imq.cluster.brokerlist 등록 정보의 목록과 병합됩니다. host에 값을 지정하지 않으면 localhost가 사용됩니다. port에 값을 지정하지 않으면 7676이 사용됩니다. 이 옵션을 사용해서 여러 브로커에 연결하는 방법에 대한 자세한 내용은 브로커 클러스터 작업을 참조하십시오.
-dbpassword password
imq.persist.jdbc.
password를 지정한 비밀번호로 대체합니다.플러그 인 JDBC 호환 데이터 저장소의 비밀번호를 지정합니다. 이 옵션은 더 이상 사용되지 않으며 향후 버전에서는 제거됩니다. 다음 중 하나를 대신 사용합니다.
-dbuser userName
imq.persist.jdbc.user
를 지정한 사용자 아이디로 대체합니다.플러그 인 JDBC 호환 데이터베이스의 사용자 아이디를 지정합니다. 영구 저장소 설정을 참조하십시오.
-Dproperty=value
시스템 등록 정보를 설정합니다. 인스턴스 구성 파일의 해당 등록 정보 값을 대체합니다.
지정한 등록 정보를 지정한 값으로 설정합니다. 브로커 구성 등록 정보에 대한 자세한 내용은 14장, "브로커 등록 정보 참조"를 참조하십시오.
주의: -D 옵션으로 설정한 등록 정보의 맞춤법과 형식에 주의하십시오. 잘못된 값을 전달한 경우 시스템에서는 경고를 하지 않으며 Message Queue에서는 해당 값을 설정할 수 없습니다.
-force
없음
사용자의 확인 없이 작업을 수행합니다. 이 옵션은 일반적으로 확인이 필요한
-remove instance 및 -upgrade-store-nobackup 옵션에만 적용됩니다.-h|-help
없음
도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-javahome path
없음
대체 Java 2 호환 JDK의 경로를 지정합니다. 기본값은 번들형 런타임을 사용하는 것입니다.
-ldappassword
passwordimq.user_repository.
ldap.password를 지정한 비밀번호로 대체합니다.LDAP 사용자 저장소에 액세스할 때 필요한 비밀번호를 지정합니다. 이 옵션은 더 이상 사용되지 않으며 향후 버전에서는 제거됩니다. 다음 중 하나를 대신 사용합니다.
-license [licenseName]
없음
로드할 사용권이 Message Queue 제품의 기본값과 다른 경우 해당 사용권을 지정합니다. 사용권 이름을 지정하지 않으면 시스템에 설치된 모든 사용권이 표시됩니다. licenseName 값은 설치된 Message Queue 버전에 따라 pe (플랫폼판-기본 기능), try (플랫폼판-90일 시험 엔터프라이즈 기능), unl (엔터프라이즈판)입니다.
-loglevel level
imq.broker.log.level을 지정한 수준으로 대체합니다.
로깅 수준을 NONE, ERROR, WARNING 또는 INFO 중 하나로 지정합니다. 기본값은 INFO입니다.
-metrics interval
imq.metrics.interval을 지정한 시간(초)으로 대체합니다.
지정된 간격(초)으로 브로커 메트릭이 로거에 기록되도록 지정합니다.
-name instanceName
imq.instancename을 지정한 이름으로 설정합니다.
이 브로커의 인스턴스 이름을 지정하고 해당 인스턴스 구성 파일을 사용합니다. 브로커 이름을 지정하지 않으면 인스턴스 이름은 imqbroker로 설정됩니다.
주: 같은 호스트에서 두 개 이상의 브로커 인스턴스를 실행하는 경우에는 각각에 고유한 이름이 있어야 합니다.-passfile fileName
imq.passfile.enabled를 대체하여 true로 설정합니다. imq.passfile.dirpath를 파일이 포함된 경로로 대체합니다. imq.passfile.name을 파일 이름으로 대체합니다.
imqcmd 명령 유틸리티, SSL 키 저장소, LDAP 사용자 저장소, JDBC 호환 데이터베이스 또는 이들의 조합에 대한 비밀번호를 읽을 파일의 이름을 지정합니다. 자세한 내용은 Passfile 사용을 참조하십시오.
-password keypassword
imq.keystore.password를 지정한 비밀번호로 대체합니다.
SSL 인증서 키 저장소에 대한 비밀번호를 지정합니다. 이 옵션은 더 이상 사용되지 않으며 향후 버전에서는 제거됩니다. 다음 중 하나를 대신 사용합니다.
-port number
imq.portmapper.port를 지정한 번호로 대체합니다.
브로커의 포트 매퍼 포트 번호를 지정합니다. 이 값은 기본적으로 7676으로 설정됩니다. 같은 서버에서 두 개의 브로커 인스턴스를 실행하려면 각 브로커의 포트 매퍼에 서로 다른 포트 번호가 있어야 합니다. Message Queue 클라이언트는 이 포트 번호를 사용하여 브로커 인스턴스에 연결합니다.
-remove instance
없음
브로커 인스턴스를 제거합니다. 인스턴스 구성 파일, 로그 파일, 영구 저장소, 인스턴스와 관련된 기타 파일 및 디렉토리를 삭제합니다. -force 옵션을 함께 지정한 경우가 아니면 사용자의 확인이 필요합니다.
-reset store| messages|
durables|
props없음
주어진 인수에 따라 데이터 저장소(또는 데이터 저장소의 일부) 또는 브로커 인스턴스의 등록 정보를 재설정합니다.
데이터 저장소를 재설정하면 지속성 메시지, 영구 가입, 트랜잭션 정보 등의 모든 지속성 데이터가 지워집니다. 그러면 브로커 인스턴스를 초기 상태로 시작할 수 있습니다. 지속성 메시지만 지우거나 영구 가입만 지울 수도 있습니다. 이후에 다시 시작할 때 영구 저장소가 재설정되지 않게 하려면 -reset 옵션을 사용하지 않고 브로커 인스턴스를 다시 시작합니다.
브로커의 등록 정보를 재설정하면 기존 인스턴스 구성 파일(config.properties)이 빈 파일로 교체됩니다. 모든 등록 정보에 기본값이 설정됩니다.
-restore fileName
없음
브로커 클러스터에만 적용됩니다. 마스터 브로커의 구성 변경 레코드를 지정한 백업 파일로 교체합니다. 이 파일은 -backup 옵션을 사용해서 미리 작성해 두어야 합니다. 구성 변경 기록 관리를 참조하십시오.
-shared
imq.jms.threadpool_model을 대체하여 shared로 설정합니다.
연결 간에 스레드를 공유하여 브로커 인스턴스가 지원하는 연결 수가 늘어나도록 jms 연결 서비스가 공유 스레드 풀 모델을 사용해서 구현되게 지정합니다.
-silent|-s
imq.log.console.output을 대체하여 NONE으로 설정합니다.
콘솔에 대한 로깅을 끕니다.
-tty
imq.log.console.output을 대체하여 ALL로 설정합니다.
모든 메시지가 콘솔에 표시되도록 설정합니다. 기본적으로 WARNING 및 ERROR 수준 메시지만 표시됩니다.
-upgrade-store-
nobackup없음
호환되지 않는 버전에서 Message Queue 3.5 또는 Message Queue 3.5 SPx로 업그레이드할 때 이전 데이터 저장소를 자동으로 제거하도록 지정합니다. 자세한 내용은 Message Queue 설치 설명서를 참조하십시오.
-version
없음
설치된 제품의 버전 번호를 표시합니다.
-vmargs arg1 [[arg2]...]
없음
Java VM으로 전달할 인수를 지정합니다. 인수는 공백으로 구분합니다. 인수를 두 개 이상 전달하거나 인수에 공백이 포함된 경우에는 따옴표를 사용합니다. 예를 들면 다음과 같습니다.
imqbrokerd -tty -vmargs "-Xmx128m -Xincgc"이러한 인수는 명령줄에서만 전달할 수 있습니다. config.props 파일에는 연결된 구성 등록 정보가 없습니다.
참조
imqbrokerd 사용 및 명령 예에 대한 자세한 내용은 대화식으로 브로커 시작을 참조하십시오.
imqcmdimqcmd 명령 유틸리티를 사용하여 브로커와 해당 서비스를 관리할 수 있습니다.
구문
imqcmd subcommand argument [options]
imqcmd -h|H
imqcmd -v하위 명령
도움말이나 제품 버전을 표시하려는 경우가 아니라면 항상 imqcmd와 함께 하위 명령을 사용하게 됩니다. 표 13-3에서는 imqcmd 하위 명령을 나열하고 해당 하위 명령에 대한 참조 정보가 있는 위치를 지정합니다.
표 13-3 imqcmd 하위 명령
하위 명령 및 인수
설명
참조
commit txn
트랜잭션을 완결합니다.
destroy dur
영구 가입을 완전 삭제합니다.
list cxn
브로커에 대한 연결을 나열합니다.
list dur
주제의 영구 가입을 나열합니다.
list svc
브로커의 서비스를 나열합니다.
list txn
브로커의 트랜잭션을 나열합니다.
metrics bkr
브로커 메트릭을 표시합니다.
metrics svc
서비스 메트릭을 표시합니다.
pause bkr
브로커의 모든 서비스를 일시 중지합니다.
pause svc
브로커에서 단일 서비스를 일시 중지합니다.
purge dur
영구 가입을 완전 삭제하지 않고 영구 가입의 모든 메시지를 제거합니다.
query bkr
브로커의 정보를 쿼리 및 표시합니다.
query cxn
연결의 정보를 쿼리 및 표시합니다.
query svc
서비스의 정보를 쿼리 및 표시합니다.
query txn
트랜잭션의 정보를 쿼리 및 표시합니다.
reload cls
브로커 클러스터 구성을 다시 로드합니다.
restart bkr
현재 실행 중인 브로커 인스턴스를 다시 시작합니다.
resume bkr
브로커의 모든 서비스를 다시 시작합니다.
resume svc
한 서비스를 다시 시작합니다.
rollback txn
트랜잭션을 롤백합니다.
shutdown bkr
브로커 인스턴스를 종료합니다.
update bkr
브로커의 속성을 업데이트합니다.
update svc
서비스의 속성을 업데이트합니다.
또한, imqcmd 명령 유틸리티에는 브로커의 물리적 대상에 사용할 하위 명령이 있습니다. 대상 하위 명령은 6장, "물리적 대상 관리"에 설명되어 있습니다.
다음 절에서는 imqcmd 하위 명령을 기능별로 나열합니다.
브로커 관리 하위 명령
표 13-4에서는 브로커 관리에 사용되는 imqcmd 하위 명령을 나열합니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 기본값(localhost:7676)인 것으로 가정합니다.
표 13-4 브로커 관리에 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
metrics bkr [-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]기본 브로커 또는 지정한 호스트 및 포트의 브로커 메트릭을 표시합니다.
-m 옵션을 사용하여 표시할 메트릭 유형을 지정합니다.
ttl 브로커에 유입 및 유출되는 메시지와 패킷의 메트릭을 표시합니다(기본 메트릭 유형).
rts 브로커에 유입 및 유출되는 메시지와 패킷의 메트릭을 초당 속도로 표시합니다.
cxn 연결, 가상 메모리 힙 및 스레드를 표시합니다.
-int 옵션을 사용하여 메트릭 표시 간격(초)을 지정합니다. 기본값은 5초입니다.
-msp 옵션을 사용하여 출력에 표시되는 샘플 수를 지정합니다. 기본값은 무제한 수입니다(무한).
pause bkr [-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커를 일시 중지합니다. 브로커 일시 중지 및 다시 시작을 참조하십시오.
query bkr -b hostName:port
기본 브로커 또는 지정한 호스트 및 포트의 브로커에 해당하는 현재 등록 정보 설정을 나열합니다. 지정한 브로커에 연결된 실행 중인 브로커(브로커가 여러 개인 클러스터에서)의 목록도 표시합니다.
reload cls
브로커 클러스터에만 적용됩니다. 클러스터에 있는 모든 브로커에서 imq.cluster.brokerlist 등록 정보를 다시 로드하고 클러스터 정보를 업데이트하도록 합니다. 자세한 내용은 클러스터에 브로커 추가를 참조하십시오.
restart bkr [-b hostName:port]
브로커를 시작했을 때 지정한 옵션을 사용하여 기본 브로커 또는 지정한 호스트 및 포트의 브로커를 종료하고 다시 시작합니다.
resume bkr [-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커를 다시 시작합니다.
shutdown bkr [-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커를 종료합니다.
update bkr [-b hostName:port]
-o attribute=value
[-o attribute=value1]...기본 브로커 또는 지정한 호스트 및 포트의 브로커에 해당하는 지정된 속성을 변경합니다.
물리적 대상 관리 하위 명령
표 13-5에서는 물리적 대상 관리에 사용되는 imqcmd 하위 명령을 나열합니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 기본값(localhost:7676)인 것으로 가정합니다.
표 13-5 대상 관리에 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
compact dst [-t destType
-n destName]기본 제공 파일 기반 데이터 저장소에서 지정된 유형과 이름의 대상을 압축합니다. 대상 유형과 이름을 지정하지 않으면 모든 대상이 압축됩니다. 대상을 압축하려면 먼저 일시 중지해야 합니다.
create dst -t destType
-n destName
[-o attribute=value]
[-o attribute=value1]...지정한 유형의 대상을 지정한 이름과 지정한 속성을 사용하여 만듭니다. 대상 이름은 영숫자(공백 없음)만 포함하고 영문자나 "_" 및 "$" 문자로 시작할 수 있습니다. "mq" 문자열로는 시작할 수 없습니다.
마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 이 작업을 수행할 수 없습니다.
destroy dst -t destType
-n destName지정한 유형과 이름의 대상을 완전 삭제합니다. 사용 불능 메시지 대기열처럼 시스템에서 생성된 대상은 완전 삭제할 수 없습니다.
마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 이 작업을 수행할 수 없습니다.
list dst [-t destType] [-tmp]
지정된 유형의 대상을 모두 나열합니다. 임시 대상을 함께 나열할 수도 있습니다.
유형 인수는 다음과 같은 두 가지 값을 가질 수 있습니다.
destType = q (대기열)
destType = t (주제)유형을 지정하지 않으면 모든 유형의 대상이 모두 나열됩니다.
metrics dst -t destType
-n destName
[-m metricType]
[-int interval]
[-msp numSamples]지정한 유형과 이름의 대상에 대한 메트릭 정보를 표시합니다.
-m 옵션을 사용하여 표시할 메트릭 유형을 지정합니다.
ttl 대상에 유입 및 유출되고 메모리에 있는 메시지와 패킷의 메트릭을 표시합니다(기본 메트릭 유형).
rts 대상에 유입 및 유출되는 메시지와 패킷의 메트릭을 초당 속도로 나타내고 기타 속도 정보를 표시합니다.
con 사용자 관련 메트릭을 표시합니다.
dsk 디스크 사용 메트릭을 표시합니다.
-int 옵션을 사용하여 메트릭 표시 간격(초)을 지정합니다. 기본값은 5초입니다.
-msp 옵션을 사용하여 출력에 표시되는 샘플 수를 지정합니다. 기본값은 무제한 수입니다(무한).
pause dst [-t destType
-n destName]
[-pst pauseType]지정된 유형과 이름의 대상에서 사용자에게 메시지 전달(-pst CONSUMERS), 생성자로부터 메시지 전달(-pst PRODUCERS) 또는 두 가지 모두(-pst ALL)를 일시 중지합니다. 대상 유형과 이름을 지정하지 않으면 모든 대상이 일시 중지됩니다. 기본값은 ALL입니다.
purge dst -t destType
-n destName지정한 유형과 이름의 대상에서 메시지를 제거합니다.
query dst -t destType
-n destName지정한 유형과 이름의 대상에 대한 정보를 나열합니다.
resume dst [-t destType
-n destName]지정된 유형과 이름의 일시 중지된 대상에서 메시지 전달을 다시 시작합니다. 대상 유형과 이름을 지정하지 않으면 모든 대상이 다시 시작됩니다.
update dst -t destType
-n destName
-o attribute=value
[-o attribute=value1]...지정한 대상에서 지정한 속성의 값을 업데이트합니다.
대상이 사용 불능 메시지 대기열 mq.sys.dmq가 아닌 경우 표 15-1에 설명된 속성 중 하나를 속성 이름으로 사용할 수 있습니다.
연결 서비스 관리 하위 명령
표 13-6에 연결 서비스 관리에 사용되는 imqcmd 하위 명령이 나열되어 있습니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 기본값(localhost:7676)인 것으로 가정합니다.
표 13-6 연결 서비스 관리에 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
list svc [-b hostName:port]
기본 브로커 또는 지정한 호스트 및 포트의 브로커에 있는 모든 연결 서비스를 나열합니다.
metrics svc -n serviceName
[-b hostName:port]
[-m metricType]
[-int interval]
[-msp numSamples]기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 지정된 서비스의 메트릭을 표시합니다.
-m 옵션을 사용하여 표시할 메트릭 유형을 지정합니다.
ttl 브로커에 유입 및 유출되는 메시지와 패킷의 메트릭을 지정된 서비스 방법으로 표시합니다(기본 메트릭 유형).
rts 브로커에 메시지와 패킷이 유입 및 유출되는 초당 속도에 대한 메트릭을 지정된 연결 서비스를 통해 표시합니다.
cxn 연결, 가상 메모리 힙 및 스레드를 표시합니다.
-int 옵션을 사용하여 메트릭 표시 간격(초)을 지정합니다. 기본값은 5초입니다.
-msp 옵션을 사용하여 출력에 표시되는 샘플 수를 지정합니다. 기본값은 무제한 수입니다(무한).
pause svc -n serviceName
[-b hostName:port]기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 실행 중인, 지정된 서비스를 일시 중지합니다. 관리 서비스는 일시 중지할 수 없습니다.
query svc -n serviceName
[-b hostName:port]기본 브로커 또는 지정한 호스트 및 포트의 서비스에서 실행 중인, 지정된 서비스에 대한 정보를 표시합니다.
resume svc -n serviceName
[-b hostName:port]기본 브로커 또는 지정한 호스트 및 포트에서 실행 중인, 지정된 서비스를 다시 시작합니다.
update svc -n serviceName
[-b hostName:port]
-o attribute=value
[-o attribute=value1]...기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 실행 중인, 지정된 서비스의 지정된 속성을 업데이트합니다. 서비스 속성에 대한 설명은 연결 서비스 등록 정보를 참조하십시오.
연결 하위 명령
표 13-7에 연결에 적용되는 imqcmd 하위 명령이 나열되어 있습니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 localhost, 7676인 것으로 가정합니다.
표 13-7 연결 서비스 관리에 사용되는 imqcmd 하위 명령
하위 명령 구문
설명
list cxn [-svn serviceName]
[-b hostName:port]기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 지정된 서비스 이름의 연결을 모두 나열합니다. 서비스 이름을 지정하지 않는 경우 모든 연결이 나열됩니다.
query cxn -n connectionID
[-b hostName:port]기본 브로커 또는 지정한 호스트 및 포트의 브로커에서 지정된 연결에 대한 정보를 표시합니다.
영구 가입 하위 명령
표 13-8에서는 imqcmd 영구 가입 하위 명령을 요약합니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 기본값(localhost:7676)인 것으로 가정합니다.
표 13-8 영구 가입 관리에 사용되는 imqcmd 하위 명령
하위 명령
설명
list dur -d destName
지정한 대상의 모든 영구 가입을 나열합니다.
destroy dur -n subscrName
-c client_id지정한 클라이언트 식별자에 해당하는 지정된 영구 가입을 완전 삭제합니다.
마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 이 작업을 수행할 수 없습니다.
purge dur -n subscrName
-c client_id지정한 클라이언트 식별자에 해당하는 지정된 영구 가입에 대한 모든 메시지를 제거합니다.
트랜잭션 관리 하위 명령
표 13-9에서는 imqcmd 트랜잭션 하위 명령을 요약합니다. 호스트 이름 또는 포트가 지정되어 있지 않으면 기본값(localhost:7676)인 것으로 가정합니다.
표 13-9 트랜잭션 관리에 사용되는 imqcmd 하위 명령
하위 명령
설명
list txn
브로커에서 추적하는 모든 트랜잭션을 나열합니다.
query txn -n transaction_id
지정한 트랜잭션에 대한 정보를 나열합니다.
commit txn -n transaction_id
지정한 트랜잭션을 완결합니다.
rollback txn -n transaction_id
지정한 트랜잭션을 롤백합니다.
명령 옵션
표 13-10에 imqcmd 명령의 옵션이 나열되어 있습니다.
표 13-10 imqcmd 옵션
옵션
설명
-b hostName:port
브로커의 호스트 이름과 해당 포트 번호를 지정합니다. 기본값은 localhost:7676입니다.
포트만 지정하려면: -b :7878
이름만 지정하려면: -b somehost-c clientID
주제에 영구 가입의 아이디를 지정합니다. 영구 가입 관리를 참조하십시오.
-d destinationName
주제의 이름을 지정합니다. list dur 및 destroy dur 하위 명령에 사용됩니다. 영구 가입 관리를 참조하십시오.
-f
사용자의 확인 없이 작업을 수행합니다.
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
이 옵션에는 사용자 아이디와 비밀번호가 필요하지 않습니다.
-H
사용 도움말, 속성 목록 및 예를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
이 옵션에는 사용자 아이디와 비밀번호가 필요하지 않습니다.
-int interval
metrics bkr, metrics dst 및 metrics svc 하위 명령이 메트릭 출력을 표시하는 간격(초)을 지정합니다.
-javahome path
Java 2와 호환할 수 있는 대체 런타임을 지정하여 사용합니다(기본값은 시스템의 런타임 또는 Message Queue와 함께 제공되는 런타임 사용).
-m metricType
표시할 메트릭 정보의 유형을 지정합니다. 이 옵션은 metrics dst, metrics svc 또는 metrics bkr 하위 명령에 사용됩니다. metricType 값은 메트릭이 대상, 서비스 또는 브로커 중 어느 것에 대해 생성되었는지에 따라 다릅니다.
-msp numSamples
metrics bkr, metrics dst 및 metrics svc 하위 명령이 메트릭 출력에 표시하는 메트릭 샘플 수를 지정합니다.
-n argumentName
하위 명령 인수의 이름을 지정합니다. 하위 명령에 따라 서비스나 물리적 대상, 영구 가입의 이름일 수도 있고 연결 아이디나 트랜잭션 아이디일 수도 있습니다.
-o attribute=value
속성의 값을 지정합니다. 하위 명령 인수에 따라 브로커(imqcmd 명령 유틸리티 사용 참조), 서비스(연결 서비스 관리 참조) 또는 대상(영구 가입 관리 참조)의 속성이 될 수 있습니다.
-p password
자신(관리자)의 비밀번호를 지정합니다. 이 옵션은 더 이상 사용되지 않으며 향후 릴리스에서는 지원되지 않습니다. 다음 중 하나를 대신 사용합니다.
-passfile path
명령을 실행하는 사용자의 비밀번호가 들어 있는 파일의 경로를 지정합니다. 자세한 내용은 Passfile 사용을 참조하십시오.
-pst pauseType
대상을 일시 중지할 때 생성자나 사용자 또는 둘 다를 일시 중지할지 여부를 지정합니다. 영구 가입 관리를 참조하십시오.
-rtm timeout
imqcmd 하위 명령의 초기(다시 시도) 시간 초과 기간(초)을 지정합니다. 시간 초과는 imqcmd 하위 명령이 브로커에 요청한 후 기다리는 시간입니다. 이후 하위 명령이 다시 시도할 때마다 초기 시간 초과 기간의 배수인 시간 초과 값을 사용합니다. 기본값: 10
-rtr numRetries
imqcmd 하위 명령이 처음으로 시간 초과된 후에 다시 시도하는 횟수를 지정합니다. 기본값: 5
-s
비대화형 모드입니다. 출력이 표시되지 않습니다.
-secure
ssladmin 연결 서비스를 사용해서 브로커에 대한 보안 관리 연결을 지정합니다(4단계. SSL기반 클라이언트 구성 및 실행 참조). 이 옵션을 생략하면 연결이 보안되지 않습니다.
-svn serviceName
연결을 나열할 서비스를 지정합니다. 연결 정보 얻기를 참조하십시오.
-t destType
대상의 유형을 지정합니다. t (주제) 또는 q (대기열). 영구 가입 관리를 참조하십시오.
-tmp
임시 대상을 표시합니다. 표 13-5를 참조하십시오.
-u userName
자신(관리자)의 이름을 지정합니다. 이 값을 생략하면 값을 묻는 메시지가 표시됩니다.
-v
버전 정보를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
이 옵션에는 사용자 아이디와 비밀번호가 필요하지 않습니다.
참조
imqbrokerd 사용 및 명령 예에 대한 자세한 내용은 5장, "브로커 관리" 및 6장, "물리적 대상 관리"를 참조하십시오.
imqobjmgr객체 관리자 유틸리티 imqobjmgr은 Message Queue 관리 대상 객체를 만들고 관리합니다.
구문
imqobjmgr subcommand [options]
imqobjmgr -h|H
imqobjmgr -v하위 명령
객체 관리자 유틸리티(imqobjmgr)에는 표 13-3에 나열된 하위 명령이 포함되어 있습니다.
표 13-11 imqobjmgr 하위 명령
하위 명령
설명
add
객체 저장소에 관리 대상 객체를 추가합니다.
delete
객체 저장소에서 관리 대상 객체를 삭제합니다.
list
객체 저장소에 있는 관리 대상 객체를 나열합니다.
query
지정한 관리 대상 객체에 대한 정보를 표시합니다.
update
객체 저장소에 있는 기존 관리 대상 객체를 수정합니다.
명령 옵션
표 13-12에는 imqobjmgr 명령의 옵션이 나열되어 있습니다. 사용 설명은 다음에서 해당 작업 기반 절을 참조하십시오.
표 13-12 imqobjmgr 옵션
옵션
설명
-f
사용자의 확인 없이 작업을 수행합니다.
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-H
사용 도움말, 속성 목록 및 예를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-i fileName
하위 명령 절의 일부 또는 전부를 포함하는 명령 파일 이름을 지정하며, 객체 유형, 조회 이름, 객체 속성, 객체 저장소 속성 또는 기타 옵션을 지정합니다. 보통은 객체 저장소 속성과 같은 반복 정보에 사용됩니다.
-j attribute=value
JNDI 객체 저장소를 확인하고 액세스할 때 필요한 속성을 지정합니다. 객체 저장소 정보를 참조하십시오.
-javahome path
Java 2와 호환할 수 있는 대체 런타임을 지정하여 사용합니다(기본값은 시스템의 런타임 또는 Message Queue와 함께 제공되는 런타임 사용).
-l lookupName
관리 대상 객체의 JNDI 조회 이름을 지정합니다. 이 이름은 관리 대상 객체 저장소의 컨텍스트에서 고유해야 합니다.
-o attribute=value
관리 대상 객체의 속성을 지정합니다. 16장, "관리 대상 객체 속성 참조"를 참조하십시오.
-pre
미리 보기 모드입니다. 명령을 수행하지 않고 수행 결과를 확인합니다.
-r read-only_state
관리 대상 객체가 읽기 전용인지 여부를 지정합니다. true 값은 관리 대상 객체가 읽기 전용임을 나타냅니다. 클라이언트는 읽기 전용 관리 대상 객체의 속성을 수정할 수 없습니다. 읽기 전용 상태는 기본적으로 false로 설정됩니다.
-s
비대화형 모드입니다. 출력이 표시되지 않습니다.
-t objectType
Message Queue 관리 대상 객체의 유형을 지정합니다.
q = 대기열
t = 주제
cf = 연결 팩토리
qf = 대기열 연결 팩토리
tf = 주제 연결 팩토리
xcf = XA 연결 팩토리(분산 트랜잭션)
xqf = XA 대기열 연결 팩토리(분산 트랜잭션)
xtf = XA 주제 연결 팩토리(분산 트랜잭션)
e = SOAP endpoint(Message Queue Developer’s Guide for Java Clients에서 설명한 것처럼 이 관리 대상 객체 유형은 SOAP 메시지를 지원하는 데 사용됨)
-v
버전 정보를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
참조
imqobjmgr 및 명령 예에 대한 자세한 내용은 8장, "관리 대상 객체 관리"를 참조하십시오.
imqdbmgr데이터베이스 관리자 유틸리티(imqdbmgr)는 지속성에 필요한 스키마를 설정합니다. imqdbmgr 명령을 사용하여 손상된 Message Queue 데이터베이스 테이블을 삭제하거나 데이터 저장소를 변경할 수도 있습니다.
구문
imqdbmgr subcommand argument [options]
imqdbmgr -h|-help
imqdbmgr -v|-version하위 명령
데이터베이스 관리자 유틸리티(imqdbmgr)에는 표 13-13에 나열된 하위 명령이 포함되어 있습니다.
표 13-13 imqdbmgr 하위 명령
하위 명령 및 인수
설명
create all
새 데이터베이스와 Message Queue 영구 저장소 스키마를 만듭니다. 이 명령은 내장 데이터베이스 시스템에 사용되며, 사용하는 경우에는 imq.persist.jdbc.createdburl 등록 정보를 지정해야 합니다.
create tbl
기존 데이터베이스 시스템에 Message Queue 영구 저장소 스키마를 만듭니다. 이 명령은 외부 데이터베이스 시스템에 사용됩니다.
delete tbl
현재 영구 저장소 데이터베이스에서 기존 Message Queue 데이터베이스 테이블을 삭제합니다.
delete oldtbl
이전 버전의 영구 저장소 데이터베이스에서 Message Queue 데이터베이스 테이블을 모두 삭제합니다. 영구 저장소가 자동으로 현재 버전의 Message Queue로 이전된 이후에 사용합니다.
recreate tbl
현재 영구 저장소 데이터베이스에서 기존 Message Queue 데이터베이스 테이블을 삭제한 후 Message Queue 영구 저장소 스키마를 다시 만듭니다.
reset lck
영구 저장소 데이터베이스를 다른 프로세스에서 사용할 수 있도록 잠금을 재설정합니다.
명령 옵션
표 13-14에는 imqdbmgr 명령의 옵션이 나열되어 있습니다.
표 13-14 imqdbmgr 옵션
옵션
설명
-Dproperty=value
지정한 등록 정보를 지정한 값으로 설정합니다.
-b instanceName
브로커 인스턴스 이름을 지정하고 해당 인스턴스 구성 파일을 사용합니다.
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-p password
데이터베이스 비밀번호를 지정합니다. 이 옵션은 더 이상 사용되지 않으며 향후 릴리스에서는 지원되지 않습니다. 다음 중 하나를 대신 사용합니다.
-passfile path
데이터베이스 비밀번호가 들어 있는 파일의 경로를 지정합니다. 자세한 내용은 Passfile 사용을 참조하십시오.
-u name
데이터베이스 사용자 아이디를 지정합니다.
-v
버전 정보를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
참조
영구 저장소 설정에 대한 자세한 내용은 영구 저장소 설정을 참조하십시오.
imqusermgr사용자 관리자 유틸리티(imqusermgr)를 사용하면 플랫 파일 사용자 저장소를 편집하거나 채울 수 있습니다. imqusermgr을 사용하기 전에 주의해야 할 사항은 다음과 같습니다.
구문
imqusermgr subcommand [options]
imqusermgr -h
imqusermgr -v하위 명령
표 13-15에는 이 장에서 설명하는 imqusermgr 하위 명령이 나열되어 있습니다.
표 13-15 imqusermgr 하위 명령
하위 명령
설명
add [-i instanceName] -u userName -p passwd
[-g group] [-s]지정한(또는 기본) 브로커 인스턴스 저장소에 사용자와 관련 비밀번호를 추가하고 선택적으로 사용자 그룹을 지정합니다.
delete [-i instanceName] -u userName [-s] [-f]
지정한(또는 기본) 브로커 인스턴스 저장소에서 지정한 사용자를 삭제합니다.
list [-i instanceName] [-u userName]
지정한(또는 기본) 브로커 인스턴스 저장소의 지정한 사용자 또는 모든 사용자에 대한 정보를 표시합니다.
update [-i instanceName] -u userName -p passwd
[-a state] [-s] [-f]update [-i instanceName] -u userName -a state
[-p passwd] [-s] [-f]지정한(또는 기본) 브로커 인스턴스 저장소에 있는 지정한 사용자의 비밀번호 및/또는 상태를 업데이트합니다.
명령 옵션
표 13-16에는 imqusermgr 명령의 옵션이 나열되어 있습니다.
표 13-16 imqusermgr 옵션
옵션
설명
-a active_state
사용자 상태의 활성화 여부를 지정합니다(true/false). true 값은 활성화 상태를 나타내며 기본값입니다.
-f
사용자의 확인 없이 작업을 수행합니다.
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-i instanceName
명령이 적용될 브로커 인스턴스 사용자 저장소를 지정합니다. 지정하지 않으면 기본 인스턴스 이름 imqbroker인 것으로 가정합니다.
-p passwd
사용자의 비밀번호를 지정합니다.
-g group
사용자 그룹을 지정합니다. 유효한 값에는 admin, user, anonymous가 있습니다.
-s
자동 모드를 설정합니다.
-u userName
사용자 아이디를 지정합니다.
-v
버전 정보를 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
참조
플랫 파일 사용자 저장소 설정 및 관리에 대한 자세한 내용과 imqusermgr 명령 예는
플랫 파일 사용자 저장소 사용을 참조하십시오.
imqsvcadmin서비스 관리(imqsvcadmin) 유틸리티는 브로커를 Windows 서비스로 설치합니다.
구문
imqsvcadmin subcommand [options]
imqsvcadmin -h
하위 명령
Message Queue 서비스 관리자 유틸리티(imqsvcadmin)에는 표 13-17에 나열된 하위 명령이 포함됩니다.
표 13-17 imqsvcadmin 하위 명령
하위 명령
설명
install
서비스를 설치하고 시작 옵션을 지정합니다.
query
imqsvcadmin 명령의 시작 옵션을 표시합니다. 여기에는 서비스의 수동 또는 자동 시작, 위치, Java 런타임 위치, 시작할 때 브로커에 전달되는 인수 값이 포함됩니다.
remove
서비스를 제거합니다.
명령 옵션
표 13-18에는 imqsvcadmin 명령의 옵션이 나열되어 있습니다.
표 13-18 imqsvcadmin 옵션
옵션
설명
-h
사용 도움말을 표시합니다. 명령줄에 있는 명령은 실행되지 않습니다.
-javahome path
Java 2와 호환할 수 있는 대체 런타임의 경로로 지정하여 사용합니다(기본값은 시스템의 런타임이나 Message Queue와 함께 제공되는 런타임 사용).
예: imqsvcadmin -install -javahome d:\jdk1.4
-jrehome path
Java 2 호환 JRE의 경로를 지정합니다.
예: imqsvcadmin -install -jrehome d:\jre\1.4
-vmargs arg [[arg]...]
브로커 서비스를 실행하는 Java VM에 전달할 추가 인수를 지정합니다. (이러한 인수는 Windows 서비스 제어판 시작 매개 변수 필드에서 지정할 수도 있습니다.)
예: -vmargs "-Xms16m -Xmx128m"
-args arg [[arg]...]
브로커 서비스에 전달할 추가 명령줄 인수를 지정합니다. imqbrokerd 옵션에 대한 설명은 imqbrokerd를 참조하십시오.
(이러한 인수는 Windows 서비스 제어판 시작 매개 변수 필드에서 지정할 수도 있습니다.) 예를 들면 다음과 같습니다.
imqsvcadmin -install
-args “passfile d:\imqpassfile”
-javahome, -vmargs, -args 옵션을 사용해서 지정하는 정보는 Windows 레지스트리의 다음 경로에 있는 JREHome, JVMArgs, ServiceArgs 키 아래에 저장됩니다.
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet
\Services\iMQ_Broker\Parameters참조
Message Queue를 Windows 서비스로 실행에 관한 자세한 내용은 자동 시작(Windows)을 참조하십시오.
imqkeytoolimqusermgr 명령은 브로커에 대해 자체 서명된 인증서를 생성합니다. ssljms, ssladmin 또는 cluster 연결 서비스에 동일한 인증서를 사용할 수 있습니다. UNIX 시스템의 경우 superuser(root) 계정에서 imqkeytool을 실행해야 할 수도 있습니다.
구문
imqkeytool -broker
참조
보안 연결 설정에 대한 자세한 내용은 SSL 기반 서비스 작업을 참조하십시오.