IBM TN5250 User Manual

TN5250 Terminal Emulation
User’ s Guide
TN5250 Terminal Emulation User’s Guide
Contents
Overview
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
About TN5250 Terminal Emulation. . . . . . . . . . . . . . . . . . . . . . . . . . . v
Product Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
The TN5250 Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Guide Format Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Text Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Command and Key Sequence Format . . . . . . . . . . . . . . . . . . . . .vii
1 Getting Started
Downloading TN5250 Option Firmware . . . . . . . . . . . . . . . . . . . . . .1-1
TN5250 Server Connection Definitions. . . . . . . . . . . . . . . . . . . . . . .1-1
Preexisting Connection Definitions. . . . . . . . . . . . . . . . . . . . . . .1-1
New Connection Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-2
TN5250 Command Options . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
Emulator-Opened Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
User-Opened Sessions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
Ending a Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-6
2 The Menu System
Main Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-1
Menu Control Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-2
Sessions Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
Open Session Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
About TN5250 Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
Utilities Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8
Remapping Local Parameter Keys. . . . . . . . . . . . . . . . . . . . . . .2-9
Screen Attributes Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-10
Keyboard Mapping Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-11
Edit Keys Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-13
Auto Key Entry Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-14
ii Contents
Edit Key Conflict Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-15
Help Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-16
3 Terminal Keyboard
Keyboard Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
5250 Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1
Terminal Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
TN5250 Key Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
Host Function Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
Cursor Control Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
Screen Control Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
Local Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
Text Assist Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8
TypeAhead Buffering. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9
Locked Keyboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9
A Error Messages
Telnet Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
TN5250 Internal Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
The Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
Status Line Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
B Troubleshooting Aids
Network Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Terminal Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
Problem Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1
List of Figures
1 The TN5250 Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
1-1 Connection Properties Dialog Box . . . . . . . . . . . . . . . . . . . .1-2
1-2 Pass Through Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5
2-1 Main Menu - Emulator-Opened Sessions . . . . . . . . . . . . . .2-2
2-2 Main Menu - User-Opened Sessions. . . . . . . . . . . . . . . . . .2-2
2-3 Sessions Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4
2-4 Open Session Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
2-5 About TN5250 Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
2-6 Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8
2-7 Screen Attributes Menu . . . . . . . . . . . . . . . . . . . . . . . . . . .2-10
2-8 Keyboard Mapping Menu . . . . . . . . . . . . . . . . . . . . . . . . . .2-11
Contents iii
2-9 Edit Keys Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-13
2-10 Auto Key Entry Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-14
2-11 Edit Key Conflict Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . .2-15
2-12 Main Menu - TN5250 - Help. . . . . . . . . . . . . . . . . . . . . . . .2-16
3-1 IBM-Style 5250 Keyboard Layout. . . . . . . . . . . . . . . . . . . . .3-1
3-2 Terminal Keyboard Layout . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
A-1 Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
List of Tables
1 Text Format Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
2 Command and Key Sequence Format Conventions . . . . . . .vii
1-1 TN5250 Command Options . . . . . . . . . . . . . . . . . . . . . . . . .1-3
2-1 Menu Control Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3
2-2 Sessions Menu Functions . . . . . . . . . . . . . . . . . . . . . . . . . .2-5
2-3 Open Session Menu Functions . . . . . . . . . . . . . . . . . . . . . .2-6
2-4 Set Local Parameters Functions . . . . . . . . . . . . . . . . . . . . .2-9
2-5 Keyboard Mapping Functions. . . . . . . . . . . . . . . . . . . . . . .2-12
3-1 TN5250 Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-2
3-2 Host Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4
3-3 Cursor Control Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
3-4 Screen Control Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6
3-5 Local Function Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7
3-6 Text Assist Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8
A-1 Telnet Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1
A-2 TN5250 Internal Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2
A-3 Status Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
A-4 Status Line Errors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-4
Copyright Notice
© 1998 ALL RIGHTS RESERVED. This manual and the software and firmware described in it are copyrighted.
You may not reproduce, transmit, transcribe, store in a retrieval system, or translate into any language or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, any part of this publication without express written permission.
Trademarks
Restricted Rights Legend
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. Specifications subject to change without notice.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013.
Control No. 075B
License Agreement
Grant
Disclaimer of Warranty
YOU SHOULD CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS SO FT WARE (TOGET HE R WI TH AN Y S UPP L IE D D OCU MEN TAT IO N, HE REA F TER “SOFTWARE”), WHICH IS COPYRIGHTED BY LICENSOR. USING THIS SOFTWARE INDICATES YOUR ACCEPTANCE OF THE FOLLOWING TERMS AND CONDITIONS.
You may use the Software only in or in conjunction with Your hardware (Terminal). You have the right to use this Software by loading it onto a computer containing the capability of transferring the Software (in whole or in part) to Your Terminal. You may use the Software in this f ashion as many times as is necessary and as permitted by your paid-up license fees, so long a such use is always in conjunction with Your Terminal. You may transfer ownership of the Terminal and equipment, including the r ight to use the Software to another party, so long as that party agrees to accept these terms and conditions.
YOU MAY NOT USE, COPY, MODIFY, TRANSLATE OR TRANSFER THE SOFTWARE, OR MODIFICATION THEREOF, IN WHOLE OR IN PART, EXCEPT AS EXPRESSL Y PROVIDED FOR IN THIS LICENSE. YOU MAY NOT DECOMPILE, REVERSE ENGINEER, OR OTHERWISE DECODE OR ALTER THE SOFTWARE.
The software is provided “AS IS”, and is delivered with no warranties, either express or implied.
LICENSOR MAKES AND YOU RECEIVE NO WARRANTIES ON THE SOFTWARE, EXPRESS, IMPLIED, OR STATUTORY, OR IN ANY OTHER PROVISION OF THIS AGREEMENT TO OR COMMUNICATION WITH YOU, AND LICENSOR DISCLAIMS ANY IMPLIED W ARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT AN D FITNE SS FOR ANY PARTICU LAR PURPO SE. LICENSOR DOES NOT WARRANT THAT THE FUNCITONS CONTAINED IN THE PRODUCT WILL MEET YOUR REQUIREMENTS OR THAT THE OPERATION WILL BE UNINTERRUPTED OR ERROR FREE.
SOME STATES DO NOT ALLOW LIMITATIONS ON HOW LONG AN IMPLIED WARRANTY LASTS SO THE ABOVE LIMITATION MAY NOT APPLY TO YOU. THIS WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. YOU MAY ALSO HAVE OTHER RIGHTS WHI C H VARY FROM STATE TO STATE.
Limit of liability
Export Restrictions
U.S. Gover n ment Restricted Rights
UNDER NO CIRCUMSTANCES SHALL LICENSOR BE LIABLE FOR LOSS OF DATA, COST OF COVER, OR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY. THESE LIMIT ATIONS SHALL APPL Y EVEN IF LICENSOR OR ITS RESELLER HAS BEEN ADVISED OF THE POSSIBIL IT Y OF SUCH DAMAGES, AND NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY PROVIDED HEREIN.
YOU AGREE THAT THESE ARE THE ONLY APPLICABLE TERMS OF AGREEMENT BETWEEN US COVERING SOFTWARE AND THAT THEY SUPERSEDE ANY OTHER COMMUNIC ATIONS (ORAL OR WRITTEN) BETWEEN US RELATING TO THE SOFTWARE.
You agree You will not export or transmit the Software to any country to which export is restricted by applicable U.S. law or regulation without the written approval of the appropriate U.S. Government organization.
The Software is provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technological Data and computer software clause at DFARS 252. 227-7013 or in subparagraphs (c) (1) and (2) of the Commercial Computer Software-Restricted Rights at 8 C.F.R. 52-227-19 as applicable.
Overview
Introduction
About This Guide
About TN5250 Terminal Emulation
The TN5250 T er minal Emulation User’ s Guide, explains ho w to configure and use the TN5250 emulation on your terminal. This emulation is an option for terminals.
This guide is organized into three chapters and two appendixes:
Chapter 1, “Getting Started,” explains TN5250 terminal emulation connection definitions, connections, and emulator sessions.
Chapter 2, “The Menu System,” e x plains the TN525 0 onlin e menu sy stem including keyboard mapping, and how to navigate through the menu system.
Chapter 3, “Terminal Keyboard,” compares TN5250 and terminal keys, and outlines t he terminal’s keyboard feat ures.
Appendix A, “Error Messages,” lists error messages and solutions to problems reported by those error messages.
Appendix B, “Troubleshooting Aids,” provides a short guide for preparation in troubleshooting your terminal.
TN5250 terminal emulation provides the protocol to connect a terminal to IBM midrange systems (AS/400 servers). Once connected, the user can access and use legacy applications such as database and word processing through a terminal.
Product Features
TN5250 terminal emulation includes these easy-to-use features:
Interactive keyboard mapping
TN5250-style screen attributes, including color and attribute settings
Multiple sessions
Telnet protocol
Color terminal support
vi Overview
The TN5250 Connection
Guide Format Conventions
To operate TN5250 emulation, you must connect to an AS/400 server operating with OS/400 V ersion 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. Figure 1 shows the TN5250 connection related to a terminal.
Figure 1 The TN5250 Connection
TN5250 Terminal Emulation
Windows Terminal
Note TN5250 terminal emulation software is downloaded, stored, and
TCP/IP Network TN5250 Server
AS/400
operated on your terminal.
This section describes the format conventions used in this guide.
Text Format
Ta ble 1 lists the text format conventions used in this document.
Table 1 Text Format Conventions
Convention Description
Bold Indicates a factory default.
Italic Indicates emphasis, a new term, or book
title.
Keycaps
Indicates a key on the keyboard.
San Serif Compressed Indicates screen display.
Monospace Indicates user input.
Monospace Italic
Indicates user input variables.
Overview vii
Command and Key Sequence Format
Table 2 lists the command and key sequence formats used in this guide.
Table 2 Command and Key Sequence Format Conventions Convention Description
command <
xxx
> Command format.
The right and left angle brackets indicate the boundaries of the parameter list.
Alt + x
or
Alt + X
Key sequence format. To enter this type of key sequence, press the keys sim ultaneousl y in the sequence shown. The operation is performed only when the last key is pressed.
Ctrl
(right)
key on the right side of the
Ctrl
keyboard in contrast to the one on the left side.
1
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 sessio ns .
Read this chapter carefully before attempting to connect to a TN5250 server.
Downloading TN5250 Option Firmware
TN5250 Server Connection Definitions
Preexisting Connection Definitions
The downloading of the TN5250 is similar to a flash download, and is done through the serial port, the parallel port, the Remote Administratio n tool, or the PCMCIA card.
Note TN5250 terminal emulation can be downloaded only to some terminals. Contact your system administrator or see the Terminal Firmware Download Instructions for options available for your terminal.
When your terminal is first turned on, the Connections dialog box dis plays. In this dialog box you will see the Connections list box. It is a list of preexisting connections. You can use one of these preexisting connections to connect to and start TN5250 emulation, or you can define a new TN5250 connection.
Note See your terminal’s connectivity guide for more information about connection definitions and the Connections dialog box.
To use a preexisting connection definition: 1 Click on an appropriate connection name in the Connections list box (see
Figure 1-1).
2 Click on the Connect command button.
1-2 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. 3 Click on the Properties command button in Connection Setup dialog box.
The Connection Properties dialog box displays. Use this dialog box to edit your preexisting connection de finition.
New Connection Definitions
If the connection def initio n you w ant does no t already e xist in t he Connections list, you can create one by:
1 Click on the Setup command button in th e Connections dialog box. 2 Click on the New command button in the Connection Setup dialog box. 3 Click on the Terminal Emulation radio button, then the OK command button
in the New Connection dialog box.
Note See your terminal’s connectivity guide for more information about instructions 1 throu gh 3 ab o ve. Refer to Figure 1-1, the Connection Properties dialog box, while executing instructions 4 through 8.
Figure 1-1 Connection Properties Dialog Box
4 Click on the TN5250 radio button in the Terminal Type group box. 5 Enter a connection description (a name you choose) in the Description
entry field.
Getting Started 1-3
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.
7 If you wish to activate the reverse video display, click the Reverse Screen
button. This effects reverse video in all the subsequent displays of the
session.Click on the OK command button. 8 Click on the Close command button in the Connection Setup dialog box. After you click on the Close command button, a dial og box appears di splaying
the message:
Flash Write In Progress, Do Not Power Down Unit
This message indicates that your new connection definition is being stored in the terminal’s memory.
When the flash write is finished, the new connection appears in the Connections list in the Connections dialog box. To connect, highlight the connection, then click on the Connect command button in the Connections dialog box. A message displays:
TN5250 Command Options
Trying to connect to XXX.XXX.XX.XX.
Connected to XXX.XXX.XX.XX.
Table 1-1 lists the command options that can be included in the Server Name field.
Table 1-1 TN5250 Command Options Option Description
-escape <character> Sets the escape character for escaping from a session. Specify character as:
A single character.
A key combination.
hostname Lets you specify a host name for
immediately di splaying a session. The host name is the name of your AS/400 host.
1-4 Chapter 1
Table 1-1 TN5250 Command Options, Continued Option Description
-terminal <terminal type> Specifies the type of terminal format for the data you receive from the host. Specify terminal type as:
IBM 3179-2
IBM 5251-11
IBM 3196-A1
PC-XT
NVT
This option overrides terminal negotiations.
-port <#> Specifies the host port you want to use.
-? Displays the command option
summary.
-version Displays the version number and environment variable settings.
Note The default command options are:
Host Name: OCS_Gateway.
Port Number: 23.
Note Pressing
when the cursor is positioned next to any field listed in
F4
Table 1-1 displays a list of choices for that function.
Sessions
If you connect to a TN5250 server using a definition that contains an IP address, the emulator will open up an initial TN5250 ses sio n (emulator­opened session) using that IP address. That session will be placed in the Sessions list in the Sessions menu, as the initial open session (see Chapter 2, “The Menu System,” for more information).
If you try to connect to a server using a definition that does not contain an IP address, you will not connect. Instead, the emulator will display the TN5250 menu system, allowing you to create a session (user-opened session). Once a session is created, you can then connect and run your session.
A session must be opened to use TN5250 terminal emulation. This section discusses both emulator-opened sessions and user-opened sessions.
Getting Started 1-5
Emulator-Opened Sessions
If you have specified an IP address in your connection definition, then once connected the Pass Through Screen displays (see Figure 1-2).
Figure 1-2 Pass Through Screen
Pass Through Screen
Type choices, Press Enter.
Remote location name AS400A Mode name LU62APPC Virtual controller QPACTL00 Virtual display device ___________ Remote network identifier ___________ Local PU name MKPTU3 Local LU name ___________
An initial session has been opened by the emulator. From the Pass Through Screen, press
sessions, press
(right) to go to the first open session. To open subsequent
Ctrl
. The main menu will display. Use the Sessions menu to
Alt + ?
open more sessions.
User-Opened Sessions
If you have not specified an IP address in your connection definition, then Main Menu - TN5250 displays (the main menu of the TN5250 user interface). Use this menu to open your initial sessi on. You will need to open a session to continue.
Note See Chapter 2, “The Menu System,” for further instructions about navigating through the TN5250 terminal emulation menu system.
To open a session:
1 Position the cursor at Open Session. 2 Press
Ctrl
.
1-6 Chapter 1
Ending a Session
3 In the Open Session menu with the
key select:
Tab
a Session: Enter a name for your session. b 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
Ctrl
.
Your initial ses sion will be opened.
Note The maximum number of simultaneous open sessions is three.
You can end a session in one of two ways: 1 Press
, while a session is displayed:
Alt + x
a Terminal emulation ends. b The terminal user interface displays.
If other sessions are active, the Open Session menu displays. You can end all open sessions by repeating the steps in 1 for each session, or resume a previous session. The terminal user interface will display only after all active sessions are ended.
2 Use Main Menu - TN5250:
a Press
+ ?, displaying Main Menu - TN5250.
Alt
b Position the cursor at Exit TN5250. c Press
Ctrl
.
The terminal user interface displays. See Chapter 2, “The Menu System,” for more information about ending TN5250 sessions.
Loading...
+ 35 hidden pages