Tibrv::open()
Method
Declaration
static TibrvStatus open();
Purpose
Start Rendezvous internal machinery.
Remarks
This call creates the internal machinery that Rendezvous software requires for its operation:
| • | Internal data structures. |
| • | Default event queue. |
| • | Intra-process transport. |
| • | Event driver. |
Until the first call to Tibrv::open() creates the internal machinery, all events, transports, queues and queue groups are unusable. Messages and their methods do not depend on the internal machinery.
Reference Count
A reference count protects against interactions between programs and third-party packages that call Tibrv::open() and Tibrv::close(). Each call to Tibrv::open() increments an internal counter; each call to Tibrv::close() decrements that counter. A call to Tibrv::open() actually creates internal machinery only when the reference counter is zero; subsequent calls merely increment the counter, but do not duplicate the machinery. A call to Tibrv::close() actually destroys the internal machinery only when the call decrements the counter to zero; other calls merely decrement the counter. In each program, the number of calls to Tibrv::open() and Tibrv::close() must match.