HP OpenVMS System Analysis Tools Manual

Contents

Index

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 when used with the /POOL qualifier. This qualifier is ignored unless you specify the /POOL qualifier. 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 information about the SHOW MEMORY command, see the description in the HP 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. The range given can be of process-space 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

Note that OpenVMS Alpha and I64 page protections are slightly different. For additional information, see Section 2.8.

Qualifiers

/FREE
Causes the starting addresses and sizes of blocks of pages in the free PTE list to be displayed. The qualifiers /S0S1 (default), /S2, /GLOBAL, and /HEADER determine which free PTE list is to be displayed. A range cannot be specified, and no other qualifiers can be combined with /FREE.
/GLOBAL
Lists the global page table. When used with the /FREE qualifier, /GLOBAL indicates the free PTE list to be displayed.
/HEADER=address
When used with the /FREE qualifier, the /HEADER=address qualifier displays the free PTE 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 only on platforms that supply an I/O memory map, causes SDA to display only page table entries that map to PFNs that are in neither the system's private memory, nor 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 causes SDA to display only page table entries that are in neither the system's private memory nor 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 PTE list to be displayed. This is the default portion of memory or free PTE list to be displayed.
/S2
Specifies S2 space as the address range. When used with the /FREE qualifier, /S2 indicates the free PTE 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, or by /INVALID_PFN or /NONMEMORY_PFN.

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 or from the process page table if a process_space address is given. Table 4-7 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.
The /L1, /L2, and /L3 qualifiers are ignored when used with the /FREE, /GLOBAL, and /SPTW qualifiers.

Table 4-7 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-8 shows the eight types and their meanings.

READ (Alpha only.) 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 (Alpha only.) 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.

MLOA (Alpha only.) 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-9 shows the codes and their meanings.

AR/PL (I64 only.) The access rights and privilege level of the page. Consists of a number (0-7) and a letter (K, E, S, or U) that determines access to a page in each mode.

KESU (I64 only.) The access allowed to the page in each mode. This is an interpretation of the AR/PL values in the previous column. For an explanation of the access codes, see Section 2.8, Page Protections and Access Rights.

MLO (I64 only.) 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-9 shows the codes and their meanings.

GH Contents of granularity hint bits.

Table 4-8 Types 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-9 Bits In the PTE
Column Name Code Meaning

M M Page has been modified.

L L Page is locked into a working set.

L P Page is locked in physical memory.

O K Owner is kernel mode.

O E Owner is executive mode.

O S Owner is supervisor mode.

O U Owner is user mode.

A A Address space match is set (Alpha only).

If the virtual page has been mapped to a physical page, the last five columns of the listing include information from the page frame number (PFN) database; otherwise, the section is left blank. Table 4-10 describes the physical page information displayed by the SHOW PAGE_TABLE command.

Table 4-10 Physical Page Information in the SHOW PAGE_TABLE Display
Category Meaning

PGTYP Type of physical page. Table 4-11 shows the types of physical pages.

LOC Location of the page within the system. Table 4-12 shows the possible locations with their meaning.

BAK Place to find information on 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.

WSLX Working Set List Index. This shows as zero for resident and global pages, and is left blank for transition pages.

Table 4-11 Types of Physical Pages
Page Type Meaning

PROCESS Page is part of process space.

SYSTEM Page is part of system space.

GLOBAL Page is part of a global section.

GBLWRT Page is part of a global, writable section.

PPGTBL Page is part of a process page table.

GPGTBL Page is part of a global page table.

PHD ¹ Page is part of a process PHD.

PPT(Ln) ¹ Page is a process page table page at level n.

SPT(Ln) ² Page is a system page table page at level n.

SHPT ³ Page is part of a shared page table.

PFNLST ² Page is in a Shared Memory Common Property Partition PFN database.

SHM_REG ³ Page is in a Shared Memory Region.

UNKNOWN Unknown.

**Table 4-7 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-8 shows the eight types and their meanings.
READ	(Alpha only.) 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	(Alpha only.) 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.
MLOA	(Alpha only.) 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-9 shows the codes and their meanings.
AR/PL	(I64 only.) The access rights and privilege level of the page. Consists of a number (0-7) and a letter (K, E, S, or U) that determines access to a page in each mode.
KESU	(I64 only.) The access allowed to the page in each mode. This is an interpretation of the AR/PL values in the previous column. For an explanation of the access codes, see Section 2.8, Page Protections and Access Rights.
MLO	(I64 only.) 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-9 shows the codes and their meanings.
GH	Contents of granularity hint bits.

**Table 4-8 Types 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-9 Bits In the PTE**
Column Name	Code	Meaning
M	M	Page has been modified.
L	L	Page is locked into a working set.
L	P	Page is locked in physical memory.
O	K	Owner is kernel mode.
O	E	Owner is executive mode.
O	S	Owner is supervisor mode.
O	U	Owner is user mode.
A	A	Address space match is set (Alpha only).

**Table 4-10 Physical Page Information in the SHOW PAGE_TABLE Display**
Category	Meaning
PGTYP	Type of physical page. Table 4-11 shows the types of physical pages.
LOC	Location of the page within the system. Table 4-12 shows the possible locations with their meaning.
BAK	Place to find information on 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.
WSLX	Working Set List Index. This shows as zero for resident and global pages, and is left blank for transition pages.

**Table 4-11 Types of Physical Pages**
Page Type	Meaning
PROCESS	Page is part of process space.
SYSTEM	Page is part of system space.
GLOBAL	Page is part of a global section.
GBLWRT	Page is part of a global, writable section.
PPGTBL	Page is part of a process page table.
GPGTBL	Page is part of a global page table.
PHD ¹	Page is part of a process PHD.
PPT(Ln) ¹	Page is a process page table page at level n.
SPT(Ln) ²	Page is a system page table page at level n.
SHPT ³	Page is part of a shared page table.
PFNLST ²	Page is in a Shared Memory Common Property Partition PFN database.
SHM_REG ³	Page is in a Shared Memory Region.
UNKNOWN	Unknown.

¹These page types are variants of the PPGTBL page type.
²These page types are variants of the SYSTEM page type.
³These page types are variants of the GBLWRT page type.

Table 4-12 Locations of Physical Pages
Location Meaning

ACTIVE Page is in a working set.

MFYLST Page is in the modified page list.

FRELST Page is in the free page list.

BADLST Page is in the bad page list.

RELPND Release of the page is pending.

RDERR Page has had an error during an attempted read operation.

PAGOUT Page is being written into a paging file.

PAGIN Page is being brought into memory from a paging file.

ZROLST Page is in the zeroed-page list.

UNKNWN Location of page is unknown.

**Table 4-12 Locations of Physical Pages**
Location	Meaning
ACTIVE	Page is in a working set.
MFYLST	Page is in the modified page list.
FRELST	Page is in the free page list.
BADLST	Page is in the bad page list.
RELPND	Release of the page is pending.
RDERR	Page has had an error during an attempted read operation.
PAGOUT	Page is being written into a paging file.
PAGIN	Page is being brought into memory from a paging file.
ZROLST	Page is in the zeroed-page list.
UNKNWN	Location of page is unknown.

SDA indicates pages are inaccessible by displaying one of the following messages:

------- 1 null page: VA FFFFFFFE.00064000 PTE FFFFFFFD.FF800190 ------- 974 null pages: VA FFFFFFFE.00064000 PTE FFFFFFFD.FF800190 -to- FFFFFFFE.007FDFFF -to- FFFFFFFD.FF801FF8

In this case, the page table entries are not in use (page referenced is inaccessible).

------- 1 entry not in memory: VA FFFFFFFE.00800000 PTE FFFFFFFD.FF802000 ------- 784384 entries not in memory: VA FFFFFFFE.00800000 PTE FFFFFFFD.FF802000 -to- FFFFFFFF.7F7FDFFF -to- FFFFFFFD.FFDFDFF8

In this case, the page table entries do not exist (PTE itself is inaccessible).

------- 1 free PTE: VA FFFFFFFF.7F800000 PTE FFFFFFFD.FFDFEOOO ------- 1000 free PTEs: VA FFFFFFFF.7F800000 PTE FFFFFFFD.FFDFE000 -to- FFFFFFFF.7FFCDFFF -to- FFFFFFFD.FFDFFF38

In this case, the page table entries are in the list of free system pages.

In each case, VA is the MAPPED ADDRESS of the skipped entry, and PTE is the PTE ADDRESS of the skipped entry.

Examples

#1

For an example of SHOW PAGE_TABLE output when the qualifier /FREE has not been given, see the SHOW PROCESS/PAGE_TABLES command.

#2
SDA> SHOW PAGE_TABLE/FREE S0/S1 Space Free PTEs --------------------- MAPPED ADDRESS PTE ADDRESS PTE COUNT FFFFFFFF.82A08000 FFFFFFFD.FFE0A820 0001FFE0.A8580000 00000003 FFFFFFFF.82A16000 FFFFFFFD.FFE0A858 0001FFE0.A8900000 00000003 FFFFFFFF.82A24000 FFFFFFFD.FFE0A890 0001FFE0.B3C00000 00000003 FFFFFFFF.82CF0000 FFFFFFFD.FFE0B3C0 0001FFE0.B4010000 00000001 FFFFFFFF.82D00000 FFFFFFFD.FFE0B400 0001FFE0.B4680000 00000002 . . . FFFFFFFF.82E48000 FFFFFFFD.FFE0B920 0001FFE0.B9390000 00000001 FFFFFFFF.82E4E000 FFFFFFFD.FFE0B938 0001FFE0.BA200000 00000002 FFFFFFFF.82E88000 FFFFFFFD.FFE0BA20 0001FFE0.C9780000 00000003 FFFFFFFF.8325E000 FFFFFFFD.FFE0C978 0001FFE0.CC980000 00000003 FFFFFFFF.83326000 FFFFFFFD.FFE0CC98 00000000.00000000 0000066D

SDA> SHOW PAGE_TABLE/FREE
S0/S1 Space Free PTEs 
--------------------- 
 MAPPED ADDRESS        PTE ADDRESS             PTE           COUNT 
 
FFFFFFFF.82A08000   FFFFFFFD.FFE0A820   0001FFE0.A8580000   00000003 
FFFFFFFF.82A16000   FFFFFFFD.FFE0A858   0001FFE0.A8900000   00000003 
FFFFFFFF.82A24000   FFFFFFFD.FFE0A890   0001FFE0.B3C00000   00000003 
FFFFFFFF.82CF0000   FFFFFFFD.FFE0B3C0   0001FFE0.B4010000   00000001 
FFFFFFFF.82D00000   FFFFFFFD.FFE0B400   0001FFE0.B4680000   00000002 
 
   .
   .
   .
FFFFFFFF.82E48000   FFFFFFFD.FFE0B920   0001FFE0.B9390000   00000001 
FFFFFFFF.82E4E000   FFFFFFFD.FFE0B938   0001FFE0.BA200000   00000002 
FFFFFFFF.82E88000   FFFFFFFD.FFE0BA20   0001FFE0.C9780000   00000003 
FFFFFFFF.8325E000   FFFFFFFD.FFE0C978   0001FFE0.CC980000   00000003 
FFFFFFFF.83326000   FFFFFFFD.FFE0CC98   00000000.00000000   0000066D

This example shows the output when you invoke the SHOW PAGE_TABLE/FREE command.

SHOW PARAMETER

Displays the name, location, and value of one or more SYSGEN parameters currently in use or at the time that the system dump was taken.

Format

SHOW PARAMETER [SYSGEN_parameter]
[/ACP][/ALL][/CLUSTER][/DYNAMIC][/GALAXY]
[/GEN][/JOB][/LGI][/MAJOR][/MULTIPROCESSING]
[/OBSOLETE][/PQL][/RMS][/SCS][/SPECIAL]
[/SYS][/STARTUP][/TTY]

Parameter

SYSGEN_parameter
Name of a parameter to be displayed. The name given may include wildcards. However, a truncated name is not recognized, unlike the equivalent SYSGEN and SYSMAN commands.

Qualifiers

/ACP
Displays all Files-11 ACP parameters.
/ALL
Displays the values of all parameters except the special control parameters.
/CLUSTER
Displays all parameters specific to clusters.
/DYNAMIC
Displays all parameters that can be changed on a running system.
/GALAXY
Displays all parameters specific to Galaxy systems.
/GEN
Displays all general parameters.
/JOB
Displays all Job Controller parameters.
/LGI
Displays all LOGIN security control parameters.
/MAJOR
Displays the most important parameters.
/MULTIPROCESSING
Displays parameters specific to multiprocessing.
/OBSOLETE
Displays all obsolete system parameters. SDA displays obsolete parameters only if they are named explicitly (no wildcards) or if /OBSOLETE is given.
/PQL
Displays the parameters for all default and minimum process quotas.
/RMS
Displays all parameters specific to OpenVMS Record Management Services (RMS).
/SCS
Displays all parameters specific to OpenVMS Cluster System Communications Services.
/SPECIAL
Displays all special control parameters.
/STARTUP
Displays the name of the site-independent startup procedure.
/SYS
Displays all active system parameters.
/TTY
Displays all parameters for terminal drivers.

Description

The SHOW PARAMETER command displays the name, location, and value of one or more SYSGEN parameters at the time that the system dump is taken. You can specify either a parameter name, or one or more qualifiers, but not both a parameter and qualifiers. If you do not specify a parameter or qualifiers, then the last parameter displayed is displayed again.
The qualifiers are the equivalent to those available for the SHOW [parameter] command in the SYSGEN utility and the PARAMETERS SHOW command in the SYSMAN utility. See the HP OpenVMS System Management Utilities Reference Manual: M--Z for more information about these two commands. You can combine qualifiers, and all appropriate SYSGEN parameters are displayed.

Note
To see the entire set of parameters, use the SDA command
SHOW PARAMETER /ALL /SPECIAL /STARTUP/OBSOLETE.

Examples

This example shows all parameters that have the string "SCS" in their name. For parameters defined as a single bit, the name and value of the bit offset within the location used for the parameter are also given.

Contents

Index

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

HP OpenVMS System Analysis Tools Manual

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

Examples

SHOW PARAMETER

Format

Parameter

SYSGEN_parameter

Qualifiers

/ACP

/ALL

/CLUSTER

/DYNAMIC

/GALAXY

/GEN

/JOB

/LGI

/MAJOR

/MULTIPROCESSING

/OBSOLETE

/PQL

/RMS

/SCS

/SPECIAL

/STARTUP

/SYS

/TTY

Description