file-of-files

file-of-files

ff Index Level files
Syntax
Category Files
Type Definition
Description contains statistical information for each file on the system.  Whenever a file is created, restored or deleted, this file is updated.

"file-of-files" items are created when a file is restored or created.

This file is also used to locate files on the disk during restores from incremental and transaction-log tapes.

The item-ids are sequential file numbers assigned when the file is created.  File number one (1) is always the "file-of-files" file and file number two (2) is always the "mds" file. The numbers of the other files are determined by the order in which they are restored or created.

On a file or account restore, the files are recreated in the order in which they were saved on the file save media.

The item "restored" in the dict of the "file-of-files" contains the time in attribute 1, and the date in attribute 2 of the last full restore.  This item should not be deleted or modified.

"fof" and "stat-file" are synonyms (q-pointer) of "file-of-files".

The attributes in the "file-of-files" file are:

ac attribute-name description......................

0  f-fms          Total number of frames in the primary
                 file space as of last file save.
0  f-size         Total number of bytes in the primary
                 file space as of last file save.
0  file#          Item-id assigned in order in which file
                 was created.
0  t-frames       Total number of frames in the file space
                 as of last file-save.
0  stat.acc       Sum of all reads and writes
0  stat.ovf       Sum of all overflow group accesses
0  sug.mod        Suggested modulo for this file, based on
                 file-of-files information.
1  md             Name of the md owning the file.
2  file-name      File name stored in the master dictionary
                 (md) of the account.
3  data-name      One dictionary may have many subsidiary
                 data files each with its own unique name.
                 The default data section name is identical
                 to the file name as stored in the md.
4  base           Base of file.
4  mod            Modulo of file.  The number of contiguous
                 frames comprising the primary file space.
4  modulo         Modulo of file.  The number of contiguous
                 frames comprising the primary file space.
5  items          Total number (including pointer items) of
                 items in file from last file save.
6  ptr-items      Number of pointer items saved in last file
                 save.
7  ovf-itms       Number of item which were partially or
                 wholly stored in secondary file space
                 during the last file save.
8  bytes          Total number of bytes in file as of last
                 file save.
9  ptr-bytes      Total number of bytes in all pointer items as
                 of last file save.
10 frames         Total number of frames in file as of last
                 file save. (Does not include index frames).
11 ptr-fms        Total number of frames of pointer items as
                 of last file save.
12 svdate         Date when file was last saved.
13 reel#          Tape, diskette, etc. number in a multi
                 'reel' file save where this file begins.
14 seq#           Decimal sequence number indicating the order
                 in which the file was saved on the file
                 save media.
15 opendate       Date when file was last opened (update at
                 save-time).
16 stat#          Number of last file save on which this
                 file was saved.
17 mask           Masks desired operations from being logged
                 in attributes 18-20 (release 7.0 and above only).
                 Currently supported masks are: "c" clear file;
                 and "d" delete-file.
18 file-code      Valid file statuses are: "c" clear file;
                 "d" delete file; "n" new file; "r" rename
                 file; "t" restored from tape.  This
                 attribute controls attributes 19 (timedate)
                 and 20 (user).
19 timedate       Time-date when file activity occurred. This
                 attribute is dependent on attribute 18
                 (file-code).
20 user           User id concatenated with account id causing
                 the associated file action. This attribute
                 is dependent on attribute 18 (file-code).
21 dx/dy-date     Date when dx/dy file was skipped on save.
25 save-list      Contains list of specific items to be saved
                 for this file. Used to selectively save
                 items in a file.  Each item name is a
                 value.  To save all items in a file, use
                 an asterisk (*).
29 stat.date      Contains the date when the file access
                 statistics were last cleared.
30 stat.rdu       Number of READU operations on the file.
31 stat.rdub      Number of blocked READU operations on the                        file.
32 stat.rdul      Number of READU LOCKED operations on the file
33 stat.rdulb     Number of blocked READU LOCKED operations on
                 the file.
34 stat.rdptr     Number of pointer items read.
35 stat.rd        Total number reads on the file.
36 stat.wtu       Number of WRITEU operations to the file
37 stat.wtb       Number of blocked writes to the file
38 stat.wtptr     Number of pointer items written.
39 stat.wt        Total number of writes to the file.
40 stat.sel       Total number of selects on the file.
41 stat.dels      Total number of deletes to the file.
42 stat.clr       Total number of clear-file's done on the file.
43 stat.open      Total number of open's on the file.
44 stat.ovf       Read overflow group accesses.
45 stat.wtovf     Write overflow group accesses.
46 read-date      Last date the file was read.
47 write-date     Last date the file was written.
60 Seg.Bas        Segment bases for resized files.
61 Seg.Mod        Segment modulos for resized files.
Options
See Also save f-resize fof files ff lfs stat-file restore-errors u001f u28 file control block resize list-file-access get-fof free istat nframe-index
Example
Warnings
Compatibility D3 7.1 D3 7.0
ff Index Level files