Set a queue connection factory for the WebSphere MQ messaging provider > factory advanced properties
To set the advanced properties of the selected queue connection factory for use with the WebSphere MQ messaging provider. These advanced properties control the behavior of connections made to WebSphere MQ messaging provider destinations.
To view WebSphere MQ queue connection factory advanced properties, use the admin console to complete the following steps:
- In the navigation pane, clickResources > JMS > Queue connection factories 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. This 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 WebSphere MQ queue connection factory.
Under General Properties there are five groups of properties:
- 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.
When specifying WebSphere MQ properties, the following restrictions apply:
- Names can have a maximum of 48 characters, with the exception of channels, which have a maximum of 20 characters.
- The property values specified must match the values that you specified when configuring WebSphere MQ for JMS resources.
See about configuring WebSphere MQ for JMS resources, see the WebSphere MQ Use Java™ section of the WebSphere MQ library.
A WebSphere MQ queue connection factory has the following advanced properties:
- Compress message headers
An option that enables the compression of message headers.
Data type Check box Default Cleared Range
- Cleared
- Do not compress message headers.
- Selected
- Compress message headers.
- Compression algorithm for message payloads
The compression algorithm used to compress message payloads.
Data type Drop-down list Default NONE Range
- RLE
- ZLIBFAST
- ZLIBHIGH
- NONE
- WebSphere MQ model queue name
The model queue used as a basis for temporary queue definitions.
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.
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.
Data type Check box Default Selected Range
- Cleared
- Do not retain messages.
- Selected
- Retain messages.
- Polling interval
This setting is applicable in the client container only. When using a WebSphere MQ version 6 queue manager (or WebSphere 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 WebSphere MQ queues that is being asynchronously consumed from exceeds the number of threads that are available internally to synchronously get messages from the WebSphere MQ queue. The setting determines how long a thread waits for a message to arrive at a WebSphere MQ queue before polling another WebSphere MQ queue in the set.
Data type Integer Units Milliseconds Default 5000 Range A value greater than zero.
- Rescan interval
When using a WebSphere MQ version 6 queue manager (or WebSphere 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 WebSphere MQ queues that is being asynchronously consumed from exceeds the number of threads that are available internally to synchronously get messages from the WebSphere MQ queue. The setting determines how long a thread retrieves messages from a WebSphere MQ queue before switching to consume messages from another WebSphere MQ queue in the set.
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.
Data type Integer Default 10 Range A value greater than zero.
- Coded character set identifier
The character set to use when we are encoding strings in the message.
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 WebSphere MQ.
See about supported CCSIDs, and about converting between message data from one coded character set to another, see the WebSphere MQ System Administration and the WebSphere MQ Application Programming Reference sections of the WebSphere MQ library.
- Append an RFH version 2 header to reply messages
The action to take when replying to a message that does not have an RFH version 2 header.
Data type Check box Default Selected Range
- Selected
- Append an RFH version 2 header to reply messages.
- Cleared
- Do not append an RFH version 2 header to reply messages.
- Fail JMS method calls if the WebSphere 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.
Data type Check box Default Selected Range
- Cleared
- Do not fail JMS operations if the queue manager is quiescing.
- Selected
- Fail JMS operations if the queue manager is quiescing.
Related
Mapping of admin console panel names to command names and WebSphere MQ names
WebSphere MQ messaging provider queue connection factory settings