Information Builders iWay 3270 User Manual Download Page 4 | Manualshive

Page: 4 / 72

Information Builders iWay 3270 User Manual Download Page 4

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

«
...
2
3
4
5
6
...
»

Summary of Contents for iWay 3270

Page 1: ...iWay Emulation Adapter 3270 5250 User s Guide Version 7 0 x and Higher August 16 2018...

Page 2: ...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 trade...

Page 3: ...ap 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 i...

Page 4: ...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 Ab...

Page 5: ...escription 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...

Page 6: ...er 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...

Page 7: ...iday 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...

Page 8: ...dditional 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 applicat...

Page 9: ...stom 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 T...

Page 10: ...ns 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...

Page 11: ...apter 3270 5250 Deployment Information for the iWay Emulation Adapter 3270 5250 Integrating Mainframe Logic Telnet is a standard protocol for remote logon over the Internet The name is an abbreviation...

Page 12: ...s to the mainframe in an XML request document and the mainframe returns screen data in an XML response document You can use these documents to integrate a mainframe session into your application This...

Page 13: ...ituations when the mainframe is unavailable For more information on emulating and recording your mainframe session see Using Emulation and Recorder Modes on page 59 Development Roadmap The following i...

Page 14: ...s 2000 with SP2 Windows 2003 Windows XP SP1 Note If you plan to run the Emulation Adapter on a UNIX system you must install iWay 7 0 2 SM and the Emulation Adapter client components on the UNIX system...

Page 15: ...5250 can be used in conjunction with one of the following components iWay Service Manager iWay Explorer iWay Business Services Provider iBSP When hosted in an iWay environment the adapter is configure...

Page 16: ...plex adapter interactions makes it ideally suited to be the foundation of a service oriented architecture iWay Explorer iWay Explorer uses an explorer metaphor to create XML schemas and web services f...

Page 17: ...another using a text based platform and language independent message format called XML Coupled with a platform and language independent messaging protocol called SOAP Simple Object Access Protocol XML...

Page 18: ...Deployment Information for the iWay Emulation Adapter 3270 5250 18 Information Builders...

Page 19: ...ion describes the menus and options available in the Telnet Designer In this chapter Navigating Telnet Designer Telnet Designer Menu Options Working With Telnet Designer Projects Telnet Designer Tools...

Page 20: ...om of the pane access project folders Project name and your Telnet sessions Sessions A default project named system is provided with Telnet Designer The Project tab displays the current project name T...

Page 21: ...e Window Viewer Window Open a Viewer window in the right pane The pane provides a tab for each loaded viewer data Not currently used Screen DB Viewer Open a Screen DB Viewer in the right pane This pan...

Page 22: ...pane Help About Open the About window which displays Telnet Designer build and version information The following table shows each Telnet Designer icon and describes its function Icon Description Crea...

Page 23: ...e for the new project 3 Click OK The new project node with its subfolders appears in the left pane To exit the New Project window at any time click Cancel Procedure How to Open an Existing Project To...

Page 24: ...ries of subfolders are displayed in the pane as shown in the following image As you design with Telnet Designer the project items are saved to the following folders dumps Contains dump files created u...

Page 25: ...ols menu Emulator Player Server Options Emulator Tool Access the Emulator tool from either the main menu Tools then Emulator or from the Emulator tool icon The Terminal Emulator dialog box opens with...

Page 26: ...available selections are tn3270 and tn5250 SSL TLS This option allows you to enable a Secure Sockets Layer SSL Transport Layer Security TLS security connection Port Port number of the connection Mode...

Page 27: ...ed attributes from the back end application These attributes are returned to the application without modification The following attributes are allowed background color character set field outlining fi...

Page 28: ...connections and privileges to specific telnet ports Click Run to connect to the designated system Click Cancel to exit the Terminal Emulator dialog box The Security tab of the Terminal Emulator dialog...

Page 29: ...1 4 and higher SSL Version 3 0 and TLS Version 1 0 are currently supported by iWay Emulation Adapter 3270 5250 iWay Emulation Adapter 3270 5250 uses its own trust store file to store server certificat...

Page 30: ...cess the Player Server tool click Tools from the menu bar and select Player Server You can also click the Player Server icon on the toolbar The Player Server dialog box opens as shown in the following...

Page 31: ...owing table lists and describes the Emulator options Option Description Font Size Determines the font size of the emulation Auto Reconnect Automatically re establishes the emulator session if the conn...

Page 32: ...ort sequence adding one to the previous port number Max sessions The maximum sequence of port numbers allocated to the player server As each new player session is opened a new session in this sequence...

Page 33: ...ece of information in a legacy mainframe application At design time you use the iWay Emulation Adapter 3270 5250 Telnet Designer to connect to a mainframe application then navigate and capture the app...

Page 34: ...cation screens input parameters and target information that make up a transaction The process of creating a transaction module consists of Accessing the mainframe application in Telnet Designer Emulat...

Page 35: ...Designer window opens as shown in the following image with the Project tab active in the left pane 2 At the bottom of the left pane click the Sessions tab A Sessions folder appears at the top of the l...

Page 36: ...n in the following image The Connection tab where you provide information about connecting to the mainframe is active 4 From the Host drop down list select the mainframe you want to emulate 5 From the...

Page 37: ...tes option is not operational for the RPC mode 9 Make a selection from the Language drop down list shown in the following image The Language selection determines the national language character set th...

Page 38: ...pane and a folder that represents your session appears in the left pane The following image shows an example of the VTAM window and a session folder named Server RPC Each session folder contains sub f...

Page 39: ...ns If the screen contains required input fields Parameters that require values at run time define them to the transaction The values will be provided in the request document at run time If the screen...

Page 40: ...entify the screen The following image shows an example of a field named RUNNING selected in the lower left of the screen 2 Right click the identifying field and select Add Screen Identifier Creating a...

Page 41: ...screen field text ends with the Field Text entry StartsWith The screen field text begins with the Field Text entry Contains The screen field text contains the Field Text entry For example if the field...

Page 42: ...ple input parameter NUMBER to explain how to define input parameters Note It may not be necessary to define parameters on each screen Define only those input parameters that are required to navigate t...

Page 43: ...me that appropriately identifies the input parameter for example Account 4 Click Ok 5 Repeat these steps for the remaining fields that you want to define as input parameters A folder with the paramete...

Page 44: ...pears in the left pane under the metadata folder A folder is created for each output field identified for the session Procedure How to Capture the Contents of a Table There are times when the mainfram...

Page 45: ...am the output of the program will contain a record like answer set with all of the information displayed as columns Procedure How to Save the Transaction Session When you are finished identifying scre...

Page 46: ...a name for the save document as shown in the following image 3 Type a name for the session for example TelnetHostA 4 If needed enter comments in the Remarks field 5 Click Save The requested XML docume...

Page 47: ...ded mainframe session in which there is no connection to the mainframe Testing allows you to verify that you have correctly identified all the required screens and parameters to run the RPC and that t...

Page 48: ...n example of an RPC program node and its drop down list The RPC Tool window opens in the right pane as shown in the following image 3 Click Parameters to enter the parameter data expected by the RPC a...

Page 49: ...where the program returns the information for the record with account number 000022 The RPC has been tested successfully You can now generate a Java program from the RPC Generating the RPC Program You...

Page 50: ...the Project system tab 2 Expand the system folder and then expand the rpcs subfolder 3 Right click the RPC design project for example MenuInqy and select Generation The following image shows the expa...

Page 51: ...and alone component select Java Class and enter the fully qualified name of the Java class you want to generate The iWay Telnet Designer generates the class under the work subfolder of your current pr...

Page 52: ...The iWay Telnet Designer also generates artifacts that can be used to compile and run the Java program using Apache Ant Creating a Transaction Module 52 Information Builders...

Page 53: ...iness Services Creating an Adapter Transaction After you have used the iWay Telnet Designer to create a project containing one or more RPCs you can import them to the iWay Emulation Adapter in iWay Ex...

Page 54: ...Adapters iWay Events and iWay Business Services also known as web services 3 In the left pane expand the iWay Adapters node and select the Telnet node 4 Right click the Telnet adapter node and select...

Page 55: ...lnet Project 8 Click OK The Telnet Project dialog box opens as shown in the following image 9 Specify the full path to the Telnet project in the Project Folder field 10 Click OK The new target for exa...

Page 56: ...you can publish and access across a network using open standards It is the implementation of an interface by a component and is an executable entity For the caller or sender a web service can be cons...

Page 57: ...mes drop down list select either new service or an existing service b If you are creating a new service specify a service name This name identifies the web service in the list of services under the Bu...

Page 58: ...Creating iWay Emulation Adapter 3270 5250 iWay Business Services 58 Information Builders...

Page 59: ...nd Recorder Mode In this chapter Using Emulation Mode About Recorder Mode Creating a Prerecorded File Developing Against a Prerecorded File Using Emulation Mode The adapter Emulation mode enables you...

Page 60: ...m terminal d Select Emulation as the Mode option 3 For more emulation options click the Advanced tab The Advanced tab of the Terminal Emulator opens Make a selection from the Language drop down list T...

Page 61: ...ay Emulation Adapter 3270 5250 Recorder mode enables you to capture your mainframe application screens and end user keystrokes using Telnet Designer in terminal mode and then stores these screens and...

Page 62: ...or debugging Procedure How to Record an Emulation Session To use Telnet Designer in Recorder REC mode 1 From the Telnet Designer main menu select Tools and then Emulator You can also click the Emulat...

Page 63: ...in the LU Name field This option allows the mainframe to dedicate specific connections and privileges to specific telnet ports 4 Click Run A connection is made to the mainframe online system The mainf...

Page 64: ...CESF LOGOFF command 7 Close the mainframe session window by clicking the X in the upper right of the mainframe window 8 To save the prerecorded file right click the Server RECORDER node in the left p...

Page 65: ...xample REC1 Note Entering information in the Remarks field is optional 10 Click Save 11 In the left pane of Telnet Designer click the Project tab and expand the dumps folder When the recorded session...

Page 66: ...mainframe transactions enabling for example two or more developers to work on separate transactions on a laptop that is disconnected from the actual mainframe You have all options available to create...

Page 67: ...gainst it to create an RPC application You can use Telnet Designer as if you were connected to the mainframe Procedure How to Start a Player Session Against a Prerecorded File To start a player sessio...

Page 68: ...the Player Server tab selected 3 In the Initial Port field type the port number your Telnet Designer tool will use to connect to the iWay Emulation Adapter 3270 5250 4 In the Max session field type a...

Page 69: ...ing The following table lists 3270 5250 keys in the left column and corresponding keyboard equivalents in the right column 3270 5250 Key Keyboard PF1 PF12 F1 F12 PF13 PF24 Shift F1 Shift F12 Clear Ctr...

Page 70: ...3270 5250 Key Keyboard Home Home New Line Ctrl N Emulator Keyboard Mapping 70 Information Builders...

Page 71: ...ing efforts You can also preview new innovations to get an early look at new content products and services Your participation helps us create great experiences for every customer To send us feedback o...

Page 72: ...Information Builders Inc Two Penn Plaza New York NY 10121 2898 iWay Emulation Adapter 3270 5250 User s Guide Version 7 0 x and Higher DN3502279 0418...

Reviews:

No comments