JMS providers set this field when a message is sent. This method can be used to change the value for a message that has been received.
Gets the message timestamp.
The JMSTimestamp header field contains the time a message was handed off to a provider to be sent. It is not the time the message was actually transmitted, because the actual send may occur later due to transactions or other client-side queueing of messages.
When a message is sent, JMSTimestamp is ignored. When the send or publish method returns, it contains a time value somewhere in the interval between the call and the return. The value is in the format of a normal millis time value.
Since timestamps take some effort to create and increase a message's size, some JMS providers may be able to optimize message overhead if they are given a hint that the timestamp is not used by an application. By calling the MessageProducer.setDisableMessageTimestamp method, a JMS client enables this potential optimization for all messages sent by that message producer. If the JMS provider accepts this hint, these messages must have the timestamp set to zero; if the provider ignores the hint, the timestamp must be set to its normal value.
Assembly: Kaazing.JMS (in Kaazing.JMS.dll)
Syntax
| Visual Basic |
|---|
Property JMSTimestamp As Long Get Set |
| C# |
|---|
long JMSTimestamp { get; set; } |
| Visual C++ |
|---|
property long long JMSTimestamp { long long get (); void set (long long value); } |
Return Value
the message timestamp
Exceptions
| Exception | Condition |
|---|---|
| Kaazing.JMS..::..JMSException | if the JMS provider fails to set the timestamp due to some internal error. |
| Kaazing.JMS..::..JMSException | if the JMS provider fails to get the timestamp due to some internal error. |