Running VeriStand Operations Using the Command Line

Use the command line to execute processes in VeriStand, such as deploying or closing a project.

Commands can be used while VeriStand is open or closed.

  1. Open a command prompt.
  2. Change directories to the location of the VeriStand executable.
  3. Execute one of the following commands using the following syntax: VeriStand.exe /<command>.
    Note You can use a slash (/), a dash (-), or two dashes (--) before each command. Commands are not case sensitive. For example, /deploy and --DePloY are equivalent commands.
    Command Description
    closeAllFiles Closes all open files prompting if there are any unsaved changes.
    closeFile <relative path to project file> Closes individual project files if they are open prompting if there are any unsaved changes. This command can be repeated multiple times to open multiple files. For example: /closeFile "logging.nivslspec" /closeFile "screen.nivsscr" will close both files.
    closeProject Closes the current project prompting if there are any unsaved changes.
    connect Connects to a deployed system on the gateway. This command executes after commands for creating the project, opening the project, and modifying the system definition. This command is ignored if deploy is also specified. An error returns if a system is not deployed but a project is open.
    disconnect Disconnects from a deployed system on the gateway.
    deploy Deploys the system to the gateway and connects to it. This command executes after commands for creating the project, opening the project, and modifying the system definition.
    editScreen Turns operate mode off to unlock the screen for editing. This can be used to reverse the operateScreen or operateOnly commands while VeriStand is running.
    forceCloseAllFiles Closes all open files and discards unsaved changes.
    forceCloseFile <relative path to project file> Closes individual project files if they are open and discards unsaved changes. This command can be repeated multiple times to open multiple files. For example: /forcecloseFile "logging.nivslspec" /forcecloseFile "screen.nivsscr" will close both files.
    forceCloseProject Closes the current project and discards unsaved changes.
    gateway <IP address or hostname> Specifies the given IP address or hostname as the gateway.
    help Opens the VeriStand manual to Running VeriStand Operations Using the Command Line.
    nivsprj <file path to .nivsprj file> Opens the specified project. If the project does not exist, VeriStand creates it using the default project template. If VeriStand has a different project open, a dialog box will ask you to save and close it.
    noDeployKeys Disables the keyboard shortcuts for deploy (F6) and undeploy (F7). This command does not disable the Operate menu or the deploy and undeploy commands.
    openDocument <relative path to project file> Operates similar to openFile normally. However, a legacy .nivsproj VeriStand project path works like openLegacyProject for backward compatibility.
    openFile <relative path to project file> Opens individual project files. This command can be repeated multiple times to open multiple files (with the last file getting focus). For example: /openFile "logging.nivslspec" /openFile "screen.nivsscr" will open both files and leave screen.nivsscr with focus.
    openLegacyProject <file path to legacy .nivsproj file> Converts a legacy .nivsproj VeriStand project into a .nivsprj file and opens it.
    openProject <file path to .nivsprj file> Opens the specified project. If the project does not exist, VeriStand creates it using the default project template. If VeriStand has a different project open, a dialog box will ask you to save and close it.
    operateOnly Turns operate mode on to lock the screen. When operate mode is on, you cannot resize, move, or edit the controls in the screen document. This command disables the screen document unlock button.
    operateScreen Turns operate mode on to lock the screen. When operate mode is on, you cannot resize, move, or edit the controls in the screen document. This command disables the screen document unlock button.
    sysDef <file path to .nivssdf system definition file> Loads the system definition into an open or specified project. If you create a new project with the nivsprj or openProject commands, the specified system definition is used instead of the default template. This command does not work if the gateway is currently connected or connecting. This command executes before the connect command.
    undeploy Removes deployed system from the gateway. This command works on connected and disconnected systems.