Inspect Manual

High-Level Inspect Commands
Inspect Manual—429164-006
6-200
Usage Considerations
Inspect issues this warning once when it first opens the file; subsequent accesses
to the file do not produce the warning.
Modifying a source file after it was compiled will result in a timestamp mismatch. In
this case, the correspondence between code locations and source lines might be
invalid.
Moving or renaming a source file and then using ADD SOURCE ASSIGN to
associate the new name with the object code can also result in a timestamp
mismatch, even when the source itself has not changed. To avoid a mismatch of
this type, use either the SAVEALL or SOURCEDATE clause of the File Utility
Program (FUP) DUPLICATE command. For more information, see the File Utility
Program (FUP) Reference Manual.

Types of Source Files
Source files must be EDIT files. Inspect reports an error if a source file is not of
this type.

Renumbering a Source File
If you renumber the lines in a source file after compiling it, the correspondence
between line numbers and code locations might become invalid, therefore causing
the SOURCE command to produce incorrect results.

Pressing the BREAK Key
You can halt a source display at any time by pressing the BREAK key. Inspect
stops displaying source text and issues an Inspect prompt.

Displaying Source from Multiple Files
A single SOURCE command can display source text from one file only. Inspect
does not interpret toggles, source directives, or copy directives in the source file. If
Inspect encounters an end-of-file or beginning-of-file when displaying the source
text, it shortens the display accordingly.

Displaying Source with the FILE Clause
The intent of the SOURCE FILE form of the SOURCE command is to allow you to
browse through EDIT files while in Inspect. This form of the SOURCE command
does not use symbol information; hence, it does not annotate the listing when the
file happens to be a source file for the program.