FDRARCH UPDATE Statement

UPDATE statement

The UPDATE statement executes all of the DELETE, RESET, EXPIRE, MODIFY, and RECATALOG statements that immediately preceded it, making one pass through the Archive Control File and comparing each record to the parameters on those statements, making any required changes to the records that match them.

An implied UPDATE with all defaults taken is executed whenever one of those statements was entered, and either an FDRARCH statement other than those five, or the end of the statement input (EOF on SYSIN) is encountered. Therefore, the UPDATE statement is not required unless you wish to specify one of the operands.

UPDATE statement syntax

CNTRESV=

Specifies the number of Archive Control File blocks (from 1 to 99) to be processed between times when the reserve on the volume containing the control file is released. This allows other processors to access the volume at intervals during the reorganization.

Default: 10.

The options specified are disabled or enabled for this UPDATE operation. Multiple options are enclosed in parentheses and separated by commas. The options and their meaning if enabled are:

Validates the data set name of the Archive Control File. It requires that some index level in the name, not the first, is ARCHIVE.

Dynamically allocates the common Archive Control File named in the ARCDSN option of the FDR Global Options if the ARCHIVE DD statement is not present.

Protects the Control File with a RESERVE macro against the volume on which it resides.

Default: DSNCK and RESERVE are enabled; DYNARC is disabled, unless overridden in the FDR Global Options.

Provides a default for the LOG or NOLOG operand on the individual MODIFY and RECATALOG statements that are executed by this UPDATE statement. If LOG or NOLOG is specified on those individual statements, it takes precedence over the operand here on the UPDATE statement. If LOG or NOLOG is not specified on the UPDATE statement nor on the individual statement the default documented for that statement is used.

Specifies if and how REORG is to verify that data sets flagged for auto recall are accurately cataloged for recall (not on DASD).

Uses Common VTOC Access Facility macros.

Bypasses this verification.

Uses the OBTAIN DADSM macro.

If CVAF or OBTAIN is specified or defaulted, for every Auto-Recall entry which is being removed from the control file, if the original DASD volume recorded in the control file is online and of the right type (for example, 3390), REORG accesses the VTOC to see if the data set is on that volume. If it is, it is re-cataloged to that volume instead of removing the catalog entry.

Default: CVAF.

If the UPDATE operation includes a RECATALOG statement with SERVICE=PERFORM specified or defaulted, this specifies how many blocks difference (from 1 to 500) there must be between Archive Control File pointer in the Auto-Recall entry in the catalog and the actual location of the entry in the Archive Control File before the catalog is updated with the new location. This is used to avoid expensive catalog updates resulting in minimal recall performance gains.

Default: 5 blocks.