Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Miscellaneous.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Miscellaneous.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Miscellaneous.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Miscellaneous.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,152 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>Appendix&#160;E.&#160;Miscellaneous - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>Appendix&#160;E.&#160;Miscellaneous</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">Appendix&#160;E.&#160;Miscellaneous</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="Java-Broker-Appendix-Queue-Alerts.html">Prev</a>&#160;</td><th 
align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a 
accesskey="n" 
href="Java-Broker-Miscellaneous-Installing-External-JDBC-Driver.html">Next</a></td></tr></table><hr
 /></div><div class="appendix"><div class="titlepage"><div><div><h1 
class="title"><a 
id="Java-Broker-Miscellaneous"></a>Appendix&#160;E.&#160;Miscellaneous</h1></div></div></div><div
 class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span 
class="section"><a 
href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification">E.1.
 JVM Installation verification</a></span></dt><dd><dl><dt><span 
class="section"><a href="Java-Broker-Miscellaneous.html#Java-Broker-Miscella
 neous-JVM-Verification-Windows">E.1.1. Verify JVM on 
Windows</a></span></dt><dt><span class="section"><a 
href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification-Unix">E.1.2.
 Verify JVM on Unix</a></span></dt></dl></dd><dt><span class="section"><a 
href="Java-Broker-Miscellaneous-Installing-External-JDBC-Driver.html">E.2. 
Installing External JDBC Driver</a></span></dt><dt><span class="section"><a 
href="Java-Broker-Miscellaneous-Installing-Oracle-BDB-JE.html">E.3. Installing 
Oracle BDB JE</a></span></dt></dl></div><div class="section"><div 
class="titlepage"><div><div><h2 class="title"><a 
id="Java-Broker-Miscellaneous-JVM-Verification"></a>E.1.&#160;JVM Installation 
verification</h2></div></div></div><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Miscellaneous-JVM-Verification-Windows"></a>E.1.1.&#160;Verify 
JVM on Windows</h3></div></div></div><p> Firstly confirm that the JAVA_HOME 
environment variable is set correctly
  by typing the
+        following at the command prompt: </p><pre class="programlisting">echo 
%JAVA_HOME%</pre><p> If JAVA_HOME is set you will see something similar to the 
following: </p><pre class="screen">c:"\PROGRA~1"\Java\jdk1.7.0_79\
+      </pre><p> Then confirm that a Java installation (1.7 or higher) is 
available: </p><pre class="programlisting">java -version</pre><p> If java is 
available on the path, output similar to the following will be seen: </p><pre 
class="screen">java version "1.7.0_79"
+Java(TM) SE Runtime Environment (build 1.7.0_79-b15)
+Java HotSpot(TM) 64-Bit Server VM (build 24.79-b02, mixed 
mode)</pre></div><div class="section"><div class="titlepage"><div><div><h3 
class="title"><a 
id="Java-Broker-Miscellaneous-JVM-Verification-Unix"></a>E.1.2.&#160;Verify JVM 
on Unix</h3></div></div></div><p> Firstly confirm that the JAVA_HOME 
environment variable is set correctly by typing the
+        following at the command prompt: </p><pre class="programlisting">echo 
$JAVA_HOME</pre><p> If JAVA_HOME is set you will see something similar to the 
following: </p><pre class="screen">/usr/java/jdk1.7.0_80
+      </pre><p> Then confirm that a Java installation (1.7 or higher) is 
available: </p><pre class="programlisting">java -version</pre><p> If java is 
available on the path, output similar to the following will be seen: </p><pre 
class="screen">java version "1.7.0_80"
+Java(TM) SE Runtime Environment (build 1.7.0_80-b15)
+Java HotSpot(TM) 64-Bit Server VM (build 24.80-b11, mixed 
mode)</pre></div></div></div><div class="navfooter"><hr /><table 
summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a 
accesskey="p" 
href="Java-Broker-Appendix-Queue-Alerts.html">Prev</a>&#160;</td><td 
align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a 
accesskey="n" 
href="Java-Broker-Miscellaneous-Installing-External-JDBC-Driver.html">Next</a></td></tr><tr><td
 align="left" valign="top" width="40%">Appendix&#160;D.&#160;Queue 
Alerts&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;E.2.&#160;Installing External JDBC 
Driver</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Background-Recovery.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Background-Recovery.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Background-Recovery.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Background-Recovery.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,157 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.7.&#160;Background Recovery - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.7.&#160;Background Recovery</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.7.&#160;Background Recovery</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="Java-Broker-Runtime-Flow-To-Disk.html">Prev</a>&#160;</td><th 
align="center" width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Message-Compression.html">Next</a></td></tr></table><hr
 /></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="Java-Broker-Runtime-Background-Recovery"></a>9.7.&#160;Background 
Recovery</h2></div></div></div><p>On startup of the Broker, or restart of a 
Virtualhost, the Broker restores all durable
+    queues and their messages from disk. In the Broker's default mode the 
Virtualhosts do not become
+    active until this recovery process completes. If queues have a large 
number of entries, this may
+    take considerable time. During this time no messaging can be 
performed.</p><p>The Broker has a background recovery feature allows the system 
to return to operation
+    sooner. If enabled the recovery process takes place in the background 
allow producers and
+    consumers to begin work earlier.</p><p>The feature respects the message 
delivery order requirements of standard queues, that is any
+    messages arriving whilst the background recovery is in flight won't 
overtake older messages
+    still to be recovered from disk. There is an exception for the out of 
order queue types whilst
+    background recovery is in flight. For instance, with priority queues older 
lower priority
+    messages may be delivered before newer, higher priority.</p><p>To activate 
the feature, set a <a class="link" 
href="Java-Broker-Management-Managing-Entities.html#Java-Broker-Management-Managing-Entities-General"
 title="7.1.&#160;General Description">context variable</a>
+    <code class="literal">use_async_message_store_recovery</code> at the 
desired Virtualhost, or at Broker or
+    higher to enable the feature broker-wide.</p><div class="note" 
style="margin-left: 0.5in; margin-right: 0.5in;"><h3 
class="title">Note</h3><p>The background recovery feature does not write 
operational log messages to indicate its
+      progress. This means messages <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-MST-1004">MST-1004</a>
 and <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-MST-1005">MST-1005</a>
 will not
+      be seen.</p></div></div><div class="navfooter"><hr /><table 
summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a 
accesskey="p" 
href="Java-Broker-Runtime-Flow-To-Disk.html">Prev</a>&#160;</td><td 
align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Message-Compression.html">Next</a></td></tr><tr><td 
align="left" valign="top" width="40%">9.6.&#160;Flow to Disk&#160;</td><td 
align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td 
align="right" valign="top" width="40%">&#160;9.8.&#160;Message 
Compression</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Close-Connection-When-No-Route.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Close-Connection-When-No-Route.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Close-Connection-When-No-Route.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Close-Connection-When-No-Route.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,173 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.5.&#160;Closing client connections on unroutable mandatory 
messages - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.5.&#160;Closing client connections on unroutable 
mandatory messages</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.5.&#160;Closing client connections on unroutable mandatory 
messages</th></tr><tr><td align="left" width="20%"><a accesskey="p" 
href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">Prev</a>&#160;</td><th
 align="center" width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Flow-To-Disk.html">Next</a></td></tr></table><hr 
/></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="Java-Broker-Runtime-Close-Connection-When-No-Route"></a>9.5.&#160;Closing 
client connections on unroutable mandatory messages</h2></div></div></div><div 
class="section"><div class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Runtime-Close-Connection-When-No-Route-Summary"></a>9.5.1.&#160;Summary</h3></div></div></div><p>
+        Due to asynchronous nature of AMQP 0-8/0-9/0-9-1 protocols sending a 
message with a routing key for which no queue binding exist results
+        in either message being bounced back (if it is mandatory or immediate) 
or discarded on broker side otherwise.
+    </p><p>
+        When a 'mandatory' message is returned back, the Qpid JMS client 
conveys this by delivering
+        an <span class="emphasis"><em>AMQNoRouteException</em></span> through 
the configured ExceptionListener on the Connection.
+        This does not cause channel or connection closure, however it requires 
a special exception handling
+        on client side in order to deal with <span 
class="emphasis"><em>AMQNoRouteExceptions</em></span>.
+        This could potentially be a problem when using various messaging 
frameworks (e.g. Mule)
+        as they usually close the connection on receiving any JMSException.
+    </p><p>
+        In order to simplify application handling of scenarios where 
'mandatory' messages
+        are being sent to queues which do not actually exist, the Java Broker 
can be configured such that
+        it will respond to this situation by closing the connection
+        rather than returning the unroutable message to the client as it 
normally should.
+        From the application perspective, this will result in failure of 
synchronous operations in progress such as a session commit() call.
+    </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 
class="title">Note</h3><p>This feature affects only transacted sessions.</p><p>
+            Qpid JMS client sends 'mandatory' messages when using Queue 
destinations
+            and 'non-mandatory' messages when using Topic destinations.
+        </p></div></div><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Runtime-Close-Connection-When-No-Route-Configuration"></a>9.5.2.&#160;Configuring
 <span 
class="emphasis"><em>closeWhenNoRoute</em></span></h3></div></div></div><p>
+        The Broker attribute <span 
class="emphasis"><em>closeWhenNoRoute</em></span> can be set to specify this 
feature on broker side.
+        By default, it is turned on. Setting <span 
class="emphasis"><em>closeWhenNoRoute</em></span> to <span 
class="emphasis"><em>false</em></span> switches it off.
+    </p><p>
+        Setting the <span class="emphasis"><em>closeWhenNoRoute</em></span> in 
the JMS client connection URL can override the broker configuration
+        on a connection specific basis, for example :
+    </p><div class="example"><a id="idm140683143330832"></a><p 
class="title"><strong>Example&#160;9.1.&#160;Disable feature to close 
connection on unroutable messages with client URL</strong></p><div 
class="example-contents"><pre class="screen">
+amqp://guest:guest@clientid/?brokerlist='tcp://localhost:5672'&amp;closeWhenNoRoute='false'</pre></div></div><br
 class="example-break" /><p>
+       If no value is specified on the client the broker setting will be used. 
If client setting is specified then it will take precedence
+       over the broker-wide configuration. If the client specifies and broker 
does not support this feature the warning will be logged.
+    </p></div></div><div class="navfooter"><hr /><table summary="Navigation 
footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" 
href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">Prev</a>&#160;</td><td
 align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Flow-To-Disk.html">Next</a></td></tr><tr><td 
align="left" valign="top" width="40%">9.4.&#160;Handing Undeliverable 
Messages&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;9.6.&#160;Flow to Disk</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Connection-Limit.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Connection-Limit.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Connection-Limit.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Connection-Limit.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,167 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.9.&#160;Connection Limits - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.9.&#160;Connection Limits</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.9.&#160;Connection Limits</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="Java-Broker-Runtime-Message-Compression.html">Prev</a>&#160;</td><th 
align="center" width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Memory.html">Next</a></td></tr></table><hr 
/></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="Java-Broker-Runtime-Connection-Limit"></a>9.9.&#160;Connection 
Limits</h2></div></div></div><p>
+     Each connection to the Broker consumes resources while it is connected. 
In order to protect
+     the Broker against malfunctioning (or malicious) client processes, it is 
possible to limit the
+     number of connections that can be active on any given port.
+   </p><p>
+       Connection limits on AMQP ports are controlled by an attribute 
"maxOpenConnections" on
+       the port. By default this takes the value of the context variable 
+       <code class="literal">qpid.port.max_open_connections</code> which in 
itself is defaulted to the
+       value <code class="literal">-1</code> meaning there is no limit.
+   </p><p>
+       If the interpolated value of <code 
class="literal">maxOpenConnections</code> on an AMQP port is a
+       positive integer, then when that many active connections have been 
established no new
+       connections will be allowed (until an existing connection has been 
closed). Any such 
+       rejection of a connection will be accompanied by the operational log 
message
+       <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-PRT-1005">PRT-1005</a>.
+   </p><p>
+       The context variable <code 
class="literal">qpid.port.open_connections_warn_percent</code> can be 
+       used to control when a warning log message is generated as the number 
of open connections
+       approaches the limit for the port. The default value of this variable 
is 
+       <code class="literal">80</code> meaning that if more the number of open 
connections to the port
+       has exceeded 80% of the given limit then the operatinal log message 
+       <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-PRT-1004">PRT-1004</a>
+       will be generated.
+   </p></div><div class="navfooter"><hr /><table summary="Navigation footer" 
width="100%"><tr><td align="left" width="40%"><a accesskey="p" 
href="Java-Broker-Runtime-Message-Compression.html">Prev</a>&#160;</td><td 
align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Memory.html">Next</a></td></tr><tr><td align="left" 
valign="top" width="40%">9.8.&#160;Message Compression&#160;</td><td 
align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td 
align="right" valign="top" 
width="40%">&#160;9.10.&#160;Memory</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Disk-Space-Management.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Disk-Space-Management.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Disk-Space-Management.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Disk-Space-Management.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.2.&#160;Disk Space Management - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.2.&#160;Disk Space Management</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.2.&#160;Disk Space Management</th></tr><tr><td align="left" 
width="20%"><a accesskey="p" 
href="Java-Broker-Runtime.html">Prev</a>&#160;</td><th align="center" 
width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Next</a></td></tr></table><hr
 /></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="Java-Broker-Runtime-Disk-Space-Management"></a>9.2.&#160;Disk Space 
Management</h2></div></div></div><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="Qpid-Producer-Flow-Control"></a>9.2.1.&#160;Producer Flow 
Control</h3></div></div></div><div class="section"><div 
class="titlepage"><div><div><h4 class="title"><a 
id="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control-GeneralInfor
 mation"></a>9.2.1.1.&#160;General Information</h4></div></div></div><p>
+            The Java Broker supports a flow control mechanism to which can be 
used to prevent either a single queue
+            or a virtualhost exceeding configured limits.  These two 
mechanisms are described
+            next.
+        </p></div><div class="section"><div class="titlepage"><div><div><h4 
class="title"><a 
id="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control-ServerConfiguration"></a>9.2.1.2.&#160;Server
 Configuration</h4></div></div></div><div class="section"><div 
class="titlepage"><div><div><h5 class="title"><a 
id="idm140683142043184"></a>Configuring a Queue to use flow 
control</h5></div></div></div><p>
+                Flow control is enabled on a producer when it sends a message 
to a Queue
+                which is "overfull". The producer flow control will be 
rescinded when all
+                Queues on which a producer is blocking become "underfull". A 
Queue is defined
+                as overfull when the size (in bytes) of the messages on the 
queue exceeds the
+                <span class="emphasis"><em>capacity</em></span> of the Queue. 
A Queue becomes "underfull" when its
+                size becomes less than the <span class="emphasis"><em>resume 
capacity</em></span>.
+            </p><p>
+                The capacity and resume capacity can be specified when the 
queue is created.  This
+                can be done using the Flow Control Settings within the Queue 
creation dialogue.
+            </p><div class="section"><div class="titlepage"><div><div><h6 
class="title"><a id="idm140683141999968"></a>Broker Log 
Messages</h6></div></div></div><p>
+                    There are four Broker log messages that may occur if flow 
control through queue capacity limits is enabled.
+                    Firstly, when a capacity limited queue becomes overfull, a 
log message similar to the following is produced
+                </p><pre class="programlisting">
+MESSAGE [vh(/test)/qu(MyQueue)] [vh(/test)/qu(MyQueue)] QUE-1003 : Overfull : 
Size : 1,200 bytes, Capacity : 1,000
+                </pre><p>Then for each channel which becomes blocked upon the 
overful queue a log message similar to the following is produced:</p><pre 
class="programlisting">
+MESSAGE [con:2(guest@anonymous(713889609)/test)/ch:1] 
[con:2(guest@anonymous(713889609)/test)/ch:1] CHN-1005 : Flow Control Enforced 
(Queue MyQueue)
+                </pre><p>When enough messages have been consumed from the 
queue that it becomes underfull, then the following log is generated: </p><pre 
class="programlisting">
+MESSAGE [vh(/test)/qu(MyQueue)] [vh(/test)/qu(MyQueue)] QUE-1004 : Underfull : 
Size : 600 bytes, Resume Capacity : 800
+                </pre><p>And for every channel which becomes unblocked you 
will see a message similar to: </p><pre class="programlisting">
+MESSAGE [con:2(guest@anonymous(713889609)/test)/ch:1] 
[con:2(guest@anonymous(713889609)/test)/ch:1] CHN-1006 : Flow Control Removed
+                </pre><p>Obviously the details of connection, virtual host, 
queue, size, capacity, etc would depend on the configuration in 
use.</p></div></div><div class="section"><div class="titlepage"><div><div><h5 
class="title"><a id="idm140683143545936"></a>Disk quota-based flow 
control</h5></div></div></div><p>
+                Flow control can also be triggered when a configured disk 
quota is exceeded. This is supported by the BDB and
+                Derby virtualhosts.
+            </p><p>
+                This functionality blocks all producers on reaching the disk 
overflow limit. When consumers
+                consume the messages, causing disk space usage to falls below 
the underflow limit, the
+                producers are unblocked and continue working as normal.
+            </p><p>
+                Two limits can be configured:
+            </p><p>
+                overfull limit - the maximum space on disk (in bytes).
+            </p><p>
+                underfull limit - when the space on disk drops below this 
limit, producers are allowed to resume publishing.
+            </p><p>
+                The overfull and underful limit can be specified when a new 
virtualhost is created or an exiting
+                virtualhost is edited.  This can be done using the Store 
Overflow and Store Underfull settings
+                within the virtual host creation and edit dialogue.  If 
editing an existing virtualhost, the virtualhost
+                must be restarted for the new values to take effect.
+            </p><p>
+                The disk quota functionality is based on "best effort" 
principle. This means the broker
+                cannot guarantee that the disk space limit will not be 
exceeded. If several concurrent
+                transactions are started before the limit is reached, which 
collectively cause the limit
+                to be exceeded, the broker may allow all of them to be 
committed.
+            </p><p>
+                The Broker will also impose flow control if the filesystem 
hosting a virtualhost
+                exceeds a <a class="link" 
href="Java-Broker-Management-Managing-Broker.html#Java-Broker-Management-Managing-Broker-Context-StoreFilesystemMaxUsagePercent">
+                    configured percentage.</a>.
+            </p><div class="section"><div class="titlepage"><div><div><h6 
class="title"><a id="idm140683145997952"></a>Broker Log Messages for quota flow 
control</h6></div></div></div><p>
+                    There are two broker log messages that may occur if flow 
control through disk quota limits is enabled.
+                    When the virtual host is blocked due to exceeding of the 
disk quota limit the following message
+                    appears in the broker log
+                    </p><pre class="programlisting">
+[vh(/test)/ms(BDBMessageStore)] MST-1008 : Store overfull, flow control will 
be enforced
+                    </pre><p>
+                    When virtual host is unblocked after cleaning the disk 
space the following message appears in the broker log
+                    </p><pre class="programlisting">
+[vh(/test)/ms(BDBMessageStore)] MST-1009 : Store overfull condition cleared
+                    </pre><p>
+                </p></div></div></div><div class="section"><div 
class="titlepage"><div><div><h4 class="title"><a 
id="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control-ClientImpact"></a>9.2.1.3.&#160;Client
 impact and configuration</h4></div></div></div><p>
+            If a producer sends to a queue which is overfull, the broker will 
respond by
+            instructing the client not to send any more messages. The impact 
of this is
+            that any future attempts to send will block until the broker 
rescinds the flow control order.
+        </p><p>
+            While blocking the client will periodically log the fact that it 
is blocked waiting on flow control.
+        </p><pre class="programlisting">
+WARN   Message send delayed by 5s due to broker enforced flow control
+WARN   Message send delayed by 10s due to broker enforced flow control
+        </pre><p>
+            After a set period the send will timeout and throw a JMSException 
to the calling code.
+        </p><p>
+            If such a JMSException is thrown, the message will not be sent to 
the broker,
+            however the underlying Session may still be active - in particular 
if the
+            Session is transactional then the current transaction will not be 
automatically
+            rolled back. Users may choose to either attempt to resend the 
message, or to
+            roll back any transactional work and close the Session.
+        </p><p>
+            Both the timeout delay and the periodicity of the warning messages 
can be set
+            using Java system properties.
+        </p><p>
+            The amount of time (in milliseconds) to wait before timing out
+            is controlled by the property qpid.flow_control_wait_failure.
+        </p><p>
+            The frequency at which the log message informing that the producer 
is flow
+            controlled is sent is controlled by the system property 
qpid.flow_control_wait_notify_period.
+        </p><p>
+            Adding the following to the command line to start the client would 
result in a timeout of one minute,
+            with warning messages every ten seconds:
+        </p><pre class="programlisting">
+-Dqpid.flow_control_wait_failure=60000
+-Dqpid.flow_control_wait_notify_period=10000
+        </pre></div></div></div><div class="navfooter"><hr /><table 
summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a 
accesskey="p" href="Java-Broker-Runtime.html">Prev</a>&#160;</td><td 
align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Next</a></td></tr><tr><td
 align="left" valign="top" 
width="40%">Chapter&#160;9.&#160;Runtime&#160;</td><td align="center" 
width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" 
valign="top" width="40%">&#160;9.3.&#160;Producer Transaction 
Timeout</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Flow-To-Disk.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Flow-To-Disk.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Flow-To-Disk.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Flow-To-Disk.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,159 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.6.&#160;Flow to Disk - Apache Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.6.&#160;Flow to Disk</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.6.&#160;Flow to Disk</th></tr><tr><td align="left" width="20%"><a 
accesskey="p" 
href="Java-Broker-Runtime-Close-Connection-When-No-Route.html">Prev</a>&#160;</td><th
 align="center" width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Background-Recovery.html">Next</a></td></tr></table><hr
 /></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a id="Java-Broker-Runtime-Flow-To-Disk"></a>9.6.&#160;Flow to 
Disk</h2></div></div></div><p>Flow to disk limits the amount of <a class="link" 
href="Java-Broker-Runtime-Memory.html" title="9.10.&#160;Memory">direct and 
heap memory</a>
+    that can be occupied by messages. Once this
+    limit is reached any new transient messages and all existing transient 
messages will be
+    transferred to disk. Newly arriving transient messages will continue to go 
to the disk until the
+    cumulative size of all messages falls below the limit once again.</p><p>By 
default the Broker makes 40% of the max direct available memory for messages. 
This memory is
+    divided between all the queues across all virtual hosts defined on the 
Broker with a percentage
+    calculated according to their current queue size. These calculations are 
refreshed periodically
+    by the housekeeping cycle.</p><p>For example if there are two queues, one 
containing 75MB and the second 100MB messages
+    respectively and the Broker has 1GB direct memory with the default of 40% 
available for messages.
+    The first queue will have a target size of 170MB and the second 230MB. 
Once 400MB is taken by
+    messages, messages will begin to flow to disk. New messages will cease to 
flow to disk when
+    their cumulative size falls beneath 400MB.</p><p>Flow to disk is 
configured by Broker context variable
+      <code class="literal">broker.flowToDiskThreshold</code>. It is expressed 
as a size in bytes and defaults
+    to 40% of the JVM maximum heap size.</p><p>Log message <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-BRK-1014">BRK-1014</a>
 is written when the feature activates. Once the total space of all messages
+    decreases below the threshold, the message <a class="link" 
href="Java-Broker-Appendix-Operation-Logging.html#Java-Broker-Appendix-Operation-Logging-Message-BRK-1015">BRK-1015</a>
 is written
+    to show that the feature is no longer active.</p></div><div 
class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td 
align="left" width="40%"><a accesskey="p" 
href="Java-Broker-Runtime-Close-Connection-When-No-Route.html">Prev</a>&#160;</td><td
 align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Background-Recovery.html">Next</a></td></tr><tr><td 
align="left" valign="top" width="40%">9.5.&#160;Closing client connections on 
unroutable mandatory messages&#160;</td><td align="center" width="20%"><a 
accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;9.7.&#160;Background Recovery</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>

Added: 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html
URL: 
http://svn.apache.org/viewvc/qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html?rev=1718924&view=auto
==============================================================================
--- 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html
 (added)
+++ 
qpid/site/docs/releases/qpid-java-6.0.0/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html
 Wed Dec  9 17:41:59 2015
@@ -0,0 +1,182 @@
+<!DOCTYPE html>
+<!--
+ -
+ - Licensed to the Apache Software Foundation (ASF) under one
+ - or more contributor license agreements.  See the NOTICE file
+ - distributed with this work for additional information
+ - regarding copyright ownership.  The ASF licenses this file
+ - to you under the Apache License, Version 2.0 (the
+ - "License"); you may not use this file except in compliance
+ - with the License.  You may obtain a copy of the License at
+ -
+ -   http://www.apache.org/licenses/LICENSE-2.0
+ -
+ - Unless required by applicable law or agreed to in writing,
+ - software distributed under the License is distributed on an
+ - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ - KIND, either express or implied.  See the License for the
+ - specific language governing permissions and limitations
+ - under the License.
+ -
+-->
+<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en">
+  <head>
+    <title>9.4.&#160;Handing Undeliverable Messages - Apache 
Qpid&#8482;</title>
+    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+    <link rel="stylesheet" href="/site.css" type="text/css" async="async"/>
+    <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/>
+    <script type="text/javascript">var _deferredFunctions = [];</script>
+    <script type="text/javascript" src="/deferred.js" defer="defer"></script>
+    <!--[if lte IE 8]>
+      <link rel="stylesheet" href="/ie.css" type="text/css"/>
+      <script type="text/javascript" src="/html5shiv.js"></script>
+    <![endif]-->
+
+    <!-- Redirects for `go get` and godoc.org -->
+    <meta name="go-import"
+          content="qpid.apache.org git 
https://github.com/alanconway/proton-go.git"/> 
+    <meta name="go-source"
+          content="qpid.apache.org
+https://github.com/alanconway/proton-go/tree/master/README.md
+https://github.com/alanconway/proton-go/tree/master{/dir}
+https://github.com/alanconway/proton-go/blob/master{/dir}/{file}#L{line}"/>
+  </head>
+  <body>
+    <div id="-content">
+      <div id="-top" class="panel">
+        <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a>
+
+        <a id="-search-link"><img width="22" height="16" src="" 
alt="Search"/></a>
+
+        <ul id="-global-navigation">
+          <li><a id="-logotype" href="/index.html">Apache 
Qpid<sup>&#8482;</sup></a></li>
+          <li><a href="/documentation.html">Documentation</a></li>
+          <li><a href="/download.html">Download</a></li>
+          <li><a href="/discussion.html">Discussion</a></li>
+        </ul>
+      </div>
+
+      <div id="-menu" class="panel" style="display: none;">
+        <div class="flex">
+          <section>
+            <h3>Project</h3>
+
+            <ul>
+              <li><a href="/overview.html">Overview</a></li>
+              <li><a href="/components/index.html">Components</a></li>
+              <li><a href="/releases/index.html">Releases</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Messaging APIs</h3>
+
+            <ul>
+              <li><a href="/proton/index.html">Qpid Proton</a></li>
+              <li><a href="/components/jms/index.html">Qpid JMS</a></li>
+              <li><a href="/components/messaging-api/index.html">Qpid 
Messaging API</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Servers and tools</h3>
+
+            <ul>
+              <li><a href="/components/java-broker/index.html">Java 
broker</a></li>
+              <li><a href="/components/cpp-broker/index.html">C++ 
broker</a></li>
+              <li><a href="/components/dispatch-router/index.html">Dispatch 
router</a></li>
+            </ul>
+          </section>
+
+          <section>
+            <h3>Resources</h3>
+
+            <ul>
+              <li><a href="/dashboard.html">Dashboard</a></li>
+              <li><a 
href="https://cwiki.apache.org/confluence/display/qpid/Index";>Wiki</a></li>
+              <li><a href="/resources.html">More resources</a></li>
+            </ul>
+          </section>
+        </div>
+      </div>
+
+      <div id="-search" class="panel" style="display: none;">
+        <form action="http://www.google.com/search"; method="get">
+          <input type="hidden" name="sitesearch" value="qpid.apache.org"/>
+          <input type="text" name="q" maxlength="255" autofocus="autofocus" 
tabindex="1"/>
+          <button type="submit">Search</button>
+          <a href="/search.html">More ways to search</a>
+        </form>
+      </div>
+
+      <div id="-middle" class="panel">
+        <ul id="-path-navigation"><li><a 
href="/index.html">Home</a></li><li><a 
href="/releases/index.html">Releases</a></li><li><a 
href="/releases/qpid-java-6.0.0/index.html">Qpid Java 6.0.0</a></li><li><a 
href="/releases/qpid-java-6.0.0/java-broker/book/index.html">AMQP Messaging 
Broker (Java)</a></li><li>9.4.&#160;Handing Undeliverable Messages</li></ul>
+
+        <div id="-middle-content">
+          <div class="docbook"><div class="navheader"><table 
summary="Navigation header" width="100%"><tr><th align="center" 
colspan="3">9.4.&#160;Handing Undeliverable Messages</th></tr><tr><td 
align="left" width="20%"><a accesskey="p" 
href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Prev</a>&#160;</td><th
 align="center" width="60%">Chapter&#160;9.&#160;Runtime</th><td align="right" 
width="20%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Close-Connection-When-No-Route.html">Next</a></td></tr></table><hr
 /></div><div class="section"><div class="titlepage"><div><div><h2 
class="title"><a 
id="Java-Broker-Runtime-Handling-Undeliverable-Messages"></a>9.4.&#160;Handing 
Undeliverable Messages</h2></div></div></div><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction"></a>9.4.1.&#160;Introduction</h3></div></div></div><p>
 Messages that cannot be delivered successfully to a consumer (f
 or instance, because the
+   client is using a transacted session and rolls-back the transaction) can be 
made available on
+   the queue again and then subsequently be redelivered, depending on the 
precise session
+   acknowledgement mode and messaging model used by the application. This is 
normally desirable
+   behaviour that contributes to the ability of a system to withstand 
unexpected errors. However, it
+   leaves open the possibility for a message to be repeatedly redelivered 
(potentially indefinitely),
+   consuming system resources and preventing the delivery of other messages. 
Such undeliverable
+   messages are sometimes known as poison messages.</p><p>For an example, 
consider a stock ticker application that has been designed to consume prices
+   contained within JMS TextMessages. What if inadvertently a BytesMessage is 
placed onto the queue?
+   As the ticker application does not expect the BytesMessage, its processing 
might fail and cause it
+   to roll-back the transaction, however the default behavior of the Broker 
would mean that the
+   BytesMessage would be delivered over and over again, preventing the 
delivery of other legitimate
+   messages, until an operator intervenes and removes the erroneous message 
from the queue. </p><p>Qpid has maximum delivery count and dead-letter queue 
(DLQ) features which can be used in
+   concert to construct a system that automatically handles such a condition. 
These features are
+   described in the following sections.</p></div><div class="section"><div 
class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count"></a>9.4.2.&#160;Maximum
 Delivery Count</h3></div></div></div><p> Maximum delivery count is a property 
of a queue. If a consumer application is unable to
+   process a message more than the specified number of times, then the broker 
will either route the
+   message to a dead-letter queue (if one has been defined), or will discard 
the message. </p><p> In order for a maximum delivery count to be enforced, the 
consuming client
+    <span class="emphasis"><em>must</em></span> call <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/Session.html#rollback()" 
target="_top">Session#rollback()</a> (or <a class="ulink" 
href="http://docs.oracle.com/javaee/6/api/javax/jms/Session.html#recover()" 
target="_top">Session#recover()</a> if the session is not transacted). It is 
during the Broker's
+   processing of Session#rollback() (or Session#recover()) that if a message 
has been seen
+   at least the maximum number of times then it will move the message to the 
DLQ or discard the
+   message.</p><p>If the consuming client fails in another manner, for 
instance, closes the connection, the
+   message will not be re-routed and consumer application will see the same 
poison message again
+   once it reconnects.</p><p> If the consuming application is using AMQP 
0-9-1, 0-9, or 0-8 protocols, it is necessary to
+   set the client system property <code 
class="varname">qpid.reject.behaviour</code> or connection or binding
+   URL option <code class="varname">rejectbehaviour</code> to the value <code 
class="literal">server</code>.</p><p>It is possible to determine the number of 
times a message has been sent to a consumer via
+   the Management interfaces, but is not possible to determine this 
information from a message client.
+   Specifically, the optional JMS message header <span 
class="property">JMSXDeliveryCount</span> is not
+   supported.</p><p>Maximum Delivery Count can be specified when a new queue 
is created or using the the
+   queue declare property <span 
class="property">x-qpid-maximum-delivery-count</span></p></div><div 
class="section"><div class="titlepage"><div><div><h3 class="title"><a 
id="Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues"></a>9.4.3.&#160;Dead
 Letter Queues (DLQ)</h3></div></div></div><p>A Dead Letter Queue (DLQ) acts as 
an destination for messages that have somehow exceeded the
+   normal bounds of processing and is utilised to prevent disruption to flow 
of other messages. When
+   a DLQ is enabled for a given queue if a consuming client indicates it no 
longer wishes the
+   receive the message (typically by exceeding a Maximum Delivery Count) then 
the message is moved
+   onto the DLQ and removed from the original queue. </p><p>The DLQ feature 
causes generation of a Dead Letter Exchange and a Dead Letter Queue. These
+   are named convention QueueName<span class="emphasis"><em>_DLE</em></span> 
and QueueName<span class="emphasis"><em>_DLQ</em></span>.</p><p>DLQs can be 
enabled when a new queue is created
+   or using the queue declare property <span 
class="property">x-qpid-dlq-enabled</span>.</p><div class="caution" 
style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Avoid 
excessive queue depth</h3><p>Applications making use of DLQs <span 
class="emphasis"><em>should</em></span> make provision for the frequent
+    examination of messages arriving on DLQs so that both corrective actions 
can be taken to resolve
+    the underlying cause and organise for their timely removal from the DLQ. 
Messages on DLQs
+    consume system resources in the same manner as messages on normal queues 
so excessive queue
+    depths should not be permitted to develop.</p></div></div></div><div 
class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td 
align="left" width="40%"><a accesskey="p" 
href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Prev</a>&#160;</td><td
 align="center" width="20%"><a accesskey="u" 
href="Java-Broker-Runtime.html">Up</a></td><td align="right" 
width="40%">&#160;<a accesskey="n" 
href="Java-Broker-Runtime-Close-Connection-When-No-Route.html">Next</a></td></tr><tr><td
 align="left" valign="top" width="40%">9.3.&#160;Producer Transaction 
Timeout&#160;</td><td align="center" width="20%"><a accesskey="h" 
href="index.html">Home</a></td><td align="right" valign="top" 
width="40%">&#160;9.5.&#160;Closing client connections on unroutable mandatory 
messages</td></tr></table></div></div>
+
+          <hr/>
+
+          <ul id="-apache-navigation">
+            <li><a href="http://www.apache.org/";>Apache</a></li>
+            <li><a href="http://www.apache.org/licenses/";>License</a></li>
+            <li><a 
href="http://www.apache.org/foundation/sponsorship.html";>Sponsorship</a></li>
+            <li><a 
href="http://www.apache.org/foundation/thanks.html";>Thanks!</a></li>
+            <li><a href="http://www.apache.org/security/";>Security</a></li>
+            <li><a href="http://www.apache.org/";><img id="-apache-feather" 
width="48" height="14" src="" alt="Apache"/></a></li>
+          </ul>
+
+          <p id="-legal">
+            Apache Qpid, Messaging built on AMQP; Copyright &#169; 2015
+            The Apache Software Foundation; Licensed under
+            the <a href="http://www.apache.org/licenses/LICENSE-2.0";>Apache
+            License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton,
+            Proton, Apache, the Apache feather logo, and the Apache Qpid
+            project logo are trademarks of The Apache Software
+            Foundation; All other marks mentioned may be trademarks or
+            registered trademarks of their respective owners
+          </p>
+        </div>
+      </div>
+    </div>
+  </body>
+</html>



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to