Oracle eMail Server Administrator's Guide Release 5.2 A86653-01 |
| Library | Service | Index

# 16
Managing Queues

Each eMail Server node has messaging queues that contain messages waiting for delivery, rerouting, garbage collection, or some other messaging function. Using OOMGR, you can monitor and control the message queues and the messages they contain to ensure the smooth delivery of messages and optimize system performance.

This chapter contains the following topics:

- Displaying a List of Message Queues on a Node

- Displaying a List of Messages in a Queue

- Suspending a Message

- Restarting a Suspended Message

- Removing (Bouncing) a Message

- Emptying the Dead Message Queue

- Rerouting a Queue

- Suspending a Queue

- Restarting a Suspended Queue

## Displaying a List of Message Queues on a Node

You can display a list of message queues to see what queues are available on a local node and to determine the queue ID for a particular queue.

### Steps for Displaying a List of Message Queues on a Node

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues.

3. In the right pane, select the Queue List tab.

#### In OOMGR

1. Start OOMGR on the node with the queue list that you want to display.

2. Enter the following command at the OOMGR prompt:

       IOFCMGR>display queue;

## Displaying a List of Messages in a Queue

You can display a list of the messages in any of the message queues to see what messages are in a particular queue and to determine the message ID for a particular message in that queue.

### Prerequisites to Displaying a List of Messages in a Queue

The Administration Tool updates the queue display periodically based on a poll rate that you can set. Refer to the online help in the Administration Tool for instructions on setting the poll rate or polling the queues manually.

### Steps for Displaying a List of Messages in a Queue

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the right pane, select the Messages tab. Active messages appear in blue. Suspended messages appear in black.

#### In OOMGR

1. Start OOMGR on the local node.

2. Determine the queue ID of the queue that you want to display. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Enter the following command at the OOMGR prompt:

       IOFCMGR>display message queueid=<queue_ID>;

## Suspending a Message

You can suspend the transmission of a single message if that message is causing trouble.

### Steps for Suspending a Message

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the right pane, select the Messages tab.

4. In the Messages tab, select the message that you want to suspend.

5. In the toolbar, click (Suspend Message).

#### In OOMGR

1. Start OOMGR on the node with the queue containing the message that you want to suspend.

2. Determine the queue ID of the queue containing the message that you want to suspend. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Determine the message ID of the message that you want to suspend.

   See Also: "Displaying a List of Messages in a Queue" for instructions.

4. Enter the following command at the OOMGR prompt:

       IOFCMGR>suspend message queueid=<queue_ID> msgid=<message_ID>;

## Restarting a Suspended Message

Once you have solved the problem that caused you to suspend a message, you should restart the message so that it can be processed.

### Steps for Restarting a Suspended Message

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the right pane, select the Messages tab.

4. In the Messages tab, select the message that you want to restart.

5. In the toolbar, click (Activate Message).

#### In OOMGR

1. Start OOMGR on the node with the queue containing the message that you want to restart.

2. Determine the queue ID of the queue containing the message that you want to restart. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Determine the message ID of the message that you want to restart. Refer to "Displaying a List of Messages in a Queue" for instructions.

4. Enter the following command at the OOMGR prompt:

       IOFCMGR>resume message queueid=<queue_ID> msgid=<message_ID>;

## Removing (Bouncing) a Message

If you cannot solve the problem with an active message that is having trouble in either a remote or gateway queue, you can remove or bounce the message from the queue. When you bounce a message, the sender of the message receives a non-delivery message containing the reason that the message cannot be sent.

### Prerequisites to Removing (Bouncing) a Message

Before bouncing a message, make sure the message is active. You cannot bounce suspended messages. In the Administration Tool, active messages appear in blue and suspended messages appear in black. Refer to "Restarting a Suspended Message" for instructions.

### Steps for Removing (Bouncing) a Message

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the right pane, select the Messages tab.

4. In the Messages tab, select the message that you want to bounce.

5. In the toolbar, click (Bounce Message).

#### In OOMGR

1. Start OOMGR on the node with the queue containing the message that you want to bounce.

2. Determine the queue ID of the queue containing the message that you want to bounce. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Determine the message ID of the message that you want to bounce. Refer to "Displaying a List of Messages in a Queue" for instructions.

4. Enter the following command at the OOMGR prompt:

       IOFCMGR>bounce queueid=<queue_ID> msgid=<message_ID>;

## Emptying the Dead Message Queue

You should check and empty the Dead Message queue periodically, so that it does not continue to grow over time. You can automate this task by setting the `deadMsgHold` parameter for the postman process so that dead messages are automatically removed by the collector process after the specified number of days.

See Also: "Postman Process Parameters" for more information about the `deadMsgHold` parameter

## Rerouting a Queue

If a remote queue becomes blocked by a message, you should reroute the messaging traffic directed to that queue before you suspend it to determine the problem. This procedure only works with a remote queue.

### Prerequisites to Rerouting a Queue

1. Change the message delivery routes so that the blocked route is not the lowest-cost route. Refer to "Creating a Message Delivery Route for a Community" for instructions.

   Wait until the replicator process propagates the change before beginning another configuration task.

   The time necessary to propagate the information depends on the replicator and postman process schedules, and on the number of nodes through which the information must travel. Refer to "Checking Replicator Status" for instructions.

2. Check to be sure the new message delivery route information has reached the node with the blocked queue by displaying the message delivery route information for that node. Refer to "Displaying Message Delivery Route Information" for instructions.

3. On the node with the blocked queue, refresh each instance of the postman process so that they will use the new message delivery route information. Refer to "Refreshing a Process" for instructions.

### Steps for Rerouting a Queue

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the toolbar, click (Reroute Queue).

4. In the dialog box, enter the name of the queue to which messages should be rerouted in the Target Queue text box.

5. Click OK.

#### In OOMGR

1. Start OOMGR on the node with the blocked queue.

2. Enter the following command at the OOMGR prompt:

       IOFCMGR>reroute sourceq=<blocked_queueID> targetq=<alternate_queueID>;

## Suspending a Queue

You can suspend a queue to help you isolate a message delivery problem, or stop messages from going to a node that is not running. You can suspend the submission, remote, and gateway queues.

### Prerequisites to Suspending a Queue

Before suspending a queue, reroute the messaging traffic directed to the queue that you want to suspend. Refer to "Rerouting a Queue" for instructions.

### Steps for Suspending a Queue

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the toolbar, click (Suspend Queue).

#### In OOMGR

1. Start OOMGR on the node where you want to suspend the queue.

2. Determine the queue ID of the queue that you want to suspend. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Enter the following command at the OOMGR prompt:

       IOFCMGR>suspend queue queueid=<queue_ID>;

## Restarting a Suspended Queue

Once you have solved the problem that caused you to suspend a queue, you should restart the queue.

Note: Restarting a queue does not activate any message in that queue that you explicitly suspended. Refer to "Restarting a Suspended Message" for instructions on reactivating a suspended message.

### Steps for Restarting a Suspended Queue

This task can be performed through either the Administration Tool GUI, or the OOMGR command-line interface.

#### In the Administration Tool GUI

1. Start the Administration Tool GUI.

2. In the navigation tree, select Messaging System > Nodes > Queues > queue_name.

3. In the toolbar, click (Activate Queue).

#### In OOMGR

1. Start OOMGR on the node with the suspended queue.

2. Determine the queue ID of the queue that you want to restart. Refer to "Displaying a List of Message Queues on a Node" for instructions.

3. Enter the following command at the OOMGR prompt:

       IOFCMGR>resume queue queueid=<queue_ID>;

| Copyright © 2001 Oracle Corporation. All Rights Reserved. |
| Library | Service | Index