Add an IBM MQ server as a member of a bus

An IBM MQ server represents an IBM MQ queue manager or (for IBM MQ for z/OS ) queue-sharing group. An IBM MQ server bus member is used as a bus member for assigning queue points and mediation points to IBM MQ queues.

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

When you add an 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, 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 IBM 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 IBM MQ server to add to the bus:

   1. Select IBM 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 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 is the name of the bus. If this value is not a valid name for an 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 an 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).

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

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

8. Click Next.

9. Click Finish to confirm.

10. Save the changes to the master configuration.
    

What to do next

You are now ready to create an IBM MQ queue-type destination for the new bus member.

Subtopics

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

• Delete an IBM MQ server bus member definition
  An IBM MQ server represents an IBM MQ queue manager or (for IBM MQ for z/OS) queue-sharing group. We cannot delete an IBM MQ server bus definition directly. Instead, when you delete a specified IBM MQ server, you remove any associated IBM 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:

IBM MQ server bus member [Settings]