Copyright © TIBCO Software Inc. All Rights Reserved

> tibemsMsg_SetExpiration
> Function
> Purpose
> Set the expiration header of a message.
> C Declaration
> tibems_status tibemsMsg_SetExpiration(
> tibemsMsg message,
> tibems_long value );
> COBOL Call
> CALL "tibemsMsg_SetExpiration"
> USING BY VALUE message,
> BY REFERENCE value,
> RETURNING tibems-status
> END-CALL.

> | message has usage pointer.

> Parameters

> Parameter | Description
> message | Set the expiration of this message.
> value | Set the expiration to this value.

> Remarks
> Sending calls set the expiration header automatically. The JMS specification defines this call for symmetry.
> Sending calls record the expiration time (in milliseconds) of the message in this field:

> • | If the time-to-live is non-zero, the expiration is the sum of that time-to-live and the sending client’s current time (GMT).

> • | If the time-to-live is zero, then expiration is also zero—indicating that the message never expires.

> The server discards a message when its expiration time has passed. However, the JMS specification does not guarantee that clients do not receive expired messages.
> See Also
> tibemsMsg_GetExpiration on page 42
> tibemsMsgProducer_GetTimeToLive on page 183
> tibemsMsgProducer_SetTimeToLive on page 193

Copyright © TIBCO Software Inc. All Rights Reserved