z/OS DFSMS Installation Exits
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Characteristics of the ARCTVEXT Exit

z/OS DFSMS Installation Exits
SC23-6850-01

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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014