DSM/Tape Catalog Management Programming Manual

Common Definitions
DSM/Tape Catalog Management Programming Manual—520481-003
4-37
ZMCS Maps
ZMCS-MAP-ALTER-TAPEVOLUME
MEDIASRV includes this extensible structured token in ALTER TAPEVOLUME
commands to describe changes in the status of a tape in the volume catalog and its
pool. ZMCS-MAP-ALTER-TAPEVOLUME is based on ZMCS-DDL-ALTER-TAPEVOLUME,
which is defined as:
ZSTATUS
corresponds to the STATUS parameter of the MEDIACOM ALTER TAPEVOLUME
command. ZSTATUS denotes the new status assigned to the tape in the library.
Valid values are:
ZOVERRIDE
this field is supported for the programmatic version of this command as of the D30
release of DSM/TC software. No equivalent option is supported for the
MEDIACOM ALTER TAPEVOLUME command.
ZOVERRIDE (ON or OFF) denotes whether to alter the tape volume status even if
the current status is ASSIGNED.
•
ON indicates that the tape volume status is altered. If more than one tape
exists (volume set), all tapes are altered.
•
OFF denotes that a tape set that is assigned will not be altered (default).
def ZMCS-DDL-ALTER-TAPEVOLUME.
02 ZSTATUS type ZMCS-DDL-TAPEVOLSTATUS-ENM.
02 ZOVERRIDE type ZSPI-DDL-BOOLEAN.
02 ZBKUPFMT type ZMCS-DDL-BKUPFMT-ENM.
end.
ZMCS-VAL-TAPEVOLSTAT-UNSPECIF
The tape status is unspecified.
ZMCS-VAL-TAPEVOLSTAT-ASSIGNED
The tape is assigned.
ZMCS-VAL-TAPEVOLSTAT-BAD
The tape status is unusable.
ZMCS-VAL-TAPEVOLSTAT-RELEASED
The tape status is released. All files on the
tape might be expired, but the tape should
not be reused until its status is manually
changed to scratch.
ZMCS-VAL-TAPEVOLSTAT-SCRATCH
The tape is ready for immediate use as a
scratch tape (default).
ZMCS-VAL-TAPEVOLSTAT-SELECTED
The tape is selected.
ZMCS-VAL-TAPEVOLSTAT-INUSE
The tape is in use.
ZMCS-VAL-TAPEVOLSTAT-ANY
Accept a tape of any status.