WebSphere MQ server [Settings]

A WebSphere® MQ server represents a WebSphere MQ queue manager or (for WebSphere MQ for z/OS®) queue-sharing group. Use this panel to view or modify the details of a WebSphere MQ server definition.

To view this page in the console, click one of the following paths:

  • Servers -> New server, choose a server type of WebSphere MQ server, then click Next.
  • Servers -> Server Types -> WebSphere MQ servers -> New
  • Servers -> Server Types -> WebSphere MQ servers -> server_name
  • Service integration -> Buses -> bus_name -> [Topology] Bus members -> member_name -> [Related Items] WebSphere MQ server

If WebSphere MQ functionality has been disabled at any scope, an informational message indicating that WebSphere MQ has been disabled is displayed. In a single server environment this informational message is only displayed when the server is restarted after WebSphere MQ functionality has been disabled.

Configuration tab

The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the task descriptions for information about how to apply configuration changes to the runtime environment.

General Properties

Name

The administrative name of the WebSphere MQ Server.

The name that you use for this WebSphere MQ server definition must be unique.
Information Value
Required Yes
Data type String

UUID

The universal unique identifier assigned by the system to this WebSphere MQ server for administrative purposes.

This identifier is assigned automatically when you create a new WebSphere MQ server definition.
Information Value
Required No
Data type String

Description

An optional description for the WebSphere MQ server, for administrative purposes.

Information Value
Required No
Data type Text area

WebSphere MQ server name

The name of the WebSphere MQ queue manager or queue sharing group, as defined in WebSphere MQ.

Information Value
Required Yes
Data type String

Server Type

A server can be either a queue manager or queue sharing group. Select the appropriate type for the server you want to establish a connection to.

Information Value
Required No
Data type Radio button
Range
Queue manager
A WebSphere MQ queue manager on the WebSphere MQ network with which WebSphere Application Server applications undertake messaging.

Queue sharing group
A WebSphere MQ for z/OS queue-sharing group on the WebSphere MQ network with which WebSphere Application Server applications undertake messaging.

Use bindings transport mode if available

When selected, bindings transport mode will be used in preference to client transport mode when establishing connections to the WebSphere MQ server. Otherwise client transport mode will always be used.

To connect to a WebSphere 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 WebSphere MQ messaging provider. If you want to use a direct binding to WebSphere MQ, rather than a TCP/IP network connection, select this option and configure the Native library path property.
Note: If you are using Resource Access Control Facility (RACF®) as the security manager on your WebSphere 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.
Information Value
Required No
Data type Boolean

WebSphere MQ host

WebSphere MQ server host defined by either its symbolic host name or an IP address.

Information Value
Required Yes
Data type String

WebSphere MQ port

This is the port that will be used when attempting to establish client transport mode connections to WebSphere MQ.

Information Value
Required Yes
Data type Integer
Range 0 through 65535

Transport chain name

The transport chain used to establish an outbound network connection to the WebSphere MQ server.

Information Value
Required Yes
Data type Custom

WebSphere MQ channel

The WebSphere MQ server connection channel, as defined in WebSphere MQ.

Information Value
Required Yes
Data type String

Test connection

Test the connection to WebSphere MQ.

In a single server environment, any attempt to test the connection fails if WebSphere MQ functionality has been disabled. .

Messaging authentication alias

WebSphere MQ server authentication alias name used when exchanging messages with WebSphere MQ.

Information Value
Required No
Data type drop-down list

Trust user identifiers received in messages

If selected user identifiers received as part of WebSphere MQ messages will be used for security purposes within the bus.

Select this option if you do not want the user IDs in messages to be overwritten with the administrative name of the WebSphere MQ server.
Information Value
Required No
Data type Boolean

Automatic discovery of resources

When selected this enables the discovery of WebSphere MQ queue names to assist the administrator.

Information Value
Required No
Data type Boolean

Resource discovery authentication alias

WebSphere MQ server authentication alias used for WebSphere MQ resource discovery.

Information Value
Required No
Data type drop-down list

Reply-to queue

WebSphere MQ queue name used by the system to obtain messages used in the resource discovery process.

Information Value
Required No
Data type Text