WebSphere MQ messaging provider activation specification advanced properties

Use this panel to view or change the advanced properties of the selected activation specification 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 activation specification advanced properties, use the administrative console to complete the following steps:

1. To display existing activation specifications.
   Resources | JMS->Activation specifications

2. If appropriate, in the content pane, change the Scope setting to the level at which the activation specifications are defined. This restricts the set of activation specifications displayed.

3. Select the name of the activation specification 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 activation specification.

Under General Properties there are four groups of properties:

• Message compression

• Connection consumer

• Message format

• Additional

Make any required changes to these groups and then click Apply to return to the activation specification.

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 specified when configuring WebSphere MQ for JMS resources. For more information about configuring WebSphere MQ for JMS resources, see the Use Java section of the WebSphere MQ information center.

A WebSphere MQ activation specification has the following advanced properties.

Compress message headers

An option that enables the compression of message headers.

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

Information	Value
Data type	Drop-down list
Default	NONE
Range	RLE Message data compression is performed using run-length encoding. ZLIBFAST Message data compression is performed using ZLIB encoding with speed prioritized. ZLIBHIGH Message data compression is performed using ZLIB encoding with compression prioritized. NONE No message data compression is performed.

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	Cleared Do not retain messages. Selected Retain messages.

Rescan interval

When using a WebSphere MQ Version 6 queue manager (or WebSphere MQ for z/OS Version 5.3 ), 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.

Information	Value
Data type	Integer
Units	Milliseconds
Default	5000
Range	A value greater than zero.

Maximum server sessions

The maximum number of server sessions in the server session pool used by the connection consumer.

Information	Value
Data type	Integer
Default	10
Range	A value greater than zero.

Server session pool timeout

The period of time, in milliseconds, that an unused server session is held open in the server session pool before being closed due to inactivity.

Information	Value
Data type	Integer
Units	Milliseconds
Default	300,000
Range	A value greater than zero.

Start timeout

The period of time, in milliseconds, within which delivery of a message to a message-driven bean (MDB) must start after the work to deliver the message has been scheduled. If this period of time elapses, the message is rolled back onto the queue.

Information	Value
Data type	Integer
Units	Milliseconds
Default	10,000
Range	A value greater than zero.

Coded character set identifier

The character set to use when we are encoding strings in the message.

The coded character set identifier (CCSID) is only applicable for activation specification advanced properties if the messaging system is using WebSphere MQ Version 6.0. If we are using WebSphere MQ Version 7.0 define the CCSID to use for the messages at the queue destination. For more information on how to do this, see WebSphere MQ Provider queue destination settings for application clients.

If the application constructs messages for a WebSphere MQ application that requires a different character or numeric encoding, we can override the character encoding value by setting the JMS_IBM_Character_Set property to the required coded character set ID (CCSID), or the JMS_IBM_Encoding property to the required numeric format, or both. For information about the values we can use for JMS_IBM_Character_Set and JMS_IBM_Encoding, see the WebSphere MQ information center.

Information	Value
Data type	Integer
Default	819
Range	A value greater than zero. The value 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 System Administration and the Application Programming Reference sections of the WebSphere MQ information center.

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.

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

Stop endpoint if message delivery fails

An option that determines whether message delivery is suspended to a failing endpoint.

Information	Value
Data type	Check box
Default	Selected
Range	Cleared Message delivery is not suspended to a failing endpoint. Selected Message delivery is suspended to a failing endpoint when the value for the Number of sequential delivery failures before suspending endpoint is exceeded.

Number of sequential delivery failures before suspending endpoint

The number of sequential message delivery failures to an endpoint allowed before message delivery to that endpoint is suspended. This property is enabled only when Stop endpoint if message delivery fails is selected.

Information	Value
Data type	Integer
Default	0
Range	A value greater than or equal to zero.

Related tasks

Configure an activation specification for the WebSphere MQ messaging provider

WebSphere MQ Provider queue destination settings for application clients

Mapping of administrative console panel names to command names and WebSphere MQ names
WebSphere MQ library Reference topic