The file-save command in the DM account invokes the procedure to perform a full backup of each file in the D3 file system.
file-save {(options}
a | Suppresses the added information (including all update stamps and binary item sizes). |
b | Saves the B-tree indexes. After a full-restore, this prevents having to regenerate indexes. |
d | Prevents the clearing of dirty bits. Note: This option should only be used when
performing a save in preparation for a full restore.
|
f | Prevents the process from automatically logging off. |
g | Displays file inconsistency errors when found, but skips the group and continues the
save. Errors are logged in the dm,errors, file in attributes 14, 15,
and 16 of the error item. Attribute 14 is the save date, 15 is the primary group FID, and 16 is the account > dictionary > data display information. At the end of the save, a message opens indicating the total number of file inconsistency errors encountered if at least one was found. If used with the b option, index corruptions are also skipped. |
h | Suppresses clearing the transaction log queue. |
i | Suppresses the dumping of the file-of-files file and clears the dirty bits. |
j | Suppresses the dirty bit counter display. |
k | Reorganizes all file-of-files file numbers sequentially on the tape. |
l | Each file might have a list of specific item-IDs within the file to save. This option
saves only the list of item-IDs provided in the associated item for the given file, located
in the dm,file-of-files, file, beginning at attribute 25. Any number of item-IDs can follow in attributes 26 and beyond. An asterisk in attribute 25 saves all items in the file. If there is no list, only the file-defining item is saved, as if the file had a dy dictionary code. In addition, the l option does not unmark (that is, clear dirty bits) items that have changed. These items are saved on subsequent incremental file-save commands or account-save commands. This is similar to the v option for the full file-save. |
m | Same as the l option, but it additionally unmarks or clears the dirty bits. |
p | Directs console listing to the printer, via the spooler. |
q | Changes the terminal display from hierarchical format to indented format. |
r | Same as the l and m options, except the list is also saved with the file as a separate item in the dm,file-of-files, file. |
t | Validates the content on tape. Must be run in conjunction with the v option. |
u | Performs an incremental file-save or
account-save. This saves all file items and data items that have changed
since the last full file-save or account-save.
Note: You cannot perform an incremental save if full save has never been
performed.
|
v | Verifies the tae against disk. |
x | Saves files with a D-pointer type of dx. |
y | Saves files with a D-pointer type of dy. |
sort Fsi:Dm,FileOfFiles, by filename (i
File statistics are built with each save, including an account-save and a dummy save, contrary to VME file statistics.
*** Remote file system error ***
If this occurs, type Q to quit the file save. At TCL, type the following commands, and then restart the file-save procedure.
clear-file dict fsi:dm,bp, compile fsi:dm,bp, (of
The operator is prompted for a series of decisions:
The file-save is typically followed by a t-dump of the file-of-files file and generation of the file statistics report.
Is this an Incremental Save (y or <n>)?
An incremental save only saves files that 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 response is no.
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 might 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 (te)’ (y or <n>)?
After the file-save is complete, the media can 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. Additional t-verify options are 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.
Bypass inconsistent groups (y or <n>)?
Instead of stopping and prompting the user when a file inconsistency error 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 causes the process to ask for the time to begin (in a 24-hour format):
Enter sleep time (default = 23:00)
Example 1
: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 (te)’ (y or <n>)? n Do you want to sleep (y or <n>)? n File Save Beginning at 08:00:00 16 Feb 2003 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 display 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, you will see the following message:
Load volume #2 and type ’C’ label 08:00:00 16 Feb 2003 DATA "account.name" # -
Example 2
When the next reel is inserted or mounted, c continues the process, or q stops it and returns control to TCL.
At the end of the save process, you will see this message:
clearing dirty bits... 2082 file-of-files being dumped to tape [802] nnn items dumped
Example 3
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 issued a t-dump to tape if the i option was not specified. If a file statistics report was requested, it prints at this time, and you will see a spooler queue entry number:
Entry #1 Block size: 16384 [96] bot
Example 4
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. After the file-save (and t-verify) is completed, it automatically logs the process off.
file save finished at 08:00:00 16 February 2003 Wednesday <Connect time= 60 Mins.; CPU= 4240 Units; LPTR pages= 0> <logged off at 09:00:00 on 16 February 2003>
account-restore command, account-save command, admin.files utility, check-account macro, check-dx command, create-file command, d/code1, Dirty bits, Dummy restore, Dummy save, File control block, Full restore, Incremental restore, Incremental save, list-device command, restore-accounts command, save command, sel-restore command, set-device command, set-floppy command, set-sct command, t-select command, Tape devices overview, Tape socket, tlog-restore command, tv.log file, u28 user exit