CMTransport.AddListener

Method

Visual Basic

Public Sub AddListener(
    ByVal cmName As String,
    ByVal subject As String )

C#

public void AddListener(
    string cmName,
    string 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 CMTransport.AddListener has no effect.

If the correspondent with this cmName is disallowed, CMTransport.AddListener throws an exception with status code NotPermitted. You can call CMTransport.AllowListener to supersede the effect of a prior call to CMTransport.DisallowListener; then call CMTransport.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.

See Also

Name

CMTransport.AllowListener

CMTransport.DisallowListener

CMTransport.RemoveListener

Anticipating a Listener in TIBCO Rendezvous Concepts

Top