3. Starting Jaikoz

3.1. General Startup Instructions

You can start Jaikoz using the shortcut that should have been created in your Start Menu Jaikoz.exe. Alternatively you can start Jaikoz using the batch file jaikoz.bat

If everything is ok there will be a short delay whilst Jaikoz initialises and then it should start.

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.2. Java Problems

This section discusses problems starting Jaikoz due to problems with your Java configuration

Java is not recognized as an internal or external command,operable program or batch file..

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

Unable to load helpset

There is a problem with your JRE Installation. Please ensure that Java is installed and can be found in your path

3.3. Licensing Problems

Once installed the license is held in the Jaikoz folder in your home directory, for example C:\Documents and Settings\paul\license.jai

3.3.1. No License Installed

If you start Jaikoz and it cannot find your license you will see this dialog

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.3.2. Expired Trial License

If you start Jaikoz and your trial license has expired you will see this dialog

The trial license is supplied at no cost for a period of 30 days from date of issue. Thereafter, the application is disabled and a permanent license must be purchased in order to use the application.

If you wish to purchase a license go to the Website and purchase, then install in the usual way

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.3.3. Corrupted License

If you start Jaikoz and there is a problem with your license you will see this dialog

Your license has been corrupted,retrieve the original license and reinstall it in the usual way

Select Path to Open a File Dialog and find the license file that you should have recieved by email (license.jai) and select Open. Then select OK to verify the license.

If the license is verified Jaikoz will start

3.4. Uninstalling Jaikoz

Run Uninstall Jaikoz from your Start menu If you wish to completely remove the application folder and any work saved in it, you will have to delete this folder manually.

3.5. Memory Management

Warning this section is for experienced users of Java only

By default Jaikoz allows upto 300MB to be used for storing the information about your loaded files, this is additional to about 100MB that is required to run Jaikoz. If you are attempting to load many audio files (more than 10,000) you may get a warning that memory is low, if your computer has sufficient memory you can increase the maximum value of memory than can be used you will be able to load larger amount of files if you require it. You should not set the memory to the actual amount that your system has because your computer requires some memory to run the operating system and other programs, additionally trying to load too many files may place too high a CPU load on your computer and could severely effect performance.

Usually Jaikoz is run using Jaikoz.exe, but you can also run it using Jaikoz.bat. If you hide extensions within File Explorer both files will be listed as Jaikoz, but Jaikoz.exe will have the Jaikoz Insect icon and have type of Application and Jaikoz.bat will have a DOS icon and a type of MS-DOS Batch File. Memory is adjusted differently depending on which file you use.

3.5.1. Jaikoz.exe

Find the Jaikoz.exe shortcut in your Start menu,right click and select 'Properties'

Edit the value in target using the -JmaxHeap parameter. For example if the target field currently contains C:\Program Files\Jthink\Jaikoz\jaikoz.exe", change to C:\Program Files\Jthink\Jaikoz\jaikoz.exe" -Jmaxheap=512000000 sets the max memory to 512 megabytes.

3.5.2. Jaikoz.bat

Within the Jaikoz.bat file , the line parameter-Xmx300m sets the max memory in megabytes, adjust this value and run Jaikoz.bat for it to take effect

3.6. Logging

Jaikoz uses two log files, jaikozuser0-0.log contains the same information as is written to the Console Panel, it contains general information about what you've done within Jaikoz. The jaikozdebug0-0.log file contains warnings and debugging information that helps diagnose problems when running Jaikoz. These files are held in the Jaikoz folder in your home directory, for example C:\Documents and Settings\paul\Jaikoz\Logs and are renamed when they get to a certain size, the latest file is always called jaikozuser0-0.log, the next most recent is called jaikozuser0-1.log. if you require support with Jaikoz it is important to send both types of log files, to help diagnose the problem. The amount of logging written to the jaikozdebug0-0.log file can be adjusted, if you have a problem that you can reproduce it would be helpful if you could increase the amount of information logged, recreate the problem, send the logs and then return the logging to the normal levels.

The following parameters effect Jaikozes logging

-l2 -m2

The -l2 parameter specifies how much logging output should be generated by Jaikoz, the -m2 parameter specfies how much output should be generated when reading and writing files. The number 2 can be replaced by any value from 1 to 7, a value of 1 is the minimum and a value of 7 is the maximum. Setting a high value will noticeably slow the performance of Jaikoz, so changes should only be made temporarily to diagnose a problem.

Usually Jaikoz is run using Jaikoz.exe, but you can also run it using Jaikoz.bat. If you hide extensions within File Explorer both files will be listed as Jaikoz, but Jaikoz.exe will have a Insect icon and have type of Application and Jaikoz.bat will have a DOS icon and a type of MS-DOS Batch File. Logging is adjusted differently depending on which file you use.

3.6.1. Jaikoz.exe

Find the Jaikoz.exe shortcut in your Start menu,right click and select 'Properties'

Edit the value in target using the -l and -m parameters. For example if the target field currently contains C:\Program Files\Jthink\Jaikoz\jaikoz.exe", change to C:\Program Files\Jthink\Jaikoz\jaikoz.exe" -l7 -m7 sets the maximum amont of logging.

3.6.2. Jaikoz.bat

Within the Jaikoz.bat file , the parameters-l2 -m2 -f sets the logging, adjust this value and run Jaikoz.bat for it to take effect