tibrvcmTransport_AddListener()

Function

Declaration

tibrv_status tibrvcmTransport_AddListener(
    tibrvcmTransport    cmTransport,
    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 sender 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 code 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 function to anticipate listeners; the anticipated listening programs must also require old messages when creating certified delivery transports.

Parameter	Description
cmTransport	Instruct this transport to pre-register the named listeners.
cmName	Anticipate a listener from a correspondent with this reusable name.
subject	Anticipate a listener for this subject. Wildcard subjects are illegal.

See Also

Name

tibrvcmTransport_AllowListener()

tibrvcmTransport_DisallowListener()

tibrvcmTransport_RemoveListener()

Anticipating a Listener in TIBCO Rendezvous Concepts