manualshive.com logo in svg

Information Builders iWay 3270, Руководство пользователя, Страница: 47 / 72

Поделиться
Скачать
Information Builders iWay 3270 Скачать руководство пользователя страница 47

where:

TelnetInstalDir

Is the directory into which the emulator product is installed.

system

Is the name of your project. System is the default project name.

The XML request document can be used to generate web services as explained in 

Creating

XML Schemas and iWay Business Services

 on page 53.

The new document appears in the left pane under the Sessions folder, as shown in the
following image.

Testing the RPC Program

The RPC application can be tested immediately against the mainframe online application.
Depending on the connection parameters, it can be tested against a prerecorded 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 the desired metadata is returned from your application. If
you are unable to successfully complete the RPC test, review the transaction and confirm that
all the necessary input data is properly assigned, along with the navigation of the transaction
through the various screens.

Procedure:

How to Unit Test the RPC

To test an RPC:

1. In the left pane, expand the rpcs node and right-click the RPC you want to test.

Note:

 Be sure you are working in the desired project.

2. From the drop-down list, select 

Run

.

3. Using Remote Procedure Call Mode

iWay Emulation Adapter (3270/5250) User's Guide 

 47

Содержание iWay 3270

Страница 1: ...iWay Emulation Adapter 3270 5250 User s Guide Version 7 0 x and Higher August 16 2018...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 18: ...Deployment Information for the iWay Emulation Adapter 3270 5250 18 Information Builders...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 58: ...Creating iWay Emulation Adapter 3270 5250 iWay Business Services 58 Information Builders...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 70: ...3270 5250 Key Keyboard Home Home New Line Ctrl N Emulator Keyboard Mapping 70 Information Builders...

Страница 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...

Страница 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...

Отзывы:

Нет отзывов