TOPS-20 Commands Reference Manual
Asks that a permanent off-line copy of specified files be made on magnetic tape, and prevents the disk copy (if retained) from being modified.
@ARCHIVE (FILES) filespec,..., @@subcommand
|filespec||is the specification of a file of which you want a permanent copy.|
|@@subcommand||means that after a final comma you can type the following optional
Notice of Archive Sent to Requestor
Whenever a file is taken off line as a result of your ARCHIVE command (for example, when you do not also give the RETAIN subcommand), the operator sends a mail message notifying you that the file has been archived.
Archived Files Unalterable
You cannot change the contents of files specified in an ARCHIVE command once the command is given, even if the files are not immediately copied to tape. This means that you cannot alter or add to them by using the EDIT or APPEND command, or overwrite them by using the COPY or RENAME command. In general, files for which you have requested archival must not be given as the second filespec argument of these commands.
Archived Files Invisible
The files you specify in an ARCHIVE command ordinarily become invisible to most TOPS-20 commands as soon as the ARCHIVE command is given. However, if you include the RETAIN subcommand when giving the ARCHIVE command, the files remain visible. See Related Commands, below, for a list of commands you can use with invisible files.
|CANCEL ARCHIVE||for canceling archival requests|
|DELETE, with the ARCHIVE subcommand||for deleting archived files|
|DELETE, with the CONTENTS-ONLY subcommand||for deleting only the disk copy of files that also have a tape copy|
|DIRECTORY, with the ARCHIVE subcommand||for requesting information on archived files (visible and invisible) only|
|DIRECTORY, with the INVISIBLE subcommand||for requesting information on invisible files only|
|DISCARD||for giving up the tape copy of on-line files|
|INFORMATION ARCHIVE-STATUS||for determining if archival for the specified files (visible and invisible) has been accomplished|
|RETRIEVE||for restoring off-line files (visible and invisible) to on-line status|
|SET FILE INVISIBLE||for making visible files invisible|
|SET FILE VISIBLE||for making invisible files visible|
- Archive a file.
@ARCHIVE ARTEST.FIL ARTEST.FIL.1 [Requested]
- Archive a file, but keep a copy on disk. Check the archive status of
@ARCHIVE ARCHEK.FIL, @@RETAIN @@ ARCHEK.FIL.1 [Requested] @INFORMATION ARCHIVE-STATUS ARCHEK.FIL.1 Archive requested, Retain contents ARTEST.FIL.1 Archive requested
- Attempt to use the EDIT editor to edit an archived file (first you must
make it visible). Note that, afterwards, the unedited backup copy is the
archived file, and that the edited file has no archive status.
@INFORMATION ARCHIVE-STATUS ARTEST.FIL ARTEST.FIL.1 Archive requested @EDIT ARTEST.FIL %No such filename, Creating New file Input: ARTEST.FIL.2 00100 $ *EQ @SET FILE VISIBLE ARTEST.FIL.1 ARTEST.FIL.1 [OK] @EDIT ARTEST.FIL.1 Edit: ARTEST.FIL.1 *P 00100 !TEST FILE FOR ARCHIVING *I200 00200 !FIRST MODIFICATION 00300 $ *P^:* 00100 !TEST FILE FOR ARCHIVING 00200 !FIRST MODIFICATION *EU [ARTEST.FIL.2] @INFORMATION ARCHIVE-STATUS ARTEST.* ARTEST.QIL.1 Archive requested @TYPE ARTEST.QIL !TEST FILE FOR ARCHIVING @TYPE ARTEST.FIL !TEST FILE FOR ARCHIVING !FIRST MODIFICATION @DIRECTORY ARTEST.* MISC:<LATTA> ARTEST.FIL.2 .QIL.1