Inspect Manual

Using Inspect With TAL and pTAL
Inspect Manual—429164-006
13-3
Usage Considerations
code-offset
specifies an offset from the code location defined by the preceding options. A
positive offset (+) denotes code following the specified code location; a negative
offset (-) denotes code preceding the specified code location. The amount to offset
is specified by a given number of units. If you omit the unit specifier, Inspect
selects INSTRUCTION as the code unit for TAL or pTAL. Inspect code units
correspond to TAL and pTAL code units as follows:
Usage Considerations

Low-level code locations
Low-level Inspect recognizes procedure names, but does not use any other symbol
information. In low-level Inspect, therefore, you can only use code locations of the
form:
#scope-path [ code-offset ]
This form represents an offset from the code base of a scope unit. Also, the code
unit of code-offset in low-level Inspect is always INSTRUCTION.

High-level code locations
High-level Inspect recognizes procedure names as does low-level Inspect, but it
also uses the symbol information created when you compile a scope unit with the
SYMBOLS directive. Therefore, code locations in high-level Inspect can include
label identifiers or line numbers.

Specifying code locations by label
You can use a TAL or pTAL label as the code reference in a code location.
However, because Inspect also accepts scope units as code references, a conflict
arises if a label's identifier is the same as the identifier for its containing scope unit.
Inspect interprets the identifier as a reference to the scope unit, not to the label.
Consequently, you must specify the code location of the label by its statement
number, its line number, or its instruction offset.

Specifying code locations by line number
If no statement begins at the line number you specify, Inspect issues this warning:
Inspect then uses the statement starting at the given line number. If more than one
statement begins on the line you specify, Inspect uses the start of the first
statement.
INSTRUCTION Specifies a machine-code instruction in the compiled TAL or
pTAL program.
STATEMENT Specifies a TAL or pTAL statement.
** Inspect error 117 ** A subsequent line number is assumed: line-number