Copyright © Cloud Software Group, Inc. All Rights Reserved

Virtual Circuit API

The virtual circuit API consists of three calls (see Table 22) and two advisory messages.

Create Terminals

Two calls create the terminal objects—one call for the terminal that accepts connections, and one for the terminal that subsequently connects to it.

The two types of terminal play complementary protocol roles as they attempt to establish a connection. However, this difference soon evaporates. After the connection is complete, the two terminals behave identically.

Testing the Connection

A third call tests the current status of the connection. Programmers can arrange for this call to return immediately, or block until the connection is complete (wait for connection).

Other Transport Calls

Programs send messages, create inbox names, and create listeners using the same calls as for ordinary transports.

 

Table 22 Virtual Circuit Calls (Sheet 1 of 2)

C	tibrvTransport_CreateAcceptVc() tibrvTransport_CreateConnectVc() tibrvTransport_WaitForVcConnection()
C++	TibrvVcTransport TibrvVcTransport::createAcceptVc() TibrvVcTransport::createConnectVc() TibrvVcTransport::waitForVcConnection()
Java	TibrvVcTransport TibrvVcTransport.createAcceptVc() TibrvVcTransport.createConnectVc() TibrvVcTransport.waitForVcConnection()
.NET	VCTransport.CreateAcceptVC VCTransport.CreateConnectVC VCTransport.WaitForVCConnection

Advisories

Advisory messages report connection status changes asynchronously; see VC.CONNECTED on page 266, and VC.DISCONNECTED on page 267.

 

Copyright © Cloud Software Group, Inc. All Rights Reserved