Reviewed and revised, April 2024
xcall MIAMEX, MX_GETTRACE, trflags
xcall MIAMEX, MX_SETTRACE, trflags
MX_GETTRACE (MIAMEX 61) retrieves the current set of trace options, MX_SETTRACE (MIAMEX 62) allows you to set those options on the fly.
Parameters
trflags (Bitmap 48 bits) [in for SET, out for GET]
Individual trace on/off options, referenced by the symbols TROP_xxx in the table below, where xxx matches the name of the trace as specified in the TRACE system parameter directives, as well as in the SET command. For example, the flag set via TRACE=BASERR in miame.ini is referenced here by the symbol TROP_BASERR.
Comments
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 System Message Window if it is open and enabled. Note that you can activate any of the traces from System Messages Window by right-clicking on it and picking Properties.
Tracing flags may also be set with the TRACE system parameter or with the TRACE options in the SET command. See those discussions for more details about these options.
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 ASB 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_CGI |
&h40000000 |
Log CGIUTL operation |
TROP_EXEC |
&h80000000 |
RUN, CHAIN, CMDLIN |
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.