+

Search Tips   |   Advanced Search


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:

  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.

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