[Digital logo]
[HR]

OpenVMS DCL Dictionary


Previous | Contents

If you enter the /OUTPUT qualifier with a partial file specification (for example, specifying only a directory), SHOW is the default file name and .LIS the default file type. If you enter a file specification, it cannot include asterisk (*) and the percent sign (%) wildcard characters.

If you enter the /NOOUTPUT qualifier, output is suppressed.

/PAGE[=keyword]

/NOPAGE (default)

Controls the display of memory information on the screen.

You can use the following keywords with the /PAGE qualifier:
CLEAR_SCREEN Clears the screen before each page is displayed.
SCROLL Displays information one line at a time.
SAVE[= n] Enables screen navigation of information, where n is the number of pages to store.

The /PAGE=SAVE qualifier allows you to navigate through screens of information. The /PAGE=SAVE qualifier stores up to 5 screens of up to 255 columns of information. When you use the /PAGE=SAVE qualifier, you can use the following keys to navigate through the information:
Key Sequence Description
Up arrow (<uparrow symbol>), Ctrl/B Scroll up one line.
Down arrow (<downarrow symbol>) Scroll down one line.
Left arrow ( <-) Scroll left one column.
Right arrow (->) Scroll right one column.
Find (E1) Specify a string to find when the information is displayed.
Insert Here (E2) Scroll right one half screen.
Remove (E3) Scroll left one half screen.
Select (E4) Toggle 80/132 column mode.
Prev Screen (E5) Get the previous page of information.
Next Screen (E6), Return, Enter, Space Get the next page of information.
F10, Ctrl/Z Exit. (Some utilities define these differently.)
Help (F15) Display utility help text.
Do (F16) Toggle the display to oldest/newest page.
Ctrl/W Refresh the display.

The /PAGE qualifier is not compatible with the /OUTPUT qualifier.

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

/SEARCH="string"

Use with the /PAGE=SAVE qualifier to specify a string that you want to find in the information being displayed. Quotation marks are required for the /SEARCH qualifier, if you include spaces in the text string.

You can also dynamically change the search string by pressing the Find key (E1) while the information is being displayed. Quotation marks are not required for a dynamic search.

/SLOTS

Displays information about the availability of partition control block (PCB) vector slots and balance slots.

/WRAP

/NOWRAP (default)

Use with the /PAGE=SAVE qualifier to limit the number of columns to the width of the screen and to wrap lines that extend beyond the width of the screen to the next line.

The /NOWRAP qualifier extends lines beyond the width of the screen and can be seen when you use the scrolling (left and right) features provided by the /PAGE=SAVE qualifier.


Examples

#1
$ SHOW MEMORY
         
      System Memory Resources on  4-MAY-1994 10:14:45.68 
 
Physical Memory Usage (pages):   Total     Free     In Use   Modified 
  Main Memory (24.00Mb)          49152    16390      31056       1706 
 
Virtual I/O Cache Usage (pages): Total     Free     In Use    Maximum 
                                  9232        0       9232      18055 
 
Slot Usage (slots):              Total     Free   Resident    Swapped 
  Process Entry Slots               26        3         21          2 
  Balance Set Slots                 23        1         21          1 
 
Dynamic Memory Usage (bytes):    Total     Free     In Use    Largest 
  Nonpaged Dynamic Memory       462336     8304     454032       4608 
  Paged Dynamic Memory          348672   117120     231552     114976 
 
Paging File Usage (pages):                  Free   Reservable   Total 
  DISK$DKA300:[SYS0.SYSEXE]PAGEFILE.SYS    46514        -3239   50000 
 
Of the physical pages in use, 5162 pages are permanently allocated 
  to VMS.
 

This example shows reservable pages. Here, the reservable pages are a negative value which indicates that you may want to consider adding to the fixed amount of pagefile space available.

#2
$ SHOW MEMORY/CACHE/FULL
 
            System Memory Resources on 10-OCT-1994 18:36:12.79
Virtual I/O Cache
Total Size (pages)   (1)   2422    Read IO Count          (6)     9577
Free Pages           (2)   18      Read Hit Count         (7)     5651
Pages in Use         (3)   2404    Read Hit Rate          (8)     59%
Maximum Size (SPTEs) (4)   11432   Write IO Count         (9)     2743
Files Retained       (5)   99      IO Bypassing the Cache (10)     88
 
 


Note

This example shows the output for the SHOW MEMORY/CACHE/FULL command on a VAX system. The SHOW MEMORY/CACHE/FULL command will display slightly different field on an Alpha system.

Virtual I/O Cache Usage (in Pages)

Shows the use of the Virtual I/O Cache facility on VAX.
(1) Total Size Displays the total number of system memory pages that the Virtual I/O cache currently controls.
(2) Free Pages Displays the number of pages controlled by the Virtual I/O cache that do not contain cache data.
(3) Pages in Use Displays the number of pages controlled by the Virtual I/O cache that contain valid cached data.
(4) Maximum Size Shows the maximum size that the cache could ever grow to.
(5) Files Retained Displays the number of files that are closed but the file system control information is being retained because they have valid data residing in the cache.
(6) Read I/O Count Displays the total number of read I/Os that have been seen by the Virtual I/O cache since the last system.
(7) Read Hit Count Displays the total number of read I/Os that did not do a physical I/O because the data for them was found in the cache since the last system BOOT.
(8) Read Hit Rate Displays the read hit count and read I/O count ratio.
(9) Write I/O Count Shows the total number of write I/Os that have been seen by the cache since the last system BOOT.
(10) I/O Bypassing Displays the count of I/Os that for some reason did not attempt to satisfy the request/update by the cache.
#3
$ SHOW MEMORY/PHYSICAL_PAGES
 
              System Memory Resources on  14-DEC-1994 16:11:30.76
Physical Memory Usage (pages):  Total (1)  Free (2)   In Use (3)  Modified (4)
Main Memory (32.00Mb)           65536    44233       20955          308
 
Of the physical pages in use, 10970 pages are permanently allocated
  to VMS.
 

Physical Memory Usage

Shows the use of physical memory.
(1) Total Displays the number of physical memory pages available for general system use. Multiport memory pages (existing on some VAX) used for shared memory global sections, mailboxes, and common event blocks are not included in this number.
(2) Free Displays the number of pages on the free page list.
(3) In Use Displays the number of pages currently being used. This number is calculated by adding the number of pages on the free, modified, and bad lists and then subtracting that sum from the total number of available pages.
(4) Modified Displays the number of pages on the modified page list.

Bad Page List

Shows the contents of the bad page list.

Note

This display is written only when there are pages on the bad page list.

Total Displays the number of pages on the bad page list.
Dynamic Displays the number of memory errors detected after the system was booted.
I/O Errors Displays the number of errors detected during page fault handling.
Static Displays the number of memory errors detected during boot-time scan.

By default, either single-bit or double-bit errors cause the pages to be removed during the boot-time scan.

Pages Allocated to OpenVMS

Any SHOW MEMORY display that includes the physical memory display concludes with the number of pages permanently allocated to the OpenVMS system. These pages include nonpaged executive code and data, the PFN database, nonpaged dynamic memory, the interrupt stack, and the system page table.
#4
$ SHOW MEMORY/SLOTS
 
              System Memory Resources on 14-DEC-1994 16:11:35.31
Slot Usage (slots):       Total (1)   Free (2)  Resident (3)  Swapped (4)
Process Entry Slots          75        28           46           1
Balance Set Slots            70        26           44           0
 
 

Slot Usage (slots)

Displays the use of process entry slots and balance set slots.
(1) Total Displays the number of process entry slots (the value of the system parameter MAXPROCESSCNT) and balance set slots (the value of the system parameter BALSETCNT) permanently allocated when the system was bootstrapped.
(2) Free Displays the number of slots currently available.
(3) Resident Displays the number of slots currently used by memory-resident processes. The number of balance set slots in use can never be any larger than the number of process entry slots in use because the SWAPPER and NULL processes have process entry slots but do not require balance set slots.
(4) Swapped Displays the number of slots used by outswapped processes. For process entry slots, this number includes all processes that have been partially outswapped. For balance set slots, this number includes those processes that have had their process bodies outswapped but have process headers that are still resident.
#5
$ SHOW MEMORY/POOL
 
 
              System Memory Resources on  14-DEC-1994 16:11:39.97
Dynamic Memory Usage (bytes):    Total (1)   Free (2)  In Use (3)  Largest (4)
  Nonpaged Dynamic Memory       161792      3488     158304        1936
  Paged Dynamic Memory           65536     29312      36224       29296
 
 

Dynamic Memory Usage (in bytes)

Shows the use of the nonpaged and paged pool areas that allocate variably sized blocks.
(1) Total Displays the total number of bytes set aside for each area.
(2) Free Displays the total amount of free space in each dynamic memory area.
(3) In Use Displays the amount of space currently allocated from each area. This number is simply the total size minus the number of free bytes.
(4) Largest Displays the size of the largest contiguous block in each area. For the paged pool, this number represents the largest block that can be allocated. For the nonpaged pool, an allocation request larger than this number will cause the nonpaged pool to grow (if other constraints allow growth).
#6
$ SHOW MEMORY/FILES
 
              System Memory Resources on  14-DEC-1994 16:11:45.83
Paging File Usage (blocks):                   Free (2) Reservable (3) Total (4)
 DISK$VMS02APR1:[SYS2.SYSEXE]SWAPFILE.SYS (1)   256           256     4096
 DISK$VMS02APR1:[SYS2.SYSEXE]PAGEFILE.SYS     7613          6912     8192
 
 

Paging File Usage (in pages)

Shows the usage of paging and swapping files.
(1) Name Displays the complete file specification of each swapping or paging file.
The names of the primary paging file, the primary swapping file (if this file exists), and the files installed by the bootstrap operation are always displayed. The names of any secondary paging or swapping files installed by the System Generation utility (SYSGEN) are displayed only if the process using the SHOW MEMORY command has read (R) access to those files. If the process cannot read the file, the name is suppressed but the usage statistics are displayed.
(2) Free Displays the number of free blocks in each paging and swapping file currently installed. Free blocks are blocks that may be physically allocated in the file.
(3) Reservable Displays the number of reservable blocks in each paging and swapping file currently installed. Reservable blocks are blocks that may be logically claimed by a process for future physical allocation. A negative value indicates that the file may be overcommitted.
Note that a negative value is not an immediate concern but indicates that the file may become overcommitted if physical memory becomes scarce.
(4) Total Displays the total size of each paging and swapping file.

When the /FULL qualifier is included on the SHOW MEMORY command for displays of pool areas or paging file usage, additional information is included in the pool or files displays.

#7
$ SHOW MEMORY/POOL/FULL
 
              System Memory Resources on  31-DEC-1994 16:11:49.74
 
Nonpaged Dynamic Memory                      (Lists + Variable) 
 Current Size (bytes)   (1)   8144384    Current Total Size (pages)(1)  15907
 Initial Size (NPAGEDYN)(2)   8144384    Initial Size (pages)      (2)  15907
 Maximum Size (NPAGEVIR)(3)  36196352    Maximum Size (pages)      (3)  70696
 Free Space (bytes)     (4)   2849856    Space in Use (bytes)      (5)5294528
 Size of Largest Block  (6)    971904    Size of Smallest Block    (7)     64
 Number of Free Blocks  (8)      6756    Free Blocks LEQU 64 Bytes (9)    274
Paged Dynamic Memory    
 Current Size (PAGEDYN) (1)   4324352    Current Total Size (pages)(1)   8446
 Free Space (bytes)     (4)   3378664    Space in Use (bytes)      (5) 951488
 Size of Largest Block  (6)   3357664    Size of Smallest Block    (7)     16
 Number of Free Blocks  (8)       216    Free Blocks LEQU 64 Bytes (9)    178
 
 

Dynamic Memory

Shows the use of dynamic memory areas consisting of variably sized blocks.
(1) Current Size Displays the current size (in 512-byte pagelets on Alpha and in bytes and pages on VAX) of each dynamic memory area.
(2) Initial Size Displays the initial size of nonpaged dynamic memory and the name of the system parameter (NPAGEDYN) that controls this size.
(3) Maximum Size Displays the maximum size to which nonpaged dynamic memory can grow and the name of the system parameter (NPAGEVIR) that controls this size.
(4) Free Space Displays the amount of free space in each dynamic memory area.
(5) Space in Use Displays the amount of space currently allocated from each area.
(6) Largest Block Displays the size of the largest contiguous area in each pool area.
(7) Smallest Block Displays the size of the smallest hole (free block) in each pool area.
(8) Free Blocks Displays the total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation.
(9) Blocks LEQU 64 Displays the number of free blocks that are 64 bytes long or shorter. This number is another measure of pool fragmentation because while allocation of these small blocks is unlikely, they contribute to the allocation time whenever an allocation request is made.
#8
$ SHOW MEMORY/FILES/FULL
 
              System Memory Resources on  14-APR-1994 16:11:55.49
DISK$VMS02APR1:[SYS0.SYSEXE]SWAPFILE.SYS (1)
  
Free Blocks (2)               256   Reservable Blocks (3)             256
Total Size (blocks) (4)      4096   Paging File Number (5)              1
Swapping Usage (processes) (6)  0   Paging Usage (processes) (7)        0
  This file is used exclusively for swapping. (8)  
  
DISK$VMS02APR1:[SYS0.SYSEXE]PAGEFILE.SYS (1)
Free Blocks (2)              7611   Reservable Blocks (3)            6912
Total Size (blocks) (4)      8192   Paging File Number (5)              5
Swapping Usage (processes) (6)  0   Paging Usage (processes) (7)        0
  This file can be used for either paging or swapping. (8)
 

Paging File Usage

Shows the usage of paging and swapping files.
(1) File Name Displays the complete file specification of each paging or swapping file, subject to the privilege restriction mentioned in the description of the normal display.
(2) Free Blocks Displays the number of free blocks in each paging and swapping file currently installed. Free blocks are blocks that may be physically allocated in the file.
(3) Reservable Blocks Displays the number of reservable blocks in each paging and swapping file currently installed. Reservable blocks are blocks that may be logically claimed by a process for future physical allocation. A negative value indicates that the file may be overcommitted.
Note that a negative value is not an immediate concern but indicates that the file may become overcommitted if physical memory becomes scarce.
(4) Total Size Displays the size of each paging and swapping file.
(5) File Number Displays the internal paging file index assigned to each paging or swapping file when it is installed.
(6) Swapping Usage Displays the number of processes currently assigned space in this file for the purpose of swapping. Swapping file assignment can change over the life of a process.
(7) Paging Usage Displays the number of processes currently paging to this file. Paging file assignment is made when a process is created and a process continues to page to that file.
Note that the last two pieces of information are limited by the GROUP and WORLD privileges. That is, a process with neither privilege can only determine the paging and swapping file assignments of itself and its subprocesses. A process with GROUP privilege can obtain this information about all processes that have the same group number. Only a process with WORLD privilege can obtain accurate paging and swapping file information for the entire system.
(8) File Usage Displays a line of text that describes whether the file is used exclusively for swapping or is used for both paging and swapping.

SHOW NETWORK

Displays information about network services registered on a node.

Format

SHOW NETWORK [network-service]


PARAMETER

network-service

Specifies a network service for which you want to display information. If you do not specify a service, the SHOW NETWORK command displays information about all services that are currently registered on the local node.

DESCRIPTION

The SHOW NETWORK command displays information about network services available on an OpenVMS system.

QUALIFIERS

/FULL

Displays all the information for the specified network service.

/OLD

If you are running DECnet Phase IV, retains the behavior of the SHOW NETWORK command prior to OpenVMS Version 7.0. If the local node is a routing node, the /OLD qualifier provides routing information.

/OUTPUT[=filespec]

/NOOUTPUT

Controls where the output of the command is sent. By default, the output of the SHOW NETWORK command is sent to the current SYS$OUTPUT device (usually your terminal).

The asterisk (*) and the percent sign (%) wildcard characters are not allowed in the file specification.

If you enter the /NOOUTPUT qualifier, output is suppressed.


Examples

#1
$ SHOW NETWORK
Product: DECnet           Node: GALAXY         Addresss(es): 19.129
 

This command displays all the network services currently registered on the local node, and the name and address of that node.

#2
$ SHOW NETWORK DECnet
Product: DECnet           Node: GALAXY         Addresss(es): 19.129
 

This command identifies the network services, in this case DECnet, registered on the local node.

#3
$ SHOW NETWORK/FULL
The following network service is available at this time:
Product:  DECNET        Manufacturer:  Digital Equipment Corporation
Node:  ZOOMAN            Address(es):  19.215
Network Type:  DNA IV   Interface(s):  net 0
Node Volatile Characteristics as of 21-NOV-1995 10:36:09
Executor node = 19.215 (ZOOMAN)
Identification           = DECnet for OpenVMS Alpha V6.2
Management version       = V4.0.0
Incoming timer           = 45
Outgoing timer           = 60
Incoming Proxy           = Enabled
Outgoing Proxy           = Enabled
NSP version              = V4.1.0
Maximum links            = 32
Delay factor             = 80
Delay weight             = 5
Inactivity timer         = 60
Retransmit factor        = 10
Routing version          = V2.0.0
Type                     = nonrouting IV
Routing timer            = 600
Broadcast routing timer  = 180
Maximum address          = 1023
Maximum circuits         = 16
Maximum cost             = 1022
Maximum hops             = 30
Maximum visits           = 63
Maximum area             = 63
Max broadcast nonrouters = 64
Max broadcast routers    = 32
Maximum path splits      = 1
Area maximum cost        = 1022
Area maximum hops        = 30
Maximum buffers          = 100
Buffer size              = 576
Default access           = incoming and outgoing
Pipeline quota           = 4032
Alias maximum links      = 32
Path split policy        = Normal
Maximum Declared Objects = 31
Known Link Volatile Summary as of 21-NOV-1995 10:36:10
   Link       Node       PID     Process   Remote link  Remote user
                                        
  8201   19.117        20200094  REMACP          25330  JONES
  8200   19.129        20200094  REMACP          24711  SMITH
Node Counters as of 21-NOV-1995 10:36:10
Executor node = 19.215 (ZOOMAN)
           3  Maximum logical links active
           0  Aged packet loss
           0  Node unreachable packet loss
           0  Node out-of-range packet loss
           0  Oversized packet loss
           0  Packet format error
           0  Partial routing update loss
           0  Verification reject
$


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  9996P056.HTM
  OSSG Documentation
  26-NOV-1996 11:18:30.33

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal