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/08/12 21:03:53 UTC

svn commit: r1372179 [13/18] - in /qpid/site/docs/books/0.18: ./ AMQP-Messaging-Broker-CPP-Book/ AMQP-Messaging-Broker-CPP-Book/html/ AMQP-Messaging-Broker-CPP-Book/html/css/ AMQP-Messaging-Broker-CPP-Book/html/images/ AMQP-Messaging-Broker-CPP-Book/pd...

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113098.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113098.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113098.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113099.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113099.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113099.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113100.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113100.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113100.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113101.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113101.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113101.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113102.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113102.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113102.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113103.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113103.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113103.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113104.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113104.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113104.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113105.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113105.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113105.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113106.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113106.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113106.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113107.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113107.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113107.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113108.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113108.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113108.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113109.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113109.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113109.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113110.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113110.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113110.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113111.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113111.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113111.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113112.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113112.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113112.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113113.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113113.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113113.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113114.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113114.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113114.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113115.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113115.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113115.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113116.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113116.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113116.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113117.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113117.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113117.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113118.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113118.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113118.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113119.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113119.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/3113119.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Key.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Key.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Key.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-MasterFail.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-MasterFail.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-MasterFail.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-NetworkPartition.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-NetworkPartition.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-NetworkPartition.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Normal.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Normal.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-Normal.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-ReplicaFail.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-ReplicaFail.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-ReplicaFail.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-SplitBrain.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-SplitBrain.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-2N-SplitBrain.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-BDBHAMessageStore-MBean-jconsole.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-BDBHAMessageStore-MBean-jconsole.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-BDBHAMessageStore-MBean-jconsole.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-perftests-results.png
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-perftests-results.png?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/images/HA-perftests-results.png
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/index.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/index.html?rev=1372179&view=auto
==============================================================================
--- qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/index.html (added)
+++ qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/index.html Sun Aug 12 19:03:49 2012
@@ -0,0 +1,120 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>AMQP Messaging Broker (Implemented in Java)</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="next" href="pr01.html" title="Introduction"></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 h
 ref="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-node">AMQP Messaging Broker (Implemented in Java)</span></DIV><div class="book" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="id2426357"></a>AMQP Messaging Broker (Implemented in Java)</h1></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="preface"><a href="pr01.html">Introduction</a></span></dt><dt><span class="chapter"><a href="Java-General-User-Guides.html">1. General User Guides</a></span></dt><dd><dl><dt><span class="section"><a href="Java-General-User-Guides.html#id2492438">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
+            features:
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-FAQ.html">1.2. 
+      Qpid Java FAQ
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-FAQ.html#QpidJavaFAQ-Purpose">1.2.1. Purpose</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Environment-Variables.html">1.3. 
+      Java Environment Variables
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Java-Environment-Variables.html#JavaEnvironmentVariables-SettingQpidEnvironmentVariables">1.3.1. 
+            Setting
+            Qpid Environment Variables
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html">1.4. 
+      Qpid Troubleshooting Guide
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html#QpidTroubleshootingGuide-I-27mgettingajava.lang.UnsupportedClassVersionErrorwhenItrytostartthebroker.Whatdoesthismean-3F">1.4.1. 
+            I'm getting a java.lang.UnsupportedClassVersionError when I
+            try to start the broker. What does this mean ?
+          </a></span></dt><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html#QpidTroubleshootingGuide-I-27mhavingaproblembindingtotherequiredhost-3Aportatbrokerstartup-3F">1.4.2. 
+            I'm having a problem binding to the required host:port at
+            broker startup ?
+          </a></span></dt><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html#QpidTroubleshootingGuide-I-27mhavingproblemswithmyclasspath.HowcanIensurethatmyclasspathisok-3F">1.4.3. 
+            I'm having problems with my classpath. How can I ensure that
+            my classpath is ok ?
+          </a></span></dt><dt><span class="section"><a href="Qpid-Troubleshooting-Guide.html#QpidTroubleshootingGuide-Ican-27tgetthebrokertostart.HowcanIdiagnosetheproblem-3F">1.4.4. 
+            I can't get the broker to start. How can I diagnose the
+            problem ?
+          </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#id2494910">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></dd><dt><span class="chapter"><a href="Qpid-Java-Broker-HowTos.html">2. How Tos</a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Broker-HowTos.html#id2495214">2.1. 
+      Add New Users
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Broker-HowTos.html#AddNewUsers-AvailablePasswordfileformats">2.1.1. 
+            Available
+            Password file formats
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-Broker-HowTos.html#AddNewUsers-Dynamicchangestopasswordfiles.">2.1.2. 
+            Dynamic
+            changes to password files.
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-Broker-HowTos.html#AddNewUsers-HowpasswordfilesandPrincipalDatabasesrelatetoauthenticationmechanisms">2.1.3. 
+            How password files and PrincipalDatabases relate to
+            authentication mechanisms
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Configuring-ACLS.html">2.2. 
+      Configuring ACLs
+  </a></span></dt><dd><dl><dt><span class="section"><a href="Configuring-ACLS.html#ConfigureACLs-EnablingACL">2.2.1. 
+       Enabling ACLs
+    </a></span></dt><dt><span class="section"><a href="Configuring-ACLS.html#ConfigureACLs-WriteACL">2.2.2. 
+       Writing .acl files
+    </a></span></dt><dt><span class="section"><a href="Configuring-ACLS.html#ConfigureACLs-Syntax">2.2.3. 
+       Syntax
+    </a></span></dt><dt><span class="section"><a href="Configuring-ACLS.html#ConfigureACLs-WorkedExamples">2.2.4. 
+      Worked Examples
+    </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-SSL.html">2.3. 
+      Configure Java Qpid to use a SSL connection.
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-SSL.html#ConfigureJavaQpidtouseaSSLconnection.-UsingSSLconnectionwithQpidJava.">2.3.1. 
+            Using SSL connection with Qpid Java.
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-SSL.html#ConfigureJavaQpidtouseaSSLconnection.-Setup">2.3.2. 
+            Setup
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-SSL.html#ConfigureJavaQpidtouseaSSLconnection.-Performingtheconnection.">2.3.3. 
+            Performing
+            the connection.
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-Log4j.html">2.4. 
+      Configure Log4j CompositeRolling Appender
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Log4j.html#ConfigureLog4jCompositeRollingAppender-HowtoconfiguretheCompositeRollinglog4jAppender">2.4.1. 
+            How to configure the CompositeRolling log4j Appender
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-Broker-Config-File.html">2.5. 
+      Configure the Broker via config.xml
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Broker-Config-File.html#ConfiguretheBrokerviaconfig.xml-Brokerconfig.xmlOverview">2.5.1. 
+            Broker config.xml Overview
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-Broker-Config-File.html#ConfiguretheBrokerviaconfig.xml-QpidVersion">2.5.2. 
+            Qpid
+            Version
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-Broker-Virtualhosts-Config.html">2.6. 
+      Configure the Virtual Hosts via virtualhosts.xml
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Broker-Virtualhosts-Config.html#ConfiguretheVirtualHostsviavirtualhosts.xml-virtualhosts.xmlOverview">2.6.1. 
+            virtualhosts.xml Overview
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Debug-Logging.html">2.7. 
+      Debug using log4j
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Debug-Logging.html#Debugusinglog4j-Debuggingwithlog4jconfigurations">2.7.1. 
+            Debugging
+            with log4j configurations
+          </a></span></dt></dl></dd><dt><span class="section"><a href="How-to-Tune-M3-Java-Broker-Performance.html">2.8. 
+      How to Tune M3 Java Broker Performance
+    </a></span></dt><dd><dl><dt><span class="section"><a href="How-to-Tune-M3-Java-Broker-Performance.html#HowtoTuneM3JavaBrokerPerformance-ProblemStatement">2.8.1. 
+            Problem
+            Statement
+          </a></span></dt><dt><span class="section"><a href="How-to-Tune-M3-Java-Broker-Performance.html#HowtoTuneM3JavaBrokerPerformance-SuccessfulTuningOptions">2.8.2. 
+            Successful
+            Tuning Options
+          </a></span></dt><dt><span class="section"><a href="How-to-Tune-M3-Java-Broker-Performance.html#HowtoTuneM3JavaBrokerPerformance-NextSteps">2.8.3. 
+            Next
+            Steps
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Qpid-Java-Build-HowTo.html">2.9. 
+      Qpid Java Build How To
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-Java-Build-HowTo.html#QpidJavaBuildHowTo-BuildInstructionsGeneral">2.9.1. 
+            Build
+            Instructions - General
+          </a></span></dt><dt><span class="section"><a href="Qpid-Java-Build-HowTo.html#QpidJavaBuildHowTo-BuildInstructionsTrunk">2.9.2. 
+            Build
+            Instructions - Trunk
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Priority-Queues.html">2.10. 
+      Use Priority Queues
+    </a></span></dt><dd><dl><dt><span class="section"><a href="Priority-Queues.html#UsePriorityQueues-GeneralInformation">2.10.1. 
+            General
+            Information
+          </a></span></dt><dt><span class="section"><a href="Priority-Queues.html#UsePriorityQueues-DefiningPriorityQueues">2.10.2. 
+            Defining
+            Priority Queues
+          </a></span></dt><dt><span class="section"><a href="Priority-Queues.html#UsePriorityQueues-Clientconfiguration-2Fmessagingmodelforpriorityqueues">2.10.3. 
+            Client configuration/messaging model for priority queues
+          </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html">2.11. Slow Consumer Disconnect - User Guide</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526441">2.11.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526475">2.11.2. What can it do?</a></span></dt><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526501">2.11.3. Frequency of SCD Checking</a></span></dt><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526581">2.11.4. Client Exception<span class="bold"><strong>s</strong></span></a></span></dt><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526640">2.11.5. Disconnection Thresholds</a></span></dt><dt><span class="section"><a href="Java-Broker-Slow-Consumer-Disconnect.html#id2526871">2.11.6. Important Points
  To Note</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Qpid-JMX-Management-Console.html">3. 
+    Qpid JMX Management Console
+  </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-JMX-Management-Console.html#QpidJMXManagementConsole-QpidJMXManagementConsole">3.1.  Qpid JMX Management Console </a></span></dt><dd><dl><dt><span class="section"><a href="Qpid-JMX-Management-Console.html#QpidJMXManagementConsole-Overview">3.1.1. 
+	Overview
+      </a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="QpidJavaBroker-ManagementTools.html">4. Management Tools</a></span></dt><dd><dl><dt><span class="section"><a href="QpidJavaBroker-ManagementTools.html#Qpid-Java-Broker-Management-CLI">4.1. 
+      Qpid Java Broker Management CLI
+    </a></span></dt><dd><dl><dt><span class="section"><a href="QpidJavaBroker-ManagementTools.html#QpidJavaBrokerManagementCLI-HowtobuildApacheQpidCLI">4.1.1. 
+            How to
+            build Apache Qpid CLI
+          </a></span></dt></dl></dd></dl></dd></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>1.1. <a href="High-Availability.html#id2496162">Key for figures</a></dt><dt>1.2. <a href="High-Availability.html#id2496210">Normal operation of a two-node cluster</a></dt><dt>1.3. <a href="High-Availability.html#id2496338">Failure of master and recovery sequence</a></dt><dt>1.4. <a href="High-Availability.html#id2498977">Failure of replica and subsequent recovery sequence</a></dt><dt>1.5. <a href="High-Availability.html#id2499098">Partition of the network separating master and replica</a></dt><dt>1.6. <a href="High-Availability.html#id2499232">Split Brain</a></dt><dt>1.7. <a href="High-Availability.html#id2500390">BDBHAMessageStore view from jconsole.</a></dt><dt>1.8. <a href="High-Availability.html#id2501679">Test results</a></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1.1. <a href="Qpid-Java-FAQ.html#id2495279">
+            Command Line Options
+          </a></dt><dt>1.2. <a href="High-Availability.html#id2499802">Effect of different durability guarantees</a></dt><dt>1.3. <a href="High-Availability.html#id2500050">Mbean <code class="classname">BDBHAMessageStore</code> attributes</a></dt><dt>1.4. <a href="High-Availability.html#id2500268">Mbean <code class="classname">BDBHAMessageStore</code> operations</a></dt><dt>1.5. <a href="High-Availability.html#id2501163">Number of producers/consumers in performance tests</a></dt><dt>1.6. <a href="High-Availability.html#id2501415">Performance Comparison</a></dt><dt>2.1. <a href="Qpid-Java-Broker-HowTos.html#id2497269">File Format and Principal Database</a></dt><dt>2.2. <a href="Configuring-ACLS.html#tabl-ConfigureACLs-Syntax_permissions">ACL Rules: permission</a></dt><dt>2.3. <a href="Configuring-ACLS.html#tabl-ConfigureACLs-Syntax_actions">ACL Rules:action</a></dt><dt>2.4. <a href="Configuring-ACLS.html#tabl-ConfigureACLs-Syntax_objects">ACL Rules:object</a></dt><dt>2.5. <a 
 href="Configuring-ACLS.html#tabl-ConfigureACLs-Syntax_properties">ACL Rules:property</a></dt><dt>2.6. <a href="Configuring-ACLS.html#tabl-ConfigureACLs-Syntax_javacomponents">ACL rules:components (Java Broker only)</a></dt><dt>2.7. <a href="How-to-Tune-M3-Java-Broker-Performance.html#id2496810"></a></dt><dt>2.8. <a href="Qpid-Java-Build-HowTo.html#id2498638"></a></dt><dt>2.9. <a href="Qpid-Java-Build-HowTo.html#id2498707"></a></dt><dt>2.10. <a href="Qpid-Java-Build-HowTo.html#id2498763"></a></dt></dl></div><div class="list-of-examples"><p><b>List of Examples</b></p><dl><dt>1.1. <a href="High-Availability.html#id2500000">Example of connection URL for the HA Cluster</a></dt><dt>1.2. <a href="High-Availability.html#id2500403">Example of java code to get the node state value</a></dt><dt>1.3. <a href="High-Availability.html#id2500512">Using <code class="classname">DbPing</code> utility for monitoring HA nodes.</a></dt><dt>1.4. <a href="High-Availability.html#id2500818">Performing
  store backup by using <code class="classname">BDBBackup</code> class directly</a></dt><dt>1.5. <a href="High-Availability.html#id2500855">Performing store backup by using <code class="classname">backup.sh</code> bash script</a></dt><dt>1.6. <a href="High-Availability.html#id2500911">Enabling replication</a></dt><dt>1.7. <a href="High-Availability.html#id2500954">Example of XML configuration for HA message store</a></dt><dt>1.8. <a href="High-Availability.html#id2501072">Reseting of replication group with <code class="classname">DbResetRepGroup</code></a></dt></dl></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="pr01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Introduction</t
 d></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/pr01.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/pr01.html?rev=1372179&view=auto
==============================================================================
--- qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/pr01.html (added)
+++ qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/html/pr01.html Sun Aug 12 19:03:49 2012
@@ -0,0 +1 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Introduction</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="index.html" title="AMQP Messaging Broker (Implemented in Java)"><link rel="next" href="Java-General-User-Guides.html" title="Chapter 1. General User Guides"></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 hre
 f="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/mail
 ing_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> &gt; <span class="breadcrumb-node">Introduction</span></DIV><div class="preface" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2426344"></a>Introduction</h2></div></div></div><p>Qpid provides two AMQP messaging brokers:</p><div class="itemizedlist"><ul><li><p>Implemented in C++ - high performance, low latency, and RDMA support.</p></li><li><p>Implemented in Java - Fully JMS compliant, runs on any Java platform.</p></li></ul></div><p>Both AMQP mess
 aging brokers support clients in multiple languages, as long as the messaging client and the messaging broker use the same version of AMQP.</p><p>This manual contains information specific to the broker that is implemented in Java.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="Java-General-User-Guides.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">AMQP Messaging Broker (Implemented in Java) </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 1. General User Guides</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/pdf/AMQP-Messaging-Broker-Java-Book.pdf
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/pdf/AMQP-Messaging-Broker-Java-Book.pdf?rev=1372179&view=auto
==============================================================================
Binary file - no diff available.

Propchange: qpid/site/docs/books/0.18/AMQP-Messaging-Broker-Java-Book/pdf/AMQP-Messaging-Broker-Java-Book.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/Message-Groups-Guide.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/Message-Groups-Guide.html?rev=1372179&view=auto
==============================================================================
--- qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/Message-Groups-Guide.html (added)
+++ qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/Message-Groups-Guide.html Sun Aug 12 19:03:49 2012
@@ -0,0 +1,100 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.17. Using Message Groups</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="Programming in Apache Qpid"><link rel="up" href="ch02.html" title="Chapter 2. Using the Qpid Messaging API"><link rel="prev" href="section-amqp0-10-mapping.html" title="2.16. The AMQP 0-10 mapping"><link rel="next" href="QpidJMS.html" title="Chapter 3. Using the Qpid JMS client"></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="h
 ttp://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">Programming in Apache Qpid</a></span> &gt; <span class="breadcrumb-link"><a href="ch02.html">Using the Qpid Messaging API</a></span> &gt; <span class="breadcrumb-node">Using Message Groups</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="Message-Groups-Guide"></a>2.17. Using Message Groups</h2></div></div></div><p>
+    This section describes how messaging applications can use the Message Group feature
+    provided by the C++ Broker.
+  </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3>
+    The content of this section assumes the reader is familiar with the Message Group
+    feature as described in the AMQP Messaging Broker (C++) user's guide.  Please read the
+    section <span class="emphasis"><em>Using Message Groups</em></span> in the user's guide before using the
+    examples given in this section.
+  </div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="messagegroups-setup"></a>2.17.1. Creating Message Group Queues</h3></div></div></div><p>
+      The following examples show how to create a message group queue that enforces
+      ordered group consumption across multiple consumers.
+    </p><div class="example"><a name="id2515682"></a><p class="title"><b>Example 2.22. Message Group Queue Creation - Python</b></p><div class="example-contents"><pre class="programlisting">
+sender = connection.session().sender("msg-group-q;" +
+                                     " {create:always, delete:receiver," +
+                                     " node: {x-declare: {arguments:" +
+                                     " {'qpid.group_header_key':'THE-GROUP'," +
+                                     " 'qpid.shared_msg_group':1}}}}")
+      </pre></div></div><br class="example-break"><div class="example"><a name="id2532698"></a><p class="title"><b>Example 2.23. Message Group Queue Creation - C++</b></p><div class="example-contents"><pre class="programlisting">
+std::string addr("msg-group-q; "
+                 " {create:always, delete:receiver,"
+                 " node: {x-declare: {arguments:"
+                 " {qpid.group_header_key:'THE-GROUP',"
+                 " qpid.shared_msg_group:1}}}}");
+Sender sender = session.createSender(addr);
+      </pre></div></div><br class="example-break"><div class="example"><a name="id2492379"></a><p class="title"><b>Example 2.24. Message Group Queue Creation - Java</b></p><div class="example-contents"><pre class="programlisting">
+Session s = c.createSession(false, Session.CLIENT_ACKNOWLEDGE);
+String addr = "msg-group-q; {create:always, delete:receiver," +
+                             " node: {x-declare: {arguments:" +
+                             " {'qpid.group_header_key':'THE-GROUP'," +
+                             " 'qpid.shared_msg_group':1}}}}";
+Destination d = (Destination) new AMQAnyDestination(addr);
+MessageProducer sender = s.createProducer(d);
+      </pre></div></div><br class="example-break"><p>
+      The example code uses the x-declare map to specify the message group configuration
+      that should be used for the queue.  See the AMQP Messaging Broker (C++) user's guide
+      for a detailed description of these arguments.  Note that the
+      qpid.group_header_key's value MUST be a string type.
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="messagegroups-sending"></a>2.17.2. Sending Grouped Messages</h3></div></div></div><p>
+      When sending grouped messages, the client must add a message property containing the
+      group identifier to the outgoing message.  The group identifier must be a string
+      type.  The key used for the property must exactly match the value passed in the
+      'qpid.group_header_key' configuration argument.
+    </p><div class="example"><a name="id2508861"></a><p class="title"><b>Example 2.25. Sending Grouped Messages - Python</b></p><div class="example-contents"><pre class="programlisting">
+group = "A"
+m = Message(content="some data", properties={"THE-GROUP": group})
+sender.send(m)
+
+group = "B"
+m = Message(content="some other group's data", properties={"THE-GROUP": group})
+sender.send(m)
+
+group = "A"
+m = Message(content="more data for group 'A'", properties={"THE-GROUP": group})
+sender.send(m)
+      </pre></div></div><br class="example-break"><div class="example"><a name="id2508880"></a><p class="title"><b>Example 2.26. Sending Grouped Messages - C++</b></p><div class="example-contents"><pre class="programlisting">
+
+const std::string groupKey("THE-GROUP");
+{
+    Message msg("some data");
+    msg.getProperties()[groupKey] = std::string("A");
+    sender.send(msg);
+}
+{
+    Message msg("some other group's data");
+    msg.getProperties()[groupKey] = std::string("B");
+    sender.send(msg);
+}
+{
+    Message msg("more data for group 'A'");
+    msg.getProperties()[groupKey] = std::string("A");
+    sender.send(msg);
+}
+      </pre></div></div><br class="example-break"><div class="example"><a name="id2508900"></a><p class="title"><b>Example 2.27. Sending Grouped Messages - Java</b></p><div class="example-contents"><pre class="programlisting">
+String groupKey = "THE-GROUP";
+
+TextMessage tmsg1 = s.createTextMessage("some data");
+tmsg1.setStringProperty(groupKey, "A");
+sender.send(tmsg1);
+
+TextMessage tmsg2 = s.createTextMessage("some other group's data");
+tmsg2.setStringProperty(groupKey, "B");
+sender.send(tmsg2);
+
+TextMessage tmsg3 = s.createTextMessage("more data for group 'A'");
+tmsg3.setStringProperty(groupKey, "A");
+sender.send(tmsg3);
+      </pre></div></div><br class="example-break"><p>
+      The examples above send two groups worth of messages to the queue created in the
+      previous example.  Two messages belong to group "A", and one belongs to group
+      "B". Note that it is not necessary to complete sending one group's messages before
+      starting another.  Also note that there is no need to indicate to the broker when a
+      new group is created or an existing group retired - the broker tracks group state
+      automatically.
+    </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="messagegroups-receiving"></a>2.17.3. Receiving Grouped Messages</h3></div></div></div><p>
+      Since the broker enforces group policy when delivering messages, no special actions
+      are necessary for receiving grouped messages from the broker.  However, applications
+      must adhere to the rules for message group consumption as described in the AMQP
+      Messaging Broker (C++) user's guide.  Refer to the section <span class="emphasis"><em>Well Behaved
+      Consumers</em></span> for details.
+    </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="section-amqp0-10-mapping.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="QpidJMS.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.16. The AMQP 0-10 mapping </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Using the Qpid JMS client</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJMS.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJMS.html?rev=1372179&view=auto
==============================================================================
--- qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJMS.html (added)
+++ qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJMS.html Sun Aug 12 19:03:49 2012
@@ -0,0 +1,78 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Chapter 3. Using the Qpid JMS client</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="Programming in Apache Qpid"><link rel="up" href="index.html" title="Programming in Apache Qpid"><link rel="prev" href="Message-Groups-Guide.html" title="2.17. Using Message Groups"><link rel="next" href="QpidJNDI.html" title="3.2. Apache Qpid JNDI Properties for AMQP Messaging"></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/maili
 ng_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">Programming in Apache Qpid</a></span> &gt; <span class="breadcrumb-node">Using the Qpid JMS client</span></DIV><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="QpidJMS"></a>Chapter 3. Using the Qpid JMS client</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="QpidJMS.html#id2553400">3.1. A Simple Messaging Program in Java JMS</a></span></dt><dt><span class="section"><a href="QpidJNDI.html">3.2. Apache Qpid JNDI Properties 
 for AMQP Messaging</a></span></dt><dd><dl><dt><span class="section"><a href="QpidJNDI.html#id2553812">3.2.1. JNDI Properties for Apache Qpid</a></span></dt><dt><span class="section"><a href="QpidJNDI.html#section-jms-connection-url">3.2.2. Connection URLs</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s03.html">3.3. Java JMS Message Properties</a></span></dt><dt><span class="section"><a href="section-JMS-MapMessage.html">3.4. JMS MapMessage Types</a></span></dt><dt><span class="section"><a href="section-JMS-Logging.html">3.5. JMS Client Logging</a></span></dt><dt><span class="section"><a href="ch03s06.html">3.6. Configuring the JMS Client</a></span></dt><dd><dl><dt><span class="section"><a href="ch03s06.html#client-jvm-properties">3.6.1. Qpid JVM Arguments</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2553400"></a>3.1. A Simple Messaging Program in Java JMS</h2></div></div>
 </div><p>The following program shows how to send and receive a
+      message using the Qpid JMS client. JMS programs typically use
+      JNDI to obtain connection factory and destination objects which
+      the application needs. In this way the configuration is kept
+      separate from the application code itself.</p><p>In this example, we create a JNDI context using a
+      properties file, use the context to lookup a connection factory,
+      create and start a connection, create a session, and lookup a
+      destination from the JNDI context. Then we create a producer and
+      a consumer, send a message with the producer and receive it with
+      the consumer. This code should be straightforward for anyone
+      familiar with Java JMS.</p><div class="example"><a name="id2553425"></a><p class="title"><b>Example 3.1. "Hello world!" in Java</b></p><div class="example-contents"><pre class="programlisting">
+	  package org.apache.qpid.example.jmsexample.hello;
+
+	  import javax.jms.*;
+	  import javax.naming.Context;
+	  import javax.naming.InitialContext;
+	  import java.util.Properties;
+
+	  public class Hello {
+
+	  public Hello() {
+	  }
+
+	  public static void main(String[] args) {
+	  Hello producer = new Hello();
+	  producer.runTest();
+	  }
+
+	  private void runTest() {
+	  try {
+	  Properties properties = new Properties();
+	  properties.load(this.getClass().getResourceAsStream("hello.properties"));  <a class="co" name="hello-java-properties" href="QpidJMS.html#callout-java-properties">(1)</a>
+	  Context context = new InitialContext(properties);   <a class="co" name="hello-java-context" href="QpidJMS.html#callout-java-context">(2)</a>
+
+	  ConnectionFactory connectionFactory
+          = (ConnectionFactory) context.lookup("qpidConnectionfactory"); <a class="co" name="hello-java-connection-factory" href="QpidJMS.html#callout-java-connection-factory">(3)</a>
+	  Connection connection = connectionFactory.createConnection();  <a class="co" name="hello-java-connection" href="QpidJMS.html#callout-java-connection">(4)</a>
+	  connection.start();  <a class="co" name="hello-java-start" href="QpidJMS.html#callout-java-start">(5)</a>
+
+	  Session session=connection.createSession(false,Session.AUTO_ACKNOWLEDGE);<a class="co" name="hello-java-session" href="QpidJMS.html#callout-java-session">(6)</a>
+	  Destination destination = (Destination) context.lookup("topicExchange");  <a class="co" name="hello-java-destination" href="QpidJMS.html#callout-java-destination">(7)</a>
+
+	  MessageProducer messageProducer = session.createProducer(destination);  <a class="co" name="hello-java-producer" href="QpidJMS.html#callout-java-producer">(8)</a>
+	  MessageConsumer messageConsumer = session.createConsumer(destination);  <a class="co" name="hello-java-consumer" href="QpidJMS.html#callout-java-consumer">(9)</a>
+
+	  TextMessage message = session.createTextMessage("Hello world!");
+	  messageProducer.send(message);
+
+	  message = (TextMessage)messageConsumer.receive();    <a class="co" name="hello-java-receive" href="QpidJMS.html#callout-java-receive">(10)</a>
+	  System.out.println(message.getText());
+
+	  connection.close();  <a class="co" name="hello-java-close" href="QpidJMS.html#callout-java-close">(11)</a>
+	  context.close();   <a class="co" name="hello-java-jndi-close" href="QpidJMS.html#callout-java-jndi-close">(12)</a>
+	  }
+	  catch (Exception exp) {
+	  exp.printStackTrace();
+	  }
+	  }
+	  }
+	</pre></div></div><br class="example-break"><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-properties"></a><a href="#hello-java-properties">(1)</a> </p></td><td valign="top" align="left"><p>Loads the JNDI properties file, which specifies connection properties, queues, topics, and addressing options. See <a class="xref" href="QpidJNDI.html" title="3.2. Apache Qpid JNDI Properties for AMQP Messaging">Section 3.2, “Apache Qpid JNDI Properties for AMQP Messaging”</a> for details.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-context"></a><a href="#hello-java-context">(2)</a> </p></td><td valign="top" align="left"><p>Creates the JNDI initial context.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-connection-factory"></a><a href="#hello-java-connection-factory">(3)</a> </p></td><td valign="top" align="lef
 t"><p>Creates a JMS connection factory for Qpid.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-connection"></a><a href="#hello-java-connection">(4)</a> </p></td><td valign="top" align="left"><p>Creates a JMS connection.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-start"></a><a href="#hello-java-start">(5)</a> </p></td><td valign="top" align="left"><p>Activates the connection.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-session"></a><a href="#hello-java-session">(6)</a> </p></td><td valign="top" align="left"><p>Creates a session. This session is not transactional (transactions='false'), and messages are automatically acknowledged.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-destination"></a><a href="#hello-java-destination">(7)</a> </p></td><td valign="top" align="left"><p>Creates a destination for the topic exchange, so sen
 ders and receivers can use it.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-producer"></a><a href="#hello-java-producer">(8)</a> </p></td><td valign="top" align="left"><p>Creates a producer that sends messages to the topic exchange.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-consumer"></a><a href="#hello-java-consumer">(9)</a> </p></td><td valign="top" align="left"><p>Creates a consumer that reads messages from the topic exchange.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-receive"></a><a href="#hello-java-receive">(10)</a> </p></td><td valign="top" align="left"><p>Reads the next available message.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-close"></a><a href="#hello-java-close">(11)</a> </p></td><td valign="top" align="left"><p>Closes the connection, all sessions managed by the connection, and all senders and receivers
  managed by each session.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-java-jndi-close"></a><a href="#hello-java-jndi-close">(12)</a> </p></td><td valign="top" align="left"><p>Closes the JNDI context.</p></td></tr></table></div><p>The contents of the hello.properties file are shown below.</p><div class="example"><a name="id2553690"></a><p class="title"><b>Example 3.2. JNDI Properties File for "Hello world!" example</b></p><div class="example-contents"><pre class="programlisting">
+	  java.naming.factory.initial
+	  = org.apache.qpid.jndi.PropertiesFileInitialContextFactory
+
+	  # connectionfactory.[jndiname] = [ConnectionURL]
+	  connectionfactory.qpidConnectionfactory
+	  = amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672' <a class="co" name="hello-properties-connectionfactory" href="QpidJMS.html#callout-hello-properties-connectionfactory">(1)</a>
+	  # destination.[jndiname] = [address_string]
+	  destination.topicExchange = amq.topic <a class="co" name="hello-properties-destination" href="QpidJMS.html#callout-hello-properties-destination">(2)</a>
+	</pre></div></div><br class="example-break"><div class="calloutlist"><table border="0" summary="Callout list"><tr><td width="5%" valign="top" align="left"><p><a name="callout-hello-properties-connectionfactory"></a><a href="#hello-properties-connectionfactory">(1)</a> </p></td><td valign="top" align="left"><p>Defines a connection factory from which connections
+	  can be created. The syntax of a ConnectionURL is given in
+	  <a class="xref" href="QpidJNDI.html" title="3.2. Apache Qpid JNDI Properties for AMQP Messaging">Section 3.2, “Apache Qpid JNDI Properties for AMQP Messaging”</a>.</p></td></tr><tr><td width="5%" valign="top" align="left"><p><a name="callout-hello-properties-destination"></a><a href="#hello-properties-destination">(2)</a> </p></td><td valign="top" align="left"><p>Defines a destination for which MessageProducers
+	  and/or MessageConsumers can be created to send and receive
+	  messages. The value for the destination in the properties
+	  file is an address string as described in
+	  <a class="xref" href="section-addresses.html" title="2.4. Addresses">Section 2.4, “Addresses”</a>. In the JMS
+	  implementation MessageProducers are analogous to senders in
+	  the Qpid Message API, and MessageConsumers are analogous to
+	  receivers.</p></td></tr></table></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="Message-Groups-Guide.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="QpidJNDI.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2.17. Using Message Groups </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.2. Apache Qpid JNDI Properties for AMQP Messaging</td></tr></table></div><div class="main_text_area_bottom"></div></div></div></body></html>

Added: qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJNDI.html
URL: http://svn.apache.org/viewvc/qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJNDI.html?rev=1372179&view=auto
==============================================================================
--- qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJNDI.html (added)
+++ qpid/site/docs/books/0.18/Programming-In-Apache-Qpid-Book/html/QpidJNDI.html Sun Aug 12 19:03:49 2012
@@ -0,0 +1,256 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.2. Apache Qpid JNDI Properties for AMQP Messaging</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="Programming in Apache Qpid"><link rel="up" href="QpidJMS.html" title="Chapter 3. Using the Qpid JMS client"><link rel="prev" href="QpidJMS.html" title="Chapter 3. Using the Qpid JMS client"><link rel="next" href="ch03s03.html" title="3.3. Java JMS Message Properties"></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">Programming in Apache Qpid</a></span> &gt; <span class="breadcrumb-link"><a href="QpidJMS.html">Using the Qpid JMS client</a></span> &gt; <span class="breadcrumb-node">Apache Qpid JNDI Properties for AMQP Messaging</span></DIV><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="QpidJNDI"></a>3.2. Apache Qpid JNDI Properties for AMQP Messaging</h2></div></div></div><p>
+	Apache Qpid defines JNDI properties that can be used to specify JMS Connections and Destinations. Here is a typical JNDI properties file:
+      </p><div class="example"><a name="id2553790"></a><p class="title"><b>Example 3.3. JNDI Properties File</b></p><div class="example-contents"><pre class="programlisting">
+	java.naming.factory.initial
+	= org.apache.qpid.jndi.PropertiesFileInitialContextFactory
+
+	# connectionfactory.[jndiname] = [ConnectionURL]
+	connectionfactory.qpidConnectionfactory
+	= amqp://guest:guest@clientid/test?brokerlist='tcp://localhost:5672'
+	# destination.[jndiname] = [address_string]
+	destination.topicExchange = amq.topic
+	</pre></div></div><br class="example-break"><p>The following sections describe the JNDI properties that Qpid uses.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553812"></a>3.2.1. JNDI Properties for Apache Qpid</h3></div></div></div><p>
+	  Apache Qpid supports the properties shown in the following table:
+        </p><div class="table"><a name="id2553822"></a><p class="title"><b>Table 3.1. JNDI Properties supported by Apache Qpid</b></p><div class="table-contents"><table summary="JNDI Properties supported by Apache Qpid" border="1"><colgroup><col><col></colgroup><thead><tr><th>
+		  Property
+	        </th><th>
+		  Purpose
+	        </th></tr></thead><tbody><tr><td>
+		  connectionfactory.&lt;jndiname&gt;
+	        </td><td>
+		  <p>
+		    The Connection URL that the connection factory uses to perform connections.
+		  </p>
+	        </td></tr><tr><td>
+		  queue.&lt;jndiname&gt;
+	        </td><td>
+		  <p>
+		    A JMS queue, which is implemented as an amq.direct exchange in Apache Qpid.
+		  </p>
+	        </td></tr><tr><td>
+		  topic.&lt;jndiname&gt;
+	        </td><td>
+		  <p>
+		    A JMS topic, which is implemented as an amq.topic exchange in Apache Qpid.
+		  </p>
+	        </td></tr><tr><td>
+		  destination.&lt;jndiname&gt;
+	        </td><td>
+		  <p>
+		    Can be used for defining all amq destinations,
+		    queues, topics and header matching, using an
+		    address string.
+
+		    <sup>[<a name="id2553906" href="#ftn.id2553906" class="footnote">a</a>]</sup>
+		  </p>
+	        </td></tr></tbody><tbody class="footnotes"><tr><td colspan="2"><div class="footnote"><p><sup>[<a name="ftn.id2553906" href="#id2553906" class="para">a</a>] </sup>Binding URLs, which were used in
+		    earlier versions of the Qpid Java JMS client, can
+		    still be used instead of address
+		    strings.</p></div></td></tr></tbody></table></div></div><br class="table-break"></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section-jms-connection-url"></a>3.2.2. Connection URLs</h3></div></div></div><p>
+	  In JNDI properties, a Connection URL specifies properties for a connection. The format for a Connection URL is:
+        </p><pre class="programlisting">amqp://[&lt;user&gt;:&lt;pass&gt;@][&lt;clientid&gt;]&lt;virtualhost&gt;[?&lt;option&gt;='&lt;value&gt;'[&amp;&lt;option&gt;='&lt;value&gt;']]
+        </pre><p>
+	  For instance, the following Connection URL specifies a user name, a password, a client ID, a virtual host ("test"), a broker list with a single broker, and a TCP host with the host name “<span class="quote">localhost</span>” using port 5672:
+        </p><pre class="programlisting">amqp://username:password@clientid/test?brokerlist='tcp://localhost:5672'
+        </pre><p>
+	  Apache Qpid supports the following properties in Connection URLs:
+        </p><div class="table"><a name="id2553964"></a><p class="title"><b>Table 3.2. Connection URL Properties</b></p><div class="table-contents"><table summary="Connection URL Properties" width="100%" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>
+		  Option
+	        </th><th>
+		  Type
+	        </th><th>
+		  Description
+	        </th></tr></thead><tbody><tr><td>
+		  brokerlist
+	        </td><td>
+		  see below
+	        </td><td>
+		  List of one or more broker addresses.
+	        </td></tr><tr><td>
+		  maxprefetch
+	        </td><td>
+		  integer
+	        </td><td>
+		  <p>
+                    The maximum number of pre-fetched messages per consumer. If not specified, default value of 500 is used.
+		  </p>
+		  <p>
+                    Note: You can also set the default per-consumer prefetch value on a client-wide basis by configuring the client using <a class="link" href="ch03s06.html#client-jvm-properties" title="3.6.1. Qpid JVM Arguments">Java system properties.</a>
+		  </p>
+	        </td></tr><tr><td>
+		  sync_publish
+	        </td><td>
+		  {'persistent' | 'all'}
+	        </td><td>
+		  A sync command is sent after every persistent message to guarantee that it has been received; if the value is 'persistent', this is done only for persistent messages.
+	        </td></tr><tr><td>
+		  sync_ack
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  A sync command is sent after every acknowledgement to guarantee that it has been received.
+	        </td></tr><tr><td>
+		  use_legacy_map_msg_format
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  If you are using JMS Map messages and deploying a new client with any JMS client older than 0.8 release, you must set this to true to ensure the older clients can understand the map message encoding.
+	        </td></tr><tr><td>
+		  failover
+	        </td><td>
+		  {'singlebroker' | 'roundrobin' | 'failover_exchange' | 'nofailover' | '&lt;class&gt;'}
+	        </td><td>
+		  <p>
+		    This option controls failover behaviour.  The method <code class="literal">singlebroker</code> uses only the first broker in the list,
+		    <code class="literal">roundrobin</code> will try each broker given in the broker list until a connection is established,
+		    <code class="literal">failover_exchange</code> connects to the initial broker given in the broker URL and will receive membership updates
+		    via the failover exchange. <code class="literal">nofailover</code> disables all retry and failover logic.  Any other value is interpreted as a
+		    classname which must implement the <code class="literal">org.apache.qpid.jms.failover.FailoverMethod</code> interface.
+		  </p>
+		  <p>
+		    The broker list options <code class="literal">retries</code> and <code class="literal">connectdelay</code> (described below) determine the number of times a
+		    connection to a broker will be retried and the the length of time to wait between successive connection attempts before moving on to
+		    the next broker in the list. The failover option <code class="literal">cyclecount</code> controls the number of times to loop through the list of
+		    available brokers before finally giving up.
+		  </p>
+		  <p>
+		    Defaults to <code class="literal">roundrobin</code> if the brokerlist contains multiple brokers, or <code class="literal">singlebroker</code> otherwise.
+		  </p>
+	        </td></tr></tbody></table></div></div><br class="table-break"><p>
+	  Broker lists are specified using a URL in this format:
+        </p><pre class="programlisting">brokerlist=&lt;transport&gt;://&lt;host&gt;[:&lt;port&gt;](?&lt;param&gt;='&lt;value&gt;')(&amp;&lt;param&gt;='&lt;value&gt;')*</pre><p>
+	  For instance, this is a typical broker list:
+        </p><pre class="programlisting">brokerlist='tcp://localhost:5672'
+        </pre><p>
+	  A broker list can contain more than one broker address; if so, the connection is made to the first broker in the list that is available. In general, it is better to use the failover exchange when using multiple brokers, since it allows applications to fail over if a broker goes down.
+	</p><div class="example"><a name="id2554213"></a><p class="title"><b>Example 3.4. Broker Lists</b></p><div class="example-contents"><p>A broker list can specify properties to be used when connecting to the broker, such as security options. This broker list specifies options for a Kerberos connection using GSSAPI:</p><pre class="programlisting">
+	  amqp://guest:guest@test/test?sync_ack='true'
+	  &amp;brokerlist='tcp://ip1:5672?sasl_mechs='GSSAPI''
+	  </pre><p>This broker list specifies SSL options:</p><pre class="programlisting">
+	  amqp://guest:guest@test/test?sync_ack='true'
+	  &amp;brokerlist='tcp://ip1:5672?ssl='true'&amp;ssl_cert_alias='cert1''
+	  </pre><p>
+	    This broker list specifies two brokers using the connectdelay and retries broker options. It also illustrates the failover connection URL
+	    property.
+	  </p><pre class="programlisting">
+
+	  amqp://guest:guest@/test?failover='roundrobin?cyclecount='2''
+	  &amp;brokerlist='tcp://ip1:5672?retries='5'&amp;connectdelay='2000';tcp://ip2:5672?retries='5'&amp;connectdelay='2000''
+	  </pre></div></div><br class="example-break"><p>The following broker list options are supported.</p><div class="table"><a name="id2554263"></a><p class="title"><b>Table 3.3. Broker List Options</b></p><div class="table-contents"><table summary="Broker List Options" width="100%" border="1"><colgroup><col><col><col></colgroup><thead><tr><th>
+		  Option
+	        </th><th>
+		  Type
+	        </th><th>
+		  Description
+	        </th></tr></thead><tbody><tr><td>
+		  heartbeat
+	        </td><td>
+		  integer
+	        </td><td>
+		  frequency of heartbeat messages (in seconds)
+	        </td></tr><tr><td>
+		  sasl_mechs
+	        </td><td>
+		  --
+	        </td><td>
+		  For secure applications, we suggest CRAM-MD5,
+		  DIGEST-MD5, or GSSAPI. The ANONYMOUS method is not
+		  secure. The PLAIN method is secure only when used
+		  together with SSL. For Kerberos, sasl_mechs must be
+		  set to GSSAPI, sasl_protocol must be set to the
+		  principal for the qpidd broker, e.g. qpidd/, and
+		  sasl_server must be set to the host for the SASL
+		  server, e.g. sasl.com.  SASL External is supported
+		  using SSL certification, e.g.
+		  <code class="literal">ssl='true'&amp;sasl_mechs='EXTERNAL'</code>
+	        </td></tr><tr><td>
+		  sasl_encryption
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  If <code class="literal">sasl_encryption='true'</code>, the JMS client attempts to negotiate a security layer with the broker using GSSAPI to encrypt the connection. Note that for this to happen, GSSAPI must be selected as the sasl_mech.
+	        </td></tr><tr><td>
+		  sasl_protocol
+	        </td><td>
+		  --
+	        </td><td>
+		  Used only for
+		  Kerberos. <code class="literal">sasl_protocol</code> must be
+		  set to the principal for the qpidd broker,
+		  e.g. <code class="literal">qpidd/</code>
+	        </td></tr><tr><td>
+		  sasl_server
+	        </td><td>
+		  --
+	        </td><td>
+		  For Kerberos, sasl_mechs must be set to GSSAPI,
+		  sasl_server must be set to the host for the SASL
+		  server, e.g. <code class="literal">sasl.com</code>.
+	        </td></tr><tr><td>
+		  trust_store
+	        </td><td>
+		  --
+	        </td><td>
+		  path to trust store
+	        </td></tr><tr><td>
+		  trust_store_password
+	        </td><td>
+	        </td><td>
+		  Trust store password
+	        </td></tr><tr><td>
+		  key_store
+	        </td><td>
+	        </td><td>
+		  path to key store
+	        </td></tr><tr><td>
+		  key_store_password
+	        </td><td>
+		  --
+	        </td><td>
+		  key store password
+	        </td></tr><tr><td>
+		  ssl
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  If <code class="literal">ssl='true'</code>, the JMS client will encrypt the connection using SSL.
+	        </td></tr><tr><td>
+		  ssl_verify_hostname
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  When using SSL you can enable hostname verification
+		  by using <code class="literal">ssl_verify_hostname='true'</code> in the broker
+		  URL.
+	        </td></tr><tr><td>
+		  ssl_cert_alias
+	        </td><td>
+
+	        </td><td>
+		  If multiple certificates are present in the keystore, the alias will be used to extract the correct certificate.
+	        </td></tr><tr><td>
+		  retries
+	        </td><td>
+		  integer
+	        </td><td>
+		  The number of times to retry connection to each broker in the broker list. Defaults to 1.
+	        </td></tr><tr><td>
+		  connectdelay
+	        </td><td>
+		  integer
+	        </td><td>
+		  Length of time to wait before attempting to reconnect (in milliseconds). Defaults to 0.
+	        </td></tr><tr><td>
+		  connecttimeout
+	        </td><td>
+		  integer
+	        </td><td>
+		  Length of time to wait for the connection to succeed (in milliseconds).  Defaults to 30000.
+	        </td></tr><tr><td>
+		  tcp_nodelay
+	        </td><td>
+		  Boolean
+	        </td><td>
+		  If <code class="literal">tcp_nodelay='true'</code>, TCP packet
+		  batching is disabled. Defaults to true since Qpid 0.14.
+	        </td></tr></tbody></table></div></div><br class="table-break"></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="QpidJMS.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="QpidJMS.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Using the Qpid JMS client </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 3.3. Java JMS Message Properties</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