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

DEFINE ALTERNATEINDEX||||||||||||||||For SMS-managed data sets, the expiration date in the catalog is updatedand the expiration date in the format-1 DSCB is changed. Should theexpiration date in the catalog not agree with the expiration date in theVTOC, the VTOC entry overrides the catalog entry. In this case, enter aLISTVTOC command to see the correct expiration date.TO(date)Specifies the earliest date that a command without the PURGEparameter can delete the alternate index. Specify the expiration date inthe form yyyyddd, where yyyy is a four-digit year (to a maximum of2155) and ddd is the three-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 thePURGE parameter will always be required to delete the alternateindex. For related information, see the ″EXPDT Parameter″ section ofz/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 datewill make the alternate index immediately eligible for deletion.FOR(days)Is the number of days to keep the alternate index before it is deleted.The maximum number is 9999. If the number is 0 through 9998, thealternate index is retained for that number of days; if the number is9999, the alternate index is retained indefinitely.UNIQUEKEY|NONUNIQUEKEYShows whether more than one data record (in the base cluster) can containthe same key value for the alternate index.UNIQUEKEYPoints each alternate index key to only one data record. When thealternate index is built (see Chapter 8, “BLDINDEX,” on page 91) andmore than one data record contains the same key value for thealternate index, the BLDINDEX processing ends with an error message.Abbreviation: UNQKNONUNIQUEKEYpoints a key value for the alternate index to more than one data recordin the base cluster. The alternate index’s key record points to amaximum of 32768 records with non-unique keys.When you include NONUNIQUEKEY, the maximum record sizeshould be large enough to allow for alternate index records that pointto more than one data record.Abbreviations: NUNQKUPGRADE|NOUPGRADESpecifies whether or not the alternate index is to be upgraded (that is, keptup to date) when its base cluster is modified.UPGRADEUpgrades the cluster’s alternate index to reflect changed data when thebase cluster’s records are added to, updated, or erased.140 z/OS V1R6.0 DFSMS Access Method Services for Catalogs