CA Dynam for VSE User Guide

Reporting on Disk Files
FT
GAINED SPACE
This is a decoded value derived from the file type indicator bytes in the VTOC
format-1 record. Generally, the codes are the same as those used on a DLBL,
but VSAM is abbreviated as VS; -- is displayed if the bits as set do not
correspond to one of the known file types (VS, SD, IS, or DA), which can occur
with initialized but never-opened utility files or in general for PIOCS files.
Reported in units appropriate to the device in question (tracks for CKD devices
and blocks for FBA). First, the number of logical records for that file is
ascertained, and then the number of optimal blocks required. From that, the
number of units is computed and subtracted from the actual number of units
used, to arrive at the number that can be gained.
This figure is correct for a file whose extents are partly outside the pool space
being reported on, but the potential gain shown applies to the whole amount
of space reported as TRACKS/BLOCKS ACTUAL (see below) even if that is not
all in the pool space.
Note that for sorting on the REBLOCK report the savings are converted into
bytes to make figures for different device types comparable. This can result in
some unexpected figures in this column, but the sort order is nonetheless
correct.
PERCENT HI/LO
This figure can be computed in the following ways:
• For under-allocated files it is shown as the percentage of the original
request by which the actual amount used exceeds the original request, and
has a minus sign (-) appended.
• For over-allocated files it is shown as the percentage of the actual amount
used by which the original request exceeds the actual amount, and has a
plus sign (+) appended.
On the REALLOC report the sort variable is the absolute value of whichever of
the percentages mentioned above has been calculated, so that over- and
under-allocated files are presented together in the output.
REBLOCKING GAIN INFO
The fields in this section are filled only if the file is type SD with record format
F or FB, for which the record length and blocksize have been recorded in the
format-1 record. For all other files these fields are left blank.
RF
TRACKS/BLOCKS
ACTUAL
This is a decoded value derived from the record format byte in the VTOC
format-1 record. The formats F, FB, V, VB, S, SB, and UN are decoded. If the
bits as set do not correspond to one of these codes then -- is shown. This
often occurs with PIOCS files and also with continuations of files beyond the
first real volume.
This is reported for all files or portions of a file, It shows the total amount of
space used on the real volume in question, regardless of whether it is in the
defined pool space.
5–46 User Guide