The FSTAT command collects and report file access statistics.
The FSTAT command controls collection and reporting of file access statistics for dynamic files and any associated alternate key indices. Directory files cannot be used with this command but are included in the global statistics.
Use of FSTAT with the ON keyword clears the statistics counters associated with the file and enables collection of statistics. The overhead for data collection is extremely low except that a file that is opened to read only a few records will require a write to update the counters on disk when the file is closed. The LISTF, LISTFL and LISTFR commands can be used to determine which files have file statistics enabled.
The second form of FSTAT displays or prints a report of the file access statistics. Data collection must be enabled when this mode is used. When using a select list, entries that do not correspond to dynamic files for which statistics are enabled will be ignored.
Use of FSTAT with the OFF keyword disables collection of statistics.
The GLOBAL keyword displays a report of statistics accumulated across all files regardless of whether statistics collection is enabled for the individual files. The global counters are reset when QM is started. On Windows NT and later, this occurs automatically when the last user leaves QM unless QMSvc has been configured to maintain a persistent shared memory image. The counters can be reset manually by use of the RESET keyword.
Use of the FSTAT command with no arguments displays a periodic display of the global statistics, updated once per second. This shows four columns; the overall data since the counts were last reset, the data since FSTAT was entered, the data for the last second and average per-second values since FSTAT was entered.
The figures displayed by FSTAT are:
GLOBAL FILE STATISTICS 12:02:33
........System .........Total .............. .......Average
.........Total ......this run .......Per sec .......per sec
Period 00:17:05 00:00:34
Opens 124 0 0 0.0
Reads 273161 143505 4228 4220.7
Writes 258086 134876 3958 3966.9
Deletes 13901 8628 269 253.8
Clears 0 0 0 0.0
Selects 0 0 0 0.0
Splits 4937 10 0 0.3
Merges 0 0 0 0.0
AK Reads 501091 269179 7924 7917.0
AK Writes 344094 178509 5221 5250.3
AK Deletes 156997 90670 2705 2666.8