# Java(tm) Communications API Read Me

Version 2.0

License

The Java(tm) communications API can be used to write platform-independent communications applications for technologies such as voice mail, fax, and smartcards. This download features API documentation in HTML format, reference implementations for the Solaris and Win32 platforms, and sample software.

This version of the Java communications API contains support for RS232 serial ports and IEEE 1284 parallel ports. With updated functionality, one can:

1. Enumerate ports available on the system.
2. Open and claim ownership of ports.
3. Resolve port ownership contention between
4. multiple applications.
5. Perform asynchronous and synchronous I/O on ports.
6. Receive Beans-style events describing communication port state changes.

Please note that the software included in this download has only been tested on JDK/JRE 1.1.5 and 1.1.6 systems. Limited testing has been done on a pre-release version of JDK 1.2, see link below. The Java communications API does not support unsigned applet access to ports.

Installation Instructions and Platform Specific notes
Java Communications API user's guide
Java Communications API FAQ
API changes between Early Access and Beta releases
Preliminary information on using the Java communications API with JDK 1.2
How ReceiveFraming, ReceiveThreshold, ReceiveTimeout, and InputBuffer interact

#### Documentation

Browse API Documentation included in this software bundle

Samples documentation:

- Simple
- BlackBox
- ParallelBlackBox
- SerialDemo
- NullDriver
- Porting the Java Communications API to other platforms

#### Year 2000 Compliance

The Java communications API is Option 1 year 2000 compliant. Sun defines Option 1 compliance as:

Option 1: all dates unambiguous

The Java communications API has no date related functionality and does not rely on the underlying operating system or JDK for date related functionality.

The JDK and the operating system on which the Java communications API run are being assessed separately for year 2000 compliance. For complete year 2000 confidence, check the compliance statement for each component in your system.

For more information on year 2000 compliance at Sun, see Sun's Year 2000 web site.

#### Further Questions

The Java Developer Connection(tm) (JDC) offers several avenues to answer questions about using the Java communications API, including discussion groups with other developers. You must register to use the JDC, but there is no charge for registration.

Copyright © 1997-1998 Sun Microsystems, Inc.
All Rights Reserved.