System Dump Analyzer SHOW — MicroVMS 4.6
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 CRASH
SHOW DEVICE
SHOW HEADER
SHOW LOCK
SHOW PAGE_TABLE
SHOW PFN_DATA
SHOW POOL
SHOW PORTS
SHOW PROCESS
SHOW RESOURCES
SHOW RMS
SHOW RSPID
SHOW STACK
SHOW SUMMARY
SHOW SYMBOL
Additional information available:
CALL_FRAMECLUSTERCONNECTIONSCRASHDEVICE
HEADERLOCKPAGE_TABLEPFN_DATAPOOLPORTS
PROCESSRESOURCESRSPIDRMSSTACKSUMMARY
SYMBOL
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 Architec-
ture (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.
CRASH
Displays information concerning the operating system and the currently
executing process, including the general and special registers that
describe the process context at the time of the system failure. Also
displayed is the processor type and certain hardware specific
maintenance registers that might prove useful in the analysis of
certain system failures.
DEVICE
SHOW DEVICE name
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.
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]
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]
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]
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.
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]
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.
PROCESS
SHOW PROCESS [procname] [/qualifier...]
Displays the software and hardware context of any process in the
balance set, and performs an implicit SET PROCESS command.
If no options are given, the PCB of the current process is printed by
default.
If 'procname' is specified as "ALL", then information is shown for
all processes that exist in the system.
'Procname' must be a quoted string if characters other than capital
letters and numbers are present in the process name.
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). 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[=optionspec]
Displays the RMS control blocks specified by the optionspec or by the
last SET RMS command. If the optionspec 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
optionspec. The default optionspec 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
Displays the RMS display options currently selected by the SET RMS
command (only applies to the show process/rms command).
STACK
SHOW STACK [range]
Displays the location and contents of the four process stacks and the
system-wide interrupt stack.
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 system-wide interrupt stack.
/EXECUTIVE
Displays the executive mode stack for the current process.
/INTERRUPT
Displays the interrupt mode stack for the system.
/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
Displays a list of all processes in the system at the time of
the system crash.
Additional information available:
/IMAGE
Displays the name of the image being run by each process, if
available.
SYMBOL
SHOW SYMBOL name
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.