ASYNCEXCEPTION
This property determines whether IBM® MQ classes for JMS informs an ExceptionListener only when a connection is broken, or when any exception occurs asynchronously to a JMS API call. This applies to all Connections created from this ConnectionFactory that have an ExceptionListener registered.
Applicable objects
ConnectionFactory, QueueConnectionFactory, TopicConnectionFactory, XAConnectionFactory, XAQueueConnectionFactory, XATopicConnectionFactory
JMS administration tool long name: ASYNCEXCEPTION
JMS administration tool short name: AEX
Programmatic access
Setters/Getters
- MQConnectionFactory.setAsyncExceptions()
- MQConnectionFactory.getAsyncExceptions()
Values
- ASYNC_EXCEPTIONS_ALL
-
Any exception detected asynchronously, outside the scope of a synchronous API call, and all connection broken exceptions are sent to the ExceptionListener.
Table 1. All async exceptions: environments and related constant names Environment Value JMS Administration Tool ALL Programmatic WMQCONSTANTS.ASYNC_EXCEPTIONS_ALL = -1 IBM MQ Explorer All - ASYNC_EXCEPTIONS_CONNECTIONBROKEN
-
Only exceptions indicating a broken connection are sent to the ExceptionListener. Any other exceptions occurring during asynchronous processing are not reported to the ExceptionListener, and hence the application is not informed of these exceptions. This is the default value from IBM MQ 8.0.0 Fix Pack 2. See JMS: Exception listener changes in IBM MQ 8.0.
Table 2. Exceptions indicating a broken connection: environments and related constant names Environment Value JMS Administration Tool CONNECTIONBROKEN Programmatic WMQCONSTANTS.ASYNC_EXCEPTIONS_CONNECTIONBROKEN = 1 IBM MQ Explorer Connection Broken The following additional constant is defined:- From IBM MQ 8.0.0 Fix Pack 2: WMQCONSTANTS.ASYNC_EXCEPTIONS_DEFAULT = ASYNC_EXCEPTIONS_CONNECTIONBROKEN
- Before IBM MQ 8.0.0 Fix Pack 2: WMQCONSTANTS.ASYNC_EXCEPTIONS_DEFAULT = ASYNC_EXCEPTIONS_ALL