Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java System Message Queue 3 2005Q4 Administration Guide 

Appendix D
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 Chapter 13, "Command Line Reference."


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 username 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)

Table D-1 lists frequently used broker configuration properties. For a full list of broker configuration properties and their descriptions, see Chapter 14, "Broker Properties Reference."

Table D-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

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)

Table D-2 lists frequently used destination configuration properties. For a full list of destination configuration properties and their descriptions, see Chapter 15, "Physical Destination Property Reference."

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

Property

Notes

consumerFlowLimit

Specify -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



Previous      Contents      Index      Next     


Part No: 819-2571-10.   Copyright 2005 Sun Microsystems, Inc. All rights reserved.