z/OSVersion 2 Release 3
DFSMSrmm Implementation andCustomization Guide
IBM
SC23-6874-30
Note
Before using this information and the product it supports, read the information in “Notices” on page537.
This edition applies to Version 2 Release 3 of z/OS (5650-ZOS) and to all subsequent releases and modifications untilotherwise indicated in new editions.
Last updated: 2019-03-01© Copyright International Business Machines Corporation 1992, 2019.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract withIBM Corp.
Contents
List of Figures...................................................................................................... xvList of Tables.......................................................................................................xxi
About this document......................................................................................... xxiiiHow to use this document.......................................................................................................................xxiiiHow to find samples in this document....................................................................................................xxivRequired product knowledge.................................................................................................................. xxivz/OS information...................................................................................................................................... xxivNotational conventions............................................................................................................................xxiv
How to read syntax diagrams.............................................................................................................xxivHow to abbreviate commands and operands...................................................................................xxviiHow to use continuation characters................................................................................................. xxviiDelimiters.......................................................................................................................................... xxviiCharacter sets................................................................................................................................... xxvii
How to send your comments to IBM................................................................... xxixIf you have a technical problem.............................................................................................................. xxix
Summary of changes..........................................................................................xxxSummary of changes for z/OS Version 2 Release 3.................................................................................xxxSummary of changes for z/OS Version 2 Release 2.................................................................................xxxSummary of changes for z/OS Version 2 Release 1................................................................................xxxi
z/OS Version 2 Release 1 summary of changes................................................................................ xxxi
Chapter 1. Introducing DFSMSrmm........................................................................ 1What is a RMMplex?..................................................................................................................................... 1What libraries and locations can DFSMSrmm manage?............................................................................. 1
What is in a removable media library?................................................................................................... 1What is in a system-managed tape library?...........................................................................................2What is in a non-system-managed tape library?................................................................................... 3What is in a storage location?.................................................................................................................3
How does DFSMSrmm manage these libraries and locations?.................................................................. 3Setting up your installation options....................................................................................................... 4Selecting the retention method............................................................................................................. 4Defining retention and movement policies for the VRSEL retention method.......................................5Running DFSMSrmm utilities................................................................................................................. 7
What resources does DFSMSrmm manage?............................................................................................... 8Shelf locations........................................................................................................................................ 9Volumes................................................................................................................................................ 10Data sets...............................................................................................................................................14Year 2000 support................................................................................................................................14Software products................................................................................................................................ 14Owner information............................................................................................................................... 14
How does DFSMSrmm help you create reports?...................................................................................... 14Using DFSMSrmm report generator.....................................................................................................15Using DFSMSrmm ISPF dialog and RMM TSO subcommands............................................................ 15Using the EDGAUD and EDGRPTD report utilities............................................................................... 15Using the DFSMSrmm EDGRRPTE exec...............................................................................................16Using the DFSORT ICETOOL utility...................................................................................................... 16Using the DFSMSrmm application programming interface.................................................................16
How does DFSMSrmm authorization and security work?.........................................................................16What tape usage does DFSMSrmm support?............................................................................................16
iii
How does DFSMSrmm validate tape mounts?..........................................................................................17Why does DFSMSrmm reject tape volumes?............................................................................................ 18
Rejects caused by installation controls............................................................................................... 18Rejects caused by validation failure.................................................................................................... 19Rejects caused by DFSMSrmm rules................................................................................................... 19
Who can use DFSMSrmm and how?..........................................................................................................20General user......................................................................................................................................... 20Tape librarian........................................................................................................................................20Storage administrator.......................................................................................................................... 20Application programmer...................................................................................................................... 21System programmer.............................................................................................................................21Operator................................................................................................................................................21Using DFSMSrmm.................................................................................................................................21
What health checks does DFSMSrmm provide?....................................................................................... 22
Chapter 2. Implementing DFSMSrmm.................................................................. 23Step 1: Preparing to implement DFSMSrmm............................................................................................ 23Step 2: Running the installation verification procedure (optional).......................................................... 24Step 3: Updating JES3 (optional).............................................................................................................. 24Step 4: Updating installation exits............................................................................................................ 24Step 5: Updating SYS1.PARMLIB members..............................................................................................25
Updating IEFSSNxx.............................................................................................................................. 25Updating IKJTSOxx to authorize DFSMSrmm commands.................................................................. 26Updating SMFPRMxx (optional)........................................................................................................... 27Updating GRSRNLxx (optional)............................................................................................................ 27Updating AUTORxx (optional).............................................................................................................. 30Enabling DFSMSrmm............................................................................................................................42
Step 6: Using the Problem Determination Aid Facility (optional).............................................................43Step 7: Setting up DFSMSrmm disposition processing (optional)............................................................43Step 8: Updating the procedure library.....................................................................................................43Step 9: Assigning DFSMSrmm a RACF user ID......................................................................................... 46Step 10: Defining parmlib member EDGRMMxx....................................................................................... 47Step 11: Tailoring parmlib member EDGRMMxx.......................................................................................47Step 12: Creating the DFSMSrmm control data set..................................................................................48
Roadmap for creating the control data set..........................................................................................48Defining the DFSMSrmm control data set........................................................................................... 49Calculating DASD space for the DFSMSrmm control data set............................................................ 49Placing the DFSMSrmm control data set............................................................................................. 50Allocating space for the control data set.............................................................................................50Protecting the control data set............................................................................................................ 51Initializing the control data set............................................................................................................ 51Planning to back up the control data set............................................................................................. 52
Step 13: Creating the journal.....................................................................................................................52Roadmap for creating the journal........................................................................................................ 53Calculating DASD space for the journal............................................................................................... 53Placing the journal................................................................................................................................54Allocating space for the journal........................................................................................................... 54Protecting the journal...........................................................................................................................55Backing up the journal..........................................................................................................................55
Step 14: Authorizing users........................................................................................................................ 55Step 15: Making the DFSMSrmm ISPF dialog available to users............................................................. 55
Adding DFSMSrmm to an ISPF selection panel.................................................................................. 56Modifying an ISPF selection panel.......................................................................................................57Enabling ISPF data set list (DSLIST) support...................................................................................... 58
Step 16: Restarting z/OS with DFSMSrmm implemented........................................................................ 59Step 17: Tailoring DFSMSrmm set up........................................................................................................60Step 18: Updating the workload management service definition for DFSMSrmm.................................. 60
iv
Step 19: Starting DFSMSrmm....................................................................................................................60Stopping DFSMSrmm........................................................................................................................... 61Quiescing DFSMSrmm..........................................................................................................................62Restarting DFSMSrmm......................................................................................................................... 63Checking DFSMSrmm status................................................................................................................63
Step 20: Defining resources...................................................................................................................... 63Defining shelf locations........................................................................................................................63Defining owner information to DFSMSrmm.........................................................................................64Defining volumes..................................................................................................................................64Defining vital record specifications......................................................................................................66
Step 21: Updating the operational procedures.........................................................................................66Step 22: Initializing the DFSMSrmm subsystem and tape recording.......................................................66
Enabling the DFSMSrmm subsystem interface................................................................................... 67Changing the DFSMSrmm running mode.............................................................................................67Activating the tape volume interface...................................................................................................67Restarting the DFSMSrmm subsystem................................................................................................ 67
Step 23: Setting up DFSMSrmm utilities...................................................................................................68Step 24: Setting up DFSMSrmm web service (optional)...........................................................................69Step 26: Installing PTFs and the SMP/E maintenance to DFSMSrmm.....................................................69
Chapter 3. Setting up DFSMSrmm client and server systems................................. 71Implementing DFSMSrmm client and server systems............................................................................. 72Using the DFSMSrmm client and server systems..................................................................................... 73Managing catalogs in an RMMplex............................................................................................................ 74
Chapter 4. Setting up DFSMSrmm web service..................................................... 75Implementing the DFSMSrmm web service............................................................................................. 75
Using the z/OS WebSphere Application Server................................................................................... 75Using the Apache-Tomcat server.........................................................................................................76
Using the DFSMSrmm web service sample client.................................................................................... 79Setting the memory limit for returned XML data when using the z/OS WebSphere Application
Server.................................................................................................................................................... 80Setting the memory limit for returned XML data when using the Apache Tomcat server.......................81Debugging the DFSMSrmm web service................................................................................................... 81
Chapter 5. Organizing the removable media library...............................................83Organizing the library by pools.................................................................................................................. 83
Pooling overview.................................................................................................................................. 83Pooling considerations......................................................................................................................... 84Calculating pool size.............................................................................................................................86Defining pools in parmlib member EDGRMMxx.................................................................................. 86Changing pool definitions.....................................................................................................................87Designing rack pools............................................................................................................................ 88Designing scratch pools....................................................................................................................... 88
Requesting and using scratch pools..........................................................................................................89Using SMS tape storage groups for DFSMSrmm scratch pooling.............................................................90
Making an ACS storage group assignment.......................................................................................... 90A pooling example................................................................................................................................92
Managing pools with job name and data set name...................................................................................93Assigning policies...................................................................................................................................... 93
Using SMS management class to retain non-system-managed volumes with VRSEL retentionmethod............................................................................................................................................ 95
Managing volumes with special dates................................................................................................. 97Using volumes with special expiration dates...................................................................................... 97Using management class to retain system-managed volumes managed by VRSEL retention
method............................................................................................................................................ 98Using the SMS pre-ACS interface...................................................................................................... 100
v
Exploiting SMS management class attributes...................................................................................100Managing volumes with duplicate volume serial numbers.................................................................... 102
Using volumes with duplicate volume serial numbers..................................................................... 102Changing duplicate volume serial numbers...................................................................................... 103Adding a duplicate volume into a system-managed tape library..................................................... 104
Managing undefined volume serial numbers..........................................................................................104Segregating WORM tapes in separate scratch pools..............................................................................104
Chapter 6. Running DFSMSrmm with system-managed tape libraries.................. 105Using DFSMSrmm with system-managed tape libraries........................................................................ 105
Associating volumes and system-managed libraries........................................................................106Cartridge entry processing.................................................................................................................106Manual cartridge entry processing.................................................................................................... 106Managing scratch pools..................................................................................................................... 107Ejecting volumes from system-managed libraries............................................................................107Returning volumes to the system-managed library..........................................................................108Volume-not-in-library processing..................................................................................................... 109Confirming volume movement for system managed libraries.......................................................... 112Defining system-managed volume information................................................................................ 112Initializing scratch volumes in system-managed libraries............................................................... 113Using storage group names............................................................................................................... 114
Using DFSMSrmm with the IBM totalstorage virtual tape server.......................................................... 114Defining logical volumes in a virtual tape server library................................................................... 115Logical volume cartridge entry processing........................................................................................115Managing stacked volumes................................................................................................................117Deleting stacked volume information................................................................................................118DFSMSrmm support for stacked volumes when stacked volume support is enabled.....................118DFSMSrmm support for stacked volumes when stacked volume support is not enabled.............. 124Enabling stacked volume support..................................................................................................... 126Performing a virtual export of logical volumes..................................................................................127
Recovering a logical volume from an exported stacked volume............................................................128Setting up DFSMSrmm for the system-managed tape library................................................................128
Using the system-managed tape library with new volumes.............................................................128Using the system-managed tape library with volumes already defined in dfsmsrmm....................129Using the system-managed tape library with existing volumes....................................................... 130Using DFSMSrmm with an existing automated tape library............................................................. 130
Returning volumes to scratch status...................................................................................................... 131Partitioning system-managed tape libraries...........................................................................................131Sharing a system-managed library and a BTLS-managed library.......................................................... 133Moving from a non-system-managed to a system-managed IBM automated tape library.................. 134
Chapter 7. Running DFSMSrmm with BTLS......................................................... 135Setting up scratch pools for BTLS-managed volumes............................................................................135Running DFSMSrmm inventory management with BTLS....................................................................... 136Running EDGINERS for BTLS-managed volumes...................................................................................136Restrictions.............................................................................................................................................. 136Defining volume information for BTLS-managed volumes.....................................................................137Returning BTLS-managed volumes to scratch....................................................................................... 137
Chapter 8. Managing storage locations............................................................... 139Types of storage locations.......................................................................................................................139Defining storage locations....................................................................................................................... 140Implementing installation defined storage locations.............................................................................140Implementing storage locations as home locations.............................................................................. 141Managing shelf space for home locations...............................................................................................142Reusing bins in storage locations............................................................................................................142Moving volumes to storage locations......................................................................................................142
vi
Moving volumes by location...............................................................................................................143Moving volumes by media shape.......................................................................................................143Moving volumes manually..................................................................................................................144Assigning bins in storage locations....................................................................................................145
Changing storage locations..................................................................................................................... 145Deleting storage locations.......................................................................................................................145Switching volumes to installation defined storage locations................................................................. 146Converting from built-in storage locations............................................................................................. 146Going back to built-in storage locations................................................................................................. 147
Chapter 9. Using the parmlib member EDGRMMxx.............................................. 149Defining storage locations: LOCDEF........................................................................................................149
LOCDEF command syntax..................................................................................................................150LOCDEF command operands............................................................................................................. 151
Defining media information: MEDINF..................................................................................................... 154MEDINF command syntax................................................................................................................. 155MEDINF command operands.............................................................................................................155Using MEDINF REPLACE commands to implement volume replacement policies..........................158Example of using the MEDINF STK command.................................................................................. 159
Defining mount and fetch messages: MNTMSG..................................................................................... 160MNTMSG command syntax................................................................................................................161MNTMSG command operands........................................................................................................... 161
Controlling the use of tape volumes: OPENRULE................................................................................... 162OPENRULE command syntax.............................................................................................................163OPENRULE command operands........................................................................................................ 163
Defining system options: OPTION...........................................................................................................166OPTION command syntax..................................................................................................................167OPTION command operands.............................................................................................................169Using the OPTION command to switch from SMF record types to IBM-assigned SMF record
types..............................................................................................................................................196Partitioning tape volumes: PRTITION.....................................................................................................196
PRTITION command syntax.............................................................................................................. 197PRTITION command operands..........................................................................................................197
Implementing PRTITION and OPENRULE parmlib commands..............................................................199Reviewing installation exits............................................................................................................... 200Identifying basic rules........................................................................................................................200Examples of OPENRULE and PRTITION commands.........................................................................201
Defining tapes not available on systems: REJECT..................................................................................202REJECT command syntax.................................................................................................................. 203REJECT command operands..............................................................................................................203Converting REJECT commands to PRTITION and OPENRULE commands...................................... 204
Defining security classes: SECCLS.......................................................................................................... 206SECCLS command syntax.................................................................................................................. 207SECCLS command operands..............................................................................................................208
Defining pools: VLPOOL...........................................................................................................................209VLPOOL command syntax..................................................................................................................209VLPOOL command operands............................................................................................................. 210
Chapter 10. Authorizing DFSMSrmm users and ensuring security........................215Protecting DFSMSrmm resources with RACF profiles............................................................................ 215Creating profiles.......................................................................................................................................218Setting the level of access for the DFSMSrmm resources......................................................................219Authorizing resources..............................................................................................................................224
General user functions.......................................................................................................................227Storage administrator functions........................................................................................................ 227System programmer functions.......................................................................................................... 228Librarian functions............................................................................................................................. 228
vii
Inventory management functions..................................................................................................... 229Operator functions............................................................................................................................. 230
Using the tape relabeling resources....................................................................................................... 230Creating audit trails................................................................................................................................. 231
Control data set information..............................................................................................................231SMF audit information........................................................................................................................231RACF audit information......................................................................................................................231
Using security classification processing................................................................................................. 232Preventing the use of IEHINITT.............................................................................................................. 232Controlling RACF tape profile processing............................................................................................... 232
Recommendations for tape security................................................................................................. 235Recommendations for using RACF tape profile processing..............................................................236Rejecting volumes on specific systems in a system complex...........................................................237Maintaining the user access list.........................................................................................................237
Using RACF with DFSMSrmm.................................................................................................................. 238DFSMSrmm RACF tape security support...........................................................................................238DFSMSrmm automatic tape security support processing................................................................ 238Data set profile processing implications........................................................................................... 239RACF installation exit conversion...................................................................................................... 239Using RACF options for authorizing RMM TSO subcommands......................................................... 240
Using the SAF interface........................................................................................................................... 240SAF calls for authorization checking................................................................................................. 240SAF and RACF calls for creating, updating and deleting security profiles....................................... 243
Chapter 11. Using DFSMSrmm programming interfaces...................................... 247Releasing tapes: EDGTVEXT....................................................................................................................247
Invocation...........................................................................................................................................248Input................................................................................................................................................... 248Output.................................................................................................................................................248Processing.......................................................................................................................................... 248Environment....................................................................................................................................... 248
Managing DFSMShsm tapes: EDGDFHSM...............................................................................................248Invocation...........................................................................................................................................249Input................................................................................................................................................... 249Output.................................................................................................................................................249Processing.......................................................................................................................................... 249Environment....................................................................................................................................... 249
Managing system-managed tape library volumes: EDGLCSUX..............................................................250Input................................................................................................................................................... 251Output.................................................................................................................................................251Processing.......................................................................................................................................... 253Environment....................................................................................................................................... 261
Processing fetch and mount messages: EDGMSGEX............................................................................. 261Input................................................................................................................................................... 261Output.................................................................................................................................................261Processing.......................................................................................................................................... 261Environment....................................................................................................................................... 261
Processing JES3 messages: EDG3X71................................................................................................... 262Input................................................................................................................................................... 262Output.................................................................................................................................................262Processing.......................................................................................................................................... 262Environment....................................................................................................................................... 262
Setting up parallel processing.................................................................................................................262Setting up parallel processing using SMP/E...................................................................................... 263Setting up parallel processing outside of SMP/E...............................................................................264
Chapter 12. Using DFSMSrmm installation exits................................................. 267
viii
Using the DFSMSrmm EDG_EXIT100 installation exit........................................................................... 267Planning to manage scratch pools with EDG_EXIT100 ................................................................... 268Managing scratch pools..................................................................................................................... 269Specifying the retention method to be used for new tape data sets................................................271Copying data set attributes in a tape copy application.....................................................................273Excluding specific data sets from VRSEL processing as they are created or rewritten................... 274Ignoring duplicate or undefined volume serial numbers..................................................................275Using vital record specification management values to retain tape volumes..................................279Using the EDG_EXIT100 installation exit from pre-ACS processing................................................ 281Creating sticky labels......................................................................................................................... 281Modifying DFSMSrmm label output...................................................................................................284Controlling tape volume data set recording...................................................................................... 285Changing location information with EDG_EXIT100.......................................................................... 287EDG_EXIT100 exit routine processing.............................................................................................. 287Setting up the EDG_EXIT100 routine environment.......................................................................... 293Installing the EDGUX100 default exit routine...................................................................................293Deleting the EDG_EXIT100 exit routines.......................................................................................... 294Writing an exit routine for the EDG_EXIT100 exit.............................................................................295EDG_EXIT100 installation exit routine return codes........................................................................300
Using the EDG_EXIT200 installation exit............................................................................................... 300EDG_EXIT200 exit routine processing.............................................................................................. 300Setting up the EDG_EXIT200 routine environment.......................................................................... 301Installing the EDGUX200 default exit routine...................................................................................301Deleting the EDG_EXIT200 exit routines.......................................................................................... 303Writing an exit routine for the EDG_EXIT200 exit.............................................................................303EDG_EXIT200 installation exit routine return codes........................................................................305
Using the EDG_EXIT300 installation exit............................................................................................... 305EDG_EXIT300 exit routine processing.............................................................................................. 305Setting up the EDG_EXIT300 routine environment.......................................................................... 306Installing the EDGUX300 default exit routine...................................................................................306Deleting the EDG_EXIT300 exit routines.......................................................................................... 307Writing an exit routine for the EDG_EXIT300 exit.............................................................................308EDG_EXIT300 installation exit return codes.................................................................................... 309
Chapter 13. Running DFSMSrmm with DFSMShsm..............................................311Defining DFSMShsm to RACF.................................................................................................................. 311Authorizing DFSMShsm to DFSMSrmm resources................................................................................. 311Authorizing ABARS to DFSMSrmm resources.........................................................................................312Setting DFSMSrmm options when using DFSMShsm............................................................................. 312Setting DFSMShsm options when using DFSMSrmm............................................................................. 313
Setting DFSMShsm system options...................................................................................................313Setting DFSMShsm dump definitions................................................................................................ 314DFSMSrmm support for DFSMShsm naming conventions................................................................314DFSMSrmm support for retention and pooling................................................................................. 314Retaining DFSMShsm tapes using expiration dates..........................................................................314
Using the EXPDT retention method to manage DFSMShsm tapes.........................................................314Using the VRSEL retention method to manage DFSMShsm tapes.........................................................315
Retaining all DFSMShsm tapes.......................................................................................................... 315Retaining open data sets................................................................................................................... 316Retaining single file format migration tapes..................................................................................... 316Retaining multifile format migration tapes........................................................................................317Retaining single file format backup tapes......................................................................................... 317Retaining multifile format backup tapes........................................................................................... 318Retaining and moving TAPECOPY tapes or DUPLEX tapes............................................................... 318Retaining and moving dump tapes.................................................................................................... 319Retaining and moving tapes written by ABARS.................................................................................321Retaining and moving ABARS accompany tapes.............................................................................. 321
ix
Retaining DFSMShsm control data set backup tapes....................................................................... 322Retaining cycles of dump tapes.........................................................................................................323Retaining DFSMShsm tapes with extra days retention..................................................................... 324
Disaster recovery using DFSMShsm alternate tapes with DFSMSrmm................................................. 324Securing tapes when running DFSMShsm and DFSMSrmm...................................................................325Recommendations for using DFSMSrmm and DFSMShsm.................................................................... 325
Chapter 14. Performing inventory management..................................................327Scheduling DFSMSrmm utilities..............................................................................................................327Running inventory management............................................................................................................. 328
Inventory management considerations for EXPROC and VRSEL processing...................................329Managing exceptions in retention......................................................................................................329Inventory management considerations............................................................................................ 332DFSMSrmm inventory management considerations when client/server support is enabled......... 332Allocating data sets for inventory management............................................................................... 333Creating an extract data set...............................................................................................................335JCL for EDGHSKP............................................................................................................................... 337EXEC parameters for EDGHSKP.........................................................................................................337SYSIN file for the EDGHSKP utility.................................................................................................... 342EDGSPLCS file for the EDGHSKP utility............................................................................................. 345
Running vital record processing..............................................................................................................345JCL for vital record processing...........................................................................................................347Using the vital records retention report............................................................................................ 348Using the inventory management ACTIVITY file...............................................................................352How vital record processing works....................................................................................................352
Running storage location management processing............................................................................... 357JCL for storage location management processing............................................................................ 357How storage location management processing works..................................................................... 357
Running expiration processing................................................................................................................359JCL for expiration processing.............................................................................................................359How expiration processing works......................................................................................................359
Running DFSMSrmm catalog synchronization........................................................................................364DFSMSrmm catalog processing.........................................................................................................366JCL for catalog synchronization.........................................................................................................366Synchronizing the DFSMSrmm control data set with user catalogs in a fully shared catalog
environment.................................................................................................................................. 366Synchronizing the DFSMSrmm control data set with user catalogs when catalogs are not fully
shared............................................................................................................................................367Confirming global volume movement..................................................................................................... 368Confirming global release actions...........................................................................................................369Backing up the control data set.............................................................................................................. 369
Ensuring a consistent copy of the DFSMSrmm CDS..........................................................................371JCL for using backup to create a CDS copy....................................................................................... 371JCL for backing up the control data set and journal..........................................................................372Backing up the journal....................................................................................................................... 373JCL for backing up the journal........................................................................................................... 373
Steps for automating control data set backup and journal clearing...................................................... 373Return codes for EDGHSKP..................................................................................................................... 374
Chapter 15. Maintaining the control data set...................................................... 375DFSMSrmm considerations when client/server support is enabled......................................................376Using EDGBKUP.......................................................................................................................................377
JCL for EDGBKUP............................................................................................................................... 377EXEC parameters for EDGBKUP........................................................................................................ 378DD statements for EDGBKUP.............................................................................................................379SYSIN file for EDGBKUP.....................................................................................................................380Return codes for EDGBKUP............................................................................................................... 382
x
Additional EDGBKUP return code information..................................................................................382Customizing the DSSOPT DD statement............................................................................................383
Backing up the control data set.............................................................................................................. 384Backing up the DFSMSrmm control data set and journal................................................................. 385
Updating the active control data set....................................................................................................... 385JCL for EDGUPDT............................................................................................................................... 386DD statements for EDGUPDT ............................................................................................................ 386SYSIN file for EDGUPDT..................................................................................................................... 387
Restoring the control data set................................................................................................................. 388Controlling the control data set recovery point.................................................................................388Restoring the control data set with forward recovery.......................................................................388Restoring the control data set without forward recovery................................................................. 389Forward recovering the control data set........................................................................................... 390Restoring the control data set at a recovery site...............................................................................390Using non-dfsmsrmm utilities to restore the control data set......................................................... 391
Reorganizing the control data set........................................................................................................... 392Monitoring the space used by the control data set................................................................................ 393Changing the size of the control data set and journal............................................................................ 393Recovering from control data set update failures.................................................................................. 393
Recovery processing.......................................................................................................................... 394Handling I/O requests following a failure..........................................................................................394
Moving the control data set and journal to a different device................................................................395Steps for moving the control data set and journal using the DFSMSrmm EDGHSKP utility with
the PARM='BACKUP' parameter...................................................................................................395Steps for moving the control data set and journal using DFSMSrmm utility EDGHSKP utility
with the PARM='BACKUP(DSS)' parameter..................................................................................397Moving the journal using DFSMSrmm utilities...................................................................................397Steps for moving the control data set using non-dfsmsrmm utilities.............................................. 398
Using EDGUTIL for tasks such as creating and verifying the control data set.......................................399JCL for EDGUTIL.................................................................................................................................399EXEC parameters for EDGUTIL.......................................................................................................... 400SYSIN file for VERIFY and MEND processing.................................................................................... 404How EDGUTIL performs VERIFY and MEND processing for volumes.............................................. 406Creating or updating the control data set control record..................................................................407Verifying the contents of the control data set................................................................................... 409Verifying the control data set and tape configuration database.......................................................411Synchronizing the contents of the control data set.......................................................................... 411Mending the control data set............................................................................................................. 412Setting up DFSMSrmm stacked volume support.............................................................................. 413Setting up DFSMSrmm common time support..................................................................................413Enabling extended bin support..........................................................................................................415EDGSPLCS file for the EDGUTIL utility...............................................................................................415Return codes for EDGUTIL.................................................................................................................415
Using EDGSPLCS to issue commands to OAM for system-managed volumes...................................... 416EXEC parameters for EDGSPLCS....................................................................................................... 416INDD input file....................................................................................................................................417OUTDD output file.............................................................................................................................. 419Return codes for EDGSPLCS.............................................................................................................. 419
Sharing the DFSMSrmm control data set................................................................................................419Running DFSMSrmm inventory management when sharing the control data set........................... 419Running EDGINERS when sharing the control data set.................................................................... 420Defining volume information when sharing the control data set......................................................420Confirming volume movement when sharing the control data set...................................................420Returning volumes to scratch when sharing the control data set.................................................... 420
Chapter 16. Initializing, erasing, and scanning tape volumes.............................. 421Replacing IEHINITT with EDGINERS......................................................................................................422
xi
Using EDGINERS......................................................................................................................................422Initializing and erasing volumes automatically.................................................................................423Initializing,Erasing, and scanning volumes manually....................................................................... 423Initializing and erasing volumes automatically using multiple tape drives......................................424JCL for EDGINERS..............................................................................................................................424SCAN output.......................................................................................................................................435Using EDGINERS with system-managed tape libraries.................................................................... 437Controlling access to EDGINERS....................................................................................................... 440How DFSMSrmm selects an ISO/ANSI label Version........................................................................440Producing label symmetry................................................................................................................. 440How EDGINERS processing works.................................................................................................... 441Return codes for EDGINERS.............................................................................................................. 441
EDGINERS examples............................................................................................................................... 442Example 1: Write IBM standard labels on three tapes..................................................................... 442Example 2: Write an ISO/ANSI label on a tape................................................................................. 442Example 3: Place two groups of serial numbers on six tape volumes............................................. 443Example 4: Place serial numbers on eight tape volumes................................................................. 443Example 5: Relabel a volume............................................................................................................ 444Example 6: Automatically initialize or erase 3480 volumes.............................................................444Example 7: Automatically initialize and erase volumes in a system-managed library.................... 445Example 8: Automatically initialize 50 scratch enhanced capacity cartridges................................445Example 9: Manually erase a volume................................................................................................ 445Example 10: Automatically initialize volumes using multiple tape drives....................................... 446Example 11: Manually labeling duplicate volumes using EDGINERS.............................................. 446Example 12: Selecting EHPCT volumes for processing automatically.............................................446Example 13: Manually scanning a system managed DFSMSrmm volume....................................... 447
Chapter 17. Customizing DFSMSrmm................................................................. 449Changing the initial entry point to the DFSMSrmm dialog..................................................................... 449Adding local dialog extensions................................................................................................................450
Customizing the local dialog with 'U' line command.........................................................................451Customize point-and-shoot fields in the DFSMSrmm dialog................................................................. 451Changing the ADD product volume defaults...........................................................................................451Customizing DFSMSrmm messages for report titles and user notification........................................... 451
Customizing DFSMSrmm report titles............................................................................................... 452Customizing notification messages and notes..................................................................................452
Managing VM tape volumes.....................................................................................................................458Replenishing scratch volumes in a system-managed library.................................................................458Automating backup..................................................................................................................................459Using the LABEL procedure.....................................................................................................................459Processing NL label tapes: EDG019VM.................................................................................................. 460
Input................................................................................................................................................... 460Output.................................................................................................................................................460Processing.......................................................................................................................................... 461Environment....................................................................................................................................... 461
Chapter 18. Using the Problem Determination Aid Facility ..................................463Roadmap for using the Problem Determination Aid...............................................................................463Planning to use the PDA facility.............................................................................................................. 464Determining how long to keep trace information................................................................................... 464
Short-term trace history.................................................................................................................... 464Long-term trace history..................................................................................................................... 464
Determining Problem Determination Aid (PDA) log data set size.......................................................... 464Enabling the Problem Determination Aid (PDA) facility......................................................................... 464Allocating the Problem Determination Aid (PDA) log data sets............................................................. 465Increasing the size of the Problem Determination Aid (PDA) log data sets.......................................... 465Maintaining a history of Problem Determination Aid (PDA) log data..................................................... 466
xii
Printing the Problem Determination Aid (PDA) log data sets.................................................................467
Chapter 19. Setting up DFSMSrmm disposition processing..................................469Implementing DFSMSrmm disposition control file processing..............................................................469Modifying the contents of the disposition control file............................................................................ 470Selecting the method used for label processing.................................................................................... 472Modifying tape labels.............................................................................................................................. 473
Chapter 20. Running DFSMSrmm with JES3....................................................... 475Preventing JES3 from validating volumes.............................................................................................. 475Updating JES3 fetch and mount messages............................................................................................ 475
Steps for using the EDG3UX71 USERMOD........................................................................................475Using the EDG3IIP1 USERMOD......................................................................................................... 476Using the EDG3LVVR USERMOD........................................................................................................476
Using the EDG3UX62 USERMOD to create and mount no label tapes.................................................. 476
Chapter 21. Running DFSMSrmm with the IBM Tivoli Workload Scheduler forz/OS.............................................................................................................. 479Using a Tivoli special resource when running DFSMSrmm with the IBM Tivoli Workload Scheduler
for z/OS............................................................................................................................................... 479Setting up DFSMSrmm to use the IBM Tivoli Workload Scheduler for z/OS..........................................480
Descriptions of DFSMSrmm jobs to run with the IBM Tivoli Workload Scheduler for z/OS.............480IBM Tivoli Workload Scheduler for z/OS applications for DFSMSrmm.............................................482Customizing the IBM Tivoli Workload Scheduler for z/OS batch loader statements.......................483Setting up IBM Tivoli Workload Scheduler for z/OS workstations....................................................483Event triggered tracking.....................................................................................................................484
Chapter 22. Using the parmlib member EDGDEFxx............................................. 485Introduction to the defaults table...........................................................................................................485Modifying the defaults table....................................................................................................................486Defining defaults table entries: DEFAULT............................................................................................... 486
DEFAULT command syntax................................................................................................................ 486DEFAULT command operands........................................................................................................... 487
Appendix A. DFSMSrmm mapping macros.......................................................... 493OAM interface: EDGLCSUP...................................................................................................................... 493Installation exit mapping macro: EDGPL100..........................................................................................501Installation exit mapping macro: EDGPL200..........................................................................................510Installation exit mapping macro: EDGPL300..........................................................................................512Sticky label data: EDGSLAB.....................................................................................................................515
Appendix B. Using DFSMSrmm samples............................................................. 521
Appendix C. Evaluating removable media management needs............................ 527
Appendix D. Problem Determination Aid log data set size work sheet for long-term trace history.......................................................................................... 529
Appendix E. Problem Determination Aid log data set size work sheet for short-term trace history.......................................................................................... 531
Appendix F. Accessibility................................................................................... 533Accessibility features.............................................................................................................................. 533Consult assistive technologies................................................................................................................ 533Keyboard navigation of the user interface.............................................................................................. 533
xiii
Dotted decimal syntax diagrams.............................................................................................................533Notices..............................................................................................................537
Terms and conditions for product documentation................................................................................. 538IBM Online Privacy Statement................................................................................................................ 539Policy for unsupported hardware............................................................................................................539Minimum supported hardware................................................................................................................540Programming interface information........................................................................................................540Trademarks.............................................................................................................................................. 540
Index................................................................................................................ 541
xiv
List of Figures
1. Defining a vital record specification chain.................................................................................................... 62. Example of a list of volumes owned by a single user.................................................................................153. Defining DFSMSrmm to z/OS through IEFSSNxx with subsystem inactive............................................... 264. Updating IKJTSOxx to authorize RMM commands.................................................................................... 275. Updating IKJTSOxx to call DFSMSrmm through TSO.................................................................................276. Converting the SYSTEMS enqueue to a local SYSTEM enqueue................................................................287. Changing an existing definition from SPECIFIC to GENERIC.....................................................................288. Converting the RESERVE to a SYSTEMS enqueue...................................................................................... 289. Changing an existing SPECIFIC definition to GENERIC............................................................................. 2910. Creating a procedure in SYS1.PROCLIB using the recommended JCL................................................... 4311. Creating a procedure in SYS1.PROCLIB using additional parameters.................................................... 4412. Allocating DASD space for the control data set....................................................................................... 5113. Initializing the control data set.................................................................................................................5214. Allocating space for the journal................................................................................................................ 5415. Adding DFSMSrmm to ISPF...................................................................................................................... 5716. Enabling ISPF data set list (DSLIST) support...........................................................................................5817. Starting DFSMSrmm..................................................................................................................................6018. Starting DFSMSrmm with additional parameters.................................................................................... 6119. Stopping DFSMSrmm................................................................................................................................ 6120. Disabling the DFSMSrmm subsystem interface....................................................................................... 6221. Quiescing the DFSMSrmm subsystem interface...................................................................................... 6222. Defining minimum volume information.................................................................................................... 6423. Defining volumes in a system-managed library....................................................................................... 6524. Defining volumes in a manual tape library............................................................................................... 6525. Changing SYS1.PARMLIB IEFSSNxx ........................................................................................................6726. Restarting the DFSMSrmm subsystem.....................................................................................................6727. Message EDG0103D................................................................................................................................. 6828. Default VLPOOL command....................................................................................................................... 8729. Defining pools with the DFSMSrmm EDGRMMxx parmlib VLPOOL command........................................9130. Sample management class routine.......................................................................................................... 9131. Storage group routine sample.................................................................................................................. 9232. Defining pools with VLPOOL commands.................................................................................................. 9233. Defining vital record specifications for non-system-managed volumes................................................. 9634. Sample management class routine for managing non-system-managed volumes................................9735. Assigning management class to data sets on tape..................................................................................9936. Special date 99000 vital record specification..........................................................................................9937. Managing management classes using a data set name mask.................................................................9938. Specifying a library name for a volume.................................................................................................. 10639. Requesting the eject of a volume........................................................................................................... 108
xv
40. Contents of the shipped table: TAPEUNITS........................................................................................... 11041. Changing volume type............................................................................................................................ 11542. Searching the required location for logical volumes............................................................................. 12043. Confirming volume moves for exported volumes.................................................................................. 12144. Building a list of stacked volumes to be imported from a single stacked volume................................ 12245. Building a list of logical volumes to be imported from a single stacked volume.................................. 12246. Building a list of logical volumes to be imported from multiple stacked volumes............................... 12247. Creating a volume export list..................................................................................................................12548. Confirming volume moves for exported volumes.................................................................................. 12549. Creating a volume import list................................................................................................................. 12650. Converting A logical volume to a physical volume.................................................................................12851. Reusing volume information for a recovered volume............................................................................ 12852. Sample JCL to return volumes to scratch.............................................................................................. 13753. Using media name to control volume movement.................................................................................. 14454. Keeping volumes on-site........................................................................................................................ 14455. Sending a volume to another system..................................................................................................... 14556. Returning a volume from another system..............................................................................................14557. Identifying an installation defined storage location.............................................................................. 14658. Parmlib member EDGRMMxx LOCDEF command example...................................................................15059. Parmlib member EDGRMMxx LOCDEF command for defining storage locations................................. 15060. Parmlib member EDGRMMxx LOCDEF command for defining shelf and system-managed libraries.. 15161. Using a medianame not defined in the LOCDEF command................................................................... 15262. Parmlib member EDGRMMxx MEDINF command example for OEM media products..........................15563. Parmlib member EDGRMMxx MEDINF command syntax......................................................................15564. Parmlib member EDGRMMxx MNTMSG command examples for 4-digit devices................................ 16065. Parmlib member EDGRMMxx MNTMSG command syntax.................................................................... 16166. Parmlib member EDGRMMxx OPENRULE command.............................................................................16367. Parmlib member EDGRMMxx OPTION command examples.................................................................16768. Parmlib member EDGRMMxx OPTION command syntax......................................................................16769. Parmlib member EDGRMMxx PRTITION command.............................................................................. 19770. Volumes not used and partitioned......................................................................................................... 20171. Volumes not used for outp