Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Pause queue message operations at runtime

Before you begin

- Create queues in a system module

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:

1. In the Administration Console, navigate to the queue resource that you want to configure:
   - Navigate to JMS Resources in System Modules
   - Navigate to JMS resources in an application module
2. Click the Control tab.
3. Select the current queue to control, and then select one of the message control operations:
   1. 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.
   2. 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.
   3. 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.

   For more information about these fields, refer to Configuration Options.

Result