# VIEWASHLOG

_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.md) | Filter function calls for program. |
| /LSX:dir | Directory for [LSX files](lsxfilescompil.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.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.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.