FDRABRUT ARCHIVE and BACKUP Statements


ARCHIVE statement

The ARCHIVE statement requests that either specific data sets or groups of data sets be archived. It either marks the DSCB of the detests) to be archived (DISKUPDATE=YES) or stores the archive request in the Archive Backup remote queue data set (DISKUPDATE=NO).

BACKUP statement

The BACKUP statement requests that either specific data sets or groups of data sets be included in the next incremental backup. It either marks the DSCB of the data sets) to be backed up (DISKUPDATE=YES) or stores the backup request in the Volume Backup remote queue data set (DISKUPDATE=NO).

ARCHIVE and BACKUP statements syntax

ARCHIVE|BACKUP


DSN=dsn|DSG=dsg


,ADATE=[yyddd|yyyyddd]|ADAYS=nnnn


,NOTIFY=userid


,VOL=vol|VOLG=volg

ARCHIVE and BACKUP statement operands

DSN=

dsn

Specifies the fully-qualified data set name, up to 44 characters, for a data set to be marked for later archiving or backup. If neither VOL= nor VOLG= are specified, a catalog LOCATE is done to get the volume serials associated with this name.

DSG=

dsg

Specifies the prefix of a group of data sets to be marked for later archiving or backup, up to 44 characters. The VTOC of every volume specified by the VOL= or VOLG= operands is scanned for data sets beginning with this string. If DISKUPDATE=NO is in effect and FDR security is enabled, use of DSG= is disabled (see Security” in Section 51.40).

There is a special form of the DSG= operand. Leading periods after DSG= indicate that the group name starts after one or more index levels. Each period indicates that one index level is to be bypassed.

Important

Either DSN= or DSG= is required, but not both.

ADATE=

yyyyddd

yyddd

Only used with ARCHIVE, specifies a Julian date that may be in the form “yyyyddd” (for example, 2020123) or “yyddd” (for example, 20123). 2-digit year numbers less than 70 are assumed to be 20xx. Data sets are not archived unless the last reference date stored by IBM in the Format 1 DSCB is less than this value.

ADAYS=

nnnn

Only used with ARCHIVE, specifies a number of days. Data sets are not archived unless the last reference date stored by IBM in the Format 1 DSCB is less than today's date minus this value.

Important

Either ADATE= or ADAYS= can be used, not both.

NOTIFY=

userid

Specifies a TSO user ID to be notified when the data set has been archived or backed up. This is ignored if DISKUPDATE=YES is in effect; it works only when the remote queue data set is used.

VOL=

vol

Specifies the volume serial of the DASD volume on which to search for the data set or data set group.

VOLG=

volg

Specifies a volume serial prefix. All online volumes whose serial starts with the prefix are searched for the data set or data set group.

Important

Either VOL= or VOLG= must be present, except that if DSN= names a cataloged data set, only the volume from the catalog is searched.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*