Inspect Manual

Inspect Manual—429164-006
6-1
6 High-Level Inspect Commands
This section describes the high-level Inspect commands in detail. The high-level
commands are summarized in Table 6-1 on page 6-2. If you want to make full use of
high-level Inspect, your program must be compiled with the SYMBOLS compiler
directive or have access to an object with symbols.
Inspect Keywords
Inspect does not reserve its keywords (command names and clause names).
Consequently, refer to identifiers such as BREAK, EVERY, and STEP in your program,
assuming that the compiler for the language you are using allows them as identifiers.
Abbreviations
You can abbreviate many Inspect keywords. In this section, keyword abbreviations are
shown in boldface type. These abbreviations might change to accommodate additional
commands in future releases of Inspect, so you should not use the abbreviations in
OBEY files, the INSPLOCL file, or the INSPCSTM file.
Language-Dependent Information
Several of the high-level Inspect commands require information that is language-
dependent; the syntax and validity of this information is based on the current source
language. The command descriptions in this section discuss how the information is
used, but you must refer to the particular language sections for details regarding the
syntax of the information. The language-dependent information required by a high-
level command can be one of these five items:

Code location—A location in the program's object code area

Data location—The location of a data item

Expression—An expression that evaluates to a numeric, boolean (true/false), or
string value

Scope path—A path used to identify specific code and data locations

Scope unit—The entity (or entities) into which source code is grouped
Machine-Dependent Information
Some high-level Inspect commands may be affected by the type of machine, TNS or
TNS/R, on which the current program is executing. The behavior of some commands
may be slightly different depending on the machine. Some commands have machine
dependent arguments that can only be used on a particular machine, and some
commands may report different information depending on the machine. Machine