TibrvDispatcher

Class

Declaration

class TibrvDispatcher
    TibrvDispatcher();             // Create empty.
    virtual ~TibrvDispatcher();    // Halt, destroy & reclaim storage.

Purpose

Dispatch events from a queue or queue group.

Remarks

A dispatcher thread repeatedly dispatches a queue or queue group by calling TibrvDispatchable::timedDispatch() in a loop.

The constructor produces a hollow object; TibrvDispatcher::create() fills in the C handle, which makes the dispatcher thread operational.

The destructor calls the destroy method, unless the C handle is already destroyed.

This class is a programming convenience. Programs can implement specialized dispatcher threads, and use them instead of this class.

Method

Description

TibrvDispatcher::create()

Start a dispatcher thread.

TibrvDispatcher::destroy()

Destroy a dispatcher thread.

TibrvDispatcher::getDispatchable()

Extract the queue or queue group that this thread dispatches.

TibrvDispatcher::getHandle()

Extract the C handle of this dispatcher thread.

TibrvDispatcher::getName()

Extract the name of a dispatcher thread.

TibrvDispatcher::isValid()

Test whether a dispatcher object has been destroyed.

TibrvDispatcher::setName()

Set the name of a dispatcher thread.

See Also

TibrvDispatchable::timedDispatch()

DISPATCHER.THREAD_EXITED on page 242 in TIBCO Rendezvous Concepts

tibrvDispatcher in TIBCO Rendezvous C Reference