Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Pause queue message operations on server restart

Before you begin


In the event that you need to troubleshoot a configured queue, you can temporarily pause all message production, insertion (in-flight messages), and consumption operations on a queue-by-queue basis. By temporarily pausing message production and insertion to a queue, you can effectively drain all the existing messages for troubleshooting purposes, and then resume message production and insertions once the issue has been resolved.

To configure message pausing for a queue:

  1. If you have not already done so, in the Change Center of the Administration Console, click Lock & Edit (see Use the Change Center).
  2. In the Administration Console, navigate to the queue resource that you want to configure:
  3. On the Configuration: General page, click the Advanced button to define the message pausing options:
    1. Select the Pause Message Insertion At Startup check box to indicate whether the insertion of "in-flight" messages is paused on this queue when the host server is restarted. When a queue is paused for message insertion, then in addition to pausing the new message production operations, all 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 to destinations targeted to the queue, clear this check box and restart the host server.
    2. Select the Pause Message Production At Startup check box to indicate whether production of new messages is paused on this queue when the host server is restarted. When a queue is paused for message production, it prevents any new message production operations from both new and existing producers attached to the queue. To resume message production to this queue, clear this check box and restart the host server.
    3. Select the Pause Message Consumption At Startup check box to indicate whether message consumption is paused on this queue when the host server is restarted. When a queue is paused for message consumption, it prevents any further message consumption operations from the queue. To resume the consumption of messages on this queue, clear this check box and restart the host server.

    For more information about these fields, see Configuration Options.

  4. Save your changes:
  5. To activate these changes, in the Change Center of the Administration Console, click Activate Changes.
    Not all changes take effect immediately—some require a restart (see Use the Change Center).

After you finish

If you modify message pausing options on a queue, you must restart the Administration Server.


Back to Top