The tape volume table contains one row for each tape volume used
by OAM. The DB2 name of the tape volume table is TAPEVOL. The table
is defined in table space OCTVLTSP. Table 1 describes
the attributes of the columns in the OCTVLTSP table. A row is inserted
into the tape volume table for each tape volume used by OAM to track
its status.
Note: Should OAM discover minor discrepancies with the tape volume
table at initialization, the following recovery actions are automatically
invoked to circumvent failure of the initialization:
- The row that is in error is skipped over, and a corresponding
volume or tape volume control block is not built. A message is issued
indicating the row that was skipped and the reason it was bypassed.
- The table row is corrected when a valid value is easily recognizable,
and a message is issued stating the correction that is made by OAM
and what steps can be taken if the correction is not acceptable to
the customer.
- More detailed messages containing recovery actions are provided
and issued during OAM initialization for database discrepancies.
Table 1. Tape
volume table column descriptionColumn description |
Name |
DB2 type |
DB2 attribute |
Value |
Report label |
Volume Serial number |
VOLSER |
CHAR(6) |
NN |
|
VOLSER |
Unit Name |
UNITNAME |
CHAR(8) |
NN |
|
UNIT_NAME |
Media type |
MEDIATYP |
CHAR(2) |
NN |
|
MEDIA_TYPE |
Storage group name |
STORGRP |
CHAR(8) |
NN |
|
STORAGE_GROUP |
Volume type |
TYPE |
CHAR(1) |
NN |
B|G|S |
TYPE |
Volume creation date |
CREDATE |
DATE |
NN |
|
CREATION_DATE |
Last mounted date |
MNTDATE |
DATE |
NN |
|
DATE_LAST_MOUNTED |
Last written date |
WRTDATE |
DATE |
NN |
|
DATE_LAST_WRITTEN |
Expiration date |
EXPDATE |
DATE |
NN |
|
EXPIRATION_DATE |
Capacity of tape |
CAPACITY |
INTEGER |
NN |
|
CAPACITY |
Free space remaining |
FRESPACE |
INTEGER |
NN |
|
FREE_SPACE |
Block id of last data block written |
LSTBLKID |
INTEGER |
NN |
|
LAST_BLOCKID |
Percent Full |
PFULL |
SMALLINT |
NN |
|
PERCENT_FULL |
Number of logical blocks written |
NUMLBLKS |
INTEGER |
NN |
|
LOGICAL_BLOCKS_WRITTEN |
Number of logical kilobytes written |
NUMLKBW |
INTEGER |
NN |
|
LOGICAL_KILOBYTES_WRITTEN |
Number of physical kilobytes written |
NUMPKBW |
INTEGER |
NN |
|
PHYSICAL_KILOBYTES_WRITTEN |
Number of logical kilobytes deleted |
NUMLKBDE |
INTEGER |
NND |
|
LOGICAL_KILOBYTES_DELETED |
Full status |
FULL |
CHAR(1) |
NN |
Y|N|P |
FULL |
Readable |
READABLE |
CHAR(1) |
NN |
Y|N |
VOLUME_READABLE_STATUS |
Writable |
WRITABLE |
CHAR(1) |
NN |
Y|N |
VOLUME_WRITABLE_STATUS |
In use status |
INUSE |
CHAR(1) |
NN |
|
IN_USE |
Copied status |
COPIED |
CHAR(1) |
NN |
|
COPIED |
Alternate volume |
AVOLSER |
CHAR(6) |
NN |
|
ALTERNATE_VOLUME |
Tape compaction indicator |
COMPACT |
CHAR(1) |
NND |
|
TAPE_COMPACTION_INDICATOR |
OAM XCF member name |
MEMBER |
CHAR(16) |
NND |
|
OAM_XCF_MEMBER |
Physical Identifier |
EPI |
SMALLINT |
NND |
|
EPI |
Backup type |
TYPE |
CHAR(1) |
NND |
1|2|blank |
BKTYPE |
Original unit name |
OUNITNAM |
CHAR(8) |
NND |
|
ORIGINAL_UNIT_NAME |
Data class |
DATACLAS |
CHAR(8) |
NND |
|
DATACLAS |
Data set name format |
DSNFMT |
CHAR(1) |
NND |
|
DATASET_NAME_FORMAT |
Tape sublevel |
SUBLEVEL |
CHAR(1) |
NND |
|
TAPE_SUBLEVEL |
Capacity overflow |
CAPACITYO |
INTEGER |
NND |
|
CAPACITY_OVERFLOW |
Freespace overflow |
FRESPACEO |
INTEGER |
NND |
|
FREE_SPACE_OVERFLOW |
Logical Kilobytes Written Overflow |
NUMLKBWO |
INTEGER |
NND |
|
LOGICAL_KBS_WRITTEN_OVERFLOW |
Physical Kilobytes Written Overflow |
NUMPKBWO |
INTEGER |
NND |
|
PHYSICAL_KBS_WRITTEN_OVERFLOW |
Logical Kilobytes Deleted Overflow |
NUMLKBDEO |
INTEGER |
NND |
|
LOGICAL_KBS_DELETED_OVERFLOW |
Volume Attribute Flags |
VOLATTRF |
SMALLINT |
NND |
|
VOLUME_ATTRIBUTE_FLAGS |
The VOLSER column has a unique index. Therefore, each tape
volume used by OAM must have a unique volume serial number. The tape
volume serial number must be unique across all types of media used
by the installation. The tape volume serial number must not conflict
with the volume serial number of an optical volume being used by OAM.
The tape volume serial number must not conflict with the serial number
of any SMS-managed DASD volume or any mounted non-SMS-managed DASD
volume.
Rows are dynamically inserted into the TAPEVOL table as unknown
scratch tape volumes mounted in a response to a mount scratch request
during allocation.
The following describes the columns in the tape volume table:
- VOLSER
- The volume serial number of the tape volume. All other columns
in the tape volume table row apply to this volume.
- UNITNAME
- The MVS unit name used when the tape volume is initially mounted
for OAM use. This unit name is used by OAM whenever this tape volume
is subsequently allocated by OAM. This parameter is valid only for
stand-alone tape drives. If the tape volume is library-resident, or
if an automated or manual tape library dataserver is chosen for the
request at the time of allocation, this parameter is ignored (in the
case of a library-resident volume mount request), or overridden (in
the case of an ATLDS or MTLDS being chosen to handle the request at
allocation).
- MEDIATYP
- The media type of the tape volume
- 02
- IBM Cartridge System Tape (MEDIA1)
- 04
- IBM Enhanced Capacity Cartridge System Tape (MEDIA2)
- 05
- IBM High Performance Cartridge Tape (MEDIA3)
- 06
- Extended High Performance Cartridge Tape (MEDIA4)
- 07
- Enterprise Tape Cartridge (MEDIA5)
- 08
- Enterprise Economy Tape Cartridge (MEDIA6)
- 09
- Enterprise WORM Tape Cartridge (MEDIA7)
- 10
- Enterprise Economy WORM Tape Cartridge (MEDIA8)
- 12
- IBM Enterprise Extended Tape Cartridge (MEDIA9)
- 14
- IBM Enterprise Extended WORM Tape Cartridge (MEDIA10)
- 16
- IBM Enterprise Advanced Tape Cartridge (MEDIA11)
- 17
- IBM Enterprise Advanced WORM Tape Cartridge (MEDIA12)
- 18
- IBM Enterprise Advanced Economy Tape Cartridge (MEDIA13)
- STORGRP
- The name of the Object or Object Backup storage group to which
the tape volume is associated.
- TYPE
- The type of tape volume:
- B
- Backup volume associated with an Object Backup storage group.
- G
- Group volume associated with an Object storage group.
- S
- Scratch volume that can be assigned to either an Object or Object
Backup storage group when another volume is needed by OAM.
- CREDATE
- The date that the volume was first used by OAM and when the row
for this volume was created in the TAPEVOL table.
- MNTDATE
- The date that the volume was last mounted by OAM.
- WRTDATE
- The date that the volume was last written by OAM.
- EXPDATE
- The expiration date of the volume. The expiration date of the
volume is the latest expiration date of all objects that reside on
the volume.
- CAPACITY
- The approximate number of kilobytes of data which can be written
for the volume allowing variance for different manufacturers.
- 218 554
- Represents the approximate number of kilobytes of data that can
be written for an IBM Cartridge System Tape written in 18-track format
on an IBM 3480 or 3490 Magnetic Tape Subsystem. The installation can
overwrite this default capacity by specifying a value between 1 and
2 147 483 646 kilobytes using the TAPECAPACITY parameter
of the SETOAM command.
- 437 109
- Represents the approximate number of kilobytes of data that can
be written for an IBM Cartridge System Tape written in 36-track format
on an IBM 3490E Magnetic Tape Subsystem. The installation can overwrite
this default capacity by specifying a value between 1 and 2 147 483 646
kilobytes using the TAPECAPACITY parameter of the SETOAM command.
- 874 218
- Represents the approximate number of kilobytes of data that can
be written for an IBM Enhanced Capacity Cartridge System Tape written
in 36-track format on an IBM 3490E Magnetic Tape Subsystem. The installation
can overwrite this default capacity by specifying a value between
1 and 2 147 483 646 kilobytes using the TAPECAPACITY
parameter of the SETOAM command.
- 9 764 864
- Represents the approximate number of kilobytes of data for an
IBM High Performance Cartridge Tape written in 128-track format on
an IBM TotalStorage High Performance Tape System 3590 Model B subsystem.
If the 3590 Model B subsystem is installed in native non-emulation
mode, this value is returned from the drive and is used as an approximation
that is close to the actual value.
- 19 530 752
- Represents the approximate number of kilobytes of data for an
IBM Extended High Performance Cartridge Tape written in 128-track
format on a 3590 Model B subsystem.
If the 3590 Model B subsystem
is installed in native non-emulation mode, this value is returned
from the drive and is used as an approximation that is close to the
actual value.
- 19 530 752
- Represents the approximate number of kilobytes of data for an
IBM High Performance Cartridge tape written in 256-track recording
technology on an IBM TotalStorage High Performance Tape System 3590
Model E subsystem.
This value is returned from the drive and is
used as an approximation that is close to the actual value.
- 39 061 504
- Represents the approximate number of kilobytes of data for an
IBM Extended High Performance Cartridge tape written in 256-track
recording technology on an 3590 Model E subsystem.
This value is
returned from the drive and is used as an approximation that is close
to the actual value.
- 29 296 640
- Represents the approximate number of kilobytes of data for an
IBM High Performance Cartridge tape written in 348-track recording
technology on an IBM TotalStorage High Performance Tape System 3590
Model H subsystem.
This value is returned from the drive and is
used as an approximation that is close to the actual value.
- 58 593 280
- Represents the approximate number of kilobytes of data for an
IBM Extended High Performance Cartridge tape written in 348-track
recording technology on a 3590 Model H subsystem.
This value is
returned from the drive and is used as an approximation that is close
to the actual value.
- 60 653 568
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Economy Tape Cartridge or IBM Enterprise Economy WORM
Tape Cartridge written in EFMT1 recording format on an IBM 3592 Model
J or Model E05 Enterprise Tape subsystem.
This value is returned
from the drive and is used as an approximation that is close to the
actual value.
- 292 968 448
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Tape Cartridge or IBM Enterprise WORM Tape Cartridge
written in EFMT1 recording format on an IBM 3592 Model J or Model
E05 Enterprise Tape subsystem. This value is returned from the drive
and is used here as an approximation that is close to actual value.
- 97 655 808
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Economy Tape Cartridge or IBM Enterprise Economy WORM
Tape Cartridge that is written in EFMT2 or EEFMT2 recording format
on an IBM 3592 Model E05 or Model E06 Enterprise Tape subsystem. This
value is returned from the drive and is used here as an approximation
that is close to the actual value.
- 488 281 088
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Tape Cartridge or IBM Enterprise WORM Tape Cartridge
that is written in EFMT2 or EEFMT2 recording format on an IBM 3592
Model E05 or Model E06 Enterprise Tape subsystem. This value is returned
from the drive and is used here as an approximation that is close
to the actual value.
- 683 593 728
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Extended Tape Cartridge or IBM Enterprise Extended
WORM Tape Cartridge that is written in EFMT2 or EEFMT2 recording format
on an IBM 3592 Model E05 or Model E06 Enterprise Tape subsystem. This
value is returned from the drive and is used here as an approximation
that is close to the actual value.
- 124 999 680
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Economy Tape Cartridge or IBM Enterprise Economy WORM
Tape Cartridge that is written in EFMT3 or EEFMT3 recording format
on an IBM 3592 Model E06 Enterprise Tape subsystem. This value is
returned from the drive and is used here as an approximation that
is close to the actual value.
- 624 999 424
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Tape Cartridge or IBM Enterprise WORM Tape Cartridge
that is written in EFMT3 or EEFMT3 recording format on an IBM 3592
Model E06 Enterprise Tape subsystem. This value is returned from the
drive and is used here as an approximation that is close to the actual
value.
- 976 562 176
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Extended Tape Cartridge or IBM Enterprise Extended
WORM Tape Cartridge that is written in EFMT3 or EEFMT3 recording format
on an IBM 3592 Model E06 Enterprise Tape subsystem or IBM 3592 Model
E07 Enterprise Tape subsystem. This value is returned from the drive
and is used here as an approximation that is close to the actual value.
- 1 562 499 072
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Extended Tape Cartridge or IBM Enterprise Extended
WORM Tape Cartridge that is written in EFMT4 or EEFMT4 recording format
on an IBM 3592 Model E07 Enterprise Tape subsystem. This value is
returned from the drive and is used here as an approximation that
is close to the actual value.
- 3 906 249 728
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Advanced Tape Cartridge or IBM Enterprise Advanced
WORM Tape Cartridge that is written in EFMT4 or EEFMT4 recording format
on an IBM 3592 Model E07 Enterprise Tape subsystem. This value is
returned from the drive and is used here as an approximation that
is close to the actual value.
- 488 281 088
- Represents the approximate number of kilobytes of data for an
IBM Enterprise Advanced Economy Tape Cartridge that is written in
EFMT4 or EEFMT4 recording format on an IBM 3592 Model E07 Enterprise
Tape subsystem. This value is returned from the drive and is used
here as an approximation that is close to the actual value.
Note: For tape volumes written using 18-track or
36-track format on IBM Cartridge System Tape or IBM Enhanced Capacity
Cartridge System Tape on an IBM 3480, 3490, or 3490E Magnetic Tape
Subsystem, the user can specify any capacity from 1 to 2 147 483 646
kilobytes of data.
The user defines the tape capacity in OAM with
SETOAM TAPECAPACITY statement of SYS1.PARMLIB(CBROAMxx).
This statement enables the user to set capacities higher or lower
than the standard capacities described previously. If the user has
specified a capacity with the SETOAM TAPECAPACITY statement that is
higher than the tape volume is physically capable of managing , the
data is written to the tape volume until the natural end of volume
is reached. In this case, the displayed capacity value is the value
that is indicated on the SETOAM TAPECAPACITY statement, even though
it is not possible to write to that capacity.
For 3592 tape
media, if the cartridge is scaled to its optimal performance capacity,
the approximate number of kilobytes of data is 20% of the cartridge
capacity.
- FRESPACE
- The available free space left for writing data in kilobyte units
on the volume. This value reflects the reduction of the percent-full
(PFULL) value associated with the storage group for this tape volume.
- LSTBLKID
- The block ID of the last block written on the volume.
- PFULL
- An indication of what percent of the tape has been written.
- NUMLBLKS
- The number of logical blocks of data that OAM has written to the
volume.
- NUMLKBW
- The number of logical kilobytes of data that OAM has written to
the volume. This value includes OAM control information recorded on
the tape volume as well as user object data.
- NUMPKBW
- The number of physical kilobytes of data that has been physically
recorded on the tape medium. This includes OAM control information
recorded on the tape volume as well as user object data.
Note: If
the data on a tape represented by a row in this table is being written
in a compacted format, the number of logical KB of data on the tape
and the number of physical KB of data on the tape might not be the
same.
- NUMLKBDE
- The number of logical kilobytes (KB) of data which have been deleted
from the tape volume.
Note: This number is an approximation.
Due to the fact that the application can issue a DB2 ROLLBACK for
the OSREQ DELETE, and OSMC can issue a DB2 ROLLBACK after the TAPEVOL
row update for NUMLKBDE has been submitted to the OAM address space,
this number might be greater than the actual amount of data which
has been deleted from this tape volume. Also, the object size is rounded
up to the next 1KB for this field, so deleting a 100 byte object will
result in NUMLKBDE being incremented by 1, even though the actual
amount of data deleted is significantly less than 1KB.
- FULL
- An indication of whether the volume is considered full by OAM.
The possible values of this column are listed below:
- Y
- The volume is considered full by OAM.
- N
- The volume is not full.
- P
- The volume is marked permanently full.
- READABLE
- An indication of whether the volume is considered readable by
OAM. The possible values are listed below:
- Y
- The volume is readable.
- N
- The volume is not readable.
- WRITABLE
- An indication of whether the volume is considered writable by
OAM.
- Y
- The volume is writable.
- N
- The volume is not writable. The WRITABLE column is set to N when
a permanent data check occurs while writing data to the volume. This
prevents the volume from being selected by OAM for the writing of
additional objects.
- INUSE
- An indication of whether the volume is in use by an OAM process.
The possible values are listed below:
- Y
- The volume is in use by an OAM process.
- N
- The volume is not in use by an OAM process.
- COPIED
- Reserved for future use.
- AVOLSER
- Reserved for future use.
- COMPACT
- The tape compaction indicator for this tape volume. The only valid
values for this field are:
- Y
- The tape volume was written in compacted format.
- N
- The tape volume was written in noncompacted format.
- EPI
- The ERDS
Physical Identifier which indicates the real underlying device type
that is used to write OAM objects to this volume. This column is used
to assist in problem diagnosis in a mixed device environment where
native and emulated devices coexist.
- MEMBER
- Indicates the name of the OAM within a Parallel Sysplex that is
managing the tape volume.
- For tape volumes that are mounted and allocated on a tape drive
for use by OAM, this member name is the member name of the OAM on
the system to which the tape drive is online and allocated.
- For tape volumes that are not mounted and allocated on a tape
drive for use by OAM, this member name is blank.
- BKTYPE
- The first or second backup copies of an object when the volume
has a type of "B", which indicates that it is a backup volume
belonging to an Object Backup storage group.
- OUNITNAM
- The original esoteric or generic name for the tape volume. The
esoteric or generic device type is inherited from the Object or Object
Backup storage group for the volume. If the allocated tape drive is
in an IBM tape library, this field is stored before the UNITNAME field
is changed to a generic device type. If the allocated tape drive is
not in an IBM tape library, the OUNITNAM field is the same as UNITNAME
field. OAM uses this field to allocate the tape volume to an Object
or Object Backup storage group after OAM returns the volume to OAM
scratch status. Options for initializing the OUNITNAM field include:
- Leaving the OUNITNAM field blank.
- Enabling OAMSCRATCHSYNCH mode using the SETOAM statement. OAM
fills in the esoteric name automatically.
- Copying the value from the UNITNAME field to the OUNITNAM field,
if you are not using tapes in an Automated Tape Library.
- Setting the OUNITNAM field to the appropriate esoteric name, if
you are using tapes in an Automated Tape Library and plan to return
expired tape volumes to OAM scratch status.
- DATACLAS
- This field represents the data class that is associated with a
tape volume. The data class is inherited from the Object storage group
that this volume was assigned to when it was originally allocated.
If SMS does not assign a data class when it allocates this volume,
the DATACLAS field is blank. OAM uses this field to allocate the tape
volume to an Object or Object Backup storage group after OAM returns
the volume to OAM scratch status. Options for initializing the DATACLAS
field include:
- Leaving the DATACLAS field blank.
- Enabling OAMSCRATCHSYNCH mode using the SETOAM OAMSCRATCHSYNCH
statement.
- Setting the DATACLAS field that is based on the Object or Object
Backup storage group to which the volume belongs.
- DSNFMT
- This field indicates the data set name format written on the tape
volume.
- If this field contains a blank, then the data set name written
on the volume is the original data set name format with no storage
group name low-level qualifier or the volume has no current OAM data
set written on the tape volume.
- If this field contains a character "G" for group, then the
data set name written on the volume has the storage group name appended.
- SUBLEVEL
- This field indicates with which tape sublevel this volume is associated.
Tape sublevels are defined by the OAM sublevel (OSL) parameter within
the SMS storage class construct definition, and associated with the
TAPEUNITNAME and L2TAPEUNITNAME keywords in the SETOAM statement of
the CBROAMxx Parmlib member. Valid values are:
- 1 This volume is associated with sublevel 1.
- 2 This volume is associated with sublevel 2.
- blank This volume is not associated with a sublevel. Only
applies to OAM scratch or backup volumes.
- CAPACITYO
- This field represents the overflow value for tape capacity. It
reflects the number of times the capacity value has exceeded 2 gigabytes.
- FRESPACEO
- This field represents the overflow value for free space on the
tape volume. It reflects the number of times the freespace value has
exceeded 2 gigabytes.
- NUMLKBWO
- This field represents the overflow value for logical kilobytes
written on the tape volume. It reflects the number of times the number
of kilobytes logically written to the tape volume has exceeded 2 gigabytes.
- NUMPKBWO
- This field represents the overflow value for physical kilobytes
written on the tape volume. It reflects the number of times the number
of kilobytes physically written to the tape volume has exceeded 2
gigabytes.
- NUMLKBDEO
- This field represents the overflow value for logical kilobytes
deleted from the tape volume. It reflects the number of times the
number of kilobytes logically deleted from the tape volume has exceeded
2 gigabytes.
- VOLATTRF
- This 16-bit field contains metadata associated with this tape
volume.
- Bits 0-13
- Reserved.
- Bit 14
- ON if this volume can have a block size greater than 32760.
- Bit 15
- ON if this is a logical WORM volume.