You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by kw...@apache.org on 2013/10/09 00:56:29 UTC

svn commit: r1530457 [10/30] - in /qpid/site: docs/components/java-broker/book/ docs/components/java-broker/book/images/ input/components/java-broker/book/ input/components/java-broker/book/images/

Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Handling-Undeliverable-Messages.html Tue Oct  8 22:56:26 2013
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>11.5. Handing Undeliverable Messages</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Runtime.html" title="Chapter 11. Runtime"><link rel="prev" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="11.4. Producer Transaction Timeout"><link rel="next" href="Java-Broker-High-Availability.html" title="Chapter 12. High Availability"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache
 .org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A
  href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="h
 ttp://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Runtime.html">Runtime</a></span> &gt; <span class="breadcrumb-node">Handing Undeliverable Messages</span></DIV><div class="section" title="11.5. Handing Undeliverable Messages"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages"></a>11.5. Handing Undeliverable Messages</h2></div></div></div><div class="section" title="11.5.1. Introduction"><div c
 lass="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction"></a>11.5.1. Introduction</h3></div></div></div><p> Messages that cannot be delivered successfully to a consumer (for instance, because the
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>12.5. Handing Undeliverable Messages</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Runtime.html" title="Chapter 12. Runtime"><link rel="prev" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html" title="12.4. Producer Transaction Timeout"><link rel="next" href="Java-Broker-Close-Connection-When-No-Route.html" title="12.6. Closing client connections on unroutable mandatory messages"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apach
 e Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_rep
 ository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box
 _body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Runtime.html">Runtime</a></span> &gt; <span class="breadcrumb-node">Handing Undeliverable Messages</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages"></a>12.5. Handing Undeliverable Messages</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 cla
 ss="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction"></a>12.5.1. Introduction</h3></div></div></div><p> Messages that cannot be delivered successfully to a consumer (for 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
@@ -12,7 +12,7 @@
    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" title="11.5.2. Maximum Delivery Count"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count"></a>11.5.2. Maximum Delivery Count</h3></div></div></div><p> Maximum delivery count is a property of a queue. If a consumer application is unable to
+   described in the following sections.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count"></a>12.5.2. 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
@@ -25,66 +25,19 @@
    URL option <code class="varname">rejectbehaviour</code> to the value <code class="literal">system</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 enabled via management (see <a class="xref" href="Java-Broker-Configuring-And-Managing.html" title="Chapter 9. Configuring And Managing">Chapter 9, <i>Configuring And Managing</i></a>) using the the queue declare property
-    <span class="property">x-qpid-maximum-delivery-count</span> or via <a class="link" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration" title="11.5.4. Configuration">configuration</a>
-   as illustrated below.</p></div><div class="section" title="11.5.3. Dead Letter Queues (DLQ)"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues"></a>11.5.3. 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
+   supported.</p><p>Maximum Delivery Count can be enabled via management (see <a class="xref" href="Java-Broker-Configuring-And-Managing.html" title="Chapter 5. Configuring And Managing">Chapter 5, <i>Configuring And Managing</i></a>) using the the queue declare property
+    <span class="property">x-qpid-maximum-delivery-count</span> or via <a class="link" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration" title="12.5.4. Configuration">configuration</a>
+   as illustrated below.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues"></a>12.5.3. 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 via management (see <a class="xref" href="Java-Broker-Configuring-And-Managing.html" title="Chapter 9. Configuring And Managing">Chapter 9, <i>Configuring And Managing</i></a>) using the queue declare property <span class="property">x-qpid-dlq-enabled</span> or via <a class="link" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration" title="11.5.4. Configuration">configuration</a>
-   as illustrated below.</p><div class="caution" title="Avoid excessive queue depth" 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
+   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 via management (see <a class="xref" href="Java-Broker-Configuring-And-Managing.html" title="Chapter 5. Configuring And Managing">Chapter 5, <i>Configuring And Managing</i></a>) using the queue declare property <span class="property">x-qpid-dlq-enabled</span> or via <a class="link" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration" title="12.5.4. Configuration">configuration</a>
+   as illustrated below.</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 class="section" title="11.5.4. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration"></a>11.5.4. Configuration</h3></div></div></div><p>In the below configuration it can be seen that DLQs/Maximum Delivery Count are enabled at
-   the broker level with maximum delivery count set to 5, disabled at the virtualhost level for the
-   'dev-only' virtualhost, and enabled specifically for the 'dev-only-main-queue' with maximum
-   delivery count overridden to 5. </p><p>As 'dev-only-main-queue' has its own configuration specified, this value overrides all
-   others and causes the features to be enabled for this queue. In contrast to this,
-   'dev-only-other-queue' does not specify its own value and picks up the false value specified for
-   its parent virtualhost, causing the DLQ/Maximum Delivery Count features to be disabled for this
-   queue. Any such queue in the 'dev-only' virtualhost which does not specify its own configuration
-   value will have the DLQ/Maximum Delivery Count feature disabled.</p><p>The queue 'localhost-queue' has the DLQ/Maximum Delivery Count features enabled, as neither
-   the queue itself or the 'localhost' virtualhost specifies a configuration value and so the broker
-   level value of true is used. Any such queue in the 'localhost' virtualhost which does not specify
-   its own configuration value will have the features enabled.</p><div class="example"><a name="idp989712"></a><p class="title"><b>Example 11.5. Enabling DLQs and maximum delivery count at broker level within config.xml</b></p><div class="example-contents"><pre class="programlisting">&lt;broker&gt;
- ...
- &lt;deadLetterQueues&gt;true&lt;/deadLetterQueues&gt;
- &lt;maximumDeliveryCount&gt;5&lt;/maximumDeliveryCount&gt;
- ...
-&lt;/broker&gt;</pre></div></div><br class="example-break"><div class="example"><a name="idp991120"></a><p class="title"><b>Example 11.6. Enabling DLQs and maximum delivery count at virtualhost and queue level within
-    virtualhosts.xml</b></p><div class="example-contents"><pre class="programlisting">&lt;virtualhosts&gt;
- ...
- &lt;virtualhost&gt;
-  &lt;name&gt;dev-only&lt;/name&gt;
-  &lt;dev-only&gt;
-   &lt;queues&gt;
-    &lt;deadLetterQueues&gt;false&lt;/deadLetterQueues&gt;
-    &lt;maximumDeliveryCount&gt;0&lt;/maximumDeliveryCount&gt;
-    &lt;queue&gt;
-     &lt;name&gt;dev-only-main-queue&lt;/name&gt;
-     &lt;dev-only-main-queue&gt;
-      &lt;deadLetterQueues&gt;true&lt;/deadLetterQueues&gt;
-      &lt;maximumDeliveryCount&gt;3&lt;/maximumDeliveryCount&gt;
-     &lt;/dev-only-main-queue&gt;
-    &lt;/queue&gt;
-    &lt;queue&gt;
-     &lt;name&gt;dev-only-other-queue&lt;/name&gt;
-    &lt;/queue&gt;
-   &lt;/queues&gt;
-  &lt;/dev-only&gt;
- &lt;/virtualhost&gt;
- &lt;virtualhost&gt;
-  &lt;name&gt;localhost&lt;/name&gt;
-  &lt;localhost&gt;
-   &lt;queues&gt;
-    &lt;queue&gt;
-     &lt;name&gt;localhost-queue&lt;/name&gt;
-    &lt;/queue&gt;
-   &lt;/queues&gt;
-  &lt;/localhost&gt;
- &lt;/virtualhost&gt;
- ...
-&lt;/virtualhosts&gt;
-   </pre></div></div><br class="example-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Runtime.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-High-Availability.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.4. Producer Transaction Timeout </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 12. High Availability</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+    depths should not be permitted to develop.</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration"></a>12.5.4. Configuration</h3></div></div></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3>DLQs/Maximum Delivery can be configured globally for all Virtual Hosts by
+  specifying non-zero value for global Broker attribute
+  "queue.maximumDeliveryAttempts" and setting of Broker attribute "queue.deadLetterQueueEnabled" to true.</div><p>An examples of configuring DLQs/Maximum Delivery Count using Virtual Hosts configuration file
+   are described in <a class="xref" href="Java-Broker-Virtual-Host-Configuring-DLQ.html" title="14.14. Configuring DLQs/Maximum Delivery Count">Section 14.14, “Configuring DLQs/Maximum Delivery Count”</a>.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Runtime.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Close-Connection-When-No-Route.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">12.4. Producer Transaction Timeout </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 12.6. Closing client connections on unroutable mandatory messages</td></tr></table></div><div class="main_text_area
 _bottom"></div></div></div></body></html>

Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Producer-Transaction-Timeout.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Producer-Transaction-Timeout.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Producer-Transaction-Timeout.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Runtime-Producer-Transaction-Timeout.html Tue Oct  8 22:56:26 2013
@@ -1,19 +1,19 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>11.4. Producer Transaction Timeout</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Runtime.html" title="Chapter 11. Runtime"><link rel="prev" href="Java-Broker-Runtime-Disk-Space-Management.html" title="11.3. Disk Space Management"><link rel="next" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html" title="11.5. Handing Undeliverable Messages"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://q
 pid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A><
 /LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI>
 <A href="http://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Runtime.html">Runtime</a></span> &gt; <span class="breadcrumb-node">Producer Transaction Timeout</span></DIV><div class="section" title="11.4. Producer Transaction Timeout"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout"></a>11.4. Producer Transaction Timeout</h2></div></div></div><div class="section" title="11.4.1. General Information
 "><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-GeneralInformation"></a>11.4.1. General Information</h3></div></div></div><p> The transaction timeout mechanism is used to control broker resources when clients
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>12.4. Producer Transaction Timeout</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="Java-Broker-Runtime.html" title="Chapter 12. Runtime"><link rel="prev" href="Java-Broker-Runtime-Disk-Space-Management.html" title="12.3. Disk Space Management"><link rel="next" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html" title="12.5. Handing Undeliverable Messages"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://q
 pid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A><
 /LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwiki.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI>
 <A href="http://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-link"><a href="Java-Broker-Runtime.html">Runtime</a></span> &gt; <span class="breadcrumb-node">Producer Transaction Timeout</span></DIV><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout"></a>12.4. Producer Transaction Timeout</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Pro
 ducer-Transaction-Timeout-GeneralInformation"></a>12.4.1. General Information</h3></div></div></div><p> The transaction timeout mechanism is used to control broker resources when clients
    producing messages using transactional sessions hang or otherwise become unresponsive, or simply
    begin a transaction and keep using it without ever calling <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Session.html#commit" target="_top">Session#commit()</a>.</p><p>Users can choose to configure an idleWarn or openWarn threshold, after which the identified
    transaction should be logged as a WARN level alert as well as (more importantly) an idleClose or
    openClose threshold after which the transaction and the connection it applies to will be
    closed.</p><p>This feature is particularly useful in environments where the owner of the broker does not
    have full control over the implementation of clients, such as in a shared services
-   deployment.</p><p>The following section provide more details on this feature and its use.</p></div><div class="section" title="11.4.2. Purpose"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Purpose"></a>11.4.2. Purpose</h3></div></div></div><p> This feature has been introduced to address the scenario where an open transaction on the
+   deployment.</p><p>The following section provide more details on this feature and its use.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Purpose"></a>12.4.2. Purpose</h3></div></div></div><p> This feature has been introduced to address the scenario where an open transaction on the
    broker holds an open transaction on the persistent store. This can have undesirable consequences
-   if the store does not time out or close long-running transactions, such as with <a class="link" href="Java-Broker-Stores-BDB-Store.html" title="8.4. BDB Store">BDB</a>. This can can result in a rapid increase in
-   disk usage size, bounded only by available space, due to growth of the transaction log. </p></div><div class="section" title="11.4.3. Scope"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Scope"></a>11.4.3. Scope</h3></div></div></div><p>Note that only <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/MessageProducer.html" target="_top">MessageProducer</a> clients will be affected by a transaction timeout, since store
+   if the store does not time out or close long-running transactions, such as with <a class="link" href="Java-Broker-Stores-BDB-Store.html" title="10.4. BDB Message Store">BDB</a>. This can can result in a rapid increase in
+   disk usage size, bounded only by available space, due to growth of the transaction log. </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Scope"></a>12.4.3. Scope</h3></div></div></div><p>Note that only <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/MessageProducer.html" target="_top">MessageProducer</a> clients will be affected by a transaction timeout, since store
    transaction lifespan on a consumer only spans the execution of the call to Session#commit() and
    there is no scope for a long-lived transaction to arise.</p><p>It is also important to note that the transaction timeout mechanism is purely a JMS
    transaction timeout, and unrelated to any other timeouts in the Qpid client library and will have
-   no impact on any RDBMS your application may utilise.</p></div><div class="section" title="11.4.4. Effect"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect"></a>11.4.4. Effect</h3></div></div></div><p>Full details of configuration options are provided in the sections that follow. This section
-   gives a brief overview of what the Transaction Timeout feature can do.</p><div class="section" title="11.4.4.1. Broker Logging and Connection Close"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect-Broker-Side"></a>11.4.4.1. Broker Logging and Connection Close</h4></div></div></div><p>When the openWarn or idleWarn specified threshold is exceeded, the broker will log a WARN
+   no impact on any RDBMS your application may utilise.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect"></a>12.4.4. Effect</h3></div></div></div><p>Full details of configuration options are provided in the sections that follow. This section
+   gives a brief overview of what the Transaction Timeout feature can do.</p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect-Broker-Side"></a>12.4.4.1. Broker Logging and Connection Close</h4></div></div></div><p>When the openWarn or idleWarn specified threshold is exceeded, the broker will log a WARN
     level alert with details of the connection and channel on which the threshold has been exceeded,
     along with the age of the transaction.</p><p>When the openClose or idleClose specified threshold value is exceeded, the broker will
     throw an exception back to the client connection via the <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/ExceptionListener.html" target="_top">ExceptionListener</a>, log the
@@ -29,7 +29,7 @@ CHN-1007 : Open Transaction : 12,406 ms
 CHN-1007 : Open Transaction : 13,406 ms
 CHN-1007 : Open Transaction : 14,406 ms
 CHN-1003 : Close
-   </pre></div><div class="section" title="11.4.4.2. Client Side Effect"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect-Client-Side"></a>11.4.4.2. Client Side Effect</h4></div></div></div><p>After a Close threshold has been exceeded, the trigger client will receive this exception
+   </pre></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Effect-Client-Side"></a>12.4.4.2. Client Side Effect</h4></div></div></div><p>After a Close threshold has been exceeded, the trigger client will receive this exception
     on its <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/ExceptionListener.html" target="_top">exception
     listener</a>, prior to being disconnected:</p><code class="computeroutput">org.apache.qpid.AMQConnectionClosedException: Error: Idle transaction timed out
     [error code 506: resource error]</code><p>Any later attempt to use the connection will result in this exception being thrown:</p><pre class="screen">Producer: Caught an Exception: javax.jms.IllegalStateException: Object org.apache.qpid.client.AMQSession_0_8@129b0e1 has been closed
@@ -39,7 +39,7 @@ CHN-1003 : Close
     at org.apache.qpid.client.AMQSession.createBytesMessage(AMQSession.java:573)
    </pre><p>Thus clients must be able to handle this case successfully, reconnecting where required and
     registering an exception listener on all connections. This is critical, and must be communicated
-    to client applications by any broker owner switching on transaction timeouts.</p></div></div><div class="section" title="11.4.5. Configuration"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration"></a>11.4.5. Configuration</h3></div></div></div><div class="section" title="11.4.5.1. Configuration"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration-Overview"></a>11.4.5.1. Configuration</h4></div></div></div><p>Transaction timeouts are configurable separately on each defined virtual host, using the
+    to client applications by any broker owner switching on transaction timeouts.</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration"></a>12.4.5. Configuration</h3></div></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration-Overview"></a>12.4.5.1. Configuration</h4></div></div></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3>Transaction timeouts can be configured globally for all virtual hosts by setting corresponding Broker transaction timeout attributes.</div><p>Transaction timeouts can be configured separately on each defined virtual host, using the
     virtualhosts.xml file.</p><p>We would recommend that only warnings are configured at first, which should allow broker
     administrators to obtain an idea of the distribution of transaction lengths on their systems,
     and configure production settings appropriately for both warning and closure. Ideally
@@ -53,22 +53,5 @@ CHN-1003 : Close
     Session and Connection. Clients that use the JMS API directly should be aware that sessions
     managing both consumers and producers, or multiple producers, will be affected by a single
     producer hanging or leaving a transaction idle or open, and closed, and must take appropriate
-    action to handle that scenario.</p></div><div class="section" title="11.4.5.2. Virtualhosts.xml"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration-Virtualhosts"></a>11.4.5.2. Virtualhosts.xml</h4></div></div></div><p> The JMS transaction timeouts are configured on each virtual host defined in the XML
-    configuration files.</p><p> The default values for each of the parameters is 0, indicating that the particular check
-    is disabled.</p><p> Any or all of the parameters can be set, using the desired value in milliseconds, and will
-    be checked each time the housekeeping process runs, usually set to run every 30 seconds in
-    standard configuration. The meaning of each property is as follows:</p><p>
-    </p><div class="itemizedlist"><ul class="itemizedlist"><li class="listitem"><p>openWarn - the time a transaction can be open for (with activity occurring on it) after
-       which a warning alert will be issued.</p></li><li class="listitem"><p>openClose - the time a transaction can be open for before the connection it is on is
-       closed.</p></li><li class="listitem"><p>idleWarn - the time a transaction can be idle for (with no activity occurring on it)
-       after which a warning alert will be issued.</p></li><li class="listitem"><p>idleClose - the time a transaction can be idle for before the connection it is on is
-       closed.</p></li></ul></div><p>
-   </p><p> The virtualhosts configuration is shown below, and must occur inside the
-   //virtualhosts/virtualhost/name/ elements: </p><div class="example"><a name="idp780048"></a><p class="title"><b>Example 11.4. Configuring producer transaction timeout</b></p><div class="example-contents"><pre class="programlisting">
-&lt;transactionTimeout&gt;
-    &lt;openWarn&gt;10000&lt;/openWarn&gt;
-    &lt;openClose&gt;20000&lt;/openClose&gt;
-    &lt;idleWarn&gt;5000&lt;/idleWarn&gt;
-    &lt;idleClose&gt;15000&lt;/idleClose&gt;
-&lt;/transactionTimeout&gt;
-   </pre></div></div><br class="example-break"></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Runtime-Disk-Space-Management.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Runtime.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.3. Disk Space Management </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 11.5. Handing Undeliverable Messages</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+    action to handle that scenario.</p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration-Virtualhosts"></a>12.4.5.2. Virtualhost configuration</h4></div></div></div><p>The details how to configure Transaction Timeouts in Virtual Host configuration file
+   are provided in <a class="xref" href="Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html" title="14.13. Configuring Transaction Timeouts">Section 14.13, “Configuring Transaction Timeouts”</a></p></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Runtime-Disk-Space-Management.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Java-Broker-Runtime.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">12.3. Disk Space Management </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 12.5. Handing Undeliverable Messages</td></tr></table></div><div class="main_text_area_bottom"></div></div></div><
 /body></html>

Modified: qpid/site/docs/components/java-broker/book/Java-Broker-Runtime.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/components/java-broker/book/Java-Broker-Runtime.html?rev=1530457&r1=1530456&r2=1530457&view=diff
==============================================================================
--- qpid/site/docs/components/java-broker/book/Java-Broker-Runtime.html (original)
+++ qpid/site/docs/components/java-broker/book/Java-Broker-Runtime.html Tue Oct  8 22:56:26 2013
@@ -1 +1 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 11. Runtime</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Security-SSL.html" title="10.5. SSL"><link rel="next" href="Java-Broker-Runtime-Alerts.html" title="11.2. Alerts"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI
 ><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwik
 i.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-node">Runtime</span></DIV><div class="chapter" title="Chapter 11. Runtime"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime"></a>Chapter 11. Runtime</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-Broker-Runtime.html#Java-Broker-Runtime-Log-Files">11.1. Log Files</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Alerts.html">11.2. Alerts</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Dis
 k-Space-Management.html">11.3. Disk Space Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control">11.3.1. Producer Flow Control</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">11.4. Producer Transaction Timeout</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-GeneralInformation">11.4.1. General Information</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Purpose">11.4.2. Purpose</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Scope">11.4.3. Scope</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-
 Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Effect">11.4.4. Effect</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration">11.4.5. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">11.5. Handing Undeliverable Messages</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction">11.5.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count">11.5.2. Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Han
 dling-Undeliverable-Messages-Dead-Letter-Queues">11.5.3. Dead Letter Queues (DLQ)</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration">11.5.4. Configuration</a></span></dt></dl></dd></dl></div><div class="section" title="11.1. Log Files"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Log-Files"></a>11.1. Log Files</h2></div></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Security-SSL.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Runtime-Alerts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">10.5. SSL </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td widt
 h="40%" align="right" valign="top"> 11.2. Alerts</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 12. Runtime</title><link rel="stylesheet" type="text/css" href="css/style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Java)"><link rel="prev" href="Java-Broker-Security-SSL.html" title="11.4. SSL"><link rel="next" href="Java-Broker-Runtime-Alerts.html" title="12.2. Alerts"></head><body><div class="container" bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><DIV class="header"><DIV class="logo"><H1>Apache Qpid™</H1><H2>Open Source AMQP Messaging</H2></DIV></DIV><DIV class="menu_box"><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Apache Qpid</H3><UL><LI><A href="http://qpid.apache.org/index.html">Home</A></LI><LI><A href="http://qpid.apache.org/download.html">Download</A></LI
 ><LI><A href="http://qpid.apache.org/getting_started.html">Getting Started</A></LI><LI><A href="http://www.apache.org/licenses/">License</A></LI><LI><A href="https://cwiki.apache.org/qpid/faq.html">FAQ</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Documentation</H3><UL><LI><A href="http://qpid.apache.org/documentation.html#doc-release">Latest Release</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-trunk">Trunk</A></LI><LI><A href="http://qpid.apache.org/documentation.html#doc-archives">Archive</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Community</H3><UL><LI><A href="http://qpid.apache.org/getting_involved.html">Getting Involved</A></LI><LI><A href="http://qpid.apache.org/source_repository.html">Source Repository</A></LI><LI><A href="http://qpid.apache.org/mailing_lists.html">Mailing Lists</A></LI><LI><A href="https://cwik
 i.apache.org/qpid/">Wiki</A></LI><LI><A href="https://issues.apache.org/jira/browse/qpid">Issue Reporting</A></LI><LI><A href="http://qpid.apache.org/people.html">People</A></LI><LI><A href="http://qpid.apache.org/acknowledgements.html">Acknowledgements</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>Developers</H3><UL><LI><A href="https://cwiki.apache.org/qpid/building.html">Building Qpid</A></LI><LI><A href="https://cwiki.apache.org/qpid/developer-pages.html">Developer Pages</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About AMQP</H3><UL><LI><A href="http://qpid.apache.org/amqp.html">What is AMQP?</A></LI></UL></DIV><DIV class="menu_box_bottom"></DIV><DIV class="menu_box_top"></DIV><DIV class="menu_box_body"><H3>About Apache</H3><UL><LI><A href="http://www.apache.org">Home</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></UL></DIV><DIV class="menu_box_bottom"></DIV></DIV><div class="main_text_area"><div class="main_text_area_top"></div><div class="main_text_area_body"><DIV class="breadcrumbs"><span class="breadcrumb-link"><a href="index.html">AMQP Messaging Broker (Java)</a></span> &gt; <span class="breadcrumb-node">Runtime</span></DIV><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="Java-Broker-Runtime"></a>Chapter 12. Runtime</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="Java-Broker-Runtime.html#Java-Broker-Runtime-Log-Files">12.1. Log Files</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Alerts.html">12.2. Alerts</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Disk-Space-Management.htm
 l">12.3. Disk Space Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Producer-Flow-Control">12.3.1. Producer Flow Control</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">12.4. Producer Transaction Timeout</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-GeneralInformation">12.4.1. General Information</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Purpose">12.4.2. Purpose</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Scope">12.4.3. Scope</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-T
 imeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Effect">12.4.4. Effect</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration">12.4.5. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">12.5. Handing Undeliverable Messages</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction">12.5.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count">12.5.2. Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Me
 ssages-Dead-Letter-Queues">12.5.3. Dead Letter Queues (DLQ)</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration">12.5.4. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html">12.6. Closing client connections on unroutable mandatory messages</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html#Java-Broker-Close-Connection-When-No-Route-Summary">12.6.1. Summary</a></span></dt><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html#Java-Broker-Close-Connection-When-No-Route-Configuration">12.6.2. Configuring <span class="emphasis"><em>closeWhenNoRoute</em></span></a></span></dt></dl></dd></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Runtime-Log-Files"></a>12.1.�
 �Log Files</h2></div></div></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Java-Broker-Security-SSL.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-Broker-Runtime-Alerts.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">11.4. SSL </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 12.2. Alerts</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@qpid.apache.org
For additional commands, e-mail: commits-help@qpid.apache.org