The qmfix Utility

The qmfix Utility

Top  Previous  Next

 

The QM file system is designed to be robust, however, there are situations when power failures, hardware failures or abnormal termination of a process might lead to structural integrity problems within a file.

 

The qmfix utility can be used to check the structural integrity of a file and, if an error is detected, then apply an automated correction. Although qmfix should always result in the file being usable, there are error situations where data will be lost because it simply was not in the file.

 

To use qmfix, firstly ensure that no users have the file(s) to be processed open. It is safest to run qmfix when no users are using QM. The qmfix utility is run from the operating system command prompt, not from within QM. The command line is

qmfix options pathname

where

optionsare case insensitive option codes from the following set:
-BSuppresses progress bar display. This can be of use when capturing the output for later review as repainting of the progress bars may make the captured data less easy to read.
-CCheck file for errors (implied if B, F, Q and R options all absent)
-FFix errors without querying
-LLog the screen output in qmfix.log
-LpathLog the screen output in path
-NSuppresses pagination of displayed output
-QQuery before fixing errors
-RRecover space from unused primary and overflow blocks. Occasional use of this function may improve performance of some large files.
-SSuppresses output to the screen when used with the -L option.
pathnameis the pathname of the file to be processed. This may be a list of may include wildcard characters. qmfix will ignore names that do not correspond to QM files. Thus, to check all files in a directory, simply type

qmfix *

 

Where pathname refers to a directory, either directly or as part of wildcard expansion, qmfix will recurse down one level to allow for directories that represent multi-files.

 

Do not run qmfix with the -F option without running it to check for errors first.

 

Note that qmfix may report that a dynamic has an incorrect load value or record count if the file was not closed properly at a system failure. These errors are unlikely to cause any serious problems and will be corrected by qmfix if the -F option is used and automatically by select operations that complete without any intervening file updates.

 

No automated error recovery tool can ever be 100% accurate in its decisions about the nature of errors so there is a very small risk that qmfix could make the situation worse. Always backup a file before fixing any errors in it.

 

 

Ladybridge Systems aims to provide software of the highest quality. We would be very interested to receive copies of any files that are reported as faulty by qmfix so that we can investigate the cause and improve the resilience of the QM product.