CA Dynam for VSE User Guide

Reporting on Disk Files
SELECT Options
The SELECT options for VTOCS are grouped into sort-order options and reportformatting
options. Any or all of them can be used in one command, to
produce up to five reports with the desired choice of reported information.
Sort-order options:
FIDEXT
CREATE
EXPIRE
VOLLOC
VTOCSEQ
Extents are reported by file-id and, within each file-id, in order of extent
sequence number. This is the default option if SELECT is omitted.
Extents are reported by ascending creation date of the file they belong to.
Extents are reported by ascending expiration date of the file they belong to.
Extents are reported by real volid and, within each volume, by physical
address. Extents having no overlap with any pool space on a volume, are not
reported (except for the VTOC extent).
Extents are reported on in order of VTOC retrieval.
Report-formatting options:
FREEXT
NODSNS
Causes free extents to be reported. Affects the VOLLOC report only.
Causes only free extents to be reported. Affects the VOLLOC report only, and
is ignored unless FREEXT is also given.
SELECT=ALL invokes the first four sort-order options, omitting the VTOCSEQ
report, and without either FREEXT or NODSNS. These last two options can be
used together with the ALL option, as in:
SELECT ALL,FREEXT
Most of the DYNVTOC reporting options can be simulated with the correct
combination of VTOCS SELECT options, and many additional combinations are
allowed. The most basic DYNVTOC report (on a single volume) can be
approximated with:
REPORT VTOCS SELECT=VOLLOC VOL=vvvvvv
Source Code for
VTOCS Report
Report Headings
The CA Earl source for the VTOCS report is the CA Dynam library member
DYNVT.0.
The report headings are generally self-explanatory, but note the following:
• If VOL= is given specifying a generic volid, one output detail line is
generated for each extent on each real volume encompassed in the
generic volid.
5–48 User Guide