CANCELERROR


>>-+-------------+---------------------------------------------><
   '-CANcelerror-'

CANCELERROR specifies that the restore function be ended for a permanent read error, or that the restore of a data set be ended for a write error.

Permanent read error (permanent I/O error):
If CANCELERROR is specified, the restore task is ended. If this keyword is not specified, DFSMSdss attempts to recover from the input errors, but the results can be unpredictable as a result of the difficulty in repositioning and assembling the data.
Write error, such as an invalid track format:
For data set restore, processing of the data set ends and the target data set is deleted. The restore operation continues with the next data set. For full volume and tracks restore, processing for the volume ends. Subsequent tracks are not processed.

DFSMSdss allows you to change this default operation. A patch byte is provided to allow you to change the default handling of invalid tracks created during RESTORE processing.

CANCELERROR has no effect on the following types of errors on a DASD volume:

For more information about the patch bytes, see DFSMSdss patch area.