Java(tm) Communications Driver for OS/2 Warp Readme and Installation Instructions

Version 2.0
Shawn Terry
Aquila Systems, Inc.
Sun MicroSystems, Inc.

Introduction

Enclosed in this package is the Aquila Systems OS/2 Warp driver for Sun's javax.comm API's. This package must be used with the jcommapi.zip package contained within it. The jcommapi.zip package contains the complete and unmodified javax.comm communications API's from Sun MicroSystems. They are being re-distributed under item 1 of their supplemental licensing terms. The OS/2 driver works with Sun's javax.comm package to implement the javax.comm API on IBM's OS/2 Warp operating system. Please note all the Aquila Systems files are in the directory you unpacked this archive into and all of Sun's file are put in the commapi directory. The Aquila Systems portions are offered on an AS-IS basis and may be distributed complete and unmodified. We provide no warrantee either express or implied on the functionality, reliability, or suitability of this package. The Sun MicroSystems portions are subject to their licensing.

These API's are intended to be the standard JAVA API's for access to a wide variety of hardware interface port types. JAVA applications written to this API can access ports in a cross platform manner. This package provides a full implementation of this standard for serial communications ports under OS/2 Warp. By providing a full implementation it is hoped that a wide variety of JAVA based Communication applications can be run unmodified under OS/2 Warp. We hope this package will extend the depth and enjoyment for OS/2 users as communications has always been one of the most popular uses for OS/2. This package is currently a beta and bug reports as well as JAVA application functionality notifications would be appreciated.

Please send bug reports or notifications to: javacomm@aquilasys.com

Web site: www.aquilasys.com click on javax.comm link in the menu.


System Requirements:



Installation

If you are reading this you have probably already unzipped the archive to a directory. If not create a new directory and unzip this archive into it.
Note: You must use unzip.exe from Info-Zip not pkunzip. If you do not already have this goto the web site listed above.
Once you have unzipped this into a directory referred to below as xdir on drive X then follow the instructions below:
  1. Read the licensing agreement for the Sun MicroSystems jcommapi.zip file, COMM2.0_license.txt. If you agree to the terms then proceed.
  2. Open an OS/2 command prompt change to the X drive and xdir directory and type unzip jcommapi to unzip Sun's javax.comm API.
  3. Add X:\xdir to the end of the LIBPATH= statement in the config.sys file. You can alternately copy X:\xdir\os2serpt.dll to the \JAVA11\DLL directory.
  4. Add X:\xdir\commapi\comm.jar;X:\xdir\os2comm.jar to end of the SET CLASSPATH= statement in the config.sys file.
  5. Copy the file X:\xdir\javax.comm.properties to the Y:\JAVA11\LIB directory (where Y is the drive the JAVA VM is installed on).
  6. Restart your OS/2 Workstation

It is now ready to use any JAVA comm program that utilizes the javax.comm API. This package includes some sample applications written by Sun see below.


Documentation

The Sun readme file contains documentation on the API's for developers and information about the provided sample programs.

Notes

As mentioned previously we have tried to provide a full implementation that is as bug free as possible. We believe this is very important with an API driver since a large number of different programs will be used with it. If we did not implement certain portions of the API or if it was buggy it would very adversely affect programs that use it. To that end we have implemented all the functionality of the API except for the framing mode and device sharing (see below). We hope to here from you regarding applications you have successfully or unsuccessfully used with it and on any other bugs. We will post on our web site a list of the known applications that use javax.comm and their status.


Support

We do not offer free formal support to users attempting to utilize this package. On an informal basis we will try to answer questions and address issues with no guarantees on response or resolution timeframes. We will also post the newest release on our web site available for download.

For organizations and developers who want formal support, source code, development assistance, or custom feature development we do offer these services on a fee basis. The fees will be quoted depending on the request.

Email support: javacomm@aquilasys.com


Copyright © 1998, 1999 Aquila Systems Inc. , Sun Microsystems, Inc.
All Rights Reserved.