IBM MQ messaging provider queue connection factory advanced properties
Use this panel to view or change the advanced properties of the selected queue connection factory for use with the IBM MQ messaging provider. These advanced properties control the behavior of connections made to IBM MQ messaging provider destinations.
- In the navigation pane, click to display existing queue connection factories.
- If appropriate, in the content pane, change the Scope setting to the level at which the queue connection factories are defined. Setting the scope in this way restricts the set of queue connection factories displayed.
- Select the name of the queue connection factory that you want to work with.
- In the content pane, under Additional properties, click Advanced properties to view a list of the advanced properties of the IBM MQ queue connection factory.
- Client reconnect
- Message compression
- Temporary destinations
- Connection consumer
- Message format
- Additional
Make any required changes to these groups and then click Apply to return to the queue connection factory.
- Names can have a maximum of 48 characters, except for channels, which have a maximum of 20 characters.
- The property values that you specify must match the values that you specified when configuring JMS resources for IBM MQ. For more information about configuring JMS resources for IBM MQ , see the Using Java™ section of the IBM MQ documentation.
An IBM MQ queue connection factory has the following advanced properties:
Client reconnect options
This property specifies whether a client mode connection reconnects automatically, or not, in the event of a communications or queue manager failure. This parameter 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 (30 minutes) |
Range | A value greater than zero and up to 2147483647 |
For more information about automatic client reconnection, see the IBM MQ documentation.
Compress message headers
An option that enables the compression of message headers.
Information | Value |
---|---|
Data type | Check box |
Default | Cleared |
Range |
|
Compression algorithm for message payloads
The compression algorithm that is used to compress message payloads.
Information | Value |
---|---|
Data type | Drop-down list |
Default | NONE |
Range |
|
IBM MQ model queue name
The model queue that is used as a basis for temporary queue definitions.
Information | Value |
---|---|
Data type | String |
Default | SYSTEM.DEFAULT.MODEL.QUEUE |
Temporary queue prefix
The prefix that is attached to the beginning of the names generated for temporary queues.
Information | Value |
---|---|
Data type | String |
Retain messages, even if no matching consumer is available
An option that determines whether messages for which there is no matching consumer are retained on the input queue or dealt with according with their disposition options.
Information | Value |
---|---|
Data type | Check box |
Default | Selected |
Range |
|
Polling interval
This setting is applicable in the client container only. When using a IBM MQ Version 6 queue manager (or IBM MQ Version 5.3 for z/OS®), this setting configures the mechanism used to dispatch messages to JMS asynchronous consumers.
This setting is used when the set of IBM MQ queues that is being asynchronously consumed from exceeds the number of threads that are available internally to synchronously get messages from the IBM MQ queue. The setting determines how long a thread waits for a message to arrive at a IBM MQ queue before polling another IBM MQ queue in the set.
Information | Value |
---|---|
Data type | Integer |
Units | Milliseconds |
Default | 5000 |
Range | A value greater than zero. |
Rescan interval
When using an IBM MQ Version 6 queue manager (or IBM MQ Version 5.3 for z/OS), this setting configures the mechanism used to dispatch messages to JMS asynchronous consumers.
This setting is used when the set of IBM MQ queues that is being asynchronously consumed from exceeds the number of threads that are available internally to synchronously get messages from the IBM MQ queue. The setting determines how long a thread retrieves messages from an IBM MQ queue before switching to use messages from another IBM MQ queue in the set.
Information | Value |
---|---|
Data type | Integer |
Units | Milliseconds |
Default | 5000 |
Range | A value greater than zero. |
Maximum batch size
The maximum number of messages that can be removed from a queue before at least one must be delivered to an asynchronous consumer.
Information | Value |
---|---|
Data type | Integer |
Default | 10 |
Range | A value greater than zero. |
Coded character set identifier
The character set to use when you are encoding strings in the message.
Information | Value |
---|---|
Data type | Integer |
Default | 819 |
Range | A value greater than zero. The coded character set identifier (CCSID) must be one of the CCSIDs supported by IBM MQ. |
For more information about supported CCSIDs, and about converting between message data from one coded character set to another, see the System Administration and the Application Programming Reference sections of the IBM MQ information center.
Append an RFH version 2 header to reply messages
When sending a reply message to the reply-to queue obtained from a message, select this option to append an RFH version 2 header to the reply message regardless of whether the original message had a RFH version 2 header.
Information | Value |
---|---|
Data type | Check box |
Default | Cleared |
Range |
|
Fail JMS method calls if the IBM MQ queue manager is quiescing
An option that enables selected JMS operations to fail when the queue manager is put into a quiescing state. Selecting this option enables the queue manager to quiesce successfully and shut down.
Information | Value |
---|---|
Data type | Check box |
Default | Selected |
Range |
|