OTN Home > Oracle WebLogic Server 10.3.6.0 Documentation > Administration Console Online Help > Uniform distributed queues - pause message operations on server restart

Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Uniform distributed queues - pause message operations on server restart


In the event that you need to troubleshoot a uniform distributed queue, you can temporarily pause all message production, insertion (in-flight messages), and consumption operations on each queue member. By temporarily pausing message production and insertion to a distributed 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 on the members of a distributed 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 uniform distributed 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 distributed queue when the host server is restarted. When a distributed 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 distributed queue. To resume the insertion of in-flight messages to destinations targeted to the distributed 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 distributed queue when the host server is restarted. When a distributed queue is paused for message production, it prevents any new message production operations from both new and existing producers attached to the distributed queue. To resume message production to this distributed 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 distributed queue when the host server is restarted. When a distributed queue is paused for message consumption, it prevents any further message consumption operations from the distributed queue. To resume the consumption of messages on this distributed 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 distributed queue, you must restart the Administration Server.


Back to Top