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

DEFINE USERCATALOGWhen no FREESPACE value is coded, the default specifies that no free space isto be reserved when the data set is loaded.Abbreviation: FSPC[ICFCATALOG|VSAMCATALOG|VOLCATALOG]Specify the type of catalog to be defined.ICFCATALOGDefines a catalog.Abbreviation: ICFCATVOLCATALOGDefines a tape volume catalog (VOLCAT). A VOLCAT can contain onlytape library and tape volume entries. You can define either a generalVOLCAT or a specific VOLCAT.vvA general VOLCAT is the default tape volume catalog. A generalVOLCAT contains all tape library entries and any tape volume entriesthat do not point to a specific VOLCAT. Each system can have access toonly one general VOLCAT. You must define the general VOLCAT priorto bringing the tape libraries online.The general VOLCAT must be in the form:XXXXXXXX.VOLCAT.VGENERALwhere XXXXXXXX either defaults to SYS1 or to another high levelqualifier specified by the LOADxx member in SYS1.PARMLIB. For moreinformation on changing the high-level qualifier for VOLCATs, see thesection on bypassing SYSCATxx with LOADxx in z/OS DFSMS:Managing Catalogs.A specific VOLCAT is a tape volume catalog that contains a specificgroup of tape volume entries based on the tape volume serial numbers(tape volsers). A specific VOLCAT cannot contain tape library entries.The specific VOLCAT must be in the form:XXXXXXXX.VOLCAT.Vy– where XXXXXXXX either defaults to SYS1 or is another high-levelqualifier specified by the LOADxx member in SYS1.PARMLIB.– where y represents the first character of a tape volser. A specificVOLCAT contains all the tape volume entries with volsers whose firstcharacter is equal to y. See “Tape Volume Names” on page 9 for adiscussion of the naming restrictions for tape volume volsers.Abbreviation: VOLCATIMBED|NOIMBEDIMBED|NOIMBED is no longer supported; if it is specified, it will be ignoredand no message will be issued.LOCK|UNLOCKControls the setting of the catalog lock attribute, and therefore checks access toa catalog. LOCK and UNLOCK can be specified only when the entrynameidentifies a catalog. UNLOCK is the default. Before you lock a catalog, reviewthe information on locking catalogs in z/OS DFSMS: Managing Catalogs.LOCKSpecifies that the catalog identified by entryname is to be defined with thelock attribute on. Defining the catalog with the lock on restricts catalogaccess to authorized personnel. Specification of this parameter requiresread authority to the profile name, IGG.CATLOCK, with class typeFACILITY. Catalogs are usually defined with the lock attribute on onlyChapter 19. DEFINE USERCATALOG 207