HP OpenVMS System Analysis Tools Manual

Contents

Index

The default of the SHOW PROCESS command provides information taken from the software process control block (PCB) and the kernel threads block (KTB) of the SDA current thread. This is the first display provided by the /ALL qualifier and the only display provided by the /PCB qualifier. This information describes the following characteristics of the process:

Software context
Condition-handling information
Information on interprocess communication
Information on counts, quotas, and resource usage

Among the displayed information are the process PID, EPID, priority, job information block (JIB) address, and process header (PHD) address. SHOW PROCESS also describes the resources owned by the process, such as event flags and mutexes. The "State" field records the current scheduling state for the thread, and indicates the CPU ID of any thread whose state is CUR. See Table 4-30 for a list of all possible states.

The /THREADS qualifier (also part of SHOW PROCESS/ALL), displays information from the KTBs of all threads in the process, instead of only the SDA current thread.

The SHOW PROCESS/ALL command displays additional process-specific information, also provided by several of the individual qualifiers to the command.

The process registers display, also produced by the /REGISTERS qualifier, describes the process hardware context, as reflected in its registers. The registers displayed are those of the SDA current thread, or of all threads if either the /THREADS or the /ALL qualifier have been specified.

A process hardware context is stored in the following locations:

If the process is currently executing on a processor in the system (that is, in the CUR scheduling state), its hardware context is contained in that processor's registers. (That is, the process registers and the processor's registers contain identical values, as illustrated by a SHOW CPU command for that processor or a SHOW CRASH command, if the process was current at the time of the system failure.)
If the process is not executing, its privileged hardware context is stored in the part of the PHD known as the HWPCB. Its integer register context is stored on its kernel stack. Its floating-point registers are stored in its PHD.

The process registers display first lists those registers stored in the HWPCB, kernel stack, and PHD ("Saved process registers"). If the process to be displayed is currently executing on a processor in the system, the display then lists the processor's registers ("Active registers for the current process"). In each section, the display lists the registers in groups.

For Alpha:

Integer registers (R0 through R29)
Special-purpose registers (PC and PS)
Stack pointers (KSP, ESP, SSP, and USP)
Page table base register (PTBR)
AST enable and summary registers (ASTEN and ASTSR)
Address space number register (ASN)

For I64:

Integer registers (R1 through R11, R13 through R31). Note that R1 is displayed as GP (Global Pointer) and R12 is omitted.
Special-purpose registers (PC, PSR, ISR)
Stack pointers (KSP, ESP, SSP, and USP)
Register stack pointers (KBSP, EBSP, SBSP, and UBSP)
Page table base register (PTBR0)
AST enable and summary registers (ASTEN and ASTSR)
Address space number registers (ASN0)
Floating point registers (F2 through F31, possibly F32 through F127)

The semaphore display, also produced by the /SEMAPHORE qualifier, provides information on the inner-mode semaphore used to synchronize kernel threads. The PC history log, recorded if the system parameter SYSTEM_CHECK is enabled, is also displayed.

The process header display, also produced by the /PHD qualifier, provides information taken from the PHD, which is swapped into memory when the process becomes part of the balance set. Each item listed in the display reflects a quantity, count, or limit for the process use of the following resources:

Process memory
The pager
The scheduler
Asynchronous system traps
I/O activity
CPU activity

The working set information and working set list displays, also produced by the /WORKING_SET_LIST qualifier, describe those virtual pages that the process can access without a page fault. After a brief description of the size, scope, and characteristics of the working set list itself, SDA displays information for each entry in the working set list as shown in Table 4-20.

Table 4-20 Working Set List Entry Information in the SHOW PROCESS Display
Column Contents

INDEX Index into the working set list at which information for this entry can be found

ADDRESS Virtual address of the page that this entry describes

STATUS Four columns that list the following status information:

Page status of VALID
Type of physical page (See Table 4-11)
Indication of whether the page has been modified
Indication of whether the page is locked into the working set

**Table 4-20 Working Set List Entry Information in the SHOW PROCESS Display**
Column	Contents
INDEX	Index into the working set list at which information for this entry can be found
ADDRESS	Virtual address of the page that this entry describes
STATUS	Four columns that list the following status information: Page status of VALID Type of physical page (See Table 4-11) Indication of whether the page has been modified Indication of whether the page is locked into the working set

When SDA locates either one or more unused working set entries, or entries that do not match the specified option, it issues the following message:

---- n entries not displayed

In this message, n is the number (in decimal) of contiguous entries not displayed.

The process section table information and process section table displays, also produced by the /PROCESS_SECTION_TABLE or /PST qualifier, list each entry in the process section table (PST) and display the offsets to, and the indexes of, the first free entry and last used entry.

SDA displays the information listed in Table 4-21 for each PST entry.

Table 4-21 Process Section Table Entry Information in the SHOW PROCESS Display
Part Definition

INDEX Index number of the entry. Entries in the process section table begin at the highest location in the table, and the table expands toward lower addresses.

ADDRESS Address of the process section table entry.

SECTION ADDRESS Virtual address that marks the beginning of the first page of the section described by this entry.

CCB Address of the channel control block on which the section file is open.

PAGELETS Length of the process section. This is in units of pagelets, except for a PFN-mapped section in which the units are pages.

VBN Virtual block number. The number of the file's virtual block that is mapped into the section's first page.

WINDOW Address of the window control block on which the section file is open.

REFCNT Number of pages of this section that are currently mapped.

FLINK Forward link. The pointer to the next entry in the PST list.

BLINK Backward link. The pointer to the previous entry in the PST list.

FLAGS Flags that describe the access that processes have to the process section.

**Table 4-21 Process Section Table Entry Information in the SHOW PROCESS Display**
Part	Definition
INDEX	Index number of the entry. Entries in the process section table begin at the highest location in the table, and the table expands toward lower addresses.
ADDRESS	Address of the process section table entry.
SECTION ADDRESS	Virtual address that marks the beginning of the first page of the section described by this entry.
CCB	Address of the channel control block on which the section file is open.
PAGELETS	Length of the process section. This is in units of pagelets, except for a PFN-mapped section in which the units are pages.
VBN	Virtual block number. The number of the file's virtual block that is mapped into the section's first page.
WINDOW	Address of the window control block on which the section file is open.
REFCNT	Number of pages of this section that are currently mapped.
FLINK	Forward link. The pointer to the next entry in the PST list.
BLINK	Backward link. The pointer to the previous entry in the PST list.
FLAGS	Flags that describe the access that processes have to the process section.

In addition, for each process section that has an associated file, the device and/or file name is displayed. For details of this display, see Table 4-23.

The regions display, also produced by the either of the /RDE or /REGIONS qualifiers, shows the contents of the region descriptors. This includes the three default regions (P0, P1, P2), plus any others created by the process. A single region will be displayed if you specify its identifier. The information displayed for each region includes the RDE address, the address range of the region, its identifiers and protection, and links to other RDEs.

If you use the /PAGE_TABLE or /PPT qualifer with /RDE or /REGION, the page table for the region is also displayed, as described below.

The P0 page table, P1 page table, P2 page table, and PT page table displays, also produced by the /PAGE_TABLES qualifier, display listings of the process page table entries in the same format as that produced by the SHOW PAGE_TABLE command (see Tables 4-7 through Table 4-12).

The RMS display, also produced by the /RMS qualifier, provides information on the RMS internal data structures for all RMS-accessed open files. The data structures displayed depend on the current setting of RMS options, as described under the SET RMS command and Table 4-2.

The locks display, also produced by the /LOCKS qualifier, provides information on the locks held by the process. For a full description of the information displayed for process locks, see the SHOW LOCKS command and Table 4-6. You can also specify the /BRIEF qualifier, which provides single-line summary of each process lock; however, no other qualifiers from SHOW LOCKS apply to SHOW PROCESS/LOCKS.

The process active channels display, also produced by the /CHANNEL qualifier, displays the information in Table 4-22 for each I/O channel assigned to the process.

Table 4-22 Process Active Channels in the SHOW PROCESS Display
Column Contents

Channel Number of the channel.

CCB The address of the channel control block (CCB).

Window Address of the window control block (WCB) for the file if the device is a file-oriented device; zero otherwise.

Status Status of the device: "Busy" if the device has an I/O operation outstanding; "Dpnd" if the device is deaccess pending; blank otherwise.

Device/file accessed Name of the device and, if applicable, name of the file being accessed on that device.

**Table 4-22 Process Active Channels in the SHOW PROCESS Display**
Column	Contents
Channel	Number of the channel.
CCB	The address of the channel control block (CCB).
Window	Address of the window control block (WCB) for the file if the device is a file-oriented device; zero otherwise.
Status	Status of the device: "Busy" if the device has an I/O operation outstanding; "Dpnd" if the device is deaccess pending; blank otherwise.
Device/file accessed	Name of the device and, if applicable, name of the file being accessed on that device.

The information listed under the heading "Device/file accessed" varies from channel to channel and from process to process. SDA displays certain information according to the conditions listed in Table 4-23.

Table 4-23 Process I/O Channel Information in the SHOW PROCESS Display
Information Displayed¹ Type of Process

dcuu: SDA displays this information for devices that are not file structured, such as terminals, and for processes that do not open files in the normal way.

dcuu: filespec SDA displays this information only if you are examining a running system, and only if your process has enough privilege to translate the file-id into the filespec.

dcuu:( file-id) The file-id no longer points to a valid filespec, as when you look at a dump from another system; or the process in which you are running SDA does not have enough privilege to translate the file-id into the corresponding filespec.

(section file) The file in question is mapped into the process's memory.

**Table 4-23 Process I/O Channel Information in the SHOW PROCESS Display**
Information Displayed¹	Type of Process
dcuu:	SDA displays this information for devices that are not file structured, such as terminals, and for processes that do not open files in the normal way.
dcuu: filespec	SDA displays this information only if you are examining a running system, and only if your process has enough privilege to translate the file-id into the filespec.
dcuu:( file-id)	The file-id no longer points to a valid filespec, as when you look at a dump from another system; or the process in which you are running SDA does not have enough privilege to translate the file-id into the corresponding filespec.
`(section file)`	The file in question is mapped into the process's memory.

¹This table uses the following conventions to identify the information displayed:
dcuu:(file-id)filespec
where:
dcuu: is the name of the device.
file-id is the RMS file identification, or
filespec is the full file specification, including directory name.

The images display, also produced by the /IMAGES qualifier, describes the activated images in the process. SDA displays the information listed in Table 4-24 for each image, plus a summary line giving the total image and total page counts.

Table 4-24 Image Information in the SHOW PROCESS Display
Item Description

Image Name The name of the image.

Link Time ¹ The date and time the image was linked.

Section Type ¹ For shareable images, the data for each image section is displayed on a separate line. For privileged shareable images, data for the change mode vector is also displayed on a separate line.

Start ² Start address of the image in process memory. For resident shareable images, this is the start address of the process-space portion of the image.

End ² End address of the image in process memory. For resident shareable images, this is the end address of the process-space portion of the image.

Type The image type and/or activation method, plus "PROT" for protected images and "SHR" for shareable images.

File ID ¹ The File ID for the image file. No attempt is made to translate this to a filename.

IMCB The address of the Image Management Control Block.

GP ³ The Global Pointer for the image.

Sym Vect ¹ The address of the image's symbol vector, if any.

Maj, Minor ID ¹, ² The major and minor revision IDs for the image.

Maj, Min ID, Match ¹, ³ The major and minor revision IDs for the image, plus the match control bits.

Base ¹ For Alpha shareable images and all I64 images, the base address of each image section and/or the change mode vector.

End ¹ For Alpha shareable images and all I64 images, the end address of each image section and/or the change mode vector.

ImageOff ¹ For Alpha shareable images and all I64 images, the virtual offset within the image file for each image section.

**Table 4-24 Image Information in the SHOW PROCESS Display**
Item	Description
Image Name	The name of the image.
Link Time ¹	The date and time the image was linked.
Section Type ¹	For shareable images, the data for each image section is displayed on a separate line. For privileged shareable images, data for the change mode vector is also displayed on a separate line.
Start ²	Start address of the image in process memory. For resident shareable images, this is the start address of the process-space portion of the image.
End ²	End address of the image in process memory. For resident shareable images, this is the end address of the process-space portion of the image.
Type	The image type and/or activation method, plus "PROT" for protected images and "SHR" for shareable images.
File ID ¹	The File ID for the image file. No attempt is made to translate this to a filename.
IMCB	The address of the Image Management Control Block.
GP ³	The Global Pointer for the image.
Sym Vect ¹	The address of the image's symbol vector, if any.
Maj, Minor ID ¹, ²	The major and minor revision IDs for the image.
Maj, Min ID, Match ¹, ³	The major and minor revision IDs for the image, plus the match control bits.
Base ¹	For Alpha shareable images and all I64 images, the base address of each image section and/or the change mode vector.
End ¹	For Alpha shareable images and all I64 images, the end address of each image section and/or the change mode vector.
ImageOff ¹	For Alpha shareable images and all I64 images, the virtual offset within the image file for each image section.

¹These items are only displayed with SHOW PROCESS/IMAGE=ALL or SHOW PROCESS/ALL.
²Alpha only.
³I64 only.

The buffer objects display, also produced by the /BUFFER_OBJECTS qualifier, describes the buffer objects in use by the process. Information displayed by SDA for each buffer object includes its address, access mode, size, flags, plus the base virtual address of the object in process space and system space.

The fast I/O handles display, also produced by the /FANDLES qualifier, describes the fast I/O handles used by the process. Information displayed by SDA includes the address and size of the fast I/O handle vector header, then the address, corresponding IRP, state, and buffer object handles for each fast I/O handle, plus information on free vector entries.

The persona display, also produced by the /PERSONA qualifier, describes the Persona status block data structures. The default output of /PERSONA consists of summary information for all personae in use by the process (the PSB address, flags, user name) and information for each persona (privilege masks, UIC, and so on). When you specify /PERSONA/RIGHTS (as in SHOW PROCESS/ALL), all the rights currently held and active for each persona are also displayed. When you specify /PERSONA/RIGHTS/AUTHORIZED, all the rights authorized for each persona are displayed instead.

The pool display, also produced by the /POOL qualifier, describes the P0 and P1 process pools. The default output of /POOL is the entire contents of each used block of pool. When you specify /POOL/HEADER (as in SHOW PROCESS/ALL), only the first 16 bytes of each used pool block is displayed. By default, all pool in either P0 or P1 is displayed. You can limit this using /POOL=P0 or /POOL=P1. See the description of the SHOW POOL command for explanations of other qualifiers.

The Timer Queue Entry (TQE) display, also produced by the /TQE qualifier, describes all timer queue entries that affect the process. The default display (as in SHOW PROCESS/ALL) is a one-line summary of each TQE. If you specify /TQE=ALL, a detailed display of each TQE is given. No other qualifiers from the SHOW TQE command apply to SHOW PROCESS/TQE.

Examples

#1
SDA> SHOW PROCESS Process index: 0028 Name: SYSTEM Extended PID: 000000E8 ----------------------------------------------------------- Process status: 02040001 RES,PHDRES,INTER status2: 00000000 PCB address 81444A40 JIB address 81443600 PHD address 821AA000 Swapfile disk address 00000000 KTB vector address 81444D2C HWPCB address 821AA080 Callback vector address 00000000 Termination mailbox 0000 Master internal PID 00030028 Subprocess count 0 Creator extended PID 00000000 Creator internal PID 00000000 Previous CPU Id 00000000 Current CPU Id 00000000 Previous ASNSEQ 0000000000000003 Previous ASN 0000000000000017 Initial process priority 4 # open files remaining 100/100 Delete pending count 0 Direct I/O count/limit 150/150 UIC [00001,000004] Buffered I/O count/limit 149/150 Abs time of last event 01F1A51D BUFIO byte count/limit 99424/99808 # of threads 1 ASTs remaining 248/250 Swapped copy of LEFC0 00000000 Timer entries remaining 20/20 Swapped copy of LEFC1 00000000 Active page table count 0 Global cluster 2 pointer 00000000 Process WS page count 43 Global cluster 3 pointer 00000000 Global WS page count 28 Thread index: 0000 ------------------ Current capabilities: System: 0000000C QUORUM,RUN User: 00000000 Permanent capabilities: System: 0000000C QUORUM,RUN User: 00000000 Current affinities: 00000000 Permanent affinities: 00000000 Thread status: 02040001 status2: 00000000 KTB address 81444A40 HWPCB address 821AA080 PKTA address 7FFEFF98 Callback vector address 00000000 Internal PID 00030028 Callback error 00000000 Extended PID 000000E8 Current CPU id 00000000 State LEF Flags 00000000 Base priority 4 Current priority 5 Waiting EF cluster 0 Event flag wait mask DFFFFFFF CPU since last quantum FFF8 Mutex count 0 ASTs active NONE

SDA>  SHOW PROCESS
Process index: 0028   Name: SYSTEM   Extended PID: 000000E8 
----------------------------------------------------------- 
Process status:          02040001  RES,PHDRES,INTER 
        status2:         00000000 
 
PCB address              81444A40    JIB address              81443600 
PHD address              821AA000    Swapfile disk address    00000000 
KTB vector address       81444D2C    HWPCB address            821AA080 
Callback vector address  00000000    Termination mailbox          0000 
Master internal PID      00030028    Subprocess count                0 
Creator extended PID     00000000    Creator internal PID     00000000 
Previous CPU Id          00000000    Current CPU Id           00000000 
Previous ASNSEQ  0000000000000003    Previous ASN     0000000000000017 
Initial process priority        4    # open files remaining        100/100 
Delete pending count            0    Direct I/O count/limit        150/150 
UIC                [00001,000004]    Buffered I/O count/limit      149/150 
Abs time of last event   01F1A51D    BUFIO byte count/limit      99424/99808 
# of threads                    1    ASTs remaining                248/250 
Swapped copy of LEFC0    00000000    Timer entries remaining        20/20 
Swapped copy of LEFC1    00000000    Active page table count         0 
Global cluster 2 pointer 00000000    Process WS page count          43 
Global cluster 3 pointer 00000000    Global WS page count           28 
 
Thread index: 0000 
------------------ 
Current capabilities:    System: 0000000C  QUORUM,RUN 
                         User:   00000000 
Permanent capabilities:  System: 0000000C  QUORUM,RUN 
                         User:   00000000 
Current affinities:      00000000 
Permanent affinities:    00000000 
Thread status:           02040001 
       status2:          00000000 
 
KTB address              81444A40    HWPCB address            821AA080 
PKTA address             7FFEFF98    Callback vector address  00000000 
Internal PID             00030028    Callback error           00000000 
Extended PID             000000E8    Current CPU id           00000000 
State                       LEF      Flags                    00000000 
Base priority                   4    Current priority                5 
Waiting EF cluster              0    Event flag wait mask     DFFFFFFF 
CPU since last quantum       FFF8    Mutex count                     0 
ASTs active                  NONE

The SHOW PROCESS command displays information taken from the software PCB of SYSTEM, the SDA current process. According to the State field in the display, process SYSTEM is in Local Event Flag Wait.

For Figures 2 and 3, refer to the printed manual.

4. SDA> SHOW PROCESS/BUFFER_OBJECTS/FANDLES Process index: 0022 Name: NODEA_RTA1: Extended PID: 00000062 ----------------------------------------------------------------- Process Buffer Objects ---------------------- ADDRESS ACMODE SEQUENCE REFCNT PID PAGCNT BASE PVA BASE SVA -------- ------ -------- -------- -------- -------- ----------------- ----------------- 8151AE00 User 00000011 00000031 00010022 00000001 00000000.00084000 FFFFFFFF.7DE68000 S2_WINDOW 814A6CC0 User 00000012 00000009 00010022 00000001 00000000.80000000 FFFFFFFF.7DE66000 S2_WINDOW 814FBA00 User 00000013 00000009 00010022 00000001 00000000.80000000 FFFFFFFF.FFFFFFFF NOSVA 81512200 User 00000014 00000009 00010022 00000001 00000000.80028000 FFFFFFFF.7DE64000 S2_WINDOW 8151A8C0 User 00000015 00000009 00010022 00000001 00000000.80028000 FFFFFFFF.FFFFFFFF NOSVA 81438580 User 00000016 00000009 00010022 00000001 FFFFFEFB.FF800000 FFFFFFFF.7DE62000 S2_WINDOW 81464480 User 00000017 00000009 00010022 00000001 FFFFFEFB.FF800000 FFFFFFFF.FFFFFFFF NOSVA 81416F00 Kernel 00000018 00000001 00010022 00000001 00000000.7FF76000 FFFFFFFF.8120C000 NOQUOTA Fandle Vector Header -------------------- Address Maxfix Real_Size CCB buffer handle -------- -------- --------- ----------------- 7FF68290 00000043 00000880 00000018.81416F00 Fandles ------- Address IRP fastio_done Orgfun Data bo handle IOSA bo handle DBYLEN -------- -------- ----------- -------- ----------------- ----------------- ----------------- 7FF682B0 815CEF40 set 00020031 00000016.81438580 00000011.8151AE00 00000000.00002000 7FF682D0 815CE4C0 set 00020030 00000016.81438580 00000011.8151AE00 00000000.00002000 7FF682F0 815CE200 set 00000031 00000016.81438580 00000011.8151AE00 00000000.00002000 7FF68310 815D4B80 set 00000030 00000016.81438580 00000011.8151AE00 00000000.00002000 7FF68330 815D65C0 set 00020031 00000015.8151A8C0 00000011.8151AE00 00000000.00002000 7FF68350 815D6880 set 00020030 00000015.8151A8C0 00000011.8151AE00 00000000.00002000 . . . 7FF68810 815D6B40 set 00020031 00000013.814FBA00 00000011.8151AE00 00000000.00002000 7FF68830 815D5880 set 00020030 00000013.814FBA00 00000011.8151AE00 00000000.00002000 ----- 00000013 free FVEs (IRP = 00000000) VA 7FF68850 -to- 7FF68A90 7FF68AB0 815D9840 set 00020031 00000017.81464480 00000011.8151AE00 00000000.00002000 7FF68AD0 815CD040 set 00020030 00000017.81464480 00000011.8151AE00 00000000.00002000 7FF68AF0 815CB480 set 00000031 00000017.81464480 00000011.8151AE00 00000000.00002000)

The SHOW PROCESS/BUFFER_OBJECTS/FANDLES command displays all the buffered objects and fast I/O handles that a process has created.

5. SDA> SHOW PROCESS JOB_CONTROL/TQE Process index: 000C Name: JOB_CONTROL Extended PID: 0000004C ---------------------------------------------------------------- Timer queue entries ------------------- TQE address Expiration Time Type -------- ----------------------------------------- ------ 81504080 00A05ABD.895F93C5 27-NOV-2001 11:17:17.37 TSD--- 815026C0 00A05AC3.80D0E000 27-NOV-2001 12:00:00.00 TSA--- 81502180 00A0C160.635594EF 7-APR-2002 02:00:00.12 TSA---

This example shows the timer queue entries for the process JOB_CONTROL. See Table 4-31 for an explanation of the Type codes.

6. SDA> SHOW PROCESS /IMAGE Process index: 0005 Name: SA_STARTUP_DCL Extended PID: 00000025 -----------------------------------------------------------------

Process activated images ------------------------ Image Name Type IMCB GP --------------------------------------- ------------ -------- ----------------- SDA MAIN 7FE86EB0 00000000.00230000 SDA$SHARE GLBL 7FE86190 00000000.00636000 SMGSHR GLBL 7FE87830 00000000.00706000 ... Total images = 17 Pages allocated = 2165 SDA> show process/image=sda Process index: 0005 Name: SA_STARTUP_DCL Extended PID: 00000025 -------------------------------------------------------------------- Process activated images ------------------------ Image Name/Link Time/Section Type Type/File Id IMCB Sym Vect Maj,Min ID,Match --------------------------------------- ------------ -------- -------- ---------------- *** see below *** SDA MAIN 7FE86EB0 231F,85F10A8C,01 17-MAY-2004 10:55:33.89 (1346,1,0) Code Data (read only) Short data Fixup *** Rightmost columns from above output moved here *** Base End ImageOff ----------------- ----------------- -------- GP = 00000000.00230000 00000000.00010000 00000000.0001022F 00010000 00000000.00020000 00000000.000200EF 00020000 00000000.00030000 00000000.00030077 00030000 00000000.80000000 00000000.800003FF 80000000

This example includes the GP (global pointer).

Contents

Index