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. In a network deployment environment the informational message is displayed immediately. For more information see Disable 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 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 creating 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 to establish a connection to.
| Information | Value |
|---|---|
| Required | No |
| Data type | Radio button |
| Range |
|
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. 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 as described in Configure the WebSphere MQ messaging provider with native libraries information.
If we are using Resource Access Control Facility (RACF ) as the security manager on the WebSphere 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 |
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. 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 Disable WebSphere MQ functionality in WebSphere Application Server.
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 we 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 |
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 WebSphere MQ server definition has been created.
Related tasks
Related information:
Reference topic