Command Line Switches


Command-line switches work for both vTask itself and for compiled .EXEs.
The Help menu has a reference for all command line switches under the "Help" menu.

*Tip:  The command switches are not case sensitive: /F and /f have the same effect. Different cases are sometimes shown for clarity.

The order of switches is not important. Be sure to include quotes around filenames that contain spaces.

*Tip:  To remove ambiguity, all switches require a space following: "/r  file.vxm". The reason for this requirement is so that a file name like "FILE-LOAD.VXM" does not cause the "-L" switch to be unintentionally activated.

Command Line Switch	Purpose	Example
-e	Edit a source VXM file inside of vTask	-e C:\MyFile.vxm
-v	Run a source VXM file inside of vTask	-v C:\MyFile.vxm
-r	Run a source VXM file without opening vTask (run file by itself)	-r C:\MyFile.vxm
-s	Start run at the specified step. This setting is only valid when the -v or -r flags are also used (run script). This is similar to the "Run From Here" command inside of vTask.	-s 4 (starts execution at step #4)
-L	Turn logging ON	-L (no options)
-f	Turn logging OFF	-f (no options)
[some variable name]	Set a user variable to a value	%foo=1234 %title=Hello World
Compiler Switches
-c	The source VXM file to compile. This is a required switch.	-c C:\MyFile.vxm
-o	The output filename	-o c:\MyProgram.exe
-icon  (or -i)	Sets the icon options filename for an EXE, DLL, or ICO file that contains an icon	-icon c:\somefile.exe
-compress  (or -z)	Activates the Compression option as described in the preceding section.	-compress  (no options)
-package_i -package_d (or  -pi, -pd)	Packages (embeds) all external image (-pi) and data (-pd) files into the program	-pi  (no options)
-single  (or -s)	Activates the "run one copy" feature of an EXE as described in the preceding section	-single  (no options)
-encrypt  (or -e)	The EXE is encrypted so that the original script steps can't be accessed by decompiling the EXE	-encrypt  (no options)
-version  (or -v)	Sets the Version string	-version 1.2
-description  (or -d)	Sets the Description string (use single quotes)	-description 'This is my program'
-copyright  (or -y)	Sets the Copyright string (use single quotes)	-copyright 'Copyright © 2010 My Company'
-quiet  (or -q)	Supresses all output unless an error occurs	-quiet  (no options)
-WIN32	Creates a Windows program (default)	-WIN32  (no options)
-CONSOLE	Creates an MS-DOS character-based program	-CONSOLE  (no options)
-DLL	Creates a Windows Dynamic Link Library (DLL)	-DLL  (no options)