The following table describes the fields of volume records:
Table 303 Keywords Used With Volume Type Records
EXTERNAL NAME |
VALID VALUES |
DESCRIPTION |
INTERNAL NAME |
---|---|---|---|
ACTIVEDS |
integer |
Number of active datasets |
DVLACTD# |
BOXID |
char (6) |
Box ID |
DVLBOXID |
CHKINDT |
date |
Check-in date |
DVLFCDT |
CLNCOUNT |
integer |
Volume’s Clean Count |
DVLCLN# |
DVLRBA |
hex (8) |
RBA of the record |
DVLRBA |
EXPDSNUM |
integer |
Expiration dataset number |
DVLEXPDS |
EXPRTRN |
date |
Expected return date from out location |
DVLRTRN |
FIRSTVOL |
char (6) |
First volser for multi-volume chains |
DVLFIRST |
IOERPRM |
integer |
Read permanent errors count |
DVLRPER |
IOERPRMC |
integer |
Read permanent errors count since last clean |
DVLRPERC |
IOERTMP |
integer |
Read temporary errors count |
DVLRTER |
IOERTMPC |
integer |
Read temporary errors count since last clean |
DVLRTERC |
IOEWPRM |
integer |
Write permanent errors count |
DVLWPER |
IOEWPRMC |
integer |
Write permanent errors count since last clean |
DVLWPERC |
IOEWTMP |
integer |
Write temporary errors count |
DVLWTER |
IOEWTMPC |
integer |
Write temporary errors count since last clean |
DVLWTERC |
LACCDT |
date |
Date of last volume access |
DVLADT |
LACCJBN |
char (8) |
Name of last job that accessed the volume |
DVLJBN |
LACCTM |
time |
Time of last volume access |
DVLATM |
LBLNUM |
integer |
Last label number on the volume |
DVLLBLNM |
LBLTYP |
SL, NL, NSL, SUL, AL, AUL, BLP |
Label type |
DVLLTYP |
LCLNDT |
date |
Last clean date |
DVLCLN |
LDSCSIZE |
integer |
Compressed size in kilobytes of the last dataset on the volume |
DVLLDCSZ |
LDSPOS |
hex (4) |
Block ID of the last dataset starting on this tape |
DVLPOSLD |
LDSPOSLB |
integer |
Label number for LDSPOS (above) |
DVLPOSLB |
LIBRARY |
char (8) |
LIBRARY NAME (ATL LIBRARY) |
DVLLIBR |
LOCATION |
char (8) |
Current location of the volume |
DVLCODE |
LOCSEQ |
integer |
Vault sequence number |
DVLVTSQ |
MEDIA |
char (8) |
Volume’s media type |
DVLMEDIA |
MOVEDATE |
date |
Last move date |
DVLMVDT |
NEXTVOL |
char (6) |
Next volser for multi-volume chains |
DVLNEXT |
PHYSVLSR |
char(6) |
VTS physical volser |
DVLPHYVL |
PREVVOL |
char (6) |
Previous volser for multi-volume chains |
DVLPREV |
RECVLNUM |
integer |
Vault number (in pattern) from which the volume recalled |
DVLVLTI |
RETVLTDT |
date |
Return to vault date |
DVLVRTRN |
SCRDT |
date |
Last volume scratch date |
DVLSCRDT |
SLNAME |
char (6) |
Volume’s SL-NAME |
DVLSLNAME |
SLOTNUM |
integer |
Vault slot number |
DVLVSLOT |
SMSSG |
char (8) |
DFSMS Storage Group |
DVLSMSSG |
UNITGNAM |
char (8) |
Generic unit name |
DVLUGNAM |
USERDATA |
char (20) |
User data |
DVLUSER2 |
VAULT |
char (8) |
First vault name in vault vaulting pattern information |
DVLVLTNM |
VAULT2 |
char (8) |
Second vault name in vault vaulting pattern information |
— |
VAULT3 |
char (8) |
Third vault name in vault vaulting pattern information |
— |
VCHANGED |
date |
Last change date |
DVLMDT |
VCHANGET |
time |
Last change time |
DVLMTM |
VCHANGEU |
char (8) |
Last user ID that changed the entry |
DVLUSER |
VENDOR |
char (8) |
Name of vendor who manufactured the volume |
DVLVNDOR |
VFREE |
integer |
Available kilobytes on the volume |
DVLFREE |
VLT2EXPD |
date/integer |
Second vault expiration in the vaulting pattern |
— |
VLT3EXPD |
date/integer |
Third vault expiration in the vaulting pattern |
— |
VLTDSNUM |
integer |
Vaulting dataset number |
DVLVLTDS |
VLTENTDT |
date |
Entry date to the vault |
DVLVENDT |
VLTENTNM |
integer |
Number of vault entries for the volume |
DVLVLTT |
VLTEXPDT |
date/integer |
Vault expiration date, number of cycles or number of days in the first vaulting pattern |
DVLVXPD1 |
VLTEXTYP |
VCYC VDATE VLACC VCAT VPERM VEXP VOLEXP VDAYS |
Vault expiration type: Number of cycles Actual date (in yyyymmdd format) Number of days since last access MVS Catalog Control Permanent Until dataset expiration Until volume expiration Number of days in vault |
DVLVXPT1 |
VLTPREFL |
integer |
Vaulting dataset name prefix length |
DVLPRFLN |
VLTVEXP |
integer |
Vaulting pattern sequence number of the volume that holds the expiration type "VOL EXPIRE". |
DVLVEXP# |
VOLEDMID |
char (4) |
EDM-ID for EDM controlled volumes: HSM - DFSMShsm ADSM - ADSM HPDM - ExHPDM |
DVLEDMID |
VOLEXCP |
integer |
EXCP count since last scratched |
DVLEXCP# |
VOLEXPDT |
date |
Expiration date |
DVLEXPD |
VOLEXPTY |
DATE, PERM, UNKNOWN |
Expiration date type |
DVLEXPT |
VOLFLAGSa |
RETURNVL DYNDEF MANUPDAT VLRSTRT EXTDEL MANVLT SNGLVOL INATL |
Additional volume status flags: Volume returned from vault Volume dynamically defined Volume manually updated (Online/Utility CTTMUP) Volume processed under MVS RESTART Volume is deleted when expired Volume manually moved to vault Single volume (out of multi-volume group) in VAULT/RECALL Volume resides in an automated tape library |
DVLFLG1 |
VOLFLAG2a |
VLTBYBOX |
Additional status flag: Volume can be vaulted by boxes |
DVLFLG2 |
VOLINDa |
PVLT PENDVLT RECALL HOLD NOSTACK |
Additional volume status indications: Potential vault Pending vault Recalled back from a vault Hold before return to vault Stacked datasets not accepted |
DVLSTA2 |
VOLODESC |
char (20) |
Volume’s description |
DVLDESC |
VOLOWNER |
char (8) |
Volume’s owner |
DVLOWNR |
VOLSEQ |
integer |
Volume sequence number |
DVLVSEQ |
VOLSER |
char (6) |
Volume serial number |
DVLVOLSR |
VOLSTATb |
ACTIVE SCRATCH PENDSCR OUT VAULTED EXTERNAL EDM DELETED |
Status of volume: Active Scratch Pending scratch Out of library (but not vaulted) Vaulted External volume EDM controlled volume Deleted volume |
DVLSTAT |
VOLTYPE |
PHYSICAL |
Volume types: Physical Logical |
DVLTYPE |
VOLUSECT |
integer |
Volume usage count from last scratch |
DVLUSED# |
VOLUSETC |
integer |
Volume usage count from date of entry to the library |
DVLUSET# |
VRFORMAT |
Tape recording format of the data on the volume |
DVLRFMT |
|
BPI200 |
200 bits per inch |
||
BPI556 |
556 bits per inch |
||
BPI800 |
800 bits per inch |
||
BPI1600 |
1600 bits per inch |
||
BPI6250 |
1625 bits per inch |
||
TRACK18 |
18 tracks |
||
TRACK36 |
36 tracks |
||
TRACK128 |
128 tracks |
||
TRACK256 |
256 tracks |
||
TRACK384 |
384 tracks |
||
EFMT1 |
Enterprise Recording Format 1 |
||
VSTKGRP |
char (8) |
Volume Stacking Group |
DVLSTKG |
VTRTCH |
COMP |
Indicates whether data is compressed (for example, IDRC) |
DVLTRTCH |
VUSED |
integer |
Kilobytes used on the volume |
DVLUSED |
a This field can be used normally in INCLUDE/EXCLUDE statements of a report. It cannot, however, be used in a report’s FIELDS and SORTBY statements; use fields DSSTAT and DSTATX instead. For more information, see the CTTRPT utility in the INCONTROL for z/OS Utilities Guide.
b This field has a special meaning when used in the FIELDS and SORTBY statements of a report. For more information, see the CTTRPT utility in the INCONTROL for z/OS Utilities Guide.
Parent Topic |