[TIBCO.EMS .NET client library 6.0 documentation]

Defines the name of the provider property controlling if ExceptionListener set on the Connection should be called for all the following events: disconnected, each reconnect attempt, and reconnected.

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

Syntax

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

Remarks

Similarly to Tibems.PROP_FT_SWITCH_EXCEPTION, if this property is set and if a Connection's ExceptionListener is set, (and the connection has FT urls), then all above events will trigger the call to the ExceptionListener.OnException callback with an EMSException which has the vendor error code (EMSException.ErrorCode) set to the String in the form:

 Copy Code
FT-SWITCH: event

where event is:

  • Disconnected from server url, will attempt to reconnect
  • Reconnecting to next server url, attempt n out of m
  • Reconnected to server url

An application can recognize such calls by analyzing the error code in the passed EMSException and perform necessary actions. Notice that this property replaces the property Tibems.PROP_FT_SWITCH_EXCEPTION, which means that if both are set, only one "reconnected" event will be passed to the ExceptionListener.OnException callback (the one described above). We recommend that if Tibems.PROP_FT_SWITCH_EXCEPTION was formerly used, and the user wishes to capture all FT events, this new property be used instead and the ExceptionListener.OnException callback modified to handle these new vendor error codes.

This property is defined as string "tibco.tibjms.ft.events.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