Owning Palette: Advanced VIs (Actor Framework)
Requires: Base Development System
Provides access the To-Self and To-Caller message queues for an actor without launching the actor.
Use this VI to test how an actor handles messages. Do not use this VI in code that you deploy.
|Actor in specifies the actor.|
|Actor-To-Caller Enqueuer specifies the queue the actor uses to send messages to its caller.|
|error in describes error conditions that occur before this node runs. This input provides standard error in functionality.|
|Actor out returns a duplicate of Actor in.|
|Actor-To-Self Enqueuer returns the reference to the queue the actor needs to send messages to itself.|
|Actor-To-Self Dequeuer returns the reference to the queue the actor needs to read its messages.|
|error out contains error information. This output provides standard error out functionality.|
This VI allows the Do method of a message to set the queues of an actor without launching it. This VI returns the message enqueuer and dequeuer of an actor to the caller, breaking the encapsulation around an actor. This action is useful for writing test harnesses that dequeue the message from an actor instead of the normal procedure in which the Actor Core method of an actor processes the message. This kind of test harness is useful if you want to verify that the messages the actor sends to itself are being generated properly when other methods are called.
To prevent abuse, this VI returns an error if the actor already has a queue set into it, if the queue has been released, or if the refnum is not Not A Refnum. This VI sets the actor-to-caller enqueuer that is passed in and creates the internal actor-to-self queue. You cannot release this actor-to-self queue except by halting the caller.