Actor:Launch Nested Actor VI

Owning Palette: Actor Framework VIs

Requires: Base Development System

(Filename: Actor Framework.lvlib:Actor.lvclass:Launch Nested Actor.vi)

Launches an asynchronously running VI that performs tasks and handles messages for the Nested Actor. Use this VI to launch actors that are dependent on one or more calling actors. This VI returns a reference to the enqueuer that you can use to send messages to the newly launched actor.

This VI requires the Caller Actor in input to call the Nested Actor. This VI will return an error if the Caller Actor in has not already been launched itself. Use the Launch Root Actor VI for launching an actor without a caller.

Details  

	Caller Actor in is the actor that calls Nested Actor. Caller Actor in must already be launched before calling Nested Actor, or else this VI will return an error.
	Nested Actor is the initial state of the actor you want to launch.
	Auto-stop determines whether Nested Actor stops when the calling actor stops. The default value is TRUE. If you set the value of this input to FALSE, you must manually override the Stop Core VI on the caller actor to specify stop behavior for Nested Actor.
	error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
	Open Actor Core front panel? specifies whether, on launching the actor, the front panel of the Actor Core method opens. The default is FALSE. The TRUE setting causes this VI to return an error in the run-time engine. Set Open Actor Core front panel? to TRUE during code development so you can access the Abort button for the VI, which helps if you forget to stop an actor. To open the Actor Core front panel of an actor for purposes other than debugging, use the Front Panel:Open method. You can also enable Show front panel when called on the Customize Window Appearance dialog box to configure this VI to open the Actor Core front panel when you call the actor.
	Caller Actor out returns the modified caller actor. The caller actor has a record of Nested Actor. The caller actor uses the record of Nested Actor to auto-stop the Nested Actor if Auto-stop? is set to true.
	Nested Actor's Enqueuer returns the reference to the enqueuer. Use this reference to send messages to the newly launched actor.
	error out contains error information. This output provides standard error out functionality.

Actor:Launch Nested Actor Details

Refer to the Actor Framework template for more information about the Actor Framework. To use the Actor Framework template, click Create Project from the LabVIEW start screen and select Actor Framework.