Welcome to Simplicity for Palm OS Platform

PLEASE READ THIS CAREFULLY FOR IMPORTANT INSTALLATION NOTES

Last updated : January 8, 2001

Installation notes

 NOTE: Before beginning the install, you must have installed a JDK1.3 or greater on your computer. This must be a full JDK; a JRE is not enough. If you have any problems with the installation, please send an email to:
support@datarepresentations.com.

Platform-specific notes

Windows 95/98/NT

  1. The installer is called simppalm.exe. Double click this file to begin the installation.
  2. A 'Simplicity for Palm OS Platform' item will be added to your Start menu. Start Simplicity for Palm OS Platform using this Start menu item.

Mac OS
  1. There is not currently a full version of JDK 1.3 available for the Macintosh. It is possible to use most of the functionality in Simplicity for Palm OS Platform by using MRJ 2.1.4.
  2. Macintosh users must first install the MRJ 2.1.4 available from http://developer.apple.com/java/download.html. There are problems with MRJ 2.2.x at the present time.
  3. We highly recommend having at least 64 MB of RAM installed to use Simplicity for Palm OS Platform on the Macintosh.
  4. The installer will create an icon called 'Simplicity for Palm OS Platform' in the directory you choose for the installation. Use this icon to start Simplicity for Palm OS Platform.
  5. Simplicity for Palm OS Platform requires JDK 1.3 for compiling and building applications. Macintosh users will be able to use the composer environment, but will need to use another platform to compile source code.

OS/2 Warp
  1. The installation must be performed on an HPFS drive.
  2. We recommend using jdk1.1.8 from IBM. This is part of IBM's Software Choice package.
  3. The distribution for OS/2 is called simppalm.zip. Unzip this file using an unzip utility, being careful to maintain the directory structure.
  4. OS/2 users using jdk118 may wish to execute the simpwps.cmd file. This REXX script will create a WPS object on the OS/2 desktop for starting Simplicity.
  5. The debugger needs to have the localhost interface enabled. You can do this by typing the following command in an OS/2 window:
    ifconfig lo 127.0.0.1 up
    Note that this will be reset when you next reboot your computer.
  6. Simplicity for Palm OS Platform requires JDK 1.3 for compiling and building applications. The composer environment will work with JDK 1.1.8, but users will need to use JDK 1.3 to compile source code.

Linux
  1. Be certain to use the latest revision of the JDK from www.blackdown.org, Sun, or IBM.
  2. The distribution for Linux is a .tar.gz file, named simppalm.tar.gz. To install, copy the distribution to your user directory and execute the following commands to unpack the archive:
    gzip -d simppalm.tar.gz
    tar -xf simppalm.tar
  3. In the resulting directory is a script called 'SimplicityPalm'. You need to edit the two variables in the file which correspond to the location of the java executable on your machine and the location of the Simplicity install directory.
  4. Set the script to be executable (using the chmod command.) You can start Simplicity for Palm OS Platform by typing "./SimplicityPalm" in this directory. This file can be moved to your $HOME/bin directory if you wish.

Solaris / Other Unix
  1. The distribution is a .tar.gz file, named simppalm.tar.gz. To install, copy the distribution to your user directory and execute the following commands to unpack the archive:
    gzip -d simppalm.tar.gz
    tar -xf simppalm.tar
  2. In the resulting directory is a script called 'SimplicityPalm'. You need to edit the two variables in the file which correspond to the location of the java executable on your machine and the location of the Simplicity install directory. You may also need to edit the first line of the script to use ksh.
  3. Set the script to be executable (using the chmod command.) You can start Simplicity for Palm OS Platform by typing "./SimplicityPalm" in this directory. This file can be moved to your $HOME/bin directory if you wish.
  4. On some Solaris machines, Simplicity for Palm OS Platform will stall shortly after starting. This can be fixed by disabling the JIT. To do this, edit the lines defining the JIT variable in the startup script.

Startup Customization

On most OS's, the installer will create a startup script from which Simplicity can be invoked.

You also may wish to start Simplicity for Palm OS Platform manually. To do so, make sure that your CLASSPATH environment variable includes only simplicitypos.jar.

For example, on Windows 95,

set CLASSPATH=C:\SimplicityPalmOS\simplicitypos.jar;

On Linux,

$SIMPLICITY=/home/user/SimplicityPalmOS
export CLASSPATH=$SIMPLICITY/simplicitypos.jar:

Simplicity is started using the following command:
java -mx100m datarep.Simplicity

Documentation

The Simplicity for Palm OS Platform manual and tutorials are provided in two formats. The first is HTML, which can be found in the doc directory. It can be viewed with any browser directly, or from the Help menu in the Simplicity IDE. The documentation and tutorials are also provided in Adobe Acrobat format, suitable for printing. This file can be found in Simplicity's installation directory, called SimplicityPalmOS.pdf.

In addition, java documentation can be found in the javadoc directory.