TibrvVcTransport::createConnectVc()

Method

Declaration

TibrvStatus createConnectVc(
    const char*        connectSubject,
    TibrvTransport*    transport);

Purpose

Create a virtual circuit connect object.

Remarks

This method creates a C connect transport and stores its handle in the C++ object.

Parameter	Description
connectSubject	The connect transport uses this connect subject to establish a virtual circuit with an accept transport in another program. The program must receive this connect subject from the accepting program. The call to TibrvVcTransport::createAcceptVc() creates this subject.
transport	The virtual circuit uses this ordinary transport for communications. Programs may use this transport for other purposes. It is illegal to supply a virtual circuit transport object for this parameter (that is, you cannot nest a virtual circuit within another virtual circuit).

Test Before Using

Either of two conditions indicate that the connection is ready to use:

•

The transport presents the VC.CONNECTED advisory.

•

TibrvVcTransport::waitForVcConnection() returns without error.

Procedure 

Immediately after this call, test both conditions with these two steps (in this order):

1.

Listen on the virtual circuit transport object for the VC.CONNECTED advisory.

2.

Call TibrvVcTransport::waitForVcConnection() with zero as the timeout parameter.

For an explanation, see Testing the New Connection in TIBCO Rendezvous Concepts.

See Also

TibrvVcTransport::createAcceptVc()

TibrvVcTransport::waitForVcConnection()

VC.CONNECTED in TIBCO Rendezvous Concepts

VC.DISCONNECTED in TIBCO Rendezvous Concepts