Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Pause topic message operations on server restart

Before you begin

- Create topics in a system module

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

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 topic resource that you want to configure:
   - Navigate to JMS Resources in System Modules
   - Navigate to JMS resources in an application module
3. 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 this topic when the host server is restarted. When a topic 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 topic. To resume the insertion of in-flight messages to destinations targeted to the topic, 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 this topic when the host server is restarted. When a topic is paused for message production, it prevents any new message production operations from both new and existing producers attached to the topic. To resume message production to this topic, 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 this topic when the host server is restarted. When a topic is paused for message consumption, it prevents any further message consumption operations from the topic. To resume the consumption of messages on this topic, clear this check box and restart the host server.

   For more information about these fields, see Configuration Options.

4. Save your changes:
   - Save Changes to JMS Resources in System Modules
   - Save changes to JMS resources in an application module
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 topic, you must restart the Administration Server.