Deleting a Disk Copy of Unneeded Reports

Once a report is no longer needed for online viewing (or printing), it can be erased from the Active User Report list and deleted from disk using the CTDDELRP utility in the Control-D JCL library.

The sample supplied deletes all reports that have been printed or backed up without waiting additional days. After completing the Walkthrough, you can change the value of parameter DAYS (for example, 1 saves all reports on the disk for 1 day after creation).

Additional parameters are optional and can be added any time. For more information on these parameters, see the INCONTROL for z/OS Utilities Guide.

1. Edit the CTDDELRP member and submit the job.

   Ensure that the job finishes executing successfully. Notice that at the end of the output there are messages that list actions performed by the utility.

   The following actions were performed:

   • All reports that met the criteria specified to CTDDELRP were deleted from the Active User Report list.
   • The CDAM datasets of the reports were deleted from disk.
   • The History User Report list was updated to indicate which reports were backed up.

   The process (backup mission) that you previously activated backed up the reports to tape (or cartridge), but it did not delete the reports from disk. In order to eliminate unnecessary restores of reports that still reside on disk, the record of the report remains in the Active Report list until the report is deleted from disk using CTDDELRP. When the report is deleted from disk, the record of the report is transferred to the History User Report list.

   Examine the Active User Report list to verify that the record of the report was deleted from the Active User Report list.

2. Type =U in the COMMAND field and press Enter. The User Reports entry panel is displayed.

   Figure 40 User Reports Entry Panel

   -------------------- CONTROL-D/V -  USER REPORTS ENTRY PANEL  ---------------(U)

   COMMAND ===>                                                                  

                                                                                 

                                                                                 

        OPTIONS ===>               1. PERMANENT  2. ACTIVE/MIGRATED 3. HISTORY         

                                                                                 

                                                                                 

         REPORT NAME   ===>                     

                                                  Report name, prefix or mask     

         USER          ===>                       Recipient name or prefix        

         DATE FROM     ===>        TO             Report date or relative day     

         JOBNAME       ===>                       Job name, prefix or mask        

                                                                                 

         SHOW MIGRATED ===> N                     Include migrated reports        

                                                                                 

         INDEX         ===>                       Index name, prefix or mask      

         VALUE         ===>                                                      

                                                                                 

                                                                                 

                                                                                 

         DISPLAY TYPE  ===> D                     BYPASS PANEL ===> N            

                                                                                 

                                                                                 

                                                                                 

   SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER       14.03.14

3. Type MGT in the USER field.

   In the Show Option window, ensure that Y appears in the CHILD field. Also ensure that the SELECT BY fields are blank. For information about the Show Option window, see the Online Facilities chapter of the Control-D and Control-V User Guide.

4. In the User Reports entry panel, press Enter.

   Notice that there are no reports in the list. All reports were backed up and then deleted from disk by the CTDDELRP utility. Records for these reports now appear in the History User Report list.

5. Press PF03/PF15.