WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 Operating Systems: Linux, Windows

ExceptionListener

An application uses an exception listener to be notified asynchronously of a problem with a connection.

Inheritance hierarchy:
None

If an application uses a connection only to consume messages asynchronously, and for no other purpose, then the only way the application can learn about a problem with the connection is by using an exception listener. In other situations, an exception listener can provide a more immediate way of learning about a problem with a connection than waiting until the next synchronous call to XMS.

Methods

Summary of methods:
Method Description
onException Notify the application of a problem with a connection.

onException – On Exception

Interface:
virtual xmsVOID onException(Exception *exception);

Notify the application of a problem with a connection.

onException() is a method of the exception listener that is registered with the connection. The name of the method must be onException.

For more information about using exception listeners, see Using exception listeners in C++.

Parameters:
exception (input)
A pointer to an exception created by XMS.
Returns:
Void

Reference topic

Terms of Use | Rate this page

Last updated: 7 Dec 2005

© Copyright IBM Corporation 2005. All Rights Reserved.