Library maintenance refers to the name of the internal system program that performs the copy process, called *LIBRARY/MAINTENANCE. When you use the COPY statement to copy a file to tape or CD, the tape or CD-ROM volume to which a file is copied is marked as a library maintenance tape or CD-ROM.
To copy files to or from ordinary tapes, use the DUMPALL utility. Normal programs cannot read files directly from tapes that are written using the library maintenance program or from CD-ROMs in library maintenance format, nor can they create tape or CD-ROM volumes in library maintenance format.
To list the names of the files on a library maintenance tape or CD-ROM, use the system FILEDATA utility program or the TDIR system command. See the System Software Utilities Operations Reference Manual and the System Commands Reference for descriptions of the DUMPALL and FILEDATA utilities and the TDIR command.
For tapes with a LIBMAINTDIR file to which you have appended files by using the LIBMAINTAPPEND=TOEND option, use the following FILEDATA syntax to get a printed list of the files on the tape:
RUN *SYSTEM/FILEDATA (“FILENAMES: LIBMAINTDIR=<file title>");
The library maintenance program checks for errors and discrepancies while copying, comparing, or verifying files. Whenever library maintenance detects an error, it issues an error message. Errors can cause library maintenance to do one of the following:
-
Stop all copying and terminate.
-
Stop copying from a particular source or to a particular destination.
-
Stop copying a particular file.
-
Issue an RSVP message asking if the file should be recopied.
Certain I/O errors or data discrepancies can generate a message that requires an answer from the operator before continuing, such as whether a given file should be recopied, copied with errors as a BADFILE, skipped, or whether a tape with a bad copy of a file should be purged or the file skipped.
The recopy facility is not available when copying to or from quarter-inch cartridge tapes.
To check the progress of a COPY or ADD statement, use the HI (Cause Exception Event) system command. A command of the form <mix number> HI displays the number of files already copied and other information.
-
In most cases, library maintenance takes special action whenever you attempt to copy KEYEDIOII files from disk. Library maintenance waits until the files are no longer being updated and then blocks usage of the files and any related files, such as audit and key files, until all the specified files are copied. However, if you use the AX (Accept) system command on the KEYEDIOII/LIBRARY to set COPYINQONLY to FALSE, library maintenance immediately copies the KEYEDIOII files. (See the System Commands Reference for details on the AX command and the KEYEDIOII Programming Reference Manual for details on the COPYINQONLY runtime parameter.)
-
Library maintenance takes special action to ensure that the copies of the various files making up a KEYEDIOII set are consistent with each other. In general, when you copy a KEYEDIOII file, it is advisable to copy all the related files in the same <copy request>. If the file is part of a <copy from group> then all the related files should be in the same <copy from group>.
To copy a SYSTEMDIRECTORY file, you must specify its file name in full. For example, the statement COPY *SYSTEMDIRECTORY/= AS SYSDIR/= FROM . . . does not copy a system directory file but the following statement does:
COPY *SYSTEMDIRECTORY/001 AS SYSDIR/1 FROM
When library maintenance makes a copy of a SYSTEMDIRECTORY file, it erases the special system file mark from the copy. System directory files with the system file mark cannot be removed with the WFL REMOVE statement or be renamed with the WFL CHANGE statement.
To copy a JOBDESC file, which is a file with a FILEKIND attribute value of JOBDESCFILE, you must specify the file name in full. For example, the statement COPY *= FROM . . . does not copy a job description file but the following statement does:
COPY *JOBDESC FROM ...
When library maintenance makes a copy of a JOBDESC file, it changes the FILEKIND attribute value of the copy to DATA.
