File-of-Files File (VME)

The file named file-of-files contains statistical information for each file on the system. Whenever a file is created, restored, or deleted, this file is updated.

Synonym(s)

ff

files

fof

stat-file

Description

Items are created in the file-of-files file when a file is restored or created.

The item-IDs are sequential file numbers assigned when the file is created.

The numbers of the files are determined by the order in which they are restored or created.

When a file or account is restored, the files are recreated in the order in which they were saved on the file-save media.

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

File number one is always the VME file-of-files file and file number two is always the mds file.

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

NOTE

The data-level of the file-of-files is DX’d. This cannot be changed. Thus, this file is not saved during a file-save.

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

Attribute

Name

Description

0

f-fms

Total number of frames in the primary file space as of the last file-save.

f-size

Total number of bytes in the primary file space as of the last file-save.

file#

Item-ID assigned in order in which the file was created.

t-frames

Total number of frames in the file space as of the last file-save.

stat.acc

Sum of all reads and writes.

stat.ovf

Sum of all overflow group accesses.

sug.mod

Suggested modulo for this file, based on file-of-files information.

1

md

Name of the master dictionary that owns the file.

2

file-name

File name stored in the master dictionary 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 master dictionary.

4

base

Base of file.

mod

Modulo of file. The number of contiguous frames comprising the primary file space.

modulo

Modulo of file. The number of contiguous frames comprising the primary file space.

5

items

Total number of items (including pointer items) in the file from last file-save.

6

ptr-items

Number of pointer items saved in last file-save.

7

ovf-itms

Number of item that were partially or wholly stored in secondary file space during the last file-save.

8

bytes

Total number of bytes in the file as of the last file-save.

9

ptr-bytes

Total number of bytes in all pointer items as of the last file-save.

10

frames

Total number of frames in the file as of the last file-save (not including index frames).

11

ptr-fms

Total number of frames of pointer items as of the last file-save.

12

svdate

Date when file was last saved.

13

reel#

Number in a multireel file-saves where this file begins (Tape, diskette, and so on).

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. Currently supported masks are:

c

clear file

d

delete-file

18

file-code

Controls attributes 19 (timedate) and 20 (user). Valid file statuses are:

c

clear file

d

delete file

n

new file

r

rename file

t

restored from tape

19

timedate

Time and date when the 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.

22

indx-fms

Number of index frames

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 operations on the file.

43

stat.open

Total number of opens 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.

See Also

f-resize Command

File Control Block

FileofFiles File (FSI)

free Command

get-fof Command

istat Command

lfs Macro

list-file-access Command

nframe-index Command

resize Command

restore-errors File

save Command

u001f User Exit

u28 User Exit