1 /ADDRESS
/ADDRESS=pcb-address
Specifies the process control block (PCB) address of a process in
order to display information about the process.
2 /ALL
Displays all information shown by the following qualifiers:
/BUFFER_OBJECTS
/CHANNELS
/FANDLES
/IMAGES=ALL
/LOCKS
/PAGE_TABLES=ALL
/PCB
/PERSONA/RIGHTS
/PHD
/POOL/HEADER/RING_BUFFER/STATISTICS
/PROCESS_SECTION_TABLE
/REGIONS
/REGISTERS
/RMS
/SEMAPHORE
/THREADS
/TQE
/UNWIND_TABLE (Integrity servers only.)
/WORKING_SET_LIST
3 /AUTHORIZED
Used with the /PERSONA/RIGHTS qualifiers. See the
/PERSONA/RIGHTS/AUTHORIZED description for the use of the
/AUTHORIZED qualifier.
4 /BRIEF
When used with the /LOCKS qualifier, causes SDA to display each
lock owned by the current process in brief format, that is, one
line for each lock. When used with the /POOL qualifier, causes
SDA to display only general information about process pool and
its addresses.
5 /BUFFER_OBJECTS
Displays all the buffer objects that a process has created.
6 /CHANNELS
Displays information about the I/O channels assigned to the
process.
7 /CHECK
Checks all free process pool packets for POOLCHECK-style
corruption in exactly the same way that the system does when
generating a POOLCHECK crash dump.
8 /FANDLES
Displays the data on the process' fast I/O handles.
9 /FID_ONLY
When used with /CHANNEL or /PROCESS_SECTION_TABLE (/PST), causes
SDA to not attempt to translate the FID (File ID) to a file name
when invoked with ANALYZE/SYSTEM.
10 /FREE
When used with /POOL, displays the entire contents, both
allocated and free, of the specified region or regions of pool.
Use the /FREE qualifier with a range to show all of the used and
free pool in the given range.
11 /GSTX
/GSTX=index
When used with the /PAGE_TABLES qualifier, displays only page
table entries for the specific global section.
12 /HEADER
When used with /POOL, displays only the first 16 bytes of each
data packet found within the specified region or regions of pool.
13 /IMAGES
/IMAGES [= {name|ALL} ]
For all images in use by this process, 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. The
/IMAGES=ALL qualifier also displays the base, end, image offset,
section type, and global pointer for all images (Integrity
servers) or for all installed resident images (Alpha) in use by
this process. The /IMAGE=name qualifier displays this information
for just the specified images; name may contain wildcards.
See the OpenVMS Linker Utility Manual and the Install utility
chapter in the OpenVMS System Management Utilities Reference
Manual for more information on images installed using the
/RESIDENT qualifier.
14 /ID
See the /INDEX qualifier, which is functionally equivalent to
/ID.
15 /INDEX
Specifies the process for which information is to be displayed
by its index into the system's list of software process control
blocks (PCBs), or by its process identification (ID). /ID and
/INDEX can be used interchangeably. You can supply the following
values for nn:
o The process index itself.
o The process identification (PID) or extended PID longword,
from which SDA extracts the correct index. You can specify the
PID or extended PID of any thread of a process with multiple
kernel threads. Any thread-specific data displayed by SHOW
PROCESS will be for the given thread.
To obtain these values for any given process, issue the SDA
command SHOW SUMMARY/THREADS.
16 /INVALID_PFN
/INVALID_PFN [=option]
The /INVALID_PFN qualifier, which is valid only on platforms that
supply an I/O memory map, causes SDA to display only page table
entries that map to PFNs that are not in the system's private
memory or in Galaxy-shared memory, and which are not I/O access
pages. Use of /INVALID_PFN implies /PAGE_TABLES.
The /INVALID_PFN qualifier allows two optional keywords, READONLY
and WRITABLE. If neither keyword is given, all relevant pages
are displayed. If you specify READONLY, only pages marked for no
write access are displayed. If you specify WRITABLE, only pages
that allow write access are displayed. For example, SHOW PROCESS
ALL/PAGE_TABLE=ALL/INVALID_PFN=WRITABLE would display all process
pages (for all processes) whose protection allows write, but
which map to PFNs that do not belong to this system.
17 /L1
/L1
/L2
/L3 (D)
Used with the /PAGE_TABLES qualifier to specify the level for
which page table entries are to be displayed. You can specify
only one level. /L3 is the default.
18 /L2
When used with the /PAGE_TABLES qualifier, specifies that only
the the Level 2 page table entries are to be displayed. Level 3
is the default.
19 /L3
When used with the /PAGE_TABLES qualifier, specifies that only
the the Level 3 page table entries are to be displayed. This is
the default.
20 /LOCKS
/LOCKS [/BRIEF]
Displays the lock management locks owned by the current process.
When specified with /BRIEF, produces a display similar in format
to that produced by the SHOW LOCKS command; that is, it causes
SDA to display each lock owned by the current process in brief
format with one line for each lock.
21 /MAXIMUM_BYTES
/MAXIMUM_BYTES [=n]
When used with /POOL, displays only the first n bytes of a
pool packet; if you specify /MAXIMUM_BYTES without a value, the
default is 64 bytes.
22 /NEXT
Locates the next valid process in the system's process list and
selects that process. If there are no further valid processes in
the system's process list, SDA returns an error.
23 /NONMEMORY_PFN
/NONMEMORY_PFN [=option]
The /NONMEMORY_PFN qualifier causes SDA to display only page
table entries that are in neither the system's private memory
nor in Galaxy-shared memory. Use of /NONMEMORY_PFN implies
/PAGE_TABLES.
The /NONMEMORY_PFN qualifier allows two optional keywords,
READONLY and WRITABLE. If neither keyword is given, all relevant
pages are displayed. If you specify READONLY, only pages marked
for no write access are displayed. If you specify WRITABLE, only
pages that allow write access are displayed. For example, SHOW
PROCESS ALL/PAGE_TABLE=ALL/NONMEMORY_PFN=WRITABLE would display
all process pages (for all processes) whose protection allows
write, but which map to PFNs that are in neither the system's
private memory nor Galaxy-shared memory.
24 /P0
/P0 (D)
/P1
/P2
/PT
When used with the /PAGE_TABLES qualifier, /P0, /P1, /P2, and /PT
specify one or more regions for which page table entries should
be displayed. You can specify any or none of these values. The
default is /P0.
25 /P1
When used with the /PAGE_TABLES qualifier, /P1 displays the
page table entries for P1 space. By default, only P0 space is
displayed.
26 /P2
When used with the /PAGE_TABLES qualifier, /P2 displays the
page table entries for P2 space. By default, only P0 space is
displayed.
27 /PAGE_TABLES
Displays the page tables of the process P0 (process), P1
(control), P2, or PT (page table) region, or, optionally, page
table entries for a range of addresses. You can use /PAGE_
TABLES=ALL to display page tables of all four regions. With /Ln,
the page table entries at the level specified by /L1, /L2, or /L3
(the default) are displayed.
With /RDE=id or /REGIONS=id, SDA displays the page tables for
the address range of the specified address region. When you do
not specify an ID, the page tables are displayed for all the
process-permanent and user-defined regions.
If /PTE_ADDRESS is given, the range is expressed using the
following syntax:
m Displays the single page table entry at address m
m:n Displays the page table entries from address m to address n
m;n Displays n bytes of page table entries starting at address m
If /PTE_ADDRESS is not given, then range is expressed using the
following syntax:
m Displays the single page table entry that corresponds to
virtual address m
m:n Displays the page table entries that correspond to the range
of virtual addresses from m to n
m;n Displays the page table entries that correspond to a range of
n bytes starting at virtual address m
The /GSTX=index qualifier causes SDA to display only the page
table entries for the pages in the specified global section.
The /SECTION_INDEX=n qualifier causes SDA to display only
the page table entries for the pages in the specified process
section.
28 /PCB
Displays the information contained in the process control block
(PCB). This is the default behavior of the SHOW PROCESS command.
29 /PERSONA
/PERSONA [=address]
Displays all persona security blocks (PSBs) held in the PERSONA
ARRAY of the process, and then lists selected information
contained in each initially listed PSB. The selected information
includes the contents of the following cells inside the PSB:
Flags
Reference count
Execution mode
Audit status
Account name
UIC
Privileges
Rights enabled mask
If you specify a PSB address, this information is provided for
that specific PSB only.
If you also specify /RIGHTS, SDA expands the display to provide
additional selected information, including all the rights and
their attributes currently held and active for each persona
security block (PSB) specified with the /PERSONA qualifier.
If you specify /RIGHTS/AUTHORIZED, SDA also displays additional
selected information, including all the rights and their
attributes authorized for each persona security block (PSB)
specified with the /PERSONA qualifier.
30 /PHD
Lists the information included in the process header (PHD).
31 /POOL
/POOL [= {P0 | P1 | IMGACT | ALL (D)} | range]
Displays the dynamic storage pool in the process' P0 (process)
region, the P1 (control) region, or the image activator's
reserved pages, or optionally, a range of addresses. The default
action is to display all dynamic storage pools.
You can express a range using the following syntax:
m:n Displays the process pool in the range of virtual addresses
from m to n.
m;n Displays process pool in a range of n bytes, starting at
virtual address m.
32 /PPT
See the description of /PAGE_TABLES, which is functionally
equivalent to /PPT.
33 /PROCESS_SECTION_TABLE
Lists the information contained in the process section table
(PST). The /SECTION_INDEX=id qualifier used with /PROCESS_
SECTION_TABLE displays the process section table entry for the
specified section.
Format
/PROCESS_SECTION_TABLE [/SECTION_INDEX=id][/FID_ONLY]
34 /PST
Is a synonym for /PROCESS_SECTION_TABLE.
35 /PT
When used with the /PAGE_TABLES qualifier, displays the page
table entries for the page table space of the process. By
default, P0 space is displayed.
36 /PTE_ADDRESS
When used with the /PAGE_TABLES qualifier, specifies that the
range is of PTE addresses instead of the virtual addresses mapped
by the PTE.
37 /RDE
/RDE [=id]
See the description of the /REGIONS qualifier, which is
functionally equivalent to /RDE.
38 /REGIONS
/REGIONS [=id]
Lists the information contained in the process region table for
the specified region. If you do not specify a region, the entire
table is displayed, including the process-permanent regions. /RDE
and /REGIONS are functionally equivalent. When used with /PAGE_
TABLES, this qualifier causes SDA to display the page tables for
only the specified region or, by default, for all regions.
39 /REGISTERS
Lists the hardware context of the process, as reflected in the
process registers stored in the hardware privileged context block
(HWPCB), in its kernel stack, and possibly, in its PHD.
40 /RIGHTS
Used with the /PERSONA qualifier. See the /PERSONA/RIGHTS
description for use of the /RIGHTS qualifier.
41 /RING_BUFFER
/RING_BUFFER [={ALL | address}]
Displays the contents of the process-pool history ring buffer.
Entries are displayed in reverse chronological order (most
recent to least recent). If you specify /RING_BUFFER without
the ALL keyword or an address, SDA displays all unmatched current
allocations and deallocations. Use /RING_BUFFER=ALL to display
matched allocations and deallocations and any non-current entries
not yet overwritten. Use /RING_BUFFER=address to limit the
display to only allocations and deallocations of blocks that
contain the given address (including matched allocations and
deallocations).
42 /RMS
/RMS [= (option[,...]) ]
Displays certain specified RMS data structures for each image I/O
or process-permanent I/O file the process has open. To display
RMS data structures for process-permanent files, specify the PIO
option to this qualifier. Other guidelines for specifying this
qualifier include the following:
o If you specify only one option, you can omit the parentheses.
o You can add additional structures to those already set by
the SET RMS command by beginning the list of options with an
asterisk (*).
o You can exclude a structure from those set by the SET RMS
command by specifying its keyword option preceded by NO (for
example, NOPIO).
SDA determines the structures to be displayed according to either
of the following methods:
o If you provide the name of a structure or structures in the
option parameter, SHOW PROCESS/RMS displays information from
only the specified structures. Type HELP SET RMS for a list of
keywords that can be supplied as options.
o If you do not specify an option, SHOW PROCESS/RMS displays the
current list of options as shown by the SHOW RMS command and
set by the SET RMS command.
43 /SECTION_INDEX
/SECTION_INDEX=n
When used with the /PAGE_TABLES qualifier, displays the page
table for the range of pages in the specified process section.
You can also specify one of the qualifiers /L1, /L2, or /L3.
When used with the /PROCESS_SECTION_TABLE qualifier, displays the
PST for the specified process section.
The /SECTION_INDEX=n qualifier is ignored if you do not specify
either the /PAGE_TABLES or the /PROCESS_SECTION_TABLE qualifier.
44 /SEMAPHORE
Displays the Inner Mode Semaphore for a multithreaded process.
45 /STATISTICS
When used with /POOL, displays statistics on the free list(s) in
process pool.
46 /SUBTYPE
/SUBTYPE=packet-type
When used with /POOL, displays only packets of the specified
subtype. Pool packet types found in the process pool can include
logical names (LNM) and image control blocks (IMCB). /SUBTYPE is
functionally equivalent to /TYPE.
47 /SUMMARY
When used with /POOL, displays only an allocation summary for
each packet type.
48 /SYSTEM
Displays the system's process control block. The system PCB and
process header (PHD) parallel the data structures that describe
processes. They contain the system working set, global section
table, global page table, and other systemwide data.
49 /THREADS
Displays the software and hardware context of all the threads
associated with the current process.
50 /TQE
/TQE [=ALL]
Displays all timer queue entries associated with the current
process. If specified as /TQE, a one-line summary is output for
each TQE. If specified as /TQE=ALL, a detailed display of each
TQE is output.
51 /TYPE
/TYPE=packet-type
When used with /POOL, displays only packets of the specified
type. Pool packet types found in the process pool can include
logical names (LNM) and image control blocks (IMCB). /TYPE is
functionally equivalent to /SUBTYPE.
52 /UNUSED
When used with /POOL, displays only free packets.
53 /UNWIND_TABLE
/UNWIND_TABLE [= {ALL | name} ]
Valid for Intergrity server systems only.
If specified without a keyword, displays the master unwind table
for the process. SHOW PROCESS/UNWIND=ALL displays the details
of every process unwind descriptor. SHOW PROCESS/UNWIND=name
displays the details of every unwind descriptor for the named
image or images implied by a wildcard. To look at unwind data for
a specific PC in process space, use SHOW UNWIND address.
If some or all unwind data for an image is not included in the
system dump (for example, if it was not in the working set of the
process at the time of the system crash), a SHOW PROCESS/UNWIND
command can fail with a %SDA-W-NOREAD error because the unwind
data is inaccessible. Collecting unwind data using the SDA
commands COLLECT and COPY/COLLECT will not correct this because
the collected unwind data is used only by SHOW UNWIND address and
SHOW CALL.
54 /WORKING_SET_LIST
/WORKING_SET_LIST [={PPT|PROCESS|LOCKED|GLOBAL|MODIFIED|n}]
Displays the contents of the requested entries of the working
set list for the process. If you do not specify an option,
all working set list entries are displayed. This qualifier is
functionally equivalent to /WSL.
The following table shows the options available with SHOW
PROCESS/WORKING_SET_LIST.
Options Results
PPT Displays process page table pages
PROCESS Displays process-private pages
LOCKED Displays pages locked into the process' working set
GLOBAL Displays global pages currently in the working set of
the process
MODIFIED Displays working set list entries marked modified
n Displays a specific working set list entry, where n
is the working set list index (WSLX) of the entry of
interest
55 /WSL
See /WORKING_SET_LIST, which is functionally equivalent to /WSL.