===========================================================================

                          VisualAge for Java
                             Version 3.0
                                   
                               Examples

                            RELEASE NOTES

===========================================================================

Table of Contents

1.0 Introduction
2.0 Loading Projects
3.0 Visual Composition Editor Examples
   3.1 Running the Visual Composition Editor Examples

4.0 Getting Started Examples
5.0 Towers of Hanoi
6.0 Sun BDK Examples
   6.1 Adding Sun BDK Beans to the Visual Composition 
       Editor Pallet
   6.2 Known Problems with the Sun BDK Examples
       6.2.1 Adding Beans to Sun's BeanBox Demo
       6.2.2 BridgeTester Bean

7.0 Sun JDK Examples
   7.1 Running the Sun JDK Examples
   7.2 Known Problems with the Sun JDK Examples
       7.2.1 Sun JDK Animator
       7.2.2 Sun JDK Clock
       7.2.3 Sun JDK DrawTest
       7.2.4 Sun JDK SymbolTest

8.0 Sun JFC Examples
   8.1 Running the Sun JFC Examples

9.0 Awt Examples
   9.1 Running the Awt Examples


1.0 Introduction

VisualAge for Java 3.0 ships with example applications and
applets to help you start exploring VisualAge.

The examples fall into six categories:

   Visual Composition Editor Examples
   Getting Started Examples
   Towers of Hanoi
   Sun BDK Examples
   Sun JDK Examples
   Awt Examples

Each of the example categories will be covered in the following
sections.


2.0 Loading Features

The examples are contained in various features. Use the following
steps to load a feature from the repository into your workspace:

  1)  Select a Workbench.
  2)  Select "Quick Start" from the file menu.
  3)  In the list on the left, select "Features".
  4)  In the list on the right, select, "Add Feature".
  5)  Select the example you want to load.
  6)  Press the "OK" button when you have selected all the
      features you wish to load.

For detailed explanations of the features, the repository, the workspace
and how to manipulate projects please consult the printed or on-line
documentation.


3.0 Visual Composition Editor Examples

The Visual Composition Editor Examples are contained in the IBM Java
Examples project.  The examples show complete working applets and
applications constructed using the Visual Composition Editor.

If the IBM Java Examples project is not visible in the "Projects" tab
of your Workbench you must load the project from the repository using
the steps described in section 2.0 of this release note.

Each Visual Composition Editor Example is contained in its own
package in the IBM Java Examples project.  Not all the packages in
the IBM Java Examples project are Visual Composition Editor examples.
These other packages will be covered later in this release note.

The Visual Composition Editor Example packages are:

   com.ibm.ivj.examples.vc.bookmarklist
   com.ibm.ivj.examples.vc.customerinfo
   com.ibm.ivj.examples.vc.layoutmanagers
   com.ibm.ivj.examples.vc.mortgageamortizer
   com.ibm.ivj.examples.vc.popupmenuexample
   com.ibm.ivj.examples.vc.propertyeditors
   com.ibm.ivj.examples.vc.todolist
   com.ibm.ivj.examples.vc.utilitybeans
   com.ibm.ivj.examples.vc.swing.actionexample
   com.ibm.ivj.examples.vc.swing.bookmarklist
   com.ibm.ivj.examples.vc.swing.directoryexplorer
   com.ibm.ivj.examples.vc.swing.layoutmanagers
   com.ibm.ivj.examples.vc.swing.mortgageamortizer


3.1 Running the Visual Composition Editor Examples

Each package comment describes what the example does and also
describes the steps to run the example.  To view a package comment:

  1)  Select a Workbench.
  2)  Select the "Projects" tab.
  3)  Select a project.  The text pane in the Workbench will
      display the project comment.
  4)  If the project is collapsed expand it by double
      clicking the project name.
  5)  Select a package.  The text pane in the Workbench will
      display the package comment.


4.0 Getting Started Examples

The Getting Started Examples are meant to be used hand in hand with
either the printed or on-line version of the IBM VisualAge For Java
Getting Started book.

The Getting Started Examples are contained in the IBM Java
Examples project in the packages:

  com.ibm.ivj.examples.vc.todofile
  com.ibm.ivj.examples.vc.todolist

For instructions on how to load and work with these examples please
see the IBM VisualAge for Java Getting Started book.


5.0 Towers of Hanoi

The Towers of Hanoi example shows both a graphical applet and a
textual application that recursively solves the classic Towers of
Hanoi puzzle.

The Towers of Hanoi example is contained in the IBM Java Examples
project.  For instructions on how to load this project see section
2.0 of this release note.

The Towers of Hanoi example is contained in the package:

  com.ibm.ivj.examples.hanoi.

The package comments describe how to run the example.  For
instructions on viewing package comments please see section 3.1 of
this release note.


6.0 Sun BDK Examples

The Sun BDK Examples are examples that Javasoft ships with their Sun
BDK.

To load the Sun BDK Examples project follow the steps in section 2.0
of this release note.

The Sun BDK Examples contain beans that you use in the Visual
Composition Editor to build applets, applications and beans of your
own.
  

6.1 Adding Sun BDK Beans to the 
    Visual Composition Editor Palette

Before you can use imported beans in the Visual Composition Editor
the beans must be added to the palette.  Adding beans to the pallet is
covered in detail in the VisualAge documentation.


6.2 Known Problems with the Sun BDK Examples


6.2.1  Adding Beans to Sun's BeanBox Demo

If you want to add beans to the Sun BeanBox you must copy the *.jar
files for the beans to the directory:

   \<ibmvjava>\ide\project_resources\jars

Where <ibmvjava> is the directory where you installed IBM VisualAge
for Java.  

You must also import the *.jar files into IBM VisualAge for Java
before trying to run the new beans from the Sun BeanBox.  Detailed
instructions for importing *.jar can be found in the IBM VisualAge
for Java documentation.

6.2.2 BridgeTester Bean

We do not ship the BridgeTester Bean that ships with Sun BDK.
This bean exposes a bug in Sun's java.beans package.


7.0 Sun JDK Examples

The Sun JDK Examples are examples that are shipped with Sun JDK 1.1.7A.

Each Sun JDK Example is contained in its own project.  You can use
the steps in section 2.0 of this release note to load the examples
you are interested in.

For detailed instructions on what each example does please see the
Sun JDK 1.1.7A documentation available on their web page.

The following Sun JDK example projects in the VisualAge repository:

  Sun JDK Animator
  Sun JDK ArcTest
  Sun JDK BarChart
  Sun JDK Blink
  Sun JDK CardTest
  Sun JDK Clock
  Sun JDK DitherTest
  Sun JDK DrawTest
  Sun JDK Fractal
  Sun JDK Gauge
  Sun JDK GraphicsTest
  Sun JDK GraphLayout
  Sun JDK i18n code
  Sun JDK ImageMap
  Sun JDK JumpingBox
  Sun JDK MoleculeViewer
  Sun JDK NervousText
  Sun JDK OpenlookButtons
  Sun JDK RoundButtons
  Sun JDK SimpleGraph
  Sun JDK SortDemo
  Sun JDK Spinner
  Sun JDK SpreadSheet
  Sun JDK SymbolTest
  Sun JDK TicTacToe
  Sun JDK WireFrame


7.1 Running the Sun JDK Examples

Once a Sun JDK Example project is loaded you can run the applet using
the following steps:

  1)  Open a Workbench.
  2)  Select the "Projects" tab.
  3)  Select the example project you wish to run.
  4)  Press the "Run" button on the Workbench toolbar.
  5)  Some examples are both applets and applications 
      (i.e. they have main). By default VisualAge
      will run these as applets. To run them as applications
      choose Run -> main()from the popup menu of the project.


7.2 Known Problems with the Sun JDK Examples


7.2.1 Sun JDK Animator

If you select the restart option from the applet viewer menu while
animator is running errors will be displayed on the Console.  The
same behavior is present when this example is run under Sun JDK 1.1.7A

Due to problems with the way the Animator example is written you may
experience a deadlock condition if you run a large number of
Animators.  The Sun JDK 1.1.7A experiences the same problem.


7.2.2 Sun JDK Clock

The graphical time display will show the current system time but the
textual time may be incorrect.


7.2.3 Sun JDK DrawTest

If you are running IBM VisualAge for Java in Windows 95/98/NT
and are using 256 colors then the fourth radio button from the left
will not draw with the displayed color.  This is a known problem that
has to do with the way Windows allocates colors.  The problem does
not appear if you have a higher color resolution or if you are running IBM
VisualAge for Java under OS/2.


7.2.4 Sun JDK SymbolTest

The symbols will not be displayed.  Instead you will see the escape
codes for the symbols.  This is a known problem.


8.0 Sun JFC Examples

The Sun JFC Examples are examples that Sun ships with their 
JFC 1.0.3.

Each Sun JFC Example is contained in its own project.  You can use
the steps in section 2.0 of this release note to load the examples
you are interested in.

For detailed instructions on what each example does please see the
Sun JFC 1.0.3 documentation available on their web page.

The following Sun JFC example projects in the VisualAge repository:

  Sun JFC DBDemos
  Sun JFC FileChooserDemo
  Sun JFC Metalworks
  Sun JFC Notepad
  Sun JFC SampleTree
  Sun JFC Simple
  Sun JFC Stylepad
  Sun JFC SwingApplet
  Sun JFC SwingSet
  Sun JFC Table


8.1 Running the Sun JFC Examples

Once a Sun JFC Example project is loaded you can run the applet using
the following steps:

  1)  Open a Workbench.
  2)  Select the "Projects" tab.
  3)  Select the example project you wish to run.
  4)  Press the "Run" button on the Workbench toolbar.
  5)  Some examples are both applets and applications 
      (i.e. they have main). By default VisualAge
      will run these as applets. To run them as applications
      choose Run -> main()from the popup menu of the project.


9.0 Awt Examples

The Awt Examples are detailed test cases for the Java Awt classes.
The Awt Examples are contained in the IBM Java Examples project.  To
load this project follow the steps in section 2.0 of this release
note.

The packages that comprise the Awt tests are:
  com.ibm.ivj.examples.awttestframework
  com.ibm.ivj.examples.awttestlauncher
  com.ibm.ivj.examples.awttests

9.1 Running the Awt Examples

Follow these steps to run the Awt Examples:

  1)  Open a Workbench.
  2)  Select the "Projects" tab.
  3)  Select the IBM Java Examples project.
  4)  Press the "Run" button on the Workbench toolbar. 
  5)  Some examples are both applets and applications 
      (i.e. they have main). By default VisualAge
      will run these as applets. To run them as applications
      choose Run -> main()from the popup menu of the project.
  6)  The AwtExampleLauncher will start.  Select one or more
      examples from the list and press the "Execute"
      button.  The example will run.

