ProcessCommandLine Property

TestStand 2017 Help

Edition Date: November 2017

Part Number: 370052W-01

»View Product Info

Download Help (Windows Only)
NI TestStand 2014 Help
NI TestStand 2014 SP1 Help
TestStand 2016 Help
TestStand 2016 SP1 Help
TestStand 2017 Help

Syntax

ApplicationMgr.ProcessCommandLine

Data Type

Boolean

Purpose

When this property is True, the Application Manager control processes the following switches on the command line:

  • /editor—Enables the application to create and edit sequence files. You must have activated a license that supports creating and editing sequence files.
  • /goto <location>—Instructs the application to display the item the <location> property object path specifies, such as
    TestExec.exe C:\example.seq /goto "Seq[\"MainSequence\"].Main[\"Power On\"]"

    TestExec.exe C:\example.seq /goto "Seq[\"MainSequence\"].Main[\"ID#:JifH4ODTf0y1z7bJne0G7D\"]"

    TestExec.exe C:\example.seq /goto "Seq[1].Main[4].TS.LoadOpt"
  • /operatorinterface—Prevents the application from creating and editing sequence files.
    Note  You can use / or - to specify a switch. Quotation marks are required for arguments that contain a space, such as "Test UUTs" and "C:\My Documents\Test Sequence.seq".
  • /outputToStdIO—Writes the status of completed executions to standard output. When you run a user interface from the command line, the console window displays the text written to standard output.
  • /quit—Exits the application once all executions complete.
  • /run <sequence> <sequencefile>—Runs the sequence in the sequence file.
  • /runEntryPoint <entryPointName> <SequenceFile>—Runs the entry point on the sequence file.
  • /setCurrentDir—Sets the current directory to the first directory in the directory history list in the File dialog box. The current directory is the directory the File dialog box initially displays when you open a file. Use this option to set the directory the File dialog box displays to the directory the File dialog box displayed the last time you ran the application. The application sets the current directory after processing the other command-line options.
  • /useExisting—Prevents a second instance of the application from running and forwards all command-line arguments to the application that is already running.
  • /?—Launches a help dialog box, which contains a list of valid command-line arguments, and then immediately closes.

In addition to the switches, you can provide on the command line sequence filenames to load into the application.

Remarks

The ApplicationMgr.ReportError event reports errors that might occur while processing the command-line arguments.

Use the ApplicationMgr.ProcessUserCommandLineArguments event to process command-line arguments the Application Manager control does not recognize as custom command-line arguments.


See Also

ApplicationMgr.CommandLineArguments

ApplicationMgr.ProcessUserCommandLineArguments

ApplicationMgr.ReportError

TestStand Licensing Options

WAS THIS ARTICLE HELPFUL?

Not Helpful