Open topic with navigation

TIBCO Rendezvous® 8.7.0

# 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

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-2023. Cloud Software Group, Inc. All Rights Reserved.