Return-Path: 
 <commits-return-12716-apmail-qpid-commits-archive=qpid.apache.org@qpid.apache.org>
Delivered-To: apmail-qpid-commits-archive@www.apache.org
Received: (qmail 70989 invoked from network); 7 May 2010 22:38:31 -0000
Received: from unknown (HELO mail.apache.org) (140.211.11.3)
  by 140.211.11.9 with SMTP; 7 May 2010 22:38:31 -0000
Received: (qmail 79535 invoked by uid 500); 7 May 2010 22:38:31 -0000
Delivered-To: apmail-qpid-commits-archive@qpid.apache.org
Received: (qmail 79514 invoked by uid 500); 7 May 2010 22:38:31 -0000
Mailing-List: contact commits-help@qpid.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:commits-help@qpid.apache.org>
List-Unsubscribe: <mailto:commits-unsubscribe@qpid.apache.org>
List-Post: <mailto:commits@qpid.apache.org>
List-Id: <commits.qpid.apache.org>
Reply-To: dev@qpid.apache.org
Delivered-To: mailing list commits@qpid.apache.org
Received: (qmail 79507 invoked by uid 99); 7 May 2010 22:38:31 -0000
Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 07 May 2010 22:38:31 +0000
X-ASF-Spam-Status: No, hits=-2000.0 required=10.0
	tests=ALL_TRUSTED
X-Spam-Check-By: apache.org
Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4)
    by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 07 May 2010 22:38:29 +0000
Received: by eris.apache.org (Postfix, from userid 65534)
	id B78BC238897F; Fri,  7 May 2010 22:37:31 +0000 (UTC)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r942258 -
 /qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
Date: Fri, 07 May 2010 22:37:31 -0000
To: commits@qpid.apache.org
From: jonathan@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20100507223731.B78BC238897F@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org

Author: jonathan
Date: Fri May  7 22:37:31 2010
New Revision: 942258

URL: http://svn.apache.org/viewvc?rev=942258&view=rev
Log:
Added sizing the replay buffer.

Modified:
    qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml

Modified: qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml
URL: http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml?rev=942258&r1=942257&r2=942258&view=diff
==============================================================================
--- qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml (original)
+++ qpid/trunk/qpid/doc/book/src/Programming-In-Apache-Qpid.xml Fri May  7 22:37:31 2010
@@ -1589,7 +1589,7 @@ sender.send(message, true);
         <section>
       <title>Performance</title>
       <para>
-         Clients can often be made significantly faster by batching acknowledgements and setting the capacity of receivers to allow prefetch. 	
+         Clients can often be made significantly faster by batching acknowledgements and setting the capacity of receivers to allow prefetch. The size of a sender's replay buffer can also affect performance.
       </para>
       <section>
 	<title>Batching Acknowledgements</title>
@@ -1625,8 +1625,34 @@ Message message = receiver.fetch();
 	</example>
       </section>
 
+      <section>
+	<title>Sizing the Replay Buffer</title>
+
+	<para>In order to guarantee delivery, a sender automatically
+	keeps messages in a replay buffer until the messaging broker
+	acknowledges that they have been received. The replay buffer
+	is held in memory, and is never paged to disk. For most
+	applications, the default size of the replay buffer works
+	well. A large replay buffer requires more memory, a small
+	buffer can slow down the client because it can not send new
+	messages if the replay buffer is full, and must wait for
+	existing sends to be acknowledged.</para>
+
+	<example>
+	  <title>Sizing the Replay Buffer</title>
+	  <para>C++</para>
+ 
+	  <programlisting>
+Sender sender = session.createSender(address);
+sender.setCapacity(100);
+	  </programlisting>
+	</example>
+	  
+      </section>
+
     </section>
 
+
     <section>
       <title>Reliability</title>
 
@@ -1655,27 +1681,24 @@ message.setDurable(1);
 
 sender.send(Message("Hello world!"));
 ]]></programlisting>
-	</example>
 <!--
 	  <para>Python:</para>
 -->
-<!--	</example>
+	</example>
 
 	<section>
-	  <title>Cluster Failover </title>
+	  <title>Cluster Failover #### </title>
 	</section>
--->
 
       </section>
 
     </section>
 
-<!--
     <section>
-      <title>Security</title>
-##########
+      <title>Security ####</title>
+
     </section>
--->
+
 
     <section>
       <title>Transactions</title>



---------------------------------------------------------------------
Apache Qpid - AMQP Messaging Implementation
Project:      http://qpid.apache.org
Use/Interact: mailto:commits-subscribe@qpid.apache.org