Table Of Contents

Connect (G Dataflow)

Last Modified: September 26, 2018

Connects routes as defined by the connection specification and supports multiconnect mode.

connector_pane_image
datatype_icon

multiconnect mode

Connection mode that defines whether a route can be connected multiple times or must be disconnected before it can be reconnected.

Name Value Description
Use Default Mode -1

Uses the mode selected as the default for the route in the Switch Executive virtual device configuration. If a default multiconnect mode has not been set for the route, this input defaults to Multiconnect Routes.

Multiconnect Routes 1

Routes defined by the connection specification input can be connected multiple times. The first call to Connect performs the physical hardware connection. Successive calls to Connect increase a connection reference count. Similarly, calls to Disconnect decrease the reference count. When the reference count reaches zero, the hardware is physically disconnected. Multiconnecting routes applies to entire routes and not to route segments.

No Multiconnect 0

Routes defined by the connection specification input must be disconnected before they can be reconnected. Calling Connect on a connected route that was connected using No Multiconnect mode results in an error condition.

Default: Use Default Mode

datatype_icon

session in

Handle that identifies your Switch Executive virtual device session previously allocated by Open Session.

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

connection specification

String defining the channel connections to be made.

datatype_icon

wait for debounce

Boolean value that controls whether switches wait to debounce.

True Waits for all switches to debounce.
False Immediately returns after the switch control is completed.
datatype_icon

session out

Reference to your virtual device session to wire to the next node.

datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Route Connection Behavior With Error Conditions

In the event of an error, Connect attempts to undo any connections made so that the system is left in the same state it was in before the call to Connect. Some errors can be caught before manipulating hardware, but it is possible that a hardware call could fail, causing some connections to be momentarily closed and then reopened.

Where This Node Can Run:

Desktop OS: Windows

FPGA: Not supported

Web Server: Not supported in VIs that run in a web application


Recently Viewed Topics