Updated May 2022; see History
xcall MIAMEX, MX_GETTRACE, trflags
MX_GETTRACE retrieves the current set of trace options.
trflags (48 bit integer) will be set to indicate the current trace options from the table shown below. Note that because the range of options extends beyond 32 bits, you need to use a variable type that can handle the full range, e.g. B5, B6, or F8. (F6 handles up to about 42 bits.) When specifying trace operations in miame.ini, use the symbol name with the TROP_ prefix. For example, the flag set via TRACE=BASERR in the miame.ini is referenced here by the symbol TROP_BASERR.
Most traces result in messages logged to ashlog.log, although some, like TROP_LP, output directly the screen. Any trace that gets written to ashlog.log can also be written to the Debug Message Window if it is open and enabled. See Event Tracing for a detailed description of tracing functionality.
|
Symbol |
Value |
Notes |
|
TROP_AMSORT |
&h00000001 |
Display sorting trace dialog |
|
TROP_SYSERR |
&h00000002 |
Display system error dialog |
|
TROP_SQL |
&h00000004 |
SQL tracing |
|
TROP_LP |
&h00000008 |
Line printer tracing display |
|
TROP_SIGNAL |
&h00000010 |
Display received signals |
|
TROP_SIGHUP |
&h00000020 |
Log hang-ups |
|
TROP_LOCKS |
&h00000040 |
Display lock trace |
|
TROP_LOG |
&h00000080 |
Log various details |
|
TROP_JOBS |
&h00000100 |
Log job info |
|
TROP_QOPEN |
&h00000200 |
Log qflock.sys operations such as XLOCK |
|
TROP_GDIPRT |
&h00000400 |
Display GDI print directives |
|
TROP_FOPENS |
&h00000800 |
Log file opens |
|
TROP_XCALL |
&h00001000 |
Log XCALLs |
|
TROP_AMOS |
&h00002000 |
Log XCALL AMOS operations |
|
TROP_DEBUG |
&h00004000 |
Log maximum details |
|
TROP_INOUT |
&h00008000 |
Log ins & outs |
|
TROP_BASERR |
&h00010000 |
Log BASIC errors |
|
TROP_ISAM |
&h00020000 |
Log ISAM operations |
|
TROP_USRMEM |
&h00040000 |
Log user memory operations |
|
TROP_MALLOC |
&h00080000 |
Log memory allocations |
|
TROP_RW |
&h00100000 |
Log reads and writes |
|
TROP_SOCKS |
&h00200000 |
Log socket operations |
|
TROP_XLOCKS |
&h00400000 |
Log XLOCK calls |
|
TROP_XDEBUG |
&h00800000 |
Combine with other flags to increase detail |
|
TROP_PERF |
&h01000000 |
Log performance for certain operations |
|
TROP_GUI |
&h02000000 |
Log internal GUI operations |
|
TROP_EFS |
&h04000000 |
Log Encrypted File System (EFS) operations |
|
TROP_ATE |
&h08000000 |
Log ATE commands |
|
TROP_KBD |
&h10000000 |
Log keyboard data and operations |
|
TROP_XTREE |
&h20000000 |
Log XTREE operations |
|
TROP_JOBLCK |
&h100000000 |
Causes all unresolved lock/unlock operations on the jobtbl.sys file to be traced in the file jobtbl.lck. Note that the bit TROP_JOBLCK is beyond the 32 bit range of the typical 32 bit flags word, so you need to use B5, B6, I6, or F6/F8 to retrieve or set this bit. |
|
Definition file: ashell.def | ||
History
2022 May: Rewrite two paragraphs before table.
2016 September, A-Shell 6.3.1526: Add TROP_JOBLCK.