Updated October 2025
Logs most subroutine calls. Certain extremely common routines, like MIAMEX, are not logged, unless the XDEBUG trace is also activated. In CGIUTL, creates additional logging in cgiutl.log file.
Beginning with A-Shell 7.0.1778, the xcall trace (e.g. SET TRACE XCALL ON) traces return parameters for xcall subroutine calls. Previously, only the parameters passed to the subroutine were traced.
For internal subroutines, the return trace is identical to the calling trace except it will show the updated parameter values. To take a simple example, the following traces:
xcall XSTRIP,S20[ ABCD123 ],S3[123],F8[1]
<---- XSTRIP,S20[ ABCD ],S3[123],F8[1]
... show the xcall XSTRIP being called with the first parameter " ABCD123 " being changed to " ABCD " on return.
Note that there are a few xcall routines, including STRIP (but not XSTRIP) which are converted by the compiler to internal functions, in which case they will not show up in the traces.
For external (SBX) subroutines, it isn't necessary to list the entire parameter list on return because any explicit parameter updates require the user of XPUTARG, which is also separately traced. See the notes for 7.0.1776.0 below which covers XPUTARG tracing in the context of user defined functions but which applies equally to SBX subroutines.
History
2025 October, A-Shell 7.0.1778: See note above.
