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

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