Contents Overview Introduction ..........v About This Guide.
Page 4
Contents Edit Key Conflict Menu ........2-15 Help Menu ..........2-16 3 Terminal Keyboard Keyboard Layouts .
Page 5
Main Menu - TN5250 - Help ......2-16 IBM-Style 5250 Keyboard Layout.....3-1 Terminal Keyboard Layout .
Page 6
Trademarks IBM is a registered trademark of International Business Machines. Microsoft and Windows are registered trademarks of Microsoft Corporation. All other products are trademarks and/or registered trademarks of their respective companies.
Page 7
License Agreement YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS SOFTWARE (TOGETHER WITH ANY SUPPLIED DOCUMENTATION, HEREAFTER “SOFTWARE”), WHICH IS COPYRIGHTED BY LICENSOR. USING THIS SOFTWARE INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS. Grant You may use the Software only in or in conjunction with Your hardware (Terminal).
About TN5250 TN5250 terminal emulation provides the protocol to connect a terminal to IBM midrange systems (AS/400 servers). Once connected, the user can access Terminal and use legacy applications such as database and word processing through a Emulation terminal.
Connection operating with OS/400 Version 1, release level 3.0 or higher. Additionally, you must be operating the emulator across a TCP/IP network, using an IBM 8209 or equivalent TCP/IP attachment. When you use TN5250 terminal emulation, you are communicating directly with the AS/400 server. This communication is accomplished with the IBM AS/400 system internet protocol.
Overview Command and Key Table 2 lists the command and key sequence formats used in this guide. Sequence Format Table 2 Command and Key Sequence Format Conventions Convention command < xxx > Ctrl (right) Description Command format. The right and left angle brackets indicate the boundaries of the parameter list.
Getting Started This chapter discusses how to initiate TN5250 terminal emulation and explains: Downloading the TN5250 terminal emulation option. Defining and using TN5250 connections. Opening and exiting sessions. Read this chapter carefully before attempting to connect to a TN5250 server. Downloading The downloading of the TN5250 is similar to a flash download, and is done through the serial port, the parallel port, the Remote Administration tool, or...
Chapter 1 You will connect to the host you specified in the connection definition selected. Connection definitions appearing in the Connections list can be edited. To edit: 1 Select the connection that you want to edit from the Connections list. 2 Click on the Setup command button in the Connections dialog box.
Getting Started 6 Enter a server name and any command options (see Table 1-1, TN5250 Command Options), in the Server Name entry field. Note The port command option (for example 5250) should be included in the server name entry. Note If the TN5250 terminal type is grayed out, check with your Administrator to see if the TN5250 application firmware has been downloaded to your terminal.
Specifies the host port you want to use. Displays the command option summary. Displays the version number and environment variable settings. Host Name: OCS_Gateway. Port Number: 23. when the cursor is positioned next to any field listed in IBM 3179-2 IBM 5251-11 IBM 3196-A1 PC-XT...
Getting Started Emulator-Opened If you have specified an IP address in your connection definition, then once Sessions connected the Pass Through Screen displays (see Figure 1-2). Figure 1-2 Pass Through Screen Type choices, Press Enter. An initial session has been opened by the emulator. From the Pass Through Screen, press sessions, press open more sessions.
Host Name: (skipping Auto Start) Enter the address of the server. c Port Number: Specify 23 or other appropriate number. 4 Skip IBM Terminal Type, and press Your initial session will be opened. Note The maximum number of simultaneous open sessions is three.
The Menu System The TN5250 menu system is used to: Control sessions Invoke utility functions Map keyboards Additionally, the TN5250 menu system includes a help section. The help section is discussed in Help Menu at the end of this chapter, and presents additional information about emulator menus and functions.
Chapter 2 Figure 2-1 Main Menu - Emulator-Opened Sessions Figure 2-2 Main Menu - User-Opened Sessions Menu Control Keys Menus are invoked by positioning the cursor next to a menu selection, then pressing the control keys and alphanumeric keys (key sequences). The control keys used Ctrl Main Menu - TN5250 Sessions...
The Menu System The keys that appear at the bottom of each menu allow you to navigate through the menus. These are menu control keys, and are described in Table 2-1. Table 2-1 Menu Control Keys Page Up Page Down Ctrl Sessions Menu Depending on the way you configure your connection, one of two sessions’...
Page 20
Chapter 2 Invoke the Sessions menu by: 1 Position the cursor next to Sessions. 2 Press Figure 2-3 shows the Sessions menu. The menu displays a list of preexisting connection definitions. Figure 2-3 Sessions Menu 1=Create The functions displayed in this menu are numbered 1 through 6. To use: 1 Position the cursor to the left of the appropriate data field, and enter the appropriate number.
The Menu System Table 2-2 describes the functions in the Sessions menu. Table 2-2 Sessions Menu Functions Function 1=Create 2=Copy 3=Switch 4=Display 5=Close 6=Options Open Session This menu displays only in a user-opened session. It is used for creating new sessions.You invoke the Open Session menu by: Menu 1 Position the cursor next to Open Session in the main menu.
Table 2-3 describes the data fields in the Open Session menu. Table 2-3 Open Session Menu Functions Field Session Auto Start Host Name Port Number IBM Terminal Type Open Session *Session ______________________________ Auto Start no____ *Host Name *DFLT__________________________ OCS_Gateway Port Number...
The Menu System Note For the Session, Auto Start, Host Name, and IBM Terminal Type data fields, user-selectable lists are available. To invoke a list, position the cursor at the appropriate field, then press About TN5250 The About TN5250 menu displays the release information for your terminal emulator software.
Chapter 2 Utilities Menu The Utilities menu displays the Set Local Parameters function. Invoke this menu by: 1 Position the cursor next to Utilities in the Main menu. 2 Press Figure 2-6 shows the Utilities menu. Figure 2-6 Utilities Menu Set Local Parameters lets you control some additional local terminal features.
The Menu System Table 2-4 Set Local Parameters Functions Function Echo Char Session Escape Session Toggle Remapping Local The key sequences listed in Table 2-4 can be remapped by: Parameter Keys 1 Position the cursor at the key sequence you want to remap. 2 Press the 3 Position the cursor at the key sequence you want, and press The Set Local Parameters menu reappears, displaying the new key...
The following is an example: [20] Normal [Green] where [20] is the IBM 5250 attribute code, and Normal [Green] is normal green text. Note The menu displayed in Figure 2-7 is one of two menus. As shown, pressing the (right).
The Menu System Keyboard You can view your emulator’s current key mappings (sequences) by accessing the Keyboard Mapping menu. Invoke this menu by: Mapping Menu 1 Position the cursor next to Keyboard Mapping in the Main menu. 2 Press Figure 2-8 shows the Keyboard Mapping menu. Figure 2-8 Keyboard Mapping Menu (right).
2-12 Chapter 2 Table 2-5 describes the functions of the Keyboard Mapping menu. Table 2-5 Keyboard Mapping Functions Function Host Function Keys Cursor Control Keys Screen Control Keys Local Function Keys Text Assist Keys Key Map Verification Save Keyboard Mapping Restore Default Mapping Description...
The Menu System Edit Keys Menu Keys can be edited or changed by using the Mapping menu. Position the cursor next to the key you want to edit, in any of the key mapping menus, and press With this menu, you can change or remap any of the emulator keys displayed in the Keyboard Mapping menu.
2-14 Chapter 2 Auto Key Entry Key sequences can be entered automatically. To do this, enter the Auto Key Entry mode by pressing Menu appears. Figure 2-10 shows the Auto Key Entry menu. Figure 2-10 Auto Key Entry Menu To use this menu: 1 Position the cursor next to the key you want to remap.
The Menu System Edit Key Conflict If you attempt to map two functions to the same key, the Edit Key Conflict menu appears. See Figure 2-11. Menu Figure 2-11 Edit Key Conflict Menu The Edit Key Conflict menu displays both the key function that you are attempting to map, and the key that is currently mapped to the key sequence.
Open Sessions Select this option to open a session. Specify a host name, port number, IBM terminal type, and a server. About TN5250 Select this option to view information about TN5250 and command usage.
The differences between the IBM 5250 keyboard and your terminal’s keyboard. Terminal keyboard features. Keyboard Layouts This section compares the layout of the IBM 5250 keyboard with your terminal’s keyboard. 5250 Keyboard Figure 3-1 shows the IBM-style 5250 keyboard layout.
The following section compares the TN5250 key definitions with the terminal key definitions. TN5250 Key The IBM 5250 keyboard key definitions (refer to Figure 3-1) are listed in Definitions Table 3-1. The purpose of this table is to enable you to compare your old terminal’s keyboard with your new terminal’s keyboard.
Page 35
Terminal Keyboard Table 3-1 TN5250 Keys, Continued TN5250 Key Function Delete Deletes a character where the cursor is positioned. Double Speed Left Moves cursor four positions to the left. Double Speed Right Moves cursor four positions to the right. Duplicates the last field. Enter Executes commands, or accepts data and/or selected options currently on the screen.
TN5250 Key Sys Req Test Req Note For a more detailed description about IBM 5250 keys, refer to the IBM 5250 Information Display System Functions Reference Manual. Host Function Keys Table 3-2 lists the host function keys and your terminal’s equivalent key or key sequence.
Chapter 3 Cursor Control Keys Table 3-3 lists the TN5250 cursor control keys and your terminal’s equivalent cursor control key or key sequence. See “Keyboard Mapping” in the TN5250 main menu (discussed in Chapter 2) for further information. Table 3-3 Cursor Control Keys TN5250 Key Back Space Double Speed R...
Roll Down Roll Up Local Function Keys Table 3-5 lists the IBM 5250 session keys, and your terminal emulation’s equivalent key. See “Keyboard Mapping” in the TN5250 main menu (discussed in Chapter 2) for further details. Table 3-5 Local Function Keys...
Chapter 3 Text Assist Keys Table 3-6 lists the TN5250 text assist keys and your terminal’s equivalent key sequence. See “Keyboard Mapping” in the TN5250 main menu (discussed in Chapter 2) for further details. Table 3-6 Text Assist Keys TN5250 Key Cmd A Cmd B Cmd C...
Terminal Keyboard Table 3-6 Text Assist Keys, Continued TN5250 Key Cmd Tab Shift Tab TypeAhead Applications such as data processing and word processing programs normally accept keystrokes as you enter information. However, these applications can Buffering lock your keyboard when data is being processed. When a keyboard locks, the II (Input Inhibited) indicator appears on the status line (see Appendix A).
Error Messages This section describes the error messages that might display on your terminal screen during a TN5250 session. These error messages are grouped into three categories: Telnet errors TN5250 internal errors Status Line errors Telnet Errors Telnet errors are generated by Telnet communications software within a TN5250 terminal.
Appendix A Table A-1 Telnet Errors, Continued Message TELNET: socket connection failed TELNET: Unable to connect to remote host Host name must be supplied if port number is specified <Host>: Host name lookup failure <Port-Number>: bad port number MAIN: error initializing socket library TN5250 Internal Table A-2 lists TN5250 internal errors.
Error Messages The Status Line The Status Line displays real-time system messages that appear during terminal emulation. This field resides at the bottom of your terminal screen, and consists of seven separate sections. Figure A-1 shows the Status Line. Figure A-1 Status Line Table A-3 describes each section of the Status Line.
Appendix A Status errors and their descriptions are listed in Table A-4. Refer to the IBM 5394 Remote Control Unit Functions Reference Manual for further information. Table A-4 Status Line Errors Error 0000 Help key not allowed 0001 Last keystroke not recognized...
Error Messages Table A-4 Status Line Errors, Continued Error 0009 This field requires numeric characters 0010 Only characters 0-9 allowed 0011 Invalid key for sign position of field 0012 Insert mode, no room to insert data 0013 Insert mode-only data keys allowed 0014 Mandatory fill field-must fill to exit 0015 Check digit error 016 FIELD- key invalid with this field...
Appendix A Table A-4 Status Line Errors, Continued Error 0019 Dup key not allowed in this field 0020 Function Ctrl key invalid in this field 0021 Mandatory enter field, must enter data 0022 Status of field not known 0024 Entry not valid in entry field 0026 Character entered invalid for this field 0027 Key not defined-key cannot be used 0029 Invalid international character set...
Troubleshooting Aids Answer the following questions and record the information before you contact technical support. This information can then be used by support engineers, to help you with your problem. Network Have software or hardware changes been made to your network? Information Are you using Domain Name Service or a hosts file? Can you run a separate executable program, such as ping or telnet?
Page 49
Telnet A-1 TN5250 A-2 Features vii Firmware viii downloading 1-1 Format conventions viii Guide viii Help menu 2-16 IBM-style 5250 keyboard layout 3-1 Introduction vii Keyboard mapping functions 2-11 Keyboard mapping menu 2-11 Keyboards IBM-style 5250 3-1 Keys 5250 3-2...
Index-2 open session menu 2-5 screen attributes menu 2-10 sessions menu 2-3 TN5250 menu 2-7 utilities 2-8 Open session menu 2-5 functions 2-6 Pass through screen 1-5 Remapping local parameter keys 2-9 Requirements viii Screen attributes menu 2-10 Screen control keys 3-6 Sessions 2-3 emulator-opened 1-5 ending 1-6...
Page 51
883554-02 Rev. A June 1998 Printed in U.S.A.