DISPLAY STORUSE command

Display storage usage for applications:

Display storage usage for application jobs:

Display storage usage for data spaces:

Display storage usage for storage pools:

Abbreviations

Operand	Abbreviation
DISPLAY	D

Purpose

The DISPLAY STORUSE (storage usage) command provides storage usage information for VTAM® data spaces, modules, and storage pools.

You can specify one of the following names:

Application name
Application job name
Data space name
Storage pool name

Operands

APPL

Specifies the applications for which storage usage will be displayed.

APPL=appl_name: Displays storage usage for one or more applications.
APPL=*: Displays storage usage for all applications.

DSPNAME

Specifies the data spaces for which storage usage information will be displayed.

DSPNAME=data_space_name: Displays storage usage for one or more VTAM data spaces.
DSPNAME=*: Displays storage usage for all VTAM data spaces.

JOBNAME

Specifies the VTAM application jobs for which storage usage will be displayed.

JOBNAME=appl_job_name: Displays storage usage for one or more VTAM application jobs.
JOBNAME=*: Displays storage usage for all VTAM application jobs.

LIST

Specifies whether storage information should be displayed about all pools or only those currently in use.

The LIST operand is valid only when all GETBLK pools are being displayed and the POOL, DSPNAME, APPLNAME, and JOBNAME operands are omitted from the DISPLAY STORUSE command.

LIST=ALL: Displays storage information about all pools, regardless of whether storage is currently allocated from that storage pool.
LIST=INUSE: Displays storage information only for pools that have been currently allocated from that storage pool.

MAX

Specifies the maximum number of output lines that VTAM displays for this command.

MAX=*: Specifies that the value of the DSPLYMAX start option limits the display output.
MAX=number_of_resources: Specifies the number of applications, application jobs, data spaces, or storage pools for which VTAM displays storage usage. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.
Specifying MAX limits the display output. VTAM searches only for the number of instances that you have specified, stopping when it reaches that number. VTAM does not search any further. This saves processing time and gives you control over the amount of display output generated by the command. If fewer applications, application jobs, data spaces, or storage pools are found than you have specified on MAX, VTAM displays only the storage usage information for those found.

NUM

A synonym for the MAX operand.

POOL

Specifies the VTAM storage pools for which storage usage will be displayed. Use * to display a list of valid pool names available in your system.

POOL=storage_pool_name: Displays storage usage for one or more VTAM storage pools.
POOL=SUMMARY: Displays storage usage collectively for all storage pools and modules.
The information supplied by SUMMARY is independent of the information supplied by storage_pool_name. SUMMARY can be specified with or without storage_pool_name.
POOL=*: Displays storage usage collectively and individually for all VTAM storage pools, and collectively for all VTAM modules.
For descriptions of the functions and characteristics of the storage pools displayed, see the z/OS Communications Server: SNA Network Implementation Guide.

POOLTYPE

Specifies the type of pools for which storage information is to be displayed.

The POOLTYPE operand is valid only when all GETBLK pools are being displayed and the POOL, DSPNAME, APPLNAME, and JOBNAME operands are omitted from the DISPLAY STORUSE command.

POOLTYPE=ALL: Displays storage information about all pools.
POOLTYPE=CSA: Displays storage information only for pools in common service area (CSA) storage.
POOLTYPE=HVCOMM: Displays storage information only for pools in 64-bit high virtual common (HVCOMM) storage.
POOLTYPE=PRIVATE: Displays storage information only for pools in VTAM private storage.

Resulting display

The resulting display shows:

Pool name or data space name
Job name
Application name
Number of applications
Current storage
Maximum storage

Examples

Displaying storage usage for a specific pool:

d net,storuse,pool=sibext
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1242I POOL     CURRENT MAXIMUM
IST1243I SIBEXT       128     128
IST1454I 1 POOL(S) DISPLAYED
IST314I END

Displaying storage usage for pools, limiting output to five resources:

d net,storuse,max=5
IST097I  DISPLAY ACCEPTED
IST350I  DISPLAY TYPE = STORAGE USAGE
IST1242I  POOL     CURRENT MAXIMUM  POOL     CURRENT MAXIMUM
IST1243I  ACDEB          4       4  ACPCB          0       0
IST1243I  ADJCP          8       8  ADJNODE        0       0
IST1243I  ANDCB          0       0
IST1315I  DISPLAY TRUNCATED AT MAX = 5
IST1454I  5 RESOURCE(S) DISPLAYED
IST924I  --------------------------------------------------------
IST1244I  TOTAL PRIVATE  POOL STORAGE USAGE:     228     228
IST1244I  TOTAL COMMON   POOL STORAGE USAGE:      64      64
IST1244I  TOTAL HVCOMM   POOL STORAGE USAGE:     768     842
IST924I -------------------------------------------------------------
IST981I  VTAM PRIVATE: CURRENT = 5208K, MAXIMUM USED = 5253K
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1384K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 5205K
IST314I  END

Displaying storage usage for pools, in CSA storage that have been currently allocated from that storage pool:

d net,storuse,pooltype=csa,list=inuse
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1242I POOL     CURRENT MAXIMUM  POOL     CURRENT MAXIMUM
IST1243I COS           16      16  CPWACSA        4       4
IST1243I CPWAPVT        4       4  EPTDVT         8       8
IST1243I ERICPOOL       8       8  ERTE           4       4
IST1243I FMCB          16      16  NDREC          8       8
IST1243I RUPEPRIV      16      16  UTILPVTS      20      20
IST1454I 10 POOL(S) DISPLAYED
IST924I -------------------------------------------------------------
IST1244I TOTAL PRIVATE  POOL STORAGE USAGE:     220     220
IST1244I TOTAL COMMON   POOL STORAGE USAGE:      68      68
IST1244I TOTAL HVCOMM   POOL STORAGE USAGE:     768     842
IST924I -------------------------------------------------------------
IST981I VTAM PRIVATE: CURRENT = 585K, MAXIMUM USED = 639K
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1384K
IST1565I CSA24 MODULES = 32K
IST1565I PRIVATE MODULES = 5500K
IST314I END

Displaying storage usage for pools, in private storage that have been currently allocated from that private storage pool:

d net,storuse,pooltype=private,list=inuse
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1242I POOL     CURRENT MAXIMUM  POOL     CURRENT MAXIMUM
IST1243I ACDEB          4       4  CDRSC         32      32
IST1243I DECB           4       4  DISKIO         8       8
IST1243I DMTSQ          4       4  FMCBEXT        4       4
IST1243I LMTABLE        4       4  NIDCB          4       4
IST1243I PAQ            8       8  POWEPRIV       8       8
IST1243I POWMPRIV       8       8  PULURDTE       4       4
IST1243I RUPECOMM       4       4  SRTE          20      20
IST1243I SSCPFMCB      16      16  UTILCSAL       4       4
IST1243I UTILCSAS      20      20  UTILPVTL      20      20
IST1243I WREEID         8       8
IST1454I 19 POOL(S) DISPLAYED
IST924I -------------------------------------------------------------
IST1244I TOTAL PRIVATE  POOL STORAGE USAGE:     220     220
IST1244I TOTAL COMMON   POOL STORAGE USAGE:      68      68
IST1244I TOTAL HVCOMM   POOL STORAGE USAGE:     768     842
IST924I -------------------------------------------------------------
IST981I VTAM PRIVATE: CURRENT = 585K, MAXIMUM USED = 639K
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1384K
IST1565I CSA24 MODULES = 32K
IST1565I PRIVATE MODULES = 5500K
IST314I END

Displaying storage usage for pools, in high virtual common:

d net,storuse,pooltype=hvcomm                                        
IST097I DISPLAY ACCEPTED                                             
IST350I DISPLAY TYPE = STORAGE USAGE                                 
IST1242I POOL     CURRENT MAXIMUM                                    
IST1243I SM3270       120     412                                    
IST1454I 1 POOL(S) DISPLAYED                                         
IST924I -------------------------------------------------------------
IST1244I TOTAL PRIVATE  POOL STORAGE USAGE:     424     436          
IST1244I TOTAL COMMON   POOL STORAGE USAGE:     108     108          
IST1244I TOTAL HVCOMM   POOL STORAGE USAGE:     120     412          
IST924I -------------------------------------------------------------
IST981I VTAM PRIVATE: CURRENT = 1218K, MAXIMUM USED = 1436K          
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1840K                                         
IST1565I CSA24 MODULES = 40K                                         
IST1565I PRIVATE MODULES = 7578K                                     
IST314I END

Displaying storage usage for all data spaces, limiting output to 6 resources:

d net,storuse,dspname=*,max=6
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1238I DSPNAME  CURRENT MAXIMUM  QUEUED
IST1239I ISTNMPDS       0       0       0
IST1239I ISTNMSDS       0       0       0
IST924I -------------------------------------------------------------
IST1240I DSPNAME  CURRENT MAXIMUM JOBNAME  APPL     COUNT
IST1241I ISTFC8E0       8       8 VTAM     SSCP1A   1
IST1241I IST68072       0       0 ECHO     APPL1    1
IST1241I IST72596       0       0 ECHO     APPL2    1
IST1241I IST30B99       0       0 ECHO     APPL3    1
IST1454I 6 DSPNAME(S) DISPLAYED
IST314I END

Displaying storage usage for a specific data space:

d net,storuse,dspname=istnmsds
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1238I DSPNAME  CURRENT MAXIMUM  QUEUED
IST1239I ISTNMSDS       0       0       0
IST1454I 1 DSPNAME(S) DISPLAYED
IST314I END

Displaying storage usage for all applications, limiting output to four resources:

d net,storuse,appl=*,max=4
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1240I DSPNAME  CURRENT MAXIMUM JOBNAME  APPL     COUNT
IST1241I ISTFC8E0       8       8 VTAM     SSCP1A   1
IST1241I IST68072       0       0 ECHO     APPL1    1
IST1241I IST72596       0       0 ECHO     APPL2    1
IST1241I IST30B99       0       0 ECHO     APPL3    1
IST1315I DISPLAY TRUNCATED AT MAX = 4
IST1454I 4 APPL(S) DISPLAYED
IST314I END

Displaying storage usage for a specific job:

d net,storuse,jobname=echo31e
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1240I DSPNAME  CURRENT MAXIMUM JOBNAME  APPL     COUNT
IST1241I 00002IST       0       0 ECHO31E  ECHO50A  1
IST1241I 00003IST       0       0 ECHO31E  ECHO50   1
IST314I END

Displaying storage usage for a specific application:

d net,storuse,appl=echo02a
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1240I DSPNAME  CURRENT MAXIMUM JOBNAME  APPL     COUNT
IST1241I 00001IST       4      16 ECHO31E  ECHO02A  1
IST314I END

Displaying storage usage summary information:

d net,storuse,pool=summary
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = STORAGE USAGE
IST1244I TOTAL PRIVATE  POOL STORAGE USAGE:     228     228
IST1244I TOTAL COMMON   POOL STORAGE USAGE:      76      76
IST1244I TOTAL HVCOMM   POOL STORAGE USAGE:     768     842
IST924I -------------------------------------------------------------
IST981I VTAM PRIVATE: CURRENT = 4550K, MAXIMUM USED = 4603K
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1384K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 5205K
IST314I END