1. jms-spec
  2. JMS_SPEC-84

Clarify when acknowledged persistent messages may be dropped


    • Type: Improvement Improvement
    • Status: Open
    • Priority: Major Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:


      The javadoc for javax.jms.DeliveryMode ( states:

      Delivery mode covers only the transport of the message to its destination. Retention of a message at the destination until its receipt is acknowledged is not guaranteed by a PERSISTENT delivery mode. Clients should assume that message retention policies are set administratively. Message retention policy governs the reliability of message delivery from destination to message consumer. For example, if a client's message storage space is exhausted, some messages may be dropped in accordance with a site-specific message retention policy.

      A message is guaranteed to be delivered once and only once by a JMS provider if the delivery mode of the message is PERSISTENT and if the destination has a sufficient message retention policy.

      This introduces several important features of JMS which are not described in such explicit terms in the JMS specification itself, in particular the statement that a JMS provider may drop (delete from storage) an unacknowledged message if the client is somehow running out of resources. The expression "message retention policy" is not used in the spec.

      Section 4.10 "Reliability" is the relevant section. This states that "Once-and-only-once message delivery, as described in this specification... does not cover loss due to resource restrictions" but does not mention that messages may be dropped from the server because the client was short of resources.

      This should be clarified.


        Nigel Deakin created issue -
        Nigel Deakin made changes -
        Field Original Value New Value
        Tags pd20-forreview
        Nigel Deakin made changes -
        Tags pd20-forreview pd20-forreview pd20-minor
        Nigel Deakin made changes -
        Tags pd20-forreview pd20-minor pd20-minor
        Nigel Deakin made changes -
        Tags pd20-minor
        Nigel Deakin made changes -
        Tags pd20-veryminor


          • Assignee:
            Nigel Deakin
          • Votes:
            0 Vote for this issue
            1 Start watching this issue


            • Created: