Run PrismUI with the Command Line

Starting PrismUI Runtime from the command line allows for additional parameters to be processed on startup.

Parameters for all Projects

The below parameters are available to all projects.

Name Flags Description
Filename Enter the full file path of a project to load Runtime with that project.
Note: If there is white space in the file name, it must be surrounded with quotation marks (" ").
Set Simulation Mode
/sim
/s
Opens the Runtime application in Simulation mode.
Multiple Instance
/alwaysstart
/f
Allows more than one instance of Runtime to start.
Workstation Selection
/selectworkstation
/w
Runtime prompts the user to select a Workstation on project load.
Ignore Version Check
/noversioncheck
/i
Overrides the project level version check. Only use this if you are certain there will be no compatibility issues.

Example: Runtime.exe C:\users\jdoe\Documents\Project\proj.dprg /w /s

This will start Runtime using the proj.dprj file. Runtime will prompt to select a Workstation. Once started, Runtime will run in Simulation mode.

Example: Runtime.exe "C:\Test Configurations\Test 1.dprj"

This will start Runtime using the Test 1.dprj file. The file path is surrounded with quotation marks as it contains white space.

Security Parameters

The below parameters are only available to projects with security enabled.

Name Flags Description
Username
/u
The value provided after this flag must be the username for the user to log in to PrismUI as.
Password
/p
The value provided after this flag must be the password corresponding with the given username.
Authentication Mode
/auth
The value provided after this flag must indicate the method of authentication for this project.

Example: Runtime.exe /u Admin /p administrator27

This will start Runtime logged in as the Admin user.

Note: In the event Runtime has an unexpected shutdown, it will be rebooted using the same parameters it was initially started with. In the event Runtime has been started before any projects have been published to it, the Runtime will close and not reboot on its own.