Wait Options Tab

Use the Wait Options tab in the Configure Call Executable dialog box in a TestStand User Interface to specify whether the step waits for the call to complete and to specify additional actions to perform based on the exit code from the call.

The Wait Options tab contains the following options:

• Wait Condition —Specifies whether the step waits for the executable to exit. The possible values are No Wait, Wait For Exit, and Wait For Specified Time. If you select Wait For Specified Time and the executable process does not exit before the time limit you specify expires, the step sets Step.Result.Error.Occurred to indicate a run-time error. Use the Time to Wait option to specify a time limit for the process.
• Time to Wait (sec) —Amount of time the step waits for the executable to exit before indicating a run-time error. This option applies only when you set Wait Condition to Wait For Specified Time.
• Exit Code Status Action —Specifies whether the step sets the status to Failed in response to the exit code the executable returns. You can choose to set the step status if the exit code is less than zero, greater than zero, equal to zero, or not equal to zero.
• Exit Code Error Action —Specifies whether the step sets the status to Error in response to the exit code the executable returns. You can choose to set the step status if the exit code is less than zero, greater than zero, equal to zero, or not equal to zero. This setting takes precedence over the Exit Code Failure Condition setting when both conditions are met.
• Set Error.Code to Exit Code —When you enable this option, the step assigns the exit code from the executable to Step.Result.Error.Code .
• Terminate Call If Step Is Terminated Or Aborted —When you enable this option, the step terminates the executable process when the operator terminates or aborts the execution. This option applies only when you set Wait Condition to Wait For Exit or Wait For Specified Time and the step is waiting on the call.
• Store Process Handle —When you enable this option, the step stores the Microsoft Windows handle of the process the step creates in a variable or property. This option is not available when calling remote executables.
  • Process Handle Location —Variable or property in which to store the Windows handle for the process the step creates. In order to avoid leaking resources, you must close the handle using the Windows CloseHandle function when you no longer need the handle.