Vortex Miscellaneous Command-line Options

These Vortex command-line options are primarily for tracing and debugging.

  • -x [N] Trap signals according to bit flags in integer N. Overrides <TRAP> directive (here). The default trap value is 0x83. The default for N if unspecified is 0.

  • -tracesql [n] Debugging: print informational, <putmsg>-capturable messages giving the exact SQL statements executed and their parameters. This is useful when debugging a complex script that constructs its SQL statements on the fly from various sources. Added in version 2.6.936400000 19990903. See also the sqlcp function (here), and the <TRACESQL> directive (here) for details on what values can be set. Specify multiple times for increased verbosity; in version 3.01.980200000 20010122 and later, an optional numeric argument n may be given instead.

  • -tracekdbf [file|n] Debugging: trace KDBF calls. Takes an optional file or numeric argument. Unsupported/internal use. Added in version 3.01.983500000 20010301.

  • -traceskt [n], -tracedns [n], -traceidx [n] Debugging: trace socket, DNS or Metamorph index calls. Use multiple times for increased verbosity. For tech support. See the same-name settings in the sqlcp and urlcp (here) functions for details. Added in version 3.0.948700000 20000124.

  • -tracepipe n Debugging: trace pipe calls. See the same-name setting under vxcp (here) for details.

  • -tracelib n Debugging: trace shared lib calls. Flags subject to change in a future release. Currently defined values (bit-wise ORed):

    • 0x1: Trace libpath expansion

    • 0x2: Trace library search and loading

    • 0x4: Trace symbol lookup
    Added in version 5.01.1215040000 20080702.

  • -tracealarm n Debugging: trace alarm calls. Added in version 5.01.1106770783 20050126. Value is a bitwise OR of any of the following flags:

    • 0x0001: TXsetalarm(), TXunsetalarm(), TXunsetallalarms() called

    • 0x0002: System alarm/handler set/unset

    • 0x0004: TX... alarms fired

    • 0x0008: System alarms fired

    • 0x0010: TXsetalarm(), TXunsetalarm(), TXunsetallalarms() finished

    • 0x0020: Timestamp each message

    • 0x0040: TXgetalarm() called
    Values may change or be added to in future releases.

  • -time Print user, system and real time used to standard error upon exit. Useful for timing a script or SQL statement.

  • -conf file Deprecated option; use --texis-conf{=| }file instead. Added in version 3.01.979600000 20010115.

There are also several options associated with Vortex modules (here) and scheduling (here).

Copyright © Thunderstone Software     Last updated: Oct 24 2023
Copyright © 2024 Thunderstone Software LLC. All rights reserved.