Volume Record Field
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.