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 during compilation if
$ret is used in a loop context
ROW flag), either directly
<loop $ret>) or indirectly
<stat nonempty ...>). This usage can cause problems
for code called inside such a loop, because like any other
$ret cannot have its type nor number of values
changed while being looped over. Thus any new
returned by calls inside the loop will be forced to have its type
cast to the looped
$ret type, will lose all but the first
returned value, and the first value will be placed in the middle
$ret (i.e. the current loop value). This may result in
loss of data, error messages from type conversions that fail, and
unexpected return type(s).
--no-warn-if-ret-loop to turn off this warning.
The default is the value of the texis.ini setting
[Texis] Warn If Ret Loop (yes/no); if that is unset,
it defaults to "no". Added in version 7.01.1409098000 20140826.
Turn on all additional warnings. This enables
--warn-if-ret-loop, plus warnings about unknown pragmas
--no-warn-all to turn off all these warnings.
The default is the value of the texis.ini setting
[Texis] Warn All (yes/no); if that is unset,
it defaults to "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.
--no-warnings-are-fatal to turn off this setting.
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 command-line variable assignment arguments (both variable name and value). This is the default. Added in version 7.00.1362529000 20130305.
Do not URL-decode command-line variable assignment arguments, i.e. take the variable name and value as-is. 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.