IBM MQ messaging provider activation specification advanced properties
Use this page to view or change the advanced properties of the selected activation specification 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 activation specifications.
- 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.
- Select the name of the activation specification 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 activation specification.
- Message compression
- Connection consumer
- Message format
- Additional
Make any required changes to these groups and then click Apply to return to the activation specification.
- Names can have a maximum of 48 characters, with the exception of channels, which have a maximum of 20 characters.
- The property values that you specify must match the values that you specified when configuring IBM MQ for JMS resources. For more information about configuring IBM MQ for JMS resources, see the Using Java™ section of the IBM MQ documentation.
An IBM 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 |
|
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 |
|
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 |
|
Rescan interval
When using an IBM MQ Version 6 queue manager (or WebSphere® MQ for z/OS® Version 5.3 ), this setting configures the mechanism that is 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 consume 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 server sessions
The maximum number of server sessions in the server session pool that is 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 you are encoding strings in the message.
The coded character set identifier (CCSID) is only applicable for activation specification advanced properties if your messaging system is using IBM MQ Version 6.0. If you are using IBM MQ Version 7.0 you must define the CCSID that you want to use for your messages at your queue destination.
If your application constructs messages for an IBM MQ application that requires a different character or numeric encoding, you 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 you can use for JMS_IBM_Character_Set and JMS_IBM_Encoding, see the IBM MQ documentation.
Information | Value |
---|---|
Data type | Integer |
Default | 819 |
Range | A value greater than zero. The value 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 documentation.
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 |
|
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 |
|
Number of sequential delivery failures before suspending endpoint
The number of sequential message delivery failures to an endpoint that are 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. |