Vortex Optional Command-line Options

These Vortex command-line options modify other actions:

• -d db Use database db instead of the default/installed database path. A run-time <DB> statement in a script will override this.

• -u user Login as the given Texis user.

• -p password Login with the given password.

• var=value Assign the URL-encoded value to var on startup. Multiple assignment statements for the same variable will result in multiple values for that variable. Vortex scripts only.

• -M Output the source file:line first in error messages. This is useful in an editing/compilation environment such as Gnu emacs that can parse this output and automatically go to the source line of the error.

• -e file Log errors to file instead of the default/installed log file (/usr/local/morph3/texis/vortex.log). A - (dash) means log to standard error. Errors are also printed in the output, unless a putmsg function (here) is defined to catch them.

• -t n Use a timeout of n seconds when running a script; -1 for no timeout. Overrides the script <timeout> (here, but not run-time timeouts via <vxcp timeout>.

• --ignore-env-script-name=value,... Override conf/texis.ini setting [Texis] Ignore Env Script Name (here). Usually the conf/texis.ini setting is enough, but this command-line override can be used (e.g. in the web server config) if multiple CGI environments are in simultaneous use and the setting must differ between them. Note that it will be ignored in CGI mode (like all command line options) unless permitted via [Texis] Allow Cgi Command Line Options (here). Added in version 5.01.1182304953 20070619.

• --pause-at-exit At program exit, pause until user presses Enter. Can be useful when running a script in a dedicated command prompt window, to avoid having the window close immediately after the script ends without having a chance to see its output. Added in version 5.01.1225327000 20081029.

• --warnings-are-fatal

  Treat compilation warnings as fatal, i.e. fail the compile and exit non-zero. Without this flag set, some compilation messages are non-fatal if the compiler considers them benign (e.g. too few/many arguments for <fmt>): this may allow the script to finish compiling and run. In a production environment (e.g. automatic re-compilation during a script upgrade), running the script - even with potential errors - may be more important than halting execution to fix a warning in code that might not even be reached at runtime; thus this flag is off by default. During development however, it is good practice to set this flag, to catch such errors early when stopping compilation/execution is more permissible.

  The default value is the value of the conf/texis.ini setting [Texis] Warnings Are Fatal (on/off); if that is unset, it defaults to off. Added in version 6.00.1306875000 20110531.

• --no-warnings-are-fatal

  Turns off --warnings-are-fatal (e.g. if set via conf/texis.ini.

• --compatibility-version[=| ]version

  Sets Texis compatibility version to given version. See <vxcp compatibilityversion> (here) for details.

• -- Indicates end of options, i.e. what follows (if anything) is the script or SQL statement. Added in version 5.01.1182193063 20070618.