IBM MQ Provider queue connection factory settings for application clients
Use this panel to view or change the configuration properties of the selected queue connection factory for use with the IBM MQ Java™ Message Service (JMS) provider. These configuration properties control how connections are created between the JMS provider and IBM MQ.
To view this Application Client Resource Configuration Tool (ACRCT) page, click Open. Expand the selected JAR file and click . Right-click Queue Connection Factories, and click New. The following fields are displayed on the General tab:
. After you browse for an EAR file, click- The property values that you specify must match the values that you specified when configuring IBM MQ for JMS resources. For more information about configuring IBM MQ for JMS resources, see the Using Java section of the IBM MQ documentation.
- In IBM MQ, names can have a maximum of 48 characters, except for channels which have a maximum of 20 characters.
A queue connection factory for the JMS provider has the following properties.
Name
The name by which this queue connection factory is known for administrative purposes within WebSphere® Application Server. The name must be unique within the JMS connection factories across the WebSphere administrative domain.
Information | Value |
---|---|
Data type | String |
Description
A description of this connection factory for administrative purposes within WebSphere Application Server.
Information | Value |
---|---|
Data type | String |
Default | Null |
JNDI Name
The application client run time uses this field to retrieve configuration information.
User ID
The user ID used, with the password property, for authentication if the calling application does not provide a user ID and password explicitly.
If you specify a value for the user ID property, you must also specify a value for the password property.
The connection factory user ID and password properties are used if the calling application does not provide a user ID and password explicitly; for example, if the calling application uses the method createQueueConnection(). The JMS client flows the user ID and password to the JMS server.
Information | Value |
---|---|
Data type | String |
Password
The password used, with the user ID property, for authentication if the calling application does not provide a user ID and password explicitly.
If you specify a value for the user ID property, you must also specify a value for the password property.
Information | Value |
---|---|
Data type | String |
Default | Null |
Re-Enter Password
Confirms the password.
Queue Manager
The name of the IBM MQ queue manager for this connection factory.
Connections created by this factory connect to that queue manager.
Information | Value |
---|---|
Data type | String |
Enter Hostname and Port Information
This radio button is selected by default and, if selected, enables the host and port properties and disables the connection name list property.
Information | Value |
---|---|
Data type | Radio button |
Default | Selected |
Host
The name of the host on which the IBM MQ queue manager runs for client connection only.
Information | Value |
---|---|
Data type | String |
Default | Null |
Range | A valid TCP/IP host name |
Port
The TCP/IP port number used for connection to the IBM MQ queue manager, for client connection only.
This port must be configured on the IBM MQ queue manager.
Information | Value |
---|---|
Data type | Integer |
Default | Null |
Range | A valid TCP/IP port number, configured on the IBM MQ queue manager. |
Enter Connection Name List Information
If selected, this radio button enables the connection name list property and disables the host and port name properties. Select this radio button if you want to connect to a multi-instance queue manager.
Information | Value |
---|---|
Data type | Radio button |
Default | Cleared |
Connection Name List
A comma-separated list of host and port information which can be used to connect to a multi-instance queue manager.
host[(port)],[host[(port)]]
where port is
optional and defaults to 1414 if it is not set. For
example:hostname1,hostname2(1415)
For further information about multi-instance queue managers, see the IBM MQ documentation.
This property must only be used for connecting to a multi-instance queue manager. It must not be used for connecting to a list of distinct queue managers as that can result in transaction integrity issues.
Channel
The name of the channel used for connection to the IBM MQ queue manager, for client connection only.
Information | Value |
---|---|
Data type | String |
Default | Null |
Range | 1 through 20 ASCII characters |
Transport type
Specifies whether the IBM MQ client connection or JNDI bindings are used for connection to the IBM MQ queue manager. The external JMS provider controls the communication protocols between JMS clients and JMS servers. Tune the transport type when you are using non-ASF nonpersistent, nondurable, nontransactional messaging or when you want to satisfy security issues and the client is local to the queue manager node.
Information | Value |
---|---|
Data type | Enum |
Units | Not applicable |
Default | BINDINGS |
Range |
|
Recommended |
Note: The IBM MQ 5.3 JMS cannot be used within WebSphere Application Server Version 6.1 because WebSphere Application Server Version 6.1 has a Java 5 runtime. Therefore,
cross-memory connections cannot be established with IBM MQ 5.3
queue managers. This can result in a performance degradation if you were previously using IBM MQ 5.3 and BINDINGS for your connections and move to CLIENT
network connections in migrating to WebSphere Application Server Version 6.1.
If you are using IBM MQ 5.3 for z/OS®, you might also need
to install an additional feature pack.
|
Client ID
The JMS client identifier used for connections to the IBM MQ queue manager.
Information | Value |
---|---|
Data type | String |
CCSID
The coded character set identifier for use with the IBM MQ queue manager.
This coded character set identifier (CCSID) must be one of the CCSIDs supported by IBM MQ.
Information | Value |
---|---|
Data type | String |
For more information about supported CCSIDs, and about converting between message data from one coded character set to another, see the System Administration and Application Programming Reference sections of the IBM MQ information center.
Message Retention
Select this check box to specify that unwanted messages are to remain on the queue. Otherwise, unwanted messages are handled according to their disposition options.
Information | Value |
---|---|
Data type | Enum |
Units | Not applicable |
Default | Cleared |
Range |
|
Temporary model
The name of the model definition used to create temporary connection factories if a connection factory does not already exist.
Information | Value |
---|---|
Data type | String |
Range | 1 through 48 ASCII characters |
Temporary queue prefix
The prefix used for dynamic queue naming.
Information | Value |
---|---|
Data type | String |
Fail if quiesce
Specifies whether applications return from a method call if the queue manager has entered a controlled failure.
Information | Value |
---|---|
Data type | Check box |
Default | Selected |
Local Server Address
Specifies the local server address.
Information | Value |
---|---|
Data type | String |
Polling Interval
Specifies the interval, in milliseconds, between scans of all receivers during asynchronous message delivery
Information | Value |
---|---|
Data type | Integer |
Units | Milliseconds |
Default | 5000 |
Rescan interval
Specifies the interval in milliseconds between which a topic is scanned to look for messages that have been added to a topic out of order.
This interval controls the scanning for messages that have been added to a topic out of order with respect to an IBM MQ browse cursor.
Information | Value |
---|---|
Data type | Integer |
Units | Milliseconds |
Default | 5000 |
SSL cipher suite
Specifies the cipher suite to use for SSL connection to IBM MQ.
Set this property to a valid cipher suite provided by your JSSE provider. The value must match the CipherSpec specified on the SVRCONN channel as the Channel property.
You must set this property, if you set the SSL Peer Name property.
SSL certificate store
Specifies a list of zero or more Certificate Revocation List (CRL) servers used to check for SSL certificate revocation. If you specify a value for this property, you must use IBM MQ JVM at Java 2 version 1.4.
ldap://hostname:[port]
A single slash (/) follows this value. If port is omitted, the default LDAP port of 389 is assumed. At connect-time, the SSL certificate presented by the server is checked against the specified CRL servers. For more information about CRL security, see the information about Working with Certificate Revocation Lists in the Security section of the IBM MQ documentation.
SSL peer name
For SSL, a distinguished name skeleton that must match the name provided by the IBM MQ queue manager. The distinguished name is used to check the identifying certificate presented by the server at connection time.
If this property is not set, such certificate checking is performed.
The SSL peer name property is ignored if SSL Cipher Suite property is not specified.
CN=QMGR.*, OU=IBM, OU=WEBSPHERE
The example given checks the identifying certificate presented by the server at connect-time. For the connection to succeed, the certificate must have a Common Name beginning QMGR., and must have at least two Organizational Unit names, the first of which is IBM® and the second WEBSPHERE. Checking is not case-sensitive.
For more details about distinguished names and their use with IBM MQ, see the information about Distinguished Names
in the
IBM MQ documentation.
Connection pool
Specifies an optional set of connection pool settings.
Connection pool properties are common to all J2C connectors.
The application server pools connections and sessions with the JMS provider to improve performance. This connection pooling is independent from any IBM MQ connection pooling. You must configure the connection and session pool properties appropriately for your applications, otherwise you might not get the connection and session behavior that you want.
Change the size of the connection pool if concurrent server-side access to the JMS resource exceeds the default value. The size of the connection pool is set on a per queue or topic basis.
Information | Value |
---|---|
Data type | Check box |
Default | Selected |
Client reconnect options
Specifies whether a client mode connection reconnects automatically, or not, in the event of a communications or queue manager failure. This property is ignored unless the connection factory is being used in a thin or managed client environment.
Information | Value |
---|---|
Data type | Drop-down list |
Default | DISABLED |
Range |
|
For more information about automatic client reconnection, see the IBM MQ documentation.
Client reconnect timeout
The maximum number of seconds that a client mode connection spends attempting to automatically reconnect to a queue manager after a communications or queue manager failure. This parameter is ignored unless the connection factory is being used in a thin or managed client environment. Whether this parameter is used or not depends on the value of the client reconnect options parameter.
Information | Value |
---|---|
Data type | Integer |
Units | Seconds |
Default | 1800 |
Range | A value greater than zero and up to 2147483647 |
For more information about automatic client reconnection, see the IBM MQ documentation.