System Debug Reference Manual (32650-90888)

300 Chapter7
Symbolic Formatting Symbolic Access
Creating and Accessing Symbol Definitions
HPLinkEditor/XL (HP32650-xx.yy.zz) (c) Hewlett-Packard Co 1986
LinkEd> link from=ygradtyp.demo.telesup;to=gradtyp.demo.telesup
LinkEd> exit
:
Preprocess the Program File with PXDB
The program file produced by LINKEDIT must be run through a utility called PXDB. This
program preprocesses the symbolic debug information for more efficient access during
symbolic debugging.
:PXDB.PUB.SYS gradtyp.demo.telesup
Copying gradetyp.demo.telesup ... Done
Procedures: 1
Files: 1
:
Prepare the Program File with SYMPREP
System Debug needs to perform additional preprocessing of the object module file after
PXDB. Quick data type lookup tables are built and symbols are sorted for fast access. The
results of this phase are saved in the program file so it need only be performed once.
Once this step is completed, the file is in a form usable by System Debug. Such a file is
called a symbolic data type file. This final task is performed from within DAT or DEBUG
by using the SYMPREP command:
:DAT
DAT XL A.00.00 Copyright Hewlett-Packard Co. 1987. All rights reserved.
$1 ($0) $nmdebug > SYMPREP gradtyp
Preprocessing GRADTYP.DEMO.TELESUP
Copying file ...
Building Constant lookup table ...
Sorting ...
Building Type lookup table ...
Sorting ...
Building lookup table header ...
Fixing up SOM directory structure ...
GRADTYP.DEMO.TELESUP preprocessed
$2 ($0) $nmdebug >
Open the Symbolic Data Type File with SYMOPEN
The System Debug SYMOPEN command is used to access the symbols in a preprocessed
program file (symbolic data type file). The user may optionally assign each symbolic file a
symbolic name when it is opened. If no symbolic name is specified, the file name (minus
the .GROUP.ACCOUNT) is used as the symbolic name. In the following example, the file
gradtyp is opened and assigned the default symbolic name gradtyp.
$nmdat > SYMOPEN GRADTYPE