Troubleshooting HIC Online

Diagnostic Self-Test

If you are experiencing problems trying to use HIC Online, the first thing to do is run the Diagnostic Self-test by clicking the Check HIC Online Installation button under the Administrator tab of Maintenance & Reports.

This will produce a text file which will identify any problems with your HIC Online installation and the suggested course of action to remedy any such problems.

HIC Online Plug-in

An integral component of the HIC Online installation is a plug-in for 4th Dimension, the database on which Genie runs. The plugin is called HICOnline.bundle. It is located in different places depending on whether you are using Macintosh or Windows, and whether you are running a Single User or Server.

It is located in the Plugins folders of the Genie and Genie Server packages

Single User: /Applications/Genie/Genie.app/Contents/Plugins/HICOnline.bundle

Server: /Applications/Genie/Genie Server.app/Contents/Plugins/HICOnline.bundle

It is located in the Plugins folder of the Solo Applications and Server folders.

Single User: \Genie\Solo Application\Plugins\HICOnline.bundle

Server: \Genie\Server\Plugins\HICOnline.bundle

You should be using at least version 2.3.5.0 of this plug-in. To see which version you are using on Macintosh, click on the HICOnline.bundle file and choose Get Info from the File menu. On Windows,  drill down within the plugin through the Contents folder into the Windows folder (HICOnline.bundle\Contents\Windows), right-click on the HICOnline.4DX file and select Properties from the drop-down list. Click on the Version tab. The File version is displayed at the top.

If you are using a version less than 2.3.5.0, you should update your Genie software (from the Special menu in Genie or from the download on the Genie website).

Java Files (Windows Only)

The HICOnline installation process creates a number of Java-related files on your PC. These are located in two places as follows:

Genie\HICOnline\Lib

Note: If you are using Java Runtime Environment version 1.3.1, the following files must also be located in the Genie\HICOnline\Lib folder:

Genie\HICOnline\LogicPack

If any of these files are missing, you should re-run the HIC_Online_Installer.exe program for the type appropriate to your installation, i.e. Single User or Transmitting Client.

HICOL_LIB_PATH (Windows Only)

The HICOL_LIB_PATH environment variable tells HIC Online where to find the jar files above. This variable is set automatically by Genie, however it can be overridden if necessary.

If it has not been correctly set, you will get the following error:

To set the HICOL_LIB_PATH manually follow these steps:

2. Go to the Advanced tab

3. Click on the Environment Variables button

4. Look for the HICOL_LIB_PATH variable in the System Variables pane at the lower half of the window

5. If the HICOL_LIB_PATH variable exists highlight it and click the Edit button, otherwise click the New button and enter HICOL_LIB_PATH in the Variable Name field

6. Enter the location of the HICOnline Lib folder into the Variable Value field, e.g. C:\MySpecialLocation\HICOnline\Lib\

7. Click the OK button (a total of three times) to close each of the windows

DLL Files (Windows Only)

The HIC Online installation process creates four DLL files, EasyClaimC.dll, pthreadVC.dll, PsiCore.dll and PsiJNI.dll. All of these files are placed in the Genie\HICOnline\Bin folder.

If any of these files are missing, you should rerun the HIC_Online_Installer.exe program for the type appropriate to your installation, i.e. Single User or Transmitting Client.

Frameworks (Macintosh Only)

The HIC Online installation process creates two framework folders:

These folders contain a number of files and folders required for correct operation of HIC Online. Both of these folders are created in the Frameworks folder in the Library folder at the root of the hard drive. If either of these framework folders is missing, you should rerun the HIC_Online_Installer program.