Administration Console Online Help

Previous Next Open TOC in new window
Content starts here

Pause JMS template message operations on server restart

Before you begin


In the event that you need to troubleshoot a destination, you can temporarily pause all message production, insertion (in-flight messages), and consumption operations on all destinations using a JMS template. By temporarily pausing message production and insertion to destinations, 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 destinations:

  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 template 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 destination when the host server is restarted. When a destination 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 destination. To resume the insertion of in-flight messages to destinations targeted to the destination, 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 destination when the host server is restarted. When a destination is paused for message production, it prevents any new message production operations from both new and existing producers attached to the destination. To resume message production to this destination, 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 destination when the host server is restarted. When a destination is paused for message consumption, it prevents any further message consumption operations from the destination. To resume the consumption of messages on this destination, 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 JMS template, you must restart the Administration Server.


Back to Top