+

Search Tips   |   Advanced Search

IBM MQ Provider topic connection factory settings for application clients

Use this panel to view or change the configuration properties of the selected topic 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 File > Open. After you browse for an EAR file, click Open. Expand the selected JAR file > Messaging Providers > IBM MQ Provider. Right-click Topic Connection Factories and click New.

MA0C broker: When creating a WebSphere Application Server v6 topic connection factory for the MA0C broker, 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.

BrokerVersion

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 our client application).

XA Enabled

Set this value to TRUE or FALSE for the MA0C broker (the setting we use is a performance enhancement flag - you probably want to set this value 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 IBM MQ JMS provider has the following properties.


Name

The name by which this topic connection factory is known for administrative purposes within WAS. The name must be unique within the JMS provider.

Information Value
Data type String


Description

A description of this topic connection factory for administrative purposes within WAS.

Information Value
Data type String


JNDI Name

The JNDI name 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.

Information Value
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 user ID and password explicitly.

If we specify a value for the user ID property, we 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 createTopicConnection(). 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 we specify a value for the user ID property, we must also specify a value for the password property.

Information Value
Data type String


Re-Enter Password

Confirms the password.


Queue Manager

The name of the IBM MQ queue manager for this connection factory. Connections created by this connection factory connect to this 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 connections only.

Information Value
Data type String
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
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 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.

The format of the list is: 

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 information center.

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 client connections to the IBM MQ queue manager, for client connection only.

Information Value
Data type String
Range 1 through 20 ASCII characters


Transport Type

Whether IBM MQ client connection or JNDI bindings are used for connection to the IBM MQ queue manager.

Information Value
Data type Enum
Default BINDINGS
Range

CLIENT

IBM MQ client connection is used to connect to the IBM MQ queue manager.

BINDINGS

JNDI bindings are used to connect to the IBM MQ queue manager.


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 to use with the IBM MQ queue manager.

This coded character set identifier (CCSID) must be one of the CCSIDs that IBM MQ supports. See the properties for the topic destination for more details.

Information Value
Data type String
Units Integer
Range 1 through 65535


Broker Control Queue

The name of the broker control queue to which all command messages (except publications and requests to delete publications) are sent.

Information Value
Data type String
Units En_US ASCII characters
Range 1 through 48 ASCII characters


Broker Queue Manager

The name of the IBM MQ queue manager that provides the Publisher and Subscriber message broker.

Information Value
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.

Information Value
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.

Information Value
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.

Information Value
Data type String
Units En_US ASCII characters
Range 1 through 48 ASCII characters


Broker Version

Whether the message broker is provided by the IBM MQ MA0C SupportPac or newer versions of WebSphere family message broker products.

Information Value
Data type Enum
Default Advanced
Range

Advanced

The message broker is provided by newer versions of WebSphere family message broker products (IBM MQ Integrator and IBM MQ Publish and Subscribe).

Basic

The message broker is provided by the IBM MQ MA0C SupportPac (IBM MQ - Publish and Subscribe).


Cleanup level

The level of cleanup provided by the publish or subscribe cleanup utility.

Information Value
Data type Enum
Default SAFE
Range

ASPROP

NONE

STRONG


Cleanup interval

The interval, in milliseconds, between background executions of the publish/subscribe cleanup utility.

Information Value
Data type Integer
Units Milliseconds
Default 6000


Message selection

Where broker message selection is performed.

Information Value
Data type Enum
Default BROKER
Range

BROKER

Message selection is performed at the broker location.

Message CLIENT

Message selection is performed at the client location.


Publish acknowledge interval

The interval, in number of messages, between publish requests that require acknowledgment from the broker.

Information Value
Data type Integer
Default 25


Sparse subscriptions

Enables sparse subscriptions.

Information Value
Data type Check box
Default Cleared


Status refresh interval

The interval, in milliseconds, between transactions to refresh the publish or subscribe status.

Information Value
Data type Integer
Default 6000


Subscription store

Where IBM MQ stores data relating to active JMS subscriptions.

Information Value
Data type Enum
Default MIGRATE
Range

MIGRATE

QUEUE

BROKER


Multicast

Whether this connection factory uses multicast transport.

Information Value
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

Whether to use direct broker authorization.

Information Value
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 certificate.


Proxy Host Name

The host name of a proxy to be used for communication with IBM MQ.

Information Value
Data type String


Proxy Port

The port number of a proxy to be used for communication with IBM MQ.

Information Value
Data type Integer
Default 0


Fail if quiesce

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

The local server address.

Information Value
Data type String


Polling Interval

The interval, in milliseconds, between scans of all receivers during asynchronous message delivery.

Information Value
Data type Integer
Units Milliseconds
Default 5000


Rescan interval

The interval in milliseconds between which a topic is scanned to look for messages that have been added to a topic out of order.

The rescan 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

The cipher suite to use for SSL connection to IBM MQ.

Set 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.

We must set this property, if we set the SSL Peer Name property.


SSL certificate store

A list of zero or more Certificate Revocation List (CRL) servers used to check for SSL certificate revocation. If we specify a value for this property, we must use IBM 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 information about "Working with Certificate Revocation Lists" in the Security section of the IBM MQ information center.


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.

This property is a list of attribute name and value pairs separated by commas or semicolons. For example: 

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 Security section of the IBM MQ information center.


Connection pool

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. Configure the connection and session pool properties appropriately for the applications, otherwise we might not get the connection and session behavior that we 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

DISABLED

The client reconnection does not automatically occur.

ASDEF

The value from the DefRecon attribute from the channels stanza of the client configuration file is used. If there is no DefRecon value specified then this setting has the same effect as a value of DISABLED.

RECONNECT

Reconnection occurs to any queue manager consistent with the value of the queue manager attribute, which might be a different queue manager from that to which the connection was originally connected.

QMGR

Reconnection only occurs to the queue manager to which the connection was originally connected.

For more information about automatic client reconnection, see the IBM MQ information center.


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 information center.

  • Use application clients
  • Configure new JMS providers with the Application Client Resource Configuration Tool
  • IBM MQ messaging provider topic connection factory settings

    IBM MQ library