Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Pause JMS server message operations on restart

Before you begin

- Create JMS servers

For troubleshooting purpose, you can temporarily pause all message production, insertion (in-flight messages), and consumption operations on all destinations targeted to this JMS server upon restarting the host server. These message pause and resume options allow you to assert administrative control of the JMS subsystem behavior 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 configure message pausing on a JMS server's destinations upon restarting the host server:

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, expand Services > Messaging and select JMS Servers.
3. On the Summary of JMS Servers page, click the JMS server you want to configure for message pausing.
4. On the Configuration: General page, click the Advanced button to define the message pausing options:
   1. Select the Insertion Paused At Startup check box to indicate whether the insertion of "in-flight" messages is paused on all destinations targeted to this JMS server when the host server is restarted. When a JMS server's destinations are 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 destinations. To resume the insertion of in-flight messages to destinations targeted to this JMS server, clear this check box and restart the host server.
   2. Select the Production Paused At Startup check box to indicate whether production of new messages is paused on all destinations targeted to this JMS server when the host server is restarted. When a JMS server's destinations are paused for production, it prevents any new message production operations from both new and existing producers attached to those destinations. To resume message production to destinations targeted to this JMS server, clear this check box and restart the host server.
   3. Select the Consumption Paused At Startup check box to indicate whether message consumption is paused on all destinations targeted to this JMS server when the host server is restarted. When a JMS server's destinations are paused for consumption, it prevents any further message consumption operations from those destinations. To resume the consumption of messages on destinations targeted to this JMS server, clear this check box and restart the host server.

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

5. Click Save.
6. 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).

Result

After you finish

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