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

ALTERLOGSTREAMIDWhen you use this, the name of the forward recovery log stream isnullified. NULLIFY(LOGSTREAMID) is not allowed if the data set has avalue of LOG(ALL).Abbreviation: LSIDOWNERNullifies the owner identification.RETENTIONNullifies the retention period that was used in a TO or FOR parameter.Abbreviation: RETNOWNER(ownerid)Specifies the owner identification for the entry being altered.RECORDSIZE(average maximum)Specifies new average and maximum lengths for data records contained in theobject whose entry is being altered.If the object whose entry is being altered is a path pointing to the alternateindex, the alternate index is altered; if it is a path pointing directly to the basecluster, the base cluster is altered.If the object whose entry is being altered is an alternate index, the length of thealternate key must be within the limit specified by maximum.Restrictions: RECORDSIZE is used only if all the following are true:vvvvvvThe object whose entry is being altered is an alternate index, a cluster, apath, or a data component.The object whose entry is being altered contains no data records.The maximum RECORDSIZE in the object’s catalog entry is the default. Fordefaults, see the DEFINE command for the object.If NONUNIQUEKEY is used for an alternate index, the record length to bespecified accounts for the increased record size; this results from themultiple prime key pointers in the alternate index data record.Use a maximum record length of at least seven bytes less than the controlinterval size, unless the record is a spanned record.Use a record length large enough to contain all prime and alternate keyspreviously defined.If RECORDSIZE in the object’s catalog entry is not the default, and ALTERRECORDSIZE specifies that same value, processing continues for any otherparameters given in the command, and there is no error message.Abbreviation: RECSZREMOVEVOLUMES(volser[ volser])Specifies volumes to be removed from the list of candidate volumes associatedwith the entry being altered. The name of the data or index component mustbe specified in the ENTRYNAME parameter. If you are also adding volumes,the volumes to be removed are removed after the new volumes are added tothe candidate list. Only nonspecific volumes can be removed fromSMS-managed, non-VSAM data sets, and GDS data sets. For information onvolume cleanup, see “VSAM Volume Cleanup” in z/OS DFSMS: ManagingCatalogs.Chapter 5. ALTER 67