Converting Micro Focus Files

Restriction: The conversion process is only supported for earlier Micro Focus indexed file formats (IDXFORMAT"4" and earlier).

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  [ -a ]  [ +c ]  [ -3456 ]  [ -d dir ]
                 [ -f # ]  [ -q ]  [ mf-files ]

You need not specify that the file is a Micro Focus file; vutil makes that determination.

The -convert option starts with the same letter as the -check option. 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 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.

Each Micro Focus file actually occupies two files: an index file with the extension .idx and a data file. The resulting Vision file has the same name as the data file with the extension .vis. Specify only the base name in the list of files (do not include any extension).

Normally vutil warns the user about the impending conversion and asks if the user 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 causes the resulting file to have uncompressed records regardless of the original file; using +c causes the resulting records to be compressed.

The -f option sets the compression factor 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 -6 option specifies that you want the resulting file to be in Vision Version 6. The -5 option specifies that you want the resulting file to be in Vision Version 5. The -4 option specifies a Vision Version 4 file. A -3 means a Version 3 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.

The -q option causes vutil to exit (with status 99) if user interaction is required.

vutil makes a copy of the file while it is converting it. You must have adequate disk space for vutil to complete its conversion. Also, 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.