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

Delete a User Catalog: Example 8In this example, a user catalog is deleted. A user catalog can be deleted when it isempty—that is, when there are no objects cataloged in it other than the catalog’svolume. If the catalog is not empty, it cannot be deleted unless the FORCEparameter is specified.Attention:The FORCE parameter deletes all clusters in the catalog.//DELET6 JOB ...//STEP1 EXEC PGM=IDCAMS//SYSPRINT DD SYSOUT=A//SYSIN DD *DELETE -XXXUCAT1 -PURGE -USERCATALOG/*The DELETE command deletes both the catalog and the catalog’s user catalogconnector entry in the master catalog. The parameters are:vvvXXXUCAT1 is the name of the user catalog.PURGE indicates the user catalog’s retention period or date is to be ignored. IfPURGE is not specified and the catalog’s retention period has not yet expired,the catalog will not be deleted.USERCATALOG identifies XXXUCAT1 as a user catalog.Delete an Alias Entry in a Catalog: Example 9In this example, an alias entry, EXAMPLE.NONVSAM1, is removed from catalogUSERCAT4.//DELET7 JOB ...//STEP1 EXEC PGM=IDCAMS//SYSPRINT DD SYSOUT=A//SYSIN DD *DELETE -EXAMPLE.NONVSAM1 -ALIAS -CATALOG(USERCAT4)/*The DELETE command removes an alias entry from catalog USERCAT4. Itsparameters are:vvvEXAMPLE.NONVSAM1 is the entryname of the object to be deleted.EXAMPLE.NONVSAM1 identifies an alias entry.ALIAS specifies the type of entry to be deleted. VSAM verifies thatEXAMPLE.NONVSAM1 is an alias entry and then deletes it. IfEXAMPLE.NONVSAM1 identifies another entry by mistake, VSAM does notdelete the entry, but notes the discrepancy with a message to the programmer.CATALOG identifies the catalog containing the entry, USERCAT4.DELETEDelete Generically Named Entries in a Catalog: Example 10In this example, each catalog entry with the name GENERIC.*.BAKER is deleted,where * is any 1-to-8 character simple name. The name GENERIC.*.BAKER is ageneric name, and all catalog entries with the same generic name are deleted. Usethis example to delete multiple entries. Multiple entries are entries with threelevels of qualification where the first is GENERIC and the third is BAKER.Chapter 20. DELETE 231