TibrvCmListener::create()

Method

Declaration

TibrvStatus create(
    TibrvQueue* queue,
    TibrvCmMsgCallback* cmMsgCallback,
    TibrvCmTransport* cmTransport,
    const char* subject,
    const void* closure = NULL);

Purpose

Listen for messages that match the subject, and request certified delivery when available.

Parameter	Description
`queue`	For each inbound message, place the listener event on this event queue.
`cmMsgCallback`	On dispatch, process the event with this callback object.
`cmTransport`	Listen for inbound messages on this certified delivery transport.
`subject`	Listen for inbound messages with subjects that match this specification. Wildcard subjects are permitted. The empty string is not a legal subject name.
`closure`	Store this closure data in the event object.

Activation and Dispatch

Details of listener event semantics are identical to those for ordinary listeners; see Activation and Dispatch.

Inbox Listener

To receive unicast (point-to-point) messages, listen to a unique inbox subject name. First call TibrvTransport::createInbox() to create the unique inbox name; then call TibrvListener::create() to begin listening. Remember that other programs have no information about an inbox until the listening program uses it as a reply subject in an outbound message.

TibrvCmListener::create()

Declaration

Purpose

Activation and Dispatch

Inbox Listener

See Also