From f0be669bb60a6a089894f24e33c858eaae9a2c59 Mon Sep 17 00:00:00 2001 From: Keith Wall Date: Sun, 16 Oct 2011 17:46:18 +0000 Subject: QPID-3516: Docbook recent changes to Java client system properties git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk@1184883 13f79535-47bb-0310-9956-ffa450edef68 --- qpid/doc/book/src/Programming-In-Apache-Qpid.xml | 20 ++++--- qpid/doc/book/src/Qpid-Java-FAQ.xml | 54 ------------------ qpid/doc/book/src/System-Properties.xml | 70 ++---------------------- 3 files changed, 17 insertions(+), 127 deletions(-) diff --git a/qpid/doc/book/src/Programming-In-Apache-Qpid.xml b/qpid/doc/book/src/Programming-In-Apache-Qpid.xml index 6fae2f0bc7..4d72864cb1 100644 --- a/qpid/doc/book/src/Programming-In-Apache-Qpid.xml +++ b/qpid/doc/book/src/Programming-In-Apache-Qpid.xml @@ -3443,9 +3443,8 @@ log4j.appender.console.layout.ConversionPattern=%t %d %p [%c{4}] %m%n qpid.amqp.version string 0-10 - Sets the AMQP version to be used - currently supports one of {0-8,0-9,0-91,0-10} - - + Sets the AMQP version to be used - currently supports one of {0-8,0-9,0-91,0-10}.The client will begin negotiation at the specified version and only negotiate downwards if the Broker does not support the specified version. + qpid.heartbeat int @@ -3610,15 +3609,20 @@ log4j.appender.console.layout.ConversionPattern=%t %d %p [%c{4}] %m%n qpid.transport string org.apache.qpid.transport.network.io.IoNetworkTransport - The transport implementation to be used.A user could specify an alternative transport mechanism that implements the org.apache.qpid.transport.network.NetworkTransport interface. - - + The transport implementation to be used.A user could specify an alternative transport mechanism that implements the org.apache.qpid.transport.network.NetworkTransport interface. + + + qpid.sync_op_timeout + long + 60000 + The length of time (in milliseconds) to wait for a synchronous operation to complete.For compatibility with older clients, the synonym amqj.default_syncwrite_timeout is supported. + amqj.tcp_nodelay boolean false - Sets the TCP_NODELAY property of the underlying socket.This could also be set per connection as well (see connection paramters). - + Sets the TCP_NODELAY property of the underlying socket.This could also be set per connection as well (see connection paramters). + diff --git a/qpid/doc/book/src/Qpid-Java-FAQ.xml b/qpid/doc/book/src/Qpid-Java-FAQ.xml index 7a28703774..2144d3a533 100644 --- a/qpid/doc/book/src/Qpid-Java-FAQ.xml +++ b/qpid/doc/book/src/Qpid-Java-FAQ.xml @@ -736,35 +736,6 @@ amqj.logging.level -
- How do I - use an InVM Broker for my own tests? - - - - I would take a look at the testPassiveTTL in - TimeToLiveTest.java - - The setUp and tearDown methods show how to correctly start up a - broker for InVM testing. If you write your tests using a file for - the JNDI you can then very easily swap between running your tests - InVM and against a real broker. - - See our on how to confgure it - - Basically though you just need to set two System Properites: - - java.naming.factory.initial = - org.apache.qpid.jndi.PropertiesFileInitialContextFactory - java.naming.provider.url = <your JNDI file> - - and call getInitialContext() in your code. - - You will of course need to have the broker libraries on your - class path for this to run. - -
-
How can I inspect the contents of my MessageStore? @@ -907,31 +878,6 @@ java.lang.NullPointerException </para> <!--h3--></section> - <section role="h3" id="QpidJavaFAQ-Clientkeepsthrowing-27Serverdidnotrespondinatimelyfashion-27-5Cerrorcode408-3ARequestTimeout-5C."><title> - Client keeps throwing 'Server did not respond in a timely - fashion' [error code 408: Request Timeout]. - - - - Certain operations wait for a response from the Server. One such - operations is commit. If the server does not respond to the - commit request within a set time a Request Timeout [error code: - 408] exception is thrown (Server did not respond in a timely - fashion). This is to ensure that a server that has hung does not - cause the client process to be come unresponsive. - - However, it is possible that the server just needs a long time to - process a give request. For example, sending a large persistent - message when using a persistent store will take some time to a) - Transfer accross the network and b) to be fully written to disk. - - These situations require that the default timeout value be - increased. A cilent 'amqj.default_syncwrite_timeout' can be set - on the client to increase the wait time. The default in 0.5 is - 30000 (30s). - -
-
Can a use TCP_KEEPALIVE or AMQP heartbeating to keep my connection open? diff --git a/qpid/doc/book/src/System-Properties.xml b/qpid/doc/book/src/System-Properties.xml index d61673f234..40b823185f 100644 --- a/qpid/doc/book/src/System-Properties.xml +++ b/qpid/doc/book/src/System-Properties.xml @@ -135,7 +135,7 @@ <varlistentry> - <term>amqj.default_syncwrite_timeout</term> + <term>qpid.sync_op_timeout</term> <listitem> <variablelist> <varlistentry> @@ -144,12 +144,11 @@ </varlistentry> <varlistentry> <term>Default</term> - <listitem><para>30000</para></listitem> + <listitem><para>60000</para></listitem> </varlistentry> </variablelist> - <para> The number length of time in millisecond to wait - for a synchronous write to complete. - </para> + <para>The length of time (in milliseconds) to wait for a synchronous operation to complete. + For compatibility with older clients, the synonym amqj.default_syncwrite_timeout is supported.</para> </listitem> </varlistentry> @@ -193,7 +192,7 @@ <varlistentry> - <term>amqj.tcpNoDelay</term> + <term>amqj.tcp_nodelay</term> <listitem> <variablelist> <varlistentry> @@ -210,65 +209,6 @@ </listitem> </varlistentry> - <varlistentry> - <term>amqj.sendBufferSize</term> - <listitem> - <variablelist> - <varlistentry> - <term>integer</term> - <listitem><para>Boolean</para></listitem> - </varlistentry> - <varlistentry> - <term>Default</term> - <listitem><para>32768</para></listitem> - </varlistentry> - </variablelist> - <para>This is the default buffer sized created by Mina. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>amqj.receiveBufferSize</term> - <listitem> - <variablelist> - <varlistentry> - <term>Type</term> - <listitem><para>integer</para></listitem> - </varlistentry> - <varlistentry> - <term>Default</term> - <listitem><para>32768</para></listitem> - </varlistentry> - </variablelist> - <para>This is the default buffer sized created by Mina. - </para> - </listitem> - </varlistentry> - - - <varlistentry> - <term>amqj.protocolprovider.class</term> - <listitem> - <variablelist> - <varlistentry> - <term>Type</term> - <listitem><para>String</para></listitem> - </varlistentry> - <varlistentry> - <term>Default</term> - <listitem><para>org.apache.qpid.server.protocol.AMQPFastProtocolHandler</para></listitem> - </varlistentry> - </variablelist> - <para> This specifies the default IoHandlerAdapter that - represents the InVM broker. The IoHandlerAdapter must have - a constructor that takes a single Integer that represents - the InVM port number. - </para> - </listitem> - </varlistentry> - - <varlistentry> <term>amqj.protocol.logging.level</term> <listitem> -- cgit v1.2.1