filename.file-of-files

Definition/Access: General, Releases: AP and AP 6.2

Statistical information on all files.

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

See Also

Command Name Type Description
tcl.save Verb: Access Invokes backup process.
tcl.f-resize Verb: Access Calculates a new recommended modulo for the requested files.
filename.fof File Synonym ('q-pointer') Synonym for 'file-of-files' file.
filename.files File Synonym ('q-pointer') Synonym for 'file-of-files' file.
filename.ff File Synonym ('q-pointer') Synonym for 'file-of-files' file.
tcl.lfs Verb: Access Produces file statistics report.
filename.stat-file File Synonym ('q-pointer')
filename.restore-errors Definition File used to record errors during restore.
ue.001f User Exit Returns the last 'shutdown' status.
ue.28 User Exit Returns file-save count.
file.control.block Definition Description of file control block.
tcl.resize Verb: Access resizes a file to the desired modulo.
tcl.list-file-access Verb: Access displays file access statistics
tcl.get-fof Verb: Access returns the file-of-files item-id for the specified file
tcl.free Verb: Access Displays available disk space for Pick and Unix.
access.istat Verb: Access Performs distribution analysis on existing file modulo.
tcl.nframe-index Verb: Access Displays total number of frames used by index or indices.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.