WebSphere Message Service Client for C/C++, Version 2.0.2 Operating Systems: AIX, Linux, Solaris, Windows

ExceptionListener

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

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.

Functions

Summary of functions:
Function Description
onException Notify the application of a problem with a connection.

onException – On Exception

Interface:
xmsVOID onException(xmsCONTEXT context,
                    xmsHErrorBlock errorBlock);

Notify the application of a problem with a connection.

onException() is the exception listener function that is registered with the connection. The name of the function does not have to be onException.

For more information about using exception listener functions, see Exception listener functions in C.

Parameters:
context (input)
A pointer to the context data that is registered with the connection.
errorBlock (input)
The handle for an error block created by XMS.

Reference topic

Terms of Use | Rate this page

Last updated: 24 May 2011

(C) Copyright IBM Corporation 2005, 2011. All Rights Reserved.