Skip navigation.

Administration Console Online Help

PreviousNextvertical dots separating previous/next from contents/index/pdfContents

JMS Templates: Configuration: Override

Configuration Options     Related Tasks     Related Topics

Destinations can override some of the settings (such as priority) that the message producer includes with its messages. Use this page to configure such overrides for destinations that are based on this template.

As with all template options, settings in individual destinations supersede template settings.

Configuration Options

Name Description
Priority Override

The priority assigned to all messages that arrive at the destination, regardless of the Priority specified by the message producer.

With a value of -1, the destination will not override the Priority set by the message producer.

This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.

MBean Attribute (Does not apply to application modules):
DeliveryParamsOverridesBean.Priority

Minimum value: -1

Maximum value: 9

Time-to-Live Override

The time-to-live assigned to all messages that arrive at this topic, regardless of the TimeToLive value specified by the message producer.

With a value of -1, the destination will not override the TimeToLive setting specified by the message producer.

This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.

MBean Attribute (Does not apply to application modules):
DeliveryParamsOverridesBean.TimeToLive

Minimum value: -1

Maximum value: 9223372036854775807

Time-to-Deliver Override

The default delay, either in milliseconds or as a schedule, between when a message is produced and when it is made visible on its target destination, regardless of the delivery time specified by the producer and/or connection factory.

With a value of -1, the destination will not override the TimeToDeliver setting specified by the producer and/or connection factory. The TimeToDeliver override can be specified either as a long or as a schedule.

Note: Changing the TimeToDeliver override only affects future message delivery, it does not affect message delivery of already produced messages.

MBean Attribute (Does not apply to application modules):
DeliveryParamsOverridesBean.TimeToDeliver

Delivery Mode Override

The delivery mode assigned to all messages that arrive at the destination regardless of the DeliveryMode specified by the message producer.

Persistent specifies that when a persistent message is sent, it is stored in the host server's default persistent store (if no store has been defined for the JMS server), or in a user-defined file store or JDBC-accessible store defined for the JMS server. The send() operation is not considered successful until delivery of the message can be guaranteed. A persistent message is guaranteed to be delivered at least once.

Non-Persistent specifies not to store non-persistent messages in a persistent store. This mode of operation provides the lowest overhead. Messages are guaranteed to be delivered at least once unless there is a system failure, in which case messages may be lost. If a connection is closed or recovered, all non-persistent messages that have not yet been acknowledged will be redelivered. Once a non-persistent message is acknowledged, it will not be redelivered.

No-Delivery specifies that the producer's DeliveryMode will not be overridden.

These overrides are applied before the message is evaluated for suitability for the hosting JMS server. For example, if a client sends a message that is specified as NON-PERSISTENT, but the destination has an override of PERSISTENT, then the message will appear as PERSISTENT when determining if the hosting JMS server can handle the message. The determination of the suitability of the hosting JMS server is based on many factors, such as the existence of a persistent store for the JMS server and the value of the JMS server's Allow Persistent Downgrade parameter.

Note: This attribute is dynamically configurable, but only incoming messages are impacted; stored messages are not impacted.

MBean Attribute (Does not apply to application modules):
DeliveryParamsOverridesBean.DeliveryMode

Related Tasks

Related Topics

 

Skip navigation bar   Back to Top