![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
The SHOW STACK command displays a system stack. The data shown above the stack pointer may not be valid. Note that the mechanism array, signal array, and exception frame symbols displayed on the left will appear only for INVEXCEPTN, FATALEXCPT, UNXSIGNAL, and SSRVEXCEPT bugchecks.
Displays a list of all active processes and the values of the parameters used in swapping and scheduling these processes.
SHOW SUMMARY [/IMAGE|/THREAD]
None.
/IMAGE
Causes SDA to display, if possible, the name of the image being executed within each process./THREAD
Displays information on all the current threads associated with the current process.
The SHOW SUMMARY command displays the information in Table SDA-32 for each active process in the system.
Table SDA-32 Process Information in the SHOW SUMMARY Display Column Contents Extended PID The 32-bit number that uniquely identifies the process Indx Index of this process into the PCB array Process name Name assigned to the process Username Name of the user who created the process State Current state of the process. Table SDA-33 shows the 14 states and their meanings. Pri Current scheduling priority of the process PCB/KTB Address of the process control block or address of the kernel thread block PHD/FRED Address of the process header or address of the floating-point registers and execution data block Wkset Number (in decimal) of pages currently in the process working set
Table SDA-33 Current State Information State Meaning COM Computable and resident in memory. COMO Computable, but outswapped. CUR Currently executing. CEF Waiting for a common event flag. LEF Waiting for a local event flag. LEFO Outswapped and waiting for a local event flag. HIB Hibernating. HIBO Hibernating and outswapped. SUSP Suspended. SUSPO Suspended and outswapped. PFW Waiting for a page that is not in memory (page-fault wait). FPG Waiting to add a page to its working set (free-page wait). COLPG Waiting for a page collision to be resolved (collided-page wait); this usually occurs when several processes cause page faults on the same shared page. MWAIT Miscellaneous wait. RWxxx Waiting for system resource xxx.
SDA> SHOW SUMMARY Current process summary ----------------------- Extended Indx Process name Username State Pri PCB/KTB PHD/FRED Wkset -- PID -- ---- --------------- ----------- ------- --- -------- -------- ------ 00000041 0001 SWAPPER HIB 16 80C641D0 80C63E00 0 00000045 0005 IPCACP SYSTEM HIB 10 80DC0780 81266000 39 00000046 0006 ERRFMT SYSTEM HIB 8 80DC2240 8126C000 57 00000047 0007 OPCOM SYSTEM HIB 8 80DC3340 81272000 31 00000048 0008 AUDIT_SERVER AUDIT$SERVER HIB 10 80D61280 81278000 152 00000049 0009 JOB_CONTROL SYSTEM HIB 10 80D620C0 8127E000 50 0000004A 000A SECURITY_SERVER SYSTEM HIB 10 80DC58C0 81284000 253 0000004B 000B TP_SERVER SYSTEM HIB 10 80DC8900 8128A000 75 0000004C 000C NETACP DECNET HIB 10 80DBFE00 8125A000 78 0000004D 000D EVL DECNET HIB 6 80DCA080 81290000 76 0000004E 000E REMACP SYSTEM HIB 8 80DE4E00 81296000 14 00000050 0010 DECW$SERVER_0 SYSTEM HIB 8 80DEF940 812A2000 739 00000051 0011 DECW$LOGINOUT <login> LEF 4 80DF0F00 812A8000 273 00000052 0012 SYSTEM SYSTEM LEF 9 80D772C0 81260000 75
The SHOW SUMMARY command describes all active processes in the system at the time of the system failure. Note that there was no process in the in the CUR state at the time of the failure.
Displays the hexadecimal value of a symbol and, if the value is equal to an address location, the contents of that location.
SHOW SYMBOL [/ALL] symbol-name
symbol-name
Name of the symbol to be displayed. You must provide a symbol-name.
/ALL
Displays information on all symbols whose names begin with the characters specified in symbol-name.
The SHOW SYMBOL/ALL command is useful for determining the values of symbols that belong to a symbol set, as illustrated in the following examples.
#1
SDA> SHOW SYMBOL G G = FFFFFFFF.80000000 : 6BFA8001.201F0104
#2The SHOW SYMBOL command evaluates the symbol G as 8000000016 and displays the contents of address 8000000016 as 201F010416.
SDA> SHOW SYMBOL/ALL BUG Symbols sorted by name ---------------------- BUG$L_BUGCHK_FLAGS = FFFFFFFF.804031E8 : 00000000.00000001 BUG$L_FATAL_SPSAV = FFFFFFFF.804031F0 : 00000000.00000001 BUG$REBOOT = FFFFFFFF.8042E320 : 00000000.00001808 BUG$REBOOT_C = FFFFFFFF.8004f4D0 : 47FB041D.47FD0600 . . . Symbols sorted by value ---------------------- BUG$REBOOT_C = FFFFFFFF.8004f4D0 :47FB041D.47FD0600 BUG$L_BUGCHK_FLAGS = FFFFFFFF.804031E8 :00000000.00000001 BUG$L_FATAL_SPSAV = FFFFFFFF.804031F0 :00000000.00000001 BUG$REBOOT = FFFFFFFF.8042E320 :00000000.00001808 . . .
This example shows the display produced by the SHOW SYMBOL/ALL command. SDA searches its symbol table for all symbols that begin with the string "BUG" and displays the symbols and their values. Although certain values equate to memory addresses, it is doubtful that the contents of those addresses are actually relevant to the symbol definitions in this instance.
Displays the system working set list and retains the current process context.
SHOW WORKING_SET_LIST [={GPT|SYSTEM|LOCKED|n }]
None.
None.
The SHOW WORKING_SET_LIST command displays the contents of requested entries in the system working set list. If no option is given, all working set list entries are displayed. Table SDA-34 shows the options available with SHOW WORKING_SET_LIST. The SHOW WORKING_SET_LIST command is equivalent to the SHOW PROCESS/SYSTEM/WORKING_SET_LIST command. See the SHOW PROCESS command and Table SDA-25 for more information.
Table SDA-34 Options for the SHOW WORKING_SET_LIST Command Options Results GPT Displays only working set list entries that are for global page table pages. SYSTEM Displays only working set list entries for pageable system pages. LOCKED Displays only working set list entries for pageable system pages that are locked in the system working set. n Displays a specific working set entry, where n is the working set list index (WSLX) of the entry of interest.
Creates a subprocess of the process currently running SDA, copying the context of the current process to the subprocess and, optionally, executing a specified command within the subprocess.
SPAWN [/qualifier[,...]] [command]
command
Name of the command that you want the subprocess to execute.
/INPUT=filespec
Specifies an input file containing one or more command strings to be executed by the spawned subprocess. If you specify a command string with an input file, the command string is processed before the commands in the input file. Once processing is complete, the subprocess is terminated./NOLOGICAL_NAMES
Specifies that the logical names of the parent process are not to be copied to the subprocess. The default behavior is that the logical names of the parent process are copied to the subprocess./NOSYMBOLS
Specifies that the DCL global and local symbols of the parent process are not to be passed to the subprocess. The default behavior is that these symbols are passed to the subprocess./NOTIFY
Specifies that a message is to be broadcast to SYS$OUTPUT when the subprocess completes processing or aborts. The default behavior is that such a message is not sent to SYS$OUTPUT./NOWAIT
Specifies that the system is not to wait until the subprocess is completed before allowing more commands to be specified. This qualifier allows you to specify new commands while the spawned subprocess is running. If you specify /NOWAIT, use /OUTPUT to direct the output of the subprocess to a file to prevent more than one process from simultaneously using your terminal.The default behavior is that the system waits until the subprocess is completed before allowing more commands to be specified.
/OUTPUT=filespec
Specifies an output file to which the results of the SPAWN operation are written. To prevent output from the spawned subprocess from being displayed while you are specifying new commands, specify an output other than SYS$OUTPUT whenever you specify /NOWAIT. If you omit the /OUTPUT qualifier, output is written to the current SYS$OUTPUT device./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. The variable n represents the subprocess number.
SDA> SPAWN $ MAIL . . . $ DIR . . . $ LO Process SYSTEM_1 logged out at 5-JAN-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. The subprocess then lists the contents of a directory before logging out to return to the parent process executing SDA.
Validates that the page counts on lists are correct.
VALIDATE PFN_LIST {/ALL (d)|[/BAD|/FREE|/MODIFIED|/ZERO]}
None
/ALL
Validates all the PFN lists: bad, free, modified, and zero./BAD
Validates the bad page list./FREE
Validates the free page list./MODIFIED
Validates the modified page list./ZERO
Validates the zero page list.
The VALIDATES PFN_LIST command validates the specified PFN list(s) bit counting the number of entries in the list and comparing that to the running count of entries for each list maintained by the system.
#1
SDA> VALIDATES PFN_LIST/ALL
Free list: expected 445 pages, found 0 pages
excluding zeroded free list with expected size 116 pages
Zeroed free list validated: 116 pages
Modified list validated: 311 pages
Bad page list validated: 0 pages
#2
SDA>VALIDATES PFN_LIST/FREE
Free list: expected 445 pages, found 0 pages
excluding zeroed free list with expected size 116 pages
Validates the integrity of the specified queue by checking the pointers in the queue.
VALIDATE QUEUE [address]
[/LIST|/QUADWORD|/SELF_RELATIVE|/SINGLY_LINKED]
address
Address of an element in a queue.If you specify the period (.) as the address, SDA uses the last evaluated expression as the queue element's address.
If you do not specify an address, the VALIDATE QUEUE command determines the address from the last issued VALIDATE QUEUE command in the current SDA session.
If you do not specify an address, and no queue has previously been specified, SDA displays the following error message:
%SDA-E-NOQUEUE, no queue has been specified for validation
/LIST
Displays address of each element in the queue./QUADWORD
Allows the validate operation to occur on queues with linked lists of quadword addresses./SELF_RELATIVE
Specifies that the selected queue is a self-relative queue. Other processes cannot insert or remove queue entries while the current process is doing so./SINGLY_LINKED
Allows validation of queues that have no backward pointers.
The VALIDATE QUEUE command uses the forward, and optionally, backward pointers in each element of the queue to make sure that all such pointers are valid and that the integrity of the queue is intact. If the queue is intact, SDA displays the following message:Queue is complete, total of n elements in the queueIn these messages, n represents the number of entries the VALIDATE QUEUE command has found in the queue.If SDA discovers an error in the queue, it displays one of the following error messages:
Error in forward queue linkage at address nnnnnnnn after tracing x elements Error comparing backward link to previous structure address (nnnnnnnn) Error occurred in queue element at address oooooooo after tracing pppp elementsThese messages can appear frequently when the VALIDATE QUEUE command is used within an SDA session that is analyzing a running system. In a running system, the composition of a queue can change while the command is tracing its links, thus producing an error message.
If there are no entries in the queue, SDA displays this message:
The queue is empty
#1
SDA> VALIDATE QUEUE/SELF_RELATIVE IOC$GQ_POSTIQ Queue is complete, total of 159 elements in the queue
#2This example validates the self-relative queue IOC$GQ_POSTIQ. The validation is successful and determines that there are 159 IRPs in the list.
SDA> validate queue/quad FFFFFFFF80D0E6CO/list
Entry Address Flink Blink
----- ------- ------ -----
Header FFFFFFFF80D0E6CO FFFFFFFF80D03780 FFFFFFFF80D0E800
1. FFFFFFFF80D0E790 FFFFFFFF80D0E7CO FFFFFFFF80D0E6C0
2. FFFFFFFF80D0E800 FFFFFFFF80D0E6C0 FFFFFFFF80D0E7C0
Queue is complete, total of 3 elements in the queue
#3This example shows the validation of quadword elements in a list.
SDA> validate queue/sing exe$gl_nonpaged+4 Queue is zero-terminated, total of 95 elements in the queue
This example shows the validation of singly linked elements in the queue. The forward link of the final element is zero instead of being a pointer back to the queue header.
All CLUE commands can be used when analyzing crash dumps; the only CLUE commands that are not allowed when analyzing a running system are CLUE CRASH, CLUE ERRLOG, CLUE HISTORY, and CLUE STACK.
When rebooting after a system failure, CLUE commands by default automatically analyze and save summary information from the crash dump file in CLUE history and listing files. This information includes the following:
For additional information on the contents of the CLUE listing file, see the reference section on CLUE HISTORY.
The following SDA CLUE extension commands are described in this section:
Performs housekeeping operations to conserve disk space.
CLUE CLEANUP
None.
None.
CLUE CLEANUP performs housekeeping operations to conserve disk space. To avoid filling up the system disk with listing files generated by CLUE, CLUE CLEANUP is run during system startup to check the overall disk space used by all CLUE$*.LIS files.If the CLUE$COLLECT:CLUE$*.LIS files occupy more space than the logical CLUE$MAX_BLOCKS allows, then the oldest files are deleted until the threshold is reached. If this logical name is not defined, a default value of 5,000 disk blocks is assumed. A value of zero disables housekeeping and no check on the disk space is performed.
SDA> CLUE CLEANUP %CLUE-I-CLEANUP, housekeeping started... %CLUE-I-MAXBLOCK, maximum blocks allowed 5000 blocks %CLUE-I-STAT, total of 4 CLUE files, 192 blocks. %CLUE-I-DEL, deleting DISK$X6AF_G5N:[SYSCOMMON.SYSERR]CLUE$_010193_0000.LIS;1 (78 blocks)
In this example, the CLUE CLEANUP command displays that the total number of blocks of disk space used by CLUE files does not exceed the maximum number of blocks allowed. No files are deleted.
Displays the system, memory, and device configurations.
CLUE CONFIG
None.
None.
CLUE CONFIG displays the system, memory, and device configurations.
SDA> CLUE CONFIG
System Configuration:
---------------------
System Information:
System Type ALPHAbook 1 Primary CPU ID 00
Cycle Time 8.6 nsec (115 MHz) Pagesize 8192 Byte
Memory Configuration:
Cluster PFN Start PFN Count Range (MByte) Usage
#03 0 256 0.0 MB - 2.0 MB Console
#04 256 7935 2.0 MB - 63.9 MB System
#05 8191 1 63.9 MB - 64.0 MB Console
Per-CPU Slot Processor Information:
CPU ID 00 CPU State rc,pa,pp,cv,pv,pmv,pl
CPU Type LCA Pass 2 (21066) Halt PC 00000000.20000000
PAL Code 5.56 Halt PS 00000000.00001F00
CPU Revision .... Halt Code 00000000.00000000
Serial Number .......... "Bootstrap or Powerfail"
Console Vers V4.6-29
Adapter Configuration:
----------------------
TR Adapter ADP Hose Bus BusArrayEntry Node Device Name / HW-Id
-- ----------- -------- ---- -------------------- ---- -------------------------
1 KA1504 80D6F680 0 BUSLESS_SYSTEM
2 PCI 80D6F880 0 PCI
80D6FBE8 PKA: 6 NCR 53C810 SCSI
80D6FC20 7 SATURN
80D6FC58 8 PCMCIA_PD6729
3 ISA 80D6FE80 0 ISA
80D70098 0 EISA_SYSTEM_BOARD
80D700D0 AUA: 1 PCXBJ
80D70108 GQA: 2 AlphaBOOK-1 LCD (WD90C24A)
80D70140 HEA: 3 H8 AlphaBook-I uProc
4 XBUS 80D70440 0 XBUS
80D70618 0 MOUS
80D70650 1 KBD
80D70688 TTA: 2 NS16450 Serial Port
80D706C0 LRA: 3 Line Printer (parallel port)
80D706F8 DVA: 4 Floppy
5 PCMCIA 80D71040 0 PCMCIA
80D71218 EOA: 0 3Com Etherlink III
Displays a crash dump summary.
CLUE CRASH
None.
None.
CLUE CRASH displays a crash dump summary, which includes the following items:
- Bugcheck type
- Current process and image
- Failing PC and PS
- Executive image section name and offset
- General registers
- Failing instructions
- Exception frame, signal and mechanism arrays (if available)
SDA> CLUE CRASH Crash Time: 30-AUG-1996 13:13:46.83 Bugcheck Type: SSRVEXCEPT, Unexpected system service exception Node: SWPCTX (Standalone) CPU Type: DEC 3000 Model 400 VMS Version: X6AF-FT2 Current Process: SYSTEM Current Image: $31$DKB0:[SYS0.][SYSMGR]X.EXE;1 Failing PC: 00000000.00030078 SYS$K_VERSION_01+00078 Failing PS: 00000000.00000003 Module: X Offset: 00030078 Boot Time: 30-AUG-1996 09:06:22.00 System Uptime: 0 04:07:24.83 Crash/Primary CPU: 00/00 System/CPU Type: 0402 Saved Processes: 18 Pagesize: 8 KByte (8192 bytes) Physical Memory: 64 MByte (8192 PFNs, contiguous memory) Dumpfile Pagelets: 98861 blocks Dump Flags: olddump,writecomp,errlogcomp,dump_style Dump Type: raw,selective EXE$GL_FLAGS: poolpging,init,bugdump Paging Files: 1 Pagefile and 1 Swapfile installed Stack Pointers: KSP = 00000000.7FFA1C98 ESP = 00000000.7FFA6000 SSP = 00000000.7FFAC100 USP = 00000000.7AFFBAD0 General Registers: R0 = 00000000.00000000 R1 = 00000000.7FFA1EB8 R2 = FFFFFFFF.80D0E6C0 R3 = FFFFFFFF.80C63460 R4 = FFFFFFFF.80D12740 R5 = 00000000.000000C8 R6 = 00000000.00030038 R7 = 00000000.7FFA1FC0 R8 = 00000000.7FFAC208 R9 = 00000000.7FFAC410 R10 = 00000000.7FFAD238 R11 = 00000000.7FFCE3E0 R12 = 00000000.00000000 R13 = FFFFFFFF.80C6EB60 R14 = 00000000.00000000 R15 = 00000000.009A79FD R16 = 00000000.000003C4 R17 = 00000000.7FFA1D40 R18 = FFFFFFFF.80C05C38 R19 = 00000000.00000000 R20 = 00000000.7FFA1F50 R21 = 00000000.00000000 R22 = 00000000.00000001 R23 = 00000000.7FFF03C8 R24 = 00000000.7FFF0040 AI = 00000000.00000003 RA = FFFFFFFF.82A21080 PV = FFFFFFFF.829CF010 R28 = FFFFFFFF.8004B6DC FP = 00000000.7FFA1CA0 PC = FFFFFFFF.82A210B4 PS = 18000000.00000000 Exception Frame: R2 = 00000000.00000003 R3 = FFFFFFFF.80C63460 R4 = FFFFFFFF.80D12740 R5 = 00000000.000000C8 R6 = 00000000.00030038 R7 = 00000000.7FFA1FC0 PC = 00000000.00030078 PS = 00000000.00000003 Signal Array: 64-bit Signal Array: Arg Count = 00000005 Arg Count = 00000005 Condition = 0000000C Condition = 00000000.0000000C Argument #2 = 00010000 Argument #2 = 00000000.00010000 Argument #3 = 00000000 Argument #3 = 00000000.00000000 Argument #4 = 00030078 Argument #4 = 00000000.00030078 Argument #5 = 00000003 Argument #5 = 00000000.00000003 Mechanism Array: Arguments = 0000002C Establisher FP = 00000000.7AFFBAD0 Flags = 00000000 Exception FP = 00000000.7FFA1F00 Depth = FFFFFFFD Signal Array = 00000000.7FFA1EB8 Handler Data = 00000000.00000000 Signal64 Array = 00000000.7FFA1ED0 R0 = 00000000.00020000 R1 = 00000000.00000000 R16 = 00000000.00020004 R17 = 00000000.00010050 R18 = FFFFFFFF.FFFFFFFF R19 = 00000000.00000000 R20 = 00000000.7FFA1F50 R21 = 00000000.00000000 R22 = 00000000.00010050 R23 = 00000000.00000000 R24 = 00000000.00010051 R25 = 00000000.00000000 R26 = FFFFFFFF.8010ACA4 R27 = 00000000.00010050 R28 = 00000000.00000000 System Registers: Page Table Base Register (PTBR) 00000000.00001136 Processor Base Register (PRBR) FFFFFFFF.80D0E000 Privileged Context Block Base (PCBB) 00000000.003FE080 System Control Block Base (SCBB) 00000000.000001DC Software Interrupt Summary Register (SISR) 00000000.00000000 Address Space Number (ASN) 00000000.0000002F AST Summary / AST Enable (ASTSR_ASTEN) 00000000.0000000F Floating-Point Enable (FEN) 00000000.00000000 Interrupt Priority Level (IPL) 00000000.00000000 Machine Check Error Summary (MCES) 00000000.00000000 Virtual Page Table Base Register (VPTB) FFFFFFFC.00000000 Failing Instruction: SYS$K_VERSION_01+00078: LDL R28,(R28) Instruction Stream (last 20 instructions): SYS$K_VERSION_01+00028: LDQ R16,#X0030(R13) SYS$K_VERSION_01+0002C: LDQ R27,#X0048(R13) SYS$K_VERSION_01+00030: LDA R17,(R28) SYS$K_VERSION_01+00034: JSR R26,(R26) SYS$K_VERSION_01+00038: LDQ R26,#X0038(R13) SYS$K_VERSION_01+0003C: BIS R31,SP,SP SYS$K_VERSION_01+00040: BIS R31,R26,R0 SYS$K_VERSION_01+00044: BIS R31,FP,SP SYS$K_VERSION_01+00048: LDQ R28,#X0008(SP) SYS$K_VERSION_01+0004C: LDQ R13,#X0010(SP) SYS$K_VERSION_01+00050: LDQ FP,#X0018(SP) SYS$K_VERSION_01+00054: LDA SP,#X0020(SP) SYS$K_VERSION_01+00058: RET R31,(R28) SYS$K_VERSION_01+0005C: BIS R31,R31,R31 SYS$K_VERSION_01+00060: LDA SP,#XFFE0(SP) SYS$K_VERSION_01+00064: STQ FP,#X0018(SP) SYS$K_VERSION_01+00068: STQ R27,(SP) SYS$K_VERSION_01+0006C: BIS R31,SP,FP SYS$K_VERSION_01+00070: STQ R26,#X0010(SP) SYS$K_VERSION_01+00074: LDA R28,(R31) SYS$K_VERSION_01+00078: LDL R28,(R28) SYS$K_VERSION_01+0007C: BEQ R28,#X000007 SYS$K_VERSION_01+00080: LDQ R26,#XFFE8(R27) SYS$K_VERSION_01+00084: BIS R31,R26,R0 SYS$K_VERSION_01+00088: BIS R31,FP,SP
Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
6135P014.HTM OSSG Documentation 22-NOV-1996 14:12:06.96Copyright © Digital Equipment Corporation 1996. All Rights Reserved.