tibrvcmEvent_CreateListener()

Function

Declaration

tibrv_status tibrvcmEvent_CreateListener(
    tibrvcmEvent*           cmListener,
    tibrvQueue              queue,
    tibrvcmEventCallback    callback,
    tibrvcmTransport        cmTransport,
    const char*             subject,
    const void*             closure);

Purpose

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

Parameter	Description
cmListener	For each inbound message, place this listener event on the event queue. The program supplies a location, and the function stores the new listener object in that location. The event object remains valid until the program explicitly destroys it.
queue	For each inbound message, place the listener event on this event queue.
callback	On dispatch, process the event with this callback function.
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 tibrvcmEvent_CreateListener() 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.

See Also

tibrvcmEvent

tibrvcmTransport_Destroy()

tibrvEvent_GetListenerSubject()

tibrvTransport_CreateInbox()