Network Deployment (Distributed operating systems), v8.0 > Administer applications and their environment > Administer Messaging resources > Manage messaging with the default messaging provider > Interoperating with a WebSphere MQ network > Use WebSphere MQ links to connect a bus to a WebSphere MQ network > Administer an existing WebSphere MQ link > Modify a WebSphere MQ link
Set 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. 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.
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, we have not yet defined a Websphere MQ receiver channel. If you did choose this option in the wizard, we 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 admin console...
Procedure
- 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 .
- In the content pane, either click New to add a new receiver channel, or click the name of a existing receiver channel to modify.
- 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 WAS v6 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 WAS v7.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".
- Click OK.
- Save your changes to the master configuration.
- Restart the application server.
Related
States of the WebSphere MQ link and its channels
WebSphere MQ link receiver channel connections [Collection]
WebSphere MQ link receiver channel connections [Settings]
WebSphere MQ link receiver channel [Collection]
WebSphere MQ link receiver channel [Settings]