Coding JCL for the REPORT BACKUP_FILE command
To report information about the backup registration records in the repository by using the REPORT BACKUP_FILE statement, use the following syntax:
{ FILTER_BY(
{ LOCATION(location_name8,*, ...) }
{ STATUS(ACTIVE | INACTIVE) }
{ START_TIME(yyyyjjjhhmmsst | Xhhhhhhhhhhhhhhhh) }
{ STOP_TIME(yyyyjjjhhmmsst| Xhhhhhhhhhhhhhhhh) }
)
}
;
BACKUP_FILE keyword
Use the required BACKUP_FILE keyword on the REPORT BACKUP_FILE command to identify the backup registration records to be reported. The value can be the ddname of the backup file in the JCL, the data set name of the backup file, or the RUV-generated internal name of the backup record (if the backup was registered with the REGISTER RESTORE_JOB_JCL command or the REGISTER RESTORE_METHOD command). If you specify a data set name or the RUV-generated name, you can use masking (wildcard) characters. You can code multiple values for this keyword.
The REPORT BACKUP_FILE command does not read the backup data set. It uses the name you supply only to identify the backup registration record in the repository. However, if you specify the ddname, z/OS allocation of the data set occurs. It is recommended that you use the data set name instead of the ddname so that z/OS allocation does not occur.
RUV generates the following internal name for a backup record that you have created with the REGISTER RESTORE_JOB_JCL command (--JOB_JCL is followed by three blanks):
RUV generates the following internal name for a backup record that you have created with the REGISTER RESTORE_METHOD command (--WTOR is followed by six blanks):
If you specify the specific name (instead of a mask) in the REPORT command, you must enclose the complete name in single quote marks because the name contains embedded blanks. See the following examples:
REPORT BACKUP_FILE('--WTOR EXT002B_WTO');
Using the FILTER_BY keyword
Use the optional FILTER_BY keyword to filter the selection of backup registration records to be reported. You can filter the selection of backup registration records by location, status, start time, and stop time. For more information, see Using-the-FILTER_BY-keyword.
Example REPORT BACKUP_FILE command
The following example shows the use of the REPORT BACKUP_FILE command to obtain a report about backup files:
FILTER_BY(
START_TIME(20092460000000)
)
;
Related topic