How you can define the properties of the receiver channel on a WebSphere® MQ link. This channel receives messages from the IBM MQ queue
manager or queue-sharing group (known as the "gateway queue manager").
The receiver channel communicates with a IBM 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
IBM 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
IBM MQ link. If you did not choose to Enable Service
integration bus to IBM MQ message flow in the foreign bus connection wizard, you have
not yet defined a IBM 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 IBM MQ link receiver channel, use the administrative console to complete the following
steps:
Procedure
- In the navigation pane, click .
- 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.
- Add or modify the properties of the channel.
For
information about all the properties that you can modify, see IBM 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 IBM MQ through this IBM 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 IBM MQ through this IBM 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 IBM 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.