/sys$common/syshlp/SDA.HLB  —  Operation
    You execute the System Dump Analyzer program by means of
    commands. SDA reads these commands from SYS$INPUT, which can
    be your terminal or a command file. You can send the output to a
    file or to your terminal.

    Any of the following commands invoke SDA:

    $ ANALYZE/CRASH_DUMP dump_file
    $ ANALYZE/SYSTEM
    $ RUN SYS$SYSTEM:SDA

    When a fatal BUGCHECK error causes the system to fail, the
    system writes the current state of the hardware registers and
    all physical memory to a directory file called SYSDUMP.DMP in the
    SYSEXE directory on the system disk. Alternatively, the system's
    paging file may be specified as the destination of the dump
    information instead of SYSDUMP.DMP. This is useful on systems
    that have constrained disk space. If there is insufficient space
    on the system disk, the file SYSDUMP.DMP may be created on a
    separate disk (dump off system disk, DOSD).

    Note that pages currently in the paging file (paged out) are not
    saved because the paging file is too large. Although these pages
    are lost from the crash dump, the effect on debugging will be
    minimal because most pages relating to the system failure are
    still in physical memory when the failure occurs, and are thus
    saved in the dump file. Of course, if the paging file is used as
    a dump file, the pages that are there are wiped out.

    SDA is always run during system startup. When executed at this
    time, SDA first checks to see if the system has just failed. If
    so, SDA executes the CLUE HISTORY command to record information
    from the system dump. If the system has not just failed, SDA
    exits.

    HP recommends that the system manager set up the system-startup
    file so that SDA collects additional information during system
    startup. The required SDA commands should be included in a
    command procedure referenced by the CLUE$SITE_PROC logical name
    in the system logical name table.

    The following example shows the SDA commands typically invoked
    via CLUE$SITE_PROC during system startup. The most important
    of these is the COPY command, which copies the dump file to
    another file. This operation is recommended because the system
    always overwrites this file in the event of a system failure,
    and the record of the previous failure is lost unless another
    copy exists. Furthermore, if the paging file was used as the
    dump file, the pages that contain the dump information are not
    available for paging until they are explicitly released by the
    COPY command.

         !
         !      SYS$MANAGER:SAVEDUMP.COM
         !
         !      Print dump listing and save dump if system just failed
         !
         !      Add the following command to SYS$MANAGER:SYLOGICALS.COM
         !      to invoke these SDA commands automatically on reboot
         !      after a system failure:
         !
         !      $ DEFINE /SYSTEM CLUE$SITE_PROC SYS$MANAGER:SAVEDUMP.COM
         !
         SET OUTPUT DISK1:SYSDUMP.LIS       ! Create listing file
         READ/EXEC         ! Read symbols into the SDA symbol table
         SHOW CRASH        ! Display crash information
         SHOW STACK        ! Show current stack
         SHOW SUMMARY      ! List all active
                           ! processes
         SHOW PROCESS/PCB/PHD/REG           ! Display current process
         COPY SYS$SYSTEM:SAVEDUMP.DMP       ! Save dump file (always last)
         EXIT

    If you need more information on the system failure, you can
    execute SDA interactively or add SDA commands to this startup
    file.
Close Help