Vision File Utility - vutil

On Windows, UNIX, and Linux systems, ACUCOBOL-GT uses the Vision indexed file system to manage its indexed data files. For these systems, ACUCOBOL-GT comes with an indexed file utility program called vutil that contains several useful functions. The full name of this 32-bit utility is vutil32, but is referred to as vutil.

vutil provides several functions in one package. It can be used to:

• display file information (-info, -size, -tree)
• display parameters for an existing Vision file. (-info -g)
  Note: You can then use the displayed parameters to recreate the Vision file using the -gen function. See Creating Empty Files for details.
• test file integrity (-check)
• modify keys within an existing file (-key)
• rebuild and repair files (-rebuild)
• reset the user count (-zero)
• reset the internal revision number (-fixvers)
• extract data records (-extract)
• create empty files (-gen)
• unload data to binary or line sequential files (-unload)
• load data from binary or line sequential files (-load)
• convert other index files to Vision (-convert)
• change the maximum record size (-augment)
• recover deleted records (-deleted)
• place text in the comment field of the header (-note)
• test the atomicity of a file system (-wtest)

Each of these functions is indicated by an initial keyword on the command line (preceded by a hyphen). This keyword may be abbreviated to its first letter. The functions are designed to allow you to specify all possible task parameters up front, so that the utility can run unattended or with a minimum of user interaction. Each function is discussed below.