activemq-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jstrac...@apache.org
Subject svn commit: r374430 [5/45] - /incubator/activemq/site/
Date Thu, 02 Feb 2006 16:33:52 GMT
Added: incubator/activemq/site/ActiveMQ+Command+Line+Tools+Reference
URL: http://svn.apache.org/viewcvs/incubator/activemq/site/ActiveMQ%2BCommand%2BLine%2BTools%2BReference?rev=374430&view=auto
==============================================================================
--- incubator/activemq/site/ActiveMQ+Command+Line+Tools+Reference (added)
+++ incubator/activemq/site/ActiveMQ+Command+Line+Tools+Reference Thu Feb  2 08:31:10 2006
@@ -0,0 +1,910 @@
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <link rel="stylesheet" href="site.css" type="text/css">
+
+
+
+    <title>ActiveMQ - ActiveMQ Command Line Tools Reference</title>
+  </head>
+
+  <body>
+    <table width="100%" id="layout" style="padding:0px;margin0px;border-collapse:collapse;">
+      <tr>
+        <td colspan="3" style="padding:8px;">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr id="header_row">
+              <td align="left" valign="middle" style="padding:0px;margin:0px;">
+                <span id="Content"><span><span class="nobr"><a href="http://incubator.apache.org/activemq" rel="nofollow"><img align="absmiddle" border=0 src="images/logo.gif"></a></span></span></span>
+
+              </td>
+              
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="breadcrumbs">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr>
+              <td align="left">
+                <a href="">Home</a>  | <a href="FAQ">FAQ</a> &gt; <a href="Using+ActiveMQ">Using&nbsp;ActiveMQ</a> &gt; ActiveMQ Command Line Tools Reference
+              </td>
+              <td align="right">
+                  <span id="Content"><span><a href="Download" title="Download">Download</a> | <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/" rel="nofollow">JavaDocs for 4.x</a></span> <span class="nobr"><a href="http://activemq.org/maven/activemq-3/activemq-core/apidocs/" rel="nofollow">3.x</a></span> | <a href="Source" title="Source">Source</a> | <span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span> |<span class="nobr"><a href="irc://irc.codehaus.org/activemq" rel="nofollow">IRC</a></span> | <span class="nobr"><a href="http://servlet.uwyn.com/drone/log/hausbot/activemq" rel="nofollow">IRC Log</a></span> | <a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a> | <span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span> | <span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Support
 </a></span></span></span>
+
+              </td>
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td id="leftColumn" valign="top" style="padding-top: 0px;">
+          <span id="Content"><h3><a name="Navigation-Overview"></a>Overview</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Home" title="Home">Home</a></li>
+    <li><a href="News" title="News">News</a></li>
+    <li><a href="Changes+in+4.0" title="Changes in 4.0">New in 4.0</a></li>
+    <li><a href="FAQ" title="FAQ">FAQ</a></li>
+    <li><a href="Articles" title="Articles">Articles</a></li>
+    <li><a href="Download" title="Download">Download</a></li>
+  </ul>
+  <h3><a name="Navigation-Community"></a>Community</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span></li>
+    <li><a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a></li>
+    <li><span class="nobr"><a href="http://gmane.org/find.php?list=activemq" rel="nofollow">News Reader</a></span></li>
+    <li><span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span></li>
+    <li><a href="Projects+Using+ActiveMQ" title="Projects Using ActiveMQ">Projects Using ActiveMQ</a></li>
+    <li><a href="Users" title="Users">Users</a></li>
+    <li><a href="Contributing" title="Contributing">Contributing</a></li>
+    <li><a href="Team" title="Team">Team</a></li>
+  </ul>
+  <h3><a name="Navigation-UsingActiveMQ"></a>Using ActiveMQ</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Getting+Started" title="Getting Started">Getting Started</a></li>
+    <li><a href="Installation" title="Installation">Installation</a></li>
+    <li><a href="Building" title="Building">Building</a></li>
+    <li><a href="Run+Broker" title="Run Broker">Running a Broker</a></li>
+    <li><a href="Examples" title="Examples">Examples</a></li>
+    <li><a href="How+can+I+monitor+ActiveMQ" title="How can I monitor ActiveMQ">Monitoring the Broker</a></li>
+    <li><a href="Xml+Configuration" title="Xml Configuration">Xml Configuration</a></li>
+    <li><a href="Xml+Reference" title="Xml Reference">Xml Reference</a></li>
+    <li><a href="Use+Cases" title="Use Cases">Use Cases</a></li>
+    <li><a href="Topologies" title="Topologies">Topologies</a></li>
+    <li><a href="Configuring+Transports" title="Configuring Transports">Configuring Transports</a></li>
+    <li><a href="How+do+I+embed+a+Broker+inside+a+Connection" title="How do I embed a Broker inside a Connection">Embedded Brokers</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">Performance Testing</a></li>
+    <li><a href="Web+Samples" title="Web Samples">Web Samples</a></li>
+    <li><a href="Hello+World" title="Hello World">Hello World</a></li>
+  </ul>
+  <h3><a name="Navigation-Features"></a>Features</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JMX" title="JMX">JMX</a></li>
+    <li><a href="Performance" title="Performance">Performance</a></li>
+    <li><a href="Protocols" title="Protocols">Protocols</a></li>
+    <li><a href="Persistence" title="Persistence">Persistence</a></li>
+    <li><a href="JDBC+Support" title="JDBC Support">JDBC Support</a></li>
+    <li><a href="Clustering" title="Clustering">Clustering</a></li>
+    <li><a href="Discovery" title="Discovery">Discovery</a></li>
+    <li><a href="Networks+of+Brokers" title="Networks of Brokers">Networks of Brokers</a></li>
+    <li><a href="Composite+Destinations" title="Composite Destinations">Composite Destinations</a></li>
+    <li><a href="JMS+Streams" title="JMS Streams">JMS Streams</a></li>
+    <li><a href="Advisory+Message" title="Advisory Message">Advisory Message</a></li>
+    <li><a href="Resource+Adapter" title="Resource Adapter">JCA 1.5 Resource Adapter</a></li>
+  </ul>
+  <h3><a name="Navigation-Connectivitiy"></a>Connectivitiy</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Ajax" title="Ajax">Ajax</a></li>
+    <li><a href="Axis+Support" title="Axis Support">Axis Support</a></li>
+    <li><a href="C+Integration" title="C Integration">C Integration</a></li>
+    <li><a href="dot+Net" title="dot Net">.Net Integration</a></li>
+    <li><a href="Geronimo" title="Geronimo">Geronimo</a></li>
+    <li><a href="J2EE" title="J2EE">J2EE</a></li>
+    <li><a href="JBoss+Integration" title="JBoss Integration">JBoss Integration</a></li>
+    <li><a href="JNDI+Support" title="JNDI Support">JNDI Support</a></li>
+    <li><a href="OpenWire" title="OpenWire">OpenWire</a></li>
+    <li><a href="REST" title="REST">REST</a></li>
+    <li><a href="Spring+Support" title="Spring Support">Spring Support</a></li>
+    <li><a href="Stomp" title="Stomp">Stomp</a></li>
+    <li><a href="Tomcat" title="Tomcat">Tomcat</a></li>
+    <li><a href="WSIF" title="WSIF">WSIF</a></li>
+  </ul>
+  <h3><a name="Navigation-Utilities"></a>Utilities</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JCA+Container" title="JCA Container">JCA Container</a></li>
+  </ul>
+  <h3><a name="Navigation-ExternalTools"></a>External Tools</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Hermes+Jms" title="Hermes Jms">Hermes Jms</a></li>
+    <li><a href="Sun+JNDI" title="Sun JNDI">Sun JNDI</a></li>
+    <li><span class="nobr"><a href="http://jakarta.apache.org/jmeter" rel="nofollow">JMeter</a></span></li>
+  </ul>
+  <h3><a name="Navigation-RelatedProjects"></a>Related Projects</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://servicemix.org/" rel="nofollow">ServiceMix</a></span></li>
+    <li><span class="nobr"><a href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a></span></li>
+    <li><span class="nobr"><a href="http://jencks.org/" rel="nofollow">Jencks</a></span></li>
+    <li><span class="nobr"><a href="http://stomp.codehaus.org/" rel="nofollow">Stomp</a></span></li>
+    <li><span class="nobr"><a href="http://activecluster.codehaus.org/" rel="nofollow">ActiveCluster</a></span></li>
+    <li><span class="nobr"><a href="http://activespace.codehaus.org/" rel="nofollow">ActiveSpace</a></span></li>
+    <li><span class="nobr"><a href="http://activesoap.codehaus.org/" rel="nofollow">ActiveSOAP</a></span></li>
+    <li><span class="nobr"><a href="http://www.springframework.org/" rel="nofollow">Spring</a></span></li>
+    <li><span class="nobr"><a href="http://geronimo.apache.org/" rel="nofollow">Geronimo</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Support"></a>Support</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Issues</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:roadmap-panel" rel="nofollow">Roadmap</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:changelog-panel" rel="nofollow">Change log</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Developers"></a>Developers</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Source" title="Source">Source</a></li>
+    <li><a href="Code+Overview" title="Code Overview">Code Overview</a></li>
+    <li><a href="Wire+Protocol" title="Wire Protocol">Wire Protocol</a></li>
+    <li><a href="ActiveMQ+4.0" title="ActiveMQ 4.0">ActiveMQ 4.0</a></li>
+    <li><a href="Becoming+a+committer" title="Becoming a committer">Becoming a committer</a></li>
+    <li><a href="Integration+Tests" title="Integration Tests">Integration Tests</a></li>
+    <li><a href="Benchmark+Tests" title="Benchmark Tests">Benchmark Tests</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">JMeter Performance Tests</a></li>
+    <li><a href="Release+Guide" title="Release Guide">Release Guide</a></li>
+    <li><a href="JUnit+Reports" title="JUnit Reports">JUnit Reports</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/clover/" rel="nofollow">Clover Report</a></span></li>
+    <li><a href="Source+XRef" title="Source XRef">Source XRef</a></li>
+    <li><a href="Test+Source+XRef" title="Test Source XRef">Test Source XRef</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/activemq.xsd.html" rel="nofollow">XSD</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Toolsweuse"></a>Tools we use</h3><span><span class="nobr"><a href="http://www.yourkit.com" rel="nofollow"><img align="absmiddle" border=0 src="/download/attachments/23786/yourkit.jpg"></a></span></span></span>
+
+            <h3 class="heading3">Feeds</h3>
+            <table border="0" cellspacing="4px">
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a><br/>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false">Site</a>
+              </td>
+            </tr>
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ">News</a>
+              </td>
+            </tr>
+            </table>
+        </td>
+        <td id="rightColumn" valign="top">
+
+          <div id="page_title">
+            <table width="100%">
+              <tr>
+                <td>
+            ActiveMQ Command Line Tools Reference 
+                </td>
+                <td align="right">
+            
+                </td>
+              </tr>
+            </table>
+          </div>
+
+
+          <div>
+  <div id="Content">
+    <h1><a name="ActiveMQCommandLineToolsReference-CommandLineTools"></a>Command Line Tools</h1>
+    <ul>
+      <li><a href="#ActiveMQCommandLineToolsReference-activemq">activemq</a> - runs an activemq broker</li>
+      <li><a href="#ActiveMQCommandLineToolsReference-shutdown">shutdown</a> - shutdowns an activemq broker</li>
+      <li><a href="#ActiveMQCommandLineToolsReference-list">list</a> - lists all running brokers in the specified JMX context</li>
+      <li><a href="#ActiveMQCommandLineToolsReference-query">query</a> - queries the JMX context for broker statistics and information</li>
+      <li><a href="#ActiveMQCommandLineToolsReference-bstat">bstat</a> - predefined query that displays useful broker statistics</li>
+      <li><a href="#ActiveMQCommandLineToolsReference-browse">browse</a> - browse the messages of a specific queue</li>
+    </ul>
+    <p><a name="ActiveMQCommandLineToolsReference-activemq"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-activemqscript"></a>activemq script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> activemq.bat, activemq </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>activemq [options] [config]</em> or <em>java -jar run.jar start [options] [config]</em></td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Script to run an activemq broker either by specifying a broker configuration file or through a broker URI configuration. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Options:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Option Name </th>
+            <th class="confluenceTh"> Syntax </th>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> System Define Option </td>
+            <td class="confluenceTd"> -D&lt;key&gt;=&lt;value&gt; </td>
+            <td class="confluenceTd"> -Dactivemq.home=c:/ActiveMQ </td>
+            <td class="confluenceTd"> Sets a systems property. i.e Systems.getProperty(&quot;activemq.home&quot;); will return c:/ActiveMQ </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Help Option </td>
+            <td class="confluenceTd"> -h or -? or --help </td>
+            <td class="confluenceTd"> activemq --help </td>
+            <td class="confluenceTd"> Display the help messages for the activemq script. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Version Option </td>
+            <td class="confluenceTd"> --version </td>
+            <td class="confluenceTd"> activemq --version </td>
+            <td class="confluenceTd"> Display the activemq version information. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq </td>
+            <td class="confluenceTd"> Runs a broker using the default 'xbean:activemq.xml' as the broker configuration file. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq xbean:myconfig.xml </td>
+            <td class="confluenceTd"> Runs a broker using the file myconfig.xml as the broker configuration file that is located in the classpath. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq xbean:<span class="nobr"><a href="file:./conf/broker1.xml" rel="nofollow">file:./conf/broker1.xml</a></span></td>
+            <td class="confluenceTd"> Runs a broker using the file broker1.xml as the broker configuration file that is located in the relative file path ./conf/broker1.xml </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq xbean:<span class="nobr"><a href="file:C:/ActiveMQ/conf/broker2.xml" rel="nofollow">file:C:/ActiveMQ/conf/broker2.xml</a></span></td>
+            <td class="confluenceTd"> Runs a broker using the file broker2.xml as the broker configuration file that is located in the absolute file path C:/ActiveMQ/conf/broker2.xml </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq broker:(tcp://localhost:61616, tcp://localhost:5000)?useJmx=true </td>
+            <td class="confluenceTd"> Runs a broker with two transport connectors and JMX enabled.&Acirc;&sup1; <br clear="all">
+            </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> activemq broker:(tcp://localhost:61616, network:tcp://localhost:5000)?persistent=false </td>
+            <td class="confluenceTd"> Runs a broker with 1 transport connector and 1 network connector with persistence disabled.&Acirc;&sup1; </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p>&Acirc;&sup1; For details on how to configure using broker URI refer to:&nbsp;<a href="Broker+Configuration+URI" title="Broker Configuration URI">Broker Configuration URI</a></p>
+    <p><a name="ActiveMQCommandLineToolsReference-shutdown"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-shutdownscript"></a>shutdown script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> shutdown.bat, shutdown </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>shutdown [options] [broker names]</em> or <em>java -jar run.jar stop [options] [broker names]</em></td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Script to stop a running activemq broker. This script requires that JMX is enabled. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Options:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Option Name </th>
+            <th class="confluenceTh"> Syntax </th>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Stop All Option </td>
+            <td class="confluenceTd"> --all </td>
+            <td class="confluenceTd"> shutdown --all </td>
+            <td class="confluenceTd"> Stops all registered brokers in the specified JMX context </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMX URL Option </td>
+            <td class="confluenceTd"> --jmxurl &lt;url&gt; </td>
+            <td class="confluenceTd"> --jmxurl service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi </td>
+            <td class="confluenceTd"> Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> System Define Option </td>
+            <td class="confluenceTd"> -D&lt;key&gt;=&lt;value&gt; </td>
+            <td class="confluenceTd"> -Dactivemq.home=c:/ActiveMQ </td>
+            <td class="confluenceTd"> Sets a systems property. i.e Systems.getProperty(&quot;activemq.home&quot;); will return c:/ActiveMQ </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Help Option </td>
+            <td class="confluenceTd"> -h or -? or --help </td>
+            <td class="confluenceTd"> --help </td>
+            <td class="confluenceTd"> Display the help messages for the shutdown script. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Version Option </td>
+            <td class="confluenceTd"> --version </td>
+            <td class="confluenceTd"> activemq --version </td>
+            <td class="confluenceTd"> Display the activemq version information. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> shutdown </td>
+            <td class="confluenceTd"> Stops the only running broker in the default JMX context. It assumes that there is only one running broker. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> shutdown --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi --all </td>
+            <td class="confluenceTd"> Stops all the running broker in the specified JMX context. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> shutdown localhost </td>
+            <td class="confluenceTd"> Stops the broker named 'localhost' in the default JMX context. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> shutdown localhost remotehost </td>
+            <td class="confluenceTd"> Stops the brokers 'localhost' and 'remotehost' in the default JMX context. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><a name="ActiveMQCommandLineToolsReference-list"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-listscript"></a>list script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> list.bat, list </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>list [options]</em> or <em>java -jar run.jar list [options]</em></td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Script to list the names of all running brokers in the specified JMX context. This script requires that JMX is enabled. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Options:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Option Name </th>
+            <th class="confluenceTh"> Syntax </th>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMX URL Option </td>
+            <td class="confluenceTd"> --jmxurl &lt;url&gt; </td>
+            <td class="confluenceTd"> --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi </td>
+            <td class="confluenceTd"> Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> System Define Option </td>
+            <td class="confluenceTd"> -D&lt;key&gt;=&lt;value&gt; </td>
+            <td class="confluenceTd"> -Dactivemq.home=c:/ActiveMQ </td>
+            <td class="confluenceTd"> Sets a systems property. i.e Systems.getProperty(&quot;activemq.home&quot;); will return c:/ActiveMQ </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Help Option </td>
+            <td class="confluenceTd"> -h or -? or --help </td>
+            <td class="confluenceTd"> --help </td>
+            <td class="confluenceTd"> Display the help messages for the list script. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Version Option </td>
+            <td class="confluenceTd"> --version </td>
+            <td class="confluenceTd"> activemq --version </td>
+            <td class="confluenceTd"> Display the activemq version information. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> list </td>
+            <td class="confluenceTd"> Lists the names of all running brokers in the default JMX context. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> list --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi </td>
+            <td class="confluenceTd"> List the names of all running brokers in the specified JMX context. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><a name="ActiveMQCommandLineToolsReference-query"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-queryscript"></a>query script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> query.bat, query </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>query [options]</em> or <em>java -jar run.jar query [options]</em></td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Script to query the specified JMX context for mbean attributes and information. This script requires that JMX is enabled. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Options:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Option Name </th>
+            <th class="confluenceTh"> Syntax </th>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Predefined Query Option </td>
+            <td class="confluenceTd"> -Q&lt;type&gt;=&lt;name&gt; </td>
+            <td class="confluenceTd"> -QTopic=TEST.FOO, -QBroker=*host </td>
+            <td class="confluenceTd"> Predefined object name query option that queries a specific type of mbean object based on its type and selected identifier. Refer to the mbean reference table below for details. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd">&nbsp;</td>
+            <td class="confluenceTd"> -xQ&lt;type&gt;=&lt;name&gt; </td>
+            <td class="confluenceTd"> -xQTopic=ActiveMQ.Advisory.*, -xQNetworkConnector=* </td>
+            <td class="confluenceTd"> Predefined object name query option that removes all mbeans that matches the query from the search result. Refer to the mbean reference table below for details. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Object Name Query Option </td>
+            <td class="confluenceTd"> --objname &lt;object name query&gt; </td>
+            <td class="confluenceTd"> --objname Type=<b>Connect</b>,BrokerName=local* </td>
+            <td class="confluenceTd"> Query option loosely based on the JMX object name format, which lets you filter mbeans based on their object name information. Refer to the mbean reference table below for details. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd">&nbsp;</td>
+            <td class="confluenceTd"> --xobjname &lt;object name query&gt; </td>
+            <td class="confluenceTd"> --xobjname Type=Topic,Destination=ActiveMQ.Advisory.* </td>
+            <td class="confluenceTd"> Object name query that removes all mbeans that matches the query from the search result. Refer to the mbean reference table below for details. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> View Option </td>
+            <td class="confluenceTd"> --view &lt;view list&gt; </td>
+            <td class="confluenceTd"> --view Type,BrokerName,Destination,EnqueueCount,DequeueCount </td>
+            <td class="confluenceTd"> Lets you specify the attributes and object name information to view. If the view is omitted, all attributes and information will be displayed. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMX URL Option </td>
+            <td class="confluenceTd"> --jmxurl &lt;url&gt; </td>
+            <td class="confluenceTd"> --jmxurl service:jmx:rmi:///jndi/rmi://remotehost:1099/jmxrmi </td>
+            <td class="confluenceTd"> Change the JMX service url to connect to. By default it connects to: service:jmx:rmi:///jndi/rmi://localhost:1099/jmxrmi </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> System Define Option </td>
+            <td class="confluenceTd"> -D&lt;key&gt;=&lt;value&gt; </td>
+            <td class="confluenceTd"> -Dactivemq.home=c:/ActiveMQ </td>
+            <td class="confluenceTd"> Sets a systems property. i.e Systems.getProperty(&quot;activemq.home&quot;); will return c:/ActiveMQ </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Help Option </td>
+            <td class="confluenceTd"> -h or -? or --help </td>
+            <td class="confluenceTd"> --help </td>
+            <td class="confluenceTd"> Display the help messages for the query script. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Version Option </td>
+            <td class="confluenceTd"> --version </td>
+            <td class="confluenceTd"> activemq --version </td>
+            <td class="confluenceTd"> Display the activemq version information. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query </td>
+            <td class="confluenceTd"> Display all attributes and object name information of all registered mbeans in the default JMX context. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query -QTopic=TEST.FOO </td>
+            <td class="confluenceTd"> Display all the attributes and object name information of the destination topic 'TEST.FOO' </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query -QQueue=* </td>
+            <td class="confluenceTd"> Display all the attributes and object name information of all registered queues. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query -QTopic=*.FOO -xQTopic=ActiveMQ.Advisory.* </td>
+            <td class="confluenceTd"> Display all the attributes and object name information of all topics that ends with '.FOO' except those that also begins with 'ActiveMQ.Advisory.'. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query -QBroker=local???? --view Type,BrokerName,EnqueueCount,DequeueCount </td>
+            <td class="confluenceTd"> Display the object type, broker name, enqueue count, and dequeue count information for all 9-letter brokers that begins with 'local'. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query --objname Type=<b>Connect</b>,BrokerName=localhost -xQNetworkConnector=* </td>
+            <td class="confluenceTd"> Display all the attributes and object name information for all connections and connectors for broker 'localhost' except its network connectors. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query --objname Type=Connection --xobjname Type=Connection,BrokerName=localhost </td>
+            <td class="confluenceTd"> Display all the attributes and object name information for all registered connections except those belonging to broker 'localhost'. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> query -QQueue=???? --objname Type=Connection --xobjname BrokerName=remote* </td>
+            <td class="confluenceTd"> Display all the attributes and object name information for all 4-letter queues and connections except those belonging to a broker that begins with 'remote'. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>ActiveMQ MBean Reference:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Mbean Type <br clear="all">
+            </th>
+            <th class="confluenceTh"> Properties / ObjectName </th>
+            <th class="confluenceTh"> Attributes </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Broker </td>
+            <td class="confluenceTd">
+              <ul>
+                <li><b>Type</b>=Broker</li>
+                <li><b>BrokerName</b>=&lt;broker identifier&gt;</li>
+              </ul>
+            </td>
+            <td class="confluenceTd">
+              <ul>
+                <li>BrokerId</li>
+                <li>TotalEnqueueCount</li>
+                <li>TotalDequeueCount</li>
+                <li>TotalConsumerCount</li>
+                <li>TotalMessages</li>
+                <li>TotalMessagesCached</li>
+                <li>MemoryLimit</li>
+                <li>MemoryPercentageUsed</li>
+              </ul>
+            </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Destination </td>
+            <td class="confluenceTd">
+              <ul>
+                <li><b>Type</b>=Queue|Topic</li>
+                <li><b>Destination</b>=&lt;destination identifier&gt;</li>
+                <li><b>BrokerName</b>=&lt;name of broker&gt;</li>
+              </ul>
+            </td>
+            <td class="confluenceTd">
+              <ul>
+                <li>EnqueueCount</li>
+                <li>DequeueCount</li>
+                <li>ConsumerCount</li>
+                <li>Messages</li>
+                <li>MessagesCached</li>
+              </ul>
+            </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> NetworkConnector </td>
+            <td class="confluenceTd">
+              <ul>
+                <li><b>Type</b>=NetworkConnector</li>
+                <li><b>BrokerName</b>=&lt;connector identifierr&gt;</li>
+              </ul>
+            </td>
+            <td class="confluenceTd">
+              <br clear="all">
+            </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Connector </td>
+            <td class="confluenceTd">
+              <ul>
+                <li><b>Type</b>=Connector</li>
+                <li><b>ConnectorName</b>=&lt;connector identifier&gt;</li>
+                <li><b>BrokerName</b>=&lt;name of broker&gt;</li>
+              </ul>
+            </td>
+            <td class="confluenceTd">
+              <ul>
+                <li>EnqueueCount</li>
+                <li>DequeueCount</li>
+              </ul>
+            </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Connection </td>
+            <td class="confluenceTd">
+              <ul>
+                <li><b>Type</b>=Connection</li>
+                <li><b>Connection</b>=&lt;connection identifier&gt;</li>
+                <li><b>BrokerName</b>=&lt;name of broker&gt;</li>
+              </ul>
+            </td>
+            <td class="confluenceTd">
+              <ul>
+                <li>EnqueueCount</li>
+                <li>DequeueCount</li>
+                <li>DispatchQueueSize</li>
+                <li>Active</li>
+                <li>Blocked</li>
+                <li>Connected</li>
+                <li>Slow</li>
+              </ul>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><a name="ActiveMQCommandLineToolsReference-bstat"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-bstatscript"></a>bstat script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> bstat.bat, bstat </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>bstat</em> [broker name] </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Predefined query script that displays useful statistics regarding a broker and its components. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> bstat </td>
+            <td class="confluenceTd"> Display useful statistics for all registered brokers in the default JMX context. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> bstat localhost </td>
+            <td class="confluenceTd"> Display useful statistics for the registered broker 'localhost'. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><a name="ActiveMQCommandLineToolsReference-browse"></a></p>
+    <h2><a name="ActiveMQCommandLineToolsReference-browsescript"></a>browse script</h2>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Script Name </th>
+            <td class="confluenceTd"> browse.bat, browse </td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Task Usage </th>
+            <td class="confluenceTd"><em>browse --amqurl &lt;broker url&gt; [options] &lt;destinations&gt;</em> or <em>java -jar run.jar browse --amqurl &lt;broker url&gt; [options] &lt;destinations&gt;</em></td>
+          </tr>
+          <tr>
+            <th class="confluenceTh"> Description </th>
+            <td class="confluenceTd"> Script to browse selected destinations' messages. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Options:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Option Name </th>
+            <th class="confluenceTh"> Syntax </th>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Broker URL Option </td>
+            <td class="confluenceTd"> --amqurl &lt;url&gt; </td>
+            <td class="confluenceTd"> --amqurl tcp://localhost:61616 </td>
+            <td class="confluenceTd"> Specify the broker URL to connect to. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Message Selector Option </td>
+            <td class="confluenceTd"> --msgsel &lt;msgsel1,msgsel2,...&gt; </td>
+            <td class="confluenceTd"> --msgsel JMSMessageID='*:10',JMSPriority&gt;5 </td>
+            <td class="confluenceTd"> Allows you to filter the specific messages to view. You can use wildcard queries by enclosing the string message property in ' '. Other than using wildcard queries to filter string properties, other queries follows the message selector format. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Group View Option </td>
+            <td class="confluenceTd"> -V[header | custom | body] </td>
+            <td class="confluenceTd"> -Vheader, -Vcustom, -Vbody </td>
+            <td class="confluenceTd"> Let's you specify a specific group of message attributes to view. The header view shows all the standard JMS message headers. The custom view shows all the custom fields added to each JMS message. The body view shows the message body of the JMS message. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Specific View Option </td>
+            <td class="confluenceTd"> --view &lt;attr1&gt;,[header:|custom:]&lt;attr2&gt;,... </td>
+            <td class="confluenceTd"> --view JMSMessageID='*:10',custom:MyCustomField </td>
+            <td class="confluenceTd"> Let's you specifically select a specific message attribute. It allows you to select specific attributes from the JMS and custom headers. You could add the tags header: and custom: to explicitly specify where the attribute belongs to. Refer to the message header table below for details. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> System Define Option </td>
+            <td class="confluenceTd"> -D&lt;key&gt;=&lt;value&gt; </td>
+            <td class="confluenceTd"> -Dactivemq.home=c:/ActiveMQ </td>
+            <td class="confluenceTd"> Sets a systems property. i.e Systems.getProperty(&quot;activemq.home&quot;); will return c:/ActiveMQ </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Help Option </td>
+            <td class="confluenceTd"> -h or -? or --help </td>
+            <td class="confluenceTd"> --help </td>
+            <td class="confluenceTd"> Display the help messages for the browse script. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> Version Option </td>
+            <td class="confluenceTd"> --version </td>
+            <td class="confluenceTd"> activemq --version </td>
+            <td class="confluenceTd"> Display the activemq version information. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>Examples:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Example </th>
+            <th class="confluenceTh"> Description </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> browse --amqurl tcp://localhost:61616 TEST.FOO </td>
+            <td class="confluenceTd"> Prints the JMS message header, custom message header, and message body of all the messages in the queue 'TEST.FOO' </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> browse --amqurl tcp://localhost:61616 -Vheader,body TEST.FOO </td>
+            <td class="confluenceTd"> Prints the JMS message header and message body of all the messages in the queue 'TEST.FOO' </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> browse --amqurl tcp://localhost:61616 -Vheader --view custom:MyCustomField TEST.FOO TEST.BAR </td>
+            <td class="confluenceTd"> Prints all the JMS message header and the custom field 'MyCustomField' of all the messages in the queue 'TEST.FOO' and 'TEST.BAR'. </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> browse --amqurl tcp://localhost:61616 --msgsel JMSMessageID='*:10',JMSPriority&gt;5 TEST.FOO </td>
+            <td class="confluenceTd"> Prints all the attributes of the messages in the queue 'TEST.FOO' that has a JMSMessageID that matches the wildcard query *:10 and has a JMSPriority greater than 5. </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+    <p><b>JMS Message Header Reference:</b></p>
+    <p class="paragraph">
+      <table class="confluenceTable">
+        <tbody>
+          <tr>
+            <th class="confluenceTh"> Header Name </th>
+            <th class="confluenceTh"> Header Type </th>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSCorrelation ID </td>
+            <td class="confluenceTd"> String </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSDelivery Mode </td>
+            <td class="confluenceTd"> int (1-Non-Persistent, 2-Persistent) </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSDestination </td>
+            <td class="confluenceTd"> javax.jms.Destination </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSExpiration </td>
+            <td class="confluenceTd"> long </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSMessageID </td>
+            <td class="confluenceTd"> String </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSPriority </td>
+            <td class="confluenceTd"> int </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSRedelivered </td>
+            <td class="confluenceTd"> boolean </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSReplyTo </td>
+            <td class="confluenceTd"> javax.jms.Destination </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSTimestamp </td>
+            <td class="confluenceTd"> long </td>
+          </tr>
+          <tr>
+            <td class="confluenceTd"> JMSType </td>
+            <td class="confluenceTd"> String </td>
+          </tr>
+        </tbody>
+      </table>
+    </p>
+  </div>
+</div>
+
+          &nbsp;
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="footer">
+          <table width="100%"> 
+            <tr>
+              <td align="left" valign="top">
+          
+              </td>
+              <td align="right" valign="top">
+          <a style="color:#999;" href="http://docs.codehaus.org/pages/editpage.action?spaceKey=ACTIVEMQ&title=ActiveMQ+Command+Line+Tools+Reference">[ edit ]</a>
+              </td>
+            </tr>
+          <table>
+        </td>
+      </tr>
+    </table>
+  </body>
+
+</html>
+
+

Added: incubator/activemq/site/Advisory+Message
URL: http://svn.apache.org/viewcvs/incubator/activemq/site/Advisory%2BMessage?rev=374430&view=auto
==============================================================================
--- incubator/activemq/site/Advisory+Message (added)
+++ incubator/activemq/site/Advisory+Message Thu Feb  2 08:31:10 2006
@@ -0,0 +1,292 @@
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <link rel="stylesheet" href="site.css" type="text/css">
+
+
+
+    <title>ActiveMQ - Advisory Message</title>
+  </head>
+
+  <body>
+    <table width="100%" id="layout" style="padding:0px;margin0px;border-collapse:collapse;">
+      <tr>
+        <td colspan="3" style="padding:8px;">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr id="header_row">
+              <td align="left" valign="middle" style="padding:0px;margin:0px;">
+                <span id="Content"><span><span class="nobr"><a href="http://incubator.apache.org/activemq" rel="nofollow"><img align="absmiddle" border=0 src="images/logo.gif"></a></span></span></span>
+
+              </td>
+              
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="breadcrumbs">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr>
+              <td align="left">
+                <a href="">Home</a>  | Advisory Message
+              </td>
+              <td align="right">
+                  <span id="Content"><span><a href="Download" title="Download">Download</a> | <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/" rel="nofollow">JavaDocs for 4.x</a></span> <span class="nobr"><a href="http://activemq.org/maven/activemq-3/activemq-core/apidocs/" rel="nofollow">3.x</a></span> | <a href="Source" title="Source">Source</a> | <span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span> |<span class="nobr"><a href="irc://irc.codehaus.org/activemq" rel="nofollow">IRC</a></span> | <span class="nobr"><a href="http://servlet.uwyn.com/drone/log/hausbot/activemq" rel="nofollow">IRC Log</a></span> | <a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a> | <span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span> | <span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Support
 </a></span></span></span>
+
+              </td>
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td id="leftColumn" valign="top" style="padding-top: 0px;">
+          <span id="Content"><h3><a name="Navigation-Overview"></a>Overview</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Home" title="Home">Home</a></li>
+    <li><a href="News" title="News">News</a></li>
+    <li><a href="Changes+in+4.0" title="Changes in 4.0">New in 4.0</a></li>
+    <li><a href="FAQ" title="FAQ">FAQ</a></li>
+    <li><a href="Articles" title="Articles">Articles</a></li>
+    <li><a href="Download" title="Download">Download</a></li>
+  </ul>
+  <h3><a name="Navigation-Community"></a>Community</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span></li>
+    <li><a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a></li>
+    <li><span class="nobr"><a href="http://gmane.org/find.php?list=activemq" rel="nofollow">News Reader</a></span></li>
+    <li><span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span></li>
+    <li><a href="Projects+Using+ActiveMQ" title="Projects Using ActiveMQ">Projects Using ActiveMQ</a></li>
+    <li><a href="Users" title="Users">Users</a></li>
+    <li><a href="Contributing" title="Contributing">Contributing</a></li>
+    <li><a href="Team" title="Team">Team</a></li>
+  </ul>
+  <h3><a name="Navigation-UsingActiveMQ"></a>Using ActiveMQ</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Getting+Started" title="Getting Started">Getting Started</a></li>
+    <li><a href="Installation" title="Installation">Installation</a></li>
+    <li><a href="Building" title="Building">Building</a></li>
+    <li><a href="Run+Broker" title="Run Broker">Running a Broker</a></li>
+    <li><a href="Examples" title="Examples">Examples</a></li>
+    <li><a href="How+can+I+monitor+ActiveMQ" title="How can I monitor ActiveMQ">Monitoring the Broker</a></li>
+    <li><a href="Xml+Configuration" title="Xml Configuration">Xml Configuration</a></li>
+    <li><a href="Xml+Reference" title="Xml Reference">Xml Reference</a></li>
+    <li><a href="Use+Cases" title="Use Cases">Use Cases</a></li>
+    <li><a href="Topologies" title="Topologies">Topologies</a></li>
+    <li><a href="Configuring+Transports" title="Configuring Transports">Configuring Transports</a></li>
+    <li><a href="How+do+I+embed+a+Broker+inside+a+Connection" title="How do I embed a Broker inside a Connection">Embedded Brokers</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">Performance Testing</a></li>
+    <li><a href="Web+Samples" title="Web Samples">Web Samples</a></li>
+    <li><a href="Hello+World" title="Hello World">Hello World</a></li>
+  </ul>
+  <h3><a name="Navigation-Features"></a>Features</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JMX" title="JMX">JMX</a></li>
+    <li><a href="Performance" title="Performance">Performance</a></li>
+    <li><a href="Protocols" title="Protocols">Protocols</a></li>
+    <li><a href="Persistence" title="Persistence">Persistence</a></li>
+    <li><a href="JDBC+Support" title="JDBC Support">JDBC Support</a></li>
+    <li><a href="Clustering" title="Clustering">Clustering</a></li>
+    <li><a href="Discovery" title="Discovery">Discovery</a></li>
+    <li><a href="Networks+of+Brokers" title="Networks of Brokers">Networks of Brokers</a></li>
+    <li><a href="Composite+Destinations" title="Composite Destinations">Composite Destinations</a></li>
+    <li><a href="JMS+Streams" title="JMS Streams">JMS Streams</a></li>
+    <li><a href="Advisory+Message" title="Advisory Message">Advisory Message</a></li>
+    <li><a href="Resource+Adapter" title="Resource Adapter">JCA 1.5 Resource Adapter</a></li>
+  </ul>
+  <h3><a name="Navigation-Connectivitiy"></a>Connectivitiy</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Ajax" title="Ajax">Ajax</a></li>
+    <li><a href="Axis+Support" title="Axis Support">Axis Support</a></li>
+    <li><a href="C+Integration" title="C Integration">C Integration</a></li>
+    <li><a href="dot+Net" title="dot Net">.Net Integration</a></li>
+    <li><a href="Geronimo" title="Geronimo">Geronimo</a></li>
+    <li><a href="J2EE" title="J2EE">J2EE</a></li>
+    <li><a href="JBoss+Integration" title="JBoss Integration">JBoss Integration</a></li>
+    <li><a href="JNDI+Support" title="JNDI Support">JNDI Support</a></li>
+    <li><a href="OpenWire" title="OpenWire">OpenWire</a></li>
+    <li><a href="REST" title="REST">REST</a></li>
+    <li><a href="Spring+Support" title="Spring Support">Spring Support</a></li>
+    <li><a href="Stomp" title="Stomp">Stomp</a></li>
+    <li><a href="Tomcat" title="Tomcat">Tomcat</a></li>
+    <li><a href="WSIF" title="WSIF">WSIF</a></li>
+  </ul>
+  <h3><a name="Navigation-Utilities"></a>Utilities</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JCA+Container" title="JCA Container">JCA Container</a></li>
+  </ul>
+  <h3><a name="Navigation-ExternalTools"></a>External Tools</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Hermes+Jms" title="Hermes Jms">Hermes Jms</a></li>
+    <li><a href="Sun+JNDI" title="Sun JNDI">Sun JNDI</a></li>
+    <li><span class="nobr"><a href="http://jakarta.apache.org/jmeter" rel="nofollow">JMeter</a></span></li>
+  </ul>
+  <h3><a name="Navigation-RelatedProjects"></a>Related Projects</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://servicemix.org/" rel="nofollow">ServiceMix</a></span></li>
+    <li><span class="nobr"><a href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a></span></li>
+    <li><span class="nobr"><a href="http://jencks.org/" rel="nofollow">Jencks</a></span></li>
+    <li><span class="nobr"><a href="http://stomp.codehaus.org/" rel="nofollow">Stomp</a></span></li>
+    <li><span class="nobr"><a href="http://activecluster.codehaus.org/" rel="nofollow">ActiveCluster</a></span></li>
+    <li><span class="nobr"><a href="http://activespace.codehaus.org/" rel="nofollow">ActiveSpace</a></span></li>
+    <li><span class="nobr"><a href="http://activesoap.codehaus.org/" rel="nofollow">ActiveSOAP</a></span></li>
+    <li><span class="nobr"><a href="http://www.springframework.org/" rel="nofollow">Spring</a></span></li>
+    <li><span class="nobr"><a href="http://geronimo.apache.org/" rel="nofollow">Geronimo</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Support"></a>Support</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Issues</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:roadmap-panel" rel="nofollow">Roadmap</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:changelog-panel" rel="nofollow">Change log</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Developers"></a>Developers</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Source" title="Source">Source</a></li>
+    <li><a href="Code+Overview" title="Code Overview">Code Overview</a></li>
+    <li><a href="Wire+Protocol" title="Wire Protocol">Wire Protocol</a></li>
+    <li><a href="ActiveMQ+4.0" title="ActiveMQ 4.0">ActiveMQ 4.0</a></li>
+    <li><a href="Becoming+a+committer" title="Becoming a committer">Becoming a committer</a></li>
+    <li><a href="Integration+Tests" title="Integration Tests">Integration Tests</a></li>
+    <li><a href="Benchmark+Tests" title="Benchmark Tests">Benchmark Tests</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">JMeter Performance Tests</a></li>
+    <li><a href="Release+Guide" title="Release Guide">Release Guide</a></li>
+    <li><a href="JUnit+Reports" title="JUnit Reports">JUnit Reports</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/clover/" rel="nofollow">Clover Report</a></span></li>
+    <li><a href="Source+XRef" title="Source XRef">Source XRef</a></li>
+    <li><a href="Test+Source+XRef" title="Test Source XRef">Test Source XRef</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/activemq.xsd.html" rel="nofollow">XSD</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Toolsweuse"></a>Tools we use</h3><span><span class="nobr"><a href="http://www.yourkit.com" rel="nofollow"><img align="absmiddle" border=0 src="/download/attachments/23786/yourkit.jpg"></a></span></span></span>
+
+            <h3 class="heading3">Feeds</h3>
+            <table border="0" cellspacing="4px">
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a><br/>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false">Site</a>
+              </td>
+            </tr>
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ">News</a>
+              </td>
+            </tr>
+            </table>
+        </td>
+        <td id="rightColumn" valign="top">
+
+          <div id="page_title">
+            <table width="100%">
+              <tr>
+                <td>
+            Advisory Message 
+                </td>
+                <td align="right">
+            
+                </td>
+              </tr>
+            </table>
+          </div>
+
+
+          <div>
+  <div id="Content">
+    <p>ActiveMQ supports advisory messages about consumers, producers, connections and temporary destinations.</p>
+    <p>This can be thought as some kind of administrative channel where you receive information regarding what is happening on your JMS provider.</p>
+    <h2><a name="AdvisoryMessage-AMQ4.x"></a>AMQ 4.x</h2>
+    <p>Methods to get the advisory destnation objects are available in AdvisorySupport</p>
+    <p class="paragraph">
+      <div class="code">
+        <div class="codeContent"><pre class="code-java">AdvisorySupport.getConsumerAdvisoryTopic()
+AdvisorySupport.getProducerAdvisoryTopic()
+AdvisorySupport.getExpiredTopicMessageAdvisoryTopic()
+AdvisorySupport.getExpiredQueueMessageAdvisoryTopic()
+AdvisorySupport.getNoTopicConsumersAdvisoryTopic()
+AdvisorySupport.getNoQueueConsumersAdvisoryTopic()
+AdvisorySupport.getDestinationAdvisoryTopic()</pre></div>
+      </div>
+    </p>
+    <p>A subscription to each of the destination returns an ActiveMQMessage. Specific DataStructure objects (ie. ConsumerInfo, ProducerInfo,ConnectionInfo) can be retrieve via getDataStructure method of ActiveMQMessage.</p>
+    <p>For example:</p>
+    <p class="paragraph">
+      <div class="code">
+        <div class="codeContent"><pre class="code-java">...
+  
+    Destination advisoryDestination = AdvisorySupport.getProducerAdvisoryTopic(destination)
+    MessageConsumer consumer = session.createConsumer(advisoryDestination);
+    consumer.setMessageListener(<span class="code-keyword">this</span>);
+....
+<span class="code-keyword">public</span> void onMessage(Message msg){
+    <span class="code-keyword">if</span> (msg <span class="code-keyword">instanceof</span> ActiveMQMessage){
+        <span class="code-keyword">try</span> {
+             ActiveMQMessage aMsg =  (ActiveMQMessage)msg;
+             ProducerInfo prod = (ProducerInfo) aMsg.getDataStructure();
+        } <span class="code-keyword">catch</span> (JMSException e) {
+            log.error(<span class="code-quote">&quot;Failed to process message: &quot;</span> + msg);
+        }
+    }
+}</pre></div>
+      </div>
+    </p>
+    <h2><a name="AdvisoryMessage-AMQ3.x"></a>AMQ 3.x</h2>
+    <p>The destination string constants are available in <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/message/ActiveMQDestination.html" rel="nofollow">ActiveMQDestination</a></span></p>
+    <p class="paragraph">
+      <div class="code">
+        <div class="codeContent"><pre class="code-java">ActiveMQDestination.CONSUMER_ADVISORY_PREFIX
+ActiveMQDestination.PRODUCER_ADVISORY_PREFIX
+ActiveMQDestination.CONNECTION_ADVISORY_PREFIX
+ActiveMQDestination.TEMP_DESTINATION_ADVISORY_PREFIX</pre></div>
+      </div>
+    </p>
+    <p>A subscription to each of the destination returns an ObjectMessage with a specific object: <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/message/ConsumerInfo.html" rel="nofollow">ConsumerInfo</a></span>, <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/message/ProducerInfo.html" rel="nofollow">ProducerInfo</a></span>,<span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/message/ConnectionInfo.html" rel="nofollow">ConnectionInfo</a></span>, <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/advisories/TempDestinationAdvisoryEvent.html" rel="nofollow">TempDestinationAdvisoryEvent</a></span>.</p>
+    <p>For example:</p>
+    <p class="paragraph">
+      <div class="code">
+        <div class="codeContent"><pre class="code-java">...
+    <span class="code-object">String</span> advisoryName = ActiveMQDestination.PRODUCER_ADVISORY_PREFIX + destination.getPhysicalName();
+    Destination advisoryDestination = ActiveMQDestination.createDestination(destination.getDestinationType(), advisoryName);
+    MessageConsumer consumer = session.createConsumer(advisoryDestination);
+    consumer.setMessageListener(<span class="code-keyword">this</span>);
+....
+<span class="code-keyword">public</span> void onMessage(Message msg){
+    <span class="code-keyword">if</span> (msg <span class="code-keyword">instanceof</span> ObjectMessage){
+        <span class="code-keyword">try</span> {
+            ProducerInfo info = (ProducerInfo)((ObjectMessage)msg).getObject();
+        } <span class="code-keyword">catch</span> (JMSException e) {
+            log.error(<span class="code-quote">&quot;Failed to process message: &quot;</span> + msg);
+        }
+    }
+}</pre></div>
+      </div>
+    </p>
+    <p>Some helper classes to deal with advisory messages are available in the <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/org/activemq/advisories/package-summary.html" rel="nofollow">advisories</a></span> package.</p>
+  </div>
+</div>
+
+          &nbsp;
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="footer">
+          <table width="100%"> 
+            <tr>
+              <td align="left" valign="top">
+          
+              </td>
+              <td align="right" valign="top">
+          <a style="color:#999;" href="http://docs.codehaus.org/pages/editpage.action?spaceKey=ACTIVEMQ&title=Advisory+Message">[ edit ]</a>
+              </td>
+            </tr>
+          <table>
+        </td>
+      </tr>
+    </table>
+  </body>
+
+</html>
+
+

Added: incubator/activemq/site/Ajax
URL: http://svn.apache.org/viewcvs/incubator/activemq/site/Ajax?rev=374430&view=auto
==============================================================================
--- incubator/activemq/site/Ajax (added)
+++ incubator/activemq/site/Ajax Thu Feb  2 08:31:10 2006
@@ -0,0 +1,257 @@
+
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+  <head>
+    <link rel="stylesheet" href="site.css" type="text/css">
+
+
+
+    <title>ActiveMQ - Ajax</title>
+  </head>
+
+  <body>
+    <table width="100%" id="layout" style="padding:0px;margin0px;border-collapse:collapse;">
+      <tr>
+        <td colspan="3" style="padding:8px;">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr id="header_row">
+              <td align="left" valign="middle" style="padding:0px;margin:0px;">
+                <span id="Content"><span><span class="nobr"><a href="http://incubator.apache.org/activemq" rel="nofollow"><img align="absmiddle" border=0 src="images/logo.gif"></a></span></span></span>
+
+              </td>
+              
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="breadcrumbs">
+          <table width="100%" id="banner" style="padding:0px;margin:0px">
+            <tr>
+              <td align="left">
+                <a href="">Home</a>  | Ajax
+              </td>
+              <td align="right">
+                  <span id="Content"><span><a href="Download" title="Download">Download</a> | <span class="nobr"><a href="http://activemq.codehaus.org/maven/apidocs/" rel="nofollow">JavaDocs for 4.x</a></span> <span class="nobr"><a href="http://activemq.org/maven/activemq-3/activemq-core/apidocs/" rel="nofollow">3.x</a></span> | <a href="Source" title="Source">Source</a> | <span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span> |<span class="nobr"><a href="irc://irc.codehaus.org/activemq" rel="nofollow">IRC</a></span> | <span class="nobr"><a href="http://servlet.uwyn.com/drone/log/hausbot/activemq" rel="nofollow">IRC Log</a></span> | <a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a> | <span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span> | <span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Support
 </a></span></span></span>
+
+              </td>
+            </tr>
+          </table>
+        </td>
+      </tr>
+      <tr>
+        <td id="leftColumn" valign="top" style="padding-top: 0px;">
+          <span id="Content"><h3><a name="Navigation-Overview"></a>Overview</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Home" title="Home">Home</a></li>
+    <li><a href="News" title="News">News</a></li>
+    <li><a href="Changes+in+4.0" title="Changes in 4.0">New in 4.0</a></li>
+    <li><a href="FAQ" title="FAQ">FAQ</a></li>
+    <li><a href="Articles" title="Articles">Articles</a></li>
+    <li><a href="Download" title="Download">Download</a></li>
+  </ul>
+  <h3><a name="Navigation-Community"></a>Community</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://forums.logicblaze.com/forums/show/1.page" rel="nofollow">Discussion Forum</a></span></li>
+    <li><a href="Mailing+Lists" title="Mailing Lists">Mailing Lists</a></li>
+    <li><span class="nobr"><a href="http://gmane.org/find.php?list=activemq" rel="nofollow">News Reader</a></span></li>
+    <li><span class="nobr"><a href="http://docs.codehaus.org/pages/listpages.action?key=ACTIVEMQ" rel="nofollow">Wiki</a></span></li>
+    <li><a href="Projects+Using+ActiveMQ" title="Projects Using ActiveMQ">Projects Using ActiveMQ</a></li>
+    <li><a href="Users" title="Users">Users</a></li>
+    <li><a href="Contributing" title="Contributing">Contributing</a></li>
+    <li><a href="Team" title="Team">Team</a></li>
+  </ul>
+  <h3><a name="Navigation-UsingActiveMQ"></a>Using ActiveMQ</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Getting+Started" title="Getting Started">Getting Started</a></li>
+    <li><a href="Installation" title="Installation">Installation</a></li>
+    <li><a href="Building" title="Building">Building</a></li>
+    <li><a href="Run+Broker" title="Run Broker">Running a Broker</a></li>
+    <li><a href="Examples" title="Examples">Examples</a></li>
+    <li><a href="How+can+I+monitor+ActiveMQ" title="How can I monitor ActiveMQ">Monitoring the Broker</a></li>
+    <li><a href="Xml+Configuration" title="Xml Configuration">Xml Configuration</a></li>
+    <li><a href="Xml+Reference" title="Xml Reference">Xml Reference</a></li>
+    <li><a href="Use+Cases" title="Use Cases">Use Cases</a></li>
+    <li><a href="Topologies" title="Topologies">Topologies</a></li>
+    <li><a href="Configuring+Transports" title="Configuring Transports">Configuring Transports</a></li>
+    <li><a href="How+do+I+embed+a+Broker+inside+a+Connection" title="How do I embed a Broker inside a Connection">Embedded Brokers</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">Performance Testing</a></li>
+    <li><a href="Web+Samples" title="Web Samples">Web Samples</a></li>
+    <li><a href="Hello+World" title="Hello World">Hello World</a></li>
+  </ul>
+  <h3><a name="Navigation-Features"></a>Features</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JMX" title="JMX">JMX</a></li>
+    <li><a href="Performance" title="Performance">Performance</a></li>
+    <li><a href="Protocols" title="Protocols">Protocols</a></li>
+    <li><a href="Persistence" title="Persistence">Persistence</a></li>
+    <li><a href="JDBC+Support" title="JDBC Support">JDBC Support</a></li>
+    <li><a href="Clustering" title="Clustering">Clustering</a></li>
+    <li><a href="Discovery" title="Discovery">Discovery</a></li>
+    <li><a href="Networks+of+Brokers" title="Networks of Brokers">Networks of Brokers</a></li>
+    <li><a href="Composite+Destinations" title="Composite Destinations">Composite Destinations</a></li>
+    <li><a href="JMS+Streams" title="JMS Streams">JMS Streams</a></li>
+    <li><a href="Advisory+Message" title="Advisory Message">Advisory Message</a></li>
+    <li><a href="Resource+Adapter" title="Resource Adapter">JCA 1.5 Resource Adapter</a></li>
+  </ul>
+  <h3><a name="Navigation-Connectivitiy"></a>Connectivitiy</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Ajax" title="Ajax">Ajax</a></li>
+    <li><a href="Axis+Support" title="Axis Support">Axis Support</a></li>
+    <li><a href="C+Integration" title="C Integration">C Integration</a></li>
+    <li><a href="dot+Net" title="dot Net">.Net Integration</a></li>
+    <li><a href="Geronimo" title="Geronimo">Geronimo</a></li>
+    <li><a href="J2EE" title="J2EE">J2EE</a></li>
+    <li><a href="JBoss+Integration" title="JBoss Integration">JBoss Integration</a></li>
+    <li><a href="JNDI+Support" title="JNDI Support">JNDI Support</a></li>
+    <li><a href="OpenWire" title="OpenWire">OpenWire</a></li>
+    <li><a href="REST" title="REST">REST</a></li>
+    <li><a href="Spring+Support" title="Spring Support">Spring Support</a></li>
+    <li><a href="Stomp" title="Stomp">Stomp</a></li>
+    <li><a href="Tomcat" title="Tomcat">Tomcat</a></li>
+    <li><a href="WSIF" title="WSIF">WSIF</a></li>
+  </ul>
+  <h3><a name="Navigation-Utilities"></a>Utilities</h3>
+  <ul class="alternate" type="square">
+    <li><a href="JCA+Container" title="JCA Container">JCA Container</a></li>
+  </ul>
+  <h3><a name="Navigation-ExternalTools"></a>External Tools</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Hermes+Jms" title="Hermes Jms">Hermes Jms</a></li>
+    <li><a href="Sun+JNDI" title="Sun JNDI">Sun JNDI</a></li>
+    <li><span class="nobr"><a href="http://jakarta.apache.org/jmeter" rel="nofollow">JMeter</a></span></li>
+  </ul>
+  <h3><a name="Navigation-RelatedProjects"></a>Related Projects</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://servicemix.org/" rel="nofollow">ServiceMix</a></span></li>
+    <li><span class="nobr"><a href="http://lingo.codehaus.org/" rel="nofollow">Lingo</a></span></li>
+    <li><span class="nobr"><a href="http://jencks.org/" rel="nofollow">Jencks</a></span></li>
+    <li><span class="nobr"><a href="http://stomp.codehaus.org/" rel="nofollow">Stomp</a></span></li>
+    <li><span class="nobr"><a href="http://activecluster.codehaus.org/" rel="nofollow">ActiveCluster</a></span></li>
+    <li><span class="nobr"><a href="http://activespace.codehaus.org/" rel="nofollow">ActiveSpace</a></span></li>
+    <li><span class="nobr"><a href="http://activesoap.codehaus.org/" rel="nofollow">ActiveSOAP</a></span></li>
+    <li><span class="nobr"><a href="http://www.springframework.org/" rel="nofollow">Spring</a></span></li>
+    <li><span class="nobr"><a href="http://geronimo.apache.org/" rel="nofollow">Geronimo</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Support"></a>Support</h3>
+  <ul class="alternate" type="square">
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ" rel="nofollow">Issues</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:roadmap-panel" rel="nofollow">Roadmap</a></span></li>
+    <li><span class="nobr"><a href="http://jira.logicblaze.com/jira/browse/AMQ?report=com.atlassian.jira.plugin.system.project:changelog-panel" rel="nofollow">Change log</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Developers"></a>Developers</h3>
+  <ul class="alternate" type="square">
+    <li><a href="Source" title="Source">Source</a></li>
+    <li><a href="Code+Overview" title="Code Overview">Code Overview</a></li>
+    <li><a href="Wire+Protocol" title="Wire Protocol">Wire Protocol</a></li>
+    <li><a href="ActiveMQ+4.0" title="ActiveMQ 4.0">ActiveMQ 4.0</a></li>
+    <li><a href="Becoming+a+committer" title="Becoming a committer">Becoming a committer</a></li>
+    <li><a href="Integration+Tests" title="Integration Tests">Integration Tests</a></li>
+    <li><a href="Benchmark+Tests" title="Benchmark Tests">Benchmark Tests</a></li>
+    <li><a href="JMeter+Performance+Tests" title="JMeter Performance Tests">JMeter Performance Tests</a></li>
+    <li><a href="Release+Guide" title="Release Guide">Release Guide</a></li>
+    <li><a href="JUnit+Reports" title="JUnit Reports">JUnit Reports</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/clover/" rel="nofollow">Clover Report</a></span></li>
+    <li><a href="Source+XRef" title="Source XRef">Source XRef</a></li>
+    <li><a href="Test+Source+XRef" title="Test Source XRef">Test Source XRef</a></li>
+    <li><span class="nobr"><a href="http://activemq.codehaus.org/maven/activemq.xsd.html" rel="nofollow">XSD</a></span></li>
+  </ul>
+  <h3><a name="Navigation-Toolsweuse"></a>Tools we use</h3><span><span class="nobr"><a href="http://www.yourkit.com" rel="nofollow"><img align="absmiddle" border=0 src="/download/attachments/23786/yourkit.jpg"></a></span></span></span>
+
+            <h3 class="heading3">Feeds</h3>
+            <table border="0" cellspacing="4px">
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a><br/>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/rss.action?key=ACTIVEMQ&newPages=false">Site</a>
+              </td>
+            </tr>
+            <tr>
+              <td align="right">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ"><img src="http://docs.codehaus.org/images/icons/rss.gif" border="0"></a>
+              </td>
+              <td align="left">
+                <a href="http://docs.codehaus.org/spaces/blogrss.action?key=ACTIVEMQ">News</a>
+              </td>
+            </tr>
+            </table>
+        </td>
+        <td id="rightColumn" valign="top">
+
+          <div id="page_title">
+            <table width="100%">
+              <tr>
+                <td>
+            Ajax 
+                </td>
+                <td align="right">
+            
+                </td>
+              </tr>
+            </table>
+          </div>
+
+
+          <div>
+  <div id="Content">
+    <p>ActiveMQ supports <b>Ajax</b> which is an Asychronous Javascript And Xml mechanism for real time web applications. </p>
+    <p>Ajax allows a regular DHTML client (with JavaScript and a modern version 5 or later web brwoser) to send and receive messages over the web. Ajax support in ActiveMQ builds on top of the <a href="REST" title="REST">REST</a> connector for ActiveMQ which allows any web capable device to send or receive messages over JMS.</p>
+    <p>To see Ajax in action, try <a href="Web+Samples" title="Web Samples">running the examples</a></p>
+    <h3><a name="Ajax-Clientsideview"></a>Client side view </h3>
+    <p>The client side is a web browser using Ajax which means using the JavaScript <span class="nobr"><a href="http://jibbering.com/2002/4/httprequest.html" rel="nofollow">XmlHttpRequest</a></span> to make calls on the <a href="REST" title="REST">REST</a> API to send or receive messages.</p>
+    <p>This means that the Ajax client can send or receive messages asynchronously from the users interaction and can easily <em>databind</em> XML messages received with the HTML DOM to produce some revolutionary applications all with standard DHTML technologies.</p>
+    <p>The web browser can then render active views of information which can update in real time.</p>
+    <p>If you want to use an existing Ajax library on the browser side we strongly recommend the <span class="nobr"><a href="http://openrico.org/" rel="nofollow">OpenRico</a></span> library which builds on top of the lower level <span class="nobr"><a href="http://prototype.conio.net/" rel="nofollow">Prototype</a></span> library for performing asychronous Ajax messaging. All our <a href="Web+Samples" title="Web Samples">Ajax examples</a> are currently using OpenRico.</p>
+    <h3><a name="Ajax-Serversideview"></a>Server side view</h3>
+    <p>Here each HTTP GET or POST is just a regular use of the <a href="REST" title="REST">REST</a> API and so doesn't particularly care what the client is; whether its JavaScript or C or Ruby/Python whatever.</p>
+    <p>We use a MessageServlet on the server side to handle the HTTP traffic; together with an optional NIO based servlet engine (Jetty) for handling large numbers of concurrent clients.</p>
+    <h3><a name="Ajax-ComparisontoPushlets"></a>Comparison to Pushlets</h3>
+    <p>Firstly we could easily add support for pushlets to ActiveMQ. However we prefer the Ajax approach for various reasons</p>
+    <ul>
+      <li>using Ajax means that we use a distinct HTTP request for each send/receive which is much more friendly to web infrastructure (firewalls, proxies, caches and so forth) rather than having an infinitely-long GET.</li>
+    </ul>
+    <ul>
+      <li>we can still take advantage of HTTP 1.1 keep-alive sockets and pipeline processing to gain the efficiency of a single socket used for communication between the client and server side; though in a way that works with any HTTP-capable infrastructure</li>
+    </ul>
+    <ul>
+      <li>the server is pure REST and so will work with any client side (rather than being tied to custom JavaScript function calls used on the page which the Pushlet approach requires). So Pushlets tie the server to the web page; with Ajax we can have a generic service which works with any page.</li>
+    </ul>
+    <ul>
+      <li>the client can be in control over frequency of polling &amp; timeouts. e.g. it can avoid the memory issues of Pushlets in some browsers by using a 20-second timeout HTTP GET. Or using a zero timeout GET to poll queues.</li>
+    </ul>
+    <ul>
+      <li>its easier to take full advantage of HTTP encoding of messages, rather than using JavaScript function calls as the transfer protocol.</li>
+    </ul>
+    <ul>
+      <li>pushlets assume the server knows what functions are used on the client side as the server basically writes JavaScript function calls down the scoket - it's better for us to send generic XML packets (or strings or whatever the message format is) and let the JavaScript client side be totally decoupled from the server side</li>
+    </ul>
+    <ul>
+      <li>Ajax supports clean XML support allowing full XML documents to be streamed to the client for rich messages which are easy to process via standard JavaScript DOM support</li>
+    </ul>
+  </div>
+</div>
+
+          &nbsp;
+        </td>
+      </tr>
+      <tr>
+        <td colspan="3" id="footer">
+          <table width="100%"> 
+            <tr>
+              <td align="left" valign="top">
+          
+              </td>
+              <td align="right" valign="top">
+          <a style="color:#999;" href="http://docs.codehaus.org/pages/editpage.action?spaceKey=ACTIVEMQ&title=Ajax">[ edit ]</a>
+              </td>
+            </tr>
+          <table>
+        </td>
+      </tr>
+    </table>
+  </body>
+
+</html>
+
+



Mime
View raw message