[jboss-cvs] JBoss Messaging SVN: r8379 - branches/Branch_1_4/docs/userguide/en/modules.

[jboss-cvs-commits at lists.jboss.org]

Author: gaohoward
Date: 2011-07-06 04:18:09 -0400 (Wed, 06 Jul 2011)
New Revision: 8379

Modified:
   branches/Branch_1_4/docs/userguide/en/modules/configuration.xml
Log:
JBPAPP-6446


Modified: branches/Branch_1_4/docs/userguide/en/modules/configuration.xml
===================================================================
--- branches/Branch_1_4/docs/userguide/en/modules/configuration.xml	2011-07-05 17:07:05 UTC (rev 8378)
+++ branches/Branch_1_4/docs/userguide/en/modules/configuration.xml	2011-07-06 08:18:09 UTC (rev 8379)
@@ -2615,6 +2615,16 @@
         <para>Minimum processing time allowed for (milliseconds) in a timeout receive. This is the minimum time for the internal processing after a message is arrived at the client
         but before returning the message to the application. Default is 300. </para>
 
+	<para><note>
+
+        <para>When consumer is using AUTO_ACKNOWLEDGE session and time out for receive method expires in the moment when message is received at the client buffer but acknowledgement
+        is not confirmed by the server, then this message will be discarded and an exception is thrown. like</para>
+
+        <para>javax.jms.JMSException: Timed out before post message processing, discarding message delegator->JBossMessage[23357322686633840]ERSISTENT, deliveryId=0 at  org.jboss.jms.client.container.ClientConsumer.receive(ClientConsumer.java:596)</para>
+
+        <para>This can happen when time out for receive method is too low. Use CLIENT_ACKNOWLEDGE mode or Transactional mode to avoid such message loss.</para>
+        </note></para>
+
       </section>
 
     <!-- End conf.connectionfactory.attributes -->