tcl.file-save Verb: Access/TCL


Command tcl.file-save Verb: Access/TCL
Applicable release versions:
Category TCL (746)
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):
Syntax file-save {(options}
Options Any options available to the "save" command may be appended to the "file-save" command at the TCL prompt.
:to dm
Tape attached block size: 16384
[1082] Tape device is attached to quarter inch Streaming Cartridge Tape
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 >
1    6 mds > qa > > admin
1    7 mds > 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 ""         # -

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 ...
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                  >
Related tcl.:absload