HELPLIB.HLB  —  ANALYZE  /CRASH_DUMP
    Invokes SDA to analyze the specified dump file.

    Format:

      /CRASH_DUMP [filespec]

    filespec

    Name of the file that contains the dump you want to analyze.
    If no filespec is given on an ANALYZE/CRASH_DUMP command,
    the default is the highest version of SYS$SYSTEM:SYSDUMP.DMP.
    If this file does not exist, SDA prompts you for a file name.
    If any field of filespec is given, the remaining fields default
    to the highest version of SYSDUMP.DMP in your default directory.

1    /COLLECTION

    Valid for Alpha and Integrity server systems only.

    Indicates to SDA that the file ID translation data or unwind data
    is to be found in a separate file.

    Format:

    /COLLECTION = collection-file-name

    collection-file-name

    You must specify at least one field of the collection file name.
    Other fields default to the highest generation of the same filename
    and location as the dump file, with a file type of .COLLECT.

    For details, refer to the VSI OpenVMS System Analysis Tools Manual.

2    /OVERRIDE

    Valid for Alpha and Integrity server systems only.

    Invokes SDA to analyze only the structure of the specified
    dump file when a corruption or other problem prevents
    normal invocation of SDA with the ANALYZE/CRASH_DUMP command.

    Format:

      /CRASH_DUMP/OVERRIDE [filespec]

    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

    You cannot use commands that access memory addresses within the
    dump file such as EXAMINE and SHOW SUMMARY

2.1  –  Examples

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

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

3    /RELEASE

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

    Requires CMKRNL (change-mode-to-kernel) privilege.

    Format:

      /CRASH_DUMP/RELEASE  filespec

    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, 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

3.1  –  Examples

  $ ANALYZE/CRASH_DUMP/RELEASE SYS$SYSTEM:PAGEFILE.SYS
  $ ANALYZE/CRASH_DUMP/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.

4    /SHADOW_MEMBER

    Valid for Alpha and Integrity server systems only.

    Specifies which member of a shadow set contains the system dump
    to be analyzed, or allows the user to determine what system dumps
    have been written to the members of the shadow set.

    Format:

    /CRASH_DUMP/SHADOW_MEMBER [filespec]

5    /SYMBOL

    Specifies an alternate system symbol table for SDA to use, for
    example, if you want to analyze a crash dump taken on a processor
    running a different version of OpenVMS.

    /SYMBOL is ignored if it is specified with /OVERRIDE or /RELEASE.

    Format:

      /SYMBOL = system-symbol-table

    system-symbol-table

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

    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:[ ],
    that is, the disk and directory specified in your last DCL command
    SET DEFAULT. If you specify a file for this parameter that is
    not a system symbol table, SDA exits with a fatal error.

5.1  –  Examples

    $ 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.
Close Help