filename.file-of-files Definition/Access: General

filename.file-of-files

Command filename.file-of-files Definition/Access: General
Applicable release versions: AP, AP 6.2
Category Access: General (65)
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.

On releases 6.2 and above, 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 (6.2 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 (*). Note that on pre-6.2 releases
this list was attribute-mark terminated.
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 (6.2 and above).
47 write-date Last date the file was written (6.2 and above).
Syntax
Options
Example
Purpose
Related tcl.save
tcl.f-resize
filename.fof
filename.files
filename.ff
tcl.lfs
filename.stat-file
filename.restore-errors
ue.001f
ue.28
file.control.block
tcl.resize
tcl.list-file-access
tcl.get-fof
tcl.free
access.istat
tcl.nframe-index