[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

SHOW POOL

Displays information about the disposition of paged and nonpaged memory, nonpaged dynamic storage pool, and paged dynamic storage pool.

Format

SHOW POOL [range][/ALL|/FREE|/HEADER|/NONPAGED| /PAGED|/RING_BUFFER|/STATISTICS| /SUMMARY|/TYPE=block-type]


Parameters

range

Range of virtual addresses in pool that SDA is to examine. You can express a range using the following format:
m:n Range of virtual addresses in pool from m to n
m;n Range of virtual addresses in pool starting at m and continuing for n bytes

Qualifiers

/ALL

Displays the entire contents of allocated pool, including the pool lists, nonpaged dynamic storage pool, and paged dynamic storage pool. This is the default behavior of the SHOW POOL command.

/FREE

Displays the entire contents, both allocated and free, of the specified region or regions of pool. You cannot use the /FREE qualifier when you use a range to indicate a region of pool to be displayed.

/HEADER

Displays only the first 16 longwords of each data block found within the specified region or regions of pool.

/NONPAGED

Displays the contents of the nonpaged dynamic storage pool currently in use.

/PAGED

Displays the contents of the paged dynamic storage pool currently in use.

/RING_BUFFER

Displays the contents of the nonpaged pool history ring buffer if pool-checking has been enabled. Entries are displayed in reverse chronological order, that is, the most recent to the least recent. You cannot use this qualifier with any other SHOW POOL qualifier. This qualifier is most useful when analyzing crash dumps; output might not be consistent when used on a running system.

/STATISTICS

Displays usage statistics about each pool list if pool-checking has been enabled. For each list, the following are displayed:

/SUMMARY

Displays only an allocation summary for each specified region of pool.

/TYPE=block-type

Displays the blocks within the specified region or regions of pool that are of the indicated block-type. If SDA finds no blocks of that type in the pool region, it displays a blank screen, followed by an allocation summary of the region.

Description

The SHOW POOL command displays information about the contents of any specified region of pool in an 8-column format. Following are explanations and examples of the contents of the full display.

Examples

#1

SDA> SHOW POOL G0BADE00;260
Non-paged dynamic storage pool
------------------------------
                    Dump of blocks allocated from non-paged pool
  
  
CIMSG   80BADE00   144
                     001000DA 003C0090 0000A900 00036FF0 .o........<.....
                     D9B3001C 00000000 A0B5001D 35E60017 ...5............
                     41414141 00000600 65EA0004 00000600 .......e....AAAA
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
   .
   .
   .
UNKNOWN 80BADE90   112
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
                     41414141 41414141 41414141 41414141 AAAAAAAAAAAAAAAA
   .
   .
   .
CIDG    80BADED0   144
                     807708BB 003B0090 0004D7E0 000008F0 ..........;...w.
                     61616161 61616161 61616161 016CE87C ..l.aaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
   .
   .
   .
UNKNOWN 80BADF60    64
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
   .
   .
   .
CIDG    80BADFA0   144
                     807708BB 003B0090 0003FFC0 0004B1B0 ..........;...w.
                     61616161 61616161 61616161 016CE94C L.l.aaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
   .
   .
   .
UNKNOWN 80BAE030    48
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
                     61616161 61616161 61616161 61616161 aaaaaaaaaaaaaaaa
  
  
Summary of non-paged pool contents
  
    3  UNKNOWN   =      176  (29%)
    2  CIDG      =      288  (48%)
    1  CIMSG     =      144  (24%)
  
Total space used = 608 out of 608 total bytes, 0 bytes left
  
Total space utilization = 100%
 
      

This example, which uses a range of values, examines 608 (26016) bytes of nonpaged pool, starting at address 80BADE0016. SDA attempts to identify allocated blocks as it proceeds through the specified region of pool, and displays an allocation summary when it completes the listing.

#2

SDA> SHOW POOL/FREE
Non-paged dynamic storage pool 
------------------------------ 
 
   Dump of blocks allocated from non-paged pool 
 
UNKNOWN 80E7C400 67136 
                         0000E53B 80E9EC00 00010000 80F16625 %fñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010001 80F16625 %fñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010000 80F166A3 £fñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010001 80F166A3 £fñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010000 80F16041 A`ñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010001 80F16041 A`ñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010000 80F16F32 2oñ......ìé.;å.. 
                         0000E53B 80E9EC00 00010001 80F16F32 2oñ......ìé.;å.. 
                         0000E53D 80EA1B08 00010000 80F16F48 Hoñ.......ê.=å.. 
                         0000E53D 80E9EC00 00010001 80F16F48 Hoñ......ìé.=å.. 
                         0000E53D 80E9EC00 00010000 80F170D8 Øpñ......ìé.=å.. 
    . 
    . 
    .  
 
 
      

The SHOW POOL/FREE command in this example produces a display similar in format and extent to that presented in Example 1. However, it displays the unallocated portions of pool in addition to those that are used.

#3

SDA>  SHOW POOL/PAGED/HEADER
Paged dynamic storage pool
--------------------------
                    Dump of blocks allocated from paged pool
  
  
RSHT    8024FE00   528
                     802DC710 00380210 00000000 FFFFFF80 ..........8...-.
LNM     80250010    96
                     8015B847 00400060 802D75A0 00000000 .....u-.`.@.G...
LNM     80250070    48
                     8015B847 01400030 802500A0 802D7400 .t-...%.0.@.G...
LNM     802500A0    96
                     8015B847 02400060 802DC170 80250070 p.%.p.-.`.@.G...
LNM     80250100    48
                     8015B847 00400030 802DC510 802E1B60 `.....-.0.@.G...
   .
   .
   .
 
      

The SHOW POOL/PAGED/HEADER command displays only the name of each block allocated from paged pool, its starting address, its size, and the first four longwords of its contents.

#4

SDA SHOW POOL/RING_BUFFER
   (Non-Paged Pool History Ring-Buffer 
    (512 entries: Most recent first) 
   Packet Adr  Size  Type  Subtype Caller's PC   Routine called      Entry Adr 
    --------  -----  -----  ----    --------    ---------------      -------- 
    DA9EE5C0    168  IRP      3     D8012BF1    EXE$DEANONPAGED      DA4C7750 
    DAA27EC0    192  DSRV     3     DA591941    EXE$DEANONPAGED      DA4C7740 
    DAD47B40    168  IRP      0     DA591918    EXE$DEANONPAGED      DA4C7730 
    DAAB5400     24  FRK     52     DA590252    EXE$DEANONPAGED      DA4C7720 
    DAAB5400     24  TQE      0     DA591276    EXE$ALONONPAGED      DA4C7710 
    DAD47B40    168  IRP     64     DA59184A    EXE$ALONONPAGED      DA4C7700 
    . 
    . 
    . 
    DAA66500    172  IRP     64     DB251C80    EXE$ALONONPAGED      DA4C7770 
    DAA32300    192  CIMSG    0     DA54C2C8    EXE$DEANONPAGED      DA4C7760 
 
 
 
      

This example of the SHOW POOL/RING_BUFFER command displays the contents of the nonpaged pool history ring buffer, with the most recent entries displayed first.

#5

SDA SHOW POOL/STATISTICS
        List head    List      Alloc.        Alloc. 
         Address     Size     Attempts      Failures      Deallocs. 
        --------    -----    ----------    ----------    ---------- 
        D80A9030       64       2077039          1121       2073964 
        D80A9038      128       6323789          4502       6309357 
        D80A9040      192      21085351          1903      21078538 
        D80A9048      256        502388          2025        499705 
        D80A9050      320       1372168          3512       1367707 
        D80A9058      384         32649           774         31899 
        D80A9060      448       2463316          1025       2462243 
        D80A9068      512        357170          2181        354754 
        D80A9070      576        293998          2438        291476 
        D80A9078      640        168145           645        167482 
        D80A9080      704         83645          2043         81547 
        D80A9088      768         34852           120         34726 
        D80A9090      832         21263            44         21215 
        . 
        . 
        . 
        D80A9290     4928       2305645          3283       2302249 
        D80A9298     4992             9             0             6 
        D80A92A0     5056             0             0             0 
        D80A92A8     5120             1             0             0 
 
 
      

This example of the SHOW POOL/STATISTICS command displays usage statistics about each pool list.

#6

SDA SHOW POOL/SUMMARY
Summary of non-paged pool contents 
 
  145  UNKNOWN   =   191616  (18%) 
    2  ADP       =     1280  (0%) 
   35  ACB       =     2624  (0%) 
    3  AQB       =      192  (0%) 
   17  CRB       =     2368  (0%) 
   16  DDB       =     2048  (0%) 
  355  FCB       =   113600  (11%) 
    3  FRK       =    18240  (1%) 
   16  IDB       =     1088  (0%) 
   42  IRP       =     8064  (0%) 
   20  PCB       =    10240  (1%) 
   48  TQE       =     3072  (0%) 
   70  UCB       =    21696  (2%) 
    5  VCB       =     1280  (0%) 
  299  WCB       =    51008  (5%) 
  287  BUFIO     =   112128  (11%) 
    5  TYPAHD    =     1920  (0%) 
    2  MVL       =     4736  (0%) 
    3  NET       =     4160  (0%) 
   15  CXB       =    23616  (2%) 
    5  NDB       =     2112  (0%) 
   14  DPT       =   132928  (13%) 
   .
   .
   .
 
Total space used = 1016896 out of 1068032 total bytes, 51136 bytes left 
 
Total space utilization = 95% 
 
Summary of paged pool contents 
 
   33  UNKNOWN   =    36480  (15%) 
    1  PQB       =     2256  (0%) 
  224  GSD       =    14240  (6%) 
  153  KFE       =    10864  (4%) 
    3  MTL       =       96  (0%) 
  118  KFRH      =    46736  (20%) 
    1  RSHT      =      528  (0%) 
    1  XWB       =    18048  (7%) 
  225  LNM       =    16720  (7%) 
    4  KFD       =      224  (0%) 
    1  KFPB      =       16  (0%) 
    2  CIA       =    29264  (12%) 
    1  CHIP      =     9216  (4%) 
   41  ORB       =     5248  (2%) 
    2  ARB       =    34912  (15%) 
    1  PTC       =     3072  (1%) 
    7  OCB       =     1344  (0%) 
    1  PGD       =      208  (0%) 
 
Total space used = 229472 out of 524800 total bytes, 295328 bytes left 
 
Total space utilization = 43% 
 
 
      

This example of the SHOW POOL/SUMMARY command displays an allocation summary for each region of pool.

SHOW PORTS

Displays those portions of the port descriptor table (PDT) that are port independent.

Format

SHOW PORTS [/qualifier[,...]]


Parameters

None.

Qualifiers

/ADDRESS=pdt-address

Displays the specified port descriptor table (PDT).10

/BUS[=bus-address]

Displays BUS (LAN device) structure data.

/CHANNEL[=channel-address]

Displays channel (CH) data.

/DEVICE

Displays the network path description for a channel.

/MESSAGE

Displays the message data associated with a virtual circuit (VC).

/NODE=name

Displays virtual circuit (VC) information associated with the named node on the specified PDT. You must use this qualifier with /ADDRESS qualifier.

/VC[=vc-address]

Displays the virtual circuit data.

Description

The SHOW PORTS command provides port-independent information from the port descriptor table (PDT) for those CI ports with full SCS connections. This information is used by all system communications services (SCS) port drivers.

Note that the SHOW PORTS command does not display similar information about UDA ports, BDA ports, and similar controllers.

The SHOW PORTS command also defines symbols for PEDRIVER based on the cluster configuration. These symbols include the following information:

The following symbols are defined automatically:
Symbol Explanation or Example
VC_nodename VC_NODE1, address of the local node's virtual circuit to node NODE1
CH_nodename The preferred channel for the virtual circuit; for example, CH_NODE1, address of the local node's preferred channel to node NODE1
BUS_busname BUS_ETA, address of the local node's BUS structure associated with LAN adapter ETA0
PE_PDT Address of PEDRIVER's port descriptor table
MGMT_VCRP_busname MGMT_VCRP_ETA, address of the management VCRP for BUS ETA
HELLO_VCRP_busname HELLO_VCRP_ETA, address of the HELLO message VCRP for BUS ETA
VCIB_busname VCIB_ETA, address of the VCIB for BUS ETA
UCB_LAVC_busname UCB_LAVC_ETA, address of the LAN device's UCB used for the local area VAXcluster protocol
UCB0_LAVC_busname UCB0_LAVC_ETA, address of the LAN device's template UCB
LDC_LAVC_busname LDC_LAVC_ETA, address of the LDC structure associated with LAN device ETA
LSB_LAVC_busname LSB_LAVC_ETA, address of the LSB structure associated with LAN device ETA

These symbols equate to system addresses for the corresponding data structures. You can use these symbols, or an address, after the equal sign in SDA commands.

The SHOW PORTS command produces several displays. The initial display, the PDT summary page, lists the PDT address, port type, device name, and driver name for each PDT. Subsequent displays provide information taken from each PDT listed on the summary page.

You can use the /ADDRESS qualifier of the SHOW PORTS command to produce more detailed information about a specific port. The first display of the SHOW PORTS/ADDRESS command duplicates the last display of the SHOW PORTS command, listing information stored in the port's PDT. Subsequent displays list information about the port blocks and virtual circuits associated with the port.


Examples

#1

SDA> SHOW PORTS/ADDR=PE_PDT
      


VAXcluster data structures 
-------------------------- 
 
                  --- Port Descriptor Table (PDT) 806C37A0 --- 
 
Type: 03 pe 
Characteristics: 0000 
 
Msg Header Size           32  Connect        80799F94  Recyclh_Msg_Buf  8079AD8A 
Max Xfer Bcnt       FFFFFFFF  Dealloc_Dg_Buf 8079AFDA  Request_Data     8079B1CC 
DG Header Size           288  Disconnect     8079A06B  Send_Data        8079B215 
Poller Sweep              31  Unmap          8079B510  Send_Dg_Buf      8079B03E 
Fork Block W.Q.        empty  Map            8079B111  Send_Msg_Buf     8079AEA8 
UCB Address         806C0E50  Map_Bypass     8079B0F8  Send_Cnt_Msg_Buf 8079AEAF 
ADP Address         00000000  Map_Irp        8079B101  Read_Count       80796D59 
Accept              80799FEC  Map_Irp_Bypass 8079B0F0  Rls_Read_Count   80796DD3 
Alloc_Dg_Buf        8079AFC6  Queue_Dg_Buf   8079AFE0  Mreset           80799C94 
Alloc_Msg_Buf       8079AD05  Queue_Mult_Dgs 8079AFE8  Mstart           80799C9E 
Dealloc_Msg_Buf     8079ADE3  Recycl_Msg_Buf 8079AD94  Stop_Vcs         8079BEDD 
Dealloc_Msg_Buf_Reg 8079ADF6  Reject         8079A036  Send_Dg_Reg      8079B031 
 
 
                 --- Port Block 80B091B0 --- 
 
Status: 0001 authorize 
VC Count: 5 
Secs Since Last Zeroed: 311728 
 
SBUF Size                 436              LBUF Size              1788 
SBUF Count                 12              LBUF Count                1 
SBUF Max                  768              LBUF Max                384 
SBUF Quo                   13              LBUF Quo                  1 
SBUF Miss                  18              LBUF Miss             12235 
SBUF Allocs            499579              LBUF Allocs           16824 
SBUFs In Use                0              LBUFs In Use              0 
Peak SBUF In Use           14              Peak LBUF In Use         34 
SBUF Queue Empty            0              LBUF Queue Empty          0 
TR SBUF Queue Empty         0 
No SBUF for ACK             0 
 
Bus Addr  Bus     LAN Address    Error Count Last Error   Time of Last Error 
--------  ---  ----------------- ----------- ---------- ----------------------- 
80B08920  LCL  00-00-00-00-00-00           0 
80B08090  ESA  AA-00-04-00-33-FD          75  00000334  25-MAR-1993 23:39:28.27 
80B008B0  XQA  08-00-2B-0A-6A-6B          12  0000002C  23-MAR-1993 12:43:59.07 
80AF6E90  XQB  08-00-2B-08-CB-B8           0 
 
 
                 --- Virtual Circuit (VC) Summary --- 
 
VC Addr     Node    SCS ID  Lcl ID    Status Summary        Last Event Time 
--------  --------  ------  ------  -----------------   ----------------------- 
806CD1A0  NODE12    64819  223/DF  open,path            1-JAN-1993 00:00:00.03 
806CD6E0  NODE13    64856  222/DE  open,path            1-JAN-1993 00:00:07. 
806CD9A0  NODE14    64587  221/DD  open,path            22-MAR-1993 18:34:10.18 
8070D530  NODE15    64555  220/DC  open,path            22-MAR-1993 18:57:33. 
8074AB60  NODE16    64841  219/DB  open,path            25-MAR-1993 20:42:38.20 
 

The SHOW PORTS/ADDRESS command displays the port descriptor table (PDT) structure, some of the fields in the PORT structure, the BUS summary, and the virtual circuit summary.

#2

SDA>SHOW PORTS/BUS=BUS_ESA
      


VAXcluster data structures 
-------------------------- 
--- BUS: 80B08090  (ESA)  Device: ES_LANCE  LAN Address: AA-00-04-00-33-FD--- 
                            LAN Hardware Address: 08-00-2B-12-AE-A1 
Status: 00000A03 run,online,xmt_chaining_disabled,restart 
------- Transmit ------  ------- Receive -------  ---- Structure Addresses --- 
Msg Xmt          434107  Msg Rcv         1170090  PORT Address       80B091B0 
  Mcast Msgs     103939    Mcast Msgs     859601  VCIB Addr          80B08248 
  Mcast Bytes  13304192    Mcast Bytes  96272072  HELLO Message Addr  80B082D8 
Bytes Xmt      59789962  Bytes Rcv     146674695  BYE Message Addr    80B08468 
Outstand I/Os         0  Buffer Size        1424  Delete BUS Rtn Adr  8079E424 
Xmt Errors           75  Rcv Ring Size         8 
Last Xmt Error 00000334         Time of Last Xmt Error 25-MAR-1993 23:39:28.27 
--- Receive Errors ----  ------ BUS Timer ------  ----- Datalink Events ------ 
TR Mcast Rcv          0  Handshake TMO  8079FA50  Last 22-MAR-1993 18:25:25.12 
Rcv Bad SCSID         0  Listen TMO     8079FA54  Last Event          00001202 
Rcv Short Msg         0  HELLO timer           1  Port Usable                1 
Fail CH Alloc         0  HELLO Xmt err        38  Port Unusable              0 
Fail VC Alloc         0                           Address Change             1 
Wrong PORT            0                           Port Restart Fail          0 
 

The SHOW PORTS/BUS=BUS_id command displays the data for the specified BUS structure. The last event time is at the top of the lower right-hand column. If an error was counted, the last error time is displayed under Xmt Errors. The normal status is: RUN, ONLINE, and RESTART.

The Xmt Error field indicates a problem detected during transmission of a message. The error rate should be less than one per hour.

#3

SDA> SHOW PORTS/VC=VC_BREE
      


VAXcluster data structures 
-------------------------- 
                 --- Virtual Circuit (VC) 806CD6E0 --- 
Remote System Name:  BREE   (0:VAX)     Remote SCSSYSTEMID:  64856 
Local System ID:  222 (DE)              Status: 0005 open,path 
------ Transmit -------  ------ VC Closures ----  ---- Congestion Control ---- 
Msg Xmt          216686  SeqMsg TMO            0  UnAcked Msgs               1 
  Unsequence          3  CC DFQ Empty          0  Pipe Quota Reached        33 
  Sequence       149643  Topology Change       0  CMD Queue Len              0 
  ReXmt             545  NPAGEDYN Low          0  Max CMD Queue Len          5 
  Lone ACK        66495                           RSVP Threshold            15 
Bytes Xmt      33309074                           Pipe Quota                31 
------- Receive -------  - Messages  Discarded -  ----- Channel Selection ---- 
Msg Rcv          194492  No Xmt Chan           0  Preferred Channel   80704320 
  Unsequence          1  Rcv Short Msg         0  Delay Time          FB7E6F80 
  Sequence       178905  Illegal Seq Msg       0  Buffer Size             1424 
  ReRcv              30  Bad Checksum          0  Channel Count              6 
  Lone ACK        15531  TR DFQ Empty          0  Channel Selections      3920 
  Cache              26  TR MFQ Empty          0  Protocol               1.3.0 
  Ill ACK             0  CC MFQ Empty          0  Open  1-JAN-1993 00:00:07.03 
Bytes Rcv      52086897  Cache Miss            0  Cls  17-NOV-1858 00:00:00.00 
 
 
        -- Channel Summary for Virtual Circuit (BREE  ) 806CD6E0 -- 
 
Address     Type    Xmt Time Size Preferred    Best        Last State Change 
--------  --------- -------- ---- ---------  --------   ----------------------- 
80704320  Preferred FB7E6F80 1424       812       617   22-MAR-1993 18:14:07.01 
807043E0  Active    FB7E735E 1424        95         4   25-MAR-1993 20:01:15.18 
807050D0  Active    FB7E7FED 1424       431         0   25-MAR-1993 20:01:15.18 
806CD820  Active    FB7E728E 1424       868      1470   25-MAR-1993 20:01:15.18 
80705010  Active    FB7E7043 1424       738         9   25-MAR-1993 20:00:58.17 
806CD8E0  Active    FB7E7BB5 1424       976      1744   25-MAR-1993 20:00:31.17 

Note

10 You can find the pdt-address for any active connection on the system in the PDT summary page display of the SHOW PORTS command. This command also defines the symbol PE_PDT. CDT addresses are also stored in many individual data structures related to SCS connections; for instance, in the path block displays of the SHOW CLUSTER/SCS command.


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_013.HTML