[OpenVMS documentation]
[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
Updated: 11 December 1998

OpenVMS VAX System Dump Analyzer Utility Manual


Previous Contents Index

The SHOW LAN/FULL command in this example displays information for all LAN, LSB, and UCB data structures.
#6

SDA> SHOW LAN/TIMESTAMPS
LAN Data Structures
-------------------
             -- LAN History Information 19-JUL-1993 14:27:38 --
19-JUL 14:27:38.93  EZA               Last receive
19-JUL 14:27:38.93  EZA               Last fork scheduled
19-JUL 14:27:38.93  EZA               Last fork time
19-JUL 14:27:36.05  EZA               Last transmit
19-JUL 14:27:36.05  EZA1     DECNET   Last transmit
19-JUL 14:23:54.41  EZA164   DIAG     Last start completed
19-JUL 08:05:16.09  EZA               Last excessive collision
19-JUL 06:40:22.94  EZA1     DECNET   Last start completed
19-JUL 06:40:21.94  EZA               Last DAT transmit
 
      

The SHOW LAN command displays LAN timestamp information.

SHOW LOCK

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


Format

SHOW LOCK {lock-id|/ALL|/CACHED|/NAME=resource-name}


Parameters

lock-id

Name of a specific lock. You cannot specify both a lock-id and a resource-name in the same command line.

Qualifiers

/ALL

Lists all locks that exist in the system. This is the default behavior of the SHOW LOCK command.

/CACHED

Shows only cached lock blocks (LKBs).

/NAME=resource-name

Displays information about the resource associated with the lock whose resource name begins with the specified resource-name. For case-sensitive names, enclose the resource-name in quotation marks. You cannot specify both a lock-id and resource-name in the same command line.

Description

The SHOW LOCK command displays the information described in Table SDA-15 for each lock management lock in the system or for the lock indicated by lock-id. (Use the SHOW SPINLOCK command to display information about spin locks.) 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 System Services Reference Manual for additional discussion of the significance of this information.

You can display information about the resource to which a lock is queued by issuing the SHOW RESOURCE command and specifying the lock-id of the resource.

Table SDA-15 Contents of the SHOW LOCK and SHOW PROCESS/LOCKS Displays
Display Element Description
Process Index 1 Index into the PCB array to a pointer to the process control block (PCB) of the process that owns the lock.
Name 1 Name of the process that owns the lock.
Extended PID 1 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.
Granted at Lock mode at which the lock was granted.
Sublocks Identification numbers 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.
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.
--- Processor access mode of the name space in which the resource block (RSB) associated with the lock resides.
--- 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.
--- Indication of whether the lock is mastered on the local system or is a process copy.


1You produce this display element only by using the SHOW PROCESS/LOCKS command.


Examples

#1

SDA> SHOW LOCK
Lock database
-------------
  
Lock id:  00010001   PID:    00000000   Flags:   NOQUEUE SYNCSTS SYSTEM
Par. id:  00000000   Granted at    EX            CVTSYS
Sublocks:        1
LKB:      80D0B8A0
Resource:      5F535953 24535953    SYS$SYS_  Status:  NOQUOTA
 Length   16   00000000 4C774449    IDwL....
 Exec. mode    00000000 00000000    ........
 System        00000000 00000000    ........
Local copy
  
  
Lock id:  00010004   PID:    00000000   Flags:   CONVERT SYNCSTS CVTSYS
Par. id:  00000000   Granted at    CR
Sublocks:       16
LKB:      80D091A0   BLKAST
Resource:      4D567624 42313146    F11B$vVM  Status:  NOQUOTA
 Length   18   20204E41 4A353153    S15JAN
 Kernel mode   00000000 00002020      ......
 System        00000000 00000000    ........
Local copy
  
  
Lock id:  00280009   PID:    00000000   Flags:   VALBLK  CONVERT SYNCSTS
Par. id:  00000000   Granted at    CR            NOQUOTA CVTSYS
Sublocks:        0
LKB:      80CDA880
Resource:      52414B5F 24535953    SYS$_KAR  Status:  MSTCPY
 Length   17   30415544 24455441    ATE$DUA0
 Kernel mode   00000000 0000003A    :.......
 System        00000000 00000000    ........
Master copy of lock 001C00F5 on system 000100A1
   .
   .
   .
SDA>  SHOW RESOURCE/LOCK=280009
Resource database
-----------------
Address of RSB:  80BD2150  Group grant mode:       CR
Parent RSB:      00000000  Conversion grant mode:  CR
Sub-RSB count:          0  BLKAST count:            0
Value block:   00000000 00000000 00000000 00000019   Seq. #:  0000002D
Resource:      52414B5F 24535953    SYS$_KAR 
 Length   17   30415544 24455441    ATE$DUA0         CSID:  00000000
 Kernel mode   00000000 0000003A    :.......
 System        00000000 00000000    ........
  
Granted queue (Lock ID / Gr mode):
     00DA1269  CR       00280009  CR       0094054D  CR
     00270B9F  CR       00D70BFE  CR       000D0F4F  CR
     000D1017  CR       00601418  CR       01131450  CR
     000F1964  CR       000200DF  CR
  
Conversion queue (Lock ID / Gr/Rq mode):
     *** EMPTY QUEUE ***
 
Waiting queue (Lock ID / Rq mode):
     *** EMPTY QUEUE ***
 
      

This SDA session shows the output of the SHOW LOCK command for several locks. The SHOW RESOURCE command, executed for the last displayed lock, verifies that the lock is in the resource's granted queue, among many other locks given concurrent read (CR) access to the resource. (See Table SDA-21 for a full explanation of the contents of the display of the SHOW RESOURCE command.)

#2

SDA SHOW LOCK/CACHE
Lock database 
------------- 
 
Lock id:  6D000032   PID:     00010028   Flags:   VALBLK  SYNCSTS SYSTEM  
Par. id:  01000002   SUBLCKs:        0            NOQUOTA                 
LKB:   80F67C00   BLKAST:  00000000                                   
PRIORTY:      0000                                                        
 
Granted at      PW   00000000-FFFFFFFF 
 
Resource:      00257324 42313146    F11B$s%.  Status:  NOQUOTA CACHED          
 Length   10   00000000 00000000    ........                                   
 Kernel mode   00000000 00000000    ........                                   
 System        00000000 00000000    ........                                   
 
Local copy  
 
Lock id:  7B00003B   PID:     0001000B   Flags:   VALBLK  SYNCSTS SYSTEM  
Par. id:  01000002   SUBLCKs:        0            NOQUOTA                 
LKB:   80F51F80   BLKAST:  00000000                                   
PRIORTY:      0000                                                        
 
Granted at      PW   00000000-FFFFFFFF 
 
Resource:      08E97324 42313146    F11B$sé.  Status:  NOQUOTA CACHED          
 Length   10   00000000 00000000    ........                                   
 Kernel mode   00000000 00000000    ........                                   
 System        00000000 00000000    ........                                   
 
   .
   .
   .
Local copy  
 
      

This example of the SHOW LOCK/CACHE command displays the contents of cached lock blocks (LKBs).

SHOW LOGS

Displays information about transaction logs currently open for the node.

Format

SHOW LOGS [/qualifier[,...]]


Qualifier

/DISPLAY=(item [,...])

Specifies the type of information to be displayed. The argument to /DISPLAY can be either a single item or a list. The following items can be specified.
Item Description
ALL All transaction log control structure information. This is the default behavior.
OPENS Transaction log open requests.
READS Transaction log read requests.
WRITES Transaction log write requests.

Example


SDA> SHOW LOGS/DISPLAY=(OPENS, WRITES)
      

The SHOW LOGS command displays the log open request and log write request information for all open transaction logs for the node.

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 [/qualifier[,...]] [range]


Parameter

range

Range of virtual addresses for which SDA is to display page table entries. You can express a range using the following format:
m:n Range of virtual addresses from m to n
m;n Range of virtual addresses starting at m and continuing for n bytes

Qualifiers

/GLOBAL

Lists the global page table.

/SYSTEM

Lists the system page table.

/ALL

Lists both the global and system page tables. This is the default behavior of SHOW PAGE_TABLE.

Description

For each virtual address displayed by the SHOW PAGE_TABLE command, the first six columns of the listing provide the associated page table entry and describe its location, characteristics, and contents (see Table SDA-16). SDA obtains this information from the system page table.

If the virtual page has been mapped to a physical page, the last nine columns of the listing include information from the page frame number (PFN) database (see Table SDA-17). Otherwise, the section is left blank.

SDA indicates pages are inaccessible by displaying the following message:


-------- n NULL PAGES 
Here, n indicates the number of inaccessible pages.

Table SDA-16 Virtual Page Information in the SHOW PAGE_TABLE Display
Value Meaning
ADDRESS System virtual address that marks the base of the virtual page.
SVAPTE System virtual address of the page table entry that maps the virtual page.
PTE Contents of the page table entry, a longword that describes a system virtual page.
Type Type of virtual page. There are the following eight types:
  • VALID

    Valid page (in main memory).

  • TRANS

    Transitional page (between main memory and page lists).

  • 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.

PROT Protection code, derived from bits in the PTE, that designates the type of access (read or write, or both) granted to processor access modes (kernel, executive, supervisor, or user).
Bits Letters that represent the setting of a bit or a combination of bits in the PTE. These bits indicate attributes of a page. The following codes are listed:
  • M

    Page has been modified.

  • L

    Page is locked into a working set.

  • K

    Owner can access the page in kernel mode.

  • E

    Owner can access the page in executive mode.

  • S

    Owner can access the page in supervisor mode.

  • U

    Owner can access the page in user mode.

Table SDA-17 Physical Page Information in the SHOW PAGE_TABLE Display
Category Meaning
PAGTYP Type of physical page. One of the following six types:
  • PROCESS

    Page is part of process space.

  • SYSTEM

    Page is part of system space.

  • GLOBAL

    Page is part of a global section.

  • PPGTBL

    Page is part of a process's page table.

  • GPGTBL

    Page is part of a global page table.

  • GBLWRT

    Page is part of a global, writable section.

LOC Location of the page within the system. One of the following eight locations:
  • ACTIVE

    Page is in a working set.

  • MDFYLST

    Page is in the modified page list.

  • FREELST

    Page is in the free page list.

  • BADLST

    Page is in the bad page list.

  • RELPEND

    Release of the page is pending.

  • RDERROR

    Page has had an error during an attempted read operation.

  • PAGEOUT

    Page is being written into a paging file.

  • PAGEIN

    Page is being brought into memory from a paging file.

STATE Byte that describes the state of the physical page.
TYPE Byte that describes the type of virtual page. The types in this column are the hexadecimal codes that stand for the page types that appear in column PAGTYP of this display, described previously.
REFCOUNT Count of the processes that are referencing this PFN. If the value of REFCOUNT is nonzero, the page is used in at least one working set. If the value is zero, the page is not used in any working set.
BAK Address of the backing store; location on a disk device to which pages can be written.
SVAPTE Virtual address associated with this page frame. The two SVAPTEs indicate a valid link between physical and virtual address space.
FLINK Forward link within PFN database that points to the next virtual page. This longword also acts as the count of the number of processes that are sharing this global section.
BLINK Backward link within PFN database. Also acts as an index into the working set list.


Example


SDA>SHOW PAGE_TABLE
System page table 
----------------- 
 
ADDRESS  SVAPTE   PTE      TYPE  PROT  BITS PAGTYP LOC  STATE TYPE REFCNT BAK     SVAPTE    FLINK      BLINK 
   .
   .
   .
8014B000 8AD22E00 F8020725 VALID UR       K 
8014B200 8AD22E04 F8020726 VALID UR       K 
8014B400 8AD22E08 F8020727 VALID UR       K 
8014B600 8AD22E0C F8020728 VALID UR       K 
8014B800 8AD22E10 F8020729 VALID UR       K 
8014BA00 8AD22E14 EC02072A VALID UREW  M  K 
8014BC00 8AD22E18 F402072B VALID URKW  M  K 
   .
   .
   .
8014BE00 8AD22FEC F801F10E VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD22FEC  00000000  00000258 
8014C000 8AD22FF0 F801F10F VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD22FF0  00000000  00000257 
8014C200 8AD22FF4 F801F173 VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD22FF4  00000000  000004B1 
8014C400 8AD22FF8 F801F172 VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD22FF8  00000000  00000301 
8014C600 8AD22FFC F801F17F VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD22FFC  00000000  000000F5 
8014C800 8AD23000 F801F17E VALID UR       K SYSTEM ACTIVE  07  01   1 0040FFF8   8AD23000  00000000  00000174 
8014CA00 8AD23004 7801EBC6 TRANS UR       K SYSTEM FREELST 00  01   0 0040FFF8   8AD23004  0000D38B  0001EBC7 
   .
   .
   .
      

SHOW PFN_DATA

Displays information that is contained in the page lists and PFN database.

Format

SHOW PFN_DATA [pfn] [/qualifier]


Parameter

pfn

Page frame number (PFN) of the physical page for which information is to be displayed.

Qualifiers

/ALL

Displays the free page list, modified page list, and bad page list. This is the default behavior of the SHOW PFN_DATA command. SDA precedes each list with a count of the pages it contains and its low and high limits.

/BAD

Displays the bad page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/FREE

Displays the free page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/MODIFIED

Displays the modified page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/SYSTEM

Displays the entire PFN database in order by page frame number, starting at PFN 0000.

Description

For each page frame number it displays, the SHOW PFN_DATA command lists information used in translating physical page addresses to virtual page addresses. Table SDA-18 lists the contents of the display.

Table SDA-18 Page Frame Number Information in the SHOW PFN_DATA Display
Item Contents
PFN Page frame number
PTE ADDRESS System virtual address of the page table entry that describes the virtual page mapped into this physical page
BAK Place to find context, as information about this page when all links to this PTE are broken: either an index into a process section table or the number of a virtual block in the paging file
REFCNT Number of references being made to this page
FLINK Address of the next page in the list in which this virtual page currently resides
BLINK Address of the previous page in the list in which this virtual page currently resides
TYPE Type of virtual page; one of the following:
  • 00

    Process page

  • 01

    System page

  • 02

    Global, read-only page

  • 03

    Global, read/write page

  • 04

    Process page-table page

  • 05

    Global page-table page

STATE State of the virtual page, the low nibble of which can be one of the following:
  • 0

    Page is on the free page list.

  • 1

    Page is on the modified page list.

  • 2

    Page is on the bad page list.

  • 3

    Release of the page to the free or modified page list is pending.

  • 4

    Error occurred as the page was being read from the disk.

  • 5

    Modified page writer is currently writing the page to the disk.

  • 6

    Page fault handler is currently reading the page from the disk.

  • 7

    Page is active and valid.


Example


SDA>SHOW PFN_DATA
Free page list
--------------
Count:             225
Low limit:          57
High limit: 1073741824
PFN   PTE ADDRESS   BAK     REFCNT FLINK BLINK    TYPE        STATE
----  ----------- --------  ------ ----- -----  ----------  ----------
1329    8047AF3C  03002A83      0   1963 0000   00 PROCESS  00 FREELST
1963    8047AB10  03002A43      0   017C 1329   00 PROCESS  00 FREELST
017C    8047B3F8  03002A84      0   14B4 1963   00 PROCESS  00 FREELST
14B4    8047B464  03002A85      0   1529 017C   00 PROCESS  00 FREELST
1529    8047AA34  03002A87      0   1485 14B4   00 PROCESS  00 FREELST
1485    8047AC80  030010B3      0   1707 1529   00 PROCESS  00 FREELST
   .
   .
   .
 
      

In this example, the SHOW PFN_DATA command displays the information for the free page list, the modified page list, and the bad page list, and then all of the PFN database, including the first three lists.


Previous Next Contents Index

[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
[OpenVMS documentation]

Copyright © Compaq Computer Corporation 1998. All rights reserved.

Legal
4556PRO_012.HTML