WebLogic Messaging API Class Library |

# IConnection.Stop Method

Temporarily stops a connection's delivery of incoming messages. Delivery can be restarted using the connection's `Start` method. When the connection is stopped, delivery to all the connection's message consumers is inhibited: synchronous receives block, and messages are not delivered to message listeners.

This call blocks until receives and/or message listeners in progress have completed.

Stopping a connection has no effect on its ability to send messages. A call to `Stop` on a connection that has already been stopped is ignored.

A call to `Stop` will not return until delivery of messages has paused. This means that a client can rely on the fact that none of its message listeners will be called and that all threads of control waiting for `Receive` calls to return will not return with a message until the connection is restarted. The receive timers for a stopped connection continue to advance, so receives may time out while the connection is stopped.

If message listeners are running when `Stop` is invoked, the `Stop` call waits until all of them have returned before it may return. While these message listeners are completing, they have the full services of the connection available to them.

void Stop();

#### Exceptions

Exception Type | Condition
--- | ---
MessageException | if the JMS provider fails to Stop message delivery due to some internal error.

#### See Also

IConnection Interface | WebLogic.Messaging Namespace | Start