37/37

# 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` | `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) 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_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