Formatting VSM dump data

The IPCS VERBEXIT VSMDATA subcommand formats VSM control blocks.

For information about using IPCS and the syntax of the IPCS VERBEXIT VSMDATA, see z/OS MVS IPCS Commands. For information about using the VSMDATA subcommand through the IPCS dialog, see z/OS MVS IPCS User's Guide.

VERBEXIT VSMDATA CONTROLBLOCKS subcommand output

The report generated by the VERBEXIT VSMDATA subcommand formats the following VSM control blocks:

Address queue anchor table (AQAT)
Allocated element (AE)
Cell pool primary extent (PXT)
Cell pool secondary extent (SXT)
Double free element (DFE)
Descriptor queue element (DQE)
Free block queue element (FBQE)
Free queue element (FQE)
Global data area (GDA)
Local data area (LDA)
Size queue anchor table (SQAT)
Subpool queue anchors (SPQA)
Subpool queue element (SPQE)
Subpool translation table (SPTT)
VSM work area (VSWK)

The VERBX VSMDATA command also supports a SUMMARY parameter which provides a more concise report designed specifically for diagnosis of out of storage conditions. This report, generated by the VERBEXIT VSMDATA 'SUMMARY' subcommand, formats key data from the following VSM control blocks:

Address queue anchor table (AQAT)
Allocated element (AE)
Double free element (DFE)
Descriptor queue element (DQE)
Free block queue element (FBQE)
Free queue element (FQE)
Global data area (GDA)
Local data area (LDA)

This 'SUMMARY' report also generates the following:

Global storage map
Global subpool usage summary
Local storage map
Local subpool usage summary

Note: The Global and Local subpool usage summaries reflect pages that have all or some of the page allocated. You can find information on the allocation of a particular page in the VSM control blocks representing the page.

The SUMMARY option of the VSMDATA CONTROLBLOCKS report has a feature which allows for easier identification of the subpool, key, and TCB associated with a particular allocated or freemained area. Additionally, this new feature provides you with the capability of sorting the VSMDATA output by subpool, by key, by TCB, or by storage address, provided that the data is first routed to an ISPF data set.

Each line of VSMDATA output that represents an allocated or free area has data similar to the following at the far right:

TCB  006FE240 SP/K  229/ 5 hppmlaaa

This data allows for easy identification of the TCB, subpool, and key associated with a particular piece of VSM storage as represented by a line in the VSMDATA output. The character data at the far right (hppmlaaa) is a translation of the address of storage represented by this line of VSMDATA output. This translation gives you the capability of decimally sorting the data into ascending address order. This is useful when trying to identify what subpool a particular address lives in, or in trying to understand what distribution of subpools own a particular section of storage. It can also be helpful in a tuning analysis because it allows you to see the progression of storage growth within an address space.

To take advantage of the sorting capability provided by this feature, you must first append the PRINT and NOTERM keywords to the VSMDATA command to direct the output data to the IPCSPRNT data set. For example, the following command will route the data to the data set and prevent it from being displayed at the terminal:

VERBX VSMDATA 'NOG SUMMARY' PRINT NOTERM

Then, you should issue the following command to close the file :

CLOSE PRINT

After this command has completed, the output should be viewable in the IPCSPRNT data set. Under ISPF, EDIT the data set and perform the following commands:

EXCLUDE ALL

to exclude all lines from the data set

F 'SP/K' ALL

to find just the lines with the sortable data

DELETE ALL X

to get discard of all of the other lines

SORT x y

to sort the remaining line of data:

by ADDRESS: x=116, y=123
by SUBPOOL: x=109, y=111
by SUBPOOL and KEY: x=109, y=114
by TCB: x=94, y=101

Sorting the data by address places the allocated and free addresses in ascending order, making it easy to identify whether a particular address is GETMAINed or free, and if GETMAINed, to which subpool and key.

Note that this sorting technique is not effective for VSMDATA output that contains local data from multiple address spaces. VSMDATA output from an SVC dump generally contains only one address space. In the event the dump is of multiple address spaces, VSMDATA output can be limited to a single address space through the ASID or JOBNAME parameter.

VERBEXIT VSMDATA OWNCOMM subcommand output

Enter the VERBEXIT VSMDATA OWNCOMM command to display information about jobs or address spaces that hold storage in the common service area (CSA), extended CSA, system queue area (SQA), or extended SQA. The dump being analyzed with VERBEXIT VSMDATA OWNCOMM must contain the SQA and ESQA subpools. If you use the SDUMP or SDUMPX macro or the DUMP command to obtain the dump, make sure to specify the SQA option of the SDATA parameter. This ensures that the following control blocks will appear in the formatted dump.

Table 1. Summary: Control blocks in VERBEXIT VSMDATA OWNCOMM subcommand output
Control Block	Mapping Name
Address space control block (ASCB)	ASCB
Address space secondary block (ASSB)	ASSB
Common area user block (CAUB)	IGVCAUB
Getmained queue element (GQE)	IGVGQE
GQE Queue Anchor Table (GQAT)	IGVGQAT
VSM address space block (VAB)	IGVVAB

If one of these control blocks does not appear in the dump, IPCS does one of the following:

For a VERBEXIT VSMDATA OWNCOMM SUMMARY request, IPCS displays a message indicating that it cannot access the control block and stops processing the VERBEXIT VSMDATA OWNCOMM SUMMARY request.
For a VERBEXIT VSMDATA OWNCOMM DETAIL request, IPCS displays a message indicating that it cannot access the control block, and continues processing the dump.

Enter the VERBEXIT VSMDATA OWNCOMM SUMMARY command to obtain a report like the one shown in Figure 1. The report is sorted by ASID. The report displays information for all ASIDs.

Figure 1. Example: VERBEXIT VSMDATA OWNCOMM SUMMARY output

     VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE
     THE FOLLOWING KEYWORDS ARE IN EFFECT:
             OWNCOMM
             SUMMARY

******************************** GRAND TOTALS **********************************
                          Total
 Description              Length   SQA    CSA    ESQA     ECSA     CAUB
 ------------------------ -------- ------ ------ -------- -------- --------

Total SYSTEM-owned       0015ADD8 007AB0 014770 0011FD98 0001EE20 01B31378

Total for active ASIDS   00295558 0148F0 044EC0 000E4EF0 00156EB8 ********

Total for "Owner Gone"   000147D0 0012C8 00F230 000004A8 00003E30 ********

Total for "No Detail"    00000000 000000 000000 00000000 00000000 ********
                          -------- ------ ------ -------- --------
 Grand Total              00404B00 01D668 068860 00205130 00179B08
********************************************************************************
                            Total
  ASID Job Name ID       St Length   SQA    CSA    ESQA     ECSA     CAUB
  ---- -------- -------- -- -------- ------ ------ -------- -------- --------
  0000 *SYSTEM* ........ Ac 0015ADD8 007AB0 014770 0011FD98 0001EE20 01B31378
  0001 *MASTER* ........ Ac 001A79B8 010108 017348 000C5C20 000BA948 01B31418
  0002 PCAUTH   ........ Ac 00000438 000000 000000 00000438 00000000 01C09010
  0003 RASP     ........ Ac 00000CE8 000000 000000 00000CE8 00000000 01C09058
  0004 TRACE    ........ Ac 000000A8 000000 000000 000000A8 00000000 01C090A0
  0005 XCFAS    ........ Ac 000100B8 000030 000000 00010088 00000000 01C090E8
  0006 GRS      ........ Ac 000011A0 001030 000000 00000170 00000000 01C09130
  0009 DUMPSRV  ........ Ac 0000D0E8 000030 000000 0000BE80 00001238 01C09208
  000A CONSOLE  ........ Ac 00008468 0020F8 0006B8 00000270 00005A48 01C09250
  000B CATALOG  ........ OG 00012470 0002C8 00F230 00000468 00002B10 01C09298
  000C ALLOCAS  ........ Ac 00000080 000000 000000 00000038 00000048 01C092E0
  000D SMF      ........ Ac 00000FA0 0008A0 000000 000003F0 00000310 01C09328
  000E LLA      ........ OG 00000010 000000 000000 00000010 00000000 01C093B8
  000F INIT     STC00003 Ac 00000438 000000 000000 00000118 00000320 01C095B0
  000F BLSJPRMI ........ OG 00002320 001000 000000 00000000 00001320 01C09400
  000F COPYMIG  JOB00011 OG 00000030 000000 000000 00000030 00000000 01C09718
  0010 VLF      ........ Ac 000004B8 000100 000000 00000158 00000260 01C09448
  0011 TCAS     STC00009 Ac 000011D8 000180 000270 00000320 00000AC8 01C09490
  0012 VTAM     STC00006 Ac 00089990 000180 005460 000003A0 00084010 01C094D8
  0013 IOSAS    ........ Ac 00000048 000030 000000 00000018 00000000 01C09370
  0014 JES2     ........ Ac 00035B58 000630 027D30 00000BA8 0000CC50 01C09520
  0015 CATALOG  ........ Ac 00000A20 000148 000040 000002A8 000005F0 01C09568
  0016 INIT     STC00008 Ac 000003B8 000000 000000 00000098 00000320 01C09640
  0017 INIT     STC00007 Ac 000003B8 000000 000000 00000098 00000320 01C09688
  0018 TSOUSER  TSU00010 Ac 00002CD0 000218 000080 00000098 000029A0 01C096D0
  0041 INIT     STC00004 Ac 000003B8 000000 000000 00000098 00000320 01C095F8
 END OF VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE

Grand Totals

Header that indicates that totals for the information listed in the remainder of the report follows.

Total SYSTEM-owned

The amount of CSA, ECSA, SQA, and ESQA storage that the system is currently using. If the system cannot access the SYSTEM CAUB, all the counts in the “Grand Totals” part of the report display ‘????????’ and the counts for the SYSTEM CAUB are not included in the displayed total counts.

Total for active ASIDs

The amount of CSA, ECSA, SQA, and ESQA storage in bytes that address spaces were using when the system wrote the dump.

Total for “Owner Gone”

The amount of CSA, ECSA, SQA, and ESQA storage obtained by jobs and address spaces that had ended without a FREEMAIN being issued before the system wrote the dump.

Total for “No Detail”

The amount of CSA, ECSA, SQA, or ESQA storage obtained by jobs and address spaces before the system programmer started the storage tracking function. The system cannot identify users of this storage because the tracking function was not on when you obtained the storage. (If you IPL the system with the tracking function on and do not turn it off, the value in this field is zero).

ASID

The hexadecimal identifier of the address space that owns the specified area of CSA, ECSA, SQA, or ESQA storage.

Jobname

The name of the job that holds the reported area of CSA, ECSA, SQA, or ESQA storage. The job may have finished without issuing a FREEMAIN to free the storage.

ID

The system-assigned identifier for an instance of a job that holds the reported area of CSA, ECSA, SQA, or ESQA storage. Used to identify multiple occurrences of the job.

St

The status of the job specified in the Jobname field:

Ac: Active - The job is active
OG: Owner gone - The job has ended.

Total Length

The total amount of CSA, ECSA, SQA, or ESQA storage (in bytes) held by the reported job. The system displays this amount in hexadecimal.

CSA, ECSA, SQA, ESQA

The total number of bytes of storage held in CSA, ECSA, SQA, and ESQA.

CAUB

The address of the CAUB that contains the reported information. A string of asterisks (********) in this field indicates that the system might have gathered the reported information from more than one CAUB. IGVCAUB maps the CAUB. For more information, see z/OS® MVS Data Areas in the z/OS Internet Library.

Enter the VERBEXIT VSMDATA OWNCOMM DETAIL command to obtain a report that displays a list of storage ranges owned by one or more jobs, like the one shown in Figure 2. The system assumes the following defaults:

ALL
SORTBY(ASIDADDR)
CONTENTS(YES)

Figure 2. Example: VERBEXIT VSMDATA OWNCOMM DETAIL output

    VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE
    THE FOLLOWING KEYWORDS ARE IN EFFECT:
            OWNCOMM
            DETAIL
            ALL
            SORTBY(ASIDADDR)
            CONTENTS(YES)

                                                        Date     Time
 ASID Job Name ID       St T Address  Length   Ret Addr MM/DD/YY HH:MM:SS CAUB     GQE
 ---- -------- -------- -- - -------- -------- -------- -------- -------- -------- --------
 0000 *SYSTEM* ........ Ac C 00C50F40 000020C0 8003D132   Not Available   01B31378 01B351A8
  Data ------> 00000000 00000000 00000000 00000000  *................*
 0000 *SYSTEM* ........ Ac C 00C53C00 00010400 8003D132   Not Available   01B31378 01B35160
  Data ------> 00000000 00000000 00000000 00000000  *................*
 0000 *SYSTEM* ........ Ac C 00C64F70 00002090 8003D132   Not Available   01B31378 01B35148
  Data ------> 00000000 00000000 00000000 00000000  *................*
 0000 *SYSTEM* ........ Ac C 00C67DE0 000000A8 8003D132   Not Available   01B31378 01B35130
  Data ------> C4E2E540 00C67DFC 00C67E14 00C67E38  *DSV .F'..F=..F=.*
 0000 *SYSTEM* ........ Ac C 00C67E88 00000178 8003D132   Not Available   01B31378 01B350E8
  Data ------> E2C4E6F1 00000000 00000000 A5B218EF  *SDW1........v...*
 0000 *SYSTEM* ........ Ac S 00EFD000 00000020 FFFFFFFE   Not Available   01B31378 01B36828
  Data ------> 00C42300 00C42D00 00C43700 00C44100  *.D...D...D...D..*
 0001 *MASTER* ........ Ac C 00C20968 00000698 80E40048 05/15/92 14:02:44 01B31418 01BF53B8
  Data ------> 00000000 00070FB0 000715A0 80FD1760  *...............-*
 0001 *MASTER* ........ Ac C 00C24B18 000004E8 81E21616 05/15/92 14:02:37 01B31418 01A571C0
  Data ------> 710004E8 00C24BE0 00C24BE0 00C24DF8  *...Y.B.\.B.\.B(8*
 0001 *MASTER* ........ Ac C 00C25000 00001000 81E21616 05/15/92 14:02:37 01B31418 01BF50B8
  Data ------> 00000000 00000000 00000000 00000000  *................*
 0001 *MASTER* ........ Ac C 00C26178 00000150 81E21616 05/15/92 14:02:37 01B31418 01BF51A8
  Data ------> 71000150 00C26240 00C26240 00C26270  *...&.B. .B. .B..*
                                     .
                                     .
                                     .
                             (report continues)

******************************** GRAND TOTALS **********************************
                          Total
 Description              Length   SQA    CSA    ESQA     ECSA     CAUB
 ------------------------ -------- ------ ------ -------- -------- --------
 Total SYSTEM-owned       0015ADD8 007AB0 014770 0011FD98 0001EE20 01B31378
 Total for active ASIDS   00295558 0148F0 044EC0 000E4EF0 00156EB8 ********
 Total for "Owner Gone"   000147D0 0012C8 00F230 000004A8 00003E30 ********
 Total for "No Detail"    00000000 000000 000000 00000000 00000000 ********
                          -------- ------ ------ -------- --------
 Grand Total              00404B00 01D668 068860 00205130 00179B08
********************************************************************************

END OF VIRTUAL STORAGE MANAGEMENT DUMP FORMAT ROUTINE

The field descriptions and defaults are the same as for the VERBEXIT VSMDATA OWNCOMM SUMMARY output shown in Figure 1, except the following fields:

Total for active ASIDs

The amount of CSA, ECSA, SQA, and ESQA storage that address spaces were using when the system wrote the dump. This value only applies to address spaces that were requested for this report.

Total for “Owner Gone”

The amount of CSA, ECSA, SQA, and ESQA storage obtained by jobs and address spaces that had ended before the dump was written. This value only applies to address spaces that were requested for this report.

ASID

The hexadecimal identifier of the address space that owns the specified area of CSA, ECSA, SQA, or ESQA storage. Specify the ASIDLIST keyword to limit the number of address spaces displayed in this column.

T

The type of storage:

C - Indicates that the obtained storage is in CSA or ECSA.
S - Indicates that the obtained storage is in SQA or ESQA.

Address

The starting address of a storage range held by the reported job.

Length

The length of the storage range, in hexadecimal, starting at the address shown in the Address column.

Ret Addr

The address to which the system returned after issuing the GETMAIN, STORAGE, or CPOOL macro for the specified storage range. If the value in this field is X'FFFFFFFE', the specified storage was obtained during MVS™ initialization.

Date, Time

The date and time when the storage was obtained. When the time-of-day clock is not available, IPCS displays “Not Available” in the Date and Time columns.

GQE

Information that IBM® may request for diagnosis.

DATA------>

The first 10 bytes of data that the address in the Address field points to.

Grand Totals

Header that indicates that totals for the information listed above follow. The totals are provided only for entries selected by the filters specified on the VERBEXIT VSMDATA OWNCOMM DETAIL command. The following examples show the output that appears in the “Grand Totals” section when certain filters are specified:

VSMDATA OWNCOMM DETAIL: The grand totals section contains all the total lines shown in Figure 2.
VSMDATA OWNCOMM DETAIL SYSTEM: The grand totals section contains only the Total SYSTEM-owned line.
VSMDATA OWNCOMM DETAIL ASIDLIST(4): The grand totals section contains only the Total for active ASIDs and Total for “Owner Gone” lines. The totals counts listed on those lines are for ASID 4 only.