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.