A WebSphere® MQ server represents a WebSphere MQ queue manager or (for WebSphere MQ for z/OS®) queue-sharing group. A WebSphere MQ server bus member is used as a bus member for assigning queue points and mediation points to WebSphere MQ queues.
Before you begin
Get details of the client connection from your WebSphere MQ administrator.
Ensure
that the WebSphere 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 WebSphere 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 WebSphere MQ server to one or more buses, messaging
engines on these buses can access queues on the target WebSphere 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 WebSphere MQ
server.
Click .
- Click Add. The "Add a
new bus member" wizard is displayed.
- Select the WebSphere MQ server to add to the bus:
- Select WebSphere MQ server.
- From the drop-down list, select the server to add.
- Click Next.
- Specify the virtual queue manager name.
When sending messages to WebSphere MQ, the WebSphere MQ gateway queue manager sees the bus as a remote queue manager. The virtual queue manager name is the name that is passed to WebSphere 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 WebSphere MQ queue manager, or if another WebSphere 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 WebSphere 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 WebSphere MQ
queue naming rules (see the Rules for naming WebSphere MQ objects topic in the WebSphere MQ information center).
- Optional: To override the server connection settings,
select the Override WebSphere 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 WebSphere 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 WebSphere MQ network.
- Click Next.
- Click Finish to confirm.
- Save your changes to the master configuration.