Tools

Tools

Top  Previous  Next

 

QM includes several tools to assist system administrators. These are provided as globally catalogued programs that can be executed by typing their name, including the leading asterisk, at the QM command prompt.

 

 

*FIXDIR

 

The FIXDIR tool updates records in a directory file to use the line terminator appropriate to the operating system. This is a CR/LF pair on Windows and LF on other platforms. It is useful when moving accounts from Windows to Linux or vice versa.

 

The command is

*fixdir filename {OMIT.HIDDEN} {id...}

 

The filename may be the VOC entry name for an F or Q-type item referencing a directory file. Alternatively, it may be the pathname of the directory.

 

If no record ids are given on the command line, the default select list is used. If this list is not active, all records in the file are processed and the OMIT.HIDDEN option will cause hidden files to be omitted.

 

 

 

*FIXPATH

 

The FIXPATH tool updates pathnames in F, Q and V-type VOC items to use the correct operating system directory delimiter character. It is useful when moving accounts from Windows to Linux or vice versa.

 

The command is

*fixpath

to update the current account or

*fixpath acc.name

to update another account. The acc.name may be the account name or its pathname.

 

 

*FIXPFX

 

The FIXPFX tool changes the prefix character on the subfiles within the directory that represents a hashed file from ~ to %. Early releases of QM used the ~ prefix but it was discovered that some PC clean-up tools assumed that anything beginning with a ~ character was a temporary item that could be deleted. QM release 2.7-1 (July 2008) changed the prefix character to % to avoid this problem and automatically renamed the subfiles when opening a file for which write permission was available. This renaming mechanism was removed in release 3.3-0 (April 2014) as there was a small performance impact on all file open operations. Instead, the installer offered an automatic scan to update the subfile prefix in all accounts.

 

There remains the possibility that a user might need to import an account from a release that used the ~ prefix. The FIXPFX tool will update a named account or all accounts to use the new subfile prefix. The command line is

*fixpfx

to update all accounts or

*fixpfx acc.name

to update a named account (which may be given as a pathname).

 

 

 

*IMPGCAT

 

The IMPGCAT tool imports items from the global catalogue of another QM system. It is of use when moving an account or an entire QM system to a new computer.

 

Simply copying the gcat subdirectory of the QMSYS account does not work unless the two systems are running the same version of QM as the global catalogue includes many items that are part of the QM release and are not compatible across different versions. This tool selectively copies items, transferring user written items and omitting those that are standard components of QM.

 

The command line is

*impgcat {pathname} {options}

where

pathnameis the pathname of the global catalogue from which items are to be copied.
optionsare chosen from
DISPLAYShow the names of items but do not copy.
NO.QUERYSuppress confirmation prompt before copying.