Author: kwall
Date: Tue Jun 24 14:33:03 2014
New Revision: 1605095
URL: http://svn.apache.org/r1605095
Log:
NO-JIRA: [Java 0-8..0-9-1 Client Book] Add
AMQAuthenticationException/AMQSecurityException to exception catalogue
Modified:
qpid/trunk/qpid/doc/book/src/jms-client-0-8/JMS-Client-Appendix-Exceptions.xml
Modified:
qpid/trunk/qpid/doc/book/src/jms-client-0-8/JMS-Client-Appendix-Exceptions.xml
URL:
http://svn.apache.org/viewvc/qpid/trunk/qpid/doc/book/src/jms-client-0-8/JMS-Client-Appendix-Exceptions.xml?rev=1605095&r1=1605094&r2=1605095&view=diff
==============================================================================
---
qpid/trunk/qpid/doc/book/src/jms-client-0-8/JMS-Client-Appendix-Exceptions.xml
(original)
+++
qpid/trunk/qpid/doc/book/src/jms-client-0-8/JMS-Client-Appendix-Exceptions.xml
Tue Jun 24 14:33:03 2014
@@ -29,11 +29,12 @@
<appendix id="JMS-Client-0-8-Appendix-Exceptions">
<title>Exceptions</title>
- <para>The methods of Qpid JMS Client throw <ulink
url="&oracleJeeDocUrl;javax/jms/JMSException.html"
- >JMSExceptions</ulink> in response to error conditions. Typically the
exception's message
- (#getMessage()) summarises the error condition, with contextual
information being provided by
- the messages of linked exception(s). To understand the problem, it is
important to read the messages
- associated with <emphasis>all</emphasis> the linked exceptions.</para>
+ <para>The methods of Qpid JMS Client throw <ulink
+ url="&oracleJeeDocUrl;javax/jms/JMSException.html">JMSExceptions</ulink>
in response to error
+ conditions. Typically the exception's message (#getMessage()) summarises
the error condition,
+ with contextual information being provided by the messages of linked
exception(s). To understand
+ the problem, it is important to read the messages associated with
<emphasis>all</emphasis> the
+ linked exceptions.</para>
<para>The following table describes some of the more common exceptions
linked to JMSException
thrown by JMS methods whilst using the client:</para>
@@ -86,6 +87,23 @@
<xref
linkend="JMS-Client-0-8-Client-Understanding-Connection-SSL"/></para></entry>
</row>
<row>
+ <entry>AMQConnectionFailure / AMQAuthenticationException</entry>
+ <entry>not allowed</entry>
+ <entry><para>Indicates that the user cannot be authenticated by the
Broker. Check the
+ username and/or password elements within the <link
+ linkend="JMS-Client-0-8-Connection-URL">Connection
URL</link>.</para></entry>
+ </row>
+ <row>
+ <entry>AMQConnectionFailure / AMQSecurityException</entry>
+ <entry>Permission denied: <emphasis>virtualhost name</emphasis>;
access refused</entry>
+ <entry><para>Indicates that the user is not authorised to connect to
the given
+ virtualhost. The user is recognised by the Broker and is using
the correct password
+ but does not have permission. This exception normally indicates
that the user (or
+ group) has not been permissioned within the Broker's <ulink
+
url="&qpidJavaBrokerBook;Java-Broker-Security-ACLs.html">Access Control List
+ (ACL)</ulink>.</para></entry>
+ </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
@@ -96,6 +114,15 @@
unexpected manner. Check the broker and the host on which it
runs and performance of
its storage.</para></entry>
</row>
+ <row>
+ <entry>AMQSecurityException</entry>
+ <entry>Permission denied: <emphasis>message varies</emphasis></entry>
+ <entry><para>Indicates that the user is not authorised to use the
given resource or
+ perform the given operation. This exception normally indicates
that the user (or
+ group) has not been permissioned within the Broker's <ulink
+
url="&qpidJavaBrokerBook;Java-Broker-Security-ACLs.html">Access Control List
+ (ACL)</ulink>.</para></entry>
+ </row>
</tbody>
</tgroup>
</table>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
