This is the section for volume information. One of these records is
created for each volume scanned. These records are collected when
the VOLUME, or STORAGEGROUP, or both parameters are selected, and
the NOVOLUMEINFO parameter is
not specified.
The record type for this record is V.
- Name
- Description
- DCVVOLSR
- 6-character volume serial number.
- DCVFLAG1
- This is the first byte of flags. The following are indicated if
the specified bit is 1.
- DCVINXEX
- An index exists for the VTOC.
- DCVINXEN
- The index for the VTOC is active.
- DCVUSPVT
- The volume usage is private.
- DCVUSPUB
- The volume usage is public.
- DCVUSSTO
- The volume usage is storage.
- DCVSHRDS
- The device can be shared between multiple processors.
- DCVPHYST
- 2 bits to indicate the physical status of the volume. This field
is mapped by constants DCVNMNGD, DCVINITL, and DCVMANGD.
- BB'00'
- Non-SMS-managed volume
- BB'01'
- In conversion to SMS
- BB'11'
- Volume is SMS-managed
- DCVERROR
- This is the error indication byte. Each bit in this byte represents
a distinct error encountered during processing. The following descriptions
are indicated if the specified bit is 1.
- DCVEVLCP
- An error occurred during calculation of the volume capacity value.
- DCVEBYTK
- An error occurred during calculation of the value for bytes per
track. This will affect the following values:
- DCVPERCT
- DCVFRESP
- DCVALLOC
- DCVLGEXT
- DCVVLCAP
- DCVELSPC
- An error occurred acquiring information from the format-4 DSCB.
This will affect the following values:
- DCVINXEN
- DCVFRAGI
- DCVFREXT
- DCVFDSCB
- DCVFVIRS
- DCVPHYST
- Plus those indicated for DCVEBYTK
- DCVPERCT
- The percentage of free space remaining on the volume. This is
the ratio of the amount of free space to volume capacity.
- DCVFRESP
- The amount of free space remaining on the volume.
When DCVCYLMG is set to 1, this value is in megabytes. When DCVCYLMG
is set to 0, this value is in kilobytes. This is a summation of the
total free cylinders and total additional free tracks on the volume.
- DCVALLOC
- The amount of allocated space on the volume. When
DCVCYLMG is set to 1, this value is in megabytes. When DCVCYLMG is
set to 0, this value is in kilobytes.
- DCVVLCAP
- The total capacity of the volume. When DCVCYLMG
is set to 1, this value is in megabytes. When DCVCYLMG is set to 0,
this value is in kilobytes.
- DCVFRAGI
- The fragmentation index, which is a numeric representation of
the relative size and distribution of free space on the volume. A
large index value indicates a high degree of fragmentation.
- DCVLGEXT
- The largest free extent on the volume, expressed in kilobytes.
- DCVFREXT
- The number of free extents on the volume.
- DCVFDSCB
- The number of free DSCB in the VTOC. This field might not be accurate
for a large VTOC.
- DCVFVIRS
- The number of available VTOC index records (VIRs).
- DCVDVTYP
- The device type of the volume, for example 3390.
- DCVDVNUM
- The device number (address) of the volume, for example 0A20 or
1D01.
- DCVSTGGP
- Storage group name
- DCVSGLNG
- The actual length of the storage group name in DCVSGTCL.
- DCVSGTCL
- The storage group name.
- DCVTRPCT
- A one-byte field which describes the percent free space on the
track-managed portion of the volume.
- DCVTRFSP
- A four-byte unsigned field which describes the free space on the
track-managed portion of the volume. When DCVCYLMG is set to 1, this
value is in megabytes. When DCVCYLMG is set to 0, this value is in
kilobytes and is equal to the value of DCVFRESP.
- DCVTRALC
- A four-byte unsigned field which describes the allocated space
in the track-managed space of the volume. When DCVCYLMG is set to
1, this value is in megabytes. When DCVCYLMG is set to 0, this value
is in kilobytes and is equal to the value of DCVALLOC.
- DCVTRVLC
- A four-byte unsigned field which describes the total capacity
of the track-managed space of the volume. When DCVCYLMG is set to
1, this value is in megabytes. When DCVCYLMG is set to 0, this value
is in kilobytes and is equal to the value of DCVVLCAP.
- DCVTRFRG
- A four-byte signed field indicating the fragmentation index for
the track-managed space of the volume.
- DCVTRLGE
- A four-byte unsigned field indicating the largest extent on the
track-managed space of the volume.
- DCVTRFRX
- A four-byte signed field indicating the number of free extents
on the track-managed space of the volume.
- DCVEAVOL
- A one-byte indicator in which a bit value, DCVCYLMG, indicates
whether or not the volume has cylinder-managed space. When DCVCYLMG
is set to 1, the volume has cylinder-managed space and both total
volume and track-managed statistics fields will be returned in megabytes.
When DCVCYLMG is set to 0, both total volume and track-managed statistics
fields will be returned in kilobytes.