Previous Topic

Next Topic

Book Contents

Book Index

Volume record table

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
INUSE

Additional volume status indications:

Potential vault

Pending vault

Recalled back from a vault

Hold before return to vault

Stacked datasets not accepted
Volume is in-use

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
LOGICAL

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
NOCOMP

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

Logical Field Names for the Control-M/Tape Repository