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 Jakarta Messaging 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).