Neoware Neoware c50 - Thin Client User manual

User's Guide
TeemTalk®5.0
for Unix

UK
Neoware UK Ltd
The Stables, Cosgrove
Milton Keynes MK19 7JJ
Tel: [phone]
Fax: [phone]
Email: [email protected]
USA
Neoware, Inc.
3200 Horizon Drive
King of Prussia, PA 19406
Tel: [phone]
Fax: [phone]
Email: [email protected]

TeemTalk
Software Support
Telephone: [phone]
Web: http://www.neoware.com/support/
Software Version 5.0.1
October 2004
Part number: TT5DM-5.0.1
Neoware UK Ltd,
The Stables, Cosgrove,
Milton Keynes, MK19 7JJ
Tel: [phone]
Fax: [phone]
TeemTalk © 1988-2004 Neoware UK Ltd, All Rights Reserved.
This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit. (http://www.openssl.org/)
This product includes cryptographic software written by Eric Young
([email protected])

The material in this user's guide is for information purposes only
and is subject to change without notice. Neoware UK Ltd
accepts no responsibility for any errors contained herein.
Trademarks
TeemTalk is a registered trademark of Neoware UK Ltd.
ADDS Viewpoint A2 is a trademark of Applied Digital Data Systems Inc.
D100, D200 and D410 are trademarks of Data General.
Dataspeed is a registered trademark of AT&T.
DEC, VT52, VT100, VT131, VT220, VT300, VT320, VT340, VT420, ReGIS,
DECstation, VAXstation, LK250, LN03 and LA50 are registered trademarks of Digital
Equipment Corporation.
Hazeltine is a trademark of Esprit Systems, Inc.
HP700/92, HP2392A, HP2622A and HP9000 are trademarks of Hewlett Packard Co.
IBM is a registered trademark of International Business Machines Corporation.
Motif is a trademark of the Open Software Foundation.
Open Look is a trademark of AT&T.
Prime is a registered trademark and PT250 is a trademark of Prime Computer, Inc.
Retrographics and VT640 are registered trademarks of Digital Engineering, Inc.
Sun is a registered trademark of Sun Microsystems, Inc.
Tandem, NonStop and LXN are trademarks of Tandem Computers Inc.
TeleVideo is a registered trademark, and TeleVideo 910, 910+ and 925 are trademarks
of TeleVideo Systems, Inc.
Tektronix is a registered trademark of Tektronix, Inc.
UNIX is a registered trademark of AT&T.
Westward is a registered trademark of Telemetrix, Inc.
WYSE is a registered trademark, and WY-50, WY-50+ and WY-60 are trademarks of
Wyse Technology Inc.
X Window System is a trademark of the Massachusetts Institute of Technology.
All other product names are trademarks of their respective manufacturers.
© 1988-2004 Neoware UK Ltd, All Rights Reserved.
Before reproduction of this material in part or in whole, obtain
written consent from Neoware UK Ltd.

Contents-1
Contents
Contents
Introduction ....................................................... 1-1
What Is TeemTalk for Unix ? ........................................................ 1-1
The X Window System & TeemTalk .............................................. 1-1
About This User's Guide ............................................................... 1-3
Terms & Conventions .................................................................... 1-5
Installing TeemTalk On UNIX Based Products 2-1
Operating System Requirements ................................................... 2-1
Installing From CD ....................................................................... 2-2
Installing From Tape..................................................................... 2-2
Creating A Licence Key File ......................................................... 2-3
Managing TeemTalk Licence Keys ............................................... 2-4
Licence Manager Errors .................................................................... 2-5
Installing Fonts On X Terminals ................................................... 2-6
NCD X Terminals.............................................................................. 2-6
Tektronix TekXpress X Terminals ................................................... 2-7
Hewlett Packard HP700RX X Terminals ......................................... 2-7
X Terminals From Other Vendors .................................................... 2-8
Understanding TeemTalk Installation........................................... 2-8
Extracting The TeemTalk Distribution Tape ................................... 2-8
Installation Stages ............................................................................. 2-9
Testing The Installation .............................................................. 2-11
Troubleshooting .......................................................................... 2-12

Contents-2
Contents
Getting Started.................................................. 3-1
Loading TeemTalk ......................................................................... 3-1
Running TeemTalk In The Background ........................................... 3-2
Quitting TeemTalk ......................................................................... 3-3
Host Communications ................................................................... 3-3
Initiating A Telnet Session ................................................................ 3-3
Serial Connection .............................................................................. 3-4
Selecting The Terminal Emulation ................................................ 3-6
Viewdata Mode ................................................................................. 3-9
Selecting & Using Window Elements .......................................... 3-11
The Title Bar ................................................................................... 3-11
The Menu Bar .................................................................................. 3-11
Window Resize Commands ............................................................ 3-12
The Scroll Bar ................................................................................. 3-12
The DEC VT Status Line ................................................................ 3-13
The Soft Buttons .............................................................................. 3-14
The Emulation Workspace .............................................................. 3-15
Keyboard Configuration ................................... 4-1
Introduction ................................................................................... 4-1
Specifying The Keyboard Type ...................................................... 4-1
Keyboard Nationality .................................................................... 4-2
Function Keys ................................................................................ 4-2
Remapping The Keyboard ............................................................. 4-2
Changing The Function Of A Key .................................................... 4-3
Compose Character Sequences ..................................................... 4-5
Mouse Functions .............................................. 5-1
Introduction ................................................................................... 5-1
Selecting & Copying Text.............................................................. 5-1
Graphic Copy & Paste .................................................................. 5-2
Moving The Cursor In Block Mode ............................................... 5-2
Show & Action Hotspots ............................................................... 5-2
Send Keyword ................................................................................ 5-3
Redefining The Mouse Buttons ...................................................... 5-3

Contents-3
Contents
Hotspots ............................................................ 6-1
Using Hotspots .............................................................................. 6-1
Defining Hotspots .......................................................................... 6-2
Print Facilities ................................................... 7-1
Selecting The Print Destination .................................................... 7-1
Troubleshooting The UNIX Print System...................................... 7-5
Setup Menus ..................................................... 8-1
Selecting & Closing Menus ........................................................... 8-1
Using The Menus ........................................................................... 8-2
Dialog Boxes ................................................................................. 8-2
Default Settings ............................................................................. 8-3
Saving The Setup ........................................................................... 8-3
Menu Descriptions ........................................................................ 8-4
File Menu ........................................................................................... 8-4
Telnet Options ................................................................................. 8-12
3270 Options ............................................................................. 8-14
5250 Options ............................................................................. 8-16
5250 Printer Options ................................................................. 8-18
SSL Connection Settings ................................................................. 8-22
SSH Connection Settings ................................................................ 8-24
Edit Menu ........................................................................................ 8-27
Settings Menu .................................................................................. 8-28
Emulation Settings .......................................................................... 8-30
Serial Settings .................................................................................. 8-35
Terminal Settings ............................................................................ 8-37
Tek Graphics Settings ..................................................................... 8-40
VT/ANSI/SCO Settings ................................................................... 8-41
HP700/92 Settings ........................................................................... 8-45
PT250 Settings ................................................................................. 8-50
TA6530 Settings .............................................................................. 8-53
IBM 3151 Settings ........................................................................... 8-55
Wyse Settings .................................................................................. 8-59
IBM 3270 Settings ........................................................................... 8-64
IBM 5250 Settings ........................................................................... 8-66
BQ 3107 Settings ............................................................................. 8-68
Keyboard Macros ............................................................................ 8-71

Contents-4
Contents
Attribute Settings ............................................................................. 8-74
Mouse Button Actions ..................................................................... 8-77
Help Menu ....................................................................................... 8-79
DEC VT Emulations .......................................... 9-1
Introduction ................................................................................... 9-1
Keyboard Mapping ........................................................................ 9-1
The Status Bar ............................................................................... 9-8
BQ 3107 Emulation ......................................... 10-1
Introduction ................................................................................. 10-1
The Status Bar ............................................................................. 10-1
Keyboard Mapping ...................................................................... 10-2
DG410 Emulation ............................................ 11-1
Introduction ................................................................................. 11-1
Keyboard Mapping ...................................................................... 11-1
HP700/92 Emulation ....................................... 12-1
Introduction ................................................................................. 12-1
Keyboard Mapping ...................................................................... 12-1
Buttons & Function Keys ............................................................ 12-5
Mode Selection ................................................................................ 12-5
Configuration Selection .................................................................. 12-8
Device Control................................................................................. 12-8
Device Modes ................................................................................ 12-10
Margins, Tabs & Start Column ..................................................... 12-11
Key Programming ..................................................................... 12-13
Character Display Attributes .................................................... 12-15
IBM 3270 Emulation ........................................ 13-1
Introduction ................................................................................. 13-1
Running The Emulation............................................................... 13-1
IBM 3287-1 Printer Support ....................................................... 13-3
Network Virtual Terminal Mode ................................................. 13-3
SysReq Key Support .................................................................... 13-3

Contents-5
Contents
The Status Line ............................................................................ 13-4
Keyboard Mapping ...................................................................... 13-6
Record & Playback Keystrokes Facility ................................... 13-11
Recording Keystrokes ................................................................... 13-11
Playback Keystrokes ..................................................................... 13-12
Error Codes .................................................................................... 13-12
IBM 5250 Emulation ........................................ 14-1
Introduction ................................................................................. 14-1
Running The Emulation............................................................... 14-1
Network Virtual Terminal Mode ................................................. 14-2
The Status Line ............................................................................ 14-3
Keyboard Mapping ...................................................................... 14-3
Record & Playback Keystrokes Facility ..................................... 14-7
Recording Keystrokes ..................................................................... 14-7
Playback Keystrokes ....................................................................... 14-8
Error Codes ...................................................................................... 14-8
Fax Image Support ...................................................................... 14-9
IBM 3151 Emulation ........................................ 15-1
Introduction ................................................................................. 15-1
The Status Line ............................................................................ 15-1
Defining Function Keys ............................................................... 15-3
Keyboard Mapping ...................................................................... 15-4
MDIS Prism Emulations ................................. 16-1
Introduction ................................................................................. 16-1
Keyboard Mapping ...................................................................... 16-1
PT250 Emulation............................................. 17-1
Introduction ................................................................................. 17-1
The Status Line ............................................................................ 17-1
Keyboard Mapping ...................................................................... 17-3
Displaying Alternate Characters ................................................ 17-7

Contents-6
Contents
Siemens 97801 Emulation.............................. 18-1
Introduction ................................................................................. 18-1
Keyboard Mapping ...................................................................... 18-1
Stratus V102 Emulation .................................. 19-1
Introduction ................................................................................. 19-1
The Status Line ............................................................................ 19-1
Keyboard Mapping ...................................................................... 19-2
TA6530 Emulation ........................................... 20-1
Introduction ................................................................................. 20-1
The Status Line ............................................................................ 20-1
Operating Modes ......................................................................... 20-2
Keyboard Mapping ...................................................................... 20-3
Wyse Emulations ............................................ 21-1
Introduction ................................................................................. 21-1
Display Format ........................................................................... 21-1
Status Line Messages .................................................................. 21-2
Keyboard Mapping ...................................................................... 21-3
File Transfer..................................................... 22-1
Introduction ................................................................................. 22-1
Protocols Supported .................................................................... 22-1
Sending Files ............................................................................... 22-3
Receiving Files ............................................................................ 22-5
Cancelling A File Transfer ......................................................... 22-6
Setting Protocol Parameters ....................................................... 22-7
General Parameters .......................................................................... 22-7
Kermit Parameters ........................................................................... 22-9
ZMODEM Parameters................................................................... 22-11
IXF Parameters .............................................................................. 22-14
Kermit Remote Operations ........................................................ 22-17
Local Operation ........................................................................ 22-19

Contents-7
Contents
IBM File Transfer ............................................. 23-1
Introduction ................................................................................. 23-1
Disabling Host Messages ............................................................ 23-1
Sending & Receiving Files .......................................................... 23-2
Ind$File Settings ......................................................................... 23-4
Private Profile File Entries ......................................................... 23-6
FTP File Transfer ............................................. 24-1
The Transfer Procedure .............................................................. 24-1
Menu Descriptions ...................................................................... 24-4
Connect Menu ................................................................................. 24-4
Operations Menu ............................................................................. 24-6
Transfer Settings Menu ................................................................... 24-8
Resources & Command Line Options........... 25-1
Introduction ................................................................................. 25-1
Resource Format ......................................................................... 25-2
Command Line Option Format ................................................... 25-3
Command Summary .................................................................... 25-4
General Operation & Setup ........................................................ 25-7
Telnet Session ............................................................................ 25-16
Display Format ......................................................................... 25-18
Window Elements ...................................................................... 25-23
Colour Selection ........................................................................ 25-26
Font Selection ............................................................................ 25-29
Understanding X Resources ...................................................... 25-33
Key Reference Numbers ..................................A-1
Keysyms ............................................................B-1
Virtual Keysyms............................................................................. B-1
Keysyms & Functions .................................................................... B-2
Virtual Key Names ............................................C-1
Sending Text To A File .................................................................. C-10

Contents-8
Contents
Sending Text To The Serial Port ................................................... C-10
Reading Text From A File ............................................................. C-11
Insert Delay..................................................................................... C-11
Product Specification ....................................... D-1

1-1
Introduction
1
Introduction
This chapter introduces the TeemTalk for Unix terminal emulation
software and describes the scope of this User's Guide.
What Is TeemTalk for Unix ?
TeemTalk is the essential connectivity tool for X Window based UNIX environments,
enabling non-X based applications to be run in the X environment. TeemTalk provides
precise emulation of a wide range of industry standard text and graphics terminals
with impressive additional features formulated to increase productivity and reduce
network loading. These include file transfer, dynamic window sizing, hotspots, soft
buttons, keyboard mapping, mouse button definition, customising capabilities,
scripting language, and an optional Application Programming Interface (API).
The XWindow System & TeemTalk
The X Window System is a network-based windowing system that provides a
common graphical interface for application programs. It defines how applications
create windows and the graphics displayed in them.
X is based on a client-server model in which the client is the application program and
the server controls the display and keeps track of user input. Communication
between client and server can be achieved via networks, serial interfaces or internal
operating system streams using standard X protocols. Since X is both window based
and network oriented there can be multiple applications on the network creating
individual windows on an individual display. The display is therefore providing a
service to each application and hence is known as the X display server.
The basic function of TeemTalk is to accept DEC, Tektronix, Retrographics, West-
ward, etc., command sequences from a host application (client) and convert them into
equivalent X functions which can then be passed on to the X display server. This
means that current investment in host application software can be retained in the X
Windows environment.

1-2
Introduction
Each window displayed by TeemTalk is, in effect, a separate 'terminal'. Several
terminal emulation windows may be displayed simultaneously on the same display
server, all running different programs, but only one window may be active at any one
time.
Relationship Between TeemTalk & The Application
X Server
Device independent
device driver
TeemTalk for Unix
Converts DEC, Tek & VT640
command sequences into
equivalent X functions
App 3
VT640
Network
Application 1
DEC based
application software
Application 2
Tek based
application software
Application 3
VT640 based
application software
Application 2
Tek 4010/4014
Application 1
VT320

1-3
Introduction
About This User's Guide
This User's Guide describes how to install and use TeemTalk for Unix. It assumes the
reader is familiar with the X Windows environment and the terminals that TeemTalk
emulates.
Chapter 1: Introduction
Introduces TeemTalk and describes the scope of this User's
Guide and various conventions used.
Chapter 2: Installing TeemTalk On UNI
X Based Products
Describes how to install TeemTalk on UNIX based products.
Chapter 3: Getting Started
Describes how to use TeemTalk and configure it for compatibility
with your hardware and the application.
Chapter 4: Keyboard Configuration
Describes how to configure TeemTalk for your particular keyboard
and remap key functions.
Chapter 5: Mouse Functions
Describes the special functions assigned to the mouse buttons by
TeemTalk and how to redefine the buttons.
Chapter 6: Hotspots
Describes the hotspot facility which enables functions to be
performed by clicking on keywords displayed on the screen.
Chapter 7: Print Facilities
Describes how to use the facilities provided by TeemTalk for
specifying where print data is directed, and also provides a
useful debugging guide for the UNIX print system.
Chapter 8: Setup Menus
Describes all the commands and setup dialog boxes that can be
accessed via pop-up menus in the menu bar.
Chapter 9: DEC VT Emulations
Describes features of the DEC VT emulations.
Chapter 10: BQ 3107 Emulation
Describes features of the Bull BQ 3107 emulation.
Chapter 11: DG410 Emulation
Describes features of the Data General D410 emulation.

1-4
Introduction
Chapter 12: HP700/92 Emulation
Describes features of the Hewlett Packard 700/92 emulation.
Chapter 13: IBM 3270 Emulation
Describes features of the IBM 3270 emulation.
Chapter 14: IBM 5250 Emulation
Describes features of the IBM 5250 emulation.
Chapter 15: IBM 3151 Emulation
Describes features of the IBM 3151 emulation.
Chapter 16: MDIS Prism Emulations
Describes features of the McDonnell Douglas Prism-8, Prism-9
and Prism-12 terminal emulations.
Chapter 17: PT250 Emulation
Describes features of the Prime PT250 emulation.
Chapter 18: Siemens 97801 Emulation
Describes features of the Siemens 97801 emulation.
Chapter 19: Stratus V102 Emulation
Describes features of the Stratus V102 emulation.
Chapter 20: TA6530 Emulation
Describes features of the Tandem 6530 emulation.
Chapter 21: Wyse Emulations
Describes features of the Wyse WY-50, WY-50+ and WY-60
emulations.
Chapter 22: File Transfer
Describes how to transfer files using the Kermit, XMODEM,
XMODEM-1K, YMODEM Batch, ZMODEM and IXF protocols.
Chapter 23: IBM File Transfer
Describes the IND$FILE file transfer utility for the IBM 3270
and 3151 emulations.
Chapter 24: FTP File Transfer
Describes how to transfer files in ASCII, Binary or Tenex
format between your workstation and systems running the
FTP daemon ftpd.
Chapter 25: Resources & Command Line Options
Describes how to use resources and command line options to
specify the loading configuration of TeemTalk.

1-5
Introduction
Appendix A: Key Reference Numbers
Lists the reference numbers assigned to keys on the British
keyboard.
Appendix B: Keysyms
Describes the use of virtual keysyms and lists all the valid
keysyms that may be used to define the function of keys.
Appendix C: Virtual Key Names
Lists all the virtual key names that enable you to include a
specific key function in a user definition for key macros, soft
buttons, hotspots, etc.
Appendix D: Product Specification
Describes the level of support provided by each terminal
emulation.
Terms & Conventions
This User's Guide uses the following terms and conventions.
1. Some sections of this User's Guide assume your version of TeemTalk includes the
graphics emulations when describing various procedures and commands. Refer-
ences to 340 (for graphics versions of TeemTalk) in filenames and command
descriptions should be substituted with 320 if you are using a version without the
graphics emulations, unless indicated otherwise.
2. When referring to mouse buttons, it will be assumed that the Left button is
configured as button 1, the Middle button is configured as button 2, and the
Right button is configured as button 3.
3. 'Click' means quickly press then release the specified mouse button.
4. 'Double click' means quickly press then release the specified mouse button twice in
quick succession.
5. 'Drag the pointer' means hold down the left mouse button (or button assigned with
the select function) and slide the mouse so that a selection box is displayed.
6. When references to keys are shown linked by a + (plus sign), this means that two
or more keys have to be pressed at the same time. For example, 'press Ctrl + M'
means press and hold down the Ctrl key, press the Mkey then release both keys.

1-6
Introduction
Notes

2-1
Installing TeemTalk On UNIX Based Products
2
Installing TeemTalk On
UNIX Based Products
This chapter describes the procedure for installin TeemTalk on UNIX
based products and how to install fonts on various X terminals.
Operating System Requirements
The table below shows the operating system versions that are required for each
machine type in order for TeemTalk to function correctly, and the tape device that is to
be specified when extracting TeemTalk from the supplied media.
achine
HP 9000 700/800
IB RS6000
Sun 4
SCO ODT
SCO OpenServer
Operating System
HP UX 9.01 or 10.0
AIX v3.2 (X11R5)
Sun Os 4.1.1
Solaris 2.5
v3.2.2
v5
Tape Device
/dev/rmt/0mn
/dev/rmt1.5
/dev/nrst8 or
/dev/nrst0
/dev/nrst4
/dev/nrct0
/dev/nrct0

2-2
Installing TeemTalk On UNIX Based Products
Installing From CD
To install TeemTalk from the CD:
1. Log in as root, change to the root directory of the CD and run the
TeemTalk installation script.
./install
2. When prompted, specify the product type and Unix system that
you are installing to.
Thereafter the installation will continue automatically.
Details on how to install the licence key and further information
on the installation are included in the file readme.
Installing From Tape
Super-user privileges will be required to perform the installation.
To install TeemTalk from the tape:
1. Create a temporary directory into which the contents of the tape
can be placed. For example:
mkdir /teemtalk_temp
cd /teemtalk_temp
2. Extract the tape contents using the following command:
tar xvf /dev/<device_name>
where <device_name> is specific to each machine type, as listed
in the table on the previous page.
Note: In all cases the device specified should reference the no-
rewind tape device.
3. Execute the ./readtape loader script. This will list a number of
machine targets and graphic user interface (GUI) styles. Select
the one that matches your machine model. ./readtape will then
load the required files for your system.
4. Execute the ./install installation script. This will move the
extracted files to the correct destination directories as well as
converting font definition files to the architecture of your machine.