Using Command-Line Arguments with the Offline Results Processing Utility

The following table lists the command-line arguments you can use with the offline results processing utility. Optional arguments appear in brackets. If the utility is already running, the command-line arguments apply to the running instance of the utility. You can also store the command line standard output in a log file .

Argument Action
/? Displays the help topic for the utility.
/env <environment path> Launches the utility in the specified environment. <environment path> specifies the location of the .tsenv file for the environment.Click here for more information about .tsenv files and here for more information about choosing an evironment with the /env command line switch.
/exit-when-done [ seconds ] Instructs the utility to exit automatically when all active profiles finish processing files successfully. The utility must process at least one file before exiting. If the utility is already running, this command has no effect. [seconds] specifies the number of seconds to wait after all active profiles finish processing before exiting. The default value is 30 seconds.
/process-all-profiles Activates all profiles.
/hide-splash-screen Hides the splash screen at launch.
/log-level < log level > Uses a number or a string to specify one of the following values for a supported severity level to log. Passing an invalid value disables logging.
  • 0 or Debug —Debugging information.
  • 1 or Info —Run-time events that provide information on the state of the system.
  • 2 or Warn —Warnings that are not errors but that might indicate an underlying error.
  • 3 or Error —Run-time errors or unexpected conditions.
  • 4 or Fatal —Severe errors that might limit the functionality of or terminate the offline results processing utility.
  • 5 or DisableLogging —Disables logging.
/process-files < profile > < one or more filenames > Activates the profile you specify and copies all the files you specify to the outbox directory of the profile for processing. Use quotation marks to escape profile names or filenames that include spaces. Example: OfflineResultsProcessingUtility.exe "Profile Name" file1.txt "C:\Documents and Settings\file2.txt"
/process-files-missing-data Automatically processes files with missing data. Files might not include all necessary data because the execution that created the file terminated or aborted while TestStand was generating results. You can review the log file to determine the files with missing data. If you automatically process files with missing data, TestStand returns a warning, which you can log by using a log level of 2 , 1 , or 0 . TestStand returns an information message for files with missing data that you do not process, which you can log by using a log level of 1 or 0 .
/process-no-profiles Deactivates all profiles.
/process-profiles < one or more profile names > Activates the profiles with the names you specify in the list of profiles. Use quotation marks to escape profile names that include spaces. Example: OfflineResultsProcessingUtility.exe Profile1 "Profile Name With Spaces" Profile3
/quit Stops the utility after the currently processing raw results files finish processing.
/tray Sends the utility to the Microsoft Windows System Notification Area (system tray) of the taskbar.

See Also

Logging Offline Results Processing Utility Messages to a File