Sun Java System Message Queue 3.7 UR1 Administration Guide

ActivationSpec JavaBean

Table 17–3 shows the configurable properties of the ActivationSpec JavaBean. These properties are used by the application server when instructing the Resource Adapter to activate a message endpoint and associate it with a message-driven bean.

Table 17–3 Activation Specification Properties

Property 

Type 

Default 

Description 

addressList [Property specific to Message Queue JMS Resource Adapter]

String 

Inherited from ResourceAdapter JavaBean

(Optional) Message service address for connecting to Message Queue service

destination [Standard Enterprise JavaBean (EJB) and J2EE Connector Architecture (CA) property]

String 

None 

(Required) Name of destination from which to consume messages

The value must be that of the destinationName property for a Message Queue destination administered object.

destinationType

String 

None 

(Required) Type of destination specified by destination property:

    javax.jms.Queue: Queue destination


    javax.jms.Topic: Topic destination


messageSelector

String 

None 

(Optional) Message selector for filtering messages delivered to consumer

subscriptionName

String 

None 

Name for durable subscriptions 

This property must be set if subscriptionDurability is set to Durable.

subscriptionDurability

String 

NonDurable

Durability of consumer for topic destination:  

    Durable: Durable consumer


    NonDurable: Nondurable consumer


This property is valid only if destinationType is set to javax.jms.Topic, and is optional for nondurable subscriptions and required for durable ones. If set to Durable, the clientID and subscriptionName properties must also be set.

clientId

String 

None 

Client ID for connections to Message Queue service 

This property must be set if subscriptionDurability is set to Durable.

acknowledgeMode

String 

Auto-acknowledge

(Optional) Acknowledgment mode:

    Auto-acknowledge: Auto-acknowledge mode


    Dups-ok-acknowledge: Dups-OK-acknowledge mode


customAcknowledgeMode

String 

None 

Acknowledgment mode for MDB message consumption

Valid values are No_acknowledge or null.

You can use no-acknowledge mode only for a nontransacted, nondurable topic subscription; if you use this setting with a transacted subscription or a durable subscription, subscription activation will fail.  

endpointExceptionRedeliveryAttempts

Integer 

6

Number of times to redeliver a message when MDB throws an exception during message delivery

sendUndeliverableMsgsToDMQ

Boolean 

true

Place message in dead message queue when MDB throws a runtime exception and number of redelivery attempts exceeds the value of endpointExceptionRedeliveryAttempts?

If false, the Message Queue broker will attempt redelivery of the message to any valid consumer, including the same MDB.