TibrvCmTransport::addListener()

Method

Declaration

TibrvStatus addListener(
    const char* cmName,
    const char* subject);

Purpose

Pre-register an anticipated listener.

Remarks

Some sending programs can anticipate requests for certified delivery—even before the listening programs actually register. In such situations, the sending transport can pre-register listeners, so Rendezvous software begins storing outbound messages in the sender’s ledger; when the listener requests certified delivery, it receives the backlogged messages.

If the correspondent with this cmName already receives certified delivery of this subject from this sender transport, then TibrvCmTransport::addListener() has no effect.

If the correspondent with this cmName is disallowed, TibrvCmTransport::addListener() returns the status TIBRV_NOT_PERMITTED. You can call TibrvCmTransport::allowListener() to supersede the effect of a prior call to TibrvCmTransport::disallowListener(); then call TibrvCmTransport::addListener() again.

It is not sufficient for a sender to use this method to anticipate listeners; the anticipated listening programs must also require old messages when creating certified delivery transports.

Parameter	Description
`cmName`	Anticipate a listener from a correspondent with this reusable name.
`subject`	Anticipate a listener for this subject. Wildcard subjects are illegal.

TibrvCmTransport::addListener()

Declaration

Purpose

Remarks

See Also