Vortex Action Command-line Options

These Vortex command-line options specify an action to do; they are mutually-exclusive. See also the library and schedule options, however:

• -? or -H Print a help message.

• --apply-license{=| }file   Apply an arbitrary Texis License update file (provided by Thunderstone, in license.upd format) directly. A user and password for authentication must be provided, with -u and -p. The file may be "-" (a dash) to indicate that standard input should be read; this can be useful for cut-and-pasting a license update to a command-prompt window. A success or failure message and exit code is generated. Note that license updates must be enabled via texis.ini (usually done at install); see the [License Update] settings in the Texis manual. Also see <vxcp applylicense>, here. Added in version 6.

• -C

  Compile script only; do not execute. It is good practice to also use the --warnings-are-fatal and --warn-all flags with -C if running in a development (non-production) environment, so that subtle warnings are found early because they will halt compilation.

• -K pid [sig] Kill Texis process pid. An optional signal sig (name or value) may be given; the default is SIGTERM, which is a safer way to terminate a Vortex script (especially under Windows) than SIGKILL or Task Manager's End Process button. Under Windows, SIGTERM is mapped to a Vortex-specific soft-terminate event, and SIGINT/SIGBREAK are also mapped to soft events. Added in version 5.01.1172007224 20070220.

• -license Print current license statistics.

• -License Print more verbose license statistics.

• -r Run Vortex script. This is the default action, unless a SQL command is given.

• -R script   Run Vortex script, specified in next argument, and pass remaining arguments to script via <vxinfo scriptargs> (here), i.e. do not parse them as Vortex options. This is useful for Unix "shebang" scripts, as the last option on the "#!" command line, so that arguments to the script (not Vortex) may be passed in without flummoxing Vortex command-line syntax (which normally requires the script to be the last Vortex argument). See --shebang example (here). Added in version 7.01.1395172000 20140318.

• -s Execute SQL statement. The remaining options only apply to SQL statements:

• -update Signal the Texis Monitor to try to update the Texis license, either by reading the "license.upd" file in the install dir (provided by Thunderstone), or by contacting the Thunderstone license server over the Internet.

• -version Print version information and exit.

• -platform Print just platform ID and exit. Added in version 6.00.1277838424 20100629.

• -W Wipe the state table (delete and re-create it). A srcfile need not be given. Occasionally running texis with this option when the server is inactive is recommended, as the state table may grow large on heavily used servers.