FDRARCH MODIFY Statement

MODIFY statement syntax

These operands control selection of records to be modified. Specify one or more of them.

These operands specify the modifications to be made to the selected records. Specify one or more of them.

MODIFY statement

The MODIFY statement is used to make changes to selected data set records within the Archive Control File. Entries to be modified may be selected using any combination of the operands in the first column above. The statement may appear more than once in the control statement input if you need to modify records based on several sets of criteria. In those selected entries, the expiration date and/or the archive backup volume serials, file number, device type and certain flags may be modified.

The MODIFY statement is commonly used to extend the expiration of archived data sets, by changing the expiration date recorded in the Archive Control File.

MODIFY may also be used to change the volume serials, file number, and device type of an archive backup. This may be used after an FDRTSEL or FDRTCOPY run (see FDR-and-ABR-Backup-Maintenance) if it failed to update the Archive Control File, to avoid having to recopy the tape.

The MODIFY parameters are saved for later processing. Please review FDRARCH Statements and Functions Archive-Maintenance-Utility-FDRARCH to understand when the Archive Control File is scanned and the modifications made in the selected records.

Many of the operands of MODIFY will accept comparison operators in addition to a simple equal (=). The operators are:

In most cases, you may also specify an operand more than once to select a range of values, such as ADAYS>5,ADAYS<20.

A record must meet all of the selection criteria specified to be selected for modification.

MODIFY statement operands

Specifies the date of the ARCHIVE run of the records to be selected. Only data sets archived on this date are marked. See the note on operators above to specify comparisons and ranges.

The date is specified as a Julian date (year plus day number) that may be in the form “yyyyddd” (for example, 2020123) or “yyddd” (for example, 20123). If the 2-digit year is used “yyddd”, year numbers less than 70 are considered to be in the 21st century, for example, 20345=2020.345. For readability, a period may be inserted between the year and day (for example, 2020.123).

For data sets that were archived with RECALL=NO (no Auto-Recall), including FDRAPPL Application Backups, the control file contains a time of day as well as a date. In this case, you can select by date and time, for example, ADATE=20123/140522 or ADATE=2020123/140522.

nnnnn

Specifies that data sets that were archived “nnnnn” days ago (from 1 to 32000) are to be selected. See the note on operators above to specify comparisons and ranges.

Specifies the data sets selected must have the first archive flag byte set to the indicators supplied. The valid indicators are:

Component marked for delete because there is no corresponding cluster.

Component marked for delete because the cluster is to be deleted.

External restore from archive.

Archive backup spans more than five volumes.

Internal restore from archive.

Portion of multi-volume data set was archived from one volume.

Entry restored from archive or restore from archive was attempted.

Data set is restored with an SUL (Standard User Label) extent.

From one to eight indicators may be specified for a single command if entered in parenthesis.

Default: The first archive flag byte does not participate in the data set selection.

Specifies the data sets selected must have the second archive flag byte set to the indicators supplied. The valid indicators are:

Backup is an ABR tape, not an archive tape.

Cluster entry.

External delete from archive.

Backup data set created on DASD device (as opposed to tape device).

Backup data set is not cataloged.

Data set archive with the auto recall option.

From one to six indicators may be specified for a single command if entered in parenthesis.

Default: The second archive flag byte does not participate in data set selection.

Prints messages showing every field that was updated in each selected data set. DETAIL implies the LOG operand.

Suppresses the detail messages.

Default: NODETAIL.

DSGROUP=

Specifies one or more data set name prefixes (up to 44 characters in length) to be selected. Multiple prefixes may be specified in parentheses, separated by commas. Only Archive Control File entries whose name begins with one of the prefixes are marked. See the note on operators above to specify comparisons and ranges. The XDSN= operand, described below, offers a much more flexible way of selecting data sets

DSNAME=

Specifies one or more data set names (up to 44 characters in length) to be selected. Multiple names may be specified in parentheses, separated by commas. See the note on operators above to specify comparisons and ranges.

EXPDATE=

Specifies the expiration date of the ARCHIVE records to be selected. If both a COPY1 and COPY2 backup exist for the data set, the higher of the two expirations is tested. See the note on operators above to specify comparisons and ranges.

The date is specified as a Julian date (year plus day number) that may be in the form “yyyyddd” (for example, 2020123) or “yyddd” (for example, 20123). If the 2-digit year is used “yyddd”, year numbers less than 70 are considered to be in the 21st century, for example, 20345=2020.345. For readability, a period may be inserted between the year and day (for example, 2020.123).

EXPDAYS=

nnnnn

Specifies that records whose expiration date is within “nnnnn” days of today's date are to be selected. The value can be from 1 to 32000 and can be positive (for example, EXPDAYS=5 or EXPDAYS=+5 means 5 days from today) or negative (for example, EXPDAYS=-5 means 5 days ago). It never considers data sets whose expiration date is 99.000, 99.365, or 99.366 to be expired. See the note on operators above to specify comparisons and ranges.

NOLOG

Specifies that messages listing the data sets that were updated are to be printed. If the DETAIL operand is also specified, the individual fields updated in each record are also listed.

NOLOG

Suppresses data set and detail messages.

Default: NOLOG unless overridden on a UPDATE statement (see FDRARCH-UPDATE-Statement).

NEWDEVICETYPE=

Specifies that the selected entries are to be modified to indicate a new device type for the archive backup file. NEWDEV= is ignored unless NEWTAPEVOL= is also specified. Valid values include:

3390

for DASD

3480

for tape

3480X

with IDRC

3490

for 3490E

3590-1

Magstar

NEWEXDATE=

NEWEXPIRE=

Specifies that the selected entries are to be modified with a new expiration date for the archive backup files. The new date can be an explicitly specified Julian date (NEWEXDATE=yyddd or yyyyddd) or it can be calculated (NEWEXPIRE= and either DAYS-= or DAYS+=). NEWEXPIRE= specifies the base date for the calculation and can have values:

The date that the selected data set was originally archived.

The current expiration date of the data set

The current date.

DAYS-= or DAYS+= should be specified with NEWEXPIRE= and specify the number of days to be subtracted from or added to the base date to arrive at the new expiration. If NEWEXPIRE= is specified without DAYS+= or DAYS-=, the default is DAYS+=30 (add 30 days to base date). If an expiration date of 1999.365 or 1999.366 is calculated, it will automatically be bumped to 2000.001.

NEWTAPEFILE=

NEWTAPEVOL=

Specifies that the selected entries are to have the volume serials (and optionally the tape file number, up to 65534) of the archive backup file modified. NEWTAPEVOL= is ignored if TAPEVOL= is not specified. If the number of volume serials specified (up to 5) is not the same as the number of serials specified by TAPEVOL=, or if NEWTAPEFILE= is specified, then TAPEFILE= must be specified to clearly define which records are to be updated.

SIMULATE

Makes the desired modifications in the selected records.

SIMULATE

Causes the statement to operate in simulation mode, so that you can verify that the parameters you have specified will have the correct results. It reports on what records it would modify if it was not in simulation mode, but does not update the control file.

Default: SIMULATE.

Specifies one or more special indicators to be turned off (RESET) or turned on (SET) in the selected Archive Control File entries. The indicators and their meaning if set are:

The data set is eligible for Auto-Recall.

The data set is flagged for deletion (can also be done by the DELETE and RESET statements).

The data has been restored by ABR.

Default: The indicators are not changed.

TAPECOPY=

Specifies which archive backup copy is to be modified in records selected. Values are:

Only COPY1 information is updated.

Only COPY2 information is updated.

Both copies (if both exist) are updated.

For expiration date changes (NEWEXDATE= and NEWEXPIRE=), the default is BOTH. Even if the record was selected because EXPDATE= or EXPDAYS= matched only one copy, BOTH copies are changed unless TAPECOPY= is specified.

Default: For Archive Backup changes (NEWDEV=, NEWTAPEVOL=, and NEWTAPEFILE=), the default is that the change is made in whichever copy matches on TAPEVOL= and, if specified, TAPEFILE=. If TAPECOPY= is specified for Archive Backup changes, then the specified copy is changed if and only if TAPEVOL=/TAPEFILE= matches on that copy.

TAPEFILE=

nnnn

Specifies a file sequence number (1 to 65534) of the archive tape data set that contains the entry that is to be selected. Ignored unless TAPEVOL= is also specified.

TAPEVOL=

Specifies a volume serial number of the archive tape data set that contains the entry that is to be selected. The volume serial number is matched against both the COPY1 and COPY2 volume serial number lists.

Multiple serials (up to 5) can be specified by enclosing the list in parentheses and separate them by commas. However, the complete list of serials is compared to every record in the Archive Control File. If a given archive run used multiple output tapes, you may have some data sets in a backup file entirely contained on one tape, some entirely on the second tape, and some that are in a file that crossed between the two tapes. You may need multiple MODIFY statements with, for example:

TAPEVOL=000001

TAPEVOL=(000001,000002)

TAPEVOL=000002

to select all the entries on those tapes.

VOLUME=

Specifies the volume serial number of the DASD from which the data sets to be selected were archived. Only those records having a matching originating volume serial number is selected. Multiple serials may be specified by enclosing them in parentheses separated by commas. Volume serial prefixes can be specified by following the prefix with an asterisk, for example, VOL=TSO*. See the note on operators above to specify comparisons and ranges.

XDSNAME=

Specifies one or more data set name masks, as defined in Generic-Data-Set-Name-Selection. The mask allows for flexible specification for the data set names to be selected. Multiple masks may be specified in parentheses, separated by commas. Only Archive Control File entries whose name matches one of the masks are selected. See the note on operators above; XDSN= accepts only equal (=) or not equal (Ø=) comparisons. For example: