Updated Octoer 2025; see History
VIEWASHLOG {switches}
VIEWASHLOG.LIT provides a simple way to view the ashlog.log file contents, either in its entirety as text, or just the errors in a spreadsheet or XTREE grid.
Switches
Switch |
Effect of Switch |
|---|---|
/ERRORS{:errno} |
Extract error info into interactive grid. errno may be a number (#), less than a number (<#), or greater than a number (>#). Default is all. |
/FILE:logspec |
Use specified file instead of ashlog.###. |
LOCAL{:dir} |
Look for ashlog in current (dir) directory. |
Other switches are available only if /ERRORS is not set:
Switch |
Effect of Switch |
|---|---|
/LOOKBACK{:#} |
look back # (default 1) ashlog.### files. |
/MACHINE:machine id |
Filter on machine id. Partial id ok. |
Filter function calls for program. |
|
/LSX:dir |
Directory for LSX files; used with /FUNCS. |
/PID:##### |
Filter on pid. |
/PROG:program |
Filter on program. |
/SESSION |
Display traces for just this session. |
/USER:name |
Filter on login name, with sessions grouped separately. |
Note that while the traditional separator between switch names and their values is a colon, you can also use the equals sign as shown by the example in the FUNCS topic. This might be less confusing when the values themselves contain colons.
In the XTREE display, you can select an error and if it can find the corresponding LSX file, allows you to bring it up in the VUE or APN editor.
History
2025 October, A-Shell 7.0.1780, VIEWASHLOG.LIT 1.0(113): Automatically detect ashlog.log file location if it has been altered via the SET LOGDIR command.
2025 August, Ashell 7.0.1776, VIEWASHLOG.LIT 1.0(109): Add switches /FILE and /LOCAL.
2025 MarchSeptember, A-Shell 1750, VIEWASHLOG.LIT 1.0(107): Add switch /USER.
2023 September, A-Shell 1750: Function added to A-Shell.
