Open topic with navigation

TIBCO Rendezvous® 8.7.0

# CMListener

Class

## Superclasses

    System.Object
      Listener
        CMListener

## Visual Basic

    Public Class CMListener
      Inherits Listener

## C#

    public class CMListener : Listener

## Purpose

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

## Remarks

Each call to the constructor CMListener results in a new 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 CMListener.Destroy. Destroying a certified listener object cancels the program’s immediate interest in that event, and frees its storage; nonetheless, a parameter to the destroy call determines whether certified delivery agreements continue to persist beyond the destroy call.

Programs must destroy instances of this class. Rendezvous software keeps internal references to these objects, so the garbage collector does not delete them automatically.

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

Member | Description |
## Public Instance Properties
`Queue` | Queue The listener’s event queue. (Inherited from Listener.) | Get
`Subject` | ``string`` The listener expresses interest in this subject, and receives messages with matching destination subjects. (Inherited from Listener.) | Get
`Transport` | Transport The listener receives inbound messages from this transport. (Inherited from Listener.) | Get

Method | Description | Page
CMListener | Listen for messages that match the subject, and request certified delivery when available. | CMListener
CMListener.ConfirmMessage | Explicitly confirm delivery of a certified message. | CMListener.ConfirmMessage
CMListener.Destroy | Destroy a certified delivery listener. | CMListener.Destroy
CMListener.SetExplicitConfirmation | Override automatic confirmation of delivery for this listener. | CMListener.SetExplicitConfirmation

## Related Classes

Listener

MessageReceivedEventHandler

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.