uCosminexus Application Server, Common Container Functionality Guide

[Contents][Glossary][Index][Back][Next]

7.12 Definitions in the DD

This section describes the items defined in the DD of the Message-driven Beans.

With the DD of the Message-driven Beans, you set up the items listed in the following table using the attributes specified beneath the <activation-config> tag.

Table 7-10 Items specified with the attributes beneath the <activation-config> tag

Attribute Data type Specifiable value Default value Explanation
destination String -- -- Specifies the name of the destination that sends the message to the Message-driven Bean. Specify the name set in Name of the Administered object for the CJMSP resource adapter in this attribute.
destinationType String
  • javax.jms.Queue
  • javax.jms.Topic
-- Specifies the queue (javax.jms.Queue) or topic (javax.jms.Topic) as the destination type.
messageSelector String -- -- Specifies Message Selector to select the messages to be received.
subscriptionName String -- -- Specifies the name of the persistence subscriber.
Make sure you specify this attribute when Durable is specified in the subscriptionDurability attribute.
subscriptionDurability String
  • Durable
  • NonDurable
NonDurable Specifies whether to set the persistence subscriber.
If you want to set a persistence subscriber, specify Durable, and if you do not want to set a persistence subscriber, specify NonDurable.
This attribute is only valid when javax.jms.Topic is specified in the destinationType attribute.
Also, make sure you specify the following attributes when you specify Durable:
  • subscriptionName
  • clientId
clientId String -- -- Specifies the identifier of the persistence subscriber for connecting to CJMSP Broker.
Make sure you specify this attribute when you specify Durable in the subscriptionDurability attribute.
acknowledgeMode String
  • Auto-acknowledge
  • Dups-ok-acknowledge
Auto-acknowledge Specifies the acknowledgement mode. For details on the modes to be specified, see the JMS specifications.
endpointExceptionRedeliveryAttempts Integer 1 to 2147483647 6 Specifies the number of re-delivery attempts if an exception occurs during message delivery.
sendUndeliverableMsgsToDMQ Boolean
  • true
  • false
true Specifies whether to register the un-delivered messages in the dead message queue when a Message-driven Bean throws a runtime exception and when the re-delivery attempts exceed the count specified in the endpointExceptionRedeliveryAttempts attribute.
If you want to register the un-delivered messages in the dead message queue, specify true, and if you do not want to register the un-delivered messages in the dead message queue, specify false.
If you specify false, the applicable messages are re-delivered to the valid consumers by CJMSP Broker (might even be delivered to the same Message-driven Bean again).
endpointPoolMaxSize Integer 1 to 2147483647 1 Specifies the maximum endpoint pool value.
endpointPoolSteadySize Integer 0 to 2147483647 1 Specifies the minimum endpoint pool value.
endpointExceptionRedeliveryInterval Integer 1 to 2147483647 500 Specifies the interval for re-delivering a message to the endpoint, when an exception occurs, in milliseconds.

Legend:
--: No restrictions on the specifiable value or default value