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.
Note: message has usage pointer.

Parameters

Parameter Description
message Set the timestamp of this message.
value Set the timestamp to this value.

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

See Also

tibemsMsg_GetTimestamp

tibemsMsgProducer_SetDisableMessageTimestamp