OpenVMS VAX System Dump Analyzer Utility Manual Order Number: AA–PV6TD–TE April 2001 This manual explains how to use the System Dump Analyzer (SDA) to investigate system failures and examine a running system. Revision/Update Information: This manual supersedes the VMS System Dump Analyzer Utility Manual, Version 6.0 Software Version: OpenVMS VAX Version 7.
© 2001 Compaq Computer Corporation Compaq, AlphaServer, VAX, VMS, and the Compaq logo Registered in U.S. Patent and Trademark Office. OpenVMS, Alpha, and DECdirect are trademarks of Compaq Information Technologies Group, L.P. in the United States and other countries. UNIX and X/Open are trademarks of The Open Group in the United States and other countries. All other product names mentioned herein may be the trademarks of their respective companies. Confidential computer software.
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii SDA Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SDA Usage Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SDA–35 SDA Qualifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SDA–36 SDA–37 SDA–38 SDA–39 SDA–40 /CRASH_DUMP /RELEASE . . . . /SYMBOL . . . . . /SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
SHOW SYMBOL . . . . . . SHOW TRANSACTIONS SPAWN . . . . . . . . . . . . . VALIDATE QUEUE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . SDA–181 SDA–182 SDA–183 SDA–185 Pointer Argument List on the Stack . . . . . . Mechanism Array . .
Preface Intended Audience The OpenVMS VAX System Dump Analyzer Utility Manual is primarily intended for the system programmer who must investigate the causes of system failures and debug kernel-mode code, such as a device driver. This programmer should have some knowledge of OpenVMS data structures to properly interpret the results of System Dump Analyzer (SDA) commands.
Section Description of Contents SDA Commands Describes each SDA command; descriptions include the following information about each command: • Function • Format • Parameters This section also provides examples of situations in which specific commands are useful.
How To Order Additional Documentation Use the following World Wide Web address to order additional documentation: http://www.openvms.compaq.com/ If you need help deciding which documentation best meets your needs, call 800-282-6672. Conventions The following conventions are used in this manual: Ctrl/x A sequence such as Ctrl/x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system output (Internal error number), in command lines (/PRODUCER=name), and in command parameters in text (where dd represents the predefined code for the device type). UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
SDA Description When a fatal error causes the system to fail, the operating system copies the contents of memory to a system dump file; the system also records the hardware context of each processor in the system. The System Dump Analyzer (SDA) provides a means of interpreting the contents of the system dump file, thus enabling you to examine the status of each processor at the time of the failure and to investigate the probable causes of the crash.
SDA Description Table SDA–1 (Cont.
SDA Description Table SDA–4 Searching for, Formatting, and Copying Information Operation SDA Command Search memory for a given value SEARCH Format system data structures FORMAT Format a call frame from a stack location SHOW CALL_FRAME Copy the system dump file COPY Table SDA–5 describes the operations you can perform to manage the SDA utility and the SDA symbol table.
SDA Description 1 System Management and SDA The system manager must perform the following operations in regard to the system dump file: • Ensure that the system writes a dump file whenever the system fails. • Ensure that the dump file is large enough to contain all the information to be saved. • Ensure that the dump file is saved for analysis. The following sections describe these tasks. 1.
SDA Description Using PAGEFILE.SYS If SYS$SYSTEM:SYSDUMP.DMP does not exist, the operating system writes the dump of physical memory into SYS$SYSTEM:PAGEFILE.SYS, the system’s paging file, overwriting the contents of that file. If the SAVEDUMP system parameter is set, the dump file is retained in PAGEFILE.SYS when the system is booted. If it is clear, the entire paging file is used for paging, and any dump written to the paging file is lost.2 Do not use a selective dump (DUMPSTYLE=1) style with PAGEFILE.
SDA Description Note The ANALYZE/CRASH_DUMP/RELEASE command does not allow you to analyze the dump before deleting it. 1.1.2 Choosing a Dump File Style In certain system configurations, it might be impossible to preserve the entire contents of memory in a disk file. For instance, a large memory system or a system with small disk capacity might not be able to supply enough disk space for a full memory dump.
SDA Description Using /IGNORE=NOBACKUP Because system dump files are set to NOBACKUP, the Backup utility (BACKUP) does not copy dump files to tape unless you use the qualifier /IGNORE=NOBACKUP when invoking BACKUP. When you use the SDA COPY command to copy the system dump file to another file, the new file is not set to NOBACKUP. As included in the distribution kit, SYS$SYSTEM:SYSDUMP.DMP is protected against world access.
SDA Description Using PAGEFILE.SYS If you are using the SYS$SYSTEM:PAGEFILE.SYS as the crash dump file, you must include SDA commands in SYS$MANAGER:SYSTARTUP_VMS.COM that free the space occupied by the dump so that the pager can use it. For instance: $ ANALYZE/CRASH_DUMP SYS$SYSTEM:PAGEFILE.SYS . . . COPY dump_filespec EXIT 2 Analyzing a System Dump SDA performs certain tasks prior to bringing a dump into memory, presenting its initial displays, and accepting command input.
SDA Description 2.1 Invoking SDA If your process satisfies these conditions, you can issue the DCL command ANALYZE/CRASH_DUMP to invoke SDA. If you do not specify the name of a dump file in the command, SDA prompts you for the name of the file, as follows: $ ANALYZE/CRASH_DUMP _Dump File: The default file specification is as follows: disk:[default-dir]SYSDUMP.DMP disk and [default-dir] represent the disk and directory specified in your last SET DEFAULT command. 2.
SDA Description 2.3 Building the SDA Symbol Table After locating and reading the system dump file, SDA attempts to read the system symbol table file into the SDA symbol table. This file, named SYS$SYSTEM:SYS.STB by default, contains most of the global symbols used by the operating system. SDA also reads into its symbol table a subset of SYS$SYSTEM:SYSDEF.STB, called SYS$SYSTEM:REQSYSDEF.STB, that it requires to identify locations in memory.
SDA Description 3 Analyzing a Running System Occasionally, an internal problem hinders system performance but does not cause a system failure. By allowing you to examine the running system, SDA provides the means to search for the solution to the problem without disturbing the operating system. For example, you can use SDA to examine the stack and memory of a process that is stalled in a scheduler state, such as a miscellaneous wait (MWAIT) or a suspended (SUSP) state (see OpenVMS Performance Management).
SDA Description 4 SDA Context When invoked to analyze either a crash dump or a running system, SDA establishes a default context from which it interprets certain commands. When the subject of analysis is a uniprocessor system, SDA’s context is solely process context. That is, SDA can interpret its process-specific commands in the context of either the process current on the uniprocessor or some other process in some other scheduling state.
SDA Description SHOW PROCESS/INDEX=nn No other SDA commands affect the ‘‘SDA current CPU.’’ Note When you analyze the running system, you cannot use the SET CPU and SHOW CPU commands because SDA does not have access to all the CPU-specific information about the running system. 6 Process Context In a uniprocessor system, process context might be the process that is current on the CPU or the process in whose context process-specific SDA commands are interpreted.
SDA Description Command Description SET CPU cpu_id Changes the ‘‘SDA current process’’ to the current process on CPU cpu_id SHOW CPU cpu_id Changes the ‘‘SDA current process’’ to the current process on CPU cpu_id SHOW CRASH Changes the ‘‘SDA current process’’ to the current process on the CPU that induced the system failure No other SDA commands affect the ‘‘SDA current process.
SDA Description 7 SDA Command Format The following sections describe the format of SDA commands and the expressions you can use with SDA commands. 7.1 General Command Format SDA uses a command format similar to that used by the DCL interpreter. You issue commands in this general format: command-name[/qualifier...] [parameter][/qualifier...] [!comment] where: command-name Is an SDA command. Each command tells the utility to perform a function.
SDA Description 7.2.1 Radix Operators Radix operators determine which numeric base SDA uses to evaluate expressions. You can use one of three radix operators to specify the radix of the numeric expression that follows the operator: • ^X (hexadecimal) • ^O (octal) • ^D (decimal) The default radix is hexadecimal. SDA displays hexadecimal numbers with leading zeros and decimal numbers with leading spaces. 7.2.
SDA Description Table SDA–8 (Cont.) SDA Operators Operator Action Binary Operators / Division3 @ Arithmetic shifting 3 In division, SDA truncates the quotient to an integer, if necessary, and does not retain a remainder. 7.2.3 Precedence Operators SDA uses parentheses as precedence operators. Expressions enclosed in parentheses are evaluated first. SDA evaluates nested parenthetical expressions from the innermost to the outermost pairs of parentheses. 7.2.
SDA Description Table SDA–9 (Cont.
SDA Description Table SDA–9 (Cont.) SDA Symbols Symbol Meaning USP User stack pointer2 VCB Address of volume control block for mounted device1 1 The SHOW DEVICE command defines this symbol, if appropriate, to represent information pertinent to the last displayed device unit. See the description of the SHOW DEVICE command for additional information. 2 The value of those symbols representing the current SDA process context changes whenever you issue a command that changes the context (see Section 4).
SDA Description caused the bugcheck is located on the stack. See Section 8.2 for information about how to proceed for several types of bugchecks. 3. Once you have found the address of the instruction that caused the bugcheck, you need to find the module in which the failing instruction resides. Use the SHOW DEVICE command to determine whether the instruction is part of a device driver.
SDA Description When the system fails, the operating system reports the approximate cause of the failure on the console terminal. SDA displays a similar message when you issue a SHOW CRASH command.
SDA Description Figure SDA–2 Mechanism Array 00000004 Frame Depth R0 R1 ZK−1921−GE The values in the mechanism array are the following: Value Meaning 00000004 Number of longwords that follow. In a mechanism array, this value is always 4. Frame Address of the FP (frame pointer) of the establisher’s call frame. Depth Depth of the search for a condition handler. R0 Contents of R0 at the time of the exception. R1 Contents of R1 at the time of the exception.
SDA Description For access violations, the signal array is set up as follows: Value Meaning 00000005 Number of longwords that follow. For access violations, this value is always 5. 0000000C Exception code. The value 0C16 represents an access violation. You can identify the exception code by using the SDA command EVALUATE/CONDITION. Reason mask Longword mask. If bit 0 of this longword is set, the failing instruction (at the PC saved below) caused a length violation.
SDA Description Figure SDA–4 Stack Following an Illegal Page-Fault Error R4 R5 Reason Mask Virtual Address PC PSL ZK−1923−GE Six longwords describe the error: Longword Contents R4 Contents of R4 at the time of the bugcheck. R5 Contents of R5 at the time of the bugcheck. Reason mask Longword mask. If bit 0 of this longword is set, the failing instruction (at the PC saved below) caused a length violation. If bit 1 is set, it referred to a location whose page table entry is in an ‘‘access’’ page.
SDA Description 9.1 Identifying the Bugcheck First, invoke SDA to analyze the system dump file. The initialization message indicates the type of bugcheck that occurred as follows: Dump taken on 31-JAN-1993 16:34:31.23 INVEXCEPTN, Exception while above ASTDEL or on interrupt stack SDA> An exception occurred that caused the system to signal a bugcheck, and signal and mechanism arrays have been created on the current operating stack. 9.
SDA Description • The PC of the instruction that referred to the bad virtual address was 8005D00316 . Issuing the SDA command EVALUATE/PSL 04080000 makes the following information apparent: • The IPL was 8 at the time of the exception (shown by bits 16 through 20 of the PSL). • The current operating stack was the interrupt stack (bit 26 of the PSL is set to 1). • The process was executing in kernel mode at the time of the exception (shown by bits 24 and 25 of the PSL).
SDA Description In the following example, the instruction that caused the exception is located within the printer driver. SDA> EXAMINE/INSTRUCTION 8005D003 LPDRIVER+2B3 MOVB (R3)+,(R0) If SDA is unable to find a symbol within FFF16 bytes of the memory location you specify, it displays the location as an absolute address. This often, but not always, means the instruction that caused the exception is not part of a device driver.
SDA Description 9.4 Finding the Problem Within the Routine To find the problem within the routine, examine the printer’s driver code. In the system failure discussed in this example, the instruction that caused the exception is MOVB (R3)+,(R0). To check the contents of R3, use the EXAMINE command as follows: SDA> EXAMINE R3 R3: 80069E00 "...." The invalid virtual address, as recorded in the signal array, is stored in R3. In the following driver code excerpt, the instruction in question appears at line 599.
SDA Description Examine the code to determine which variables control the loop. The byte count (BCNT) is the number of characters in the buffer. Note that BCNT is set by a function decision table (FDT) routine and that this routine sets the value of BCNT to the number of characters in the buffer. In line 586, the starting address of a buffer that is BCNT bytes in size is moved into R3.
SDA Description . . . 8005D1C8 8005D1CC 8005D1CE 8005D1D0 8005D1D1 8005D1D2 . . . SDA> UCB$L_SVAPTE UCB$W_BOFF UCB$W_BCNT UCB$B_ERTCNT UCB$B_ERTMAX UCB$W_ERRCNT 80062720 0795 006D 00 00 0000 If you have only one printer in your system configuration, you do not need to use the FORMAT command. Instead, you can use the command SHOW DEVICE LP. Because only one printer is connected to the processor, only one UCB is associated with a printer for SDA to display.
SDA Description 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 30$: BNEQ 40$ ;If NEQ paper problem ADDW3 #1,R1,UCB$W_BOFF(R5) ;Save number of characters remaining DEVICELOCK LOCKADDR=UCB$L_DLCK(R5),- ;Lock device interrupts SAVIPL=-(SP) ;Save current IPL BITW #^X80,LP_CSR(R4) ;Is it ready now? BNEQ 35$ ;If NEQ, yes, it’s ready BISB #^X40,LP_CSR(R4) ;Set interrupt enable WFIKPCH 40$,#12 ;Wait for ready interrupt IOFORK ;Create
SDA Description • There must be a crash dump file in SYS$SYSTEM: named either SYSDUMP.DMP or PAGEFILE.SYS. This dump file must be either large enough to hold the entire contents of memory (as discussed in Section 1.1) or, if the DUMPSTYLE system parameter is set, large enough to accommodate a subset dump (see Section 1.1.2). If SYSDUMP.DMP is not present, the operating system attempts to write crash dumps to PAGEFILE.SYS. In this case, the SAVEDUMP system parameter must be 1 (the default is 0).
SDA Description VAX 82x0/83x0, VAXstation 3520/3540, 6000 Series, and 9000 Series The following console commands cause a system failure on a VAX 82x0/83x0 system, a VAXstation 3520/3540 system, a VAX 6000 series system, or a VAX 9000 series system. $ Ctrl/P PC = 80008B1F >>> >>> >>> >>> >>> >>> >>> >>> >>> E P E/I E/I E/I E/I E/I D/G D P C 0 + + + + F FFFFFFFF 41F0000 VAX 8600/8650 The following console commands cause a system failure on the VAX 8600/8650 systems.
SDA Description CONTINUE VAX-11/750 The following code causes a system failure on a VAX-11/750. On this processor, the HALT command is a NOP; a Ctrl/P automatically halts the processor. $ Ctrl/P >>> H >>> E P >>> E/I >>> E/I >>> E/I >>> E/I >>> E/I >>> D/G >>> D P >>> C 0 + + + + F FFFFFFFF 41F0000 MicroVAX 3400/3600/3900 Series, VAXstation/MicroVAX 3100, VAXstation/MicroVAX 2000, MicroVAX II, and VAX 4000 Series To force a crash of a MicroVAX, you must first halt the processor.
SDA Usage Summary The System Dump Analyzer is a utility that you can use to help determine the causes of system failures. This utility is also useful for examining the running system. Format analyze {/CRASH_DUMP [/RELEASE] filespec | /SYSTEM} [/SYMBOL=system-symbol-table] Command Parameter filespec Name of the file that contains the dump you want to analyze. At least one field of the filespec is required, and it can be any field. The default filespec is the highest version of SYSDUMP.
SDA Usage Summary SDA Qualifiers The following qualifiers, described in this section, determine whether the object of an SDA session is a crash dump or a running system. They also help create the environment of an SDA session. Table SDA–10 briefly describes the SDA qualifiers.
System Dump Analyzer /CRASH_DUMP /CRASH_DUMP Invokes SDA to analyze the specified dump file. Format /CRASH_DUMP filespec Parameter 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. Description See Section 2 for additional information on crash dump analysis. Examples 1.
System Dump Analyzer /RELEASE /RELEASE Invokes SDA to release those blocks in the specified system paging file occupied by a crash dump. Format /RELEASE filespec Parameter filespec Name of the system page file (SYS$SYSTEM:PAGEFILE.SYS). 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.
System Dump Analyzer /SYMBOL /SYMBOL Specifies a system symbol table for SDA to use in place of the system symbol table it uses by default (SYS$SYSTEM:SYS.STB). Format /SYMBOL =system-symbol-table Parameter system-symbol table File specification of the SDA system symbol table needed to define symbols required by SDA to analyze a dump from a particular system. The specified system-symbol-table must contain those symbols required by SDA to find certain locations in the executive image.
System Dump Analyzer /SYSTEM /SYSTEM Invokes SDA to analyze a running system. Format /SYSTEM Parameters None. Description See Section 3 for a full discussion of using SDA to analyze a running system. You cannot specify the /CRASH_DUMP or /RELEASE qualifiers when you include the /SYSTEM qualifier in the ANALYZE command. Example $ ANALYZE/SYSTEM This command invokes SDA to analyze the running system.
System Dump Analyzer SDA Commands Table SDA–11 briefly describes the SDA commands that are explained fully in the following section.
System Dump Analyzer Table SDA–11 (Cont.
System Dump Analyzer Table SDA–11 (Cont.
System Dump Analyzer @ (Execute Procedure) @ (Execute Procedure) Causes SDA to execute SDA commands contained in a file. Use this command to execute a set of frequently used SDA commands. Format @filespec Parameter filespec Name of a file that contains the SDA commands to be executed. The default file type is .COM. Example SDA> @USUAL The Execute Procedure command executes the following commands, as contained in a file named USUAL.COM: SET OUTPUT LASTCRASH.
System Dump Analyzer ATTACH ATTACH Switches control of your terminal from your current process to another process in your job. Format ATTACH [/PARENT] process-name Parameter process-name Name of the process to which you want to transfer control. Qualifier /PARENT Transfers control of the terminal to the parent process of the current process. When you specify this qualifier, you cannot specify the process-name parameter. Examples 1.
System Dump Analyzer COPY COPY Copies the contents of the dump file to another file. Format COPY output-filespec Parameter output-filespec Name of the device, directory, and file to which SDA copies the dump file. The default file specification is: SYS$DISK:[default-dir]filename.DMP SYS$DISK and [default-dir] represent the disk and directory specified in your last SET DEFAULT command. You must supply at least the file name.
System Dump Analyzer DEFINE DEFINE Assigns a value to a symbol or associates an SDA command with a terminal key. Format DEFINE [symbols-name [=] expression | /KEY key-name command | [/qualifier....]] Parameters symbol-name Name, containing from 1 to 31 alphanumeric characters, that identifies the symbol. See Section 7.2.4 for a description of SDA symbol syntax and a list of default symbols. expression Definition of the symbol’s value. See Section 7.2 for a discussion of the components of SDA expressions.
System Dump Analyzer DEFINE command SDA command the key is to be defined as. The command must be enclosed in quotation marks (" "). Qualifiers /ECHO /NOECHO Determines whether the equivalence string is displayed on the terminal screen after the defined key has been pressed. The /NOECHO qualifier functions only with the /TERMINATE qualifier. The default is /ECHO. /IF_STATE=(state-name, . . .
System Dump Analyzer DEFINE /TERMINATE /NOTERMINATE Causes the key definition to include termination of the command, which causes SDA to execute the command when the defined key is pressed. Therefore, you do not have to press the Return key after you press the defined key if you specify the /TERMINATE qualifier. Description The DEFINE command causes SDA to evaluate an expression and then assign its value to a symbol.
System Dump Analyzer DEFINE 5. SDA> DEFINE/KEY PF1 "SHOW STACK" SDA> PF1 SHOW STACK RETURN Process stacks (on CPU 00) ------------------------Current operating stack (KERNEL): 7FFE8DD4 7FFE8DD8 7FFE8DDC 7FFE8DE0 7FFE8DE4 7FFE8DE8 7FFE8DEC 7FFE8DF0 00001703 80127920 00000000 00000000 00000000 00000000 7FF743E4 7FF743CC SP => 7FFE8DF4 8000E646 7FFE8DF8 7FFEDE96 7FFE8DFC 03C00000 SGN$C_MAXPGFL+703 EXE$CMODEXEC+1EE SYS$CMKRNL+006 The DEFINE/KEY command defines PF1 as the SHOW STACK command.
System Dump Analyzer EVALUATE EVALUATE Computes and displays the value of the specified expression in both hexadecimal and decimal. Alternative evaluations of the expression are available with the use of the qualifiers defined for this command. Format EVALUATE {/CONDITION_VALUE | /PSL | /PTE | /SYMBOLS} expression Parameter expression SDA expression to be evaluated. Section 7.2 describes the components of SDA expressions.
System Dump Analyzer EVALUATE 2. SDA> EVALUATE 1 Hex = 00000001 Decimal = 1 ACP$V_SWAPGRP ACP$V_WRITECHK EVT$_EVENT The EVALUATE command evaluates a numeric expression and displays the value of that expression in hexadecimal and decimal notation. This example also shows the symbols that have the displayed value. A finite number of symbols are displayed by default. 3.
System Dump Analyzer EXAMINE EXAMINE Displays either the contents of a location or range of locations in physical memory, or the contents of a register. You can use location parameters to display specific locations or use qualifiers to display entire process and system regions of memory. Format EXAMINE [/qualifier[,...]] [location] Parameter location Location in memory to be examined. You can represent a location by any valid SDA expression (see Section 7.2).
System Dump Analyzer EXAMINE %SDA-E-NOINSTRAN, cannot translate instruction When you use this qualifier with the EXAMINE command, SDA calculates subsequent default addresses by adding the length of the last instruction, including all operands, to the last address examined. /NOSKIP Causes the EXAMINE command not to skip any bytes in the range when translating the contents of memory into MACRO instructions. The /NOSKIP qualifier causes the execution of the /INSTRUCTION qualifier by default.
System Dump Analyzer EXAMINE To examine a range of locations, you can designate starting and ending locations separated by a colon. For example: SDA> EXAMINE G40:G200 Alternatively, you can specify a location and a length, in bytes, separated by a semicolon.
System Dump Analyzer EXAMINE Examining Memory Regions You can display an entire region of virtual memory by using one or more of the qualifiers /ALL, /SYSTEM, /P0, and P1, with the EXAMINE command. Other Uses Other uses of the EXAMINE command appear in the following examples. Examples 1. SDA> EXAMINE/SYSTEM System Region Memory -------------------00040039 8FBC0010 00040038 8FBC0010 ....8.......9... . . .
System Dump Analyzer EXIT EXIT Exits from an SDA display or from the SDA utility. Format EXIT Parameters None. Qualifiers None. Description If SDA is displaying information about a video display terminal—and if that information extends beyond one screen—SDA displays a screen overflow prompt at the bottom of the screen:4 Press RETURN for more. SDA> If you want to discontinue the current display at this point, enter the EXIT command. If you want SDA to execute another command, enter that command.
System Dump Analyzer FORMAT FORMAT Displays a formatted list of the contents of a block of memory. Format FORMAT [/qualifier] location Parameter location Location of the beginning of the data block. The location can be given as any valid SDA expression. Qualifier /TYPE=block-type Forces SDA to characterize and format a data block at location as the specified type of data structure.
System Dump Analyzer FORMAT Certain data structures do not contain a block type at offset 0A16 . If this byte contains information other than a block type—or the byte does not contain a valid block type—SDA displays this message: %SDA-E-INVBLKTYP, invalid block type in specified block To format such a block, you must reissue the FORMAT command, using the /TYPE qualifier to designate a block-type.
System Dump Analyzer HELP HELP Displays information about the SDA utility, its operation, and the format of its commands. Format HELP [command-name] Parameter command-name Command for which you need information. You can also specify the following keywords in place of command-name.
System Dump Analyzer HELP If you do not specify a parameter in the HELP command, it lists those commands and topics for which you can request help, as follows: Information available: ATTACH COPY Execute_Command Initialization SEARCH SET CPU_Context DEFINE EXIT Expressions Operation Process_Context SHOW SPAWN Symbols EVALUATE EXAMINE FORMAT HELP READ REPEAT VALIDATE QUEUE Topic? SDA–61
System Dump Analyzer READ READ Loads the global symbols contained in the specified object module into the SDA symbol table. Format READ {/EXECUTIVE directory-spec | [RELOCATE=expression] | filespec} Parameter filespec Name of the device, directory, and file that contains the object module from which you want to copy global symbols. The filespec defaults to SYS$DISK:[defaultdir]filename.STB, where SYS$DISK and [default-dir] represent the disk and directory specified in your last SET DEFAULT command.
System Dump Analyzer READ Table SDA–12 lists those object module files provided in SYS$SYSTEM. Table SDA–13 lists those loadable images in SYS$LOADABLE_IMAGES that define locations within the executive image. Table SDA–12 Modules Containing Global Symbols and Data Structures Used by SDA File Contents CLUSTRLOA.STB DCLDEF.STB IMGDEF.STB NETDEF.STB RMSDEF.
System Dump Analyzer READ Table SDA–13 (Cont.) Modules Defining Global Locations Within the Executive Image File Contents IO_ROUTINES.
System Dump Analyzer READ Table SDA–13 (Cont.) Modules Defining Global Locations Within the Executive Image File Contents TCPIP$NFS_SERVICES.STB1 Symbols for the TCP/IP NFS server Symbols for the TCP/IP proxy execlet TCP/IP PWIP ACP TCP/IP PWIP driver TCP/IP TELNET/RLOGIN server driver Swapper, its supporting routines, and working set management system services TCPIP$PROXY_SERVICES.STB1 TCPIP$PWIPACP.STB1 TCPIP$PWIPDRIVER.STB1 TCPIP$TNDRIVER.STB1 WORKING_SET_ MANAGEMENT.
System Dump Analyzer READ 3. SDA> SHOW STACK Process stacks (on CPU 01) -------------------------Current operating stack (KERNEL): 7FF8F2B0 806BA870 7FF8F2B4 7FF8F4C0 7FF8F2B8 8016F33E PAGE_MANAGEMENT+0053E . . . SDA> READ/RELOCATE=PAGE_MANAGEMENT SYS$LOADABLE_IMAGES:PAGE_MANAGEMENT.EXE %SDA-I-READSYM, reading symbol table SYS$COMMON:[SYS$LDR]PAGE_MANAGEMENT.
System Dump Analyzer REPEAT REPEAT Repeats execution of the last command issued. On terminal devices, the KP0 key performs the same function as the REPEAT command. Format REPEAT Parameters None. Qualifiers None. Description The REPEAT command is useful for stepping through a linked list of data structures or for examining a sequence of memory locations. Examples 1. SDA> FORMAT @IOC$GL_DEVLIST 8000B540 8000B544 8000B548 . . .
System Dump Analyzer REPEAT pressing the KP0 key—or issuing the REPEAT command—is sufficient to display each DDB in the device list. 2. SDA> SHOW CALL_FRAME Call Frame Information ---------------------Call Frame Generated by CALLG Instruction Condition Handler SP Align Bits = 00 Saved AP Saved FP 7FFE7D78 7FFE7D7C 7FFE7D80 7FFE7D84 00000000 00000000 7FFE7DC0 7FFE7D94 CTL$GL_KSTKBAS+005C0 CTL$GL_KSTKBAS+00594 . . .
System Dump Analyzer SEARCH SEARCH Scans a range of memory locations for all occurrences of a specified value. Format SEARCH [/qualifier] range[=]expression Parameters range Location in memory to be searched. A location can be represented by any valid SDA expression (see Section 7.2).
System Dump Analyzer SEARCH 2. SDA> SEARCH/STEPS=BYTE 80000000;1000 6 Searching from 80000000 to 80001000 in BYTE steps for 00000006... Match at 80000A99 SDA> The SEARCH command finds the value 00000006 in the longword at 80000A99. 3. SDA> SEARCH/LENGTH=WORD 80000000;2000 6 Searching from 80000000 to 80002000 in LONGWORD steps for 0006...
System Dump Analyzer SET CPU SET CPU Selects a processor to become the SDA current CPU. Format SET CPU cpu-id Parameter cpu-id Numeric value from 0016 to 1F16 indicating the identity of the processor to be made the current CPU. If you specify a value outside this range or a cpu-id of a processor that was not active at the time of the system failure, SDA displays the following message: %SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range Qualifiers None.
System Dump Analyzer SET CPU You cannot use the SET CPU command when examining the running system with SDA. Example $ ANALYZE/CRASH SYS$SYSTEM:SYSDUMP.DMP Dump taken on 22-FEB-1993 14:22:17.66 NOBUFPCKT, Required buffer packet not present SDA> SHOW CPU CPU 01 Processor crash information ---------------------------------CPU 01 reason for Bugcheck: NOBUFPCKT, Required buffer packet not present . . .
System Dump Analyzer SET CPU 80DAFB4C 80DAFB50 8018BC20 7FFC653E . . . The series of SHOW CPU and SHOW STACK commands in this example illustrates the switching of CPU context within an SDA session: 1. When you first invoke SDA, it is, by default, within the CPU context of the processor that caused the crash (CPU 01). This is illustrated by the first set of SHOW CPU and SHOW STACK commands. 2.
System Dump Analyzer SET LOG SET LOG Initiates or discontinues the recording of an SDA session in a text file. Format SET [NO]LOG filespec Parameter filespec Name of the file in which you want SDA to log your commands and their output. The default filespec is SYS$DISK:[default_dir]filename.LOG, where SYS$DISK and [default-dir] represent the disk and directory specified in your last SET DEFAULT command. You must specify a file name. Qualifiers None.
System Dump Analyzer SET OUTPUT SET OUTPUT Redirects output from SDA to the specified file or device. Format SET OUTPUT filespec Parameter filespec Name of the file to which SDA is to send the output generated by its commands. The default filespec is SYS$DISK:[default_dir]filename.LIS, where SYS$DISK and [default-dir] represent the disk and directory specified in your last SET DEFAULT command. You must specify a file name.
System Dump Analyzer SET PROCESS SET PROCESS Selects a process to become the SDA current process. Format SET PROCESS {process-name | /INDEX=nn | /SYSTEM} Parameter process-name Name of the process to become the SDA current process. The process-name is a string containing up to 15 uppercase or lowercase characters; numerals, the dollar sign ( $ ) character, and the underscore ( _ ) character can also be included in the string.
System Dump Analyzer SET PROCESS The SET PROCESS command changes the current SDA process context to that of the process indicated by name or /INDEX=nn.
System Dump Analyzer SET PROCESS The SET PROCESS command sets the current process to ERRFMT, as shown by the second SHOW PROCESS command.
System Dump Analyzer SET RMS SET RMS Changes the options shown by the SHOW PROCESS/RMS command. Format SET RMS =(option[,...]) Parameter option Data structure or other information to be displayed by the SHOW PROCESS/RMS command. Table SDA–14 lists those keywords that you can use as options.
System Dump Analyzer SET RMS Table SDA–14 (Cont.
System Dump Analyzer SET RMS that are displayed in response to a SHOW PROCESS/RMS command. The SET RMS command selects only the IFB to be displayed by subsequent SET/PROCESS commands. 2. SDA> SET RMS=(*,BLB,BLBSUM,RLB) SDA> SHOW RMS RMS Display Options: IFB,RLB,BLB,BLBSUM Display RMS structures for all IFI values. The SET RMS command adds BLB, BLBSUM, and RLB to the list of data structures that the SHOW PROCESS/RMS command currently displays. 3.
System Dump Analyzer SHOW CALL_FRAME SHOW CALL_FRAME Displays the locations and contents of the longwords representing a procedure call frame. Format SHOW CALL_FRAME [starting-address | /NEXT_FP] Parameter starting-address Expression representing the starting address of the procedure call frame to be displayed. The default starting-address is the longword contained in the FP register of the SDA current process.
System Dump Analyzer SHOW CALL_FRAME Figure SDA–5 Call Frame Condition Handler Address SPA S 0 Mask <11:0> Saved PSW <15:5> 0 :(FP) Saved AP Saved FP Saved PC Saved R0 Saved R11 ZK−6564−GE The SHOW CALL_FRAME command follows this listing with an indication of how many bytes were used to align the call frame to a longword boundary.
System Dump Analyzer SHOW CALL_FRAME Example SDA> SHOW CALL_FRAME Call Frame Information ---------------------Call Frame Generated by CALLG Instruction Condition Handler SP Align Bits = 00 Saved AP Saved FP Return PC Align Stack by 0 Bytes 7FFE7D78 7FFE7D7C 7FFE7D80 7FFE7D84 7FFE7D88 => 00000000 00000000 7FFE7DC0 7FFE7D94 8015303F CTL$GL_KSTKBAS+005C0 CTL$GL_KSTKBAS+00594 EXCEPTION+0043F SDA> SHOW CALL_FRAME/NEXT_FP Call Frame Information ---------------------Call Frame Generated by CALLS Instruction Co
System Dump Analyzer SHOW CLUSTER SHOW CLUSTER Displays connection manager and system communications services (SCS) information for all nodes in a cluster. Format SHOW CLUSTER {/CSID=csid | /NODE=name | /SCS} Parameters None. Qualifiers /CSID=csid Displays VAXcluster system information for a specific VAXcluster member node. The value csid is the cluster system identification number (CSID) of the node to be displayed.
System Dump Analyzer SHOW CLUSTER • Number of votes (if any) provided by the node • Its state8 • Its status The cluster block display includes information recorded in the cluster block (CLUB), including a list of activated flags, a summary of quorum and vote information, and other data that applies to the cluster from the perspective of the node for which SDA is being run.
System Dump Analyzer SHOW CLUSTER --- CSB list --Address ------- Node ---- CSID ---- 803686F0 SOLLY 80368550 GUS 80367B90 DORIS 000100C8 000100C9 000100C5 Votes ----- State ----- 1 1 1 open open open Status -----member,qf_active member,qf_active member,qf_active --- Cluster Block (CLUB) 801C3F70 --Flags: 10080001 cluster,init,quorum Quorum/Votes Quorum Disk Votes Nodes Quorum Disk Found Node SYSID Founding Time 2/3 1 3 $255$DUA2 0000000008A0 3-DEC-1992 00:01:44 Index of next CSID 00D2 Quorum Disk
System Dump Analyzer SHOW CLUSTER 2. SDA> SHOW CLUSTER /CSID=000100C8 VAXcluster data structures ---------------------------- SOLLY Cluster System Block (CSB) 803686F0 --State: 01 open Flags: 02020302 member,cluster,qf_active,selected,status_rcvd Quorum/Votes 2/1 Quor. Disk Vote 1 CSID 000100C8 Eco/Version 0/12 Reconn. time 00000059 Ref. count 2 Ref. time 18-DEC-1993 08:53:58 Next seq. number 0247 Last seq num rcvd 0314 Last ack.
System Dump Analyzer SHOW CLUSTER --- PINTO System Block (SB) 8041A120 --System ID 00000000F10E Max message size 66 Max datagram size 62 Local hardware type HS50 Local hardware vers. 022702220222 022202220222 Local software type Local software vers. Local software incarn. SCS poller timeout SCS poller enable mask HSC X301 8355FE00 008DA59A 000F 01 --- Path Block (PB) 8041C400 --Status: 0000 Remote sta. addr. 00000000000E Remote state 00000000000E Remote hardware rev. 00000225 Remote func.
System Dump Analyzer SHOW CONNECTIONS SHOW CONNECTIONS Displays information about all active connections between systems communications services (SCS) processes or a single connection. This command displays information that is in the connection descriptor table (CDT). Format SHOW CONNECTIONS {/ADDR or /ADDRESS=cdt-address | /NODE=name | /SYSAP=name} Parameters None. Qualifiers /ADDR or /ADDRESS=cdt-address Displays information contained in the connection descriptor table (CDT) for a specific connection.
System Dump Analyzer SHOW CONNECTIONS Examples 1.
System Dump Analyzer SHOW CONNECTIONS 3. SDA> SHOW CONNECTIONS/NODE=MOON VAXcluster data structures ---------------------------- Connection Descriptor Table (CDT) 98310EE0 --State: 0002 open Local Process: MSCP$DISK Blocked State: 0000 Remote Node::Process: MOON::VMS$DISK_CL_DRVR Local Con. ID 7C79004E Remote Con. ID 009F0069 Receive Credit 16 Send Credit 10 Min. Rec. Credit 1 Pend Rec. Credit 0 Initial Rec. Credit 10 Rem. Sta.
System Dump Analyzer SHOW CONNECTIONS State: 0001 listen Blocked State: 0000 Local Process: Local Con. ID 7C790003 Remote Con. ID 00000000 Receive Credit 0 Send Credit 0 Min. Rec. Credit 0 Pend Rec. Credit 0 Initial Rec. Credit 0 Rem. Sta. 000000000000 Rej/Disconn Reason 0 Queued for BDT 0 Queued Send Credit 0 Datagrams sent Datagrams rcvd Datagram discard Messages Sent Messages Rcvd. Send Data Init. Req Data Init.
System Dump Analyzer SHOW CPU SHOW CPU Displays information about the state of a processor at the time of the system failure. Format SHOW CPU [cpu-id] Parameter cpu-id Numeric value from 00 to 1F16 indicating the identity of the processor for which context information is to be displayed.
System Dump Analyzer SHOW CPU • Stack pointers and memory interconnect silos The first section includes registers that maintain the virtual address space, system space, or other system functions of the current process.
System Dump Analyzer SHOW CPU Example SDA> SHOW CPU CPU 00 Processor crash information ---------------------------------CPU 00 reason for Bugcheck: INVEXCEPTN, Exception while above ASTDEL or on interrupt stack Process currently executing: NETACP Current image file: $254$DUA200:[SYS6.SYSCOMMON.]NETACP.
System Dump Analyzer SHOW CPU Spinlocks currently owned by CPU 00 IOLOCK8 Owner CPU ID : 00 Ownership Depth : 0001 CPUs Waiting : 0000 Address IPL Rank Index : : : : 80185E50 08 14 34 SDA> EXAMINE R5 R5: 8047FC40 "@üG." SDA> SHOW PROCESS Process index: 000D Name: NETACP Extended PID: 33C0010D ----------------------------------------------------------Process status: 00148001 RES,NOACNT,PHDRES,LOGIN . . .
System Dump Analyzer SHOW CRASH SHOW CRASH In the analysis of a system failure, displays information about the state of the system at the time of the failure. In the analysis of a running system, provides information identifying the system. Format SHOW CRASH Parameters None. Qualifiers None. Description The SHOW CRASH command has two different manifestations, depending upon whether you use it while analyzing a running system or a system failure.
System Dump Analyzer SHOW CRASH • Identity of the system, including an indication of its VAXcluster membership and the location of the primary CPU in a multiprocessing configuration. • CPU IDs of both the primary CPU and the CPU that initiated the bugcheck. In a uniprocessor system, these IDs are identical. • Two bit masks indicating which processors in the system are active and which are available for booting, respectively.
System Dump Analyzer SHOW CRASH 2. $ ANALYZE/CRASH SYS$SYSTEM OpenVMS VAX System dump analyzer Dump taken on 23-FEB-1993 12:44:30.23 INVEXCEPTN, Exception while above ASTDEL or on interrupt stack SDA> SHOW CRASH System crash information ! -----------------------Time of system crash: 23-FEB-1993 12:44:30.23 Version of system: OpenVMS VAX VERSION 6.
System Dump Analyzer SHOW CRASH 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Spinlocks currently owned by CPU 00 IOLOCK8 Owner CPU ID : 00 Ownership Depth : 0001 CPUs Waiting : 0000 Address IPL Rank Index : : : : 80185E50 08 14 34 CPU 01 Processor crash information ---------------------------------CPU 01 reason for Bugcheck: CPUEXIT, Shutdown requested by another CPU Process currently executing on this CPU
System Dump Analyzer SHOW CRASH 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 No spinlocks currently owned by CPU 01 This long display reflects the output of the SHOW CRASH command within the analysis of a system failure that occurred on a VAX 8800 multiprocessing system.
System Dump Analyzer SHOW DEVICE SHOW DEVICE Displays a list of all devices in the system and their associated data structures or displays the data structures associated with a given device or devices. Format SHOW DEVICE {device-name | /ADDRESS=ucb-address} Parameter device-name Device or devices for which data structures are to be displayed. There are several uses of the device-name parameter. To Display the Structures for . . .
System Dump Analyzer SHOW DEVICE Description The SHOW DEVICE command produces several displays taken from system data structures that describe the devices in the system configuration. If you use the SHOW DEVICE command to display information for more than one device or one or more controllers, it initially produces the DDB list display to provide a brief summary of the devices for which it renders information in subsequent screens.
System Dump Analyzer SHOW DEVICE Symbol Meaning ORB DDB DDT CRB AMB IRP 2P_UCB LNM PDT CDDB 2P_CDDB RWAITCNT VCB Address of object rights block Address of device data block Address of driver dispatch table Address of channel request block Associated mailbox UCB pointer Address of I/O request packet Address of alternate UCB for dual-pathed device Address of logical name block for mailbox Address of port descriptor table Address of class driver descriptor block for MSCP-served device Address of alternate C
System Dump Analyzer SHOW DEVICE STATE C IRP PID MODE CHAN FUNC 80BE2B00 00010064 E nop bufio,func WCB EFN AST IOSB STATUS FFC0 C000 00000000 29 80127458 7FFA800C 0003 This example reproduces the SHOW DEVICE display for a single device unit, VTA20. Whereas this display lists information from the UCB for VTA20, including some addresses of key data structures and a list of pending I/O requests for the unit, it does not display information about the controller or its device driver.
System Dump Analyzer SHOW DEVICE 3. SDA> SHOW DEVICE DUS I/O data structures ------------------DDB list -------Address ------- Controller ---------- 80D0B9C0 RED$DUS ACP --- Driver ------ F11XQP DSDRIVER DPT --- DPT size -------- 807735B0 679D Controller: RED$DUS ---------------------- LOVE System Block (SB) 80D0C500 --System ID 00000000FFF2 Max message size 66 Max datagram size 62 Local hardware type HS50 Local hardware vers. 2722722221A3 000000272272 Local software type Local software vers.
System Dump Analyzer SHOW DEVICE Owner UIC [100001,000063] PID 00000000 Alloc. lock ID 00010161 Alloc. class 254 Class/Type 01/15 Def. buf.
System Dump Analyzer SHOW DEVICE --- ACP Queue Block (AQB) 80D0BAE0 --ACP requests are serviced by the eXtended Qio Processor (XQP) Status: 14 defsys,xqioproc Mount count 56 ACP type ACP class f11v2 0 Request queue 00000000 *** ACP request queue is empty *** RED$DUS5 RA80 UCB address: 803B9DF0 Device status: 00021810 online,valid,unload,lcl_valid Characteristics: 1C4D4008 dir,fod,shr,avl,mnt,elg,idv,odv,rnd 000002A1 clu,mscp,srv,nnm . . .
System Dump Analyzer SHOW EXECUTIVE SHOW EXECUTIVE Displays the location and size of each loadable image that makes up the executive. Format SHOW EXECUTIVE Parameters None. Qualifiers None. Description The executive consists of a fixed portion and a loadable portion. The fixed portion is known as SYS$SYSTEM:SYS.
System Dump Analyzer SHOW EXECUTIVE Example SDA> SHOW EXECUTIVE VMS Executive Layout -------------------Image Base End Length SYSMSG RECOVERY_UNIT_SERVICES RMS CPULOA LMF$GROUP_TABLE SYSLICENSE SYSGETSYI SYSDEVICE MESSAGE_ROUTINES EXCEPTION LOGICAL_NAMES SECURITY LOCKING PAGE_MANAGEMENT WORKING_SET_MANAGEMENT IMAGE_MANAGEMENT EVENT_FLAGS_AND_ASTS IO_ROUTINES PROCESS_MANAGEMENT ERRORLOG PRIMITIVE_IO SYSTEM_SYNCHRONIZATION SYSTEM_PRIMITIVES 8015AA00 80211400 80183600 801B2800 801B3800 801B4000 801B5A00 8
System Dump Analyzer SHOW HEADER SHOW HEADER Displays the header of the dump file. Format SHOW HEADER Parameters None. Qualifiers None. Description The SHOW HEADER command produces a 10-column display, each line of which displays both the hexadecimal and ASCII representation of the contents of the dump file header in 32-byte intervals.
System Dump Analyzer SHOW LAN SHOW LAN Displays information contained in various local area network (LAN) data structures. The default qualifiers are /CSMACD/FDDI. Format SHOW LAN [/qualifier[,...]] Parameters None. Qualifiers /CLIENT=xx Specifies that information be displayed for the specified client. Valid client designators are SCA, DECNET, LAT, MOPRC, TCPIP, DIAG, ELN, BIOS, LAST, USER, ARP, MOPDL, LOOP, BRIDGE, DNAME, ENCRY, DTIME, and LTM.
System Dump Analyzer SHOW LAN /SUMMARY Specifies that only a summary of LAN information (a list of flags, LSBs, UCBs, and base addresses) be printed. This is the default. /TIMESTAMPS Specifies to print time information (start and stop times and error times) from the device and unit data structures. SDA displays the data in chronological order. /UNIT=xx/[dn] Specifies that information be displayed for the specified unit.
System Dump Analyzer SHOW LAN UCB --EXB0 EXB1 EXB2 UCB Addr -------98358880 983B8B00 98ACD500 Fmt --- Value ----- Client State ------ ----------- Eth Eth 60-07 60-03 SCA 0017 Strtn,Len,Uniq,Strtd DECNET 0004 Uniq LSB address = 9836FE00 Device state = 001B Inited,Run,Ctl_Rdy,Timer -- EXC Unit Summary 26-JAN-1993 20:57:41 -UCB --EXC0 EXC1 EXC2 UCB Addr -------9836CA80 983C08C0 98ACD7C0 Fmt --- Value ----- Client State ------ ----------- Eth Eth 60-07 60-03 SCA 0017 Strtn,Len,Uniq,Strtd DECNET 0
System Dump Analyzer SHOW LAN UCB --EXA0 EXA1 EXA3 EXA5 UCB Addr -------98358540 98376340 98ACD240 983A9580 Fmt --- Value ----- Client State ------ ----------- Eth Eth Eth 60-07 60-03 80-41 SCA 0017 Strtn,Len,Uniq,Strtd DECNET 0004 Uniq LAST 0015 Strtn,Uniq,Strtd LSB address = 9836CE00 Device state = 001B Inited,Run,Ctl_Rdy,Timer -- EXB Unit Summary 26-JAN-1993 20:57:22 -UCB --EXB0 EXB1 EXB2 UCB Addr -------98358880 983B8B00 98ACD500 Fmt --- Value ----- Client State ------ ----------- Eth Eth
System Dump Analyzer SHOW LAN UCB --FXB0 FXB1 FXB2 UCB Addr -------98377F80 983D0440 98AC9900 Fmt --- Value ----- Client State ------ ----------- Eth Eth 60-07 60-03 SCA 0017 Strtn,Len,Uniq,Strtd DECNET 0004 Uniq The SHOW LAN command in this example displays FDDI information. 5.
System Dump Analyzer SHOW LAN Rcv buffers owned by device Xmt entries owned by device Xmt entries owned by host 9 0 0 NMgmt advised buffer count 0 EIB address 00000000 LPB address 00000000 System buffer quota Device dependent longword # restarts pending 0 00000000 0 Events logged 0 NMgmt assigned adr 00-00-00-00-00-00 -- ESA Queue Information 27-JAN-1993 09:54:50 -Control hold queue Control request queue Control pending queue Transmit request queue Transmit pending queue Receive buffer queue Receive p
System Dump Analyzer SHOW LAN LSB address Packet format Device buffer size Maximum buffer size Hardware buffer quota Receive buffer quota Allow prom client Promiscuous mode 802.2 service Data chaining Padding mode Automatic restart CRC generation mode Maintenance state P2 parameters All multicast mode Rcv buffer quota 80ECE700 Ethernet 1500 1500 9 0 ON OFF OFF OFF ON OFF ON ON 00000000 OFF 0 VCIB address 00000000 Error count 0 LAN medium CSMACD Eth protocol type 00-00 802E protocol ID 00-00-00-00-00 802.
System Dump Analyzer SHOW LAN -- ESA4 80-41 (LAST) Counters & Misc Info 27-JAN-1993 09:54:50 -Last receive 27-JAN 09:54:39 Last transmit 27-JAN 09:54:38 Octets received 1941967 Octets sent 371740 . . . -- ESA4 80-41 (LAST) Multicast Address Info 27-JAN-1993 09:54:50 -Multicast address table, embedded: 09-00-2B-04-00-00 The SHOW LAN/FULL command in this example displays information for all LAN, LSB, and UCB data structures. 6.
System Dump Analyzer SHOW LOCK SHOW LOCK Displays information about all lock management locks in the system, cached locks, or a specified lock. Format SHOW LOCK {lock-id | /ALL | /CACHED | /NAME=resource-name} Parameters lock-id Name of a specific lock. You cannot specify both a lock-id and a resource-name in the same command line. Qualifiers /ALL Lists all locks that exist in the system. This is the default behavior of the SHOW LOCK command. /CACHED Shows only cached lock blocks (LKBs).
System Dump Analyzer SHOW LOCK Table SDA–15 Contents of the SHOW LOCK and SHOW PROCESS/LOCKS Displays Display Element Process Index1 Name1 Extended PID1 Lock ID PID Flags Par. ID Granted at Sublocks LKB Resource Status Length — — — 1 You SDA–122 Description Index into the PCB array to a pointer to the process control block (PCB) of the process that owns the lock. Name of the process that owns the lock. Clusterwide identification of the process that owns the lock. Identification of the lock.
System Dump Analyzer SHOW LOCK Examples 1. SDA> SHOW LOCK Lock database ------------Lock id: 00010001 PID: 00000000 Flags: NOQUEUE SYNCSTS SYSTEM Par. id: 00000000 Granted at EX CVTSYS Sublocks: 1 LKB: 80D0B8A0 Resource: 5F535953 24535953 SYS$SYS_ Status: NOQUOTA Length 16 00000000 4C774449 IDwL.... Exec. mode 00000000 00000000 ........ System 00000000 00000000 ........ Local copy Lock id: 00010004 PID: 00000000 Flags: CONVERT SYNCSTS CVTSYS Par.
System Dump Analyzer SHOW LOCK This SDA session shows the output of the SHOW LOCK command for several locks. The SHOW RESOURCE command, executed for the last displayed lock, verifies that the lock is in the resource’s granted queue, among many other locks given concurrent read (CR) access to the resource. (See Table SDA–21 for a full explanation of the contents of the display of the SHOW RESOURCE command.) 2. SDA SHOW LOCK/CACHE Lock database ------------Lock id: 6D000032 PID: 00010028 Par.
System Dump Analyzer SHOW LOGS SHOW LOGS Displays information about transaction logs currently open for the node. Format SHOW LOGS [/qualifier[,...]] Qualifier /DISPLAY=(item [,...]) Specifies the type of information to be displayed. The argument to /DISPLAY can be either a single item or a list. The following items can be specified. Item Description ALL All transaction log control structure information. This is the default behavior. Transaction log open requests. Transaction log read requests.
System Dump Analyzer SHOW PAGE_TABLE SHOW PAGE_TABLE Displays a range of system page table entries, the entire system page table, or the entire global page table. Format SHOW PAGE_TABLE [/qualifier[,...]] [range] Parameter range Range of virtual addresses for which SDA is to display page table entries.
System Dump Analyzer SHOW PAGE_TABLE Table SDA–16 (Cont.) Virtual Page Information in the SHOW PAGE_TABLE Display Value Meaning PTE Contents of the page table entry, a longword that describes a system virtual page. Type of virtual page. There are the following eight types: Type PROT • VALID Valid page (in main memory). • TRANS Transitional page (between main memory and page lists). • DZERO Demand-allocated, zero-filled page. • PGFIL Page within a paging file. • STX Section table’s index page.
System Dump Analyzer SHOW PAGE_TABLE Table SDA–16 (Cont.) Virtual Page Information in the SHOW PAGE_TABLE Display Value Meaning Bits Letters that represent the setting of a bit or a combination of bits in the PTE. These bits indicate attributes of a page. The following codes are listed: • M Page has been modified. • L Page is locked into a working set. • K Owner can access the page in kernel mode. • E Owner can access the page in executive mode. • S Owner can access the page in supervisor mode.
System Dump Analyzer SHOW PAGE_TABLE Table SDA–17 (Cont.) Physical Page Information in the SHOW PAGE_TABLE Display Category Meaning LOC Location of the page within the system. One of the following eight locations: STATE TYPE REFCOUNT BAK SVAPTE FLINK BLINK • ACTIVE Page is in a working set. • MDFYLST Page is in the modified page list. • FREELST Page is in the free page list. • BADLST Page is in the bad page list. • RELPEND Release of the page is pending.
System Dump Analyzer SHOW PAGE_TABLE Example SDA>SHOW PAGE_TABLE System page table ----------------ADDRESS . . . 8014B000 8014B200 8014B400 8014B600 8014B800 8014BA00 8014BC00 . . . 8014BE00 8014C000 8014C200 8014C400 8014C600 8014C800 8014CA00 . . .
System Dump Analyzer SHOW PFN_DATA SHOW PFN_DATA Displays information that is contained in the page lists and PFN database. Format SHOW PFN_DATA [pfn] [/qualifier] Parameter pfn Page frame number (PFN) of the physical page for which information is to be displayed. Qualifiers /ALL Displays the free page list, modified page list, and bad page list. This is the default behavior of the SHOW PFN_DATA command. SDA precedes each list with a count of the pages it contains and its low and high limits.
System Dump Analyzer SHOW PFN_DATA Table SDA–18 (Cont.
System Dump Analyzer SHOW PFN_DATA Table SDA–18 (Cont.) Page Frame Number Information in the SHOW PFN_ DATA Display Item Contents STATE State of the virtual page, the low nibble of which can be one of the following: • 0 Page is on the free page list. • 1 Page is on the modified page list. • 2 Page is on the bad page list. • 3 Release of the page to the free or modified page list is pending. • 4 Error occurred as the page was being read from the disk.
System Dump Analyzer SHOW PFN_DATA Example SDA>SHOW PFN_DATA Free page list -------------Count: 225 Low limit: 57 High limit: 1073741824 PFN PTE ADDRESS ---- ----------1329 8047AF3C 1963 8047AB10 017C 8047B3F8 14B4 8047B464 1529 8047AA34 1485 8047AC80 . . .
System Dump Analyzer SHOW POOL SHOW POOL Displays information about the disposition of paged and nonpaged memory, nonpaged dynamic storage pool, and paged dynamic storage pool. Format SHOW POOL [range][/ALL | /FREE | /HEADER | /NONPAGED | /PAGED | /RING_BUFFER | /STATISTICS | /SUMMARY | /TYPE=block-type] Parameters range Range of virtual addresses in pool that SDA is to examine.
System Dump Analyzer SHOW POOL • Attempts, failures, and deallocations SDA does not synchronize its access to these last three counters with other CPUs in a symmetric multiprocessing (SMP) system. Therefore, the numbers might not add up to what you would expect in a multiprocessor configuration. However, the statistics do provide a good indicator of overall pool activity. /SUMMARY Displays only an allocation summary for each specified region of pool.
System Dump Analyzer SHOW POOL Col.1 ----3 2 1 Col. 2 ------UNKNOWN CIDG CIMSG = = = Col.3 Col. 4 ----- -----176 (29% 288 (48% 144 (24%) Total space used = 608 out of 608 total bytes, 0 bytes left Total space utilization = 100% Examples 1. SDA> SHOW POOL G0BADE00;260 Non-paged dynamic storage pool -----------------------------Dump of blocks allocated from non-paged pool CIMSG 80BADE00 . . . UNKNOWN 80BADE90 . . . CIDG 80BADED0 . . . UNKNOWN 80BADF60 . . . CIDG 80BADFA0 . . .
System Dump Analyzer SHOW POOL Summary of non-paged pool contents 3 UNKNOWN 2 CIDG 1 CIMSG = = = 176 (29%) 288 (48%) 144 (24%) Total space used = 608 out of 608 total bytes, 0 bytes left Total space utilization = 100% This example, which uses a range of values, examines 608 (26016 ) bytes of nonpaged pool, starting at address 80BADE0016 . SDA attempts to identify allocated blocks as it proceeds through the specified region of pool, and displays an allocation summary when it completes the listing. 2.
System Dump Analyzer SHOW POOL 3. SDA> SHOW POOL/PAGED/HEADER Paged dynamic storage pool -------------------------Dump of blocks allocated from paged pool RSHT 8024FE00 LNM 80250010 LNM 80250070 LNM 802500A0 LNM 80250100 528 802DC710 96 8015B847 48 8015B847 96 8015B847 48 8015B847 00380210 00000000 FFFFFF80 ..........8...-. 00400060 802D75A0 00000000 .....u-.‘.@.G... 01400030 802500A0 802D7400 .t-...%.0.@.G... 02400060 802DC170 80250070 p.%.p.-.‘.@.G... 00400030 802DC510 802E1B60 ‘.....-.0.@.G..
System Dump Analyzer SHOW POOL 5. SDA SHOW POOL/STATISTICS List head Address -------D80A9030 D80A9038 D80A9040 D80A9048 D80A9050 D80A9058 D80A9060 D80A9068 D80A9070 D80A9078 D80A9080 D80A9088 D80A9090 . . . D80A9290 D80A9298 D80A92A0 D80A92A8 List Size ----64 128 192 256 320 384 448 512 576 640 704 768 832 Alloc. Attempts ---------2077039 6323789 21085351 502388 1372168 32649 2463316 357170 293998 168145 83645 34852 21263 Alloc.
System Dump Analyzer SHOW POOL 33 1 224 153 3 118 1 1 225 4 1 2 1 41 2 1 7 1 UNKNOWN PQB GSD KFE MTL KFRH RSHT XWB LNM KFD KFPB CIA CHIP ORB ARB PTC OCB PGD = = = = = = = = = = = = = = = = = = 36480 2256 14240 10864 96 46736 528 18048 16720 224 16 29264 9216 5248 34912 3072 1344 208 (15%) (0%) (6%) (4%) (0%) (20%) (0%) (7%) (7%) (0%) (0%) (12%) (4%) (2%) (15%) (1%) (0%) (0%) Total space used = 229472 out of 524800 total bytes, 295328 bytes left Total space utilization = 43% This example of the SHOW POO
System Dump Analyzer SHOW PORTS SHOW PORTS Displays those portions of the port descriptor table (PDT) that are port independent. Format SHOW PORTS [/qualifier[,...]] Parameters None. Qualifiers /ADDRESS=pdt-address Displays the specified port descriptor table (PDT).10 /BUS[=bus-address] Displays BUS (LAN device) structure data. /CHANNEL[=channel-address] Displays channel (CH) data. /DEVICE Displays the network path description for a channel.
System Dump Analyzer SHOW PORTS • BUS data structure for each of the local LAN adapters • Some of the data structures used by both PEDRIVER and the LAN drivers The following symbols are defined automatically: Symbol Explanation or Example VC_nodename VC_NODE1, address of the local node’s virtual circuit to node NODE1 The preferred channel for the virtual circuit; for example, CH_NODE1, address of the local node’s preferred channel to node NODE1 BUS_ETA, address of the local node’s BUS structure assoc
System Dump Analyzer SHOW PORTS Examples 1. SDA> SHOW PORTS/ADDR=PE_PDT VAXcluster data structures ---------------------------- Port Descriptor Table (PDT) 806C37A0 --Type: 03 pe Characteristics: 0000 Msg Header Size Max Xfer Bcnt DG Header Size Poller Sweep Fork Block W.Q.
System Dump Analyzer SHOW PORTS 2.
System Dump Analyzer SHOW PORTS The SHOW PORTS/VC=VC_id command displays the virtual circuit data for the specified remote node and a channel summary. In this display, the upper center of the display contains the virtual circuit status. The lower right-hand corner contains the virtual circuit open and close times. The ReXmt field indicates a problem sending messages to the remote system. The error rate per hour should be less than the Pipe Quota field.
System Dump Analyzer SHOW PORTS VAXcluster data structures -------------------------: PEDRIVER Channel (CH:80704320) for Virtual Circuit (VC:806CD6E0) BREE -State: 0004 open Status: 0B path,open,rmt_hwa_valid BUS: 80B008B0 (XQA) Lcl Device: XQ_DELQA Lcl LAN Address: 08-00-2B-0A-6A-6B Rmt Name: XQB Rmt Device: XQ_DEQTA Rmt LAN Address: 08-00-2B-13-70-88 Rmt Seq #: 0002 Open:22-MAR-1993 18:14:07.01 Closed:17-NOV-1858 00:00:00.
System Dump Analyzer SHOW PORTS 8. SDA> SHOW PORTS/BUS/CHANNEL/DEVICE/MESSAGE/VC/ADDRESS=PE_PDT This command displays all of the bus structures, all of the virtual circuits and their message counters, and channels, including network path descriptions when available. 9.
System Dump Analyzer SHOW PROCESS SHOW PROCESS Displays the software and hardware context of any process in the balance set. Format SHOW PROCESS [/qualifier[,...]][ALL | process-name | /INDEX=nn | /SYSTEM] Parameters ALL Shows information about all processes that exist in the system. process-name Name of the process for which information is to be displayed.11 You can determine the names of the processes in the system by issuing a SHOW SUMMARY command.
System Dump Analyzer SHOW PROCESS /LOCKS Displays the lock management locks owned by the current process. The /LOCKS qualifier produces a display similar in format to that produced by the SHOW LOCKS command. See Table SDA–15 for additional information. /P0 Displays the page tables for P0 space. See the description of the /PAGE_TABLES qualifier. /P1 Displays the page tables for P1 space. See the description of the /PAGE_TABLES qualifier.
System Dump Analyzer SHOW PROCESS /RMS[=option[,...]] Displays certain specified RMS data structures for each image I/O or processpermanent I/O file the process has open. To display RMS data structures for process-permanent files, specify the PIO option to this qualifier.
System Dump Analyzer SHOW PROCESS • TID=tid Specifies the transaction for which information is to be displayed. If you omit the TID option, the SHOW PROCESS/TRANSACTIONS command displays information about all transactions for the process. If you omit these options, the SHOW PROCESS/TRANSACTIONS command displays all information about all transactions for the process.
System Dump Analyzer SHOW PROCESS The process header display, also produced by the /PHD qualifier, provides information taken from the process header (PHD), which is swapped into memory when the process becomes part of the balance set.
System Dump Analyzer SHOW PROCESS Column Contents STATUS Three columns that list the following status information: • Page type • Location of the page in physical memory • Indication of whether the page is locked into the working set When SDA locates one or more unused working set entries, it issues the following message: --- n empty entries In this message, n is the number (in decimal) of contiguous, unused entries.
System Dump Analyzer SHOW PROCESS Column Contents Channel Window Number of the channel Address of the window control block (WCB) for the file if the device is a file-oriented device; zero otherwise Status of the device: ‘‘Busy’’ if the device has an I/O operation outstanding; blank otherwise Name of the device and, if applicable, name of the file being accessed on that device Status Device/file accessed The information listed under the heading ‘‘Device/file accessed’’ varies from channel to channel and
System Dump Analyzer SHOW PROCESS Examples 1.
System Dump Analyzer SHOW PROCESS AP = 7FEF4AE4 KSP = 7FFE7E00 FP = 7FEF4AEC ESP = 7FFE9E00 PC = 801622B4 SSP = 7FFED04E PSL = 03C00000 USP = 7FEF4AE4 P0BR = 82D43600 P0LR = 000003EB P1BR = 82654E00 P1LR = 001FF792 R2 R6 R10 PC SSP R3 R7 R11 PSL USP Active registers for current process -----------------------------------R0 = 00000001 R1 = 80002398 R4 = 7FFA05A0 R5 = 00000000 R8 = 00001F60 R9 = 7FF9FB38 AP = 7FFE9D70 FP = 7FFE9D58 KSP = 7FFE7E00 ESP = 7FFE9D58 = = = = = 00000000 0007D400 7FF9FA08
System Dump Analyzer SHOW PROCESS . . Process active channels ----------------------Channel ------0010 0020 0030 0040 0050 0060 0070 0080 0090 00A0 00B0 00C0 Window Status Device/file accessed ----------- -------------------00000000 ROCK$DJA233: 8082C400 ROCK$DJA233:(1008,48490,0) 807F2260 LOVE$DUA200:(209,1,0)[V5COMMON.SYSLIB]SMGSHR.EXE;1 (section file) 00000000 VTA71: 00000000 VTA71: 807EFFE0 LOVE$DUA200:(195,1,0)[V5COMMON.SYSLIB]LIBRTL.EXE;1 (section file) 807EECC0 LOVE$DUA200:(199,1,0)[V5COMMON.
System Dump Analyzer SHOW PROCESS Display RMS structures for all IFI values. SDA> SHOW PROCESS/RMS . . .
System Dump Analyzer SHOW PROCESS The SHOW PROCESS/IMAGES command displays the address of the image control block, the start and end addresses of the image, the activation code, the protected and shareable flags, the image name, and the major and minor IDs of the image. 6. SDA> SHOW PROCESS/TRANSACTIONS=(DISPLAY=THREADS, TID=FAC21DE2-BA88-0092-8FA6-B24B) The SHOW PROCESS command displays the transaction thread information for the transaction whose identifier is FAC21DE2-BA88-0092-8FA6-B24B.
System Dump Analyzer SHOW RESOURCE SHOW RESOURCE Displays information about all resources in the system or about a resource associated with a specific lock. Format SHOW RESOURCE {/ALL | /LOCKID=lock-id | /NAME=resource-name} Parameters None. Qualifiers /ALL Displays information from all resource blocks (RSBs) in the system. This is the default behavior of the SHOW RESOURCE command. /LOCKID=lock-id Displays information about the resource associated with the lock with the specified lock-id.
System Dump Analyzer SHOW RESOURCE Table SDA–21 (Cont.) Resource Information in the SHOW RESOURCE Display Field Contents Group grant mode Indication of the most restrictive mode in which a lock on this resource has been granted.
System Dump Analyzer SHOW RESOURCE Table SDA–21 (Cont.) Resource Information in the SHOW RESOURCE Display Field Contents Resource Dump of the name of this resource, as stored at the end of the RSB. The first two columns are the hexadecimal representation of the name, with the least significant byte represented by the rightmost two digits in the rightmost column.
System Dump Analyzer SHOW RESOURCE Resource database ----------------Address of RSB: 807F6120 Group grant mode: NL Parent RSB: 806EA180 Conversion grant mode: NL Sub-RSB count: 0 BLKAST count: 0 Value block: 806CE510 00000000 00000002 00000002 Seq. #: 00000008 Resource: 09ED7324 42313146 F11B$sí. Length 10 00000000 00000200 ........ CSID: 00020041 Kernel mode 00000000 00000000 ........ System 00000000 00000000 ........
System Dump Analyzer SHOW RESOURCE Resource database ----------------Address of RSB: 806BB050 Group grant mode: NL Parent RSB: 00000000 Conversion grant mode: NL Sub-RSB count: 4 BLKAST count: 0 Value block: 00960102 0000330B 000735AA 5A020005 Seq. #: 00006D9F Resource: 45527624 42313146 F11B$vRE Length 18 20205241 4D323053 S02MAR CSID: 0002001A Kernel mode 00000000 00002020 ...... System 00000000 00000000 ........
System Dump Analyzer SHOW RMS SHOW RMS Displays the RMS data structures selected by the SET RMS command to be included in the default display of the SHOW PROCESS/RMS command. Format SHOW RMS Parameters None. Qualifiers None. Description The SHOW RMS command lists the names of the data structures selected for the default display of the SHOW PROCESS/RMS command.
System Dump Analyzer SHOW RSPID SHOW RSPID Displays information about response IDs (RSPIDs) of all SCS connections or, optionally, a specific SCS connection. Format SHOW RSPID [/CONNECTION=cdt-address] Parameters None. Qualifier /CONNECTION=cdt-address Displays RSPID information for the specific SCS connection whose connection descriptor table (CDT) address is provided in cdt-address.
System Dump Analyzer SHOW RSPID Examples 1. SDA> SHOW RSPID VAXcluster data structures ---------------------------- Summary of Response Descriptor Table(RDT) 8037A4A8 --RSPID ----04C30000 06260001 0C390002 . . .
System Dump Analyzer SHOW SPINLOCKS SHOW SPINLOCKS Displays information taken from the data structures that provide system synchronization in a multiprocessing environment. The default qualifiers are /STATIC and /DYNAMIC. Format SHOW SPINLOCKS [/OWNED][/BRIEF | /FULL][/DYNAMIC | /STATIC] [name | /ADDRESS=expression | /INDEX=expression] Parameter name Name of the spin lock, fork lock, or device lock structure to be displayed.
System Dump Analyzer SHOW SPINLOCKS /STATIC Displays information for all system spin locks and fork locks. Description The SHOW SPINLOCKS command displays status and diagnostic information about the multiprocessing synchronization structures known as spin locks. A static spin lock is a spin lock whose data structure is permanently assembled into the system.
System Dump Analyzer SHOW SPINLOCKS Table SDA–22 (Cont.
System Dump Analyzer SHOW SPINLOCKS Examples 1. SDA> SHOW SPINLOCKS System static spinlock structures --------------------------------EMB Owner CPU ID : None Ownership Depth : 0000 CPUs Waiting : 0000 Timeout interval 002DC60 MCHECK Owner CPU ID : None Ownership Depth : 0000 CPUs Waiting : 0000 Timeout interval 002DC60 . . . IOLOCK8 Owner CPU ID : 02 Ownership Depth : 0001 CPUs Waiting : 0000 Timeout interval 002DC60 . . .
System Dump Analyzer SHOW SPINLOCKS 2.
System Dump Analyzer SHOW SPINLOCKS 3. SDA> SHOW SPINLOCKS/OWNED System static spinlock structures --------------------------------IOLOCK8 Owner CPU ID : 02 Ownership Depth : 0001 CPUs Waiting : 0000 Timeout interval 002DC60 . . .
System Dump Analyzer SHOW SPINLOCKS 4. SDA> SHOW SPINLOCKS/FULL System static spinlock structures --------------------------------EMB Owner CPU ID : None Ownership Depth : 0000 CPUs Waiting : 0000 Timeout interval 002DC60 Address IPL Rank Index : : : : 801B9EF8 1F 00 20 Spinlock EMB was last acquired or released from: (Most recently) 80195146 ERL$WAKE+00089 . 801950EF ERL$WAKE+00032 . 80195146 ERL$WAKE+00089 . 801950EF ERL$WAKE+00032 . 80195146 ERL$WAKE+00089 . 801950EF ERL$WAKE+00032 .
System Dump Analyzer SHOW STACK SHOW STACK Displays the location and contents of the four process stacks of the SDA current process and the interrupt stack of the SDA current CPU. Format SHOW STACK [range | /qualifier[,...]] Parameters range Range of memory locations you want to display in stack format.
System Dump Analyzer SHOW STACK SDA provides the following information in each stack display. Section Contents Identity of stack SDA indicates whether the stack is a process stack (user, supervisor, executive, or kernel) or the processor interrupt stack. If the interrupt stack is being displayed, SDA displays the CPU ID of the processor that owns it.
System Dump Analyzer SHOW SUMMARY SHOW SUMMARY Displays a list of all active processes and the values of the parameters used in swapping and scheduling those processes. Format SHOW SUMMARY [/IMAGE] Parameters None. Qualifier /IMAGE Causes SDA to display, if possible, the name of the image being executed within each process. Description The SHOW SUMMARY command displays the information in Table SDA–23 for each active process in the system.
System Dump Analyzer SHOW SUMMARY Table SDA–23 (Cont.
System Dump Analyzer SHOW SUMMARY Table SDA–23 (Cont.
System Dump Analyzer SHOW SYMBOL SHOW SYMBOL Displays the hexadecimal value of a symbol and, if the value is equal to an address location, the contents of that location. Format SHOW SYMBOL [/ALL] symbol-name Parameter symbol-name Name of the symbol to be displayed. You must provide a symbol-name. Qualifier /ALL Displays information about all symbols whose names begin with the characters specified in symbol-name.
System Dump Analyzer SHOW TRANSACTIONS SHOW TRANSACTIONS Displays information about all transactions on the node or about a specified transaction. Format SHOW TRANSACTIONS [/qualifier[,...]] Qualifiers /DISPLAY=(item [,...]) Specifies the type of information to be displayed. The argument to /DISPLAY can be either a single item or a list. The following items can be specified. Item Description ALL All transaction control structures for the specified transaction. This is the default behavior.
System Dump Analyzer SPAWN SPAWN Creates a subprocess of the process currently running SDA, copying the context of the current process to the subprocess and, optionally, executing within the subprocess a specified command. Format SPAWN [/qualifier[,...]] [command] Parameter command Name of the command that you want executed by the subprocess. Qualifiers /INPUT=filespec Specifies an input file containing one or more command strings to be executed by the spawned subprocess.
System Dump Analyzer SPAWN /PROCESS=process-name Specifies the name of the subprocess to be created. The default name of the subprocess is username_n, where username is the user name of the parent process. Example SDA> SPAWN $ MAIL . . . $ DIR . . . $ LO Process SYSTEM_1 logged out at 5-MAR-1993 15:42:23.59 SDA> This example uses the SPAWN command to create a subprocess that issues DCL commands to invoke the Mail utility.
System Dump Analyzer VALIDATE QUEUE VALIDATE QUEUE Validates the integrity of the specified queue by checking the pointers in the queue. Format VALIDATE QUEUE [address] [/qualifier[,...]] Parameter address Address of an element in a queue. If you specify a period ( . ) as the address, SDA uses the last evaluated expression as the queue element’s address.
If there are no entries in the queue, SDA displays this message: The queue is empty Examples 1. SDA> VALIDATE QUEUE SCH$GQ_LEFWQ/MAXIMUM_LINKS=3 The queue is consistent through 3 elements This example validates three elements in the SCH$GQ_LEFWQ queue. 2. SDA> VALIDATE QUEUE/SELF_RELATIVE IOC$GL_IRPFL Queue is complete, total of 159 elements in the queue This example validates the self-relative queue that is the IRP pool list.
Index A Access violations, SDA–21, SDA–23 ACP (ancillary control process), SDA–104 Addition operator ( + ), SDA–16 Addresses, examining, SDA–53 /ADDRESS qualifier, SDA–90, SDA–103, SDA–142 /ALL qualifier, SDA–53, SDA–121, SDA–131, SDA–149, SDA–161, SDA–181 SHOW PAGE_TABLE command, SDA–126 SHOW STACK command, SDA–176 AMB symbol, SDA–17 ANALYZE/CRASH_DUMP/RELEASE command, SDA–5 ANALYZE/CRASH_DUMP command, SDA–9, SDA–35 ANALYZE/SYSTEM command, SDA–3, SDA–35 ANALYZE command, SDA–35 /CRASH_DUMP qualifier, SDA–37
/CONDITION_VALUE qualifier, SDA–51 Connection manager, displaying SDA information, SDA–85 /CONNECTION qualifier, SDA–167 Connections displaying SDA information about, SDA–142, SDA–167 Connections, displaying SDA information about, SDA–90 Context SDA CPU, SDA–14 SDA process, SDA–12 Control blocks, formatting, SDA–58 Control region, SDA–18 base register, SDA–18 examining, SDA–54 length register, SDA–18 page table, displaying, SDA–150 Control region operator (H), SDA–16 COPY command, SDA–5, SDA–6, SDA–46 CPU c
/EXECUTIVE qualifier, SDA–62, SDA–176 Executive stack pointer, SDA–18 EXIT command, SDA–57 Expressions, SDA–15, SDA–19 Expressions, evaluating, SDA–51 FABs (file access blocks), SDA–79 Fatal exceptions, SDA–20 FATALEXCPT bugcheck, SDA–21 FCBs (file control blocks), SDA–79 Floating-point emulation code, base address, SDA–18 FORMAT command, SDA–29, SDA–58, SDA–67 FPEMUL symbol, SDA–18 FP symbol, SDA–18 Frame pointers, SDA–18 Free page list, displaying, SDA–131 /FREE qualifier, SDA–131, SDA–135 FWAs (file wor
Lock manager, displaying SDA information, SDA–121 Lock mode, SDA–162 Locks, displaying SDA information, SDA–161 /LOCKS qualifier, SDA–150 Logical operators, SDA–16 AND ( & ), SDA–16 NOT ( # ), SDA–16 OR ( | ), SDA–16 XOR ( \ ), SDA–16 LOGICAL_NAMES.
PCB symbol, SDA–18 PCs (program counters), SDA–18 PCs (program counters), in a crash dump, SDA–19 PC symbol, SDA–18 PDTs (port descriptor tables), SDA–142 PDT symbol, SDA–18 PFN database, SDA–126 PFN database, displaying, SDA–131 PGFIPLHI bugcheck, SDA–23 /PHD qualifier, SDA–150 PHDs (process headers), SDA–180 PHDs (process headers), displaying, SDA–150 PHD symbol, SDA–18 PID numbers SDA uses to extract correct index, SDA–149 Pool lists displaying contents, SDA–135 statistics about, SDA–135 Port drivers, di
/RMS qualifier, SDA–151 RSBs (resource blocks), SDA–122, SDA–161 RSPID (response ID), displaying SDA information, SDA–167 RUBs (recovery unit blocks), SDA–80 RUFBs (recovery unit file blocks), SDA–80 RUSBs (recovery unit stream blocks), SDA–80 RWAITCNT symbol, SDA–18 S S0 region, examining, SDA–54 SAVEDUMP system parameter, SDA–5 SBR register, displaying, SDA–95 SBs (system blocks), SDA–86, SDA–104 SB symbol, SDA–18 SCBB register, displaying, SDA–95 Schedulers, global symbols, SDA–64 SCS (System Communicat
SHOW SYMBOL command, SDA–181 SHOW TRANSACTIONS command, SDA–182 Shutdown, operator-requested, SDA–7 SID register, displaying, SDA–95 Signal array, SDA–22 SISR register, displaying, SDA–95 Site-specific startup procedure See SYS$MANAGER:SYSTARTUP_VMS.
System management, creating a crash dump file, SDA–4 System map, SDA–20 System message routines, global symbols, SDA–64 System page file as dump file, SDA–5 releasing blocks containing a crash dump, SDA–38 System page tables See SPTs System processes, SDA–76 /SYSTEM qualifier, SDA–54, SDA–76, SDA–126, SDA–131, SDA–151 System region, examining, SDA–54 Systems analyzing running, SDA–3, SDA–11, SDA–35 investigating performance problems, SDA–11 System space base address, SDA–18 System space operator (G), SDA–16