[TIBCO.EMS .NET client library 6.0 documentation]

Asynchronously detect problems with connections.

Namespace:  TIBCO.EMS
Assembly:  TIBCO.EMS (in TIBCO.EMS.dll)

Syntax

public interface IExceptionListener
Public Interface IExceptionListener
public interface class IExceptionListener

Remarks

The client implements the IExceptionListener interface, and registers it with the Connection object. If the client detects a serious problem with the Connection object, it informs the IExceptionListener by calling the listener's OnException(EMSException) method, passing it a EMSException argument describing the problem.

An exception listener allows a client to be notified of a problem asynchronously. Some connections only consume messages, so they would have no other way to learn that their connection has failed.

The client will first attempt to resolve connection problems before it notifies the client of them.

IExceptionListener mimics the way in which JMS detects this type of problem in a Java programming idiom. In contrast, EMSExceptionHandler provides similar functionality in a .NET idiom. Programmers may select either idiom—but not both (which would cause duplicate exception processing, with undefined behavior).

See Also