This topic describes how to define a WebSphere MQ link on a messaging
engine in a service integration bus.
Before you begin
Before starting this task you will need to:
- Know the name of the messaging engine on which you intend to put the WebSphere
MQ link.
- Have created the foreign bus that represents the WebSphere MQ queue manager
network. For information about creating a foreign bus, see Configuring foreign bus definitions.
- Know the name of the WebSphere MQ queue manager that you will define as
the gateway through which messages will be exchanged with the WebSphere MQ
link.
- Have created sender and receiver channels in the WebSphere MQ network.
The WebSphere MQ link receiver channel must have the same name as its partner
sender channel in the WebSphere MQ network. The WebSphere MQ link sender channel
must have the same name as its partner receiver channel in the WebSphere MQ
network. For examples on creating channels, see WebSphere MQ link sample configuration.
Why and when to perform this task
To define a WebSphere MQ link, use the administrative console to complete the following steps. This task contains optional steps to define
a WebSphere MQ link sender channel and a WebSphere MQ link receiver channel.
Steps for this task
- In the navigation pane, click bus_name
- In the content pane, click New.
- Type the name of the new WebSphere MQ link.
- Enter a description for the WebSphere MQ link.
- In the foreign bus name, click the name of the foreign bus that
represents the WebSphere MQ network.
- Type the virtual, messaging-engine queue-manager name, that is,
the queue name that WebSphere MQ will use to address this service integration bus.
This is the service integration bus name. Maximum 48 characters.
- Review the default values in the remaining
fields on the panel, using the field help in the Help pane to find out more
information about each field. Modify any values as necessary.
- Click Next.
- Define the WebSphere MQ link sender
channel.
- Type the name of the sender channel associated with this WebSphere
MQ link. Maximum 20 characters. This name must be the same as the name of
the partner receiver channel in the WebSphere MQ network.
- Type the host name or address of the target queue manager in
the WebSphere MQ network.
- Enter the port number on which the gateway queue manager is
listening for the inbound communication requests.
- Type the transport chain, that is the communication protocol
for the foreign bus. Possible choices include "OutboundBasicMQLink" and "OutboundSecureMQLink".
For more information seeOutbound transport options and Securing connections to a WebSphere MQ network.
- Review the default values in the remaining fields on the panel,
using the field help in the Help pane to find out more information about each
field. Modify any values as necessary.
- Click Next.
- Define the WebSphere MQ link receiver channel.
- Type the name of the receiver channel associated with this WebSphere
MQ link. Maximum 20 characters. This name must be the same as the name of
the partner sender channel in the WebSphere MQ network.
- Review the default values in the remaining fields on the panel,
using the field help in the Help pane to find out more information about each
field. Modify any values as necessary.
- Click Next
- Check the summary of WebSphere MQ link properties,
and when you are satisfied click Finish.
- Save your changes to the master configuration
- Restart the application server if you have
completed configuring the WebSphere MQ link, that is, you are not going to
define broker profiles. The WebSphere MQ link is ready to
send, receive, or exchange messages with the WebSphere MQ network, provided
the queue manager (the gateway queue manager) has been created on the WebSphere
MQ network, and the required resources defined.
You can now define a broker profile, by following the steps in Defining a publish/subscribe broker profile.