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

ALLOCATEvvFREESPACE and SHAREOPTIONS parameters assigned to this data class by theACS routines. This parameter is optional. If it is not used, the data set assumesthe default data class assigned by the ACS routines.STORCLAS gives an installation-defined name of an SMS storage class to beassigned to this new data set. This storage class and the ACS routines are usedto determine the volume. This parameter is optional and, if not given, the dataset assumes the default storage class assigned by the ACS routines.MGMTCLAS is the installation-defined name of an SMS management class to beassigned to this new data set. The data set assumes the migration and backupcriteria assigned to this management class by the ACS routines. This parameteris optional and, if not given, the data set assumes the default management classassigned by the ACS routines.Allocate a VSAM Data Set Using SMS Class Specifications:Example 2This example uses the ALLOCATE command to allocate a new data set. Data classis not assigned, and attributes assigned through the default data class areoverridden by explicitly specified parameters. By providing the SMS managementclass and storage class, you can take advantage of attributes already assignedthrough the ACS routines.//ALLOC JOB ...//STEP1 EXEC PGM=IDCAMS,DYNAMNBR=1//SYSPRINT DD SYSOUT=A//SYSIN DD *ALLOC -DSNAME(M166575.ALLOC.EXAMPLE) -NEW CATALOG -SPACE(10,2) -AVBLOCK(80) -AVGREC(K) -LRECL(80) -RECORG(ES) -STORCLAS(FAST) -MGMTCLAS(VSAM)/*The parameters are:vvvvvDSNAME states that the name of the data set being allocated isM166575.ALLOC.EXAMPLE.NEW creates the data set.CATALOG retains the data set by the system in the catalog after steptermination. This is mandatory for SMS-managed data sets.The SPACE parameter determines the amount of space to be allocated to thenew data set.– The first amount (10) is the primary allocation. The second amount (2) is thesecondary allocation.– Using AVGREC(K) determines that the amounts defined in the SPACEparameter represent kilobytes (K) of records. In this example, the primaryallocation is 10K or 10240 records and the secondary allocation is 2K or 2048records.– To determine the space allocation in bytes, multiply the number of records by80, the record length in LRECL(80). The primary allocation is 819200 bytes.The secondary allocation is 163840 bytes.AVBLOCK is the average block length. This example uses an average blocklength of 80 bytes.Chapter 4. ALLOCATE 49