DISPLAY CSMUSE command


                               .-,--POOL--=--ALL----------.   
>>-DISPLAY-- --NET--,--CSMUSE--+--------------------------+----->
                               '-,--POOL--=--+-ALL------+-'   
                                             '-poolname-'     

   .-,--OWNERID--=--ALL---------.   
>--+----------------------------+------------------------------><
   '-,--OWNERID--=--+-ALL-----+-'   
                    '-ownerid-'

Abbreviations

Operand	Abbreviation
DISPLAY	D

Purpose

Using the output of the DISPLAY CSMUSE command, IBM® service can evaluate the use of storage managed by the communications storage manager (CSM). Although this command is similar to the DISPLAY CSM command, it provides a lower level of detail regarding storage usage, and therefore the output of this command is different from that of DISPLAY CSM.

This command is primarily intended for IBM service. However, it can also be beneficial to the user. The display output provides detailed information about each CSM storage pool. The detailed information describes storage as it corresponds to an identifier, which is referred to as a monitor ID. Monitor IDs describe specific z/OS® Communications Server components. When CSM storage is associated with (or isolated to) a specific monitor ID, then IBM service can correlate the monitor ID to a component (usage or function) of z/OS Communications Server. This information can be useful when evaluating how z/OS Communications Server is using system storage or to help diagnose storage growth. See z/OS Communications Server: IP and SNA Codes for the complete description of monitor IDs.

The CSM monitor IDs are associated with the CSM monitor function. The display output from this command will always provide monitor IDs even when the monitor is inactive. However, the display output will be much more useful when the CSM monitor is active (an active monitor will provide closer tracking). To determine if the CSM monitor is active, see the DISPLAY CSM command.

You can use this command to see up to four monitor ID/OWNERID pairs using the most CSM storage for each pool.

This command is routed to CSM so that VTAM® does not have to be operational when you issue this command.

Operands

POOL

Specifies whether to display information about the amount of storage in use by all pools or a specific pool. The POOL is the pool name of the CSM storage pool. OWNERID can be specified with the pool. When POOL is specified on the command, CSM displays up to four monitor IDs with the amount of storage and the buffer's user data field and monitor history field. The user data field allows IBM service to correlate the current usage and history to a specific resource, such as a device, connection, route, and so on. The monitor IDs are displayed in the order of highest to lowest storage usage in the messages.

The default value of POOL is ALL.

POOL=ALL

A summary is provided for all CSM pools.

POOL=poolname

Specifies the poolname of the CSM storage pool.

The following list shows valid CSM pool names and their explanations:

4KECSA: 4-KB buffer size ECSA storage pool.
16KECSA: 16-KB buffer size ECSA storage pool.
32KECSA: 32-KB buffer size ECSA storage pool.
60KECSA: 60-KB buffer size ECSA storage pool.
180KECSA: 180-KB buffer size ECSA storage pool.
4KDS: 4-KB buffer size data space storage pool.
16KDS: 16-KB buffer size data space storage pool.
32KDS: 32-KB buffer size data space storage pool.
60KDS: 60-KB buffer size data space storage pool.
180KDS: 180-KB buffer size data space storage pool.
4KDS64: 4-KB buffer size data space backed by 64-bit real storage pool.
16KDS64: 16-KB buffer size data space backed by 64-bit real storage pool.
32KDS64: 32-KB buffer size data space backed by 64-bit real storage pool.
60KDS64: 60-KB buffer size data space backed by 64-bit real storage pool.
180KDS64: 180-KB buffer size data space backed by 64-bit real storage pool.

OWNERID

Specifies whether to display information about the amount of storage owned by all owners or a specific owner. The owner ID is the halfword address space identifier (ASID) of a CSM buffer owner. ASID values are in hexadecimal format and range from 1–7FFF. If OWNERID is not specified, this command displays the total storage allocated to the pool by the storage pool source.

OWNERID=ALL: Produces the same display as if OWNERID was not specified.
OWNERID=ownerid: Specifies that the storage owned by the specified owner ID be displayed.

Resulting display

Storage amounts are displayed in units of K (kilobytes) or M (megabytes).

Examples

Displaying information about storage managed and used by CSM for all owners:

d net,csmuse
IVT5508I DISPLAY ACCEPTED                                    
IVT5572I PROCESSING DISPLAY CSMUSE COMMAND - OWNERID NOT SPECIFIED
IVT5532I ------------------------------------------------------        
IVT5575I USAGE SUMMARY - 4KECSA   POOL TOTAL (ALL USERS)  =       60K  
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                   
IVT5577I       24K      B1         0029      TCPCS                     
IVT5577I       24K      21         0028      VTAMCS                    
IVT5578I DISPLAY TOTAL FOR 4KECSA   POOL (2 USERS)        =       48K  
IVT5532I ------------------------------------------------------        
IVT5575I USAGE SUMMARY - 32KECSA  POOL TOTAL (ALL USERS)  =       32K  
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                   
IVT5577I       32K      B1         0029      TCPCS                     
IVT5578I DISPLAY TOTAL FOR 32KECSA  POOL (1 USERS)        =       32K  
IVT5532I ------------------------------------------------------        
IVT5575I USAGE SUMMARY - 4KDS64   POOL TOTAL (ALL USERS)  =       24K  
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                   
IVT5577I       20K      21         0028      VTAMCS                    
IVT5578I DISPLAY TOTAL FOR 4KDS64   POOL (1 USERS)        =       20K  
IVT5599I END

Tips:

This is the summary information (when ALL pools specified or defaulted).
An operator can also use OWNERID of the user with this command and monitor one user.
A pool will not be displayed if there is no storage in use or it does not match the provided OWNERID.
An operator can get more details about a specific pool if poolname is specified.
Although CSM storage will always have an associated monitor ID even when the CSM Monitor is not active, the monitor IDs are tracked (monitored and updated) more closely when the CSM monitor is active.
See z/OS Communications Server: IP and SNA Codes for the description of monitor IDs.

Guideline: Under each pool summary, monitor IDs are no longer listed when 75% of the pool total usage or a maximum of four monitor ID and OWNERID pairs is reached. They are listed in the order by highest to lowest storage usage. It will display at least one pair of monitor ID and OWNERID usage.

The new display CSMUSE command with the ownerid operand and its output:

d net,csmuse,ownerid=0029
IVT5508I DISPLAY ACCEPTED                                     
IVT5573I PROCESSING DISPLAY CSMUSE COMMAND - OWNERID SPECIFIED
IVT5557I OWNERID: ASID = 0029  JOBNAME = TCPCS                          
IVT5532I ------------------------------------------------------         
IVT5575I USAGE SUMMARY - 4KECSA   POOL TOTAL (ALL USERS)  =       56K   
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                    
IVT5577I       36K      B1         0029      TCPCS                      
IVT5589I DISPLAY TOTAL FOR 4KECSA   POOL FOR THIS OWNERID =       36K   
IVT5532I ------------------------------------------------------         
IVT5575I USAGE SUMMARY - 32KECSA  POOL TOTAL (ALL USERS)  =       32K   
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                    
IVT5577I       32K      B1         0029      TCPCS                      
IVT5589I DISPLAY TOTAL FOR 32KECSA  POOL FOR THIS OWNERID =       32K   
IVT5532I ------------------------------------------------------         
IVT5575I USAGE SUMMARY - 4KDS64   POOL TOTAL (ALL USERS)  =       24K   
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                    
IVT5577I        4K      B1         0029      TCPCS                      
IVT5589I DISPLAY TOTAL FOR 4KDS64   POOL FOR THIS OWNERID =        4K   
IVT5599I END

The new display CSMUSE command with the pool operand and its output:

d net,csmuse,pool=4kecsa
IVT5508I DISPLAY ACCEPTED                                   
IVT5574I PROCESSING DISPLAY CSMUSE COMMAND - POOL SPECIFIED 
IVT5584I USAGE DETAILS - 4KECSA   POOL - POOL TOTAL =       56K       
IVT5532I ------------------------------------------------------       
IVT5576I    AMOUNT   MONITOR ID   OWNERID    JOBNAME                  
IVT5532I ------------------------------------------------------       
IVT5577I       24K      B1         0029      TCPCS                    
IVT5579I BUFFER USE FOR B1 :   USECNT  USERDATA   MONITOR HISTORY     
IVT5580I                            3  15352C90       000000B1        
IVT5580I                            2  15352C88       000000B1        
IVT5580I                            1  15352C98       000000B1        
IVT5580I                            1  15352CA8       000000B1        
IVT5532I ------------------------------------------------------       
IVT5577I       20K      21         0028      VTAMCS                   
IVT5579I BUFFER USE FOR 21 :   USECNT  USERDATA   MONITOR HISTORY     
IVT5580I                            5  F0C4F0F0       00000021        
IVT5585I DETAIL TOTAL FOR 4KECSA   POOL =       44K                   
IVT5599I END

Tips:

This is an example of the detailed CSM usage information (when a specific pool is specified).
For each CSM monitor ID, the user data field and monitor history field from the CSM buffer headers is provided. Using the user data field, IBM service can correlate the current usage and monitor history to a specific resource, such as a device, connection, and route.
The display is similar to poolname=all (summary) with the addition of IVT5579I and IVT5580I. This display is most useful when CSM MONITOR is active.
This detailed output provides details of the same monitor IDs that were provided in the summary display (for example, if the summary output provided only one monitor ID, then the detailed display will provide information about one monitor ID).
Under each monitor ID, more detailed buffer usage information is provided. A list of up to four usage pairs (user data and monitor ID history) are provided. The usage pairs are listed in order of highest to lowest number of times a matching usage pair was found. The use count is counted only once per CSM buffer even when multiple matching usage pairs exist for the same buffer. A usage pair match is counted for either a CSM primary buffer or image buffer usage, but not both (or multiple images) for the same CSM buffer. A CSM buffer may have multiple concurrent usages that have both matching and unmatching usage pairs, and therefore some CSM buffers may be counted multiple times.
An operator can also specify OWNERID of the user with the poolname and monitor one user (specific TCP stack or VTAM).