tibemsMsg_GetTimestamp

Function

Purpose

Get the timestamp header from a message.

C Declaration

tibems_status tibemsMsg_GetTimestamp(
    tibemsMsg message,
    tibems_long* value );

COBOL Call

CALL "tibemsMsg_GetTimestamp"
     USING BY VALUE message,
           BY REFERENCE value,
           RETURNING tibems-status
END-CALL.
Note: message has usage pointer.

Parameters

Parameter Description
message Get the timestamp from this message.
value Store the timestamp.

Remarks

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. When the producer disables timestamps, the value of this header is zero.

See Also

tibemsMsg_SetTimestamp

tibemsMsgProducer_SetDisableMessageTimestamp