tibrvMsg_SetCMTimeLimit()

Function

Declaration

tibrv_status tibrvMsg_SetCMTimeLimit(
    tibrvMsg         message,
    tibrv_f64        timeLimit);

Purpose

Set the message time limit of a certified message.

Remarks

Every labeled message has a time limit, after which the sender no longer certifies delivery.

Sending programs can explicitly set the message time limit using this function. If a time limit is not already set for the outbound message, tibrvcmTransport_Send() sets it to the transport’s default time limit (see tibrvcmTransport_SetDefaultCMTimeLimit()); if that default is not set for the transport, the default time limit is zero (no time limit).

Time limits represent the minimum time that certified delivery is in effect.

It is meaningless for receiving programs to call this function.

Parameter

Description

message

Set the time limit of this message.

timeLimit

Use this time limit (in whole seconds) for the message. The time limit must be non-negative.

See Also

tibrvcmTransport_GetDefaultCMTimeLimit()

tibrvcmTransport_SetDefaultCMTimeLimit()

tibrvMsg_GetCMTimeLimit()