file-save command

Syntax

 file-save {(options}

Parameter(s)

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.

Description

Any options available to the save command can be appended to the file-save command at the TCL prompt.
The TCL file-save command creates file statistics to examine in the file FSI:DM,FileOfFiles. These can be examined with the D3 File Manager or from TCL using the format:
```
 sort Fsi:Dm,FileOfFiles, by filename (i
```
The s option is not necessary.
File statistics are built with each save, including an account-save and a dummy save, contrary to VME file statistics.
The file statistics can also be built with the restore operation. It is therefore not necessary to do a file-save after a restore to create file statistics.
The file-save operation refreshes the estimated count returned by the Count File option in the D3 File Manager.
If the file-save utility is not run, the internal tool (nt_makefof) builds the file-of-files file. Run this utility as part of any custom backup procedure.
This file might contain statistics for files no longer on the system and can be cleared at any time without affecting the system.
During the file-save procedure, when compiling some utilities in FSI:DM,BP, it is possible to get the error:
```
 *** 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
```

Using the file-save command

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.

Warning: This version does not support the incremental save or restore of FSI accounts. Use only account saves of full saves.

Note: You cannot perform an incremental save if full save has never been performed. For more information on incremental saves, see save command.

 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.

Note: When supplying additional options, the e must be specified again if it is desired. Also, by default, the tape is not verified against the data on the disk.

 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(s)

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>