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 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 Physical Destination Property Reference

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

Property	Notes
`consumerFlowLimit`	Specify `0` or `-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