Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Pause JMS server message operations at runtime

Before you begin

- Create JMS servers

For troubleshooting purposes, you can temporarily pause all run-time message production, insertion (in-flight messages), and consumption operations on all destinations targeted to this JMS server. These "message pausing" 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 pause or resume run-time message activity on a JMS server's destinations:

1. In the Administration Console, expand Services > Messaging and select JMS Servers.
2. On the Summary of JMS Servers page, click the JMS server you want to configure for message pausing.
3. Click the Control tab.
4. In the Servers table, select the current JMS server to control, and then select one of the message control operations:
   1. Click the Production button, and then click the Pause option to stop production of new messages on all destinations targeted to this JMS server. 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, click the Production button, and then click the Resume option.
   2. Click the Consumption button, and then click the Pause option to stop message consumption is paused on all destinations targeted to this JMS server. 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, click the Consumption button, and then click the Resume option.
   3. Click the Insertion button, and then click the Pause option to stop the insertion of "in-flight" messages on all destinations targeted to this JMS server. 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, click the Insertion button, and then click the Resume option.

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

Result