Appendix E Frequently Used Command Utility Commands

This appendix lists some frequently used Message Queue Command utility ( imqcmd) commands. For a comprehensive list of command options and attributes available to you from the command line, refer to Command Utility in Command Utility

Syntax

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

-H or -h provides comprehensive help. The -v subcommand provides version information.

When you use imqcmd, the Command utility prompts you for a password. To avoid the prompt (and to increase security), you can use the -passfile pathToPassfile option to point the utility to a password file that contains the administrator user name and password.

Example: imqcmd query bkr -u adminUserName -passfile pathToPassfile -b myServer:7676

Broker and Cluster Management

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

Broker Configuration Properties (-o option)

Broker Configuration Properties (-o option) lists frequently used broker configuration properties. For a full list of broker configuration properties and their descriptions, see Chapter 17, Broker Properties Reference

Table E–1 Broker Configuration Properties ( -o option)

Property	Notes
imq.autocreate.queue
imq.autocreate.queue.maxNumActiveConsumers	Specify -1 for unlimited
imq.autocreate.queue.maxNumBackupConsumers	Specify -1 for unlimited
imq.autocreate.topic
imq.cluster.url
imq.destination.DMQ.truncateBody
imq.destination.logDeadMessages
imq.log.file.rolloverbytes	Specify -1 for unlimited
imq.log.file.rolloversecs	Specify -1 for unlimited
imq.log.level	NONEERRORWARNINGINFO
imq.message.max_size	Specify -1 for unlimited
imq.portmapper.port
imq.system.max_count	Specify -1 for unlimited
imq.system.max_size	Specify -1 for unlimited

Service and Connection Management

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

Durable Subscriber Management

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"

Transaction Management

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

Destination Management

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

Destination Configuration Properties (-o option)

Destination Configuration Properties (-o option) lists frequently used destination configuration properties. For a full list of destination configuration properties and their descriptions, see Chapter 18, Physical Destination Property Reference

Table E–2 Destination Configuration Properties (-o option)

Property	Notes
consumerFlowLimit	Specify -1 for unlimited
isLocalOnly (create only)
limitBehavior	FLOW_CONTROLREMOVE_OLDESTREJECT_NEWESTREMOVE_LOW_PRIORITY
localDeliveryPreferred (queue only)
maxNumActiveConsumers (queue only)	Specify -1 for unlimited
maxNumBackupConsumers (queue only)	Specify -1 for unlimited
maxBytesPerMsg	Specify -1 for unlimited
maxNumMsgs	Specify -1 for unlimited
maxNumProducers	Specify -1 for unlimited
maxTotalMsgBytes	Specify -1 for unlimited
useDMQ

Metrics

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