Open topic with navigation

TIBCO Rendezvous® 8.7.0

# 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

Subtopics

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.