z/OS V1R6.0 DFSMS Access Method Services for Catalogs

DELETEv If data set contains indirect or symbolic VOLSER, the scratch parameter willbe ignored, if specified.SCRATCHspecifies that a data set is to be scratched from (removed from the VTOCof) the volume on which it resides. For VSAM data sets and SMS-managednon-VSAM data sets, the VSAM volume data set (VVDS) entry is alsoremoved.When SCRATCH is specified for a VVDS, the VVDS is scratched and thecatalog entry for the VVDS is removed. The VVDS must be empty.If the catalog entry does not exist for a non-VSAM data set, you can usethe SCRATCH function of the OS/VS IEHPROGM utility to remove theformat-1 DSCB from the VTOC.If you select SCRATCH, one of the following statements must be true:vvvThe entry is in the master catalog.One or more of the qualifiers in the entry’s qualified name is the sameas the catalog’s name or alias.The FILE parameter is specified.If you specify SCRATCH when deleting a non-VSAM data set defined withan esoteric device type, SYSDA for example, the DELETE will beunsuccessful under the following circumstances:vvInput/output configuration is changed resulting in addition or deletionof one or more esoteric device types.The esoteric device type definitions on the creating and using systemsdo not match when the catalog is shared between the two systems.Note: If the VVDS indicates that the data set is owned by a catalog otherthan that catalog identified through the usual catalog search order forDELETE, a DELETE NOSCRATCH is done against the catalog that resultedfrom the catalog search, and a zero return code is returned to the user. Forexample, if you specify a DELETE SCRATCH command against a data setin Catalog A, and the VVDS indicates that the data set is owned byCatalog B, a DELETE NOSCRATCH operation is done against Catalog A,and the data set remains intact and accessible from Catalog B. See “CatalogSearch Order for DELETE” on page 11 for information on the catalogsearch order for DELETE.Abbreviation: SCR226 z/OS V1R6.0 DFSMS Access Method Services for CatalogsNOSCRATCHspecifies that the catalog entry is to be deleted from the catalog withoutmounting the volume that contains the object defined by the entry. VVDSand VTOC entries are not deleted.If RACF is installed, you must have access authority under RACF tospecify NOSCRATCH. With proper authority, DELETE NOSCRATCH isallowed on SMS-managed VSAM and non-VSAM data sets, thus deletingthe BCS entry in the catalog without accessing the VVDS or VTOC.Attention DELETE NOSCRATCH can result in uncataloged SMS-manageddata sets.NOSCRATCH removes the catalog entry for a VVDS. This entry can bereinstated with DEFINE RECATALOG. If the volume is mounted andusable, the VVDS is checked to ensure that the catalog entry being