Define a User Catalog, Using SMS Keywords and the VOLUME Parameter: Example 4

In this example, an SMS-managed user catalog is defined and a specific volume is referenced.
//DEFUCAT  JOB  ...
//STEP1    EXEC PGM=IDCAMS
//VOL1     DD   VOL=SER=VSER01,UNIT=DISK,DISP=OLD
//SYSPRINT DD  SYSOUT=A
//SYSIN    DD  *
     DEFINE USERCATALOG -
           (NAME(USERCAT1) -
           VOLUME(VSER01) -
           ICFCATALOG -
           STRNO(3) -
           DATACLAS(VSDEF) -
           STORCLAS(SPECIAL) -
           MGMTCLAS(VSAM))
/*
Job control language statement:
  • VOL1 DD describes the volume on which the catalog is to be defined.
The DEFINE USERCATALOG command defines an SMS-managed user catalog, USERCAT1. Its parameters are:
  • NAME specifies the user catalog, USERCAT1.
  • VOLUME specifies that the user catalog is to reside on volume VSER01. In this example, the installation defined SMS storage class of SPECIAL has the GUARANTEED SPACE=YES attribute. This allows specific volume allocation on this DEFINE using the VOLUME keyword.
  • ICFCATALOG specifies that the user catalog is to be in the catalog format.
  • STRNO specifies that up to 3 concurrent requests to this catalog are to be processed.
  • DATACLAS specifies an installation defined name of an SMS data class. The data set will assume the space parameters, and the FREESPACE, SHAREOPTIONS, and RECORDSIZE parameters assigned to this data class by the ACS routines. This parameter is optional. If it is not specified, the data set will assume the data class default assigned by the ACS routines.
  • STORCLAS specifies an installation defined name of an SMS storage class. In this example, STORCLAS is not optional and you should not allow the catalog to assume the storage class default assigned by the ACS routines. The storage class named SPECIAL has the GUARANTEED SPACE=YES attribute and must be explicitly specified to enable specific volume allocation.
  • MGMTCLAS specifies an installation defined name of an SMS management class. This parameter is optional. If it is not specified, the data set will assume the management class default assigned by the ACS routines.