Sun Logo


Sun 3270 Pathway User's Guide

Release 2.0

816-5340-11



Contents

Figures

Tables

Preface

How This Book Is Organized

Using UNIX Commands

Typographic Conventions

Shell Prompts

Accessing Sun Documentation

Contacting Sun Technical Support

Sun Welcomes Your Comments

1. Introduction to Sun 3270 Pathway

Sun 3270 Pathway Overview

Supported Transport Protocols

2. Required Software

Development Environment

Obtaining a Java Runtime Environment (JRE)

Obtaining a Java-enabled Web Browser

TCP Router

3. Installation

Installation Locations

Installing Sun 3270 Pathway

procedure iconsmall spaceTo Install Sun 3270 Pathway on Solaris and UNIX Systems

procedure iconsmall spaceTo Install Sun 3270 Pathway on Microsoft Windows Systems

4. Using the Sun 3270 Pathway Bean

Using Sun 3270 Pathway Bean With the JDK

Using Sun 3270 Pathway Bean in an IDE

5. Sun 3270 Pathway Sample Programs

Sun 3270 Pathway Bean Samples

Sample1.java

Sample1Applet.java

Sample2.java

Sample3.java

Pathway Recorder Sample

ACCTSample.java

6. Sun 3270 Pathway Bean Programmable Interface

Available Classes

Instantiating a Terminal Object

Connecting a Terminal

Determining When a Terminal is Connected

Determining When the Keyboard is Locked

Disconnecting a Terminal

Terminal Wait Methods

Obtaining Information From a Terminal

Obtaining Field Information

Obtaining Screen Buffer Information

Screen Change Notification

Supplying Data to a Terminal

The Visible Terminal

The Status Bar

Keyboard Handling

Automatic Font Resizing

Current and Maximum Display Sizes

7. Introduction to Sun 3270 Pathway Recorder

Recorder Concepts

Starting the Sun 3270 Pathway Recorder

Starting the Recorder on Solaris and UNIX Systems

procedure iconsmall spaceTo Start the Recorder Using the Shell Script

procedure iconsmall spaceTo Start the Recorder Using the JAR File

Starting the Recorder on Microsoft Windows Systems

procedure iconsmall spaceTo Start the Recorder Using the Start Menu

procedure iconsmall spaceTo Start the Recorder Using the Recorder Executable

procedure iconsmall spaceTo Start the Recorder Using the JAR File

Creating the Navigation Class

procedure iconsmall spaceTo Make a Connection and Display the Recorder Main Screen

Starting to Record

procedure iconsmall spaceTo Start Recording

Creating an Input Variable

procedure iconsmall spaceTo Create an Input Variable

procedure iconsmall spaceTo Select the Variable

Creating an Output Variable

procedure iconsmall spaceTo Create an Output Variable

procedure iconsmall spaceTo Select the Variable

Completing the Recording

procedure iconsmall spaceTo Finish the Recording Process

procedure iconsmall spaceTo Save the Navigation Class

Generated Output Files

Calling the Navigation Class

8. 3270 Pathway Recorder in Detail

Sun 3270 Pathway Navigation Class

procedure iconsmall spaceTo Create a Navigation Class

procedure iconsmall spaceTo Save Navigation Classes to the Disk

Navigation Recorder Window

Starting and Stopping Recording

procedure iconsmall spaceTo Start and Stop Recording

Supplying a Variable

procedure iconsmall spaceTo Create a New Variable

Double-Byte Character Set (DBCS) Issues

Highlighting an Area of the Screen

procedure iconsmall spaceTo Highlight an Area of the Screen

Storing an Area of the Screen

procedure iconsmall spaceTo Store the Highlighted Area of the Screen

Creating an assert

Starting the Store List Wizard

procedure iconsmall spaceTo Change the Font

Namespace Viewer Window

Namespace Viewer Window Contents

Variable Types

Creating and Deleting Variables

procedure iconsmall spaceTo Create a Variable

procedure iconsmall spaceTo Delete a Variable

Code Viewer Window

Structure of the Main Navigation Class

Instance Variables

init() Method

performWork() Method

Structure of the BeanInfo Class

Deleting the Most Recent Interaction

procedure iconsmall spaceTo Delete the Most Recent Interaction

Code Viewer Window Settings

Wait Strategies

9. Store List Wizard

How the Store List Wizard Works

Using the Store List Wizard

procedure iconsmall spaceTo Start the Store List Wizard

The Store List Wizard Interface

Store List Wizard Usage Example

Using the Select the Storage Vector Page

procedure iconsmall spaceTo Select a Storage Vector

Using the Select the Area of the List Page

procedure iconsmall spaceTo Select an Area of the List

Using the Select the End Condition Page

Using the Record the Advance Actions Page

Using the Manual Move to the End of the List

Using the Select the Text That has Appeared Page

Using the Select the Text That Will Disappear Page

Using the Move to the End of the List Page

Using the Select Matching Text Areas Page

procedure iconsmall spaceTo Select Matching Text Areas

10. TCP Routing Program

Starting the TCP Router

Starting the Router on Solaris and UNIX Systems

procedure iconsmall spaceTo Start the Router Using the Shell Script

procedure iconsmall spaceTo Start the Router Using the JAR File

Starting the Router on Microsoft Windows Systems

procedure iconsmall spaceTo Start the Router Using the Start Menu

procedure iconsmall spaceTo Start the Router Using the Router Executable

procedure iconsmall spaceTo Start the Router Using the JAR File

Command Line Parameters

Graphical User Interface (GUI)

procedure iconsmall spaceTo Connect to a Host Using the GUI

Menu Bar

Diagnostic Tracing

Structure of a Diagnostic Trace File Name

Contents of the Diagnostic Trace File

11. The Pathway Terminal

Starting the Pathway Terminal

Starting the Pathway Terminal on Solaris and UNIX Systems

procedure iconsmall spaceTo Start the Pathway Terminal Using the Shell Script

procedure iconsmall spaceTo Start the Pathway Terminal Using the JAR File

Starting the Pathway Terminal on Microsoft Windows Systems

procedure iconsmall spaceTo Start Pathway Terminal Using the Start Menu

procedure iconsmall spaceTo Start Pathway Terminal Using the Executable

procedure iconsmall spaceTo Start Pathway Terminal Using the JAR File

Command Line Parameters

3270 Emulator Window

The Menu Bar

The Emulator

The Status Bar

Connecting to a 3270 System

procedure iconsmall spaceTo Connect to a Host

Copy and Paste

Specifying Keyboard Mapping

procedure iconsmall spaceTo View the Current Key Mapping

procedure iconsmall spaceTo Change the Current Key Mapping

procedure iconsmall spaceTo Restore the Key Mapping to the Default Values

Resizing the Pathway Terminal

Diagnostic Information

Using the Pathway Terminal in DBCS Mode

Available 3270 Field Types

Restrictions on a Pure Single-byte Field

Restrictions on a Pure Double-byte Field

Restrictions on Mixed (SOSI) Fields

Making an Association With an Internet Browser

Accessibility Features of the Pathway Terminal

Index