Administration Console Online Help

Pause queue message
operations at runtime

For troubleshooting
purposes, you can temporarily pause all run-time message production,
insertion (in-flight messages), and consumption operations on a
queue-by-queue basis. These "message pausing" options allow you to
assert administrative control of JMS destinations in the event of an
external resource failure. For example, by temporarily pausing message
production and insertion on destinations, you can effectively drain all
the existing messages for troubleshooting purposes, and then resume
production and insertions once the issue has been resolved.

To pause or resume run-time message activity on a queue:

In the
Administration Console, navigate to the queue resource that you want
to configure:

Select the
current queue to control, and then select one of the message control
operations:

Click the
Production button, and then click the
Pause option to stop production of new
messages on this queue. When a queue is paused for production, it
prevents any new message production operations from both new and
existing producers attached to that queue. To resume message
production, click the Production button,
and then click the Resume option.

Click the
Consumption button, and then click the
Pause option to stop message consumption is
paused on this queue. When a queue is paused for consumption, it
prevents any further message consumption operations from that
queue. To resume the consumption of messages, click the
Consumption button, and then click the
Resume option.

Click the
Insertion button, and then click the
Pause option to stop the insertion of
"in-flight" messages on this queue. When a queue is paused for
insertion, then in addition to pausing the new message production
operations, all the messages that are result of the in-flight work
completion are also prevented from appearing on the queue. To
resume the insertion of in-flight messages, click the
Insertion button, and then click the
Resume option.