tibrv_Open()

Function

Declaration

tibrv_status tibrv_Open(void);
tibrv_status tibrv_OpenEx(
    const char    *pathname);

Purpose

Create and 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, queues, and transports are unusable. However, calls that manipulate messages do not require this machinery, and programs may use them before calling tibrv_Open().

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.

IPM

Programs that use IPM can start the Rendezvous machinery either with tibrv_Open or with tibrv_OpenEx. The extended call is available only with IPM. When IPM is not available, the extended call fails with error status.

The extended call accepts a filepath name, which explicitly specifies a configuration file. IPM reads parameter values from that file.

Parameter	Description
`pathname`	Programs that use IPM can supply a filepath name, which explicitly specifies a configuration file. IPM reads parameter values from that file. For details, see Configuring IPM in TIBCO Rendezvous Concepts. When IPM is not available, this version of the method fails with error status. Not supported for Visual Basic.

Parameter

Description

pathname

Programs that use IPM can supply a filepath name, which explicitly specifies a configuration file. IPM reads parameter values from that file.

For details, see Configuring IPM in TIBCO Rendezvous Concepts.

When IPM is not available, this version of the method fails with error status.

Not supported for Visual Basic.

IPM: Specifying a Configuration File

char* cfgfile = "/var/tmp/mycfgfile"
tibrv_OpenEx(cfgfile);