System Debug Reference Manual (32650-90888)

264 Chapter6
System Debug Command Specifications M-X
SYMPREP
Parameters
filename The file name of the symbolic data type file. The file must contain symbolic
debug records.
symname The symbolic name under which the symbolic data type file is referenced
in the formatter commands. If this parameter is omitted, the file name will
be used as the symbolic name.
Examples
$nmdat > symopen SYMOS.PUB.SYS OS
$nmdat >
Open the symbolic file SYMOS.PUB.SYS and assign the symbolic name OS to it.
Limitations, Restrictions
Before a symbolic data type file is ready to be opened with SYMOPEN, ensure that the
following steps have been followed:
1. The types must be compiled with the $SYMDEBUG 'xdb'$ option.
2. The program containing the types must have at least one statement.
3. The relocatable library generated by the compiler must be run through LINKEDIT.
4. The program file generated by LINKEDIT must be run through PXDB.
5. The modified program file generated by PXDB must be prepared with SYMPREP in DAT
or Debug.
6. The program file (symbolic data type file) is now ready to be opened with SYMOPEN.
SYMPREP
Prepares a program file containing symbolic debug information to be used by the symbolic
formatter/symbolic access facility. Files modified through the use of this command are
referred to as symbolic data type files.
Syntax
SYMPREP { filename }
Parameters
filename The name of the program file name to be preprocessed. (Required)