System Dump Analyzer SHOW — VMS 5.2
Prints formatted data structures, other contents of memory, or
RMS display options. The following commands are available:
SHOW CALL_FRAME
SHOW CLUSTER
SHOW CONNECTIONS
SHOW CPU
SHOW CRASH
SHOW DEVICE
SHOW EXECUTIVE
SHOW HEADER
SHOW LOCK
SHOW PAGE_TABLE
SHOW PFN_DATA
SHOW POOL
SHOW PORTS
SHOW PROCESS
SHOW RESOURCES
SHOW RMS
SHOW RSPID
SHOW SPINLOCKS
SHOW STACK
SHOW SUMMARY
SHOW SYMBOL
Additional information available:
CALL_FRAMECLUSTERCONNECTIONSCPUCRASH
DEVICEEXECUTIVEHEADERLOCKPAGE_TABLE
PFN_DATAPOOLPORTSPROCESSRESOURCESRSPID
RMSSPINLOCKSSTACKSUMMARYSYMBOL
CALL_FRAME
SHOW CALL_FRAME [starting_address]
[/NEXT_FP]
Displays the locations and contents of the longwords
representing a CALLG or CALLS procedure call frame.
The starting address of the call frame is determined from the
specified starting_address, the NEXT_FP option, or by default.
The default starting address is the longword contained in the
SDA current process FP register.
Additional information available:
/NEXT_FP
Used to follow a chain of successive procedure call frames.
Displays the next call frame by using the contents of the
"Saved FP" from the previous displayed call frame as the
starting address of the next call frame.
CLUSTER
SHOW CLUSTER [/CSID=n] [/SCS]
Displays a view of the Vaxcluster, or the SCS cluster (with the
SCS qualifier). The VAXcluster is composed of VAXprocessor nodes
actively participating in the management of shared resources.
The SCS cluster (System Communication Services) is composed of
all nodes participating in the Systems Communication Architecture
(SCA) Protocol. Generally, this is all nodes connected to a SCA
bus, for example the CI.
Additional information available:
/CSID=n
Displays cluster information on a particular VAXcluster member
node which is specified by its cluster system id.
/SCS
Displays a view of the cluster as seen by the system
communications services (SCS).
CONNECTIONS
SHOW CONNECTIONS [/ADDRESS=n]
Displays all active connection descriptor tables (CDTs). A CDT
describes the connection between two SCS processes.
Additional information available:
/ADDRESS=n
Displays a connection descriptor table (CDT)
specified by its address.
CPU
SHOW CPU [cpu_id]
Displays information about the state of a CPU at the time of the
system failure. The CPU is specified by its hexadecimal CPU ID
number (a value between 00 and 1F), or by default. The default CPU
is the "SDA current CPU". The information displayed includes the
reason for the BUGCHECK exception, the currently executing process,
the current IPL, the contents of all the CPU registers, and any
spinlocks that the CPU owns.
SHOW CPU performs an implicit SET CPU command. The "SDA current
CPU" will change to the CPU displayed by the SHOW CPU command.
The implicit SET CPU command also changes SDA process context.
The "SDA current process" will change to the current process on the
new "SDA current CPU". If there is no current process on the new
"SDA current CPU", then the "SDA current process" will be undefined,
and no process context information will be available until SDA process
context is set to a specific process. Type HELP PROCESS_CONTEXT
for specific information about the "SDA current process". Type
HELP CPU_CONTEXT for specific information about the "SDA current CPU".
Note: SHOW CPU is only valid when analyzing a crash dump. It is not
a valid command when analyzing the running system, because
all the CPU-specific information may not be available.
CRASH
SHOW CRASH
Displays information about the state of the system at the time of
the system failure. This information includes the time of the system
failure, the version of the operating system that was running, the
CPUs that were active and available in the system, a summary of the
BUGCHECK exception messages for all CPUs in the system, and
CPU-specific information about each active CPU in the system.
The CPU-specific information includes the reason for the BUGCHECK
exception, the currently executing process, the current IPL, the
contents of all the CPU registers, and any spinlocks that the CPU owns.
SHOW CRASH performs an implicit SET CPU command. The new "SDA current
CPU" is the CPU that induced the system failure. The implicit SET CPU
command also changes SDA process context. The new "SDA current process"
is the process that was currently executing on the CPU that induced the
system failure. If there was no process currently executing on the
CPU that induced the system failure, then the "SDA current process" is
undefined, and no process context information will be available until
SDA process context is set to a specific process.
Type HELP PROCESS_CONTEXT for specific information about the
"SDA current process". Type HELP CPU_CONTEXT for specific
information about the "SDA current CPU".
Note: SHOW CRASH shows only the system-wide information when
analyzing the running system, because all the CPU-specific
information may not be available.
DEVICE
SHOW DEVICE [name] [/ADDRESS=n]
Displays the I/O data structures associated with a device.
The device name can be a generic name (DB for example), which shows
all I/O structures associated with that device type; it can be a
specific name (DBA1 for example), which shows all I/O structures
associated with that particular device; or it can be omitted, which
shows all the I/O structures for all devices in the system.
Additional information available:
/ADDRESS=n
Displays the I/O data structures associated with the device
which is specified by its unit control block (UCB) address.
EXECUTIVE
SHOW EXECUTIVE
Displays the executive loaded images, their starting and ending
virtual addresses, and their sizes.
HEADER
SHOW HEADER
Displays the header of the dump file.
LOCK
SHOW LOCK [lockid] [/ALL]
Displays lock data structures. Specify the lockid to display
the lock identified by particular lockid.
Additional information available:
/ALL
Displays all the lock data structures in the system.
PAGE_TABLE
SHOW PAGE_TABLE [range] [/qualifier]
Displays the contents of the system page table and the global page
table. You can display a range of page table entries or the entire
system page table.
The range is a range of virtual addresses for which SDA is to display
page table entries. You can specify a range as two addresses separ-
ated by a colon (:), or as an address and a length, in bytes, separ-
ated by a semicolon (;).
Additional information available:
/ALL
Lists both the global and system page tables. This is the
default qualifier.
/GLOBAL
Lists the global page table.
/SYSTEM
Lists the system page table.
PFN_DATA
SHOW PFN_DATA [pfn] [/qualifier...]
Displays a listing of the free, modified, and bad page
lists as well as the entire PFN database.
If the pfn is specified, SDA displays the information
associated with that page frame number.
Additional information available:
/ALL
Displays the free page list, modified page list, and bad page list as
as well as the entire PFN database. This qualifier is the default.
/BAD
Displays the bad page list.
/FREE
Displays the free page list.
/MODIFIED
Displays the modified page list.
/SYSTEM
Displays the PFN database. The information is ordered by
page frame number, starting at PFN zero.
POOL
SHOW POOL [range]
[/qualifier...]
Displays the contents of the lookaside (SRP, IRP, and LRP)
pools, the nonpaged dynamic storage pool, and the paged dynamic storage
pool. You can display part or all of each pool. If no range or
qualifiers are specified, the default is SHOW POOL/ALL.
The range is a range of virtual addresses within a pool that you want
to display. You can specify a range as two addresses separated by a
colon (:), or as an address and a length, in bytes, separated by a
semicolon (;).
Additional information available:
/IRP/NONPAGED/PAGED/ALL/FREE/HEADER
/LRP/SRP/SUMMARY/TYPE
/IRP
Displays the contents of the IRP lookaside list.
/NONPAGED
Displays all the contents of nonpaged pool except the IRP list.
/PAGED
Displays the contents of paged pool.
/ALL
Displays the contents of all of memory; this is the default.
/FREE
Displays the lookaside,paged, and nonpaged pools and shows
the blocks that are currently available to the system.
/HEADER
Displays only the first 16 longwords of each block within pool.
/LRP
Displays the pool of long I/O request packets. Formats all
blocks currently allocated (in use) within this pool.
/SRP
Displays the pool of short I/O request packets. Formats all
blocks currently allocated (in use) within this pool.
/SUMMARY
Displays a summary of the pools or portions of pool specified by
the above qualifiers. This qualifier shows the different types of
blocks present, lists the total number of each, and shows,
in decimal, the number of bytes in each block.
/TYPE=block-type
Displays the blocks within pool that are of the specified type.
PORTS
SHOW PORTS [/ADDRESS=n][/NODE=name]
Displays the port independent portion of the port descriptor table
(PDT), particularly the list of system communication services
(SCS) entry addresses.
Additional information available:
/ADDRESS=n
Displays the port descriptor table (PDT) specified by the address.
For PE ports the Port block and Virtual Circuit Blocks are also
shown.
/NODE=name
Requires /ADDRESS qualifier. Shows only the Virtual Circuit Block
associated with the specifed node.
PROCESS
SHOW PROCESS [name] [/qualifier...]
Displays the software and hardware context of any process in the
balance set, and performs an implicit SET PROCESS command. If the
process specified is current on some CPU, SDA also performs an
implicit SET CPU command. Type HELP PROCESS_CONTEXT for specific
information about the "SDA current process". Type HELP CPU_CONTEXT
for specific information about the "SDA current CPU".
If no options are given, the PCB of the "SDA current process" is printed
by default. If the process name is specified as "ALL", then information
is shown for all processes that exist in the system.
The process name must be a quoted string if it contains characters other
than capital letters, numbers, dollar signs ($), or underscores (_).
The maximum size of the process name is 15 characters.
Additional information available:
/ALL/CHANNEL/INDEX/LOCK/PAGE_TABLES/PCB
/PHD/PROCESS_SECTION_TABLE/REGISTERS/RMS
/SYSTEM/WORKING_SET_LIST
/ALL
This qualifier selects all other qualifiers available with this
command. Thus, the maximum amount of information for the specified
process or processes is displayed.
/CHANNEL
Displays the I/O channels assigned to the process, the address of the
window control block associated with that channel, and the specifica-
tion of the file or device associated with the channel.
/INDEX=n
Displays the software and hardware context of the process which is
specified by the index of the software PCB into the system's PCB
vector. Alternately, this value could be the process identifica-
tion ( PID or EPID ), from which SDA extracts the correct index.
/LOCK
Displays the locks owned by the current process.
/PAGE_TABLES [range]
Displays the page tables of the program and control regions. The
range is a range of virtual addresses within a pool that you want
to display. You can specify a range as two addresses separated by
a colon (:), or as an address and a length, in bytes, separated by
a semicolon (;).
An accepted abbreviation is /PPT.
/PCB
Produces a list of the data contained in the software
process control block (PCB). The CPU ID is displayed
as part of the process state if the process is current
on some CPU (e.g. CUR 03 for the current process on CPU 03).
This qualifier is the default.
/PHD
Lists information included in the process header.
/PROCESS_SECTION_TABLE
Lists the information contained in the process section table.
An accepted abbreviation is /PST.
/REGISTERS
Lists the saved hardware context of the process. If the process is
the current process at the time of the system failure, the active
registers are also displayed.
/RMS[=option-spec]
Displays the RMS control blocks specified by the option-spec or by the
last SET RMS command. If the option-spec is specified, it is valid for
only that command and has no effect on the options selected by the
last SET RMS command. See the SET RMS command for the format of the
option-spec. The default option-spec is to display all RMS structures.
/SYSTEM
Displays the system process control block (PCB).
/WORKING_SET_LIST
Displays the working set list for the process.
An accepted abbreviation is /WSL.
RESOURCES
SHOW RESOURCES [/qualifier]
Displays resource data structures.
Additional information available:
/ALL
Displays all resources in the system.
This qualifier is the default.
/LOCKID=n
Displays the resource data associated with the lock whose lockid
is n.
RSPID
SHOW RSPID [/CONNECTION=n]
Displays all entries in the response-id descriptor table which are
in use. The VMS System Communication Services (SCS) provide response-
ids (RSPIDs) as a mechanism for matching request completion mes-
sages to the original requests. Generally, the original request
is represented by a class driver request packet (CDRP).
Additional information available:
/CONNECTION=n
Displays all entries in the response-id descriptor table which
are associated with this connection descriptor table (CDT).
RMS
SHOW RMS
Displays the RMS display options currently selected by the SET RMS
command (only applies to the SHOW PROCESS/RMS command).
SPINLOCKS
SHOW SPINLOCKS [name] [/qualifier...]
Displays the multiprocessing synchronization data structures.
Specify a name to display a particular synchronization structure.
Additional information available:
/ADDRESS/BRIEF/DYNAMIC/FULL/INDEX/OWNED/STATIC
/ADDRESS=n
Display only the lock structure at the specified address.
/BRIEF
Format the displayed spinlocks into a compacted form.
/DYNAMIC
Display only the dynamic system spinlocks. These spinlocks
coordinate multiprocessor activity throughout the I/O subsystems.
/FULL
Display additional information about the specified spinlocks
including the access histories.
/INDEX=n
Display only the system static spinlock of the specified index.
/OWNED
Display only those spinlocks which are owned.
/STATIC
Display only the system static spinlocks. These spinlocks
coordinate multiprocessor activity central to the processors.
STACK
SHOW STACK [range]
[/qualifier...]
Displays the location and contents of the four process stacks and
the interrupt stack of the "SDA current CPU".
You can express the range of memory locations you want to display as
two locations separated by a colon (:), or as a location and a length,
in bytes, separated by a semicolon (;).
If no options are specified, the current operating stack is displayed.
Additional information available:
/ALL/EXECUTIVE/INTERRUPT/KERNEL/SUPERVISOR
/USER
/ALL
Displays the location and contents of the four process stacks and
the interrupt stack for the "SDA current CPU".
/EXECUTIVE
Displays the executive mode stack for the current process.
/INTERRUPT
Displays the interrupt mode stack for the "SDA current CPU".
/KERNEL
Displays the kernel mode stack for the current process.
/SUPERVISOR
Displays the supervisor mode stack for the current process.
/USER
Displays the user mode stack for the current process.
SUMMARY
SHOW SUMMARY [/IMAGE]
Displays a list of all processes in the system at the time of
the system crash. The CPU ID is displayed as part of the process
state for processes that are current on some CPU (e.g. CUR 03
for the current process on CPU 03).
Additional information available:
/IMAGE
Displays the name of the image being run by each process, if
available.
SYMBOL
SHOW SYMBOL name [/ALL]
Displays the value of the specified system symbol
and the contents of that memory location (if possible).
Additional information available:
/ALL
Displays information on all the symbols that start with the
string you specified in the command parameter and are defined
in the SDA symbol table.