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

DEFINE GENERATIONDATAGROUPcatnameSpecifies the name of the catalog.EMPTY|NOEMPTYSpecifies what action is to be taken when the maximum number of GDSs forthe GDG is exceeded and another GDS is to be cataloged. The disposition ofthe data set’s DSCB in the volume’s VTOC is determined with theSCRATCH|NOSCRATCH parameter. For SMS-managed data sets, the dataset’s NVR is also determined with the SCRATCH|NOSCRATCH parameter. IfNOSCRATCH is specified for an SMS-managed GDS, the GDS is uncatalogedfrom its GDG base and can be re-cataloged outside its GDG base as an SMSnon-VSAM entry with the roll-off status.EMPTYSpecifies that all the generation data sets are to be uncataloged when themaximum is exceeded (each data set’s non-VSAM entry is automaticallydeleted from the catalog).Abbreviation: EMPNOEMPTYSpecifies that only the oldest generation data set is to be uncataloged whenthe maximum is reached.Abbreviation: NEMPOWNER(ownerid)Identifies the generation data set’s owner.For TSO users, if the owner is not identified with the OWNER parameter, theTSO userid is the default ownerid.SCRATCH|NOSCRATCHSpecify whether or not a generation data set’s DSCB is to be deleted from thevolume’s VTOC when the data set is uncataloged (that is, when its entry isdeleted from the catalog automatically, as described under EMPTY|NOEMPTY,or explicitly as a result of a user entered DELETE request). For SMS-managedGDSs, SCRATCH|NOSCRATCH specifies if the NVR is to be removed fromthe VVDS when the data set is uncataloged.You can override the SCRATCH|NOSCRATCH attribute when issuing theDELETE command.SCRATCHSpecifies that the generation data set’s DSCB is to be deleted from thevolume’s VTOC when the generation data set is uncataloged. Direct accessdevice space management (DADSM) removes the data set’s DSCB from theVTOC, erases the data set’s space on the volume, and makes the spaceavailable to other system users. The generation data set ceases to exist. ForSMS-managed GDSs, SCRATCH also specifies that the NVR is to beremoved from the VVDS when the data set is uncataloged.Abbreviation: SCRNOSCRATCHSpecifies that the generation data set’s DSCB is not to be removed from thevolume’s VTOC when the generation data set is uncataloged. The dataset’s DSCB in the volume’s VTOC is left intact and can be used to locatethe data set. Your program, however, can process the data set by using aJCL DD statement to describe and allocate the data set.Abbreviation: NSCR176 z/OS V1R6.0 DFSMS Access Method Services for Catalogs