FILES Maintenance › Archive Index Rebuild Utility › REBUILD Command and Parameters

REBUILD Command and Parameters

A REBUILD command is not needed unless you want to specify an expiration date to the ARCHVOLS index entry that is different from the default computation. See the EXPDT parameter below. All other needed information is obtained from the DD statement for the input archive tape, or the input archive data set on disk. Symbolic parameters are provided in the JCL procedure to allow you to identify the input data set. If the archive data set spans multiple volumes, the volume serial numbers must be properly specified in the JCL as shown on the previous section.

The REBUILD command syntax is:

REBUILD

OR

REBUILD DSNAMES=(HLQ1.yyy.nnn,HLQ2.zzz.nnn,HLQ3.aaa.nnn)

OR

REBUILD FILENOS=(01.02,05)

OR

REBUILD EXPDT=,FAST,ARCONLY,DSNPRINT=,ARCKEY=

OR

REBUILD UNIT=,FAST,ARCONLY,DSNPRINT=,ARCKEY=

ARCKEY=

This parameter specifies the original ARCHVOL key for the Archive volume when rebuilding using ARCONLY. Any existing DSNINDEX records that match the data sets on the volume being rebuilt will be reset to the new key assigned by specifying this parameter.

ARCONLY

This optional parameter requests the REBUILD utility to only rebuild the ARCHVOL entry. This parameter can be used to rebuild the ARCHVOL entry when it has been deleted to correct the problems associated with the volume(s).

DSNAMES=

Indicates that a Selective Rebuild is desired. Up to 50 dsname patterns can be specified that will be used to select files to be rebuilt from the archive data set. All files with a dsname that matches any of the patterns will be considered for rebuilding.

DSNPRINT=

This parameter can be specified as YES or NO to request that the data set entries on the Archive Data set be printed. The default value is YES for a normal rebuild and NO for an ARCONLY rebuild.

EXPDT=

The default expiration date for the Archive data set will be the highest date found on all of the individual archived data sets or the expiration date of the Archive data set, whichever is higher. This ensures that the Archive data set is not dropped due to either a DELETE command or a MERGE PROCESS until every data set has indeed expired. This default calculation can, however, be overridden by supplying a date in an accepted CA Disk format on this parameter. This can be desirable in cases where archive retention periods are set by an installation, and not by the data set expiration date or unit.

Note: The create TIME for the ARCHVOLS record will be x'0000' after REBUILD. The exact time is not available.

FAST

Specify FAST to indicate the ARCHVOLS record being built is to be flagged as containing Fast Archive data sets.

FILENOS=

Indicates that a Selective Rebuild is desired. Up to 50 File Numbers can be specified that will be used to select files to be considered for rebuilding from the archive data set.

PRIMARY2=

Indicates that the ARCHVOLs and DSNINDEX record should be rebuilt as PRIMARY2 records. The corresponding flags will be set and appropriate expiration dates used.

UNIT=

The UCB device type determines the default unit type. You can override the default for DYN unit types by specifying the same esoteric name as used in the JCL. This ensures that ARCFLAG2 and ARCFLAG4 are set correctly in the ARCHVOL record.