Pausing and Resuming Physical Destinations

You can pause a physical destination to control the delivery of messages from producers to the destination, or from the destination to consumers, or both. In particular, you can pause the flow of messages into a destination to help prevent destinations from being overwhelmed with messages when production of messages is much faster than consumption. You must pause a physical destination before compacting it.

To pause the delivery of messages to or from a physical destination, use the pause dst subcommand. This is the syntax of the pause dst subcommand:

pause dst [-t destType -n 
destName] [-pst pauseType]

The subcommand pauses the delivery of messages to consumers (-pst CONSUMERS ), or from producers (-pst PRODUCERS), or both ( -pst ALL), for the destination of the specified type and name. If no destination type and name are specified, all physical destinations are paused. The default is ALL.

Example:

imqcmd pause dst -n myQueue -t q -pst PRODUCERS -u admin
imqcmd pause dst -n myTopic -t t -pst CONSUMERS -u admin

To resume delivery to a paused destination, use the resume dst subcommand. This is the syntax of the resume dst subcommand:

resume dst [-t destType -n 
destName]

The subcommand resumes delivery of messages to the paused destination of the specified type and name. If no destination type and name are specified, all destinations are resumed.

Example:

imqcmd resume dst -n myQueue -t q

In a broker cluster, instances of the physical destination reside on each broker in the cluster. You must pause each one individually.