VCTransport.CreateAcceptVC

Method

Visual Basic

Public Shared Function CreateAcceptVC(
    ByVal transport As Transport,
    ByRef connectSubject As String )
  As VCTransport

C#

public static VCTransport CreateAcceptVC(
    Transport transport,
    out string connectSubject );

Purpose

Create a virtual circuit accept object.

Remarks

After this call returns, the program must send a message to another program, inviting it to establish a virtual circuit. Furthermore, the reply subject of that invitation message must be the connect subject (which this method creates). To complete the virtual circuit, the second program must extract this subject from the invitation, and supply it to VCTransport.CreateConnectVC.

Parameter	Description
transport	The virtual circuit terminal 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).
connectSubject	Supply a location of type string. The method creates an inbox where it can accept a request from a virtual circuit connect object, and places the inbox name in this location.

Test Before Using

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

•

The transport presents the VC.CONNECTED advisory.

•

VCTransport.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 VCTransport.WaitForVCConnection with zero as the timeout parameter.

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

See Also

VCTransport.CreateConnectVC

VCTransport.WaitForVCConnection

VC.CONNECTED in TIBCO Rendezvous Concepts

VC.DISCONNECTED in TIBCO Rendezvous Concepts