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.

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. [V8.0.0.2 Feb 2015]This is the default value from IBM MQ 8.0.0, Fix Pack 2 (see JMS: Exception listener changes in Version 8.0).

Environment Value
JMS Administration Tool CONNECTIONBROKEN
Programmatic WMQCONSTANTS.ASYNC_EXCEPTIONS_CONNECTIONBROKEN = 1
MQ Explorer Connection Broken
The following additional constant is defined:
  • [V8.0.0.2 Feb 2015]From Version 8.0.0, Fix Pack 2: WMQCONSTANTS.ASYNC_EXCEPTIONS_DEFAULT = ASYNC_EXCEPTIONS_CONNECTIONBROKEN
  • Before Version 8.0.0, Fix Pack 2: WMQCONSTANTS.ASYNC_EXCEPTIONS_DEFAULT = ASYNC_EXCEPTIONS_ALL