HP OpenVMS Systems Documentation

HP OpenVMS System Analysis Tools Manual

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.

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 1	Page is part of a process PHD.
PPT(Ln) 1	Page is a process page table page at level n.
SPT(Ln) 2	Page is a system page table page at level n.
SHPT 3	Page is part of a shared page table.
PFNLST 2	Page is in a Shared Memory Common Property Partition PFN database.
SHM_REG 3	Page is in a Shared Memory Region.
UNKNOWN	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

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

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.

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.

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.