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

    Invokes the System Dump Analyzer (SDA) utility to analyze a
    specified dump file.

    You can use SDA to help determine the causes of system failures.
    This utility is also useful for examining the running system by
    using the DCL command ANALYZE/SYSTEM.

    On Alpha systems, the format is as follows:

    Format

      ANALYZE {/CRASH_DUMP [/RELEASE][/OVERRIDE] filespec | /SYSTEM}
              [/SYMBOL=system-symbol-table]

    On VAX systems, the format is as follows:

    Format

      ANALYZE  {/CRASH_DUMP [/RELEASE] filespec | /SYSTEM}
               [/SYMBOL=system-symbol-table]

    filespec

    Name of the crash dump file to be analyzed. The default file
    specification is:

       SYS$DISK:[default-dir]SYSDUMP.DMP

    SYS$DISK and [default-dir] represent the disk and directory
    specified in your last SET DEFAULT command. If you do not
    specify filespec, SDA prompts you for it.

    You cannot specify the /SYSTEM qualifier when you include the
    /CRASH_DUMP qualifier in the ANALYZE command.

1 - /OVERRIDE

    On Alpha systems, when used with the /CRASH_DUMP qualifier,
    invokes SDA to analyze the specified dump file if a corruption
    or other problem prevents normal invocation of SDA with an
    ANALYZE/CRASH_DUMP command.

    Format

      ANALYZE/CRASH_DUMP/OVERRIDE filespec

    filespec

    Name of the crash dump file to be analyzed.  The default file
    specification is:

       SYS$DISK:[default-dir]SYSDUMP.DMP

    SYS$DISK and [default-dir] represent the disk and directory
    specified in your last SET DEFAULT command.  If you do not
    specify filespec, SDA prompts you for it.

 1.1 - Description

    Commands that can be used when SDA is invoked with /OVERRIDE are
    as follows:

    o  Output control commands such as SET OUTPUT and SET LOG
    o  Dump file related commands such as SHOW DUMP and CLUE ERRLOG

    Commands that cannot be used are as follows:

    o  Commands that access memory addresses within the dump file such
       as EXAMINE and SHOW SUMMARY
    o  You cannot specify the /RELEASE qualifier when you include the
       /OVERRIDE qualifier in the ANALYZE/CRASH_DUMP command.

 1.2 - Examples

   $ ANALYZE/CRASH_DUMP/OVERRIDE SYS$SYSTEM:SYSDUMP.DMP
   $ ANALYZE/CRASH SYS$SYSTEM

       These commands invoke SDA to analyze the crash dump stored in
       SYS$SYSTEM:SYSDUMP.DMP.

2 - /RELEASE

    Invokes SDA to release those blocks in the specified system
    paging file occupied by a crash dump.

    Format

      ANALYZE/CRASH_DUMP/RELEASE  filespec

    filespec

    Name of the system paging file (SYS$SYSTEM:PAGEFILE.SYS).
    The default file specification is:

              SYS$DISK:[default-dir]SYSDUMP.DMP

    Because the default file specification is SYS$DISK and [default-dir]
    you must identify the page file explicitly.  SYS$DISK and [default-dir]
    represent the disk and directory specified in your last DCL command
    SET DEFAULT.  If you do not specify filespec, SDA prompts you for it.

 2.1 - Description

    Use the /RELEASE qualifier to release from the system paging file
    those blocks occupied by a crash dump. Be aware that when you use
    the /RELEASE qualifier, SDA immediately deletes the dump from the
    paging file and allows you no opportunity to analyze its contents.

    When you specify the /RELEASE qualifier in the ANALYZE command,
    do the following:

    1. Use the /CRASH_DUMP qualifier.

    2. Include the name of the system paging file
       (SYS$SYSTEM:PAGEFILE.SYS) as the filespec.

    If you do not specify the system paging file or the specified
    paging file does not contain a dump, SDA displays one of the
    following messages:

    %SDA-E-BLKSNRLSD, no dump blocks in page file to release,
                      or no page file
    %SDA-E-NOTPAGFIL, specified file is not the page file

 2.2 - Examples

  $ ANALYZE/CRASH_DUMP/RELEASE SYS$SYSTEM:PAGEFILE.SYS

  $ ANALYZE/CRASH/RELEASE PAGEFILE.SYS

      These commands invoke SDA to release to the page file those
      blocks in SYS$SYSTEM:PAGEFILE.SYS occupied by a crash dump.

3 - /SYMBOL

    Specifies an alternate system symbol table for SDA to use.

    Format

      ANALYZE/CRASH_DUMP/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.

 3.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.

 3.2 - Examples

   On Alpha systems:

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

        This command invokes SDA to analyze the crash dump stored in
        SYS$SYSTEM:SYSDUMP.DMP, using the base image in SDA$READ_DIR.

   On VAX systems:

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

        This command invokes SDA to analyze the crash dump stored
        in SYS$SYSTEM:SYSDUMP.DMP, using the system symbol table at
        SYS$CRASH:SYS.STB.

4 - Examples

    On Alpha systems:

    $ ANALYZE/CRASH_DUMP SYS$SYSTEM:SYSDUMP.DMP
    $ ANALYZE/CRASH SYS$SYSTEM

         These commands invoke SDA to analyze the crash dump stored
         in SYS$SYSTEM:SYSDUMP.DMP

    On VAX systems:

    $ ANALYZE/CRASH_DUMP SYS$SYSTEM:CRASHDUMP.DMP.

         This command invokes SDA to analyze the crash dump stored
         in SYS$SYSTEM:CRASHDUMP.DMP

    On Alpha and VAX systems:

     $ ANALYZE/CRASH SYS$SYSTEM:PAGEFILE.SYS

          This command invokes SDA to analyze a crash dump stored in
          the system page file.