13장 명령줄 참조

하위 명령 및 명령 수준의 인수(있는 경우)는 모든 옵션과 인수 앞에 와야 합니다. 옵션 자체는 임의 순서대로 나타날 수 있습니다. 모든 하위 명령, 명령 인수, 옵션 및 옵션 인수는 공백으로 구분됩니다. 옵션 인수 값에 공백이 포함되어 있는 경우 전체 값을 따옴표로 묶어야 합니다. 일반적으로 속성 값 쌍을 따옴표로 묶는 것이 가장 안전합니다.

기본 브로커를 시작하는 다음 명령은 하위 명령절이 없는 명령줄의 예입니다.

imqbrokerd

다음은 전체 명령줄의 예입니다.

imqcmd destroy dst -t q -n myQueue -u admin -f -s

이 명령은 myQueue라는 대기열 대상(대상 유형 q)을 완전 삭제합니다. 인증은 사용자 이름 admin에 대해 수행됩니다. 비밀번호를 묻는 메시지가 표시됩니다. 이 명령은 확인 메시지를 표시하지 않고(-f 옵션) 자동 모드로 수행되며 어떠한 출력도 표시하지 않습니다(-s 옵션).

브로커 유틸리티

브로커 유틸리티(imqbrokerd)는 브로커를 시작합니다. 명령줄 옵션은 현재 브로커 세션에 대해서만 브로커 구성 파일의 값을 무시합니다.

표 13-1에서는 imqbrokerd 명령의 옵션과 각 옵션으로 대체되는 구성 등록 정보(있는 경우)를 보여줍니다.

표 13-1 브로커 유틸리티 옵션
옵션	대체되는 등록 정보	설명
-name instanceName	imq.instancename	브로커의 인스턴스 이름 동일한 호스트에서 실행 중인 여러 브로커 인스턴스에는 서로 다른 인스턴스 이름이 있어야 합니다. 기본값: imqbroker
-port portNumber	imq.portmapper.port	브로커의 포트 매퍼 포트 번호 Message Queue 클라이언트는 이 포트 번호를 사용하여 브로커에 연결합니다. 동일한 호스트에서 실행 중인 여러 브로커 인스턴스에는 서로 다른 포트 매퍼 포트 번호가 있어야 합니다. 기본값: 7676
-cluster broker1 [ [,broker2 ] � ]	imq.cluster.brokerlist	브로커를 클러스터에 연결1 지정된 브로커는 imq.cluster.brokerlist 등록 정보의 목록과 병합됩니다. 각 브로커 인수는 다음 형태 중 하나입니다. hostName:portNumber hostName :portNumber hostName을 생략하는 경우에는 기본값이 localhost입니다. portNumber를 생략하는 경우에는 기본값이 7676입니다.
-Dproperty=value	인스턴스 구성 파일의 해당 등록 정보	구성 등록 정보 설정 브로커 구성 등록 정보에 대한 자세한 내용은 14장, "브로커 등록 정보 참조"를 참조하십시오. 주의: 이 옵션을 사용하여 설정한 등록 정보의 형식과 맞춤법에 주의하십시오. 잘못된 값은 알림이나 경고 없이 무시됩니다.
-reset props	없음	구성 등록 정보 재설정 브로커의 기존 인스턴스 구성 파일(config.properties)을 빈 파일로 바꿉니다. 모든 등록 정보에 기본값이 설정됩니다.
-reset store	없음	영구 데이터 저장소 재설정 데이터 저장소의 모든 영구 데이터(지속성 메시지, 영구 가입 및 트랜잭션 정보 포함)를 삭제하여 빈 상태에서 브로커 인스턴스를 시작할 수 있도록 합니다. 이후에 다시 시작할 때 영구 저장소가 재설정되지 않도록 하려면 -reset 옵션을 지정하지 않고 브로커 인스턴스를 다시 시작합니다. 지속성 메시지 또는 영구 가입만 삭제하려면 -reset messages 또는 -reset durables를 대신 사용합니다.
-reset messages	없음	데이터 저장소에서 지속성 메시지 삭제
-reset durables	없음	데이터 저장소에서 영구 가입 삭제
-backup fileName	없음	구성 변경 레코드를 파일로 백업¹ 자세한 내용은 구성 변경 기록 관리를 참조하십시오.
-restore fileName	없음	백업 파일에서 구성 변경 레코드 복원¹ -backup 옵션을 사용하여 백업 파일을 미리 작성해 두어야 합니다. 자세한 내용은 구성 변경 기록 관리를 참조하십시오.
-remove instance	없음	브로커 인스턴스 제거2 인스턴스 구성 파일, 로그 파일, 영구 저장소 및 인스턴스와 관련된 기타 파일 및 디렉토리를 삭제합니다.
-password keyPassword	imq.keystore.password	SSL 인증 키 저장소의 비밀번호3
-dbuser userName	imq.persist.jdbc.user	JDBC 기반 영구 데이터 저장소의 사용자 이름
-dbpassword dbPassword	imq.persist.jdbc.password	JDBC 기반 영구 데이터 저장소의 비밀번호³
-ldappassword ldapPassword	imq.user_repository.ldap.password	LDAP 사용자 저장소의 비밀번호³
-passfile filePath	imq.passfile.enabled imq.passfile.dirpath imq.passfile.name	비밀번호 파일의 위치 브로커의 imq.passfile.enabled 등록 정보를 true로 설정하고 imq.passfile.dirpath를 비밀번호 파일을 포함하는 경로로 설정하며 imq.passfile.name을 파일 이름 자체로 설정합니다. 자세한 내용은 비밀번호 파일 사용을 참조하십시오.
-shared	imq.jms.threadpool_model	공유 스레드 풀 모델을 사용하여 jms 연결 서비스 구현 연결 간에 예외 스레드가 공유되므로 지원되는 연결 수가 증가합니다. 브로커의 imq.jms.threadpool_model 등록 정보를 shared로 설정합니다.
-javahome path	없음	대체 Java 런타임의 위치 기본값: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
-vmargs arg1 [ [ arg2 ] � ]	없음	인수를 Java 가상 머신에 전달 인수는 공백으로 구분됩니다. 두 개 이상의 인수를 전달하거나 공백을 포함하는 인수를 전달하려면 인수 목록을 따옴표로 묶습니다. VM 인수는 명령줄을 통해서만 전달할 수 있으며, 인스턴스 구성 파일에는 관련 구성 등록 정보가 없습니다.
-license [ licenseName ]	없음	로드할 사용권이 설치된 Message Queue 제품의 기본값과 다를 경우: pe 기본 기능 사용 플랫폼판 try 엔터프라이즈 기능 사용 플랫폼판 (90일 시험 사용) unl 엔터프라이즈판 사용권 이름이 지정되지 않은 경우에는 시스템에 설치된 모든 사용권이 나열됩니다.
-upgrade-store-nobackup	없음	Message Queue 3.5 또는 3.5 SPx로 업그레이드할 때 호환되지 않는 버전의 이전 데이터 저장소를 자동으로 제거² 자세한 내용은 Message Queue 설치 설명서를 참조하십시오.
-force	없음	사용자 확인 없이 작업 수행 이 옵션은 일반적으로 확인을 필요로 하는 -remove instance 및 -upgrade-store-nobackup 옵션에만 적용됩니다.
-loglevel level	imq.broker.log.level	로깅 수준: NONE ERROR WARNING INFO 기본값: INFO
-metrics interval	imq.metrics.interval	브로커 메트릭 로깅 간격(초)
-tty	imq.log.console.output	모든 메시지를 콘솔에 기록 브로커의 imq.log.console.output 등록 정보를 ALL로 설정합니다. 지정하지 않을 경우 오류 및 경고 메시지만 기록됩니다.
-s \| -silent	imq.log.console.output	자동 모드(콘솔에 기록하지 않음) 브로커의 imq.log.console.output 등록 정보를 NONE으로 설정합니다.
-version	없음	버전 정보 표시4
-h \| -help	없음	사용 도움말 표시⁴

1이 옵션은 브로커 클러스터에만 적용됩니다.

2이 옵션은 -force를 함께 지정한 경우가 아니면 사용자의 확인이 필요합니다.

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

4명령줄에 지정된 다른 옵션은 무시됩니다.

명령 유틸리티

명령 유틸리티(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	클러스터 구성 다시 로드1 모든 지속성 정보를 최신 상태로 유지합니다.
query bkr -b hostName:portNumber	브로커 등록 정보 값 나열 또한 클러스터 내 지정된 브로커에 연결된 모든 실행 중인 브로커를 나열합니다.
metrics bkr [-b hostName:portNumber] [-m metricType] [-int interval] [-msp numSamples]	브로커 메트릭 표시 -m 옵션은 표시할 메트릭 유형을 지정합니다. ttl 브로커로 유입 또는 유출되는 메시지 또는 패킷 rts 메시지 및 패킷이 브로커로 유입 또는 유출되는 초당 속도 cxn 연결, 가상 메모리 힙 및 스레드 기본값: ttl -int 옵션은 메트릭 표시 간격(초)을 지정합니다. 기본값: 5 -msp 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음)

1이 옵션은 브로커 클러스터에만 적용됩니다.

연결 서비스 관리

표 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 주제 대상

표 13-5 물리적 대상 관리에 대한 명령 유틸리티 하위 명령
구문	설명
create dst -t destType -n destName [-o property1=value1] [ [-o property2=value2] � ]	물리적 대상 작성1 대상 이름 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 -n destName]	물리적 대상에 대한 메시지 전달 다시 시작 -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 옵션은 표시할 샘플 수를 지정합니다. 기본값: 무제한(지정되지 않음)

1마스터 브로커를 일시적으로 사용할 수 없는 클러스터에서는 이 작업을 수행할 수 없습니다.

영구 가입 관리

표 13-6에서는 영구 가입을 관리하는 데 사용되는 imqcmd 하위 명령을 나열합니다.

표 13-6 영구 가입 관리에 대한 명령 유틸리티 하위 명령
구문	설명
destroy dur -c clientID -n subscriberName	영구 가입 완전 삭제1
purge dur -c clientID -n subscriberName	영구 가입에 대한 모든 메시지 제거
list dur -d topicName	주제에 대한 영구 가입 나열

1마스터 브로커를 일시적으로 사용할 수 없는 브로커 클러스터에서는 이 작업을 수행할 수 없습니다.

트랜잭션 관리

표 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	인증에 사용되는 비밀번호1
-passfile path	비밀번호 파일의 위치 자세한 내용은 비밀번호 파일 사용을 참조하십시오.
-rtm timeoutInterval	초기 시간 초과 간격(초) 요청을 다시 시도하기 전에 명령 유틸리티가 브로커로부터 응답을 기다리는 초기 시간 길이입니다. 각 후속 재시도에서는 이 초기 간격의 배수가 되는 시간 초과 간격을 사용합니다. 기본값: 10
-rtr numRetries	브로커 요청 시간이 초과된 후 시도할 재시도 횟수 기본값: 5
-javahome path	대체 Java 런타임의 위치 기본값: 시스템에 설치된 런타임 또는 Message Queue과 함께 번들로 제공된 런타임을 사용합니다.
-f	사용자 확인 없이 작업 수행
-s	자동 모드(출력이 표시되지 않음)
-v	버전 정보 표시2^,3
-h	사용 도움말 표시²^,³
-H	속성 목록과 예를 포함하여 자세한 사용 도움말을 표시합니다.²^,³

1이 옵션은 더 이상 사용되지 않으며 추후 제거됩니다. 대신에, 비밀번호를 완전히 생략하거나(명령에서 대화식으로 비밀번호를 묻는 메시지 표시) -passfile 옵션을 사용하여 비밀번호를 포함하는 비밀번호 파일을 지정합니다.

2명령줄에 지정된 다른 옵션은 무시됩니다.

3이 옵션에는 사용자 이름과 비밀번호가 필요하지 않습니다.

객체 관리자 유틸리티

객체 관리자 유틸리티(imqobjmgr)는 Message Queue 관리 객체를 생성 및 관리합니다. 표 13-9에서는 사용 가능한 하위 명령을 나열합니다.

표 13-9 객체 관리자 하위 명령
하위 명령	설명
add	객체 저장소에 관리 객체 추가
delete	객체 저장소에서 관리 객체 삭제
list	객체 저장소의 관리 객체 나열
query	관리 객체 정보 표시
update	관리 객체 수정

표 13-10에서는 imqobjmgr 명령에 대한 옵션을 나열합니다.

표 13-10 객체 관리자 옵션
옵션	설명
-l lookupName	관리 객체의 JNDI 조회 이름
-j attribute=value	JNDI 객체 저장소 속성(객체 저장소 참조)
-t objectType	관리 객체 유형: q 대기열 대상 t 주제 대상 cf 연결 팩토리 qf 대기열 연결 팩토리 tf 주제 연결 팩토리 xcf 분산 트랜잭션의 연결 팩토리 xqf 배포 트랜잭션의 대기열 연결 팩토리 xtf 분산 트랜잭션의 주제 연결 팩토리 e SOAP 종점(Java 클라이언트용 Message Queue 개발 안내서 참조)
-o attribute=value	관리 객체 속성(관리 객체 속성 및 16장, "관리 객체 속성 참조" 참조)
-r readOnlyState	관리 객체가 읽기 전용입니까? true이면 클라이언트에서 객체 속성을 수정할 수 없습니다. 기본값: false
-i fileName	하위 명령절 전체 또는 일부를 포함하는 명령 파일의 이름
-pre	명령을 수행하지 않고 결과 미리 보기 이 옵션은 기본 속성의 값을 확인할 때 유용합니다.
-javahome path	대체 Java 런타임의 위치 기본값: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
-f	사용자 확인 없이 작업 수행
-s	자동 모드(출력이 표시되지 않음)
-v	버전 정보 표시1
-h	사용 도움말 표시¹
-H	속성 목록과 예를 포함하여 자세한 사용 도움말 표시¹

1명령줄에 지정된 다른 옵션은 무시됩니다.

데이터베이스 관리자 유틸리티

데이터베이스 관리자 유틸리티(imqdbmgr)에서는 JDBC 기반 영구 데이터 저장소의 데이터베이스 스키마를 설정합니다. 또한 이 유틸리티를 사용하여 손상된 Message Queue 데이터베이스 테이블을 삭제하거나 데이터 저장소를 변경할 수도 있습니다. 표 13-11에서는 사용 가능한 하위 명령을 나열합니다.

표 13-11 데이터베이스 관리자 하위 명령
하위 명령	설명
create all	새 데이터베이스와 영구 저장소 스키마 만들기 내장 데이터베이스 시스템에 사용됩니다. 브로커 등록 정보 imq.persist.jdbc.createdburl을 지정해야 합니다.
create tbl	기존 데이터베이스의 영구 저장소 스키마 만들기 외부 데이터베이스 시스템에 사용됩니다.
delete tbl	현재 영구 저장소에서 Message Queue 데이터베이스 테이블 삭제
delete oldtbl	이전 버전 영구 저장소에서 Message Queue 데이터베이스 테이블 삭제 영구 저장소가 현재 버전의 Message Queue로 자동 마이그레이션된 후에 사용됩니다.
recreate tbl	영구 저장소 스키마 다시 만들기 현재의 영구 저장소에서 모든 기존 Message Queue 데이터베이스 테이블을 삭제하고 스키마를 다시 만듭니다.
reset lck	영구 저장소 잠금 재설정 영구 저장소 데이터베이스를 다른 프로세스에서 사용할 수 있도록 잠금을 재설정합니다.

표 13-12에는 imqdbmgr 명령의 옵션이 나열되어 있습니다.

표 13-12 데이터베이스 관리자 옵션
옵션	설명
-b instanceName	브로커의 인스턴스 이름
-Dproperty=value	브로커 구성 등록 정보 설정 지속성 관련 브로커 구성 등록 정보에 대한 자세한 내용은 지속성 등록 정보를 참조하십시오. 주의: 이 옵션을 사용하여 설정한 등록 정보의 형식과 맞춤법에 주의하십시오. 잘못된 값은 알림이나 경고 없이 무시됩니다.
-u name	인증에 사용되는 사용자 이름
-p password	인증에 사용되는 비밀번호1
-passfile path	비밀번호 파일의 위치 자세한 내용은 비밀번호 파일 사용을 참조하십시오.
-v	버전 정보 표시2
-h	사용 도움말 표시²

2명령줄에 지정된 다른 옵션은 무시됩니다.

사용자 관리자 유틸리티

사용자 관리자 유틸리티(imqusermgr)는 플랫 파일 사용자 저장소를 채우거나 편집하는 데 사용됩니다. 이 유틸리티는 브로커가 설치된 위치와 동일한 호스트에서 실행되어야 합니다. 브로커별 사용자 저장소가 아직 없으면 먼저 해당 브로커 인스턴스를 시작하여 사용자 저장소를 만들어야 합니다. 또한 저장소에 쓸 수 있는 적절한 권한도 필요합니다. 즉, Solaris 및 Linux 플랫폼의 경우에는 해당 브로커 인스턴스를 처음으로 만든 사용자나 루트 사용자여야 합니다.

표 13-13에서는 imqusermgr 명령에서 사용할 수 있는 하위 명령을 나열합니다. 이 경우, -i 옵션은 명령의 사용자 저장소가 적용되는 브로커의 인스턴스 이름을 지정합니다. 지정하지 않을 경우 기본 이름 imqbroker가 사용됩니다.

표 13-13 사용자 관리자 하위 명령
구문	설명
add [-i instanceName] -u userName -p password [-g group]	사용자 및 비밀번호를 저장소에 추가 선택적 -g 옵션은 현재 사용자를 할당할 그룹을 지정합니다. admin user anonymous
delete [-i instanceName] -u userName	저장소에서 사용자 삭제
update [-i instanceName] -u userName -p password [-a activeState] update [-i instanceName] -u userName -a activeState [-p password]	사용자의 비밀번호 또는 활성 상태(또는 둘 다) 설정 -a 옵션은 사용자를 활성화하거나(true) 비활성화할지(false) 여부를 지정하는 부울 값을 사용합니다. 기본값: true
list [-i instanceName] [-u userName]	사용자 정보 표시 사용자 이름을 지정하지 않을 경우 저장소의 모든 사용자가 나열됩니다.

또한 표 13-14에 나열된 옵션은 imqusermgr 명령의 모든 하위 명령에 적용할 수 있습니다.

표 13-14 일반 사용자 관리자 옵션
옵션	설명
-f	사용자 확인 없이 작업 수행
-s	자동 모드(출력이 표시되지 않음)
-v	버전 정보 표시1
-h	사용 도움말 표시¹

1명령줄에 지정된 다른 옵션은 무시됩니다.

서비스 관리자 유틸리티

서비스 관리자 유틸리티(imqsvcadmin)는 브로커를 Windows 서비스로 설치합니다. 표 13-15에서는 사용 가능한 하위 명령을 나열합니다.

표 13-15 서비스 관리자 하위 명령
하위 명령	설명
install	서비스 설치
remove	서비스 제거
query	시작 옵션 표시 시작 옵션에는 서비스의 수동 또는 자동 시작, 위치, Java 런타임 위치, 시작할 때 브로커에 전달되는 인수 값이 포함됩니다.

표 13-16에는 imqsvcadmin 명령의 옵션이 나열되어 있습니다.

표 13-16 서비스 관리자 옵션
옵션	설명
-javahome path	대체 Java 런타임의 위치 기본값: 시스템에 설치된 런타임 또는 Message Queue와 함께 번들로 제공된 런타임을 사용합니다.
-jrehome path	대체 Java Runtime Environment(JRE)의 위치
-vmargs arg1 [ [arg2] � ]	브로커 서비스를 실행 중인 Java 가상 머신에 전달할 추가 인수1 예를 들면 다음과 같습니다. imqsvcadmin install -vmargs "-Xms16m -Xmx128m"
-args arg1 [ [arg2] � ]	브로커 서비스에 전달할 추가 명령줄 인수¹ 예를 들면 다음과 같습니다. imqsvcadmin install -args "-passfile d:\imqpassfile" 브로커 명령줄 인수에 대한 자세한 내용은 브로커 유틸리티를 참조하십시오.
-h	사용 도움말 표시2

1이러한 인수는 서비스의 등록 정보 창(Windows 관리 도구 제어판의 서비스 도구)에 있는 일반 탭의 시작 매개 변수 필드에서도 지정할 수 있습니다.

2명령줄에 지정된 다른 옵션은 무시됩니다.

-javahome, -vmargs 및 -args 옵션을 사용하여 지정한 모든 정보는 Windows 레지스트리의 다음 경로에 있는 JREHome, JVMArgs 및 ServiceArgs 키 아래에 저장됩니다.

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\iMQ_Broker\Parameters

키 도구 유틸리티

키 도구 유틸리티(imqkeytool)는 브로커에 대해 자체 서명한 인증서를 생성합니다. 이 인증서는 ssljms, ssladmin 또는 cluster 연결 서비스에 사용할 수 있습니다. 구문은 다음과 같습니다.

imqkeytool -broker

UNIX 시스템의 경우 superuser(root) 계정에서 이 유틸리티를 실행해야 할 수도 있습니다.

이전 목차 색인 다음

이전 목차 색인 다음
Sun Java System Message Queue 3 2005Q4 관리 설명서