Adding or modifying a WebSphere MQ link receiver channel

How you can define the properties of the receiver channel on a WebSphere® MQ link. This channel receives messages from the WebSphere MQ queue manager or queue-sharing group (known as the "gateway queue manager"). The receiver channel communicates with a WebSphere MQ sender channel on the gateway queue manager, and converts MQ format messages to service integration bus messages.

Before you begin

You have to know the name of the bus, and the messaging engine on the bus that contains the WebSphere MQ link with the receiver channel you intend to add or modify.

About this task

When you use the foreign bus connection wizard to connect a bus and a gateway queue manager to use point-to-point messaging or publish-subscribe messaging, the wizard does not ask you to set all possible properties of a WebSphere MQ link. If you did not choose to Enable Service integration bus to WebSphere MQ message flow in the foreign bus connection wizard, you have not yet defined a Websphere MQ receiver channel. If you did choose this option in the wizard, you have defined the receiver channel name, host name and port number, and the wizard has set the other properties to default values.

To add or modify a WebSphere MQ link receiver channel, use the administrative console to complete the following steps:

Procedure

  1. In the navigation pane, click Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional properties] WebSphere MQ links -> link_name -> [Additional Properties] Receiver channel .
  2. In the content pane, either click New to add a new receiver channel, or click the name of a existing receiver channel that you want to modify.
  3. Add or modify the properties of the channel.

    For information about all the properties that you can modify, see WebSphere MQ link receiver channel [Settings].

    If you used the foreign bus connection wizard to create the channel, the wizard has used default values for the following properties:

    Inbound nonpersistent message reliability
    The acceptable reliability of message delivery for nonpersistent message flows from WebSphere MQ through this WebSphere MQ link, from Best effort to Reliable, in order of increasing reliability. By default, the value is "Reliable".
    Inbound persistent message reliability
    The acceptable reliability of message delivery for inbound persistent message flows from WebSphere MQ through this WebSphere MQ link, from Reliable to Assured, in order of increasing reliability. By default, the value is "Assured".
    Prefer queue points local to this link's messaging engine
    When this check box is selected, the link prefers to send inbound messages to available queue points of target queue destinations that are located on the same messaging engine as the link. By default the check box is selected, which corresponds to the behavior in WebSphere Application Server Version 6 and can make it easier to handle links in a mixed-version cell. If you clear the check box, preference is not given to local queue points and inbound messages are workload balanced across all available queue points of target queue destinations. This option (not to give preference to local queue points) is available only on links running on WebSphere Application Server Version 7.0 or later.
    Initial state
    Whether the receiver channel is started or stopped when the associated WebSphere MQ link is first started. Until started, the channel is unavailable. By default, the value is "Started".
  4. Click OK.
  5. Save your changes to the master configuration.
  6. Restart the application server.



In this information ...


Related concepts

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 of Use | Feedback

Last updatedLast updated: Sep 19, 2011 4:16:02 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=matt&product=was-base-dist&topic=tjc0332a_
File name: tjc0332A_.html