The following options are available in the RESTORE statement.
The COMPARE option compares the copied files and the resident files bit by bit immediately after the files are copied. You can use the COMPARE option to ensure that the new copies of the files are readable, and that the data in the new files matches the data in the source files.
The DSONERROR option causes the system to discontinue the library maintenance program if an error is detected. This option will cause library maintenance to terminate with a DS response whenever:
-
A file or directory to be copied is missing and library maintenance issues a “filename FILE NOT ON <source volume>” message.
-
An error prevents a file from being copied to its destination.
-
Library maintenance issues a “RECOPY REQUIRED” RSVP and the operator replies with DS, FR, or OF.
The REPORT option causes library maintenance to print a report of the files it copied and any errors encountered. When & REPORT is specified library maintenance does not write “file copied” or “file not copied” messages in the job log or the system sumlog.
Causes library maintenance to call the LIBMAINTSELECTOR procedure in the ARCHIVESUPPORT library for each file to be copied. You or your site can code a special version of the LIBMAINTSELECTOR procedure that indicates if the file should be copied or not.
For information on how to code a custom LIBMAINTSELECTOR procedure, refer to the SYMBOL/ARCHIVESUPPORT DCALGOLSYMBOL file and the MCP System Interfaces Programming Reference Manual.
The VERIFY option is similar to the COMPARE option. However, instead of comparing the copied files bit by bit, the files are read again, and the overall checksum is compared.
Both the COMPARE and the VERIFY options ensure that the new copy of the files is written correctly.
Designates the assigned hardware unit number of the tape volume to be used.
The WAITONERROR option causes library maintenance to issue an RSVP message whenever an error occurs. Examples of possible errors include:
-
Requesting a file or directory that is missing.
-
Attempting to open a failed tape. The RSVP message halts library maintenance until the operator or programmer responds with OK or DS. A response of OK causes library maintenance to continue restoring other files or tapes. A response of DS will terminate the library maintenance program. After investigating the error which created the RSVP message, you can restart library maintenance.
