Explanation: LISTOFNAMES(listdsname) is an optional parameter to specify that data sets listed in a separate file are to be recovered from the backup copy of an aggregate group. For the list file (listdsname), specify a single fully qualified data set name.
LISTOFNAMES can be abbreviated as LON.
If one or more of the data sets in the list specified on the LISTOFNAMES parameter are not found on the tapes for that aggregate version, ARECOVER will recover the data sets that are found, fail those data sets that are not found, and end with a non-zero return code.
The LISTOFNAMES data set must be a sequential data set, fixed-block, a logical record length (LRECL) of 80 and must also be cataloged. If the LISTOFNAMES data set is not cataloged or properly allocated, ARECOVER processing fails with a non-zero return code.
In the LISTOFNAMES data set, specify only one fully qualified data set name per record. Specifying multiple data set names per record, or using partially qualified data set names will cause ARECOVER processing to fail with a non-zero return code. Each record in the LISTOFNAMES data set should only contain 1 fully qualified data set name per 80 character record. There is no limit to the number of records that could be contained in the file. The LISTOFNAMES parameter should be used when you want to recover more than 1 data set from the aggregate group, but you do not wish to recover all data sets in the aggregate group.
To recover just one data set from the aggregate group, use the NAME subparameter of the ONLYDATASET parameter.
Defaults: None.