[TIBCO.EMS .NET client library 5.1 documentation]

Defines the name of the provider property controlling if ExceptionListener set on the Connection should be called during fault-tolerant switch.

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

Syntax

public const string PROP_FT_SWITCH_EXCEPTION
Public Const PROP_FT_SWITCH_EXCEPTION As String
public:
literal String^ PROP_FT_SWITCH_EXCEPTION

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.

See Also