OpenVMS Alpha System Analysis Tools Manual

Document revision date: 30 March 2001

OpenVMS Alpha System Analysis Tools Manual

Contents

Index

SHOW LOCKS

Displays information about all lock management locks in the system, or about a specified lock.

Format

SHOW LOCKS {lock-id|/ADDRESS=n|/ALL (d)|
/BLOCKING|/BRIEF|/CACHED|/CONVERT|/GRANTED
|/NAME=name|/POOL|
/STATUS=(keyword [,keyword...])|/SUMMARY|
/WAITING}

Parameter

lock-id
Name of a specific lock.

Qualifiers

/ADDRESS=n
Displays a specific lock, given the address of the lock block.
/ALL
Lists all locks that exist in the system. This is the default behavior of the SHOW LOCK command.
/BLOCKING
Displays only the locks that have a blocking AST specified or attached.
/BRIEF
Displays a single line of information for each lock.
/CACHED
Displays locks that are no longer valid. The memory for these locks is saved so that later requests for locks can use them. Cached locks are not displayed in the other SHOW LOCK commands.
/CONVERT
Displays only the locks that are on the conversion queue.
/GRANTED
Displays only the locks that are on the granted queue.
/NAME=name
Displays a specified lock with the given name.
/POOL
Displays the lock manager's poolzone information, which contains the lock blocks (LKB) and resource blocks (RSB).
/STATUS=(keyword[,keyword...])
Displays only the locks that have the specified status bits set in the LKB$L_STATUS field. Status keywords are as follows:

Keyword Meaning

2PC_IP Indicates a two-phase operation in progress

2PC_PEND Indicates a two-phase operation pending

ASYNC Completes request asynchronously

BLKASTFLG Specifies a blocking AST

BLKASTQED Indicates a blocking AST is queued

BRL Indicates a byte range lock

CACHED Indicates a lock block in cache

CVTSUBRNG Indicates a sub-range convert request

CVTTOSYS Converts back to system-owned lock

DBLKAST Delivers a blocking AST

DCPLAST Delivers a completion AST

DPC Indicates a delete pending cache lock

FLOCK Indicates a fork lock

GRSUBRNG Grants sub-range lock

IP Indicates operation in process

MSTCPY Indicates a lock block is a master copy

NEWSUBRNG Indicates a new sub-range request

NOQUOTA Does not charge quota

PCACHED Indicates lock block needs to be cached

PROTECT Indicates a protected lock

RESEND Resends during failover

RM_RBRQD Requires remaster rebuild

RNGBLK Specifies a range block

RNGCHG Indicates a changing range

TIMOUTQ Indicates lock block is on timeout queue

VALBLKRD Indicates read access to lock value block

VALBLKWRT Indicates write access to lock value block

WASSYSOWN Indicates was system-owned lock

/SUMMARY
Displays summary data and performance counters.
/WAITING
Displays only the waiting locks.

Keyword	Meaning
2PC_IP	Indicates a two-phase operation in progress
2PC_PEND	Indicates a two-phase operation pending
ASYNC	Completes request asynchronously
BLKASTFLG	Specifies a blocking AST
BLKASTQED	Indicates a blocking AST is queued
BRL	Indicates a byte range lock
CACHED	Indicates a lock block in cache
CVTSUBRNG	Indicates a sub-range convert request
CVTTOSYS	Converts back to system-owned lock
DBLKAST	Delivers a blocking AST
DCPLAST	Delivers a completion AST
DPC	Indicates a delete pending cache lock
FLOCK	Indicates a fork lock
GRSUBRNG	Grants sub-range lock
IP	Indicates operation in process
MSTCPY	Indicates a lock block is a master copy
NEWSUBRNG	Indicates a new sub-range request
NOQUOTA	Does not charge quota
PCACHED	Indicates lock block needs to be cached
PROTECT	Indicates a protected lock
RESEND	Resends during failover
RM_RBRQD	Requires remaster rebuild
RNGBLK	Specifies a range block
RNGCHG	Indicates a changing range
TIMOUTQ	Indicates lock block is on timeout queue
VALBLKRD	Indicates read access to lock value block
VALBLKWRT	Indicates write access to lock value block
WASSYSOWN	Indicates was system-owned lock

Description

The SHOW LOCKS command displays the information described in Table 4-4 for each lock management lock in the system, or for the lock indicated by lock-id, an address or name. (Use the SHOW SPINLOCKS command to display information about spinlocks.) You can obtain a similar display for the locks owned by a specific process by issuing the appropriate SHOW PROCESS/LOCKS command. See the OpenVMS Programming Concepts Manual for additional information.
You can display information about the resource to which a lock is queued by issuing the SHOW RESOURCES command specifying the resource's lock-id.

Table 4-4 Contents of the SHOW LOCK and SHOW PROCESS/LOCKS Displays
Display Element Description

Process Index ¹ Index in the PCB array to a pointer to the process control block (PCB) of the process that owns the lock.

Name ¹ Name of the process that owns the lock.

Extended PID ¹ Clusterwide identification of the process that owns the lock.

Lock ID Identification of the lock.

PID Systemwide identification of the lock.

Flags Information specified in the request for the lock.

Par. ID Identification of the lock's parent lock.

Sublocks Count of the locks that the lock owns.

LKB Address of the lock block (LKB). If a blocking AST has been enabled for this lock, the notation "BLKAST" appears next to the LKB address.

Priority The lock priority.

Granted at Lock mode at which the lock was granted.

RSB Address of the resource block.

Resource Dump of the resource name. The two leftmost columns of the dump show its contents as hexadecimal values, the least significant byte being represented by the rightmost two digits. The rightmost column represents its contents as ASCII text, the least significant byte being represented by the leftmost character.

Status Status of the lock, information used internally by the lock manager.

Length Length of the resource name.

Mode Processor access mode of the namespace in which the resource block (RSB) associated with the lock resides.

Owner Owner of the resource. Certain resources owned by the operating system list "System" as the owner. Resources owned by a group have the number (in octal) of the owning group in this field.

Copy Indication of whether the lock is mastered on the local system or is a process copy.

**Table 4-4 Contents of the SHOW LOCK and SHOW PROCESS/LOCKS Displays**
Display Element	Description
Process Index ¹	Index in the PCB array to a pointer to the process control block (PCB) of the process that owns the lock.
Name ¹	Name of the process that owns the lock.
Extended PID ¹	Clusterwide identification of the process that owns the lock.
Lock ID	Identification of the lock.
PID	Systemwide identification of the lock.
Flags	Information specified in the request for the lock.
Par. ID	Identification of the lock's parent lock.
Sublocks	Count of the locks that the lock owns.
LKB	Address of the lock block (LKB). If a blocking AST has been enabled for this lock, the notation "BLKAST" appears next to the LKB address.
Priority	The lock priority.
Granted at	Lock mode at which the lock was granted.
RSB	Address of the resource block.
Resource	Dump of the resource name. The two leftmost columns of the dump show its contents as hexadecimal values, the least significant byte being represented by the rightmost two digits. The rightmost column represents its contents as ASCII text, the least significant byte being represented by the leftmost character.
Status	Status of the lock, information used internally by the lock manager.
Length	Length of the resource name.
Mode	Processor access mode of the namespace in which the resource block (RSB) associated with the lock resides.
Owner	Owner of the resource. Certain resources owned by the operating system list "System" as the owner. Resources owned by a group have the number (in octal) of the owning group in this field.
Copy	Indication of whether the lock is mastered on the local system or is a process copy.

¹This display element is produced only by the SHOW PROCESS/LOCKS command.

Examples

#1
SDA> SHOW LOCKS Lock Database ------------- Lock id: 3E000002 PID: 00000000 Flags: CONVERT NOQUEUE SYNCSTS Par. id: 00000000 SUBLCKs: 0 NOQUOTA CVTSYS LKB: FFFFFFFF.7DF48150 BLKAST: 81107278 Priority: 0000 Granted at CR 00000000-FFFFFFFF RSB: FFFFFFFF.7DF68D50 Resource: 494D6224 42313146 F11B$bMI Status: NOQUOTA VALBLKR VALBLKW Length 18 4D55445F 5944414C LADY_DUM Kernel mode 00000000 00005350 PS...... System 00000000 00000000 ........ Local copy Lock Database ------------- Lock id: 3F000003 PID: 00000000 Flags: VALBLK CONVERT SYNCSTS Par. id: 0100007A SUBLCKs: 0 CVTSYS LKB: FFFFFFFF.7DF48250 BLKAST: 00000000 Priority: 0000 Granted at NL 00000000-FFFFFFFF RSB: FFFFFFFF.7DF51D50 Resource: 01F77324 42313146 F11B$s÷. Status: NOQUOTA VALBLKR VALBLKW Length 10 00000000 00000000 ........ Kernel mode 00000000 00000000 ........ System 00000000 00000000 ........ Local copy Lock Database ------------- Lock id: 0A000004 PID: 0001000F Flags: VALBLK CONVERT SYNCSTS Par. id: 00000000 SUBLCKs: 0 SYSTEM NODLCKW NODLCKB LKB: FFFFFFFF.7DF48350 BLKAST: 81190420 QUECVT Priority: 0000 Granted at EX 00000000-FFFFFFFF RSB: FFFFFFFF.7DF50850 Resource: 004F0FDF 24534D52 RMS$ß.O. Status: VALBLKR VALBLKW Length 26 5F313039 58020000 ...X901_ Exec. mode 00202020 204C354B K5L . System 00000000 00000000 ........ Local copy . . .

SDA>  SHOW LOCKS
Lock Database 
------------- 
 
Lock id:  3E000002            PID:    00000000   Flags: CONVERT NOQUEUE SYNCSTS 
Par. id:  00000000            SUBLCKs:       0          NOQUOTA CVTSYS 
LKB:      FFFFFFFF.7DF48150   BLKAST: 81107278 
Priority:     0000 
 
Granted at    CR   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF68D50 
Resource:          494D6224 42313146  F11B$bMI  Status: NOQUOTA VALBLKR VALBLKW 
 Length   18       4D55445F 5944414C  LADY_DUM 
 Kernel mode       00000000 00005350  PS...... 
 System            00000000 00000000  ........ 
 
Local copy 
 
Lock Database 
------------- 
 
Lock id:  3F000003            PID:    00000000   Flags: VALBLK  CONVERT SYNCSTS 
Par. id:  0100007A            SUBLCKs:       0          CVTSYS 
LKB:      FFFFFFFF.7DF48250   BLKAST: 00000000 
Priority:     0000 
 
Granted at    NL   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF51D50 
Resource:          01F77324 42313146  F11B$s÷.  Status: NOQUOTA VALBLKR VALBLKW 
 Length   10       00000000 00000000  ........ 
 Kernel mode       00000000 00000000  ........ 
 System            00000000 00000000  ........ 
 
Local copy 
 
Lock Database 
------------- 
 
Lock id:  0A000004            PID:    0001000F   Flags: VALBLK  CONVERT SYNCSTS 
Par. id:  00000000            SUBLCKs:       0          SYSTEM  NODLCKW NODLCKB 
LKB:      FFFFFFFF.7DF48350   BLKAST: 81190420          QUECVT 
Priority:     0000 
 
Granted at    EX   00000000-FFFFFFFF 
 
RSB:               FFFFFFFF.7DF50850 
Resource:          004F0FDF 24534D52  RMS$ß.O.  Status: VALBLKR VALBLKW 
 Length   26       5F313039 58020000  ...X901_ 
 Exec. mode        00202020 204C354B  K5L    . 
 System            00000000 00000000  ........ 
 
Local copy 
 
   .
   .
   .

#2
SDA> SHOW RESOURCES/LOCKID=0A000004 Resource Database ----------------- RSB: FFFFFFFF.7DF50850 GGMODE: EX Status: DIRENTR VALID Parent RSB: 00000000.00000000 CGMODE: EX Sub-RSB count: 0 FGMODE: EX Lock Count: 1 RQSEQNM: 0000 BLKAST count: 1 CSID: 00000000 (MILADY) Resource: 004F0FDF 24534D52 RMS$ß.O. Valblk: 00000000 00000000 Length 26 5F313039 58020000 ...X901_ 00000000 00000000 Exec. mode 00202020 204C354B K5L . System 00000000 00000000 ........ Seqnum: 00000000 Granted queue (Lock ID / Gr mode / Range): 0A000004 EX 00000000-FFFFFFFF Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range): * EMPTY QUEUE * Waiting queue (Lock ID / Rq mode / Range): * EMPTY QUEUE *

SDA>  SHOW RESOURCES/LOCKID=0A000004
Resource Database 
----------------- 
RSB:         FFFFFFFF.7DF50850  GGMODE:     EX  Status: DIRENTR VALID 
Parent RSB:  00000000.00000000  CGMODE:     EX 
Sub-RSB count:      0           FGMODE:     EX 
Lock Count:         1           RQSEQNM:  0000 
BLKAST count:       1           CSID: 00000000  (MILADY) 
 
Resource:          004F0FDF 24534D52  RMS$ß.O.  Valblk: 00000000 00000000 
 Length   26       5F313039 58020000  ...X901_          00000000 00000000 
 Exec. mode        00202020 204C354B  K5L    . 
 System            00000000 00000000  ........  Seqnum: 00000000 
 
Granted queue (Lock ID / Gr mode / Range): 
 0A000004  EX 00000000-FFFFFFFF 
 
Conversion queue (Lock ID / Gr mode / Range -> Rq mode / Range): 
     *** EMPTY QUEUE *** 
 
Waiting queue (Lock ID / Rq mode / Range): 
     *** EMPTY QUEUE ***

This SDA session shows the output of the SHOW LOCKS command for several locks. The SHOW RESOURCES command, executed for the last displayed lock, verifies that the lock is in the resource's granted queue. (See Table 4-21 for a full explanation of the contents of the display of the SHOW RESOURCES command.)

This example shows the brief display for all locks with a blocking AST.

SHOW MACHINE_CHECK

Displays the contents of the stored machine check frame. This command is valid for the DEC 4000 Alpha, DEC 7000 Alpha, and DEC 10000 Alpha computers only.

Format

SHOW MACHINE_CHECK [/FULL] [cpu-id]

Parameter

cpu-id
Numeric value from 00 to 1F₁₆ indicating the identity of the CPU for which context information is to be displayed. This parameter changes the SDA current CPU (the default) to the CPU specified with cpu-id. If you specify a value outside this range, or you specify the cpu-id of a processor that was not active at the time of the system failure, SDA displays the following message:
%SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range
If you use the cpu-id parameter, the SHOW MACHINE_CHECK command performs an implicit SET CPU command, making the CPU indicated by cpu-id the current CPU for subsequent SDA commands. (See the description of the SET CPU command and Chapter 2, Section 2.5 for information on how this can affect the CPU context---and process context---in which SDA commands execute.)

Qualifier

/FULL
Specifies that a detailed version of the machine check information be displayed. This is currently identical to the default summary display.

Description

The SHOW MACHINE_CHECK command displays the contents of the stored machine check frame. A separate frame is allocated at boot time for every CPU in a multiple-CPU system. This command is valid for the DEC 4000 Alpha, DEC 7000 Alpha, and DEC 10000 Alpha computers only.
If you do not specify a qualifier, a summary version of the machine check frame is displayed.
The default cpu-id is the SDA current CPU.

Examples

#1
SDA> SHOW MACHINE_CHECK CPU 00 Stored Machine Check Crash Data -------------------------------------- Processor specific information: ------------------------------- Exception address: FFFFFFFF.800B0250 Exception Summary: 00000000.00000000 Pal base address: 00000000.00008000 Exception Mask: 00000000.00000000 HW Interrupt Request: 00000000.00000342 HW Interrupt Ena: 00000001.FFC01CE0 MM_CSR 00000000.00003640 ICCSR: 00000002.381F0000 D-cache address: 00000007.FFFFFFFF D-cache status: 00000000.000002E0 BIU status: 00000000.00000050 BIU address [7..0]: 00000000.000060E0 BIU control: 00000008.50006447 Fill Address: 00000000.00006120 Single-bit syndrome: 00000000.00000000 Processor mchck VA: 00000000.00006190 A-box control: 00000000.0000040E B-cache TAG: 00106100.83008828 System specific information: ---------------------------- Garbage bus info: 00200009 00000038 Device type: 000B8001 LCNR: 00000001 Memory error: 00000000 LBER: 00000009 Bus error synd 0,1: 00000000 00000000 Bus error cmd: 00048858 00AB1C88 Bus error synd 2,3: 00000000 0000002C LEP mode: 00010010 LEP lock address: 00041108

SDA> SHOW MACHINE_CHECK 
CPU 00 Stored Machine Check Crash Data
--------------------------------------
Processor specific information: 
------------------------------- 
Exception address:    FFFFFFFF.800B0250    Exception Summary:  00000000.00000000 
Pal base address:     00000000.00008000    Exception Mask:     00000000.00000000 
HW Interrupt Request: 00000000.00000342    HW Interrupt Ena:   00000001.FFC01CE0 
MM_CSR                00000000.00003640    ICCSR:              00000002.381F0000 
D-cache address:      00000007.FFFFFFFF    D-cache status:     00000000.000002E0 
BIU status:           00000000.00000050    BIU address [7..0]: 00000000.000060E0 
BIU control:          00000008.50006447    Fill Address:       00000000.00006120 
Single-bit syndrome:  00000000.00000000    Processor mchck VA: 00000000.00006190 
A-box control:        00000000.0000040E    B-cache TAG:        00106100.83008828 
System specific information: 
---------------------------- 
Garbage bus info:     00200009 00000038    Device type:                 000B8001 
LCNR:                          00000001    Memory error:                00000000 
LBER:                          00000009    Bus error synd 0,1: 00000000 00000000 
Bus error cmd:        00048858 00AB1C88    Bus error synd 2,3: 00000000 0000002C 
LEP mode:                      00010010    LEP lock address:            00041108

The SHOW MACHINE_CHECK command in this SDA display shows the contents of the stored machine check frame.

#2
SDA> SHOW MACHINE_CHECK 1 CPU 01 Stored Machine Check Crash Data -------------------------------------- Processor specific information: ------------------------------- Exception address: FFFFFFFF.800868A0 Exception Summary: 00000000.00000000 Pal base address: 00000000.00008000 Exception Mask: 00000000.00000000 HW Interrupt Request: 00000000.00000342 HW Interrupt Ena: 00000000.1FFE1CE0 MM_CSR 00000000.00005BF1 ICCSR: 00000000.081F0000 D-cache address: 00000007.FFFFFFFF D-cache status: 00000000.000002E0 BIU status: 00000000.00000050 BIU address [7..0]: 00000000.000063E0 BIU control: 00000008.50006447 Fill Address: 00000000.00006420 Single-bit syndrome: 00000000.00000000 Processor mchck VA: 00000000.00006490 A-box control: 00000000.0000040E B-cache TAG: 35028EA0.50833828 System specific information: ---------------------------- Garbage bus info: 00210001 00000038 Device type: 000B8001 LCNR: 00000001 Memory error: 00000080 LBER: 00040209 Bus error synd 0,1: 00000000 00000000 Bus error cmd: 00048858 00AB1C88 Bus error synd 2,3: 00000000 0000002C LEP mode: 00010010 LEP lock address: 00041108

SDA> SHOW MACHINE_CHECK 1
CPU 01 Stored Machine Check Crash Data 
--------------------------------------
Processor specific information: 
------------------------------- 
Exception address:    FFFFFFFF.800868A0    Exception Summary:  00000000.00000000 
Pal base address:     00000000.00008000    Exception Mask:     00000000.00000000 
HW Interrupt Request: 00000000.00000342    HW Interrupt Ena:   00000000.1FFE1CE0 
MM_CSR                00000000.00005BF1    ICCSR:              00000000.081F0000 
D-cache address:      00000007.FFFFFFFF    D-cache status:     00000000.000002E0 
BIU status:           00000000.00000050    BIU address [7..0]: 00000000.000063E0 
BIU control:          00000008.50006447    Fill Address:       00000000.00006420 
Single-bit syndrome:  00000000.00000000    Processor mchck VA: 00000000.00006490 
A-box control:        00000000.0000040E    B-cache TAG:        35028EA0.50833828 
System specific information: 
---------------------------- 
Garbage bus info:     00210001 00000038    Device type:                 000B8001 
LCNR:                          00000001    Memory error:                00000080 
LBER:                          00040209    Bus error synd 0,1: 00000000 00000000 
Bus error cmd:        00048858 00AB1C88    Bus error synd 2,3: 00000000 0000002C 
LEP mode:                      00010010    LEP lock address:            00041108

The SHOW MACHINE_CHECK command in this SDA display shows the contents of the stored machine check frame for cpu-id 01.

SHOW MEMORY

Displays the availability and usage of memory resources.

Format

SHOW MEMORY [/ALL][/BUFFER_OBJECTS][/CACHE][/FILES]
[/FULL][/GH_REGIONS][/PHYSICAL_PAGES][/POOL]
[/RESERVED][/SLOTS]

Parameters

None.

Qualifiers

/ALL
Displays all available information, that is, information displayed by the following qualifiers:
/BUFFER_OBJECTS
/CACHE
/FILES
/GH_REGIONS
/PHYSICAL_PAGES
/POOL
/RESERVED
/SLOTS

This is the default display.
/BUFFER_OBJECTS
Displays information about system resources used by buffer objects.
/CACHE
Displays information about either the Virtual I/O Cache facility, or the Extended File Cache facility. The system parameter VCC_FLAGS determines which is used. The cache facility information is displayed as part of the SHOW MEMORY and SHOW MEMORY/CACHE/FULL commands.
/FILES
Displays information about the use of each paging and swapping file currently installed.
/FULL
Displays additional information about each pool area or paging or swapping file currently installed, when used with the /POOL or the /FILES qualifier. This qualifier is ignored unless the /FILES or the /POOL qualifier is specified explicitly. When used with the /CACHE qualifier, /FULL displays additional information about the use of the Virtual I/O Cache facility, but is ignored if the Extended File Cache facility is in use.
/GH_REGIONS
Displays information about the granularity hint regions (GHR) that have been established. For each of these regions, information is displayed about the size of the region, the amount of free memory, the amount of memory in use, and the amount of memory released to OpenVMS from the region. The granularity hint regions information is also displayed as part of SHOW MEMORY, SHOW MEMORY/ALL, and SHOW MEMORY/FULL commands.
/PHYSICAL_PAGES
Displays information about the amount of physical memory and the number of free and modified pages.
/POOL
Displays information about the usage of each dynamic memory (pool) area, including the amount of free space and the size of the largest contiguous block in each area.
/RESERVED
Displays information about memory reservations.
/SLOTS
Displays information about the availability of partition control block (PCB) vector slots and balance slots.

Description

For more details on the SHOW MEMORY command, see the description in OpenVMS DCL Dictionary: N--Z.

SHOW PAGE_TABLE

Displays a range of system page table entries, the entire system page table, or the entire global page table.

Format

SHOW PAGE_TABLE {range|/FREE [/HEADER=address]
|/GLOBAL|/GPT|/PT
|/INVALID_PFN [=option]
|/NONMEMORY_PFN [=option]
|/PTE_ADDRESS|/SECTION_INDEX=n
|/S0S1 (d)|/S2|/SPTW|=ALL}
{/L1|/L2|/L3 (d)}

Parameter

range
Range of virtual addresses or PTE addresses for which SDA displays page table entries. If the qualifier /PTE_ADDRESS is given, then the range is of PTE addresses; otherwise, the range is of virtual addresses.
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

Qualifiers

/FREE
Causes the starting addresses and sizes of blocks of pages in the free page list to be displayed. The qualifiers /S0S1 (default), /S2, /GLOBAL, and /HEADER determine which free page list is to be displayed.
/GLOBAL
Lists the global page table. When used with the /FREE qualifier, /GLOBAL indicates the free page list to be displayed.
/HEADER=address
When used with the /FREE qualifier, the /HEADER=address qualifier displays the free list for the specified private page table.
/GPT
Specifies the portion of page table space that maps the global page table as the address range.
/INVALID_PFN [=option]
The /INVALID_PFN qualifier, which is valid 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, nor in Galaxy shared memory, nor are I/O access pages.
See the /NONMEMORY_PFN qualifier definition for a description of the options.
/L1
Lists the Level 1 page table entries for the portion of memory specified.
/L2
Lists the Level 2 page table entries for the portion of memory specified.
/L3
Lists the Level 3 page table entries for the portion of memory specified. This qualifier is the default level.
/NONMEMORY_PFN [=option]
The /NONMEMORY_PFN qualifier, supported on all platforms, causes SDA to display only page table entries that are neither in the system's private memory nor in Galaxy shared memory.
Both /INVALID_PFN and /NONMEMORY_PFN qualifiers allow two optional keywords, READONLY and WRITABLE. If neither keyword is given, all relevant pages are displayed. If READONLY is given, only pages marked for no write access are displayed. If WRITABLE is given, only pages that allow write access are displayed. For example, SHOW PAGE_TABLE=ALL/INVALID_PFN=WRITABLE would display all system pages whose protection allows write, but which map to PFNs that do not belong to this system.
/PT
Specifies page table space, as viewed from system context, as the address range.
/PTE_ADDRESS
Specifies that the range given is of PTE addresses instead of the virtual addresses mapped by the PTEs.
/SECTION_INDEX=n
Displays the page table for the range of pages in the global section or pageable part of a loaded image. For pageable portions of loaded images, one of the qualifiers /L1, /L2, or /L3 can also be specified.
/S0S1
Specifies S0 and S1 space as the address range. When used with the /FREE qualifer, /S0S1 indicates the free page list to be displayed. This is the default portion of memory or free page list to be displayed.
/S2
Specifies S2 space as the address range. When used with the /FREE qualifier, /S2 indicates the free page list to be displayed.
/SPTW
Displays the contents of the system page table window.

Option

=ALL
The SHOW PAGE = ALL command displays the page table entries for all shared (system) addresses, without regard to the section of memory being referenced. It is equivalent to specifying all of /S0S1, /S2, /SPTW, /PT, /GPT, and /GLOBAL. This option can be qualified by only one of the /L1, /L2, or /L3 qualifiers.

Description

If the /FREE qualifier is not specified, this command displays page table entries for the specified range of addresses or section of memory. For each virtual address displayed by the SHOW PAGE_TABLE command, the first eight columns of the listing provide the associated page table entry and describe its location, characteristics, and contents. SDA obtains this information from the system page table. Table 4-5 describes the information displayed by the SHOW PAGE_TABLE command.
If the /FREE qualifier is specified, this command displays the free PTE list for the specified section of memory.
Note that the /L1, /L2, and /L3 qualifiers are ignored when used with the /FREE, /GLOBAL, and /SPTW qualifiers.

Table 4-5 Virtual Page Information in the SHOW PAGE_TABLE Display
Value Meaning

MAPPED ADDRESS Virtual address that marks the base of the virtual page(s) mapped by the PTE.

PTE ADDRESS Virtual address of the page table entry that maps the virtual page(s).

PTE Contents of the page table entry, a quadword that describes a system virtual page.

TYPE Type of virtual page. Table 4-6 shows the eight types and their meanings.

READ A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which read access is granted.

WRIT A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which write access is granted.

BITS Letters that represent the setting of a bit or a combination of bits in the PTE. These bits indicate attributes of a page. Table 4-7 shows the codes and their meanings.

GH Contents of granularity hint bits.

Table 4-6 Type of Virtual Pages
Type Meaning

VALID Valid page (in main memory).

TRANS Transitional page (on free or modified page list).

DZERO Demand-allocated, zero-filled page.

PGFIL Page within a paging file.

STX Section table's index page.

GPTX Index page for a global page table.

IOPAG Page in I/O address space.

NXMEM Page not represented in physical memory. The page frame number (PFN) of this page is not mapped by any of the system's memory controllers. This indicates an error condition.

Table 4-7 Bits In the PTE
Code Meaning

A Address space match is set.

M Page has been modified.

L Page is locked into a working set.

K Owner is kernel mode.

E Owner is executive mode.

S Owner is supervisor mode.

U Owner is user mode.

Previous Next Contents Index

privacy and legal statement

6549PRO_014.HTML

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

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

Value	Meaning
MAPPED ADDRESS	Virtual address that marks the base of the virtual page(s) mapped by the PTE.
PTE ADDRESS	Virtual address of the page table entry that maps the virtual page(s).
PTE	Contents of the page table entry, a quadword that describes a system virtual page.
TYPE	Type of virtual page. Table 4-6 shows the eight types and their meanings.
READ	A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which read access is granted.
WRIT	A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which write access is granted.
BITS	Letters that represent the setting of a bit or a combination of bits in the PTE. These bits indicate attributes of a page. Table 4-7 shows the codes and their meanings.
GH	Contents of granularity hint bits.

Type	Meaning
VALID	Valid page (in main memory).
TRANS	Transitional page (on free or modified page list).
DZERO	Demand-allocated, zero-filled page.
PGFIL	Page within a paging file.
STX	Section table's index page.
GPTX	Index page for a global page table.
IOPAG	Page in I/O address space.
NXMEM	Page not represented in physical memory. The page frame number (PFN) of this page is not mapped by any of the system's memory controllers. This indicates an error condition.

Code	Meaning
A	Address space match is set.
M	Page has been modified.
L	Page is locked into a working set.
K	Owner is kernel mode.
E	Owner is executive mode.
S	Owner is supervisor mode.
U	Owner is user mode.

OpenVMS Alpha System Analysis Tools Manual

SHOW LOCKS

Format

Parameter

lock-id

Qualifiers

/ADDRESS=n

/ALL

/BLOCKING

/BRIEF

/CACHED

/CONVERT

/GRANTED

/NAME=name

/POOL

/STATUS=(keyword[,keyword...])

/SUMMARY

/WAITING

Description

Examples

SHOW MACHINE_CHECK

Format

Parameter

cpu-id

Qualifier

/FULL

Description

Examples

SHOW MEMORY

Format

Parameters

Qualifiers

/ALL

/BUFFER_OBJECTS

/CACHE

/FILES

/FULL

/GH_REGIONS

/PHYSICAL_PAGES

/POOL

/RESERVED

/SLOTS

Description

SHOW PAGE_TABLE

Format

Parameter

range

Qualifiers

/FREE

/GLOBAL

/HEADER=address

/GPT

/INVALID_PFN [=option]

/L1

/L2

/L3

/NONMEMORY_PFN [=option]

/PT

/PTE_ADDRESS

/SECTION_INDEX=n

/S0S1

/S2

/SPTW

Option

=ALL

Description