Frequently Used Command Utility Commands

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)

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

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`	NONE``ERROR``WARNING``INFO
`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

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

NONE``ERROR``WARNING``INFO

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)

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

Property	Notes
`consumerFlowLimit`	Specify `0` or `-1` for unlimited
`isLocalOnly` (create only)	+
`limitBehavior`	FLOW_CONTROL``REMOVE_OLDEST``REJECT_NEWEST``REMOVE_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`	+

consumerFlowLimit

Specify 0 or -1 for unlimited

isLocalOnly (create only)

limitBehavior

FLOW_CONTROL``REMOVE_OLDEST``REJECT_NEWEST``REMOVE_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

E Frequently Used Command Utility Commands

Syntax

Broker and Cluster Management

Broker Configuration Properties (-o option)

Service and Connection Management

Durable Subscriber Management

Transaction Management

Destination Management

Destination Configuration Properties (-o option)

Metrics

Broker Configuration Properties (`-o` option)

Destination Configuration Properties (`-o` option)