Technical data

System Dump Analyzer
READ
READ
Loads the global symbols contained in the specified object module into the SDA
symbol table.
Format
READ {/EXECUTIVE directory-spec | [RELOCATE=expression]|filespec}
Parameter
filespec
Name of the device, directory, and file that contains the object module from which
you want to copy global symbols. The filespec defaults to SYS$DISK:[default-
dir]filename.STB, where SYS$DISK and [default-dir] represent the disk and
directory specified in your last SET DEFAULT command. You must specify a file
name.
Qualifiers
/EXECUTIVE directory-spec
Reads into the SDA symbol table all global symbols and global entry
points defined within all loadable images that make up the executive. (See
Table SDA–13 for a list of those images.)
The directory-spec is the name of the directory containing the loadable images
of the executive. This parameter defaults to SYS$LOADABLE_IMAGES.
/RELOCATE=expression
Adds the value of expression to the value of each symbol in the symbol table
file to be read. You can use the /RELOCATE qualifier only if you also specify
a filespec. The /RELOCATE qualifier is useful for examining images that are
position independent and are loaded at a base of zero.
Description
The READ command symbolically identifies locations in memory for which
the default symbol table (SYS$SYSTEM:SYS.STB) provides no definition. In
other words, the required global symbols are located in modules that have been
compiled and linked separately from the executive.
5
The object module file specified in the READ command can be one of the
following:
• Output of a compiler or assembler (for example, an .OBJ file)
• Output generated by the linker qualifier /SYMBOL_TABLE (for example, an
.STB file)
Most often the object module file is a file provided by the operating system
in SYS$SYSTEM or SYS$LOADABLE_IMAGES. Many SDA applications, for
instance, need to load the definitions of system data structures by issuing a
READ command specifying SYS$SYSTEM:SYSDEF.STB. Others require the
definitions of specific global entry points within the executive image that are
contained within those object modules included in the executive.
5
SDA extracts no local symbols from the object module.
SDA–62