DD statements for scratch list reports

The DD statements you can code for scratch list reports are:

NEWSCR

NEWSCR is the output file for the listing of all scratch volumes returned to scratch status since the last scratch list was produced. DFSMSrmm produces the NEWSCR file when there is a valid date and time in the SCRDATE file or the SCRDATE file contains no record.

SCRDATE

This file is used to produce the scratch list report. Each time a scratch list report is produced, DFSMSrmm updates the SCRDATE file with the highest scratch date and time for a volume. DFSMSrmm uses the date and time to determine which volumes to include in the new scratch list report. DFSMSrmm includes all scratch volumes with a newer assigned date and time in the new scratch listings. You can edit the SCRDATE file, which is a single record of LRECL 80 that contains a 10-character date and an eight-character time in external format. The date format must be the same format you specified for EDGRPTD. DFSMSrmm produces a new scratch list report only if there is a valid date or time for a volume. If there is no date or time, or the date is not valid, DFSMSrmm does not produce a new scratch list but produces a full scratch listing only in the SCRDATE DD. If the SCRDATE file is empty, the NEWSCR and SCRLIST reports are identical, and DFSMSrmm writes the highest scratch date and time to the SCRDATE file.

Here is an example of the 80 byte input record.

 01/12/201223:01:00

This example uses American date format. The date is 10 characters long and must start in column 1. The time is 8 characters and starts in column 11. The SCRDATE file can be a new data set or an existing data set. Do not specify the date and time in the JCL using DD * because EDGRPTD updates the file with the highest scratch date and time.

The SCRLIST DD can be in any format, even a partitioned data set (PDS) member. The SCRDATE DD can be preallocated with any disposition.

SCRLIST

Output file for the full scratch list report.