blob: 3d3edd43d64befc32c8ba860e88eb94c8bdcacce [file] [log] [blame]
<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter&#160;2.&#160;Configuring the Client</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-10-Example.html">Prev</a>&#160;</td><th align="center" width="60%">&#160;</th><td align="right" width="20%">&#160;<a accesskey="n" href="JMS-Client-0-10-Configuring-JNDI.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-10-Configuring"></a>Chapter&#160;2.&#160;Configuring the Client</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-10-Configuring.html#JMS-Client-0-10-Configuring-Overview">2.1. Overview</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-JNDI.html">2.2. JNDI Properties</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-10-Configuring-JNDI.html#d0e159">2.2.1. Properties File Format</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-JNDI.html#JMS-Client-0-10-Configuring-JNDI-Connection-URL">2.2.2. Connection URLs</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-10-Configuring-JVM-Properties.html">2.3. JVM Properties</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Addresses.html">2.4. Addresses</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Addresses.html#d0e1449">2.4.1. Address Strings</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Addresses.html#d0e1473">2.4.2. Subjects</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Addresses.html#d0e1649">2.4.3. Address String Options</a></span></dt><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Addresses.html#section-address-string-bnf">2.4.4. Address String Grammar</a></span></dt></dl></dd><dt><span class="section"><a href="JMS-Client-0-10-Configuring-Logging.html">2.5. Logging</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="JMS-Client-0-10-Configuring-Overview"></a>2.1.&#160;Overview</h2></div></div></div><p>This chapter covers various configuration details for the Apache Qpid JMS Client for AMQP 0-10, from the basics of setting up the client
using JNDI in <a class="xref" href="JMS-Client-0-10-Configuring-JNDI.html" title="2.2.&#160;JNDI Properties">Section&#160;2.2, &#8220;JNDI Properties&#8221;</a>, to the various configuration options avilable to
customize it's behaviour at different levels of granualarity, e.g:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
Connection level using Connection/Broker properties : Affects the respective connection and sessions, consumers and produces created by that connection.
</p><p>Ex. <code class="varname">amqp://guest:guest@test/test?maxprefetch='1000'
&amp;brokerlist='tcp://localhost:5672'
</code> property specifies the message credits to use. This overrides any value specified via the JVM argument <code class="varname">max_prefetch</code>.</p><p>Please refer to the <a class="xref" href="JMS-Client-0-10-Configuring-JNDI.html#JMS-Client-0-10-Configuring-JNDI-Connection-URL" title="2.2.2.&#160;Connection URLs">Section&#160;2.2.2, &#8220;Connection URLs&#8221;</a> section for a complete list of all properties and how to use them.</p></li><li class="listitem"><p>
JVM level using JVM arguments : Configuration that affects all connections, sessions, consumers and producers created within that JVM.
</p><p>Ex. <code class="varname">-Dmax_prefetch=1000</code> property specifies the message credits to use.</p><p>Please refer to the <a class="xref" href="JMS-Client-0-10-Configuring-JVM-Properties.html" title="2.3.&#160;JVM Properties">Section&#160;2.3, &#8220;JVM Properties&#8221;</a> section for a complete list of all properties and how to use them.</p></li><li class="listitem"><p>
Destination level using Addressing options : Affects the producer(s) and consumer(s) created using the respective destination.
</p><p>Ex. <code class="varname">my-queue; {create: always, link:{capacity: 10}}</code>, where <code class="varname">capacity</code> option specifies the message credits to use. This overrides any connection level configuration.</p><p>Please refer to the <a class="xref" href="JMS-Client-0-10-Configuring-Addresses.html" title="2.4.&#160;Addresses">Section&#160;2.4, &#8220;Addresses&#8221;</a> section for a complete understanding of addressing and it's various options.</p></li></ul></div><p>Some of these config options are available at all three levels, while others are available only at JVM or connection level.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-10-Example.html">Prev</a>&#160;</td><td align="center" width="20%">&#160;</td><td align="right" width="40%">&#160;<a accesskey="n" href="JMS-Client-0-10-Configuring-JNDI.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;1.&#160;HelloWorld Example&#160;</td><td align="center" width="20%"><a accesskey="h" href="JMS-Client-0-10-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;2.2.&#160;JNDI Properties</td></tr></table></div></div>