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

ALTERIf FILE is not specified, an attempt is made to dynamically allocate the object’sdata set. Therefore, the object’s volume must be mounted as permanentlyresident or reserved.Restriction: While the FILE parameter can preallocate a volume where the dataset resides, it does not direct the ALTER request to the data set to be altered.Instead, a catalog search is done to locate the data set to be altered.FILEDATA(TEXT|BINARY)Use one of the following:TEXTSpecifies that the data in the data set is text. If the data set is read orwritten across the network, the data in this data set is EBCDIC on z/OSand ASCII on the workstation.BINARYSpecifies that data is to be processed as is.FREESPACE(CI-percent[ CA-percent]) Abbreviation: FSPCIndicates the percent of free space left after any allocation. CI-percent is apercentage of the amount of space to be preserved for adding new records andupdating existing records, with an increase in the length of the record. Becausea CI is split when it becomes full, the CA might also need to be split when it isfilled by CIs created by a CI split. The amounts, as percentages, must be equalto, or less than, 100. If you use 100% of free space, one record is placed in eachcontrol interval and one control interval is placed in each control area (CA).Use this parameter to alter the data component of a cluster, alternate index, orcatalog.If the FREESPACE is altered after the data set has been loaded, and sequentialinsert processing is used, the allocation of free space is not honored.FRLOG(NONE|REDO)Specifies whether VSAM batch logging can be performed for your VSAM dataset. VSAM batch logging is available with CICS VSAM Recovery V3R1.NONEDisables the VSAM batch logging function for your VSAM data set.Changes made by applications are not written to the MVS log streamindicated on the LOGSTREAMID parameter.REDOEnables the VSAM batch logging function for your VSAM data set.Changes made by applications are written to the MVS log stream indicatedin the LOGSTREAMID parameter. If you specify FRLOG(REDO), you mustalso specify LOGSTREAMID for that data set, unless the log stream isalready defined.Restrictions:1. Use the FRLOG parameter only if you want to enable (REDO) or disable(NONE) VSAM batch logging. Do not use the FRLOG parameter for datasets that are not intended for use with VSAM batch logging.2. If FRLOG is specified, these rules apply to the data set:vMust be SMS-managedv Cannot be LINEAR or a temporary data setINHIBIT|UNINHIBITSpecifies whether the entry being altered can be accessed for any operation oronly for read operations.Chapter 5. ALTER 61