You are here: NI Home > Support > Product Reference > Manuals > LabVIEW 8.2 Help

Method of VI.

Starts the VI execution, similar to the Run button. This method is different than calling a VI because it uses the current values of all front panel controls for execution rather than using data passed in through parameters. This method also ignores the Execution:Show Front Panel On Call property of a VI and the Execution:Close After Call property. You cannot use this method to run a VI that is already reserved for execution by another VI.

If you use the Open VI Reference function and wire the type specifier VI Refnum input, you cannot use the reference returned by the function with this method. Instead, you must use the Call By Reference Node.

If you want to use this method with a reentrant VI, set the options parameter to 0x08 in the Open VI Reference function to prepare the VI for reentrant run. Example

Parameters

Name	Description
Wait Until Done	Specifies whether to wait until the VI completes execution before the Invoke Node continues executing. The default is TRUE.
Auto Dispose Ref	If TRUE, the target VI detaches the reference from the main VI. When the target VI finishes executing, LabVIEW automatically disposes the reference, along with the parallel data space. If FALSE, the main VI retains control of the target VI. The default is FALSE. Note  If Auto Dispose Ref is TRUE and the method returns an error, LabVIEW does not dispose of the reference.

Remarks

The following table lists the characteristics of this method.

Settable when the VI is running	Yes
Need to authenticate before use	No
Loads the block diagram into memory	No
Remote access disallowed	No
Loads the front panel into memory	No
Must wait until user interface is idle	Yes
Available with control VIs	No
Available with global VIs	No
Available with strict type definitions	No
Available with polymorphic VIs	No
Available in Run-Time Engine and Real-Time Operating System	Yes (Read/Write)

Example

Refer to the DateServerUsingReentrantRun VI in the labview\examples\viserver\runvi.llb for an example of using the Run VI method.