INPRISE CORPORATION

VisiBroker for Java 3.3 Release Notes

[03.03.00.C3.02]

Table of Contents

Release Contents
Changes Since 3.2
Known Issues
Platform Notes
Compatibility Notes
Additional Notes

Release Contents

VisiBroker for Java 3.3 consists of:

Support for SSL over IIOP is available as a separate add-on product, VisiBroker SSL Pack for Java.  In addition, although the VisiBroker Gatekeeper is packaged with the ORB, it is sold separately and requires a license key during installation that enables it.   You can determine if any product component is licensed during the installation process, or by using vbver, as shown below.


Changes Since 3.2

VisiBroker for Java 3.3 contains bug fixes and enhancements over the last release, as indicated below.  It is very important that this section be read carefully since the changes in this release affect all developers.

Upgrading from 3.2

VisiBroker for Java 3.3 is binary compatible with VisiBroker for Java 3.2. It will not be necessary to recompile existing code.  When upgrading from VisiBroker for Java 3.2, it is recommended that you remove previous installations of VisiBroker for Java 3.2 from your system.

<NEW>Enhancements and fixes in 3.3

The following is a brief outline and description of the changes in VisiBroker for Java 3.3.  Note: This list is not complete; if you have a question about a particular issue, please contact Inprise technical support.

Important notes

ORB runtime

GateKeeper

Compiler Tools


Known Issues

There are no new known issues for VisiBroker for Java 3.3.  The following issues have existed since VisiBroker for Java 3.0.


Platform Notes

Platform Certification

This release has been certified for the following browsers and Java Virtual Machines (JVMs):

In addition, this release has been certified with the following operating systems:

With the exception of the osagent, osfind, and locserv executables, the VisiBroker for Java ORB is written entirely in Java and can run in any Java 1.1-compatible environment.  For a complete list of Java-enabled platforms, click here.

Use with Netscape Communicator/Navigator 4.0

<NEW>Using VisiBroker with the Microsoft SDK

<NEW>Known Issues with Windows NT 3.51

VisiBroker for Java 3.3 runtime has been certified for Windows NT 3.51 with JDK version "1.0.2". Limitations exist when using VisiBroker with JDK 1.0.2. For a complete list, click here.

<NEW>Known Issues with HP-UX 10.20

VisiBroker for Java 3.3 has been certified for HP-UX 10.20 with JDK version "HP-UX Java C.01.15.03 07/07/98"

<NEW>Known Issues with AIX 4.1, 4.2

VisiBroker for Java 3.3 has been certified for AIX 4.1, 4.2 with JDK version "JDK 1.1.6 IBM build a116-19980711 "

<NEW>Known Issues with Digital Unix 4.0

VisiBroker for Java 3.3 has been certified for Digital Unix 4.0 with JDK version "JDK 1.1.6 digital:02/16/1998-19:32 "

<NEW>Known Issues with IRIX 6.2, 6.3, 6.4

VisiBroker for Java 3.3 has been certified for IRIX 6.2, 6.3, 6.4 with JDK version "3.1.1 (Sun JDK 1.1.6N) "


Compatibility notes

Compatibility with JDK 1.0.2

VisiBroker for Java 3.3 is also compatible with JVMs which are compatible with JDK 1.0.2 with the following restrictions:

<NEW>Compatibility with JDK 1.2 Beta 4

VisiBroker for Java 3.3 has been tested with JDK 1.2 Beta 4 from Sun Microsystems, but has not been officially certified on that VM.  Below are the list of known issues when using JDK 1.2:

Compatibility with other VisiBroker for Java Releases

Compatibility with VisiBroker for Java 2.5

Compatibility with VisiBroker for Java 1.2

Interoperability with other VisiBroker Releases

VisiBroker for Java 3.3 is fully interoperable with VisiBroker for C++ 3.x.  Communicating with VisiBroker for C++ 3.x requires no runtime flags.  VisiBroker for Java 3.3  is "on-the-wire" interoperable with:

As a result of clarifications in the original OMG IIOP specification, minor IIOP wire format changes have been necessary in VisiBroker for Java 3.0 and higher.  However, full backward compatibility is supported that enables client programs and servers running on VisiBroker for Java 3.x to interoperate with existing client programs and servers running on VisiBroker for Java 1.2/2.5 and VisiBroker for C++ 2.x. With this backward compatibility, in addition to 3.x-to-3.x communication, 3.x client programs can talk seamlessly to Java 1.2/2.5 and C++ 2.x servers, and Java 1.2/2.5 and C++ 2.x client programs can talk seamlessly to 3.x servers.

In environments where previous versions of VisiBroker for Java and VisiBroker for C++ are being used, it is necessary to enable backwards compatibility.  As described in the Programmer's Guide, to turn backwards compatibility on, the following runtime property (or Applet parameter) must be set to "true":

For example, to run the bank client example application on VisiBroker for Java 3.0 with backwards compatibility turned on, the following command would be used:

Or, the following line would be added to the applet tag of the ClientApplet.html file:


Additional notes

Printing Version Information

VisiBroker for Java 3.3 provides mechanisms for printing version information for the binaries and libraries included in this release.  In general use the executable vbver followed by the file to query version information.  For example vbver osagent.exe on Windows NT prints:

Similarly, vbver vbjorb.jar prints:

To obtain version information for the utilities (such as idl2java, irep, idl2ir, etc.), pass the -version argument to the utility.  For example, idl2java -version prints:

<NEW>Printing Licensing Information

To obtain licensing information on an installation, use the -type flag to vbver.  For example, for a licensed version of the ORB and Gatekeeper, vbver -type vbjorb.jar vbjgk.jar prints:

Information for:        vbjorb.jar
Product Name:           VisiBroker Developer for Java
Licensed to:            <Company Name>
Product Key:            <License Key>
Version:                03.03.00.C3.02

Copyright:              (C) 1996-98
Company:                Inprise Corp.
Build Date:             07/29/1998 12:34:31

Information for:        vbjgk.jar
Product Name:           VisiBroker Developer for Java
Licensed to:            <Company Name>
Product Key:            <License Key>
Version:                03.03.00.C3.02

Copyright:              (C) 1996-98
Company:                Inprise Corp.
Build Date:             07/29/1998 12:34:31

Alternatively, for an evaluation version, vbver -type vbjorb.jar vbjgk.jar prints:

Information for:        vbjorb.jar
Product Name:           VisiBroker Developer for Java
Version:                03.03.00.C3.02
Copyright:              (C) 1996-98
Company:                Inprise Corp.
Build Date:             07/29/1998 12:34:31
Expiration info:        60 days
Build Type:             Eval

Information for:        vbjgk.jar
Product Name:           VisiBroker Developer for Java
Version:                03.03.00.C3.02
Copyright:              (C) 1996-98
Company:                Inprise Corp.
Build Date:             07/29/1998 12:34:31
Expiration info:        60 days
Build Type:             Eval

Note that the version information that appears above may not exactly match your release.