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

Parameter
Description
msgProducer
Get the property from this producer.
timeToLive
The function stores the property in this location.

Remarks

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

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.


TIBCO Enterprise Message Service™ C and COBOL Reference
System Release 4.3, February 2006
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com