These Vortex command-line options modify other actions:
-d dbUse database
dbinstead of the default/installed database path. A run-time
<DB>statement in a script will override this.
-u userLogin as the given Texis user.
-p passwordLogin with the given password.
var=valueAssign the URL-encoded
varon startup. Multiple assignment statements for the same variable will result in multiple values for that variable. Vortex scripts only.
-MOutput the source
file:linefirst in error messages. This is useful in an editing/compilation environment such as Gnu
emacsthat can parse this output and automatically go to the source line of the error.
-e fileLog errors to
fileinstead of the default/installed log file (
-(dash) means log to standard error. Errors are also printed in the output, unless a
putmsgfunction (here) is defined to catch them.
-t nUse a timeout of
nseconds when running a script; -1 for no timeout. Overrides the script
<timeout>(here, but not run-time timeouts via <vxcp timeout>.
Parse comma- or space-separated Vortex
options that are
part of this same argument. This may be used in Unix "shebang"
scripts, where most platforms either merge space-separated
arguments on the "
#!" command line (after the
interpreter) into one argument, or silently drop arguments after
the first (e.g. Solaris), either of which would cause problems.
--shebang, such a merged argument may be passed to
Vortex such that it knows to space-separate the remainder of the
argument into further options.
Combining this option with
-R enables a Vortex script to be
made into a self-executing script (in Unix), and still pass Vortex
options on the command line. E.g. to set the error log to
-R is always last. The script (not Vortex)
command-line arguments may be obtained with
<vxinfo scriptargs> (here).
texis.inisetting [Texis] Ignore Env Script Name (here). Usually the
texis.inisetting 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-exitAt 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.
Warn (or not) during compilation if
$ret is used in a loop
ROW behavior in effect), either directly
(e.g. <loop ret>) or indirectly (e.g. <stat nonempty
...>). This usage can cause problems for code called inside
such a loop, because like any other variable,
have its type nor number of values changed while being looped
over. Thus any new
$ret returned by calls inside the loop
will be forced to have its type cast to the looped
type, will lose all but the first returned value, and the first
value will be placed in the middle of
$ret (i.e. the
current loop value). This may result in loss of data, error
messages from type conversions that fail, and unexpected return
The default is the value of the texis.ini setting [Texis] Warn Ret Loop (yes/no); if that is unset, [Texis]
Warn All is used; if that is unset, the warning defaults to
"no". Added in version 7.01.1409098000 20140826 as
--[no-]warn-if-ret-loop (with texis.ini setting [Texis] Warn If Ret Loop); renamed to
--[no-]warn-ret-loop (for consistency with other warning
options) in version 8. See also
Warn (or not) during compilation if an unknown
(here) is used. Normally, unknown pragmas are
silently ignored, for back-compatibility since they are in
The default is the value of the texis.ini setting [Texis] Warn Unknown Pragma (yes/no); if that is unset, [Texis] Warn All is used; if that is unset, the warning
defaults to "no". Added in version 7.07.1574459000 20191122.
Turn on (or off) all
--warn-... warnings listed above.
The default for each warning is its command-line or texis.ini value; if those are unset, the warning is set from
the texis.ini setting [Texis] Warn All value (yes/no).
Added in version 7.07.1568230000 20190911.
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 texis.ini setting [Texis] Warnings Are Fatal (yes/no); if that is unset, it defaults to "no". Added in version 6.00.1306875000 20110531.
URL-decode (or not) command-line variable assignment arguments (both variable name and value). The default is to decode. Added in version 7.00.1362529000 20130305.
Sets Texis compatibility version to given version. See
(here) for details.
Sets path to use when searching for Texis/Vortex shared libraries. See <vxcp libpath> (here), which can override this at run time, for details. Added in version 7.02.1408567000 20140820.
--Indicates end of options, i.e. what follows (if anything) is the script or SQL statement. Added in version 5.01.1182193063 20070618.