IBM MQ server [Settings]

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

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

  • Servers -> New server, choose a server type of "IBM MQ server", then click Next.
  • Servers -> Server Types -> IBM MQ servers -> New
  • Servers -> Server Types -> IBM MQ servers -> server_name
  • Service integration -> Buses -> bus_name -> [Topology] Bus members -> member_name -> [Related Items] IBM 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. In a network deployment environment the informational message is displayed immediately. For more information see Disabling WebSphere MQ functionality in WebSphere Application Server.

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 information center task descriptions for information about how to apply configuration changes to the runtime environment.

General Properties

Name

The administrative name of the IBM MQ Server.

The name that you 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 you 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 you want to establish a connection to.

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

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

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 as described in Configuring the IBM MQ messaging provider with native libraries information.
Note: 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 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 MQ functionality has been disabled. In a network deployment environment, any attempt to test the connection fails if WebSphere MQ functionality has been disabled at either the cell or deployment manager node scope. For more information see Disabling WebSphere MQ functionality in WebSphere Application Server.

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 you 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

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: March 5, 2017 17:54
File name: SIBMQServer_DetailForm.html