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, and ESQA 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, and ESQA 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, and ESQA 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, or ESQA 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.
- 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.