Dynamically Set the Client Sequence File

Purpose

This example demonstrates how to dynamically specify a client sequence file. This example uses the Execution.ClientFile property to set the client sequence file of the process model.

Example File Location

<TestStand Public>\Examples\Modifying Process Models\Dynamically Setting the Client Sequence File\Dynamically Set the Client Sequence File.seq

Highlighted Features

• TestStand API
• Process model plug-in architecture

Major API

• Engine.GetSequenceFileEx
• Execution.ClientFile
• Engine.ReleaseSequenceFileEx

Prerequisites

None

How to Use This Example

When you run this example, TestStand prompts you to select Sequence A or Sequence B to run as the client sequence file of the process model. Run the example several times using the Test UUTs or Single Pass Execution entry points and review the report, which includes information relevant to the sequence file you selected.

Open the process model plug-in file, DynamicClientFileExampleModelPluginAddon.seq, associated with this example. Notice that the Model Plugin - Pre UUT sequence sets the Execution.ClientFile property to the file you select at run time.

Complete the following steps to use this example.

1. Open <TestStand Public>\Examples\Modifying Process Models\Dynamically Setting the Client Sequence File\Example -Dynamically Set the Client Sequence File.seq, read the dialog box that appears, and dismiss the dialog box.
2. Select Execute»Single Pass. Select the sequence you want to run when prompted.
3. Review the report that TestStand displays when execution completes.
4. Repeat steps 2-3 but select Execute»Test UUTs to run the sequence using the Test UUTs Execution entry point.

The example copies the DynamicClientFileExampleModelPluginAddon.seq file from the <TestStand Public>\Examples directory to the <TestStand Public>\Components\ModelsPlugins\Addons directory so that the process model automatically executes the Model Plugin - Pre UUT sequence in the file. If you want to set a breakpoint in the Model Plugin - Pre UUT sequence, set the breakpoint in the copy of the file in the <TestStand Public>\Components\ModelsPlugins\Addons directory. If you make any changes to the file in the Addons directory you must change the name of the file because the Example - Dynamically Set the Client Sequence File.seq file overwrites the DynamicClientFileExampleModelPluginAddon.seq file in the Addons directory when you load the Example - Dynamically Set the Client Sequence File.seq file and deletes the DynamicClientFileExampleModelPluginAddon.seq file from the Addons directory when you unload the Example - Dynamically Set the Client Sequence File.seq file.