Table Of Contents
Run VI (G Dataflow)
Starts the VI execution, similar to the Run button. This node is different than calling a VI, because it uses the current values of all front panel controls for execution rather than using data passed through parameters.
You can use this node to run a reserved VI unless another calling VI is already running.
reference in
A reference to a VI.
Use Open VI Reference or Static VI Reference to obtain a valid reference for this input.
wait until done
Boolean that determines whether to wait until the referenced VI completes execution.
| True | Waits until the referenced VI completes execution. |
| False | Does not wait until the referenced VI completes execution. |
If you set this parameter to True, make sure the referenced VI terminates execution on its own.
Default: False
auto dispose
Boolean that specifies whether the compiler clears a referenced VI from memory when the panel of the VI is closed.
| True | The compiler clears the reference and memory space when the panel of the referenced VI is closed. |
| False | The compiler clears the reference but does not clear the memory space when the panel of the referenced VI is closed. |
Reference Disposal Behaviors
If True, the compiler disposes of the reference, along with the parallel data space, when the target VI goes idle, not when the VI that opened the reference goes idle. The reference can still be used by the calling VI until the target VI closes the reference. The calling VI does not need to close the reference unless Run VI returns an error. If the calling VI does close the reference, the target VI can abort and leave memory.
If True and the node returns an error, the compiler does not transfer ownership of the reference to the target VI. The compiler does not automatically dispose of the reference when the target VI goes idle.
If False, the application automatically disposes of the VI reference when the VI that opened it goes idle.
Default: False
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.
Default: No error
reference out
Unchanged reference to the same VI.
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.
Using Run VI
This node requires the referenced VI to have a panel. To use this node to retrieve data from an application, make sure you include the panel when you build the application.Using Run VI with a Reentrant VI
Use the Enable Simultaneous call on reentrant VIs configuration in the Open VI Reference node to prepare the VI for reentrant run.
Running Target VIs Asynchronously
To run a referenced VI asynchronously, use Start Asynchronous Call instead of Run VI. In addition to having a simpler interface, you can use Start Asynchronous Call to collect the outputs of the referenced VI with a corresponding Wait on Asynchronous Call.
Using Strictly Typed VI References with Run VI
A strictly typed static VI reference also reserves any subVIs when a top-level VI is reserved, thus making it ineligible for Run VI if the reserved VI does not have a caller that is already running.