Status Codes from SCRATCH

After the SCRATCH macro instruction is executed (for SCRATCH return codes 0, 4, and 8 only), the last byte of each 12-byte entry in the volume list indicates one of the following conditions:

Table 1. SCRATCH Status Codes
Status Code	Meaning
0 (X'00')	The data set has been deleted from this volume.
1 (X'01')	The VTOC of this volume does not contain the format-1 or format-8 DSCB to be deleted.
2 (X'02')	One of the following conditions occurred: The data set could not be scratched because the correct password was not specified in the two attempts allowed. The user tried to scratch a VSAM data space or an integrated catalog facility VSAM data set. The user tried to scratch the VTOC index data set. An SMS-validation failure occurred. The verify of the last referenced date failed.
3 (X'03')	The data set was not deleted because either the OVRD option was not specified or the retention cycle had not expired.
4 (X'04')	One of the following conditions occurred: An invalid format-1 or format-8 DSCB was encountered when processing this volume. An unexpected CVAF error return code was encountered. An installation exit rejected the request. An I/O error occurred while the DASD tracks occupied by the data set were being erased. Either the ERASE option was specified in the scratch parameter list or the ERASE attribute was specified for an RACF-defined data set.
5 (X'05')	It could not be verified that this volume was mounted, nor was there a unit available for mounting the volume.
6 (X'06')	The operator was unable to mount this volume.
7 (X'07')	The data set was not deleted because it was open.
8 (X'08')	The format-1 or format-8 DSCB indicates the data set is defined to RACF®, but either you are not authorized to the data set or volume, or the data set is a VSAM data space.

After the SCRATCH macro instruction is executed, the next to last byte of the first entry in the volume list indicates one of the following conditions:

Table 2. Secondary Status Codes
Status Code	Meaning
0 (X'00')	No secondary status for this volume.
128 (X'80')	The data set was RACF protected and the calling program was authorized by the RACF DATASET class to scratch the data set. This means that at least one volume entry was protected.