Repository: qpid-jms-amqp-0-x Updated Branches: refs/heads/master 472a5de89 -> 83451b94a
QPID-8018: [Qpid JMS AMQP 0-x] Further improvements to the message and documentation Project: http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/repo Commit: http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/commit/83451b94 Tree: http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/tree/83451b94 Diff: http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/diff/83451b94 Branch: refs/heads/master Commit: 83451b94a4734b4d09503da988f0f1679686fed0 Parents: 472a5de Author: Keith Wall <kw...@apache.org> Authored: Mon Nov 13 16:47:35 2017 +0000 Committer: Keith Wall <kw...@apache.org> Committed: Mon Nov 13 16:47:35 2017 +0000 ---------------------------------------------------------------------- .../apache/qpid/client/util/BlockingWaiter.java | 5 +++-- .../src/docbkx/JMS-Client-Appendix-Exceptions.xml | 18 ++++++++++++------ 2 files changed, 15 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/blob/83451b94/client/src/main/java/org/apache/qpid/client/util/BlockingWaiter.java ---------------------------------------------------------------------- diff --git a/client/src/main/java/org/apache/qpid/client/util/BlockingWaiter.java b/client/src/main/java/org/apache/qpid/client/util/BlockingWaiter.java index c977854..66be535 100644 --- a/client/src/main/java/org/apache/qpid/client/util/BlockingWaiter.java +++ b/client/src/main/java/org/apache/qpid/client/util/BlockingWaiter.java @@ -168,8 +168,9 @@ public abstract class BlockingWaiter<T> if (nanoTimeout <= 0 && !_ready && _error == null) { final String errorMsg = String.format( - "Waiting for receive timed out after %d ms. Possible reasons include JVM garbage" - + " collection, slow connection, busy broker, ...", + "The server's response was not received within the time-out period of %d ms. " + + "Possible reasons include: the server may be too busy, the network may be " + + "overloaded, or this JVM itself may be too busy to process the response.", timeout); _error = new AMQTimeoutException(errorMsg, null); _ready = true; http://git-wip-us.apache.org/repos/asf/qpid-jms-amqp-0-x/blob/83451b94/doc/jms-client-0-8/src/docbkx/JMS-Client-Appendix-Exceptions.xml ---------------------------------------------------------------------- diff --git a/doc/jms-client-0-8/src/docbkx/JMS-Client-Appendix-Exceptions.xml b/doc/jms-client-0-8/src/docbkx/JMS-Client-Appendix-Exceptions.xml index 5435378..7fa04bb 100644 --- a/doc/jms-client-0-8/src/docbkx/JMS-Client-Appendix-Exceptions.xml +++ b/doc/jms-client-0-8/src/docbkx/JMS-Client-Appendix-Exceptions.xml @@ -88,12 +88,18 @@ </row> <row> <entry>AMQTimeoutException</entry> - <entry>Server did not respond in a timely fashion; Request Timeout</entry> - <entry><para>Indicates that the broker did not respond to a request sent by the client in - a reasonable length of time. The timeout is governed by <link linkend="JMS-Client-0-8-System-Properties-SyncOpTimeout"><literal>qpid.sync_op_timeout</literal></link>.</para><para>This can be a symptom - of a heavily loaded broker that cannot respond or the Broker may have failed in - unexpected manner. Check the broker and the host on which it runs and performance of - its storage.</para></entry> + <entry>The server's response was not received within the time-out period of %d ms.</entry> + <entry> + <para>Indicates that the Broker's response to the request sent by the client was not received + within a timely fashion. The timeout is governed by + <link linkend="JMS-Client-0-8-System-Properties-SyncOpTimeout"> + <literal>qpid.sync_op_timeout</literal> + </link>. + </para> + <para>This can be a symptom of a heavily loaded Broker, an overloaded network or a client JVM itself which + is too overloaded to process incoming responses. Check for unreasonably long garbage collection pauses. + </para> + </entry> </row> <row> <entry>AMQSecurityException</entry> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org