VERBEXIT VSMDATA CONTROLBLOCKS subcommand output

The report generated by the VERBEXIT VSMDATA subcommand formats the following VSM control blocks:
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:
This 'SUMMARY' report also generates the following:
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.

Parent topic: Formatting VSM dump data