VMS Help ANALYZE, /SYSTEM  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Invokes the System Dump Analyzer (SDA) utility to analyze a running
    system.

    On Alpha systems, you cannot specify the /CRASH_DUMP, /OVERRIDE, or
    /RELEASE qualifier when you use the /SYSTEM qualifier with the
    ANALYZE command.

    On VAX systems, you cannot specify the /CRASH_DUMP or /RELEASE
    qualifier when you use the /SYSTEM qualifier with the ANALYZE
    command.

    For a complete description of SDA, including more information about
    the ANALYZE/SYSTEM command and its qualifiers, see the OpenVMS Alpha
    System Dump Analyzer Utility Manual and the OpenVMS VAX System Dump
    Analyzer Utility Manual.

                               Caution

    Although the analysis of a running system might be instructive,
    be aware that system context, process context, and a processor's
    hardware context remain fluid during any given display.  In a
    multiprocessing environment, a process running SDA might be
    rescheduled to a different processor frequently during analysis.
    Therefore, Compaq recommends that you do not examine the hardware
    state using addresses that are not mapped to physical memory
    locations.

    Also, when using SDA to analyze a running system, use caution in
    interpreting its displays. Because system states change frequently,
    it is possible that the information SDA displays might be inconsistent
    with the actual, volatile state of the system at any given moment.

    Format

      ANALYZE/SYSTEM

1 - Example

  $  ANALYZE/SYSTEM

      This command invokes SDA to analyze the running system.

2 - /SYMBOL

    Specifies an alternate system symbol table for SDA to use.

    Format

      ANALYZE/SYSTEM/SYMBOL=system-symbol-table

    system-symbol-table

    On Alpha systems, file specification of the OpenVMS Alpha SDA
    system symbol table required by SDA to analyze a system dump.
    The specified system-symbol-table must contain those symbols
    required by SDA to find certain locations in the executive image.

    On Alpha systems, if you do not specify the /SYMBOL qualifier,
    SDA uses SDA$READ_DIR:SYS$BASE_IMAGE.EXE to load system symbols
    into the SDA symbol table.  When you specify the /SYMBOL qualifier,
    SDA assumes the default disk and directory to be SYS$DISK and
    [default-dir]; that is, the disk and directory specified in your
    last SET DEFAULT command.  If no device and directory are given
    in the file name and the file is not found in the current default
    directory, SDA attempts to open the file SDA$READ_DIR:filename.type.
    If no type has been given in the file name, SDA assumes .EXE. If
    you specify a file for this parameter that is not a system symbol
    table, SDA halts with a fatal error.

    On VAX systems, file specification of the SDA system symbol
    table required by SDA to analyze a system dump. The specified
    system-symbol-table must contain those symbols required by SDA
    to find certain locations in the executive image.

    On VAX systems, if you do not specify the /SYMBOL qualifier, SDA
    uses SYS$SYSTEM:SYS.STB by default.  When you do specify the
    /SYMBOL qualifier, SDA assumes the default disk and directory to be
    SYS$DISK; that is, the disk and directory specified in your last
    SET DEFAULT command. If you specify a file for this parameter that
    is not a system symbol table, SDA halts with a fatal error.

 2.1 - Description

    On Alpha systems, the /SYMBOL qualifier allows you to specify a
    system symbol table other than SDA$READ_DIR:SYS$BASE_IMAGE.EXE to
    load into the SDA symbol table.  You can use the /SYMBOL qualifier
    whether you are analyzing a system dump or a running system.

    On Alpha systems, the /SYMBOL qualifier can be used with the
    /CRASH_DUMP and /SYSTEM qualifiers.  It is ignored when
    /OVERRIDE or /RELEASE is specified.

    On VAX systems, the /SYMBOL qualifier allows you to specify a
    system symbol table other than SYS$SYSTEM:SYS.STB to load into
    the SDA symbol table.  This might be necessary, for instance, to
    analyze a crash dump taken on a processor running a different
    version of OpenVMS.

    On VAX systems, you can use the /SYMBOL qualifier whether you are
    analyzing a system dump or a running system.

 2.2 - Examples

    On Alpha systems:

    $ ANALYZE/SYSTEM/SYMBOL=SDA$READ_DIR:SYS$BASE_IMAGE.EXE SYS$SYSTEM

        This command invokes SDA to analyze the running system, using
        the base image in SDA$READ_DIR.

    On VAX systems:

    $ ANALYZE/SYSTEM/SYMBOL=SYS$CRASH:SYS.STB SYS$SYSTEM

        This command invokes SDA to analyze the running system, using
        the system symbol table at SYS$CRASH:SYS.STB.