IBM Terminal Emulation TN5250 User Manual
IBM Terminal Emulation TN5250 User Manual

IBM Terminal Emulation TN5250 User Manual

Ibm terminal emulation user's guide
Table of Contents

Advertisement

TN5250 Terminal
Emulation
User's Guide

Advertisement

Table of Contents
loading

Summary of Contents for IBM Terminal Emulation TN5250

  • Page 1 TN5250 Terminal Emulation User’s Guide...
  • Page 2 TN5250 Terminal Emulation User’s Guide...
  • Page 3: Table Of Contents

    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).
  • Page 8: Overview

    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.
  • Page 9: The Tn5250 Connection

    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.
  • Page 10: Command And Key Sequence Format

    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.
  • Page 11: Getting Started

    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...
  • Page 12: New Connection Definitions

    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.
  • Page 13: Tn5250 Command Options

    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.
  • Page 14: Sessions

    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...
  • Page 15: Emulator-Opened Sessions

    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.
  • Page 16: Ending A Session

    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.
  • Page 17: The Menu System

    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.
  • Page 18: Menu Control Keys

    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...
  • Page 19: Sessions Menu

    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.
  • Page 21: Open Session Menu

    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.
  • Page 22: Open Session 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...
  • Page 23: About Tn5250 Menu

    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.
  • Page 24: Utilities Menu

    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.
  • Page 25: Remapping Local Parameter Keys

    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...
  • Page 26: Screen Attributes Menu

    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).
  • Page 27: Keyboard Mapping Menu

    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).
  • Page 28: Keyboard Mapping Functions

    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...
  • Page 29: Edit Keys Menu

    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.
  • Page 30: Auto Key Entry 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.
  • Page 31: Edit Key Conflict Menu

    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.
  • Page 32: Help Menu

    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.
  • Page 33: Keyboard Layouts

    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.
  • Page 34: Keys

    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.
  • Page 36: Host Function Keys

    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.
  • Page 37 Terminal Keyboard Table 3-2 Host Function Keys, Continued TN5250 Key Terminal Key(s) Cmd8 Cmd9 Cmd10 Cmd11 Cmd12 Cmd13 (shift) Cmd14 (shift) Cmd15 (shift) Cmd16 (shift) Cmd17 (shift) Cmd18 (shift) Cmd19 (shift) Cmd20 (shift) Cmd21 (shift) Cmd22 (shift) Cmd23 (shift) Cmd24 (shift) Help Scroll Lock...
  • Page 38: Cursor Control Keys

    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...
  • Page 39: Local Function Keys

    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...
  • Page 40: Text Assist 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...
  • Page 41: Typeahead Buffering

    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).
  • Page 42: A Error Messages

    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.
  • Page 43: Tn5250 Internal Errors

    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.
  • Page 44: The Status Line

    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.
  • Page 45: Status Line Errors

    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...
  • Page 46: Status Line Errors

    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...
  • Page 47: Status Line

    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...
  • Page 48: B Troubleshooting Aids

    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...
  • Page 50: Terminal Keyboard

    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.

Table of Contents