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

BLDINDEXthat points to the alternate index. If the data set has previously been deletedand redefined in this same invocation of IDCAMS and the FILE parameter wasspecified on the delete, you must specify the OUTDATASET keyword insteadof OUTFILE to avoid picking up incorrect volume information from theoriginal DD statement. Alternately, you may issue the BLDINDEX in a differentstep than the step that did the delete and define. You can build more than onealternate index for the same base cluster by using more than one ddname ordata set name with the OUTFILE or OUTDATASET parameter.OUTFILE(ddname[ ddname...])indicates the DD statement that identifies the alternate index, or a paththat points to the alternate index. You must define the alternate index inthe same catalog as the base cluster, and it must be empty (that is, itshigh-used relative byte address equals zero) or defined with the REUSEattribute.The alternate index must be related to the base cluster identified withINDATASET or INFILE.Abbreviation: OFILEOUTDATASET(entryname[ entryname...])specifies the data set that identifies the alternate index or a path that pointsto the alternate index. When you define the alternate index in the samecatalog as the base cluster, it must be empty (that is, its high-used RBAequals zero) or must be defined with the REUSE attribute.The alternate index must be related to the base cluster identified withINDATASET or INFILE.When you use OUTDATASET, to dynamically allocate the alternate index’svolume, make sure the volume is mounted as permanently resident orreserved.Abbreviation: ODSOptional ParametersCATALOG(catname)names the catalog in which the work files are to be defined. The work files aredefined and used by the BLDINDEX routine. When all alternate indexes arebuilt and the BLDINDEX routine no longer needs the work files, they aredeleted. See “Catalog Selection Order for BLDINDEX” on page 10 for moreinformation.To use catalog names for SMS-managed data sets, you must have access to theRACF STGADMIN.IGG.DIRCAT FACILITY class. See “Storage ManagementSubsystem (SMS) Considerations” on page 2 for more information.Abbreviation: CATEXTERNALSORT|INTERNALSORTdecides whether the key-pointer pairs are to be sorted entirely within virtualstorage.EXTERNALSORTspecifies that two external-sort work files are defined and built asentry-sequenced clusters. You must provide two DD statements thatdescribe the external-sort work files to be defined by BLDINDEX. You canname the DD statements IDCUT1 and IDCUT2. When you choose other92 z/OS V1R6.0 DFSMS Access Method Services for Catalogs