-C H A P T E R

C H A P T E R 3

Installation

This chapter contains the following topics:

Installation Locations

Installing Sun 3270 Pathway

Installation Locations

Install Sun 3270 Pathway on your development machine. Later, if you need to deploy a Java applet to use Sun 3270 Pathway, you can also install it on the web server machine from which that applet is served.

After you install Sun 3270 Pathway, the following structure is created:

/3270_Pathway2.0.0 /3270_Pathway2.0.0/bin /3270_Pathway2.0.0/doc /3270_Pathway2.0.0/doc/com /3270_Pathway2.0.0/doc/com/sun /3270_Pathway2.0.0/doc/com/sun/emp /3270_Pathway2.0.0/doc/com/sun/emp/pathway /3270_Pathway2.0.0/doc/com/sun/emp/pathway/bean /3270_Pathway2.0.0/etc /3270_Pathway2.0.0/JRE(Only with the InstallShield packaged products)
/3270_Pathway2.0.0/lib /3270_Pathway2.0.0/samples /3270_Pathway2.0.0/samples/bean /3270_Pathway2.0.0/samples/recorder

This document refers to the top level directory as INSTROOT, which is
/3270_Pathway2.0.0 in this example.

The Java Archive (JAR) files that contain the Sun 3270 Pathway products are shipped in the INSTROOT/lib subdirectory:

INSTROOT/lib/pathway_bean.jar contains the Sun 3270 Pathway Bean.

INSTROOT/lib/pathway_recorder.jar contains the Sun 3270 Pathway Navigation Recorder.

INSTROOT/lib/pathway_router.jar contains the Sun 3270 Pathway Router.

INSTROOT/lib/pathway_terminal.jar contains the Pathway Terminal.

Caution - Do not unpack the JAR files. They work as single files and do not require unpacking.

The HTML API documentation for programming the Sun 3270 Pathway Bean is located in the following directory:

INSTROOT/doc/index.html

Installing Sun 3270 Pathway

This section describes how to install Sun 3270 Pathway on UNIX and Microsoft Windows platforms.

If you use Microsoft Windows, Sun 3270 Pathway is available as an InstallShield executable. This executable contains a 1.4 version of the JRE along with Sun 3270 Pathway.

The InstallShield installation process creates a program group and other associated entries on your Start menu.

Note - The InstallShield version of Sun 3270 Pathway does not contain a Java compiler. If you want Sun 3270 Pathway to compile the source code classes it creates, you must ensure that the Java compiler, javac, is in your path before you start Sun 3270 Pathway.

You can obtain the javac compiler by downloading the JDK from http://java.sun.com. If you are using an IDE, a copy of javac might already exist on your system.

To Install Sun 3270 Pathway on Solaris and UNIX Systems

1. Locate the *.zip file that contains the Sun 3270 Pathway software.

2. Uncompress the archive under an appropriate directory.

Refer to the ZIP(1) man page for information about command options.

To Install Sun 3270 Pathway on Microsoft Windows Systems

1. Locate the *.exe file that contains the Sun 3270 Pathway software.

2. Start the installation using either method:

Double-click the .exe file.

On the desktop, select Start Run, type the name of the Sun 3270 Pathway executable, and click OK.

3. Follow the on-screen directions to complete the installation, making sure to select the desired installation location.

After the installation is finished, you can use the Sun 3270 Pathway software.