WebSphere MQ Provider topic connection factory settings for application clients
Use this panel to change configuration properties of a topic connection factory for use with the WebSphere MQ product JMS provider.
These configuration properties control how connections are created between the JMS provider and WebSphere MQ.
To view this Application Client Resource Configuration Tool (ACRCT) page, click...
File | Open | EAR file | Open | JAR file | Messaging Providers | WebSphere MQ Provider | Topic Connection Factories (right-click) | New
- The property values specified must match the values specified when configuring WebSphere MQ product JMS resources. For more information about configuring WebSphere MQ product JMS resources, see the WebSphere MQ Using Java book.
- In WebSphere MQ, names can have a maximum of 48 characters, with the exception of channels which have a maximum of 20 characters.
MA0C broker: When creating a WAS v6 topic connection factory for the MA0C broker, you should consider the following attribute values:
- BrokerControlQueue
- This value is fixed at SYSTEM.BROKER.CONTROL.QUEUE for the MA0C broker and is the queue the broker reads from.
- BrokerV
- Set this value to BASIC for the MA0C broker.
- ClientID
- Set this value to whatever you like for the MA0C broker (the value is string and is merely an identifier for your client application).
- XA Enabled
- Set this value to TRUE or FALSE for the MA0C broker (the setting you use is a performance enhancement flag - you will probably want to set this to 'true' most of the time).
- BrokerMessage Selection
- This value is fixed at CLIENT for the MA0C broker because the broker relies on client side message selection.
- Direct Broker Authorization Type
- This value is not required by the MA0C broker.
A topic connection factory for the WebSphere MQ product JMS provider has the following properties.
Name
The name by which this topic connection factory is known for administrative purposes within IBM WAS. The name must be unique within the JMS provider.
Data type String
Description
A description of this topic connection factory for administrative purposes within IBM WAS.
Data type String
JNDI Name
The JNDI name that is used to bind the topic connection factory into the application server name space.
As a convention, use the fully qualified JNDI name; for example, in the form jms/Name, where Name is the logical name of the resource.
This name is used to link the platform binding information. The binding associates the resources defined by the deployment descriptor of the module to the actual (physical) resources bound into JNDI by the platform.
Data type String Units En_US ASCII characters Range 1 through 45 ASCII characters
User ID
The user ID used, with the Password property, for authentication if the calling application does not provide a userid and password explicitly.
If you specify a value for the User property, also specify a value for the Password property.
The connection factory User and Password properties are used if the calling application does not provide a userid and password explicitly, for example, if the calling application uses the method createTopicConnection(). The JMS client flows the userid and password to the JMS server.
Data type String
Password
The password used, with the User ID property, for authentication if the calling application does not provide a userid and password explicitly.
If you specify a value for the User ID property, also specify a value for the Password property.
Data type String
Re-Enter Password
Queue Manager
The name of the WebSphere MQ queue manager for this connection factory. Connections created by this factory connect to that queue manager.
Data type String
Host
The name of the host on which the WebSphere MQ queue manager runs for client connections only.
Data type String Range A valid TCP/IP host name
Port
The TCP/IP port number used for connection to the WebSphere MQ queue manager, for client connection only.
This port must be configured on the WebSphere MQ queue manager.
Data type Integer Range A valid TCP/IP port number, configured on the WebSphere MQ queue manager.
Channel
The name of the channel used for client connections to the WebSphere MQ queue manager for client connection only.
Data type String Range 1 through 20 ASCII characters
Transport Type
Whether WebSphere MQ client connection or JNDI bindings are used for connection to the WebSphere MQ queue manager.
Data type Enum Default BINDINGS Range
- CLIENT
- WebSphere MQ client connection is used to connect to the WebSphere MQ queue manager.
- BINDINGS
- JNDI bindings are used to connect to the WebSphere MQ queue manager.
Client ID
The JMS client identifier used for connections to the WebSphere MQ queue manager.
Data type String
CCSID
The coded character set identifier to be used with the WebSphere MQ queue manager.
This coded character set identifier (CCSID) must be one of the CCSIDs supported by WebSphere MQ.
Data type String
Broker Control Queue
The name of the broker control queue to which all command messages (except publications and requests to delete publications) are sent.
Data type String Units En_US ASCII characters Range 1 through 48 ASCII characters
Broker Queue Manager
The name of the WebSphere MQ queue manager that provides the Publisher and Subscriber message broker.
Data type String Units En_US ASCII characters Range 1 through 48 ASCII characters
Broker Publish Queue
The name of the broker input queue that receives all publication messages for the default stream.
The name of the broker's input queue (stream queue) that receives all publication messages for the default stream. Applications can also send requests to delete publications on the default stream to this queue.
Data type String Units En_US ASCII characters Range 1 through 48 ASCII characters
Broker Subscribe Queue
The name of the broker queue from which nondurable subscription messages are retrieved.
The name of the broker queue from which nondurable subscription messages are retrieved. The subscriber specifies the name of the queue when it registers a subscription.
Data type String Units En_US ASCII characters Range 1 through 48 ASCII characters
Broker CCSubQ
The name of the broker queue from which nondurable subscription messages are retrieved for a ConnectionConsumer request. This property applies only for use of the Web container.
Data type String Units En_US ASCII characters Range 1 through 48 ASCII characters
Broker Version
Specify whether the message broker is provided by the WebSphere MQ MA0C SupportPac or newer versions of WebSphere family message broker products.
Data type Enum Default Advanced Range
- Advanced
- The message broker is provided by newer versions of WebSphere family message broker products (MQ Integrator and MQ Publish and Subscribe).
- Basic
- The message broker is provided by the WebSphere MQ MA0C SupportPac (WebSphere MQ - Publish and Subscribe).
Cleanup level
Level of clean up provided by the publish or subscribe cleanup utility.
Data type Enum Default SAFE Range
- ASPROP
- NONE
- STRONG
Cleanup interval
Specify the interval, in milliseconds, between background executions of the publish/subscribe cleanup utility.
Data type Integer Units Milliseconds Default 6000
Message selection
Specify where broker message selection is performed.
Data type Enum Default BROKER Range
- BROKER
- Message selection is done at the broker location.
- Message CLIENT
- Message selection is done at the client location.
Publish acknowledge interval
The interval, in number of messages, between publish requests that require acknowledgement from the broker.
Data type Integer Default 25
Sparse subscriptions
Enables sparse subscriptions.
Data type Check box Default Cleared
Status refresh interval
The interval, in milliseconds, between transactions to refresh publish or subscribe status.
Data type Integer Default 6000
Subscription store
Specify where WebSphere MQ stores data relating to active JMS subscriptions.
Data type Enum Default MIGRATE Range
- MIGRATE
- QUEUE
- BROKER
Multicast
Specify whether this connection factory uses multicast transport.
Data type Enum Default NOT USED Range
- NOT USED
- This connection factory does not use multicast transport.
- ENABLED
- This connection factory always uses multicast transport.
- ENABLED_IF_AVAILABLE
- This connection factory uses multicast transport.
- ENABLED_RELIABLE
- This connection factory uses reliable multicast transport.
- ENABLED_RELIABLE_IF_AVAILABLE
- This connection factory uses reliable multicast transport if available.
Direct authentication
Specify whether to use direct broker authorization.
Data type Enum Default NONE Range
- NONE
- Direct broker authorization is not used.
- PASSWORD
- Direct broker authorization is authenticated with a password.
- CERTIFICATE
- Direct broker authorization is authenticated with a certificates.
Proxy Host Name
Specify the host name of a proxy to be used for communication with WebSphere MQ.
Data type String
Proxy Port
Port number of a proxy to be used for communication with WebSphere MQ.
Data type Integer Default 0
Fail if quiesce
Specify whether applications return from a method call if the queue manager has entered a controlled failure.
Data type Check box Default Selected
Local Server Address
Local server address.
Data type String
Polling Interval
Specify the interval, in milliseconds, between scans of all receivers during asynchronous message delivery.
Data type Integer Units Milliseconds Default 5000
Rescan interval
Specify the interval in milliseconds between which a topic is scanned to look for messages added to a topic out of order.
This interval controls the scanning for messages added to a topic out of order with respect to a WebSphere MQ browse cursor.
Data type Integer Units Milliseconds Default 5000
SSL cipher suite
Specify the cipher suite to use for SSL connection to WebSphere 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.
Set this property, if you set the SSL Peer Name property.
SSL certificate store
Specify 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, use WebSphere MQ JVM at Java 2 version 1.4. The value is a space-delimited list of entries of the form:
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 section "Working with Certificate Revocation Lists" in the WebSphere MQ Security book; for example at: http://publibfp.boulder.ibm.com/epubs/html/csqzas01/csqzas012w.htm#IDX2254.
SSL peer name
For SSL, a distinguished name skeleton that must match the name provided by the WebSphere 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. This property is a list of attribute name and value pairs separated by commas or semicolons. For example:
CN=QMGR.*, OU=IBM, OU=WEBSPHEREThe 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 WebSphere MQ, see the section "Distinguished Names" in the WebSphere MQ Security book.
Connection pool
Specify an optional set of connection pool settings.
Connection pool properties are common to all J2C connectors.
The appserver pools connections and sessions with the JMS provider to improve performance. This is independent from any WebSphere MQ connection pooling. We need to configure the connection and session pool properties appropriately for your applications, otherwise you may 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.
Data type Check box Default Selected
Related tasks
Use application clients
Configure new JMS providers with the Application Client Resource Configuration Tool
Configure Java messaging client resources