[TIBCO.EMS .NET client library 7.0 documentation]

Gets and Sets the time to live property of the message producer.

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

Syntax

public long TimeToLive { get; set; }
Public Property TimeToLive As Long
public:
property long long TimeToLive {
	long long get ();
	void set (long long value);
}

Remarks

Time-to-live (in milliseconds) determines the expiration time of a message.

  • If the time-to-live is non-zero, the expiration is the sum of that time-to-live and the sending client’s current time (GMT). This rule applies even within sessions with transaction semantics—the timer begins with the send call, not the commit call.
  • If the time-to-live is zero, then expiration is also zero—indicating that the message never expires.

Programs can use this property to define a default time-to-live for messages that this producer sends. Individual sending calls can override this default value.

Whenever your application uses non-zero values for message expiration or time-to-live, you must ensure that clocks are synchronized among all the host computers that send and receive messages. Synchronize clocks to a tolerance that is a very small fraction of the smallest or time-to-live.

See Also