Execu/Tech Systems, Inc.
Knowledgebase
Search:
850-747-0581 Email Website
Contents
 
:
IndexBookmarkPrint This Article

Home > Errors / Fixes > Rebuild Corrupted File

Rebuild Corrupted File

If you have any questions about dealing with a potentially corrupted file, contact support before you attempt to perform any of these actions.

 


 If you experience these situations, you've got network or hardware problems:

  • The errors occur more than four times a year. 
  • The errors come and go, without having to rebuild the file.

 

Most of the time, corrupted files can be rebuilt with no loss of data.

 

Often, your first symptom of a corrupted file will be an error message similar to these:

 

File error 91, 02 on GACNTL.FIL . . .    File error 91 on GARSXREF.FIL . . . 


 

BEFORE RUNNING THE REBUILD

  • The name of the file that will need rebuilding is immediately after the error code (GACNTL.FIL and GARSXREF.FIL in the examples above. Your error may show a different file name, and that is the file that will need rebuilding.
  • The computer where the rebuild will be performed should be the only one logged into the software. DO NOT LET ANY OTHER COMPUTERS LOG INTO THE SOFTWARE BEFORE YOU RUN THE REBUILD!!!!
  • If you will be using the Command Prompt to run the rebuild, it can only be done at your server, where the software is installed on a local hard drive.

Running the File Rebuild Utility

There are three ways to run the rebuild utility:

  1. Graphical User Interface (GUI) in System Information within the software.
  2. ETRebuild. This can be done at the server or client.
  3. Command Prompt. This must be done at the server.

Using the Graphical User Interface (GUI)


How to get to System Information:

  • Drop-down menus: go to File > Special > System Information. It might take a few seconds to open.

  • Push-button menus: type 88 <enter>to run a program by name. The program name you will enter is MENUSYSI. Run Program by Name

 

The System Information window will open:



Use the file name in your error message. 

 

Quick Rebuild

  • If the file you are rebuilding is one of the common core files, you'll find it in the Select Item from List for Quick Rebuild drop-down box.
  • If you find it there, select it and then click Quick Rebuild

Select File 

  • If you don't see the file in the Quick Rebuild list, click Select File (on the left.)
  • A window will open in hotel folder.  Locate the file (ending in .fil) and click the Open button to return to the main System Information window. The file you selected should be displayed in the box.
  • To rebuild this file, you click the Rebuild File button (middle right.)

ETRebuild

 

ETRebuild.exe is a helper app that can be run from the Execu/Tech software folder. This app will run the script that rebuilds the corrupted file and is useful for situations where you're unable to access the System Information menu in the software.

If you don't have this app, you can download it by clicking here. Unzip the file and place it in the Execu/Tech software folder.

 

Running ETRebuild

  • Browse to the Execu/Tech software folder. This is the same folder referenced in the "Target" line of the shortcut properties.

Locate the app ETRebuild.exe and run it (right-click or double-click it)

  • Once the app opens, click the button titled Step 1 Select File to Rebuild.

  • The Select File dialog box will open to the Execu/Tech software folder. 

Find the file that was referenced in the error you received. 

 

You can start typing in the File Name field and the list of files will start filtering to make the file easier to find.

 

Click Open once the file is selected.

  • Once you have selected the file, the button titled Step 2 Rebuild the Selected File will appear. Click this button to begin the rebuild process.



 

Using the Command Prompt

  • *This can only be done at your server, where the software is installed on a local hard drive.
  • If you don't have access to the System Information utility, you can run the rebuild from the Command Prompt. Different versions of Windows access the Command Prompt in different ways, so use Google to determine how to access it on your computer.​
  • Make sure you have the name of the file that's causing the error.​
  • You'll need to change the directory to where the software is installed. You can find the location by right-clicking on your Execu/Tech shortcut and going to Properties.

    The "Start in:" field shows the location of the software.


     

  • To change the directory, you will type cd, followed by a space, and then the location of the software folder from the shortcut Start in line. Your computer may allow you to copy the Start in line, and paste it into the Command Prompt. If not, just type it in. If it is located in the same drive (C:, etc) as the current directory, you do not need to reenter it.
  • In this example, we entered: cd \executech\hotel   (Use the location of YOUR software folder!)

 

  • Press <enter>, and it will change to the correct directory.

​​

  • Next, you will type vutil32, followed by a space, then -r, followed by another space, then the name of the file you are rebuilding.

In this example we entered: vutil -r GACNTL.FIL    (Use the file name in YOUR error message!)

 

 

  • Press <enter> and the file rebuild will start.

 

The Rebuild

You'll see a command window open with the progress and results of your file rebuild.

 

 

If the rebuild is successful, you will receive a response similar to this one, telling you how many records were recovered and how many deleted records were removed.

 

Type Y and press <enter> to replace the original (corrupted) file with the new (rebuilt) one. 


Errors

Chain of records is broken!

This means that there is a point in the file where the damage is just too severe to recover. This is rare, but it happens, and is usually the result of large chunks of data being removed from the file.

 

When it does happen, you'll find that you usually lost a single record (the last one to be saved when the problem occurred.) You will lose all of the lost records. Depending on the affected file, these could be reservations, Point of Sale transactions, etc., so it's a good idea to call Execu/Tech Support and ask for advice.

 

Type N and we will have you rerun this utility, if needed. While you're calling us, you should also try to locate your backup, because you may need to restore it if the damage is too severe.

Duplicate Key

This is usually due to network traffic problems and hard drive caching problems. This does what is impossible to do in the software: add records with a duplicate key. Most often, these are the same records created a second time because of a failure in the hard drive caching. It's very rare, but it happens (typically only to a few records.) As in the previous case, you should call Execu/Tech Support. 
File Locked - File not rebuilt

 

 

Sometimes this error occurs but the file is still successfully rebuilt. Verify this by trying the process that produced the error and if the error is gone, the file was rebuilt.

 

This error often occurs because the file is locked by a computer running the software, the user doesn't have write access, or the file has been set to "Read Only".

  • Make sure that no computers are running the software when you try the rebuild. The computer where the rebuild is run from should be the only one logged into the software.
  • Make sure that the Windows user has "write access" to the file.

  • Make sure that the file isn't set to "Read Only."

  • You can try to release any locks on the file. See Release Locked File below. 
Not a Vision File - Rebuild Stopped

 

 

Vision is the file structure used in many of the files, and the error can be caused by three reasons:

 

1. The file really isn't a Vision File, and you may have selected the wrong file to rebuild. 

 

2. The file is locked by another user, which sometimes happens when a file is corrupted, and the error is on their screen. You can try to release any locks on the file.​ See Release Locked File below.

    ​3. The file has been damaged beyond recognition. Locate your backup, because you may need to restore this file.

     

    If, after restarting your server, the error continues, call Execu/Tech Support. It may be that you're trying to rebuild a file that doesn't use the Vision File structure, or the file may be damaged beyond all recognition.


    Release Locked File

    • If it's in a shared folder, you can release any locks from the server using Windows Computer Management. See Close an Open File.
    • If you don't see the file in the Computer Management console, you can restart ALL client computers and then restart your server. 
    • ​​You can try this command prompt to unlock the file: VUTIL32 -ZERO GACNTL.FIL  (Example only. Replace GACNTL.FIL with the file name displayed in your error message.)

    The computer where the rebuild is performed should be the only one logged into the software. DO NOT LET ANY OTHER COMPUTERS LOG INTO THE SOFTWARE BEFORE YOU RUN THE REBUILD!!!!



    Related Pages
    Cobol File Errors
    Slow / Stuck Software
    Network Benchmark
    Common System Issues





    Article ID
     rebuild_corrupted_file
    Views
     5433
    Last Modified
     6/29/2024 2:15 PM