# VIEWASHLOG
> [HTML Version](viewashlog_lit.htm)
_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. |
| [/FUNCS:program\{:sbx\}](funcs.htm.md) | Filter function calls for program. |
| /LSX:dir | Directory for [LSX files](lsxfilescompil.htm.md); 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](funcs.htm.md). 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](lsxfilescompil.htm.md), 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.