VERBEXIT VSMDATA subcommand — format virtual storage management data

Specify the VSMDATA verb name and optional parameters on the VERBEXIT subcommand to format diagnostic data from virtual storage management (VSM).

Syntax

  VERBEXIT VSMDATA [ 'parameter [,parameter]...' ]

The parameters are:
 [CONTROLBLOCKS] [ALL] [DETAIL]
                    [SUMMARY]

                [CURRENT]
                [ERROR]
                [TCBERROR]
                [NOASIDS]
                [ASIDLIST(asidlist)]
                [JOBNAME(joblist) | JOBLIST(joblist)]
                [GLOBAL|NOGLOBAL]

  [OWNCOMM [([CSA] [SQA])]
                [SUMMARY  ]
                [DETAIL ]
                [ALL]
                [ASIDLIST(asidlist)]
                [SYSTEM]
                [SORTBY(ASIDADDR|ASIDLEN|ADDRESS|TIME|LENGTH)]
                [CONTENTS(YES|NO)]

Report Type Parameters
Use these parameters to select the type of report. If you omit a report type parameter, the default is CONTROLBLOCKS. Both the CONTROLBLOCKS and OWNCOMM parameters have two additional report type parameters — SUMMARY and DETAIL. For the CONTROLBLOCKS report, the default is DETAIL. For the OWNCOMM report, the default is SUMMARY.
CONTROLBLOCKS
Specifies a report of VSM control blocks. The blocks formatted depend on the associated parameters: ALL, DETAIL, SUMMARY, CURRENT, ERROR, TCBERROR, NOASIDS, ASIDLIST, JOBNAME, GLOBAL, and NOGLOBAL. The CONTROLBLOCKS parameter is the default; the following two commands produce the same report:
```
VSMDATA ALL NOGLOBAL
VSMDATA CONTROLBLOCKS ALL NOGLOBAL
```
OWNCOMM [([CSA] [SQA])]

Requests CSA tracker reporting from VERBEXIT VSMDATA. OWNCOMM may be entered with a CSA option, an SQA option, or both. When only one of the options is entered, it indicates that the report should only contain information pertaining to the referenced areas of common storage. Reporting regarding both may be explicitly requested or implied by omission of all qualifying options.
When you use an abbreviated form of OWNCOMM, enter OWNC at minimum.

SUMMARY

Specifies a summary CONTROLBLOCKS or OWNCOMM report. SUMMARY is the default for the OWNCOMM report but not for the CONTROLBLOCKS report. For more information about the output produced by the VERBX VSMDATA CONTROLBLOCKS SUMMARY report, see the VSM component in z/OS MVS Diagnosis: Reference.

DETAIL

Specifies a detailed CONTROLBLOCKS or OWNCOMM report. DETAIL is the default for the CONTROLBLOCKS report but not for the OWNCOMM report.
Address Space Selection Parameters for CONTROLBLOCKS
Use these parameters to obtain data for particular address spaces, which you specify by their address space identifiers (ASIDs). If you omit these parameters with CONTROLBLOCKS, the default is CURRENT. For more information, see the select ASID service in z/OS MVS IPCS Customization.

ALL

Specifies formatting of all VSM control blocks for LSQA and the private area for all address spaces in the dump.

CURRENT

Specifies formatting of the VSM control blocks for LSQA and the private area for the address spaces that were current when the system wrote the dump.

ERROR

Specifies formatting of VSM control blocks for LSQA and the private area for any address space with an MVS™ error indicator or containing a task with an error indicator.

TCBERROR

Specifies processing of VSM control blocks for LSQA and the private area for any address space containing a task with an error indicator. Blocks for address spaces with an error indicator are not processed.

NOASIDS

Suppresses formatting of VSM control blocks for LSQA or the private area for any address space.

ASIDLIST(asidlist)

Specifies one or more ASIDs for the address spaces for which you want to process VSM control blocks for LSQA and the private area.
The asidlist can be a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs, When specifying a range, separate the first and last ASIDs in the range with a colon. When specifying a list, separate the list members with commas or blanks.

The ASID can be 1 through 32767 (decimal). You can specify as many ASIDs as you need; there is no system-imposed maximum.

JOBNAME(joblist) | JOBLIST(joblist)

Specifies one ore more job names whose associated address spaces are to be processed for the VSM control blocks for LSQA and the private area. Use commas to separate the job names in the list; do not enclose job names in apostrophes; and do not specify a range of job names.
Data Selection Parameters for CONTROLBLOCKS
Use these parameters to limit the scope of the data in the report. If you omit a data selection parameter, the default is GLOBAL.

GLOBAL or NOGLOBAL

Specifies or suppresses formatting of VSM control blocks for the SQA and CSA. GLOBAL specified the formatting; NOGLOBAL suppresses the formatting.
Address Space Selection Parameters for OWNCOMM DETAIL
Use these parameters to obtain data from particular address spaces, which you specify by their address space identifiers (ASIDs). If you omit these parameters with OWNCOMM DETAIL, the default is ALL. For more information, see the select ASID service in z/OS MVS IPCS Customization.

ALL

Specifies formatting of data about CSA, ECSA, SQA, ESQA, RUCSA and ERUCSA storage for all address spaces in the dump.

ASIDLIST(asidlist)

Specifies a list of ASIDs for the address spaces for which you want data about CSA, ECSA, SQA, ESQA, RUCSA and ERUCSA storage.
The asidlist can be a single ASID, a range of ASIDs, or a list of noncontiguous ASIDs, When you specify a range, separate the first and last ASIDs in the range with a colon. When you specify a list, separate the list members with commas or blanks.

The ASID can be 1 through 32767 (decimal). You can specify as many ASIDs as you need; there is no system-imposed maximum.
Data Selection Parameters for OWNCOMM DETAIL
Use these parameters to limit the scope of the data in the report.

SYSTEM

Requests data about CSA, ECSA, SQA, ESQA, RUCSA and ERUCSA storage that the system uses; this storage is not "owned" by any particular address space or job.

SORTBY(ASIDADDR | ASIDLEN | ADDRESS | TIME | LENGTH)

Indicates how IPCS is to sort the list of requests for CSA, ECSA, SQA, ESQA, RUCSA or ERUCSA storage:

ASIDADDR

Sort the output by address space identifier, in ascending order. When two or more entries have the same ASID, IPCS sorts these entries by storage address. If you omit a qualifying value with SORTBY, the default is ASIDADDR.

ASIDLEN

Sort the output by address space identifier, in ascending order. When two or more entries have the same ASID, IPCS sorts these entries by the length of the storage at the reported address.

ADDRESS

Sort the output by storage address, in ascending order.

TIME

Sort the output by the time at which the system processed the request to obtain storage, starting with the oldest request.

LENGTH

Sort the output by the length of the storage represented by each entry, starting with the smallest length value.

CONTENTS(YES | NO)

Indicates whether IPCS is to display the contents of the first 4 words of the data at the storage address. If an error occurs when the system tries to access the storage, the message Data ------] Not Available appears in this field. If you omit CONTENTS, CONTENTS(YES) is the default.
Example 1: Format information about CSA, ECSA, SQA, and ESQA storage for address space identifiers 1, 6, 7, 8, and 9, and sort the output by storage length.
- Action
```
VERBX VSMDATA 'OWNCOMM DETAIL SORTBY(LENGTH) ASIDLIST(1,6:9)'
```
Example 2: Format information about CSA, ECSA, SQA, and ESQA storage for all address space identifiers, and sort the output by address.
- Action
```
VERBX VSMDATA 'OWNCOMM DETAIL ALL SORTBY(ADDRESS)'
```
- Result
  For an example of the VSMDATA output, see the VSM component in z/OS MVS Diagnosis: Reference.