Welcome to Together

OS/2^® Information

SYSTEM REQUIREMENTS	JAVA VIRTUAL MACHINE	INSTALLATION	STARTUP	TROUBLESHOOTING
<< Go back to general readme

System Requirements for OS/2

CPU:	Pentium, 166MHz or faster	Recommended: Pentium, 233MHz; for large projects: Pentium-II, 300MHz or faster
Memory:	64 MB or more	Recommended: 96 MB; for large projects and running scripts: 128 MB
Hard disk space:	15 MB on HPFS partition; 15-33MB on FAT partition (depending on cluster size).	Not including the size of virtual machine Recommended: HPFS partition since Java uses long filenames.
Video:	SVGA, high color mode	Recommended screen resolution: 1024x768 or more
OS:	OS/2^® Warp 4.0 Merlin	Fix Pack 5 or later for OS/2 Warp 4 must be installed
Java VM or JDK:	(see Java VM info below)	Required to run Together
HTML browser - required to view and print online documentation and generated documentation.
CD-ROM drive or Internet connection - required for installation/download and information update.

Java™ Virtual machine (VM) information

Together has been tested on the following Java VMs under OS/2

IBM^® Java VM, Versions 1.1.4 and 1.1.6

ftp://ftp.hursley.ibm.com/pub/java/fixes/os2/11/116/

Installation

The installation process varies depending upon the product version and what variant of the installer you have obtained. For OS/2 Together has a pure-Java installer and command file.

**To install Together using the pure-Java Installer:**

You must have a Java VM already installed on your computer.
Start OS/2 command line window.
Run installation command file: install_os2.cmd. This file may require corrections in accordance to your environment (see Troubleshooting).

readme

Choose the destination directory.
Checking "Create program folders", you can place links to start Together program and project templates to your desktop. Note that creation is performed only when you run install_os2.cmd.

Start-up

To run Together:

If during the installation you've checked the "Create program folders" option, open the Together folder and open (double-click) the Together object.
If not, go to Together\bin subdirectory and execute Together.cmd.

Now Together.cmd looks like:

java -classpath ..\classes;..\lib\together.zip;..\lib\jbcl.zip;..\lib\jgl.zip;..\lib\gifs.zip;..\lib\jacl.jar;%CLASSPATH%; oisoft.together.Main %1 %2 %3

It uses %CLASSPATH% variable, which is defined in CONFIG.SYS. The standard Java classes should be located on this path.
If you have missing or incorrect CLASSPATH, correct the variable in CONFIG.SYS, or define it directly in Together.cmd file.

After startup:

Choose File | New Project... to create a new Together project, or File | Open Project... to open an existing project.
To work with existing source code, create the project in a directory, which contains source files (directly or in its subdirectories).
You can begin your work using Samples template of the Together program folder.

For more information, see the Getting Started part of the Help.

Troubleshooting

In case of any problems, refer to faq.html file where you'll find answers to many questions including installation, start-up and VM-specific issues.

During the installation, assuming all path variables are properly specified, you need only type "java together". If JVM reports "class not found" error, then you have no CLASSPATH variable in CONFIG.SYS. In such a case, you need type (assuming that Java is installed in d:\Java11):

java -classpath d:\Java11\lib\classes.zip; together

Problems can also occur if any of the following paths are missing in the CONFIG.SYS file (in the root of OS/2 boot drive):

path to java.exe in the PATH variable
path to Java 1.1.4. dll-s in the LIBPATH variable
path to classes.zip file from JDK 1.1.4. in the CLASSPATH variable.

All these variables are properly tuned by the JDK 1.1.4. installation. If you encounter a problem, you should check that there are no paths to JavaOS2 (JDK 1.0.2) in these variables, and that paths to Java1.1 (JDK 1.1.4) are present. Here are some sample lines from CONFIG.SYS (leaving only Java paths):

        LIBPATH=F:\NETSCAPE;D:\Java11\Dll;.;
       SET PATH=F:\NETSCAPE;D:\Java11\Bin;D:\Java11\ICATJAVA\Bin;
       SET DPATH=D;\JAVA11\ICATJAVA\HELP;
       SET CLASSPATH=D:\JAVA11\LIB\classes.zip;.\.

Note: To apply changes in CONFIG.SYS you must reboot your OS/2.

SYSTEM REQUIREMENTS JAVA VIRTUAL MACHINE INSTALLATION STARTUP TROUBLESHOOTING