tcl.file-save
System backup process.
Syntax
file-save {(options}
Description
invokes the procedure to perform a full backup of each file in the Pick file system. This verb is usually invoked from 'dm' account.
The operator is prompted for a series of decisions, including:
Is this an Incremental Save (y or <n>)?
Console listing to printer (y or <n>)?
Send statistics report to printer (y or <n>)?
Verify save with 't-verify (e)' (y or <n>)?
Bypass groups with GFE's (y or <n>)?
Do you want to sleep (y or <n>)?
The 'file-save' is typically followed by a 't-dump' of the 'file-of-files' and generation of the file statistics report.
Is this an Incremental Save (y or <n>)?
An 'incremental save' only saves files which have changed since the last full save was done. Incremental saves perform much faster than a 'full' save, since there is less to save. The default answer is 'no'. See the 'save' command for more information on incremental saves.
Console listing to printer (y or <n>)?
As the save progresses, it shows the current account name and file name. The system then shows the files being saved in the following form:
Tape# file# mds > account > dictionary > data
The display may be directed to the printer by responding with 'y', or use the default of 'n' to have it display to the console.
Send Statistics Report to printer (y or <n>)?
As the file-save progresses, it builds a statistics report about the files it saves.
Verify save with 't-verify (e)' (y or <n>)?
After the file-save is complete, the media may be checked for reliability by re-reading it using the 't-verify' command. It is strongly recommended that file-save tapes be verified. If 't-verify' is selected, errors are logged to the 'tv.log' file. As of AP release 5.2.5, a new feature is available at this prompt. It allows 'y', 'yes', or 'n', as before, but now also allows additional 't-verify' options to be supplied in the following format:
Verify save with 't-verify' (y or <n>)?y (eilp
The options must be delimited from the 'y' or 'yes' with a space, a comma, or a left parenthesis. Note that when supplying additional options, the 'e' must be specified again if it is desired. Note that by default, the tape is NOT verified against the data on the disk.
Bypass groups with GFE's
Instead of stopping and prompting the user when a GFE is encountered, this option allows the file-save procedure to continue. This is especially useful when no operator is around monitoring the file-save.
Do you want to sleep (y or <n>)?
The file-save does not need to be started immediately. An entry of 'y' will cause the process to ask for the time to begin (in 24-hour military time):
Enter sleep time (default = 23:00):
Options
Any options available to the 'save' command may be appended to the 'file-save' command at the TCL prompt.
Example
:to dm
:set-sct
Tape attached block size: 16384
[1082] Tape device is attached to quarter inch Streaming Cartridge Tape
:file-save
Is this an Incremental Save (y or <n>)? n
Console listing to printer (y or <n>)? n
Send statistics report to printer (y or <n>)? n
Verify save with 't-verify (e)' (y or <n>)? n
Do you want to sleep (y or <n>)? n
File Save Beginning at 08:00:00 16 Jan 1997
Block size: 16384
Block size: 16384
[96] bot
Block size: 16384
1 2 mds
1 3 mds > qa
1 4 mds > qa > lst
1 5 mds > qa > bp.qa
1 6 mds > qa > bp.qa > admin
1 7 mds > qa > bp.qa > bp.qa
1 8 mds > qa > model
In the standard form of this command, the account/dict/file names are displayed
as they are saved:
Tape# file# mds > account > dictionary > data
In all multi-reel operations, if the save detects end of media before
completing the save, it prompts with the message:
Load volume #2 and type 'C'
label 08:00:00 16 Jan 1997 DATA 'account.name' # -
When the next 'reel' is inserted or mounted, 'c' continues
the process, or 'q' will stop it and return control to TCL.
At the end of the save process, the following message is displayed:
clearing dirty bits ...
2082
file-of-files being dumped to tape
[802] nnn items dumped
After the (full) file-save completes, the process scans through the files and
resets the 'dirty bits', which indicate if the file was to be saved
during an incremental-save or not. When finished clearing the dirty bits, the
file-of-files file is t-dumped to tape, if the 'I', account save,
option was not specified. If a file statistics report was requested, it prints
at this time, and a spooler queue entry number is displayed. See the entry for
list-file-stats for more information.
Entry #1
Block size: 16384
[96] bot
After the file stats are finished, a 't-rew' is issued to rewind the
tape. If 't-verify' was requested, it begins at this time, See the
entry on 't-verify' for more information. After the file-save (and
t-verify) is completed, it automatically logs the process off.
file save finished at 08:00:00 16 Jan 1997 Wednesday
< Connect time= 91 Mins.; CPU= 4240 Units; LPTR pages= 0 >
< logged off at 08:00:00 on 16 Jan 1997 >
See Also
User Comments
What do you think?
Share your experience or ask a question by using the form below.
Login to leave your comments.