<archive volume statement>

── ARCHIVE VOLUME ─┬─ DELETE ──┬─┬──────────────┬─────────────────────►
                   ├─ OFFSITE ─┤ └─<volume name>┘
                   └─ ONSITE ──┘
►─ ( ─┬──────────────────────────────┬─ SERIALNO ── = ─────────────────►
      ├─────────────┬─┬─ TAPE ─┬─ , ─┘
      └─ KIND ── = ─┘ └─ CD ───┘
►─<serial number list>─┬────────────────────────────────────────────┬──►
                       └─ , ── FAMILYNAME ── = ──<disk family name>─┘
►─ ) ──────────────────────────────────────────────────────────────────┤

Explanation

Use the ARCHIVE VOLUME DELETE statement to remove archive backup references to CD-ROMs or tape volumes that have been purged, overwritten, or damaged. This action prevents archive restore tasks from requesting CD-ROMs and tape volumes that cannot be used.

Use the ARCHIVE VOLUME OFFSITE statement to mark archive backup references to selected CD-ROMs or tape volumes as not located at the site. The archive restore and merge tasks then avoid requesting offsite CD-ROMs and tape volumes, unless there are files with no other archive backups.

Use the ARCHIVE VOLUME ONSITE statement to mark archive backup references to selected CD-ROMs or tape volumes as onsite. You can also use this statement to reverse the actions of a previous ARCHIVE VOLUME OFFSITE statement, and you can use it to mark volumes as onsite that were originally created as offsite.

If you do not specify KIND, then the system assumes KIND = TAPE.

The serial number list is a list of the serial numbers of one or more CD-ROM or tape volumes that the system can act on. If you specify more than one serial number, then the system works on the archive backup information for all entries that match any of the serial numbers you specified.

If you specify the volume name, then the system only works on those archive records that have a matching volume name and a matching serial number. If you do not specify a volume name, then the system works on all archive records that have a matching serial number.

If you specify FAMILYNAME = <disk family name>, then the system works on the archive directory for that disk family only. If you do not specify FAMILYNAME, then the system works on the archive directories for all the online disk families.

Options

The following options are available in the ARCHIVE VOLUME statement.

DELETE

If you specify DELETE, the system removes all references to the specified CD-ROM or tape volumes from the specified archive directory or all archive directories.

OFFSITE

If you specify OFFSITE, the system marks all references to the specified CD-ROM or tape volumes from the specified archive directory or all archive directories as offsite. The WFL ARCHIVE RESTORE and ARCHIVE RESTOREADD statements do not try to copy a file from an offsite CD-ROM or tape volume unless it is the only CD-ROM or tape volume on which there is a copy of a specific file.

Specifying OFFSITE marks the tapes in the archive directory the same way that the following ARCHIVE backup statement does:

ARCHIVE FULL X/= FROM MYPACK TO MYTAPE (OFFSITE);

ONSITE

If you specify ONSITE, the system marks all references to the specified CD-ROM or tape volumes from the specified archive directory or all archive directories as not offsite.

Examples

The following examples illustrate the use of the ARCHIVE VOLUME statement syntax.

The following statement deletes all references to the tape with serial number 555555 from all active archive directories:

ARCHIVE VOLUME DELETE (SERIALNO = 555555);

The following example marks all references to tape volumes with the name DISK06122 and serial numbers 111111 or XXX in the archive directory for the family DISK as offsite:

ARCHIVE VOLUME OFFSITE DISK06122 (SERIALNO=(111111,"XXX"),
                                       FAMILYNAME=DISK);

The following example shows an archive backup statement creating a tape with offsite status and then an ARCHIVE VOLUME ONSITE statement giving that tape volume onsite status:

ARCHIVE FULL MYFILE FROM PACK                  
             TO MYTAPE (OFFSITE, SERIALNO="Q5");     
ARCHIVE VOLUME ONSITE MYTAPE (SERIALNO="Q5");