The OAM Object Tape Volume Return to MVS Scratch exit routine, CBRUXTVS_EXIT, can be used to notify the installation's tape management system that all knowledge of a given tape volume has been removed from OAM’s tape volume inventory. This is a notification only exit; OAM does not change it's tape volume expiration processing regardless of the return code supplied by the user exit. The exit is invoked after OAM issues the CBR2165I message indicating that OAM has removed the tape volume from the OAM inventory and released it for return to the MVS scratch pool.

The exit point uses Dynamic Exit Services, CSVDYNEX, which allows multiple exit routines to be simultaneously associated with a single exit point. No additional steps are required for you to use this dynamic exit with DFSMSrmm. The DFSMSrmm tape exit (EDGTVEXT) is always invoked independently of the dynamic exit routines. If your installation manages tape volumes with any tape management systems other than DFSMSrmm, you can write the exit routine(s), or use the same load module used for the ARCTVEXT exit and add them to this exit using the MVS dynamic exits facility.

This CBRUXTVS_EXIT exit point can provide a tape management system, through user-written or system exit routines that have been defined to the dynamic exits facility, with the information required to maintain an accurate inventory of OAM tapes. However, you do not have to use this exit point to use tapes with OAM.

The exit routine is called when OAM is returns an object tape to MVS scratch after it no longer contains valid files. The tape volume is deleted from the OAM TAPEVOL database before the exit is called. This is a notification only exit. A non-zero return code or an abend in the exit module has no effect on OAM’s object tape expiration processing. No error message is issued for a non-zero return code, but an error message is issued for an abend in the exit module.