Help for Beginner Programmers - Installing Ubercode

1. How do I begin installation of Ubercode programming software?

If your copy of Ubercode is on CD, put the CD into the computer and the install program should start automatically. If you have floppy disks (or if the CD installer does not start), click the Windows Start button, then Settings, then Control Panel, double-click "Add/Remove Programs", then click "Add New Programs" then click "CD or Floppy". This makes Windows find the installer.

If you downloaded Ubercode from the web site, it will be a self-installing EXE file. Make a note of where you downloaded the file to, then double-click the EXE file to start the installer.

If you have already installed Ubercode, you can refresh the installation by repeating the installation process. The repeat installation will re-copy all the files. If you are installing a different version, you must choose a different folder. It is not possible to install different versions into the same folder as (i) some of the files would be overwritten and the previous installation would be damaged and (ii) when one of the versions was uninstalled, files common to both versions would also be removed.

2. How do I remove Ubercode programming software?

You should always remove Ubercode before upgrading versions, or if you want to re-install into a different folder. Click Start -> Settings -> Control Panel, double-click "Add/Remove Programs", then look in the scrolling list for Ubercode vX.Y where X.Y is the version number. Double-click the Ubercode entry, then confirm whether you want to remove the software, and follow the instructions on screen.

It is possible to remove Ubercode manually, by using Windows Explorer to remove the Ubercode folder and all files and sub-folders. However this is not recommended, since it will not remove Ubercode from the list of programs that can be removed by Windows.

3. How do I change the Ubercode folder after installation?

To change the Ubercode folder, uninstall Ubercode, then re-install into the new folder. It is unsafe to rename the Ubercode folder without uninstalling Ubercode beforehand, since the folder paths are saved in INI files and in the registry and these would not be updated. Always uninstall Ubercode first then reinstall to the new folder.

4. How do I copy the Ubercode folder to another computer?

Reinstall Ubercode from the website or the installation disks. It is not possible to cut and paste the folder tree, because the registry settings, INI files and system link libraries will not be copied. If you install multiple copies of Ubercode from one CD, please make sure you are obeying the licence conditions. Most versions of Ubercode are licenced for a single user only.

5. How do I check Ubercode has been installed correctly?

Make sure your PC meets the system requirements (refer to What kind of computer do I need?). You can check everything works properly by building the sample programs. For example if you can build the Hello World program and it works properly, this shows the Developer Environment and the compiler is installed correctly.

6. How do I put a short cut to the Developer Environment on the desktop?

Normally you won't need to do this, because the installation program does it for you. But if you deleted the short-cut and want to put it back, use the following steps:

• Right-click the Windows Start button.
• Choose the Open command from the menu.
• Double-click on the Programs icon.
• Double-click on the Ubercode icon.
• Right-click on the Developer Environment icon, then choose the Create Shortcut menu command.
• Drag the short-cut to the desktop.
• To rename the short-cut rearrange your windows so you can see the icon on the desktop. Click it once with the mouse to highlight it, then press F2 to edit the name.

These steps work with all programs, not just Ubercode.

7. Installation Error: File is not a Windows help file or the file is corrupted

Symptom

After some installations, the following error message:

is seen when trying to access the Ubercode help system. File represents the name of a help file, for example ide.hlp

Cause

The most likely cause is the help file was damaged during installation, or has become corrupted after installation. The error should not occur if Ubercode is installed from a CD / DVD, because the installer checks files as they are copied.

The error may occur with downloaded copies of Ubercode if an error occurred during the download. Although unlikely, it is possible for the download process (built into a web browser) to add or remove a few bytes from the end of the file.

Solution

To fix the problem, check the help file is the correct size as follows:

1. On your Windows desktop, click Start - Run.
2. Type notepad c:\program files \Ubercode \filelist.txt to open the list of file sizes. If you installed Ubercode to a non- default folder, use the non-default path instead.
3. Read through the filelist.txt file until you see the help file. The size listed here is the size when the file was created, which is the correct size.
4. Click Start - Search - Files or Folders.
5. In the Search dialog, type the help file name in the Search for Files field.
6. In the Look In field, make sure that Local Hard Drives (C:) is selected.
7. Click Search Now button and wait a few moments.
8. Scroll through the right-hand list until you find the file. When scrolling through the right-hand list, ignore the help links, which have little arrows in the bottom corner.
9. After finding the help file, check its actual size. To do this, click the right mouse button on the help file, choose 'Properties', click the 'General' tab and look at the 'size' field. The size should be exactly the same as the size in 'filelist.txt'.

If the sizes are different, the help file is damaged and you need to re-install Ubercode. Use the same options as before and you will not need to remove the first installation.

If the size is correct, or if the error still occurs, it is possible the entire download file was damaged (this applies only to downloaded copies of Ubercode, not to copies on CD / DVD). Re-visit downloads and note the size of the download file. The size listed on the web page is the size when the download was created, which is the correct size. Locate the download file on your computer and check the two sizes are identical. If not then repeat the download.

If the size is correct and the error persists, there may be an incompatibility between the help file and your computer. If you have access to a different computer, copy the help file to the other computer and see if it works there. Note that help file compatibility is unlikely to be the cause of the problem, since help files are designed to run under all versions of Windows (Windows 95 on).

Finally, if the size is correct and the error persists, contact Ubercode technical support. Keep the damaged help file - it will be needed for further testing.

8. Installation Error: S32EVNT1.DLL An installable Virtual Device Driver failed Dll initialization.

Symptom

If Norton Anti Virus (NAV) is installed, during some installations of Ubercode the following error message may occur:

The error can occur during the installation of Ubercode under Windows XP.

Cause

The error message is caused by a problem in Norton Anti Virus (NAV) 2000, 2001 and 2002, and the failing DLL is part of the NAV suite. Refer to the Symantec web site http://service1.symantec.com/SUPPORT/nav.nsf/docid/2000030812224206 for more details (if the full text of this article is not available, Symantec have moved it to another location).

Solution

Install NAV 2003 or later, or update to a different anti-virus checker such as the one from grisoft.com which is free for personal use.

Note that when Ubercode is built, it is automatically scanned against viruses as part of the build process. Results from the actual scan during the build are available in the Ubercode file scan.txt.

9. Installation Error: The system file is not suitable for running MS-DOS and Windows applications

Symptom

During some installations under Windows NT v4, Windows 2000 or Windows XP, the following error occurs:

<File> represents a Windows system file such as autoexec.nt, config.nt or command.com. After the error message the Ubercode installation is unable to continue.

Cause

The error is caused by some of the Windows system files being missing from the c:\winnt\system32\ folder or the c:\windows\system32 folder under Windows XP. Refer to http://www.support.microsoft.com/default.aspx?scid=kb;en-us;324767 for more details.

Solution

Check whether the files are missing. On your Windows desktop, click Start - Run and type in:

  cmd

then press Enter. This starts a command prompt. In the command prompt window, type:

  cd \winnt\system32

(under Windows XP replace winnt with windows). This changes into the Windows folder. Then type:

  dir *.nt

and press Enter. Among the files you should see: autoexec.nt and config.nt. Then type:

  dir command.*

and press Enter. You should see a file command.com. If any of these three files are missing, you need to reinstall them. Some installations of Windows keep a backup copy of their files in the c:\i386 folder on the hard disk, so you may already have replacements for the missing files. Check for replacements by typing:

  cd \i386

and press Enter. If the command prompt shows c:\i386 you found the replacement folder. Install the replacement files by typing:

  expand config.nt_ c:\winnt\system32\config.nt
  expand autoexec.nt_ c:\winnt\system32\autoexec.nt
  expand command.co_ c:\winnt\system32\command.com

Press Enter after each line, and if you have Windows XP replace winnt with windows. This should fix the problem.

If the cd command was not successful, you will see a warning message saying there is no such path. In this case you need the Windows 2000 / Windows XP installation CD, or a CD containing the Windows files. Put this in your CD drive and type:

  expand d:\i386\config.nt_ c:\winnt\system32\config.nt
  expand d:\i386\autoexec.nt_ c:\winnt\system32\autoexec.nt
  expand d:\i386\command.co_ c:\winnt\system32\command.com

Press Enter after each line. Again if you have Windows XP replace winnt with windows. Also this assumes your CD drive is the D: drive. If you have zip drives or CD rewriter drives or DVD rewriter drives, it may have a different letter, so use the drive letter corresponding to your CD drive in place of D: above.

The steps above should fix the problem - now try re-installing Ubercode. If this is not successful, contact Ubercode Technical Support with full details.