Create a new IBM MQ link
An IBM MQ link provides a server to server channel connection between a service integration bus and an IBM MQ queue manager or queue-sharing group, which acts as the gateway to the IBM MQ network. Use the foreign bus connection wizard to create a foreign bus and link it to the IBM MQ network through an IBM MQ link.
Decide which method to use to configure these resources. Create a new IBM MQ link using the administrative console as described in this task, or we can create a new IBM MQ link .
The following resources must be defined in WAS:
- A service integration bus to connect from (known as the local bus) with at least one bus member.
The following resources must be defined in IBM MQ:
- A queue manager or queue-sharing group, which acts as the gateway to the IBM MQ network.
- A listener configured and running.
- (optionally) A sender channel to receive messages on the local bus, a receiver channel to send messages from the local bus, or both.
- (For publish-subscribe messaging) A topic and input queue for broker publish-subscribe flow.
We use the foreign bus connection wizard to connect a bus and an IBM MQ network. We can configure the connection for either point-to-point or publish-subscribe messaging.
Specifically, the wizard helps we configure the following resources:
- The bus and messaging engine on which the IBM MQ link is defined.
- The foreign bus that represents the IBM MQ network.
- The IBM MQ link.
- (Optionally) The sender and receiver channels and protocol. Using the wizard we can choose to define no channels (and add them afterward), or one channel if the IBM MQ link is to be one-way, or both channels.
- (Optionally) Security for messages flowing across the link.
- (Optionally) A publish/subscribe broker profile and associated topic mappings, to allow publication and subscription with a broker in the IBM MQ network.
The wizard does not ask you to set all possible properties of an IBM MQ link, and many of the properties are set to default values. We can fine tune these properties afterward if necessary, by modifying the IBM MQ link.
For a sample configuration showing a systems view of the setup for an IBM MQ link, see IBM MQ link sample configuration.
Create a new IBM MQ link
- To connect a bus and an IBM MQ network...
- Foreign bus connection wizard for point-to-point messaging
- Foreign bus connection wizard for publish-subscribe messaging
An IBM MQ link is created and configured as part of the action of the wizard.
We can subsequently convert a point-to-point connection to a publish/subscribe connection, by adding a publish/subscribe broker on the IBM MQ link for the connection.
- Optional: Modify the new IBM MQ link.
When we create a new IBM MQ link, the following properties are set to default values:
- Description
- Adoptable
- Exception destination
- Initial state
- Nonpersistent message speed
We can fine tune these properties by modifying the link.
- Optional: Add or modify the IBM MQ receiver channel.
If we did not choose to Enable Service integration bus to IBM MQ message flow in the foreign bus connection wizard, we have not yet defined an IBM MQ receiver channel. If we did choose this option in the wizard, we have defined the receiver channel name, host name and communication port, and the wizard has used default values for the following properties:
- Inbound nonpersistent message reliability
- Inbound persistent message reliability
- Prefer queue points local to this link's messaging engine
- Initial state
We can fine tune these properties by modifying the channel.
- Optional: Add or modify the IBM MQ sender channel
If we did not choose to Enable IBM MQ to Service integration bus message flow in the foreign bus connection wizard, we have not yet defined an IBM MQ sender channel. If we did choose this option in the wizard, we have defined the sender channel name, host name, communication port and transport chain, and the wizard has used default values for the following properties:
- Disconnect interval
- Short retry count
- Short retry interval
- Long retry count
- Long retry interval
- Initial state
We can fine tune these properties by modifying the channel.
Subtopics
- IBM MQ link sample configuration
This sample configuration illustrates how we can use an IBM MQ link to connect WAS service integration messaging to IBM MQ messaging.
Related:
Foreign bus connection wizard for point-to-point messaging Foreign bus connection wizard for publish-subscribe messaging Message exchange through an IBM MQ link High availability of messaging engines connected to IBM MQ Configure foreign bus connections Default messaging provider unified connection factory [Settings] IBM MQ link [Settings] IBM MQ link routing properties [Settings]