Document revision date: 30 March 2001

## OpenVMS DCL Dictionary

Previous | Contents | Index

> #### Extended File Cache Statistics Usage

> Shows the use of the Extended File Cache Statistics facility on an Alpha system.

(1) Allocated pages | .Number of main memory data pages currently being used by the extended file cache to contain actual file data, for this volume
(2) Read hits | Cumulative number of times a read has been satisfied from the data cache.
(3) Virtual writes | Cumulative number of virtual write I/Os received on this volume by the cache.
(4) Read aheads | Cumulative number of times the extended file cache issued read ahead I/Os on this volume after detecting sequential file I/O virtual reads.
(5) Write throughs | Cumulative number of times a virtual write has been capable of modifying cached data.
(6) Total QIOs | Total number of QIO and PAGE I/O calls received by the extended file cache on this volume.
(7) Virtual reads | Cumulative number of Virtual Read requests received by the extended file cache on this volume.
(8) Hit rate | Percentage of Total QIOs that were completed by copying data from cache, rather than issuing real I/O to a volume.
(9) Read throughs | Number of Virtual Reads that are capable of being satisfied by the extended file cache.
(10) Read arounds | Number of Virtual Reads that cannot be satisfied by the extended file cache. Reasons for this include the presence of a non-XFC compliant node in an OpenVMS cluster, and the receipt of an I/O that is larger than VCC_MAX_IO_SIZE.
(11) Write arounds | Cumulative number of times a virtual write has been detected that cannot update data in cache memory.

#7
    $ SHOW MEMORY/PHYSICAL_PAGES
                  System Memory Resources on  3-NOV-2001 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 | 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 | Number of pages on the free page list.
> (3) In Use | 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 | 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 | Number of pages on the bad page list.
> Dynamic | Number of memory errors detected after the system was booted.
> I/O Errors | Number of errors detected during page fault handling.
> Static | 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.

#8
    $ SHOW MEMORY/SLOTS
                  System Memory Resources on 3-NOV-2001 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 | 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 | Number of slots currently available.
> > (3) Resident | 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 | 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.

#9
    $ SHOW MEMORY/POOL

                  System Memory Resources on  5-DEC-2001 03:59:35.29

    Dynamic Memory Usage (bytes):   Total (1)
        Free (2)
     In Use (3)
     Largest (4)

      Nonpaged Dynamic Memory    24993792   23511872   1481920   23363776
      Bus Addressable Memory       131072     114688     16384     114688
      Paged Dynamic Memory        5799936    3530784   2269152    3530176
      Lock Manager Dynamic Memory 1048576     254976    793600

> > #### Dynamic Memory Usage (in bytes)

> > Shows the use of the nonpaged and paged pool areas that allocate variably sized blocks.

> > (1) Total | Total number of bytes set aside for each area.
> > (2) Free | Total amount of free space in each dynamic memory area.
> > (3) In Use | Amount of space currently allocated from each area. This number is the total size minus the number of free bytes.
> > (4) Largest | 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). This attribute does not apply to the lock manager, as all items for the lock manager are the same size.

#10
    $ SHOW MEMORY/POOL/FULL
                  System Memory Resources on  5-DEC-2001 03:59:35.29

    Nonpaged Dynamic Memory                   (Lists + Variable)
     Current Size (bytes)    (1) 24993792 Current Size (pagelets)  (1)  48816
     Initial Size (NPAGEDYN) (2) 24993792 Initial Size (pagelets)  (2)  48816
     Maximum Size (NPAGEVIR) (3)499998720 Maximum Size (pagelets)  (3) 976560
     Free Space (bytes)      (4) 22230144 Space in Use (bytes)     (5)2763648
     Largest Variable Block  (6) 19676672 Smallest Variable Block  (7)   2176
     Number of Free Blocks   (8)    38334 Free Blocks LEQU 64 Bytes(9)      0
     Free Blocks on Lookasides(16)  38330 Lookaside Space (bytes)   2537472
    Bus Addressable Memory                   (Lists + Variable)
     Current Size (bytes)    (1)   131072 Current Size (pagelets)  (1)    256
     Initial Size (NPAGEDYN) (2)   131072 Initial Size (pagelets)  (2)    256
     Free Space (bytes)      (4)   114688 Space in Use (bytes)     (5)  16384
     Largest Variable Block  (6)   114688 Smallest Variable Block  (7) 114688
     Number of Free Blocks   (8)        1 Free Blocks LEQU 64 Bytes(9)      0
     Free Blocks on Lookasides(16)      0 Lookaside Space (bytes)         0
    Paged Dynamic Memory
     Current Size (PAGEDYN)  (1)  5799936 Current Size (pagelets)  (1)  11328
     Free Space (bytes)      (4)  3518288 Space in Use (bytes)     (5)2281648
     Largest Variable Block  (6)  3517584 Smallest Variable Block  (7)     16
     Number of Free Blocks   (8)       25 Free Blocks LEQU 64 Bytes(9)     23
    Lock Manager Dynamic Memory
     Current Size (Mbytes)   (1)    13.85 Current Size (pages)    (1)    1774
     Free Space (Mbytes)     (4)    10.06 Hits                    (12)  54050
     Space In Use            (5)     3.79 Misses                  (13)   1664
     Number of Empty Pages   (10)      26 Expansions              (14)   1792
     Number of Free Packets  (11)   41244 Packet Size             (15)    256

> > #### Dynamic Memory

> > Shows the use of dynamic memory areas consisting of variably sized blocks.

> > (1) Current Size | Current size (in 512-byte pagelets on Alpha and in bytes and pages on VAX) of each dynamic memory area. For the lock manager display, the unit of measurement is megabytes.
> > (2) Initial Size | Initial size of nonpaged dynamic memory and the name of the system parameter (NPAGEDYN) that controls this size.
> > (3) Maximum Size | Maximum size to which nonpaged dynamic memory can grow and the name of the system parameter (NPAGEVIR) that controls this size.
> > (4) Free Space | Amount of free space in each dynamic memory area.
> > (5) Space in Use | Amount of space currently allocated from each area.
> > (6) Largest Block | Size of the largest contiguous area in each pool area.
> > (7) Smallest Block | Size of the smallest hole (free block) in each pool area.
> > (8) Free Blocks | Total number of free blocks in each pool area. The size of this number is a measure of pool fragmentation.
> > (9) Blocks LEQU 64 | 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.
> > (10) Empty Pages | Number of pages that do not have any packets allocated.
> > (11) Free Packets | Total number of packets not in use. This number is the sum of free packets from partially used pages and the packets of all Empty Pages.
> > (12) Hits | Total number of packet allocations.
> > (13) Misses | Total number of packet allocation requests that could not be satisfied because the number of packets requested were not available. A miss causes dynamic memory to expand by one page to satisfy the packet allocation request.
> > (14) Expansions | Total number of times that dynamic memory increased by a page to satisfy packet allocation requests.
> > (15) Packet Size | Packet size of 256 bytes, which is used by the lock manager to hold either a lock block data structure or a resource block data structure.
> > (16) Lookasides Free Blocks | Total number of memory packets that the system has preallocated and placed on "lookaside lists". If a packet of the correct size is on a lookaside list, it can be allocated very quickly and efficiently, however, it can not then be used as part of any other size packet. An excess of packets on the lookaside list can be a cause for the inability to allocate other sizes.

#11
    $ SHOW MEMORY/FILES
            System Memory Resources on 22-MAY-2001 19:04:19.67
    Swap File Usage (8KB pages):              Index (1)     Free     Size
    DISK$ALPHASYS:[SYS48.SYSEXE]SWAPFILE.SYS      1         904      904
    DISK$SWAP:[SYS48.SYSEXE]SWAPFILE.SYS;1        2        1048     1048

      Total size of all swap files:                                 1952

    Paging File Usage (8KB pages):            Index (2)     Free     Size
    DISK$PAGE:[SYS48.SYSEXE]PAGEFILE.SYS;1      253       16888    16888
    DISK$ALPHASYS:[SYS48.SYSEXE]PAGEFILE.SYS    254       16888    16888

      Total size of all paging files:                              33776
      Total committed paging file usage:  (3)                        1964

> > #### Paging File Usage (in blocks)

> > Shows the usage of paging and swapping files.

> > (1) Swap File Usage | Number of swap files. Begins with an index value of 1 and increases in count.
> > (2) Paging File Usage | Number of page files. Begins with an index value of 254 and decreases in count.
> > (3) Total Paging File Usage | Total committed page file usage. As in previous releases, more pages can reside in page-file sections systemwide than would fit into installed page files.

## 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: GALENA               Address(es): 19.64
    Product: TCP/IP   Node: GALENA.zka.cpq.com   Address(es): 16.32.0.138

> The SHOW NETWORK command in this example displays all the network services currently registered on the local node, and the name and address of that node.

#2
    $ SHOW NETWORK "TCP/IP"
    Product: TCP/IP   Node: GALENA.zka.cpq.com   Address(es): 16.32.0.138

> The SHOW NETWORK command in this example displays the TCP/IP network service registered on the local node.

#3
    $ SHOW NETWORK/FULL
    The following network service is available at this time:

    Product:  DECNET          Manufacturer:  Compaq Computer Corporation
    Node:  NEMYA              Address(es):   4.26
    Network Type:  DNA V      Interface(s):  net 0

    Node 0
    at 2001-02-26-10:35:28.737-05:00I526.997

    Identifiers

      Name                        = DEC:.LKR.NEMYA
      Address                     =
        {
          (
          [ DNA_CMIP-MICE ] ,
          [ DNA_SessionControlV3 , number = 19 ] ,
          [ DNA_OSItransportV1 , 'DEC0'H ] ,
          [ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:21 (DEC:.LKR.NEMYA) ]
           ,)
          (
          [ DNA_CMIP-MICE ] ,
          [ DNA_SessionControlV2 , number = 19 ] ,
          [ DNA_OSItransportV1 , 'DEC0'H ] ,
          [ DNA_IP , 0.0.0.0 ]
           ,)
          (
          [ DNA_CMIP-MICE ] ,
          [ DNA_SessionControlV3 , number = 19 ] ,
          [ DNA_NSP ] ,
          [ DNA_OSInetwork , 49::00-04:AA-00-04-00-1A-10:20 (DEC:.LKR.NEMYA) ]
          )
        }

    Status

      UID                         = 06E08000-DF79-11D4-8001-AA0004001A10
      State                       = On
      Functions Enabled           =
        {
          Address Watcher ,
          CMIP Listener
        }
      ID                          = 08-00-2B-E5-A8-AB

    Characteristics

      Version                     = T5.0.3
      Implementation              =
        {
          [
          Name = OpenVMS AXP ,
          Version = "X901-SSB"
          ] ,
          [
          Name = Compaq DECnet-Plus for OpenVMS ,
          Version = "V7.3 30-DEC-2000 01:14:34.32"
          ]
        }
      Script Location             = <Default value>
      Maximum Listeners           = 0
      Listener Template           = <Default value>
      Secondary Names             =
        {
           LOCAL:.NEMYA
        }

    Counters

      Creation Time               = 2001-02-05-11:53:38.135-05:00Iinf
      Renames                     = 1
      Changes of ID               = 9
      IDROM Check Failures        = 0
      Changes of Address          = 0

    Node 0 Session Control Port SCL$PORT$12010029
    at 2001-02-26-10:35:30.230-05:00I526.997

    Identifiers

      Name                        = SCL$PORT$12010029

    Status

      Client                      = Session Control Application 42
      Local End User Address      = UIC = [0,0]SYSTEM
      Transport Port              = OSI Transport Port OSI$PORT_0_002A
      Direction                   = Outgoing
      Remote End User Address     = number = 42
      Node Name Sent              = DEC:.LKR.NEMYA
      Version Sent                = V3
      Outgoing Network Priority   = 0
      Incoming Network Priority   = 0
      Process Identifier          = "00000127"

    Counters

      Creation Time               = 2001-02-26-10:33:14.104-05:00I526.966

    Node 0 Session Control Port SCL$PORT$1201002A
    at 2001-02-26-10:35:30.230-05:00I526.997

    Identifiers

      Name                        = SCL$PORT$1201002A

    Status

      Client                      = Session Control Application 42
      Local End User Address      = number = 42
      Transport Port              = OSI Transport Port OSI$PORT_0_002B
      Direction                   = Incoming
      Remote End User Address     = UIC = [0,0]SYSTEM
      Node Name Sent              = DEC:.LKR.NEMYA
      Version Sent                = V3
      Outgoing Network Priority   = 0
      Incoming Network Priority   = 0
      Process Identifier          = "00000115"

    Counters

      Creation Time               = 2001-02-26-10:33:14.112-05:00I526.966

    Node 0 Session Control Port SCL$PORT$1201002D
    at 2001-02-26-10:35:30.230-05:00I526.997

    Identifiers

      Name                        = SCL$PORT$1201002D

    Status

      Client                      = Session Control Application 42
      Local End User Address      = UIC = [0,0]SYSTEM
      Transport Port              = OSI Transport Port OSI$PORT_0_002E
      Direction                   = Outgoing
      Remote End User Address     = number = 42
      Node Name Sent              = DEC:.LKR.NEMYA
      Version Sent                = V3
      Outgoing Network Priority   = 0
      Incoming Network Priority   = 0
      Process Identifier          = "0000012C"

    Counters

      Creation Time               = 2001-02-26-10:35:19.522-05:00I526.996

    Node 0 Session Control Port SCL$PORT$1201002E
    at 2001-02-26-10:35:30.231-05:00I526.997

    Identifiers

      Name                        = SCL$PORT$1201002E

    Status

      Client                      = Session Control Application 42
      Local End User Address      = number = 42
      Transport Port              = OSI Transport Port OSI$PORT_0_002F
      Direction                   = Incoming
      Remote End User Address     = UIC = [0,0]SYSTEM
      Node Name Sent              = DEC:.LKR.NEMYA
      Version Sent                = V3
      Outgoing Network Priority   = 0
      Incoming Network Priority   = 0
      Process Identifier          = "00000115"

    Counters

      Creation Time               = 2001-02-26-10:35:19.529-05:00I526.996

    Node 0 Session Control
    at 2001-02-26-10:35:32.081-05:00I526.997

    Counters

      Creation Time               = 2001-02-06-23:56:24.297-05:00Iinf
      Access Control Violations   = 0
      Backtranslation Deletions   = 0
      Deleted Maintained Objects  = 0
      Dangling Links              = 0
      Verification Failures       = 0
    $

> The SHOW NETWORK/FULL command in this example displays all the information available about all the network services registered on the local node.

Previous | Next | Contents | Index

| privacy and legal statement |
9996PRO_071.HTML