| field | Index Level | file-save (R83) |
| Syntax | file-save {(options} |
| Category | TCL |
| Type | Verb |
| 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 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. |
| See Also | :absload (R83) account-restore account-save admin.files check-account check-dx create-file d/code deleting items dummy save file control block files full restore incremental restore incremental save restore-accounts save sel-restore set-device set-floppy set-sct t-select t-stat tape label tlog-restore tv.log u28 transaction logger dirty bits dummy restore restore |
| 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 > |
| Warnings | R83 does not support incremental saves and transaction logging, nor does it provide the "file-of-files" file. |
| Compatibility |
| field | Index Level | file-save (R83) |