Open topic with navigation

TIBCO Rendezvous® 8.8.0

# TibrvVcTransport::waitForVcConnection()

Method

## Declaration

    TibrvStatus waitForVcConnection(
        tibrv_f64         timeout);

## Purpose

Test the connection status of a virtual circuit.

## Remarks

This method tests (and can block) until this virtual circuit transport object has established a connection with its opposite terminal. You may call this method for either an accept terminal or a connect terminal.

This method produces the same information as the virtual circuit advisory messages—but it produces it synchronously (while advisories are asynchronous). Programs can use this method not only to test the connection, but also to block until the connection is ready to use.

For example, a program can create a terminal object, then call this method to wait until the connection completes.

Parameter | Description
`timeout` | This parameter determines the behavior of the call:
| • | For a quick test of current connection status, supply zero. The call returns immediately, without blocking.
| • | To wait for a new terminal to establish a connection, supply a reasonable positive value. The call returns either when the connection is complete, or when this time limit elapses.
| • | To wait indefinitely for a usable connection, supply -1. The call returns when the connection is complete. If the connection was already complete and is now broken, the call returns immediately.

Status | Description
TIBRV_OK | The connection is complete (ready to use).
TIBRV_TIMEOUT | The connection is not yet complete, but the non-negative time limit for waiting has expired.
TIBRV_VC_NOT_CONNECTED | The connection was formerly complete, but is now irreparably broken.

## See Also

TibrvVcTransport::createAcceptVc()

TibrvVcTransport::createConnectVc()

Testing the New Connection in TIBCO Rendezvous Concepts

VC.CONNECTED in TIBCO Rendezvous Concepts

VC.DISCONNECTED in TIBCO Rendezvous Concepts

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO Rendezvous®

Copyright © 1997-2025. Cloud Software Group, Inc. All Rights Reserved.