Copyright © TIBCO Software Inc. All Rights Reserved

> tibems_SetExceptionOnFTEvents
> Function
> Purpose
> Sets whether exception listener is called each step of the fault-tolerant switchover process.
> C Declaration
> tibems_status tibems_SetExceptionOnFTEvents(
> tibems_bool* callExceptionListener);
> COBOL Call
> CALL "tibems_SetExceptionOnFTEvents"
> USING BY VALUE callExceptionListener,
> RETURNING tibems-status
> END-CALL.
> Remarks
> This setting determines exception behavior when the fault-tolerant client goes through phases in the failover process. If an exception listener is set on the connection, the callback is invoked when the client detects:

> • | Disconnection, or TIBEMS_SERVER_DISCONNECTED.

> • | Each reconnect attempt, or TIBEMS_SERVER_RECONNECTING.

> • | Reconnection to the server, or TIBEMS_SERVER_RECONNECTED.

> This call reports on all events during the failover process. To report only the successful reconnection event, use the tibems_setExceptionOnFTSwitch method instead.
> Parameters

> Parameter | Description
> callExceptionListener | When true, the connection’s ExceptionListener catches an exception, which contains a status code indicating the state of the fault-tolerant failover: TIBEMS_SERVER_DISCONNECTED, TIBEMS_SERVER_RECONNECTING, or TIBEMS_SERVER_RECONNECTED When false, fault-tolerant failover does not trigger an exception in the client.

> See Also
> tibems_GetExceptionOnFTEvents on page 384
> tibems_setExceptionOnFTSwitch on page 400
> Setting an Exception Listener in the TIBCO Enterprise Message Service User’s Guide

Copyright © TIBCO Software Inc. All Rights Reserved