WebSphere 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 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 administrative console to complete the following steps:
  1. In the navigation pane, clickResources > JMS > Queue connection factories to display existing queue connection factories.
  2. 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.
  3. Select the name of the queue connection factory that you want to work with.
  4. 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:

Make any required changes to these groups and then click Apply to return to the queue connection factory.

Note: When specifying WebSphere MQ properties, the following restrictions apply:

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 that is 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 that is 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 you 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.

For more information 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 required when sending a reply message to the reply-to queue obtained from a message that does not include an RFH version 2 header.

Data type Check box
Default Cleared
Range
Selected
Append an RFH version 2 header to reply messages regardless of whether the original message had a RFH version 2 header.
Cleared
Only append an RFH version 2 header to reply messages if the original message had a RFH version 2 header.

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 tasks
Configuring a queue connection factory for the WebSphere MQ messaging provider
Related reference
Mapping of administrative console panel names to command names and WebSphere MQ names
WebSphere MQ messaging provider queue connection factory settings
Reference topic    

Terms of Use | Feedback

Last updated: Oct 21, 2010 3:36:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=compass&product=was-express-iseries&topic=umj_pqcfm_advprops
File name: umj_pqcfm_advprops.html