Information Builders iWay 3270 Manuale utente

iWay Emulation Adapter
(3270/5250) User's Guide
Version 7.0.x and Higher
August 16, 2018

Active Technologies, EDA, EDA/SQL, FIDEL, FOCUS, Information Builders, the Information Builders logo, iWay, iWay
Software, Parlay, PC/FOCUS, RStat, Table Talk, Web390, WebFOCUS, WebFOCUS Active Technologies, and WebFOCUS
Magnify are registered trademarks, and DataMigrator and Hyperstage are trademarks of Information Builders, Inc.
Adobe, the Adobe logo, Acrobat, Adobe Reader, Flash, Adobe Flash Builder, Flex, and PostScript are either registered
trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
Due to the nature of this material, this document refers to numerous hardware and software products by their
trademarks. In most, if not all cases, these designations are claimed as trademarks or registered trademarks by their
respective companies. It is not this publisher's intent to use any of these names generically. The reader is therefore
cautioned to investigate all claimed trademark rights before using any of these names other than to refer to the product
described.
Copyright ©2018, by Information Builders, Inc. and iWay Software. All rights reserved. Patent Pending. This manual, or
parts thereof, may not be reproduced in any form without the written permission of Information Builders, Inc.

Contents
Preface ......................................................................... 5
Documentation Conventions ............................................................5
Related Publications .................................................................. 6
Customer Support .................................................................... 6
Help Us to Serve You Better ............................................................7
User Feedback .......................................................................9
Information Builders Consulting and Training ............................................. 9
1. Introducing the iWay Emulation Adapter (3270/5250) ..........................11
Integrating Mainframe Logic ...........................................................11
iWay Emulation Adapter (3270/5250) Components..................................12
Remote Procedure Call Development Mode ............................................. 12
Emulating and Recording Mainframe Sessions......................................12
Development Roadmap..........................................................13
Installing the iWay Emulation Adapter (3270/5250) ......................................14
Deployment Information for the iWay Emulation Adapter (3270/5250) ......................15
Deployment Information Roadmap.................................................15
iWay Service Manager...........................................................16
iWay Explorer...................................................................16
iWay Business Services Provider..................................................16
2. Understanding Telnet Designer ................................................19
Navigating Telnet Designer ............................................................20
Telnet Designer Menu Options ........................................................ 21
Working With Telnet Designer Projects ..................................................23
Project Tab.....................................................................24
Telnet Designer Tools ................................................................25
Emulator Tool.................................................................. 25
Player Server Tool...............................................................30
Options........................................................................30
3. Using Remote Procedure Call Mode ........................................... 33
Remote Procedure Call Mode Overview .................................................33
Creating a Transaction Module ........................................................34
iWay Emulation Adapter (3270/5250) User's Guide 3

Accessing the Mainframe Application..............................................34
Capturing a Transaction..........................................................39
Testing the RPC Program.........................................................47
Generating the RPC Program..................................................... 49
4. Creating XML Schemas and iWay Business Services ............................53
Creating an Adapter Transaction .......................................................53
Understanding iWay Business Services .................................................56
Creating iWay Emulation Adapter (3270/5250) iWay Business Services .....................56
5. Using Emulation and Recorder Modes ......................................... 59
Using Emulation Mode ............................................................... 59
About Recorder Mode ................................................................61
Creating a Prerecorded File ........................................................... 62
Developing Against a Prerecorded File ..................................................66
A. Emulator Keyboard Mapping .................................................. 69
Emulator Keyboard Mapping .......................................................... 69
Contents
4 Information Builders

Preface
This documentation describes how to install, configure, and use the iWay Emulation Adapter
(3270/5250). It is intended for system administrators who are responsible for planning an
enterprise software environment.
Note: This Release 7.0.x content is currently being updated to support iWay Release 8.0.x
software. In the meantime, it can serve as a reference for your use of iWay Release 8. If you
How This Manual Is Organized
This manual includes the following chapters:
Chapter/Appendix Contents
1 Introducing the iWay
Emulation Adapter
(3270/5250)
Provides an overview of the iWay Emulation Adapter
(3270/5250) and describes how to install it.
2 Understanding Telnet
Designer
Describes the Telnet Designer user interface. This
includes a description of available menus and
options.
3 Using Remote Procedure Call
Mode
Describes how to use the iWay Emulation Adapter
(3270/5250) to create a Remote Procedure Call
(RPC) of an emulation session and save it as a
stand-alone Java program.
4 Creating XML Schemas and
iWay Business Services
Describes how to create XML schemas and iWay
Business Services that will be used to execute the
iWay Emulation Adapter (3270/5250).
5 Using Emulation and
Recorder Modes
Describes how to use Emulation mode, which
allows you to access a mainframe session directly
from your workstation, and how to use Recorder
Mode, which allows you to record an emulation
session so that you can play back at a later time to
simulate a live mainframe session.
A Emulator Keyboard Mapping Describes how your keyboard maps to 3270/5250
keys when you use the emulator.
Documentation Conventions
The following table describes the documentation conventions that are used in this manual.
iWay Emulation Adapter (3270/5250) User's Guide 5

Convention Description
THIS TYPEFACE or
this typeface
Denotes syntax that you must enter exactly as shown.
this typeface Represents a placeholder (or variable), a cross-reference, or an
important term. It may also indicate a button, menu item, or dialog
box option that you can click or select.
underscore Indicates a default setting.
Key + Key Indicates keys that you must press simultaneously.
{ } Indicates two or three choices. Type one of them, not the braces.
| Separates mutually exclusive choices in syntax. Type one of them,
not the symbol.
... Indicates that you can enter a parameter multiple times. Type only
the parameter, not the ellipsis (...).
.
.
.
Indicates that there are (or could be) intervening or additional
commands.
Related Publications
Visit our Technical Content Library at http://documentation.informationbuilders.com. You can
also contact the Publications Order Department at (800) 969-4636.
Customer Support
Do you have questions about this product?
Join the Focal Point community. Focal Point is our online developer center and more than a
message board. It is an interactive network of more than 3,000 developers from almost every
profession and industry, collaborating on solutions and sharing tips and techniques. Access
Focal Point at http://forums.informationbuilders.com/eve/forums.
Related Publications
6 Information Builders

You can also access support services electronically, 24 hours a day, with InfoResponse
Online. InfoResponse Online is accessible through our website, http://
www.informationbuilders.com. It connects you to the tracking system and known-problem
database at the Information Builders support center. Registered users can open, update, and
view the status of cases in the tracking system and read descriptions of reported software
issues. New users can register immediately for this service. The technical support section of
http://www.informationbuilders.com also provides usage techniques, diagnostic tips, and
answers to frequently asked questions.
Call Information Builders Customer Support Services (CSS) at (800) 736-6130 or (212)
736-6130. Customer Support Consultants are available Monday through Friday between 8:00
a.m. and 8:00 p.m. EST to address all your questions. Information Builders consultants can
also give you general guidance regarding product capabilities. Please be ready to provide your
six-digit site code number (xxxx.xx) when you call.
To learn about the full range of available support services, ask your Information Builders
representative about InfoResponse Online, or call (800) 969-INFO.
Help Us to Serve You Better
To help our consultants answer your questions effectively, be prepared to provide
specifications and sample files and to answer questions about errors and problems.
The following tables list the environment information our consultants require.
Platform
Operating System
OS Version
JVM Vendor
JVM Version
The following table lists the deployment information our consultants require.
Adapter Deployment For example, iWay Business Services Provider, iWay
Service Manager
Container For example, WebSphere
Preface
iWay Emulation Adapter (3270/5250) User's Guide 7

Version
Enterprise Information System
(EIS) - if any
EIS Release Level
EIS Service Pack
EIS Platform
The following table lists iWay-related information needed by our consultants.
iWay Adapter
iWay Release Level
iWay Patch
The following table lists additional questions to help us serve you better.
Request/Question Error/Problem Details or Information
Did the problem arise through
a service or event?
Provide usage scenarios or
summarize the application that
produces the problem.
When did the problem start?
Can you reproduce this
problem consistently?
Describe the problem.
Describe the steps to
reproduce the problem.
Specify the error message(s).
Help Us to Serve You Better
8 Information Builders

Request/Question Error/Problem Details or Information
Any change in the application
environment: software
configuration, EIS/database
configuration, application, and
so forth?
Under what circumstance does
the problem not occur?
The following is a list of error and problem files that might be applicable.
Input documents (XML instance, XML schema, non-XML documents)
Transformation files
Error screen shots
Error output files
Trace files
Service Manager package to reproduce problem
Custom functions and agents in use
Diagnostic Zip
Transaction log
For information on tracing, see the iWay Service Manager User's Guide.
User Feedback
In an effort to produce effective documentation, the Technical Content Management staff
welcomes your opinions regarding this document. You can contact us through our website,
http://documentation.informationbuilders.com/connections.asp.
Thank you, in advance, for your comments.
Information Builders Consulting and Training
Interested in training? Information Builders Education Department offers a wide variety of
training courses for this and other Information Builders products.
Preface
iWay Emulation Adapter (3270/5250) User's Guide 9

For information on course descriptions, locations, and dates, or to register for classes, visit
our website (http://education.informationbuilders.com) or call (800) 969-INFO to speak to an
Education Representative.
Information Builders Consulting and Training
10 Information Builders
Questo manuale è adatto per i seguenti modelli
1
Indice

















