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

DELETETo delete a user catalog when it is empty (that is, it contains only itsself-describing entries and its volume’s VVDS entry), you must specifyUSERCATALOG. To delete a user catalog that is not empty, you mustspecify both USERCATALOG and FORCE.If you are deleting the catalog as part of recovering from a backup copy,you may want to use the RECOVERY option instead. For moreinformation, see the RECOVERY keyword.Exception: JOBCAT and STEPCAT are ignored for this command. UseEXPORT DISCONNECT to delete a user catalog entry from a user catalog.A master catalog for another system is considered a user catalog by theprocessing system.Abbreviation: UCATVOLUMEENTRYspecifies that the entry to be deleted is a tape library volume.To delete a tape volume entry, you must have authorization to RACFFACILITY class profile STGADMIN.IGG.LIBRARY. Because access methodservices cannot change the library manager inventory in an automated tapelibrary, ISMF should be used for normal tape library delete functions. Theaccess method services DELETE VOLUMEENTRY command should beused only to recover from volume catalog errors.Abbreviation: VOLENTRYor VOLENTVVRspecifies that the objects to be deleted are one or more unrelated VSAMvolume record (VVR) entries. To delete a VVR from both the VSAMvolume data set (VVDS) and from the VTOC, you must specify thisparameter.The VVR entry is deleted only if the related cluster or alternate-index dataand index component catalog entries do not exist. When VVR is specified,the component name of the cluster or alternate-index to which the VVRwas once related must be specified in the entryname parameter. If youselect a catalog through alias orientation or by use of the catalogparameter, it must match the catalog name in the isolated VVR (unless youhave read authority to the RACF FACILITY classSTGADMIN.IGG.DLVVRNVR.NOCAT).The FILE parameter must specify the DD statement name that identifiesthe volume on which the VVDS resides.CATALOG(catname)specifies the name of the catalog that contains the entries to be deleted. See“Catalog Search Order for DELETE” on page 11 for the order in which catalogsare searched.This parameter cannot be used to delete a user catalog, and is ignored whenyou delete members of a partitioned data set.To specify catalog names for SMS-managed data sets, you must have authorityfrom the RACF STGADMIN.IGG.DIRCAT FACILITY class. See “StorageManagement Subsystem (SMS) Considerations” on page 2 for moreinformation.catnameidentifies the catalog that contains the entry to be deleted.Chapter 20. DELETE 221