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


Chapter 2 Messages : tibemsMsg : tibemsMsg_SetTimestamp

tibemsMsg_SetTimestamp
Function
Purpose
Set the timestamp header of a message.
C Declaration
tibems_status tibemsMsg_SetTimestamp(
    tibemsMsg message,
    tibems_long value );
COBOL Call
CALL "tibemsMsg_SetTimestamp"
USING BY VALUE message,
BY VALUE value,
RETURNING tibems-status
END-CALL.
 
message has usage pointer.
Parameters
 
Remarks
Sending calls set the timestamp header automatically. The JMS specification defines this call for symmetry.
Sending calls record a UTC timestamp in this header, indicating the approximate time that the server accepted the message.
The value is in milliseconds since January 1, 1970 (as in Java).
Applications that do not require timestamps can reduce overhead costs by disabling timestamps; see tibemsMsgProducer_SetDisableMessageTimestamp on page 197. When the producer disables timestamps, the value of this header is zero.
See Also
tibemsMsg_GetTimestamp on page 53
tibemsMsgProducer_SetDisableMessageTimestamp on page 197

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