Open topic with navigation

TIBCO Rendezvous® 8.8.0

# tibrvcmTransport_RemoveSendState()

Function

## Declaration

    tibrv_status tibrvcmTransport_RemoveSendState(
        tibrvcmTransport    cmTransport,
        const char*         subject);

## Purpose

Reclaim ledger space from obsolete subjects.

## Background

In some programs subject names are useful only for a limited time; after that time, they are never used again. For example, consider a server program that sends certified reply messages to client inbox names; it only sends one reply message to each inbox, and after delivery is confirmed and complete, that inbox name is obsolete. Nonetheless, a record for that inbox name remains in the server’s ledger.

As such obsolete records accumulate, the ledger size grows. To counteract this growth, programs can use this function to discard obsolete subject records from the ledger.

The `DELIVERY.COMPLETE` advisory is a good opportunity to clear the send state of an obsolete subject. Another strategy is to review the ledger periodically, sweeping to detect and remove all obsolete subjects.

## Remarks

Warning | Do not use this function to clear subjects that are still in use. As a side-effect, this function resets the sequence numbering for the subject, so the next message sent on the subject would be number 1. In proper usage, this side-effect is never detected, since obsolete subjects are truly obsolete.

Parameter | Description
`cmTransport` | Remove send state from the ledger of this certified delivery transport.
`subject` | Remove send state for this obsolete subject.

## See Also

tibrvcmTransport_ReviewLedger()

tibrvcmTransport_Send()

DELIVERY.COMPLETE in TIBCO Rendezvous Concepts

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.