TibrvCmListener

Class

Declaration

class TibrvCmListener : TibrvEvent
    TibrvCmListener();             // Create empty.
    virtual ~TibrvCmListener();    // Destroy and reclaim storage.

Purpose

A certified delivery listener object listens for labeled messages and certified messages.

Remarks

The constructor creates a hollow object; TibrvCmListener::create() makes it operational—starting a C certified delivery listener, which represents your program’s listening interest in a stream of labeled messages and certified messages. Rendezvous software uses the same listener object to signal each occurrence of such an event.

We recommend that programs explicitly destroy each certified delivery listener object using TibrvCmListener::destroy(). Destroying a certified listener object cancels the program’s immediate interest in that event; nonetheless, a parameter to the destroy call determines whether certified delivery agreements continue to persist beyond the destroy call.

The destructor calls the destroy() method, unless the C object is already destroyed.

Destroying the queue, the certified delivery transport, or the transport of a listener object automatically invalidates the listener as well (but certified delivery agreements continue to persist).

Method	Description
Life Cycle
TibrvCmListener::create()	Listen for messages that match the subject, and request certified delivery when available.
TibrvCmListener::destroy()	Destroy a certified delivery listener.
TibrvCmListener::isValid()	Test whether a certified delivery listener has been destroyed.
Confirmation
TibrvCmListener::confirmMsg()	Explicitly confirm delivery of a certified message.
TibrvCmListener::setExplicitConfirm()	Override automatic confirmation of delivery for this listener.
Properties
TibrvCmListener::getSubject()	Extract the subject from a certified delivery listener.
TibrvCmListener::getTransport()	Extract the transport from a certified delivery listener.

Inherited Methods
TibrvEvent::destroy() TibrvEvent::getClosure() TibrvEvent::getHandle() TibrvEvent::getType() TibrvEvent::getQueue() TibrvEvent::isValid() TibrvEvent::isListener() TibrvEvent::isTimer() TibrvEvent::isIOEvent()

Related Classes

TibrvEvent

TibrvListener