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.