F-S

Saves a complete database to tape like FILE-SAVE, but with the following differences:

It allows the file-save to be delayed for overnight execution.
It lists the names of DX'd accounts (that is, accounts that will not be saved) as soon as you enter the F-S command. It then gives you the option of exiting the F-S procedure so that you can make changes if necessary.
It disables the break key for the duration of the actual save procedure.
It supports the option to output the file statistics report to the printer. However, if there are Group Format Errors (GFEs) the report is always printed.

In all other respects F-S is the same as FILE-SAVE.

The description of the FILE-SAVE command also applies to F-S, except for the detailed procedure, and should be read before using F-S.

Caution

You must always perform a VERIFY-SAVE as soon as possible after completing a save procedure. This verifies the integrity of the data saved to tape to ensure that it can be restored.

Command Class

Proc.

Syntax

F-S

Restrictions

SYSMAN and SYSPROG only. If run from SYSPROG, accounts with update/retrieval lock codes are not saved.

On Windows, multi-reel tape operations are not supported. If the database cannot be fitted onto one reel, dbsave must be used.

Synonym (Q-Pointer) and remote (R-Pointer) accounts are not saved. Only accounts defined as D-Pointers are saved.

Multiple reel FILE-SAVEs cannot be restored on a Reality Release 7.x system.

Procedure

To perform a file-save using F-S, proceed as follows:

Ensure that the tape is loaded and on-line, that the tape is NOT write-protected, and you are logged to the SYSMAN or SYSPROG account.
At the TCL prompt, enter:
```
F-S
```
The names of any DX'd accounts (that is, accounts that will not be saved) are displayed and you are asked if you want to continue:
```
If you still wish to continue with this FILE-SAVE type 'Y' otherwise C/R to exit?
```
Enter Y to continue or press RETURN to exit to TCL.
The time and date are displayed and you are asked to confirm that they are correct:
```
Is the time and date correct (Y/N)?
```
A printout of the file statistics is optional unless GFEs are encountered. The software prompts:
```
Do you wish to have the File-Stats printed regardless (Y/N)?
```
Enter Y, or N, as appropriate.
The software now prompts for the required record block size:
```
Enter tape record block length, if other than 16000?
```
Enter the required record size. Press return to accept the default value (16000).

Note

The record size used with encrypted tape devices must be a multiple of 8.
The software then prompts for the tape units to be assigned:
```
Enter tape units desired, in sequence, separated by commas.
```
Enter the number(s) of the tape unit(s) to be assigned. Multiple tape units can be used in sequence. Refer to the topic Multiple Tape Units for details.
Next the required tape density is prompted for:
```
Enter tape density (if other than Device Default)
```
Possible values may be 800, 1600, 3200 and 6250 bpi, depending on your system. A density of 1600 or 3200 may be required for compatibility with other systems. A density of 6250 bpi reduces the number of tapes.

Pressing RETURN only selects the default density, as configured in the database config file.

This initiates an ASSIGN on the specified tape unit. A message similar to the following is displayed.
```
[1021] DEVICE(S) TAPE 1 NOW ASSIGNED,
       RECORD SIZE = 16000      DENSITY = 1600
```
The software then prompts for any text that you wish to include in the tape label (the time, date, reel number, and tape record size are automatically included in the label). The prompt is:
```
Tape label if desired
```
Enter up to 44 or 42 characters of text, depending on the record size you have chosen. If the record size is greater than 31767 bytes (32Kbytes), you are limited to 42 characters.
Finally the software prompts:
```
Do you require to sleep until 03:00 (Y/N)?
```
This enables you to delay the start of the FILE-SAVE until 3 am. If you wish to do this, enter Y.

The FILE-SAVE now proceeds, as requested. If required, it prompts for additional reels to be mounted.

Failure to write data to tape may result in an error message:
```
Tape operation failed (after retries)
Bad Tape - unable to continue.  Type "Q" to Quit
```
Refer to the topic Error Messages for a description of the message.

On completing the FILE-SAVE, the number of GFEs encountered is displayed and a file statistics report is printed, if requested. The tape unit is detached and the terminal is logged off automatically. The tape is rewound and unloaded.
Re-load the tape, logon again to the database and re-attach the tape unit using ASSIGN or T-ATT.
Use the VERIFY-SAVE command to check the integrity of the FILE-SAVE tape. The procedure is as follows:
1. Enter T-REW to rewind the tape to the BOT.
2. Enter T-FWD to bypass the dummy bootstrap EOF mark.
3. Enter T-RDLBL to read the tape label and ensure that you have the correct FILE-SAVE tape.
4. If a dummy ABS is saved, enter T-FWD to bypass the dummy ABS EOF mark. The tape is now positioned at the files section.
5. Enter VERIFY-SAVE to verify the integrity of the files section.
Note

If the dummy bootstrap and dummy ABS sections are not bypassed, the VERIFY-SAVE procedure shows errors.
Finally detach the tape unit(s), using CLEAR-ASSIGN or T-DET, to enable other database users to attach the tape unit(s).

Example

The following shows a typical F-S procedure.

:F-S

13 ITEMS SELECTED.
DX Accounts not saved 13 SEP 1999
MORRIS.
.
.
If you still wish to continue with this FILE-SAVE type 'Y' otherwise C/R to exit ? Y

16:26:51  13 SEP 1999
Is the time and date correct (Y/N) ? Y

File statistics are no longer automatically produced unless there 
are found to be Group Format Errors on the system.
Do you wish to have the File-Stats printed regardless (Y/N) ? N


NOTE FILESAVE TAPES CANNOT BE RESTORED ON A RELEASE PRIOR TO 7.0
Tape record block length (if other than 16000)?
Enter tape units desired, in sequence, separated by commas.? 1
Tape density (if other than Default Density) ?
Tape label if desired  PRODUCTION SYS
Do you require to sleep until 03:00 (Y/N)? Y

***********************************************************
* THIS TERMINAL IS NOW ASLEEP FOR THE OVERNIGHT FILE-SAVE *
***********************************************************
03:02:02   14 SEP 1999
  
Disable Break Key
. . . START FILE SAVE . . . 03:02:07  14 SEP 95
SYSTEM    
  .
  .
  .
[99] 15323 TAPE RECORDS WRITTEN
. . . END FILE SAVE . . . 06:05:07 14 SEP 1999
T-DUMP STAT-FILE
 Break Key re-enabled
Checking the Stat file for GFE's
[401] NO ITEMS PRESENT
Verify the system
Verify the BASIC COMPILER
0 MISMATCHES IN INTERMEDIATE OBJECT CODE.
Verify SCREENPRO, TIPH, and SPOOLER basic programs
87 ITEMS SELECTED.
Verify TERMINAL-OBJECT
 VERIFY-SYSTEM COMPLETE
****  FILE SAVE COMPLETED SUCCESSFULLY  ****
***************************************************
***      CONNECT TIME AT 06:10:55 = 824 MINUTES  ***
***  CPU MS. = 306828         DISC I/O = 6726   ***
***        NUMBER OF ACTIVATIONS = 203389       ***
***************************************************
***  LOGGED OFF AT 06:10:55   ON 14 SEP 1999    ***
Disconnected

Product:	RealityVersion 15.4
Help revision:	Revision 0
Help topic:	F-S
File name:	userref_ops07+FS.HTM