Add a WebSphere MQ server as a member of a bus

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.

Get details of the client connection from the 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. We can add the WebSphere MQ server as a bus member using the console as described in this task, or using the addSIBusMember command.

When we 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 we make the server a bus member, we 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.

1. Start the console.

2. Navigate to the list of bus members for the bus to which we are adding the WebSphere MQ server.

   Click Service integration -> Buses -> bus_name -> [Topology] Bus members.

3. Click Add. The "Add a new bus member" wizard is displayed.

4. Select the WebSphere MQ server to add to the bus:

   1. Select WebSphere MQ server.

   2. From the drop-down list, select the server to add.

   3. Click Next.

5. 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).

6. 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 we 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].

7. Optional: If we have changed the server connection settings, we can click Test connection to test the connection to the associated WebSphere MQ network.

8. Click Next.

9. Click Finish to confirm.

10. Save the changes to the master configuration.
    

What to do next

We are now ready to create a WebSphere MQ queue-type destination for the new bus member.

Subtopics

• Modify a WebSphere MQ server bus member definition
  A WebSphere MQ server bus member is used for assigning queue points and mediation points to WebSphere MQ queues. This topic describes how to modify the attributes of a WebSphere MQ server bus member.

• Delete a WebSphere MQ server bus member definition
  A WebSphere MQ server represents a WebSphere MQ queue manager or (for WebSphere MQ for z/OS) queue-sharing group. We cannot delete a WebSphere MQ server bus definition directly. Instead, when we delete a specified WebSphere MQ server, you remove any associated WebSphere MQ server bus members, as well as assigned queue points and mediation points.

Related tasks

Create a queue for point-to-point messaging

addSIBusMember command

Related information:

WebSphere MQ server bus member [Settings]