JShift Component Conversion Utility v0.5.
JShift Technologies
http://www.jshift.com
113 St. Mark's Place, Suite 1W
New York, NY  10009
fax: 801-705-1989
info@jshift.com


installation
-------------
1. Install JRE1.4 (http://java.sun.com/j2se/1.4) or above.
2. For Windows, just execute setup.exe.  Otherwise, continue with step 3.
3. Ensure that the directory containing 'java.exe' (and 'javaw.exe') is in the PATH environment variable.
4. Manually copy the contents of the ZIP file to some directory.  If desired, setup.exe can be excluded to save space.


startup
-------
In Windows, an icon should be added to the start menu.  If feeling 'old school' or using another OS, just execute

java -cp <JAR file location> com.jshift.ccu.WorkAreaController [filename]

from the command line.  Replace <JAR file location> with the path of the downloaded JAR file, of course.  Also, be sure to execute java.exe from within the directory you unzipped to (so that the CCU can locate the 'bin' directory).  If your environment is setup to run executable jar files, double-clicking 'ccu.jar' should start the program as well.


external classes
----------------
If you plan on creating Java classes that extend existing custom classes, make sure that the superclasses are included in your classpath as well: 

java -cp <JAR file location>;%CLASSPATH% com.jshift.ccu.WorkAreaController [filename]

If you wish to import from or export to a database, ensure that your JDBC drivers are included in the classpath.  Lastly, if your CLASSPATH is quoted (in order to accommodate directories with spaces in them), ccu.bat may claim to be unable to find a class.  This is because "ccu.jar;%CLASSPATH%" evaluates to a classpath with a quote in the middle.  Try manually editing ccu.bat and remove the '-cp' (and its associated parameter).  You'll then need to put the JAR file in your CLASSPATH manually.  With the Windows installation, external libraries placed in the 'lib' directory are automatically added to the classpath.


usage
-----
Once you're up and running, create a new project (File >> New) and insert entities (Tools >> Insert >> Entity) and attributes (Tools >> Insert >> Attribute) as necessary.  Alternatively, you can import elements from a database with the 'Import' & 'JDBC...' buttons.


troubleshooting
---------------
If the CCU will not start using the above methods, try to run 'ccu.exe' or 'ccu.bat'.  If this fails, activate 'check_jvm.exe' in order to verify that the JVM is found.  When running 'ccu.exe', JVM parameters can be specified with "-J[VM parameter]" (e.g. -J-Xmx512m).  If difficulties occur in transferring project files from one computer to another, be certain that identical versions of the CCU are in use; the application build time can be found at the end of this file.

Built on 07/27/2003 10:51 PM.