list-file-stats Command

The list-file-stats BASIC program produces the file statistics report generated from the most recently executed file-save Command or account-save Command.

Syntax

list-file-stats {det-supp}{leg-supp | legend-supp} {tcl-supp} {(options}

Parameter(s)

options

b

Suppresses the number of items listed message at the end of most AQL reports (see ni-supp Modifier).

c

Suppresses column headings above output columns as well as the default page heading on AQL reports (see col-hdr-supp Modifier).

h

Suppresses the default page heading (system time/date and page number) (see hdr-supp Modifier).

i

If this option is used, the results will include the number of bytes and frames that are used in both the data and the index. Note that this command requires that you run the save command with the (b option.

n

Affects output to the terminal only, preventing the AQL output from pausing at the end of each (terminal) page of output (see nopage Modifier).

p

Directs output of the AQL sentence to the system printer, via the spooler (see lptr Modifier).

w

Displays the output of a list or sort command in a full screen window, allowing the user to scroll backward, forward, left, and right through the report. If a minus sign (-) displays after the w option, then a wide virtual display is used to display the output of the AQL sentence. The user can then scroll left and right a screen at a time, as well as up and down a screen at a time. If a number is entered, that number of lines from the top of the first page are stored away as the header, and are displayed on each page. This may cause confusion for reports that display the page number within the header. The h option (hdr-supp) is automatically appended to any reports that do not include a heading sentence. A short help screen is available while displaying the output to elaborate on the keystrokes.

The list-file-stats command lists both VME and FSI file statistics, listing the file statistics for VME first.

For a separate FSI listing, type ntlfs {(p} from TCL.

NOTE

  • VME: file-of-files (hyphenated)

  • FSI: FileOfFiles (not hyphenated)

In general terms, when referring to either file, file of files file is used.

Statistics are produced from the dm,file-of-files, file or the fsi:dm,FileOfFiles, file.

The data displays as:

r#

Reel number (or volume number) that the file resides on (from the last file-save).

seq#

File sequence number that numbers from 1 to nn across the whole file-save.

file#

File sequence number in the system’s master dictionary.

fname

File name.

mod

Modulo of the file.

bytes

Size (in bytes) of the file.

items

Number of items in the file.

ovfitms

Number of items residing in overflow frames (secondary file space).

frames

Total number of frames used by this file.

ptr-fms

Number of pointer frames used by this file.

Example(s)

sort dm,file-of-files, by name id-supp reel# seq# file# roll-on acct "*** ’UVF’" fname mod total bytes total items total ovf-itms total frames total ptr-fms grand-total "’U’" heading "PAGE ’P’ ** FILE STATISTICS REPORT ** ’DCLL’" with stat# "2" lptr

PAGE 1

** FILE STATISTICS REPORT **

16 Feb 2003

r#

seq#.

file#

fname......

mod

bytes

items

ovfitms

frames

ptr-fms

3

89

132

 

17

4470

8

 

25

8

4

109

142

01

1

556

1

 

2

1

4

111

139

TOOLS

1

20632

20

 

22

21

4

113

141

TOOLS OBSLT

1

15080

30

28

17

5

4

112

140

TOOLS TOOLS

3

23226

30

18

29

21

 

 

 

 

 

-------

-------

-------

-------

-------

*** atp4

 

 

 

359333

125

479

366

131

 

 

 

 

 

-------

-------

-------

-------

-------

*** tutor

 

 

 

172970

945

355

210

129

 

 

 

 

 

=======

=======

=======

=======

=======

 

 

 

 

 

4170691

15323

6229

5546

2645

[405] 132 items listed out of 158 items.

See Also

account-restore Command

check-account Macro

col-hdr-supp Modifier

det-supp Modifier

f/realloc

File Control Block

lfs Macro

lptr Modifier

ni-supp Modifier

nopage Modifier

save Command

sel-restore Command

tcl-supp Modifier

u28 User Exit