# 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`

Copyright © Cloud Software Group, Inc. All rights reserved.