file-save Command

The file-save command in the DM account invokes the procedure to perform a full backup of each file in the D3 file system.

Syntax

file-save {(options}

Parameter(s)

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.
	e	Saves external QS-pointers. QS-pointers are special Q-pointers, which point to an OSFI data source. NOTE—Only the spooler and UNIX OSFI drivers support the save functionality at this point.
	f	List file names as save proceeds. NOTE—The file-save will not automatically logoff if this option is used.
	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 displays 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 may 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 may 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 (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 tape 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 now 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 may 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 commands below, 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, as described below:

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.

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 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 (te)’ (y or <n>)?

After the file-save is complete, the media may be checked for reliability by rereading 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)

: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

[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 multireel 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 Feb 2003 DATA "account.name" # -

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, this message displays:

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 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 a spooler queue entry number displays.

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. 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