z/OS DFSMSrmm Implementation and Customization Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


EDG_EXIT200 exit routine processing

z/OS DFSMSrmm Implementation and Customization Guide
SC23-6874-00

The DFSMSrmm sample EDGUX200 exit module performs these functions:
  • Validates the parameter list
  • Returns immediately for a system-managed volume

The EDG_EXIT200 installation exit is called during inventory management expiration processing in the DFSMSrmm started procedure address space. It is called by DFSMSrmm each time a volume is identified for the return to scratch action. The volume has not yet been returned to scratch in either the TCDB or the DFSMSrmm control data set. If the exit requests that the volume is not returned to scratch status, DFSMSrmm leaves the volume in pending release status. If the exit requests that DFSMSrmm ignore the data set name information, all data set information for the volume is removed from the DFSMSrmm control data set and the volume is returned to scratch status.

The EDG_EXIT200 installation exit is not called for volumes that are under manual scratch control until the scratch release action has been confirmed because of VLPOOL AUTOSCRATCH(NO). Use the EDG_EXIT200 installation exit to implement control of return to scratch without using the VLPOOL AUTOSCRATCH(NO) feature. For example, you can use EDG_EXIT200 to check if the scratch action has been confirmed before you allow EXPROC to scratch the volume. When MVFLGE.MVRETSCR is set, the scratch action has not been confirmed. If you want to manually cleanup volumes on another system, use this flag and set the PL200_SET_NOSCRATCH to prevent return to scratch. When MVFLGE.MVRETSCR is off, manual actions are performed and confirmed, and you can allow the volume to return to scratch.

When any exit module detects an incorrect parameter list and sets return code 16, DFSMSrmm skips return to scratch processing for the volume and issues message EDG0313I the first occurrence and EDG2448I at the end of processing. When any exit module abends, DFSMSrmm disables return to scratch processing for the remainder of the EXPROC run. and issues message EDG0314I is issued for the first occurrence, followed by EDG2447I.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014