[TIBCO.EMS .NET client library 7.0 documentation]
Assembly: TIBCO.EMS (in TIBCO.EMS.dll)
Defines the name of the provider property controlling if ExceptionListener
set on the Connection should be called during fault-tolerant switch.
Namespace:
TIBCO.EMSAssembly: TIBCO.EMS (in TIBCO.EMS.dll)
Syntax
Remarks
When an application performs fault-tolerant switch it may notify
the Connection's ExceptionListener by calling it with EMSException
providing the information about fault-tolerant switch. If this property
is set, the Connection's ExceptionListener is called with the EMSException
which has the vendor error code (EMSException.getErrorCode()) set to
the string in the form:
FT-SWITCH: <new-server-url>
An application can recognize such calls by analyzing the error code
in the passed EMSException and perform necessary actions. Notice that
the ExceptionListener is called with the special EMSException
only when fault-tolerant switch has been performed succesfully. In case
the fault-tolerant switch has failed, the Connection's ExceptionListener
will be called with regular EMSException (it will not have error code in the
form 'FT-SWITCH: <new-server-url>' specifying that the connection to
Server has been terminated. Notice that if this property is not
set then by default Connection's ExceptionListener is not called
after a successfull fault-tolerant switch.
This property is defined as string "tibco.tibjms.ft.switch.exception". NOTE: when the exception listener is called, the exception listener is not allowed to call any EMS method. To do so in this case risks a deadlock in the client.