附錄 D 常用指令公用程式指令

本附錄列出常用之 Message Queue^TM 指令公用程式 (imqcmd) 指令。如需指令行可用之指令選項和屬性的詳細清單，請參閱指令公用程式中的指令公用程式。

語法

imqcmd subcommand argument [
options]
imqcmd -h|H
imqcmd -v

-H 或 -h 會提供詳細的說明。-v 子命令提供版本資訊。

當您使用 imqcmd 時，指令公用程式會提示您輸入密碼。若要避免出現提示 (同時增加安全性)，您可以使用 -passfile pathToPassfile 選項，將公用程式指向包含管理員使用者名稱和密碼的密碼檔案。

範例：imqcmd query bkr -u adminUserName -passfile pathToPassfile -b myServer:7676

代理程式和叢集管理

imqcmd query bkr
imqcmd pause bkr
imqcmd restart bkr
imqcmd resume bkr
imqcmd shutdown bkr -b myBroker:7676
imqcmd update bkr -o "imq.system.max_count=1000"
imqcmd reload cls

代理程式配置特性 (-o 選項)

代理程式配置特性 (-o 選項)中列出常用的代理程式配置特性。如需代理程式配置特性及其說明的完整清單，請參閱第 14 章, 代理程式特性參照。

表 D–1 代理程式配置特性 ( -o 選項)

特性	備註
imq.autocreate.queue
imq.autocreate.queue.maxNumActiveConsumers	指定 -1 表示無限制
imq.autocreate.queue.maxNumBackupConsumers	指定 -1 表示無限制
imq.autocreate.topic
imq.cluster.url
imq.destination.DMQ.truncateBody
imq.destination.logDeadMessages
imq.log.file.rolloverbytes	指定 -1 表示無限制
imq.log.file.rolloversecs	指定 -1 表示無限制
imq.log.level	NONEERRORWARNINGINFO
imq.message.max_size	指定 -1 表示無限制
imq.portmapper.port
imq.system.max_count	指定 -1 表示無限制
imq.system.max_size	指定 -1 表示無限制

服務和連線管理

imqcmd list svc
imqcmd query svc
imqcmd update svc -n jms -o "minThreads=200" -o "maxThreads=400" -o "port=8995"
imqcmd pause svc -n jms
imqcmd resume svc -n jms
imqcmd list cxn -svn jms
imqcmd query cxn -n 1234567890

長期訂閱者管理

imqcmd list dur -d MyTopic
imqcmd destroy dur -n myDurSub -c "clientID-111.222.333.444"
imqcmd purge dur -n myDurSub -c "clientID-111.222.333.444"

作業事件管理

imqcmd list txn
imqcmd commit txn -n 1234567890
imqcmd query txn -n 1234567890
imqcmd rollback txn -n 1234567890

目標管理

imqcmd create dst -n MyQueue -t q -o "maxNumMsgs=1000" -o "maxNumProducers=5"
imqcmd update dst -n MyTopic -t t -o "limitBehavior=FLOW_CONTROL|REMOVE_OLDEST|REJECT_NEWEST|REMOVE_LOW_PRIORITY"
imqcmd compact dst -n MyQueue -t q
imqcmd purge dst -n MyQueue -t q
imqcmd pause dst -n MyQueue -t q -pst PRODUCERS|CONSUMERS|ALL
imqcmd resume dst -n MyQueue -t q
imqcmd destroy dst -n MyQueue -t q
imqcmd query dst -n MyQueue -t q
imqcmd list dst -tmp

目標配置特性 (-o 選項)

目標配置特性 (-o 選項)中列出常用的目標配置特性。如需目標配置特性及其說明的完整清單，請參閱第 15 章, 實體目標特性參照。

表 D–2 目標配置特性 (-o 選項)

特性	備註
consumerFlowLimit	指定 -1 表示無限制
isLocalOnly (僅限建立時使用)
limitBehavior	FLOW_CONTROLREMOVE_OLDESTREJECT_NEWESTREMOVE_LOW_PRIORITY
localDeliveryPreferred (僅限佇列)
maxNumActiveConsumers (僅限佇列)	指定 -1 表示無限制
maxNumBackupConsumers (僅限佇列)	指定 -1 表示無限制
maxBytesPerMsg	指定 -1 表示無限制
maxNumMsgs	指定 -1 表示無限制
maxNumProducers	指定 -1 表示無限制
maxTotalMsgBytes	指定 -1 表示無限制
useDMQ

度量

imqcmd metrics bkr -m cxn|rts|ttl -int 5 -msp 20
imqcmd metrics svc -m cxn|rts|ttl
imqcmd metrics dst -m con|dsk|rts|ttl