+

Search Tips   |   Advanced Search

IBM MQ server [Settings]

An IBM MQ server represents an IBM MQ queue manager or (for IBM MQ for z/OS ) queue-sharing group. Use this panel to view or modify the details of an IBM MQ server definition.

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

If IBM MQ functionality has been disabled at any scope, an informational message indicating that IBM MQ has been disabled is displayed. In a single server environment this informational message is only displayed when the server is restarted after IBM MQ functionality has been disabled. In a network deployment environment the informational message is displayed immediately. See Disable IBM MQ functionality in WAS.


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.


General Properties


Name

The administrative name of the IBM MQ Server.

The name that we use for this IBM MQ server definition must be unique.

Information Value
Required Yes
Data type String


UUID

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

This identifier is assigned automatically when we create a new IBM MQ server definition.

Information Value
Required No
Data type String


Description

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

Information Value
Required No
Data type Text area


IBM MQ server name

The name of the IBM MQ queue manager or queue sharing group, as defined in IBM 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 we want to establish a connection to.

Information Value
Required No
Data type Radio button
Range

Queue manager

An IBM MQ queue manager on the IBM MQ network with which WAS applications undertake messaging.

Queue sharing group

An IBM MQ for z/OS queue-sharing group on the IBM MQ network with which WAS 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 IBM MQ server. Otherwise client transport mode will always be used.

To connect to an IBM MQ queue manager or queue-sharing group in bindings mode, WAS 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. 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 as described in Configure the IBM MQ messaging provider with native libraries information.

If we are using Resource Access Control Facility (RACF ) as the security manager on your IBM MQ for z/OS system, and using bindings transport mode, specify in uppercase characters the user names and passwords for authentication aliases. If we are using RACF and client transport mode, we can specify the user names and passwords in either upper or lowercase characters.

Information Value
Required No
Data type Boolean


IBM MQ host

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

Information Value
Required Yes
Data type String


IBM MQ port

This is the port that will be used when attempting to establish client transport mode connections to IBM 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 IBM MQ server.

Information Value
Required Yes
Data type Custom


IBM MQ channel

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

Information Value
Required Yes
Data type String


Test connection

Test the connection to IBM MQ.

In a single server environment, any attempt to test the connection fails if WebSphere Q functionality has been disabled. In a network deployment environment, any attempt to test the connection fails if IBM MQ functionality has been disabled at either the cell or deployment manager node scope. See Disable IBM MQ functionality in WAS.


Messaging authentication alias

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

Information Value
Required No
Data type drop-down list


Trust user identifiers received in messages

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

Select this option if we do not want the user IDs in messages to be overwritten with the administrative name of the IBM MQ server.

Information Value
Required No
Data type Boolean


Automatic discovery of resources

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

Information Value
Required No
Data type Boolean


Resource discovery authentication alias

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

Information Value
Required No
Data type drop-down list


Reply-to queue

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

Information Value
Required No
Data type Text


Related Items

JAAS - J2C authentication data

List of user identities and passwords for Java 2 connector security to use.

This item is not available until after the IBM MQ server definition has been created.

  • Create an IBM MQ server definition
  • Disable IBM MQ functionality in WAS