Open topic with navigation

TIBCO Rendezvous® 8.8.0

# TibrvCmTransport::expireMessages()

Method

## Declaration

    TibrvStatus expireMessages(
        const char*    subject,
        tibrv_u64      sequenceNumber);

## Purpose

Mark specified outbound CM messages as expired.

## Remarks

This call checks the ledger for messages that match both the subject and sequence number criteria, and immediately marks them as expired.

Once a message has expired, the CM transport no longer attempts to redeliver it to registered listeners.

Rendezvous software presents each expired message to the sender in a `DELIVERY.FAILED` advisory. Each advisory includes all the fields of an expired message. (This call can cause many messages to expire simultaneously.)

Warning | Use with extreme caution. This call exempts the expired messages from certified delivery semantics. It is appropriate only in very few situations. For example, consider an application program in which an improperly formed CM message causes registered listeners to exit unexpectedly. When the listeners restart, the sender attempts to redeliver the offending message, which again causes the listeners to exit. To break this cycle, the sender can expire the offending message (along with all prior messages bearing the same subject).

Parameter | Description
`subject` | Mark messages with this subject. Wildcards subjects are permitted, but must exactly reflect the send subject of the message. For example, if the program sends to `A.*` then you may expire messages with subject `A.*` (however, `A.>` does not resolve to match `A.*`).
`sequenceNumber` | Mark messages with sequence numbers less than or equal to this value.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2025. Cloud Software Group, Inc. All Rights Reserved.