VOLSER

Volume serial number. Cannot be updated.

STATUS

Status of the volume. (Refer to "Statuses of the Inquire/Update Screen" in this chapter.) Generally, cannot be updated. However, may be automatically updated if the value of related field MEDIA TYPE is changed.

General Information:

SL-NAME

Standard label name. Logical name of the volume.

OWNER

Owner of the volume.

MEDIA TYPE

Media type. A change to MEDIA TYPE can affect the following fields:

MEDIA DESC

Automatically updated.

CAPACITY USED

The Capacity Used value remains unchanged, but the Percentage Used value is automatically updated.

SLOT NUM

Affected only if the volume is vaulted.

MEDIA DESC

Description of the media (as specified in member CTTPARM). Generally, cannot be updated. However, may be automatically updated if the value of related field MEDIA TYPE is changed.

DESCRIPTION

Description of the volume.

VENDOR NAME

Name of the vendor.

STK GROUP

Name of the stacking group.

Retention and Location information:

RETENTION

Volume retention criteria.a  A change to this field does not change the actual expiration date (that is generally determined by the latest expiration date of the data sets in the volume). However, a change to data set retention criteria in the Dataset Update panel can cause an automatic recalculation of this value (see the description of field RETENTION in Dataset Update Panel).

RET-DATASET

Data set that determines the retention period of the volume. Control-M/Tape frequently modifies this field; it is therefore recommended that you not modify it.

LOCATION

Current location of the volume. Can be updated for active volumes only. Cannot be updated for scratch volumes.

Changing the value of this field is equivalent to immediately moving a volume to another location. A change to LOCATION can affect the following fields:

MOVE DATE

Automatically updated with the current date if it was not manually updated since entering the Volume Update panel.

STATUS

Automatically changed to one of the following statuses (depending on the specified situation):

Act-Out

If LOCATION is changed from MAINLIB and no vault pattern is specified for the volume.

Active

If LOCATION is changed to MAINLIB and no value pattern is specified for the volume.

Vaulted

If LOCATION is changed from MAINLIB and a vault pattern is specified for the volume.

Act-Retvlt

If LOCATION is changed to MAINLIB and a vault pattern is specified for the volume.

VAULT NAME

Affected only if the volume is vaulted in the new location.

SLOT NUM

Affected only if the volume is vaulted in the new location. Because the current slot number may be occupied in the new location, it is recommended that SLOT NUM be set to zeros so that an unoccupied slot is automatically assigned in the new location. (See the description of SLOT NUM below.)

ENTRY DATE

Automatically updated to match the MOVE DATE if the volume is vaulted in the new location.

MOVE DATE

Last date the volume was moved. If this field was not manually updated since entering the Volume Update panel, it is automatically updated to the current date when the value of the LOCATION field is changed.

CHECKIN DATE

Date the volume was checked into the active library.

RETURN DATE

Date the volume should return to the active library.

ATL INTR

Name of the Automated Tape Library interface used by Control-M/Tape to access the library to which the volume belongs.

TAPE LIBR

Name of the robotic tape library (if the volume resides in a robot).

Usage Information:

ACTIVE DS#

Number of data sets stored on the volume^a. Can be updated for active volumes only, but not for scratch volumes. A change to ACTIVE DS# can affect field LAST LABEL.

LAST LABEL

Last label number on the volume. Can be updated for active volumes only, but not for scratch volumes. A change to LAST LABEL can affect field ACTIVE DS#.

CAPACITY USED

Space currently in use on the volume (followed by the percentage of the total volume capacity this value represents). Can be updated for active volumes only, but not for Scratch volumes. (The percentage used value is protected but automatically updated if the CAPACITY USED value or MEDIA TYPE field is changed.)

DATA UNCOMP

Uncompressed size.

EXCP COUNT

Number of EXCPs performed on this volume since it was last scratched.

LAST ACCESS

Date of the last access of the volume.

BY JOB

Job that last accessed the volume.

CLEAN COUNT

Number of times option C (Clean) was specified for the volume in screen TI.

CLEAN DATE

Date the volume was last cleaned.

USE COUNT

Number of times the volume has been used (accessed).

User Information:

USER FIELD

Free text.

Vaulting Information:

Note: Only the first three vault entries are displayed.

If the total number of vault entries in the vault pattern for active volumes does not exceed three, vault information can be updated .

Vault information fields are protected for scratch volumes and for active volumes that have more than three vault entries.

V-DATASET

Label number of the data set that determines the vault pattern.

SLOT NUM

Slot number indicating where the volume is located in the vault. This field is affected by changes to field LOCATION, VAULT NAME and MEDIA TYPE.

When the user confirms changes upon exiting the Volume Update panel (see "Exiting the Volume Update panel" in this chapter), if field SLOT NUM or dependent fields have been changed, first the Volume record and then the Slot Definition record are updated. If SLOT NUM was changed to zero, the first available unoccupied slot in the Slot Definition record is automatically assigned to the volume.

If an error is detected when the Slot Definition record is being updated (for example, the specified slot number is in use by another volume), the Slot Definition record is not updated and the Volume Update panel is redisplayed to enable the user to correct the error. Note, however, that the Volume record has already been updated. At this point there is a discrepancy between the Slot Definition record and the Volume record. When this happens the user can do one of the following:

Correct the errors and press END to exit. In this case, if there are no errors, there is no confirmation window but both the Volume record and Slot Definition record are updated with the newest values. (If there are still errors, the Volume Update panel is redisplayed.)

Specify the CANCEL command to exit the Volume Update panel. In this case, the discrepancy between the Volume record and the Slot Definition record remains (and the same slot is used by at least two volumes).

VAULT NAME

Name of the vault. When a vault name is defined, field RETENTION is mandatory.

ENTRY DATE

Date the volume entered the vault.

RETENTION

Retention period of the volume in the vault. Valid format and values are the same as for the UNTIL value of statement DO VAULT (for example, DATE date, MVS CATALOG, CYCLES cycles). For more information, see DO VAULT: Action Parameter.