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

DEFINE USERCATALOG||||||||||||||||numberThe number of requests catalog administration must be prepared toaccommodate. The minimum number allowed is 2 and the maximumnumber is 255.TO(date)|FOR(days)Specifies the retention period for the catalog being defined. If no value iscoded, the catalog can be deleted whenever it is empty.The MANAGEMENTCLASS maximum retention period, if specified, limits theretention period specified by this parameter.For non-SMS-managed catalogs, the correct retention period is reflected in thecatalog entry. The VTOC entry cannot contain the correct retention period.Enter a LISTCAT command to see the correct expiration date.For SMS-managed catalogs, the expiration date in the catalog is updated andthe expiration date in the format-1 DSCB is changed. Should the expirationdate in the catalog not agree with the expiration date in the VTOC, the VTOCentry overrides the catalog entry. In this case, enter a LISTVTOC command tosee the correct expiration date.TO(date)Specifies the earliest date that a command without the PURGE parametercan delete the catalog. Specify the expiration date in the form yyyyddd,where yyyy is a four-digit year (to a maximum of 2155) and ddd is thethree-digit day of the year from 001 through 365 (for non-leap years) or 366(for leap years).The following four values are ″never-expire″ dates: 99365, 99366, 1999365,and 1999366. Specifying a ″never-expire″ date means that the PURGEparameter will always be required to delete the catalog. For relatedinformation, see the ″EXPDT Parameter″ section of z/OS MVS JCL Reference,SA22-7597.Notes:1. Any dates with two-digit years (other than 99365 or 99366) will betreated as pre-2000 dates. (See note 2.)2. Specifying the current date or a prior date as the expiration date willmake the catalog immediately eligible for deletion.FOR(days)Specifies the number of days to keep the catalog. The maximum numberthat can be specified is 9999. If the number specified is 0 through 9998, thecatalog is retained for the number of days specified; if the number is 9999,the catalog is retained indefinitely.WRITECHECK|NOWRITECHECKSpecify whether or not the catalog is to be checked by a direct access deviceoperation called write check when a record is written to the device.WRITECHECK Abbreviation: WCKSpecifies that a record is to be written and then read, without data transfer.NOWRITECHECK Abbreviation: NWCKSpecifies that the catalog is not to be checked by a write Checks to see if arecord has been written to the device.210 z/OS V1R6.0 DFSMS Access Method Services for Catalogs