Open topic with navigation

TIBCO Rendezvous® 8.7.0

# 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.

## IPM: Specifying a Configuration File

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

## See Also

tibrv_Close()

Configuring IPM in TIBCO Rendezvous Concepts

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2023. Cloud Software Group, Inc. All Rights Reserved.