PcVue's command line arguments can be used to perform various operations such as specifying alternative location for projects, start a specific project version, get a license from a dongle on another station, starting in VCR playback mode and much more.
To access the command line, right-click on the PcVue program icon and select Properties. If necessary, the command line arguments can be combined. For example, the following would cause the Select Project dialog to be displayed and also change the project root.
"C:\<SV target folder>\BIN\SV32.EXE" -s -b "C:\My Project Root"If parameters within the command line contain spaces, they must be enclosed in quotation marks.
For instance, using -d proj=x.y.z,lib=x.y.z with no space in parameters will work, but it is recommended to use "-d proj=x.y.z, lib=x.y.z" with quotes to accommodate the presence of space characters in parameters.
Command line options
| Argument | Parameter | Purpose |
|
-ansi -ansip |
Interpret all project plain text files, including the trace and audit files, as ANSI. Normally they are treated as ASCII. | |
|
-s |
Display the Select Project dialog when PcVue starts. |
|
|
-p |
Project name |
Run the project Project name. Project name can be up to 255 characters in length. |
|
-b |
Project root |
Use the folder specified in Project root for PcVue projects. |
|
-k |
KeyNum,SlotNum,StationID |
To get a license from a network dongle. SlotNum identifies the address from which the license is obtained: Slot 1 (NETWORK1) or Slot 2 (NETWORK2). StationID is the number of the PcVue station into which the dongle is plugged. This was mandatory when running PcVue in a session on an RDS host with a version earlier than 10.0 SP1. For later versions, -k is deprecated for this purpose. Use -WTS instead It can also be used with a classic architecture such as a single client station with a single server station that holds the license key. |
|
-WTS |
ProjectName, ClientStationListName |
Run PcVue in a Windows Remote Desktop Session on RDS, and automatically get the station number from the ClientStationListName. The -WTS and -Station_Number command line arguments cannot be used altogether as both set the station number. |
|
-Station_Number |
StationNumber |
Run PcVue as station number StationNumber. Overrides the station number in INI.DAT. The -WTS and -Station_Number command line arguments cannot be used altogether as both set the station number. |
|
-r |
Start the reference version of the project and libraries. |
|
| -r_delta |
Start the reference version of the project and libraries. Only those files that have changed are copied from the reference project. |
|
| -preref |
Start the pre-reference version of the project and libraries. |
|
|
-d |
Display the Version Selector dialog when PcVue starts. Here the Version Selector displays development, operational and reference versions. |
|
| -d | "proj=x.y.z, lib=x.y.z" | Starts the specified version of project and libraries. You can either omit the proj or lib parameter, or use both together. |
|
-d |
"tag_proj=myProjTag [tag lib=myLibTag]"
"tag_lib=myLibTag [tag_proj=myProjTag]" |
Starts the version of the project and libraries specified by the associated tags. If tag_lib or tag_proj is omitted, the local project or libraries are used. In case the the specified tag is not associated to any project or library version, a message is logged in the Event viewer. |
|
-x |
Display the Version Selector dialog when PcVue starts. Here the Version Selector displays operational and reference versions only. |
|
|
-vcr |
Starts PcVue in VCR playback mode. See topic The VCR facility for more information. |
|
| -vcrrecordall |
Forces all variables to be recorded in the VCR archive unit. See topic The VCR facility for more information. |
For more information on command line arguments that start the project version refer to the topic How to select a project version at start-up.