Use these constants to specify the executionTypeMaskParam parameter of the Engine.NewExecution , Engine.NewHierarchicalExecution , and SequenceContext.NewExecution methods.

• ExecTypeMask_AutoWaitAtEndOfSequence –(Value: 0x80) Use this option to have the calling sequence wait for the launching execution to complete before the calling sequence returns. This constant applies only to the SequenceContext.NewExecution method.
• ExecTypeMask_BreakOnSequenceFailure –(Value: 0x40) Specifies whether the sequence editor and user interfaces suspend when a failing step causes a sequence failure to first occur. TestStand does not suspend on failing Sequence Call steps already in the stack. If the sequence failure setting is reset, TestStand suspends when the next failing step causes sequence failure. When this constant is not set, TestStand suspends execution based on the value of the setting in the StationOptions.BreakOnSequenceFailure property.
• ExecTypeMask_BreakOnStepFailure –(Value: 0x20) Specifies whether the sequence editor and user interfaces suspend when a step fails. TestStand does not suspend an execution on a failing Sequence Call step if the step that caused the sequence failure already suspended execution. When this constant is not set, TestStand suspends execution based on the value of the setting in the StationOptions.BreakOnStepFailure property.
• ExecTypeMask_CloseWindowWhenDone –(Value: 0x10) Directs the sequence editor and user interfaces to close the Execution window when it finishes executing.
• ExecTypeMask_DiscardArgumentsWhenDone –(Value: 0x400) Directs the execution to discard its arguments when it finishes executing. Executions normally hold arguments until the execution is destroyed so the execution can use the arguments again if the execution restarts. However, because the execution holds the arguments, arguments that contain a reference to a .NET object prevent TestStand from unloading .NET assemblies until the execution is destroyed. Use this option to avoid this situation and to ensure that TestStand more promptly cleans up arguments. When using this option, if you restart the execution, the execution no longer uses any arguments unless you use the Execution.RestartWithNewArguments method to restart it.
• ExecTypeMask_DisplayPreloadProgress –(Value: 0x200) Specifies to launch the Preload Progress dialog box while preloading code modules for the execution of a sequence file. You normally use this flag only for executions you initiate from a user interface.
• ExecTypeMask_InitiallyHidden –(Value: 0x1) Specifies that an execution does not appear in a window unless a trace or break event occurs. Typically, you use this constant for executions you do not want the user to see unless an error occurs. Use this constant with ExecTypeMask_TracingInitiallyOff flag to hide the execution even when tracing is on for the application.
• ExecTypeMask_InitiallySuspended –(Value: 0x4) Specifies that the execution is created in a suspended state. You must call the Execution.Resume method to continue execution.
• ExecTypeMask_Normal –(Value: 0) Specifies that the execution is visible in the window when it starts.
• ExecTypeMask_NotRestartable –(Value: 0x8) Specifies that the execution cannot be restarted with the Execution.RestartEx method.
• ExecTypeMask_TracingInitiallyOff –(Value: 0x2) Disables tracing for the execution. Tracing can be turned back on by either a sequence call setting or by setting the RunState.Tracing property of the sequence context to True .
• ExecTypeMask_UseSTA –(Value: 0x100) Specifies whether TestStand initializes the concurrency model of the thread as single-threaded apartment (STA) or multi-threaded apartment (MTA). By default, TestStand initializes new executions and threads to use the MTA model. A thread must use the STA model if the thread creates or launches a dialog box that contains ActiveX controls. If you use this option to launch a sequence with a step that displays an ActiveX control, you might need to set the Load Option on the Run Options tab of the Step Properties dialog box to Load dynamically . This option ensures that TestStand loads the module the step calls in the thread initialized as STA.

See Also

Engine.NewExecution

Engine.NewHierarchicalExecution

Execution.RestartEx

Execution.Resume

Execution.TypeMask

Run Options tab

SequenceContext.NewExecution

StationOptions.BreakOnSequenceFailure

StationOptions.BreakOnStepFailure

Step Properties dialog box