TibrvCmTransport.expireMessages()

Method

Declaration

void expireMessages(
    String    subject,
    long      sequenceNumber)
  throws TibrvException;

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. Wild cards 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.

See Also

DELIVERY.FAILED in TIBCO Rendezvous Concepts