Inspect Manual

High-Level Inspect Commands
Inspect Manual429164-006
6-199
Usage Considerations
If you do not specify file-locator, the SOURCE command reads from the file
associated with source-locator.
If you do not specify WRAP, the SOURCE command uses the current value of the
SOURCE WRAP environment parameter. You can use the SET command to
change this parameter.
Usage Considerations
Components of the Source Display
When you use the SOURCE command, Inspect displays the source text
corresponding to the location you provide. In addition, Inspect also displays:
An asterisk next to the source line containing the current location.
Breakpoint numbers next to source lines containing break locations.
Statement numbers if the LOCATION FORMAT session parameter includes
STATEMENTS.
Line numbers if the LOCATION FORMAT session parameter includes LINES.
Continuing the Last SOURCE Command
After you enter a SOURCE command, you can continue it by pressing RETURN at
the next Inspect prompt. The ability to repeat continues until you enter any other
Inspect command.
When you repeat a SOURCE command, Inspect continues from the source line
where the previous SOURCE command ended.
When you repeat a SOURCE SEARCH command, Inspect searches for the next
occurrence of the original string.
Accessing Source Text
In order for SOURCE to access and display the source text, the scope unit
containing source-locator must have symbol information associated with it. If no
symbol information is available, Inspect cannot display any source text and
therefore issues the error message:
Timestamps of Source Files
When Inspect first opens a source file, it checks the file’s current modification
timestamp. If this timestamp differs from the timestamp recorded in the program
file, Inspect issues this warning:
** Inspect error 36 ** No symbols available in scope: scope-unit
** Inspect warning 49 ** Timestamp mismatch for file-name
Source modification time at present: current-timestamp
Source modification time at compilation: compile-timestamp