If you specify any attribute not listed here for a tape or CD-ROM volume used as input to a RESTORE process, then either the WFL compiler issues a syntax error for that attribute or library maintenance ignores the value you specified for that attribute.

The following tape and CD-ROM attributes are available for the RESTORE statement.

AUTOUNLOAD

Determines whether or not a tape is unloaded when it is released by library maintenance during a reel switch or a file close operation. If the value is ON, the tape is rewound and unloaded. If the value is OFF, the tape is not unloaded.

If the value is DONTCARE, or if this value is not specified, the tape behavior is controlled by the setting of the AUTOUNLOAD option of the MODE (Unit Mode) system command. Refer to the System Operations Guide for further information.

If a reel is switched during a COPY AND COMPARE operation, intermediate reels are not unloaded, regardless of the AUTOUNLOAD value, until the COMPARE phase is finished.

CYCLE

Designates the specific generation of a tape volume family. This file attribute is used in conjunction with the VERSION attribute. The default value is 1.

FAMILYOWNER

Indicates the usercode of the owner of a tape volume. If you specify a usercode with the FAMILYOWNER attribute, then library maintenance searches for the named tape owned by that usercode.

If you do not specify the FAMILYOWNER attribute or if you specify the null string (" "), then library maintenance searches for the named tape owned by the usercode of the library maintenance process itself.

If you specify an asterisk (*) for the FAMILYOWNER attribute then library maintenance searches for the named tape owned by the * usercode. Library maintenance ignores the FAMILYOWNER attribute if the Security Accountability Facility software is not installed, or if the TAPECHECK option of the SECOPT system command is not set to AUTOMATIC.

LIBMAINTDIR

Determines if library maintenance should use the information in the tape directory disk file of source tapes to speed up the search for files.

LOCATECAPABLE

Set the LOCATECAPABLE attribute to ON to indicate that the file requires a tape drive capable of processing the READ POSITION and LOCATE BLOCK ID tape commands for fast tape access.

If the assigned tape drive is locate capable, then library maintenance automatically takes advantage of this feature to do high-speed spacing in the following situations:

If the original tape was created on a locate capable tape drive, and a LIBMAINTDIR directory was created for the tape, then library maintenance uses the LOCATE BLOCK ID information found in the LIBMAINTDIR directory to rapidly space up to each of the files to be copied.

SERIALNO

Identifies the specific tape or CD-ROM volumes to be used when copying files.

To copy a few specific files from a multi-reel library maintenance tape set, you can use this attribute to skip directly to the reel holding the file(s) you need. If you know which reel contains the file you want (or the first reel that contains one of the files you want), use the serial number of that tape volume for the value of the SERIALNO attribute.

The SERIALNO attribute does not have a default value. For more information, refer to Serial Number Assignment.

VERSION

Designates the successive iteration of the same generation of a tape volume. This file attribute is used in conjunction with the CYCLE attribute. The default value is 0.

Examples

The following example will restore SYSTEM/ALGOL and SYSTEM/COBOL85 to the disk family CODE if those files are not currently resident on the family CODE and if the files were previously copied from the family CODE to a tape name CODETAPE:

RESTOREADD SYSTEM/ALGOL ORIGIN CODE, SYSTEM/COBOL85 ORIGIN
CODE FROM CODETAPE (SERIALNO= (6622, "6622A") , AUTOUNLOAD=ON);

You can use the following form of the RESTORE statement to copy all files from a tape to their original families. To use the *= construct, the statement must be started from an ODT, or it must run under a privileged usercode.

RESTORE & COMPARE *= ORIGIN DISK, *= ORIGIN PACK FROM SAVETAPE;

In the preceding example, any files copied to SAVETAPE from the family DISK are copied back to DISK, and any files copied to SAVETAPE from the family PACK are copied back to PACK.

You can use the following WFL statements to copy certain files from CD-ROM to a new disk family:

FAMILY OLDFAM = NEWFAM ONLY;
RESTORE DATA/= ORIGIN OLDFAM, 
PROG/=ORIGIN OLDFAM FROM XPORT(CD);

These statements select files under the directories DATA/= and PROG/= that were originally copied from the family OLDFAM to the CD-ROM XPORT. The selected files are copied from the CD-ROM XPORT to the disk family NEWFAM.

The following example replaces all the resident SYMBOL files with the backup copies of those files:

RESTOREREPLACE SYMBOL/= ORIGIN SYSPACK FROM SYSTAPE;