HP 3000 Manuals

System Debug Reference Manual

SYMOPEN 

Opens a symbolic data type file and sets up pointers to the symbolic
debug records.

Syntax 

      SYMOPEN filename [symname]

The SYMOPEN command must be used to open a symbolic data type file before
the symbolic formatting command and functions can be used.

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.


CAUTION  The output format of all System Debug commands is subject to
         change without notice.  Programs that are developed to
         postprocess System Debug output should not depend on the exact
         format (spacing, alignment, number of lines, uppercase or
         lowercase, or spelling) of any System Debug command output.

MPE/iX 5.0 Documentation