Stopping the receiver channel on a WebSphere MQ link

This topic describes how to stop the receiver channel on a WebSphere® MQ link while leaving the link itself running.

Before you begin

Note: If you stop the receiver channel on a WebSphere MQ link, communication with the target WebSphere MQ network on that channel will cease for both point-to-point messaging and publishing and subscribing. Messages will be held at their transmission locations.

You may wish to warn the administrator of the WebSphere MQ network that you are about to stop the channel.

Procedure

  1. In the navigation pane, click Service integration > Buses > [Content Pane] bus_name > [Topology] Messaging engines > engine_name > [Additional Properties] WebSphere MQ links > [Content Pane] link_name.
  2. Click the receiver channel you want to stop.
  3. Select the check box next to the channel you want to stop.
  4. In the Stop mode list, select Quiesce or Force.
  5. In the Target state list, select Inactive or Stopped.
  6. Click Stop.

Results

Stopping a receiver channel stops all the receiver channel connections for that receiver. The resultant state of the receiver channel, and the sender channel in the WebSphere MQ network with which it is communicating, depends on the options you chose:
Table 1. Effects of stop modes and target states
  Stop mode
Quiesce Force
Target state Inactive The receiver channel moves to the stopping state and the data flow to the WebSphere MQ sender channel stops. When the WebSphere MQ sender channel next tries to communicate with the receiver channel the WebSphere MQ sender channel enters a state of retrying. The receiver channel then becomes inactive. The retrying WebSphere MQ sender channel then reestablishes a session with the receiver channel, and both channels become running. The receiver channel immediately becomes inactive. When the WebSphere MQ sender channel next tries to communicate with the receiver channel, the WebSphere MQ sender channel enters a state of retrying. The retrying WebSphere MQ sender channel then reestablishes a session with the receiver channel, and both channels become running.
Stopped The receiver channel moves to the stopping state and the data flow to the WebSphere MQ sender channel stops. When the WebSphere MQ sender channel next tries to communicate with the receiver channel the WebSphere MQ sender channel enters a state of retrying. The receiver channel then becomes stopped, so preventing the WebSphere MQ sender channel from reestablishing a session. The WebSphere MQ sender channel itself then becomes stopped. The receiver channel immediately becomes stopped. When the WebSphere MQ sender channel next tries to communicate with the receiver channel, the WebSphere MQ sender channel enters a state of retrying, and then becomes stopped itself.

What to do next

If you have stopped the receiver channel, messages sent to the WebSphere MQ link engine will not be received. For more information on stopped states of the WebSphere MQ link and its channels, see States of the WebSphere MQ link and its channels.

If a WebSphere MQ sender channel is started while an MQ link receiver channel is stopped, the request fails with an error indicating that the receiver channel is not available. For more information on stopped states of the WebSphere MQ link and its channels, see States of the WebSphere MQ link and its channels.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 1:23:07 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=tjc0036a_
File name: tjc0036B_.html