You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@qpid.apache.org by ro...@apache.org on 2012/09/02 00:32:52 UTC
svn commit: r1379885 [18/27] - in /qpid/site/docs: ./
books/0.18/AMQP-Messaging-Broker-CPP-Book/html/
books/0.18/AMQP-Messaging-Broker-CPP-Book/pdf/
books/0.18/AMQP-Messaging-Broker-Java-Book/html/
books/0.18/AMQP-Messaging-Broker-Java-Book/pdf/ books/...
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Debug-Logging.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Debug-Logging.html?rev=1379885&r1=1379884&r2=1379885&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Debug-Logging.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Debug-Logging.html Sat Sep 1 22:32:47 2012
@@ -1,8 +1,8 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.7. Debug using log4j</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="Qpid-Java-Broker-Virtualhosts-Config.html" title="2.6. Configure the Virtual Hosts via virtualhosts.xml"><link rel="next" href="How-to-Tune-M3-Java-Broker-Performance.html" title="2.8. How to Tune M3 Java Broker Performance"></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 Q
pid</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">0.14 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 clas
s="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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.8. Debug using log4j</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="ch02s07.html" title="2.7. Configuring Authentication Mechanisms"><link rel="next" href="How-to-Tune-M3-Java-Broker-Performance.html" title="2.9. How to Tune M3 Java Broker Performance"></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.apac
he.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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">
Debug using log4j
- </span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Debug-Logging"></a>2.7.Â
+ </span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Debug-Logging"></a>2.8.Â
Debug using log4j
- </h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="Debugusinglog4j-Debuggingwithlog4jconfigurations"></a>2.7.1.Â
+ </h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="Debugusinglog4j-Debuggingwithlog4jconfigurations"></a>2.8.1.Â
Debugging
with log4j configurations
</h3></div></div></div><p>
@@ -28,7 +28,7 @@
oversight. Hopefully in future releases the latter will be
addressed but care needs to be taken when adding logging to the
'Message Flow' path as this will have performance implications.
- </p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Debugusinglog4j-LoggingConnectionState-5CDeprecated-5C"></a>2.7.1.1.Â
+ </p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Debugusinglog4j-LoggingConnectionState-5CDeprecated-5C"></a>2.8.1.1.Â
Logging
Connection State *Deprecated*
</h4></div></div></div><p>
@@ -131,7 +131,7 @@
</log4j:configuration>
-</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Debugusinglog4j-DebuggingMyApplication"></a>2.7.1.2.Â
+</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="Debugusinglog4j-DebuggingMyApplication"></a>2.8.1.2.Â
Debugging My
Application
</h4></div></div></div><p>
@@ -244,8 +244,6 @@
</log4j:configuration>
-</pre></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Qpid-Java-Broker-Virtualhosts-Config.html">Prev</a>Â </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right">Â <a accesskey="n" href="How-to-Tune-M3-Java-Broker-Performance.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.6.Â
- Configure the Virtual Hosts via virtualhosts.xml
- Â </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">Â 2.8.Â
+</pre></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s07.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="How-to-Tune-M3-Java-Broker-Performance.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.7. Configuring Authentication Mechanisms </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.9.Â
How to Tune M3 Java Broker Performance
</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Slow-Consumer-Disconnect.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Slow-Consumer-Disconnect.html?rev=1379885&r1=1379884&r2=1379885&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Slow-Consumer-Disconnect.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Broker-Slow-Consumer-Disconnect.html Sat Sep 1 22:32:47 2012
@@ -1,16 +1,16 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.11. Slow Consumer Disconnect - User Guide</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="OtherQueueTypes.html" title="2.10. Other Queue Types"><link rel="next" href="Qpid-JMX-Management-Console.html" title="Chapter 3. Qpid JMX Management Console"></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.o
rg/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">0.14 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><L
I><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><L
I><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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">Slow Consumer Disconnect - User Guide</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Slow-Consumer-Disconnect"></a>2.11. Slow Consumer Disconnect - User Guide</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div>
<div><h3 class="title"><a name="id2526932"></a>2.11.1. Introduction</h3></div></div></div><p>Slow Consumer Disconnect (SCD) is a new feature in Qpid that provides a configurable
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.12. Slow Consumer Disconnect - User Guide</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="OtherQueueTypes.html" title="2.11. Other Queue Types"><link rel="next" href="Qpid-JMX-Management-Console.html" title="Chapter 3. Qpid JMX Management Console"></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.o
rg/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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">Slow Consumer Disconnect - User Guide</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Broker-Slow-Consumer-Disconnect"></a>2.12. Slow Consumer Disconnect - User Guide</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><di
v><div><h3 class="title"><a name="id2527151"></a>2.12.1. Introduction</h3></div></div></div><p>Slow Consumer Disconnect (SCD) is a new feature in Qpid that provides a configurable
mechanism to prevent a single slow consumer from causing a back up of unconsumed messages on
the broker. </p><p>This is most relevant where Topics are in use, since a published message is not removed
from the broker's memory until all subscribers have acknowledged that message. </p><p>Cases where a consumer is 'slow' can arise due to one of the following: poor network
connectivity exists; a transient system issue affects a single client; a single subscriber
written by a client team is behaving incorrectly and not acknowledging messages; a
downstream resource such as a database is non-responsive. </p><p>SCD will enable the application owner to configure limits for a given consumer's queue and
- the behaviour to execute when those limits are reached. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526967"></a>2.11.2. What can it do?</h3></div></div></div><p>SCD is only applicable to topics or durable subscriptions and can be configured on either
+ the behaviour to execute when those limits are reached. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527185"></a>2.12.2. What can it do?</h3></div></div></div><p>SCD is only applicable to topics or durable subscriptions and can be configured on either
a topic or a subscription name. </p><p>On triggering of a specified threshold the offending client will be disconnected from the
broker with a 506 error code wrapped in a JMSException returned to the client via the
ExceptionListener registered on the Connection object. </p><p>Note that it is essential that an ExceptionListener be specified by the client on
creation of the connection and that exceptions coming back on that listener are handled
- correctly. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2526993"></a>2.11.3. Frequency of SCD Checking</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2526998"></a>2.11.3.1. <span class="bold"><strong>Configuring Frequency</strong></span></h4></div></div></div><p>You can configure the frequency with which the SCD process will check for slow consumers,
+ correctly. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527211"></a>2.12.3. Frequency of SCD Checking</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527216"></a>2.12.3.1. <span class="bold"><strong>Configuring Frequency</strong></span></h4></div></div></div><p>You can configure the frequency with which the SCD process will check for slow consumers,
along with the unit of time used to specify that frequency. </p><p>The <span class="italic">virtualhosts.virtualhost.hostname.slow-consumer-detection</span>
elements <span class="italic">delay</span> and <span class="italic">timeunit</span>
are used to specify the frequency and timeunit respectively in the virtualhosts.xml
@@ -27,10 +27,10 @@
</test>
</virtualhost>
</virtualhosts>
-</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527048"></a>2.11.3.2. <span class="bold"><strong>SCD Log output</strong></span></h4></div></div></div><p>When the SCD component finds a queue with a configured threshold to check, the operational
+</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527266"></a>2.12.3.2. <span class="bold"><strong>SCD Log output</strong></span></h4></div></div></div><p>When the SCD component finds a queue with a configured threshold to check, the operational
logging component (if enabled) will output the following line:</p><pre class="programlisting">
SCD-1003 : Checking Status of Queue
- </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527073"></a>2.11.4. Client Exception<span class="bold"><strong>s</strong></span></h3></div></div></div><p>When a Slow Consumer is disconnected, the client receives a 506 error from the broker
+ </pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527291"></a>2.12.4. Client Exception<span class="bold"><strong>s</strong></span></h3></div></div></div><p>When a Slow Consumer is disconnected, the client receives a 506 error from the broker
wrapped in a JMSException and the Session and Connection are closed:</p><pre class="programlisting">
Dispatcher-Channel-1 2010-09-01 16:23:34,206 INFO [qpid.client.AMQSession.Dispatcher]
Dispatcher-Channel-1 thread terminating for channel 1:org.apache.qpid.client.AMQSession_0_8@1de8aa8
@@ -57,19 +57,19 @@ at org.apache.qpid.client.protocol.AMQPr
... 8 more
main 2010-09-01 16:23:34,316 INFO [apache.qpid.client.AMQSession] Closing session:
org.apache.qpid.client.AMQSession_0_8@ffeef1
-</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527132"></a>2.11.5. Disconnection Thresholds</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527138"></a>2.11.5.1. Topic Subscriptions</h4></div></div></div><p>One key feature of SCD is the disconnection of a consuming client when a specified
+</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527350"></a>2.12.5. Disconnection Thresholds</h3></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527356"></a>2.12.5.1. Topic Subscriptions</h4></div></div></div><p>One key feature of SCD is the disconnection of a consuming client when a specified
threshold is exceeded. For a pub-sub model using topics, this means that messages will no
longer be delivered to the private queue which was associated with that consuming client,
- thus reducing any associated backlog in the broker. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527155"></a>2.11.5.2. Durable Topic Subscriptions</h4></div></div></div><p>For durable subscriptions, simply disconnecting the consuming client will not suffice
+ thus reducing any associated backlog in the broker. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527373"></a>2.12.5.2. Durable Topic Subscriptions</h4></div></div></div><p>For durable subscriptions, simply disconnecting the consuming client will not suffice
since the associated queue is by definition durable and messages would continue to flow to
it after disconnection, potentially worsening any backing up of data on the broker. </p><p>The solution is to configure durable subscriptions to delete the underlying queue on
disconnection. This means that messages will no longer be delivered to the private queue
- associated with the subscription, thus preventing any backlog. </p><p>Full details of how to configure the thresholds are provided below. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527183"></a>2.11.5.3. Message Age Threshold</h4></div></div></div><p>You can configure SCD to be triggered on a topic or subscription when the oldest message
+ associated with the subscription, thus preventing any backlog. </p><p>Full details of how to configure the thresholds are provided below. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527401"></a>2.12.5.3. Message Age Threshold</h4></div></div></div><p>You can configure SCD to be triggered on a topic or subscription when the oldest message
in the associated private queue for the consumer ages beyond the specified value, in
- milliseconds. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527198"></a>2.11.5.4. Queue Depth Threshold</h4></div></div></div><p>You can opt to use the depth of the queue in bytes as a threshold. SCD will be triggered
+ milliseconds. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527415"></a>2.12.5.4. Queue Depth Threshold</h4></div></div></div><p>You can opt to use the depth of the queue in bytes as a threshold. SCD will be triggered
by a queue depth greater than the threshold specified i.e. when a broker receives a
- message that takes the queue depth over the threshold. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527212"></a>2.11.5.5. Message Count Threshold</h4></div></div></div><p>You can use the message count for the consumer's queue as the trigger, where a count
- higher than that specified will trigger disconnection. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527226"></a>2.11.5.6. <span class="bold"><strong>Delete Policy</strong></span></h4></div></div></div><p>You can configure the policy you wish to apply in your broker configuration. There are
+ message that takes the queue depth over the threshold. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527430"></a>2.12.5.5. Message Count Threshold</h4></div></div></div><p>You can use the message count for the consumer's queue as the trigger, where a count
+ higher than that specified will trigger disconnection. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2527443"></a>2.12.5.6. <span class="bold"><strong>Delete Policy</strong></span></h4></div></div></div><p>You can configure the policy you wish to apply in your broker configuration. There are
currently 2 policies available: </p><p>
<span class="bold"><strong>Delete Temporary Queues Only</strong></span>
</p><p>If you do not specify a <topicDelete/> element in your configuration, then only temporary
@@ -105,10 +105,10 @@ The following steps are required to conf
</slow-consumer-detection>
</topic>
</topics>
-</pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527362"></a>2.11.6. Important Points To Note</h3></div></div></div><p> Client application developers should be educated about how to correctly handle being
+</pre></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2527580"></a>2.12.6. Important Points To Note</h3></div></div></div><p> Client application developers should be educated about how to correctly handle being
disconnected with a 506 error code, to avoid them getting into a thrashing state where they
continually attempt to connect, fail to consume fast enough and are disconnected again. </p><p>Clients affected by slow consumer disconnect configuration should always use transactions
where duplicate processing of an incoming message would have adverse affects, since they may
- receive a message more than once if disconnected before acknowledging a message in flight. </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="OtherQueueTypes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Qpid-JMX-Management-Console.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.10. Other Queue Types </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3.Â
+ receive a message more than once if disconnected before acknowledging a message in flight. </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="OtherQueueTypes.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="Qpid-JMX-Management-Console.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. Other Queue Types </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3.Â
Qpid JMX Management Console
</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Environment-Variables.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Environment-Variables.html?rev=1379885&r1=1379884&r2=1379885&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Environment-Variables.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-Environment-Variables.html Sat Sep 1 22:32:47 2012
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.3. Java Environment Variables</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Java-General-User-Guides.html" title="Chapter 1. General User Guides"><link rel="prev" href="Qpid-Java-FAQ.html" title="1.2. Qpid Java FAQ"><link rel="next" href="Qpid-Troubleshooting-Guide.html" title="1.4. Qpid Troubleshooting Guide"></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">0.14 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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Java-General-User-Guides.html">General User Guides</a></span> > <span class="breadcrumb-node">
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>1.3. Java Environment Variables</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Java-General-User-Guides.html" title="Chapter 1. General User Guides"><link rel="prev" href="Qpid-Java-FAQ.html" title="1.2. Qpid Java FAQ"><link rel="next" href="Qpid-Troubleshooting-Guide.html" title="1.4. Qpid Troubleshooting Guide"></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="ht
tp://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="ht
tp://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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Java-General-User-Guides.html">General User Guides</a></span> > <span class="breadcrumb-node">
Java Environment Variables
</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-Environment-Variables"></a>1.3.Â
Java Environment Variables
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-General-User-Guides.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-General-User-Guides.html?rev=1379885&r1=1379884&r2=1379885&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-General-User-Guides.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/Java-General-User-Guides.html Sat Sep 1 22:32:47 2012
@@ -1,4 +1,4 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. General User Guides</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="prev" href="pr01.html" title="Introduction"><link rel="next" href="Qpid-Java-FAQ.html" title="1.2. Qpid Java FAQ"></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/downloa
d.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">0.14 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 (Implemented in Java)</a></span> > <span class="breadcrumb-node">General User Guides</span></DIV><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-General-User-Guides"></a>Chapter 1. General User Guides</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-General-User-Guides.html#id2492446">1.1.
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 1. General User Guides</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="prev" href="pr01.html" title="Introduction"><link rel="next" href="Qpid-Java-FAQ.html" title="1.2. Qpid Java FAQ"></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/downloa
d.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://ww
w.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 (Implemented in Java)</a></span> > <span class="breadcrumb-node">General User Guides</span></DIV><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Java-General-User-Guides"></a>Chapter 1. General User Guides</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="Java-General-User-Guides.html#id2492441">1.1.
Java Broker Feature Guide
</a></span></dt><dd><dl><dt><span class="section"><a href="Java-General-User-Guides.html#JavaBrokerFeatureGuide-TheQpidpureJavabrokercurrentlysupportsthefollowingfeatures-3A">1.1.1.
The Qpid pure Java broker currently supports the following
@@ -27,7 +27,7 @@
</a></span></dt><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html#QpidTroubleshootingGuide-WhenItrytosendmessagestoaqueueI-27mgettingaerrorasthequeuedoesnotexist.WhatcanIdo-3F">1.4.5.
When I try to send messages to a queue I'm getting a error as
the queue does not exist. What can I do ?
- </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html">1.5. Broker Configuration Guide </a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html#Qpid-Producer-Flow-Control">1.5.1. Producer Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html#id2494578">1.5.2. Topic Configuration on Java Broker</a></span></dt></dl></dd><dt><span class="section"><a href="High-Availability.html">1.6. High Availability</a></span></dt><dd><dl><dt><span class="section"><a href="High-Availability.html#HAGeneralIntroduction">1.6.1. General Introduction</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAOfferingsOfJavaBroker">1.6.2. HA offerings of the Java Broker</a></span></dt><dt><span class="section"><a href="High-Availability.html#HATwoNodeCluster">1.6.3. Two Node Cluster</a></span></dt><dt><span class="section"><a href="High-Availabil
ity.html#HAMultiNodeCluster">1.6.4. Multi Node Cluster</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAConfiguration">1.6.5. Configuring a Virtual Host to be a node</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADurabilityGuarantee">1.6.6. Durability Guarantees</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAClientFailover">1.6.7. Client failover configuration</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAJMXAPI">1.6.8. Qpid JMX API for HA</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Monitoring-cluster">1.6.9. Monitoring cluster</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADiskSpace">1.6.10. Disk space requirements</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Network-Requirements">1.6.11. Network Requirements</a></span></dt><dt><span class="section"><a href="High-Avai
lability.html#BDB-HA-Security">1.6.12. Security</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Backup">1.6.13. Backups</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAMigrationFromNonHA">1.6.14. Migration of a non-HA store to HA</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADisasterRecovery">1.6.15. Disaster Recovery</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAPerformance">1.6.16. Performance</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2492446"></a>1.1.Â
+ </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html">1.5. Broker Configuration Guide </a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html#Qpid-Producer-Flow-Control">1.5.1. Producer Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuration-Guide.html#id2493933">1.5.2. Topic Configuration on Java Broker</a></span></dt></dl></dd><dt><span class="section"><a href="High-Availability.html">1.6. High Availability</a></span></dt><dd><dl><dt><span class="section"><a href="High-Availability.html#HAGeneralIntroduction">1.6.1. General Introduction</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAOfferingsOfJavaBroker">1.6.2. HA offerings of the Java Broker</a></span></dt><dt><span class="section"><a href="High-Availability.html#HATwoNodeCluster">1.6.3. Two Node Cluster</a></span></dt><dt><span class="section"><a href="High-Availabil
ity.html#HAMultiNodeCluster">1.6.4. Multi Node Cluster</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAConfiguration">1.6.5. Configuring a Virtual Host to be a node</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADurabilityGuarantee">1.6.6. Durability Guarantees</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAClientFailover">1.6.7. Client failover configuration</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAJMXAPI">1.6.8. Qpid JMX API for HA</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Monitoring-cluster">1.6.9. Monitoring cluster</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADiskSpace">1.6.10. Disk space requirements</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Network-Requirements">1.6.11. Network Requirements</a></span></dt><dt><span class="section"><a href="High-Avai
lability.html#BDB-HA-Security">1.6.12. Security</a></span></dt><dt><span class="section"><a href="High-Availability.html#BDB-HA-Backup">1.6.13. Backups</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAMigrationFromNonHA">1.6.14. Migration of a non-HA store to HA</a></span></dt><dt><span class="section"><a href="High-Availability.html#HADisasterRecovery">1.6.15. Disaster Recovery</a></span></dt><dt><span class="section"><a href="High-Availability.html#HAPerformance">1.6.16. Performance</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2492441"></a>1.1.Â
Java Broker Feature Guide
</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="JavaBrokerFeatureGuide-TheQpidpureJavabrokercurrentlysupportsthefollowingfeatures-3A"></a>1.1.1.Â
The Qpid pure Java broker currently supports the following
Modified: qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/OtherQueueTypes.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/OtherQueueTypes.html?rev=1379885&r1=1379884&r2=1379885&view=diff
==============================================================================
--- qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/OtherQueueTypes.html (original)
+++ qpid/site/docs/books/trunk/AMQP-Messaging-Broker-Java-Book/html/OtherQueueTypes.html Sat Sep 1 22:32:47 2012
@@ -1,18 +1,18 @@
-<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.10. Other Queue Types</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="Qpid-Java-Build-HowTo.html" title="2.9. Qpid Java Build How To"><link rel="next" href="Java-Broker-Slow-Consumer-Disconnect.html" title="2.11. Slow Consumer Disconnect - User Guide"></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">0.14 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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">Other Queue Types</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="OtherQueueTypes"></a>2.10. Other Queue Types</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Introduction
"></a>2.10.1. Introduction</h3></div></div></div><p> In addition to the standard queue type where messages are delivered in the same order
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.11. Other Queue Types</title><link rel="stylesheet" href="css/style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="up" href="Qpid-Java-Broker-HowTos.html" title="Chapter 2. How Tos"><link rel="prev" href="Qpid-Java-Build-HowTo.html" title="2.10. Qpid Java Build How To"><link rel="next" href="Java-Broker-Slow-Consumer-Disconnect.html" title="2.12. Slow Consumer Disconnect - User Guide"></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></L
I><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><U
L><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 (Implemented in Java)</a></span> > <span class="breadcrumb-link"><a href="Qpid-Java-Broker-HowTos.html">How Tos</a></span> > <span class="breadcrumb-node">Other Queue Types</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="OtherQueueTypes"></a>2.11. Other Queue Types</h2></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Introduct
ion"></a>2.11.1. Introduction</h3></div></div></div><p> In addition to the standard queue type where messages are delivered in the same order
that they were sent, the Java Broker supports three additional queue types which allows for
- alternative delivery behaviours. These are <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-Priority" title="2.10.2. Priority Queues">priority-queues</a>, <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-Sorted" title="2.10.3. Sorted Queues">sorted-queues</a>-, and
- <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-LVQ" title="2.10.4. Last Value Queues (LVQ)">last-value-queues</a> (LVQs). </p><p> In the following sections, the semantics of each queue type is described, followed by a
- description of how instances of these queue can be created via <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-CreateUsingConfig" title="2.10.5.1. Using configuration">configuration</a> or <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-CreateUsingJmsOrJmx" title="2.10.5.2. Using JMS or AMQP">programmatically</a>. </p><p>The final section discusses the importance of using a <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-SetLowPrefetch" title="2.10.6. Low pre-fetch">low client pre-fetch</a> with these queued.
- </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Priority"></a>2.10.2. Priority Queues</h3></div></div></div><p>In a priority queue, messages on the queue are delivered in an order determined by the
+ alternative delivery behaviours. These are <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-Priority" title="2.11.2. Priority Queues">priority-queues</a>, <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-Sorted" title="2.11.3. Sorted Queues">sorted-queues</a>-, and
+ <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-LVQ" title="2.11.4. Last Value Queues (LVQ)">last-value-queues</a> (LVQs). </p><p> In the following sections, the semantics of each queue type is described, followed by a
+ description of how instances of these queue can be created via <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-CreateUsingConfig" title="2.11.5.1. Using configuration">configuration</a> or <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-CreateUsingJmsOrJmx" title="2.11.5.2. Using JMS or AMQP">programmatically</a>. </p><p>The final section discusses the importance of using a <a class="link" href="OtherQueueTypes.html#OtherQueueTypes-SetLowPrefetch" title="2.11.6. Low pre-fetch">low client pre-fetch</a> with these queued.
+ </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Priority"></a>2.11.2. Priority Queues</h3></div></div></div><p>In a priority queue, messages on the queue are delivered in an order determined by the
<a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Message.html#getJMSPriority()" target="_top">JMS priority message
header</a> within the message. By default Qpid supports the 10 priority levels mandated
by JMS, with priority value 0 as the lowest priority and 9 as the highest. </p><p>It is possible to reduce the effective number of priorities if desired.</p><p>JMS defines the <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Message.html#DEFAULT_PRIORITY" target="_top">
default message priority</a> as 4. Messages sent without a specified priority use this
- default. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Sorted"></a>2.10.3. Sorted Queues</h3></div></div></div><p>Sorted queues allow the message delivery order to be determined by value of an arbitrary
+ default. </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Sorted"></a>2.11.3. Sorted Queues</h3></div></div></div><p>Sorted queues allow the message delivery order to be determined by value of an arbitrary
<a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Message.html#getStringProperty()" target="_top">JMS message
property</a>. Sort order is alpha-numeric and the property value must have a type
java.lang.String.</p><p>Messages sent to a sorted queue without the specified JMS message property will be
- inserted into the 'last' position in the queue.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-LVQ"></a>2.10.4. Last Value Queues (LVQ)</h3></div></div></div><p>LVQs (or conflation queues) are special queues that automatically discard any message when
+ inserted into the 'last' position in the queue.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-LVQ"></a>2.11.4. Last Value Queues (LVQ)</h3></div></div></div><p>LVQs (or conflation queues) are special queues that automatically discard any message when
a newer message arrives with the same key value. The key is specified by arbitrary <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/Message.html#getPropertyNames()" target="_top">JMS message
property</a>.</p><p>An example of an LVQ might be where a queue represents prices on a stock exchange: when
you first consume from the queue you get the latest quote for each stock, and then as new
@@ -20,14 +20,14 @@
individual subscriber does not remove the message from the queue when receiving it. This
allows for many subscriptions to browse the same LVQ (i.e. you do not need to create and bind
a separate LVQ for each subscriber who wishes to receive the contents of the LVQ).</p><p>Messages sent to an LVQ without the specified property will be delivered as normal and
- will never be "replaced".</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Create"></a>2.10.5. Creating a Priority, Sorted or LVQ Queue</h3></div></div></div><p>To create a priority, sorted or LVQ queue, it can be defined in the virtualhost
+ will never be "replaced".</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-Create"></a>2.11.5. Creating a Priority, Sorted or LVQ Queue</h3></div></div></div><p>To create a priority, sorted or LVQ queue, it can be defined in the virtualhost
configuration file, or the queue can be created programmtically from a client via AMQP (using
an extension to JMS), or using JMX. These methods are described below. </p><p>Once a queue is created you cannot change its type (without deleting it and re-creating).
Also note you cannot currently mix the natures of these queue types, for instance, you cannot
- define a queue which it both an LVQ and a priority-queue.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="OtherQueueTypes-CreateUsingConfig"></a>2.10.5.1. Using configuration</h4></div></div></div><p>To create a priority, sorted or LVQ queue within configuration, add the appropriate xml
+ define a queue which it both an LVQ and a priority-queue.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="OtherQueueTypes-CreateUsingConfig"></a>2.11.5.1. Using configuration</h4></div></div></div><p>To create a priority, sorted or LVQ queue within configuration, add the appropriate xml
to the virtualhost.xml configuration file within the <code class="varname">queues</code>
element.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="OtherQueueTypes-CreateUsingConfig-Priority"></a>Priority</h5></div></div></div><p> To defining a priority queue, add a <priority>true</priority> element. By
- default the queue will have 10 distinct priorities. </p><div class="example"><a name="id2502411"></a><p class="title"><b>Example 2.1. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ default the queue will have 10 distinct priorities. </p><div class="example"><a name="id2502618"></a><p class="title"><b>Example 2.1. Configuring a priority queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
<name>myqueue</name>
<myqueue>
<exchange>amq.direct</exchange>
@@ -39,7 +39,7 @@
sent to that queue, their effective priority will be calculated by partitioning the
priority space. If the number of effective priorities is 2, then messages with priority
0-4 are treated the same as "lower priority" and messages with priority 5-9 are treated
- equivalently as "higher priority". </p><div class="example"><a name="id2502442"></a><p class="title"><b>Example 2.2. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ equivalently as "higher priority". </p><div class="example"><a name="id2502648"></a><p class="title"><b>Example 2.2. Configuring a priority queue with fewer priorities</b></p><div class="example-contents"><pre class="programlisting"><queue>
<name>myqueue</name>
<myqueue>
<exchange>amq.direct</exchange>
@@ -48,7 +48,7 @@
</myqueue>
</queue></pre></div></div><br class="example-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="OtherQueueTypes-CreateUsingConfig-Sorted"></a>Sorted</h5></div></div></div><p> To define a sorted queue, add a <code class="varname">sortKey</code> element. The value of the
<code class="varname">sortKey</code> element defines the message property to use the value of when
- sorting the messages put onto the queue. </p><div class="example"><a name="id2502483"></a><p class="title"><b>Example 2.3. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ sorting the messages put onto the queue. </p><div class="example"><a name="id2502689"></a><p class="title"><b>Example 2.3. Configuring a sorted queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
<name>myqueue</name>
<myqueue>
<exchange>amq.direct</exchange>
@@ -57,29 +57,29 @@
</queue></pre></div></div><br class="example-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="OtherQueueTypes-CreateUsingConfig-LVQ"></a>LVQ</h5></div></div></div><p> To define a LVQ, add a <code class="varname">lvq</code> element with the value
<code class="constant">true</code>. Without any further configuration this will define an LVQ
which uses the JMS message property <code class="constant">qpid.LVQ_key</code> as the key for
- replacement. </p><div class="example"><a name="id2502527"></a><p class="title"><b>Example 2.4. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ replacement. </p><div class="example"><a name="id2502734"></a><p class="title"><b>Example 2.4. Configuring a LVQ queue</b></p><div class="example-contents"><pre class="programlisting"><queue>
<name>myqueue</name>
<myqueue>
<exchange>amq.direct</exchange>
<lvq>true</lvq>
</myqueue>
</queue></pre></div></div><br class="example-break"><p> If you wish to define your own property then you can do so using the
- <code class="varname">lvqKey</code> element.</p><div class="example"><a name="id2502550"></a><p class="title"><b>Example 2.5. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting"><queue>
+ <code class="varname">lvqKey</code> element.</p><div class="example"><a name="id2502756"></a><p class="title"><b>Example 2.5. Configuring a LVQ queue with custom message property name</b></p><div class="example-contents"><pre class="programlisting"><queue>
<name>myqueue</name>
<myqueue>
<exchange>amq.direct</exchange>
<lvq>true</lvq>
<lvqKey>ISIN</lvqKey>
</myqueue>
-</queue></pre></div></div><br class="example-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="OtherQueueTypes-CreateUsingJmsOrJmx"></a>2.10.5.2. Using JMS or AMQP</h4></div></div></div><p>To create a priority, sorted or LVQ queue programmatically from JMX or using a Qpid
- extension to JMS, pass the appropriate queue-declare arguments.</p><div class="table"><a name="id2502584"></a><p class="title"><b>Table 2.11. </b></p><div class="table-contents"><table border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Queue type</th><th>Argument name</th><th>Argument name</th><th>Argument Description</th></tr></thead><tbody><tr><td>priority</td><td>priorities</td><td>java.lang.Integer</td><td>Specifies a priority queue with given number priorities</td></tr><tr><td>sorted</td><td>qpid.queue_sort_key</td><td>java.lang.String</td><td>Specifies sorted queue with given message property used to sort the
+</queue></pre></div></div><br class="example-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="OtherQueueTypes-CreateUsingJmsOrJmx"></a>2.11.5.2. Using JMS or AMQP</h4></div></div></div><p>To create a priority, sorted or LVQ queue programmatically from JMX or using a Qpid
+ extension to JMS, pass the appropriate queue-declare arguments.</p><div class="table"><a name="id2502791"></a><p class="title"><b>Table 2.11. </b></p><div class="table-contents"><table border="1"><colgroup><col><col><col><col></colgroup><thead><tr><th>Queue type</th><th>Argument name</th><th>Argument name</th><th>Argument Description</th></tr></thead><tbody><tr><td>priority</td><td>priorities</td><td>java.lang.Integer</td><td>Specifies a priority queue with given number priorities</td></tr><tr><td>sorted</td><td>qpid.queue_sort_key</td><td>java.lang.String</td><td>Specifies sorted queue with given message property used to sort the
entries</td></tr><tr><td>lvq</td><td>qpid.last_value_queue_key</td><td>java.lang.String</td><td>Specifies lvq queue with given message property used to conflate the
entries</td></tr></tbody></table></div></div><br class="table-break"><p>The following example illustrates the creation of the a LVQ queue from a
javax.jms.Session object. Note that this utilises a Qpid specific extension to JMS and
- involves casting the session object back to its Qpid base-class.</p><div class="example"><a name="id2503422"></a><p class="title"><b>Example 2.6. Creation of an LVQ using the Qpid extension to JMS</b></p><div class="example-contents"><pre class="programlisting">Map<String,Object> arguments = new HashMap<String, Object>();
+ involves casting the session object back to its Qpid base-class.</p><div class="example"><a name="id2503635"></a><p class="title"><b>Example 2.6. Creation of an LVQ using the Qpid extension to JMS</b></p><div class="example-contents"><pre class="programlisting">Map<String,Object> arguments = new HashMap<String, Object>();
arguments.put("qpid.last_value_queue_key","ISIN");
((AMQSession<?,?>) session).createQueue(queueName, autoDelete, durable, exclusive, arguments);</pre></div></div><br class="example-break"><p> The following example illustrates the creation of the sorted queue from a the JMX
- interface using the ManagedBroker interface. </p><div class="example"><a name="id2503443"></a><p class="title"><b>Example 2.7. Creation of a sorted queue using JMX</b></p><div class="example-contents"><pre class="programlisting">Map<String, Object> environment = new HashMap<String, Object>();
+ interface using the ManagedBroker interface. </p><div class="example"><a name="id2503656"></a><p class="title"><b>Example 2.7. Creation of a sorted queue using JMX</b></p><div class="example-contents"><pre class="programlisting">Map<String, Object> environment = new HashMap<String, Object>();
environment.put(JMXConnector.CREDENTIALS, new String[] {"admin","password"});
// Connect to service
JMXServiceURL url = new JMXServiceURL("service:jmx:rmi:///jndi/rmi://localhost:8999/jmxrmi");
@@ -93,7 +93,7 @@ ManagedBroker managedBroker = JMX.newMBe
// Create the queue passing arguments
Map<String,Object> arguments = new HashMap<String, Object>();
arguments.put("qpid.queue_sort_key","myheader");
-managedBroker.createNewQueue("myqueue", null, true, arguments);</pre></div></div><br class="example-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-SetLowPrefetch"></a>2.10.6. Low pre-fetch</h3></div></div></div><p>Qpid clients receive buffered messages in batches, sized according to the pre-fetch value.
+managedBroker.createNewQueue("myqueue", null, true, arguments);</pre></div></div><br class="example-break"></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="OtherQueueTypes-SetLowPrefetch"></a>2.11.6. Low pre-fetch</h3></div></div></div><p>Qpid clients receive buffered messages in batches, sized according to the pre-fetch value.
The current default is 500. </p><p>However, if you use the default value you will probably <span class="emphasis"><em>not</em></span> see
desirable behaviour when using priority, sorted or lvq queues. Once the broker has sent a
message to the client its delivery order is then fixed, regardless of the special behaviour of
@@ -110,6 +110,6 @@ managedBroker.createNewQueue("myqueue",
amqp://guest:guest@client1/development?maxprefetch='1'&brokerlist='tcp://localhost:5672'
</pre><p>Setting the Qpid pre-fetch to 1 will give exact queue-type semantics as perceived by the
client however, this brings a performance cost. You could test with a slightly higher
- pre-fetch to trade-off between throughput and exact semantics.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Qpid-Java-Build-HowTo.html">Prev</a>Â </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right">Â <a accesskey="n" href="Java-Broker-Slow-Consumer-Disconnect.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.9.Â
+ pre-fetch to trade-off between throughput and exact semantics.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Qpid-Java-Build-HowTo.html">Prev</a>Â </td><td width="20%" align="center"><a accesskey="u" href="Qpid-Java-Broker-HowTos.html">Up</a></td><td width="40%" align="right">Â <a accesskey="n" href="Java-Broker-Slow-Consumer-Disconnect.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.10.Â
Qpid Java Build How To
-  </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.11. Slow Consumer Disconnect - User Guide</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>
+  </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2.12. Slow Consumer Disconnect - User Guide</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