3.3.12 Converting Micro Focus Files

vutil can convert a Micro Focus file into a Vision file. This is useful when you are moving Micro Focus data to an ACUCOBOL-GT application. The command is:

vutil  -convert  [-ac]  [+c]  [-f #]  [-234]  [-d dir]  [mf-files]

You need not specify that the file is Micro Focus; vutil will determine that.

Note that the "convert" option starts with the same letter as the "check" option described earlier. You must use at least two letters of the word "convert" in order to specify this option. If you just use "-c", vutil will assume that you are specifying the "check" option.

The "convert" function will take each named mf-file and convert it from a Micro Focus indexed file to a corresponding Vision file. If no mf-files are specified, then the standard input is read for a list of files to convert.

Note that each Micro Focus file actually occupies two files: an index file with the extension ".idx" and a data file. The resulting Vision file will have the same name as the data file, with the extension ".vis". Specify only the base file name in the list of files.

Normally vutil will warn the user about the impending conversion and ask if he or she wants to continue. The "-a" (for "automatic") option suppresses this warning. This can be useful when you are calling vutil from another program.

Specifying the "-c" option will cause the resulting file to have uncompressed records regardless of the original file; using "+c" will cause the resulting records to be compressed.

The "-f #" option sets the compression factor to be used when the file is converted. This option does not force the use of compression, it merely sets the compression factor if compression is used. The compression factor, a numeric literal, specifies how much of the space saved by compression is actually to be removed from the record.

The "-4" option specifies that you want the resulting file to be in Vision Version 4. A "-3" means you want the file to be a Version 3 file, and "-2" means you want a Version 2 file.

The "-d" option specifies that you want the converted files to be placed in a new directory. Dir should be the name of a directory on the machine other than the directory containing the files to be converted. The "-d" option implies the "-a" option.

Note that vutil must make a copy of the file while it is converting it. You must have adequate disk space for vutil to complete its conversion. Also note that Micro Focus files and Vision files differ in the amount of disk space that they use. This difference is fairly unpredictable and can vary quite widely. Sometimes the Vision files are smaller, and sometimes the Micro Focus files are smaller. You should have some spare disk space when you start converting files to accommodate the potential difference.