IBM Terminal Emulation TN5250 User manual

TN5250 Terminal
Emulation
User’s Guide

TN5250 Terminal Emulation
User’s Guide

Contents
Overview
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
About This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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
Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4
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
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.
Restricted Rights
Legend
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
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). 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 fashion 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 right 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 EXPRESSLY PROVIDED FOR
IN THIS LICENSE. YOU MAY NOT DECOMPILE, REVERSE ENGINEER, OR OTHERWISE
DECODE OR ALTER THE SOFTWARE.
Disclaimer of Warranty
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 WARRANTIES OF
MERCHANTABILITY, NON-INFRINGEMENT AND FITNESS FOR ANY PARTICULAR PURPOSE.
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 WHICH VARY FROM
STATE TO STATE.
Limit of liability
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 LIMITATIONS SHALL APPLY EVEN IF LICENSOR OR
ITS RESELLER HAS BEEN ADVISED OF THE POSSIBILITY 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 COMMUNICATIONS
(ORAL OR WRITTEN) BETWEEN US RELATING TO THE SOFTWARE.
Export Restrictions
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.
U.S. Government Restricted
Rights
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
The TN5250 TerminalEmulation User’s Guide, explains how to configure and
use the TN5250 emulation on your terminal. This emulation is an option for
terminals.
About This Guide
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,” explains the TN5250 online menu system
including keyboard mapping, and how to navigate through the menu
system.
◆Chapter 3, “Terminal Keyboard,” compares TN5250 and terminal keys,
and outlines the terminal’s keyboard features.
◆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.
About TN5250
Terminal
Emulation
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
To operate TN5250 emulation, you must connect to an AS/400 server
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. Figure 1
shows the TN5250 connection related to a terminal.
Figure 1 The TN5250 Connection
❖Note TN5250 terminal emulation software is downloaded, stored, and
operated on your terminal.
Guide Format
Conventions
This section describes the format conventions used in this guide.
Text Format
Table 1 lists the text format conventions used in this document.
TN5250 Terminal
Emulation
Windows Terminal
TCP/IP Network TN5250 Server
AS/400
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 simultaneously in the
sequence shown. The operation is
performed only when the last key is
pressed.
Ctrl (right) Ctrl key on the right side of the
keyboard in contrast to the one on
the left side.