Welcome to Simplicity for Palm OS Platform
PLEASE READ THIS CAREFULLY FOR IMPORTANT INSTALLATION NOTES
Last updated : January 4, 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
- The installer is called simppalm.exe. Double click
this file to begin the installation.
- 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
- 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.
- 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.
- We highly recommend having at least 64 MB of RAM installed
to use Simplicity for Palm OS Platform on the Macintosh.
- 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.
OS/2 Warp
- The installation must be performed on an HPFS drive.
- We recommend using jdk1.1.8 from IBM. This is part of IBM's
Software Choice package.
- The distribution for OS/2 is called simppalm.zip. Unzip
this file using an unzip utility, being careful to maintain the directory
structure.
- 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.
- 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.
Linux
- Be certain to use the latest revision of the JDK from
www.blackdown.org, Sun,
or IBM.
- 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
- 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.
- 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
- 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
- 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.
- 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.
- 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.