Library /sys$common/syshlp/SDA.HLB  —  READ  Qualifiers

1    /EXECUTIVE

       /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. For all the execlets in the system, SDA reads the .STB
    or .EXE files in the requested directory.

2    /FORCE

       /FORCE filespec

    Forces SDA to read the symbols file, regardless of what other
    information or qualifiers are specified. If you do not specify
    the /FORCE qualifier, SDA may not read the symbols file if the
    specified filespec matches the image name in either the executive
    loaded images or the current processes activated image list, and
    one of the following conditions is true:

    o  The image has a symbols vector (is a shareable image), and
       a symbols vector was not specified with the /SYMVA or /IMAGE
       qualifier.

    o  The image is sliced, and slicing information was not provided
       with the /IMAGE qualifier.

    o  The shareable or executive image is not loaded at the same
       address it was linked at, and the relocation information was
       not provided with either the /IMAGE or /RELOCATE qualifier.

    The use of /FORCE [/SYMVA=addr][/RELOCATE=addr] filespec is a
    variant of the /IMAGE qualifier and avoids fixing up the symbols
    to match an image of the same name.

3    /IMAGE

       /IMAGE filespec

    Searches the executive loaded image list and the current process
    activated image list for the image specified by filespec. If
    the image is found, the symbols are read in using the image
    symbol vector (if there is one) and either slicing or relocation
    information.

    This is the preferred way to read in the .STB files produced
    by the linker. These .STB files contain all universal symbols,
    unless SYMBOL_TABLE=GLOBAL is in the linker options file, in
    which case the .STB file contains all universal and global
    symbols.

4    /LOG

       /LOG
       /NOLOG (D)

    The /LOG qualifier causes SDA to output the %SDA-I-READSYM
    message for each symbol table file it reads. By default, these
    messages are suppressed. You can specify /LOG and /NOLOG with any
    other combination of parameters and qualifiers.

5    /RELOCATE

       /RELOCATE=expression

    Changes the relative addresses of the symbols to absolute
    addresses by adding the value of expression to the value of
    each symbol in the symbol table file to be read. This qualifier
    changes those addresses to absolute addresses in the address
    space into which the dump is mapped.

    The relocation only applies to symbols with the relocate flag
    set. All universal symbols must be found in the symbol vector for
    the image. All constants are read in without any relocation.

    If the image is sliced (image sections are placed in memory at
    different relative offsets than how the image is linked), then
    the /RELOCATE qualifier does not work. SDA compares the file
    name used as a parameter to the READ command against all the
    image names in the executive loaded image list and the current
    processes activated image list. If a match is found, and that
    image contains a symbol vector, an error results. At this point
    you can either use the /FORCE qualifier or the /IMAGE qualifier
    to override the error.

6    /SYMVA

       /SYMVA=expression

    Informs SDA whether the absolute symbol vector address is for
    a shareable image (SYS$PUBLIC_VECTORS.EXE) or base system image
    (SYS$BASE_IMAGE.EXE). All symbols found in the file with the
    universal flag are found by referencing the symbol vector (that
    is, the symbol value is a symbol vector offset).
Close Help