Creating an IBM MQ server definition

A IBM MQ server represents an IBM MQ queue manager or (for WebSphere® MQ for z/OS®) queue-sharing group. To create a IBM MQ server definition, you use the administrative console to define the server connection and quality of service properties.

Before you begin

Decide which method to use to configure these resources. You can create a new IBM MQ server definition by using the administrative console as described in this task, or by using the createSIBWMQServer command.

About this task

A IBM MQ server definition defines the connection to an underlying IBM MQ queue manager or queue-sharing group and the associated queues.

When you subsequently add the server as a member of a service integration bus, you can optionally override the server connection settings with the bus connection settings. This means that you can create a IBM MQ server definition that is specific to a bus, yet reusable in a multiple bus topology.

Procedure

  1. Start the administrative console.
  2. Complete either of the following sub-steps:
    1. Navigate to Servers -> New server, choose a server type of IBM MQ server, then click Next.
    2. Navigate to Servers -> Server Types -> IBM MQ servers, then click New.
    The IBM MQ server settings form is displayed.
  3. Complete the fields as required.
    Name
    The name that you use for this IBM MQ server definition must be unique.
    UUID
    This identifier is assigned automatically when you create a new IBM MQ server definition.
    Use bindings transport mode if available
    To connect to a IBM MQ queue manager or queue-sharing group in bindings mode, WebSphere Application Server needs to know where to load native libraries from. This information is stored in the Native library path property of the IBM MQ messaging provider. If you want to use a direct binding to IBM MQ, rather than a TCP/IP network connection, select this option and configure the Native library path property.
    If you are using Resource Access Control Facility (RACF®) as the security manager on your IBM MQ for z/OS system, and using bindings transport mode, you must specify in uppercase characters the user names and passwords for authentication aliases. If you are using RACF and client transport mode, you can specify the user names and passwords in either uppercase or lowercase characters.
    Test connection
    After you have configured the Connection properties, click this button to test the connection to IBM MQ.
    Trust user identifiers received in messages
    Select this option if you do not want the user IDs in messages to be overwritten with the administrative name of the IBM MQ server.
    JAAS - J2C authentication data
    This item is not available until after the IBM MQ server definition has been created.
  4. Click OK to confirm.
  5. Save your changes to the master configuration.
  6. Restart the application server.

What to do next

You are now ready to add the new IBM MQ server as a member of a bus.