Environment.Open

Method

Visual Basic

Public Shared Sub Open()

C#

public static void Open();
public static void Open(string pathname)

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

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.

Reference Count

A reference count protects against interactions between programs and third-party packages that call Environment.Open and Environment.Close. Each call to Environment.Open increments an internal counter; each call to Environment.Close decrements that counter. A call to Environment.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 Environment.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 Environment.Open and Environment.Close must match.

See Also

Environment.Close