Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 5 Producer : tibemsMsgProducer : tibemsMsgProducer_GetTimeToLive

tibemsMsgProducer_GetTimeToLive
Function
Purpose
Get the time-to-live property of a producer object.
C Declaration
tibems_status tibemsMsgProducer_GetTimeToLive(
    tibemsMsgProducer msgProducer,
    tibems_long* timeToLive );
COBOL Call
CALL "tibemsMsgProducer_GetTimeToLive"
USING BY VALUE msgProducer,
BY REFERENCE timeToLive,
RETURNING tibems-status
END-CALL.
 
msgProducer has usage pointer.
Parameters
 
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.
 
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.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved