HP 64767 User Manual page 417

Chapter 12: Emulator/Analyzer Interface Commands
--SYMB--
Symbolic Retrieval Utilities (SRU)
The 80186 emulator interface software can read absolute files in HP-OMF and
OMF-86 formats. When you load a program for the first time, the emulator uses
the Symbolic Retrieval Utilities (SRU) to build a symbol database for each module.
This database associates symbol names and symbol type information (not data
types) with logical addresses. You will see a message on screen indicating the
module for which the database is being built.
Once a symbol database is created for a particular module, it does not need to be
rebuilt unless the module is changed. You can rebuild modules using the srubuild
utility (see the Symbolic Retrieval Utilities User's Guide). Or, if you reenter
emulation without building symbols, the emulator software will automatically
rebuild portions of the symbol database as you reference symbols in modified
modules.
Global symbol information is immediately available for the file that you loaded.
To obtain local symbol information, you need to specify the module that contains
the symbols.
You can use the symbol names instead of addresses when entering expressions as
part of an emulation command. Therefore, you don't have to remember
segment:offset information to make a measurement. Also, the emulator can display
symbols as part of a measurement, using the set symbols on command. This helps
you relate the measurement to your original program.
The Symbolic Retrieval Utilities (SRU) handle symbol scoping and referencing.
Symbols are arranged in a "tree" structure that mimics the natural scoping of your
source language as much as possible.
Each absolute file has its own symbol tree. Each entry in the symbol tree has a type
and a name. If you are not sure what your "language tree" looks like, you can use
the sruprint program to print portions of your tree.
All emulation references to symbols (both input from the keyboard and output
displays) make use of the tree structure to show the scoping of symbols and to
make evident the symbols that have the same name but different scopes.
417