TibrvVcTransport.createAcceptVc()
Method
Declaration
TibrvVcTransportCreateAcceptVc(
TibrvTransport transport)
throws TibrvException
Purpose
Create a virtual circuit accept object.
Remarks
After this call returns, the program must extract the object’s connect subject, and send it in a message to another program, inviting it to establish a virtual circuit. Furthermore, the reply subject of that invitation message must be this connect subject. To complete the virtual circuit, the second program must extract this subject from the invitation, and supply it to TibrvVcTransport.createConnectVc().
|
Parameter |
Description |
|
|
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). |
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 on page 99 in .
See Also
TibrvVcTransport.createConnectVc()
TibrvVcTransport.getConnectSubject()