A IBM MQ server represents a IBM MQ queue manager or (for WebSphere® MQ for z/OS®) queue-sharing group. A IBM MQ server bus member is used as a bus member for assigning queue points and mediation points to IBM MQ queues.
Before you begin
Get details of the client connection from your IBM MQ administrator.
Ensure
that the IBM MQ server has been configured,
that the bus has been defined and that the server is not already a member
of the bus.
Decide which method to use to configure these resources. You
can add the IBM MQ
server as a bus member by using the administrative console as described in
this task, or by using the addSIBusMember command.
About this task
When you add a IBM MQ server to one or more buses, messaging
engines on these buses can access queues on the target IBM MQ installation. When you
make the server a bus member, you can override the server connection settings
with settings that are specific to the new bus member. This can be useful
in a multiple bus topology.
Procedure
- Start the administrative console.
- Navigate to the list of bus members for the bus to which you are
adding the IBM MQ
server.
Click .
- Click Add. The "Add a
new bus member" wizard is displayed.
- Select the IBM MQ server to add to the bus:
- Select IBM MQ server.
- From the drop-down list, select the server to add.
- Click Next.
- Specify the virtual queue manager name.
When sending messages to IBM MQ, the IBM MQ gateway queue manager sees the bus as a remote queue manager. The virtual queue manager name is the name that is passed to IBM MQ as the name of this remote queue manager. The default value is the name of the bus. If this value is not a valid name for a IBM MQ queue manager, or if another IBM MQ queue manager already exists that has the same name, then replace the default value with another value that is a valid and unique name for a IBM MQ queue manager. To be valid, the name must meet the following criteria:- It must contain between 1 and 48 characters.
- It must conform to the IBM MQ queue naming rules (see the Rules for
naming IBM MQ objects topic in the IBM MQ information
center).
- Optional: To override the server connection settings, select the Override IBM MQ server
connection properties check box.
When you select this option, the connection properties for the server are made available so that
you can change them to settings that are specific to this bus member. For more information about
these connection properties, see IBM MQ server bus member [Settings].
- Optional: If you have changed the server connection
settings, you can click Test connection to test the
connection to the associated IBM MQ network.
- Click Next.
- Click Finish to confirm.
- Save your changes to the master configuration.