The ARCTVEXT installation exit receives control during the following
situations:
- DFSMShsm tape deletion processing.
The ARCTVEXT exit receives
control either when all valid data is removed from a tape, or when
a RECYCLE FORCE command is issued. All valid data is removed after
a backup or migration tape is recycled, after a dump tape has its
contents deleted, or when the DELVOL PURGE command is used. This exit
is called for each tape, regardless of whether the SCRATCHTAPE or
HSMTAPE option is specified for the SETSYS TAPEDELETION command. If
you jointly manage your tapes with a tape management system other
than DFSMSrmm, you can write the exit routine to inform the tape management
system that the tape no longer contains valid DFSMShsm data.(Users of DFSMSrmm do
not need this exit because the equivalent DFSMShsm/DFSMSrmm interface
is always invoked.)
If an alternate tape exists for a tape
that is being deleted, both the alternate tape and the original tape
are deleted by a single call to delete the original tape.
- Backup of the control data sets and journal if the SETSYS CDSVERSIONBACKUP
command has been specified.
This exit is called after DFSMShsm uncatalogs
the oldest backup version. The exit is called separately for each
tape associated with the version being rolled off.
- Tape replace processing when an original tape is replaced by an
alternate tape. The ARCTVEXT exit releases the original tape.
- Tape copy processing if a failure occurs after the alternate tape
is mounted.
- EXPIREBV command processing when the EXPIREBV command is issued
for ABARSVERSIONS.
This exit is called after DFSMShsm successfully
deletes each ABACKUP output file associated with the ABARS version
being expired. The exit is called separately for each tape volume
associated with the files being deleted as part of the expiration
process. The exit is called without alternate volumes.
- ABACKUP or ARECOVER roll-off processing.
This exit is called
before DFSMShsm backs up or recovers an aggregate if DFSMShsm determines
that one or more of the oldest ABARS version records should be rolled
off. The exit is called separately for each tape associated with
the files belonging to the version being rolled off.
- ABACKUP processing when a failure occurs.
During ABACKUP cleanup
processing, this exit is called separately for each tape associated
with each ABACKUP output file being deleted during the cleanup process.
The tape volume exit does not receive control when tapes are being
marked unavailable by DFSMShsm.
You must write ARCTVEXT to be reentrant.