HP TeemTalk 5.0 User Manual

User's Guide

TeemTalk® 5.0

for Unix

UK

Neoware UK Ltd
Host Access Business Unit
The Stables, Cosgrove
Milton Keynes MK19 7JJ
Tel: [phone]
Fax: [phone]
Email: [e-mail]

USA

Neoware Systems, Inc.
400 Feheley Drive
King of Prussia, PA 19406
Tel: [phone]
Fax: [phone]

FRANCE

Neoware Systems, Inc.
58 rue Pottier, Suite 106
78150 LE CHESNAY
Tel: [phone]
Fax: [phone]

GERMANY

Neoware Systems GmbH
Höglwörther Str. 1
D - 81379 München
Tel: [phone]-NEOWARE
Tel: [phone]
Fax: [phone]

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, Host Access Business Unit,
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

([e-mail])

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

TeemTalk & The X Window System .............................................. 1-1

User's Guide Overview.................................................................. 1-2

Terms & Conventions.................................................................... 1-4

Getting Started.................................................. 2-1

Selecting The Terminal Emulation................................................ 2-1

Viewdata Mode ................................................................................. 2- 4

Host Communications ................................................................... 2-6

Initiating A Telnet Session................................................................2-6

Serial Connection .............................................................................. 2-7

Selecting & Using Window Elements............................................ 2-9

The Title Bar .....................................................................................2-9

The Menu Bar.................................................................................... 2-9

Window Resize Commands .....................................................2-10

The Scroll Bar ................................................................................. 2-11

The Status Bar ................................................................................. 2-11

The Soft Buttons..............................................................................2-13

The Emulation Workspace..............................................................2-13

Keyboard Configuration ................................... 3-1

Introduction ................................................................................... 3-1

Remapping The Keyboard ............................................................. 3-1

Changing The Function Of A Key .................................................... 3 -2

Programming Keys........................................................................ 3-4

Entering Control Characters .............................................................. 3-5

Compose Character Sequences ..................................................... 3-6

Contents-2

Contents

Mouse Functions .............................................. 4-1

Introduction ................................................................................... 4-1

Selecting & Copying Text.............................................................. 4-1

Graphic Copy & Paste .................................................................. 4-2

Moving The Cursor In Block Mode............................................... 4-2

Show & Action Hotspots ............................................................... 4-2

Send Keyword................................................................................ 4-3

Redefining The Mouse Buttons...................................................... 4-3

Hotspots............................................................ 5-1

Using Hotspots .............................................................................. 5-1

Defining Hotspots.......................................................................... 5-2

Setup Menus ..................................................... 6-1

Selecting & Closing Menus ........................................................... 6-1

Using The Menus........................................................................... 6-2

Dialog Boxes ................................................................................. 6-2

Default Settings ............................................................................. 6-3

Saving The Setup ........................................................................... 6-3

Menu Descriptions ........................................................................ 6-4

File Menu...........................................................................................6-4

Telnet Options ................................................................................. 6-10

3270 Options............................................................................. 6-12

5250 Options............................................................................. 6-14

5250 Printer Options.................................................................6-16

SSL Connection Settings.................................................................6-20

SSH Connection Settings ................................................................ 6-22

Settings Menu .................................................................................. 6-25

Emulation Settings .......................................................................... 6-27

Serial Settings .................................................................................. 6-32

Terminal Settings ............................................................................ 6-34

Tek Graphics Settings ..................................................................... 6-37

VT/ANSI/SCO Settings ................................................................... 6-38

HP700/92 Settings ...........................................................................6-42

PT250 Settings ................................................................................. 6-47

TA6530 Settings .............................................................................. 6-50

Contents-3

Contents

IBM 3151 Settings...........................................................................6-52

Wyse Settings ..................................................................................6-56

IBM 3270 Settings...........................................................................6-61

IBM 5250 Settings...........................................................................6-63

BQ 3107 Settings.............................................................................6-65

Keyboard Macros ............................................................................6-68

Attribute Settings ............................................................................. 6-71

Mouse Button Actions..................................................................... 6-74

Help Menu .......................................................................................6-76

DEC VT Emulations .......................................... 7-1

Introduction ................................................................................... 7-1

Keyboard Mapping........................................................................ 7-1

The Status Bar ............................................................................... 7-4

BQ 3107 Emulation........................................... 8-1

Introduction ................................................................................... 8-1

The Status Bar ............................................................................... 8-1

Keyboard Mapping........................................................................ 8-2

DG410 Emulation.............................................. 9-1

Introduction ................................................................................... 9-1

Keyboard Mapping........................................................................ 9-1

HP700/92 Emulation ....................................... 10-1

Introduction ................................................................................. 10-1

Keyboard Mapping...................................................................... 10-1

Buttons & Function Keys ............................................................ 10-3

Mode Selection................................................................................ 10-3

Configuration Selection .................................................................. 10-6

Device Control ................................................................................. 10-6

Device Modes ..................................................................................10-8

Margins, Tabs & Start Column ....................................................... 10-9

Key Programming ..................................................................... 10-11

Character Display Attributes .................................................... 10-13

Contents-4

Contents

IBM 3270 Emulation........................................ 11-1

Introduction ................................................................................. 11-1

Running The Emulation............................................................... 11-1

IBM 3287-1 Printer Support ....................................................... 11-3

Network Virtual Terminal Mode ................................................. 11-3

SysReq Key Support .................................................................... 11-3

The Status Line ............................................................................ 11-4

Keyboard Mapping...................................................................... 11-6

Record & Playback Keystrokes Facility ..................................... 11-8

Recording Keystrokes ..................................................................... 11-8

Playback Keystrokes ....................................................................... 11-9

Error Codes...................................................................................... 11-9

IBM 5250 Emulation........................................ 12-1

Introduction ................................................................................. 12-1

Running The Emulation............................................................... 12-1

Network Virtual Terminal Mode ................................................. 12-2

The Status Line ............................................................................ 12-3

Keyboard Mapping...................................................................... 12-3

Record & Playback Keystrokes Facility ..................................... 12-5

Recording Keystrokes ..................................................................... 12-5

Playback Keystrokes ....................................................................... 12-6

Error Codes...................................................................................... 12-6

Fax Image Support ...................................................................... 12-7

IBM 3151 Emulation........................................ 13-1

Introduction ................................................................................. 13-1

The Status Line ............................................................................ 13-1

Defining Function Keys............................................................... 13-3

Keyboard Mapping...................................................................... 13-4

MDIS Prism Emulations ................................. 14-1

Introduction ................................................................................. 14-1

Keyboard Mapping...................................................................... 14-1

Contents-5

Contents

PT250 Emulation............................................. 15-1

Introduction ................................................................................. 15-1

The Status Line ............................................................................ 15-1

Keyboard Mapping...................................................................... 15-3

Displaying Alternate Characters ................................................ 15-5

Siemens 97801 Emulation.............................. 16-1

Introduction ................................................................................. 16-1

Keyboard Mapping...................................................................... 16-1

Stratus V102 Emulation.................................. 17-1

Introduction ................................................................................. 17-1

The Status Line ............................................................................ 17-1

Keyboard Mapping...................................................................... 17-2

TA6530 Emulation........................................... 18-1

Introduction ................................................................................. 18-1

The Status Line ............................................................................ 18-1

Operating Modes......................................................................... 18-2

Keyboard Mapping...................................................................... 18-3

Wyse Em ulations ............................................ 19-1

Introduction ................................................................................. 19-1

Display Format ........................................................................... 19-1

Status Line Messages .................................................................. 19-2

Keyboard Mapping...................................................................... 19-3

Resources & Command Line Options........... 20-1

Introduction ................................................................................. 20-1

Resource Format ......................................................................... 20-2

Command Line Option Format ................................................... 20-2

Command Summary .................................................................... 20-3

General Operation & Setup ........................................................ 20-5

Telnet Session ............................................................................ 20-10

Contents-6

Contents

Display Format ......................................................................... 20-12

Window Elements ...................................................................... 20-16

Colour Selection ........................................................................ 20-19

Font Selection............................................................................ 20-22

Understanding X Resources ...................................................... 20-26

Key Ref erence Number s ..................................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

Sending Text To The Serial Port ................................................... C-10

Reading Text From A File ............................................................. C-1 1

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.

TeemTalk & The X Window System

TeemTalk for Unix is the essential connectivity tool for enabling non-X based
applications to be run in the X environment. TeemTalk provides precise emulation of a
wide range of industry standard terminals with impressive additional features formu­lated to increase productivity and reduce network loading. These include dynamic
window sizing, hotspots, soft buttons, keyboard mapping, mouse button definition and
customising capabilities. TeemTalk for Unix integrates seamlessly into the X Window
system with the same look and feel as other applications.

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 for Unix is to accept DEC, IBM, etc., command
sequences from a host application (client) and convert them into equivalent X func­tions 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.

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.

1-2

Introduction

User's Guide Overview

Chapter 1: Introduction

Introduces TeemTalk and describes various conventions used.

Chapter 2: Getting Started

Describes how to use TeemTalk and configure it for compatibility
with your hardware and the application.

Chapter 3: Keyboard Configuration

Describes how to configure the keyboard, remap key functions
and compose special characters.

Chapter 4: Mouse Functions

Describes the special functions assigned to the mouse buttons by
TeemTalk and how to redefine the buttons.

Chapter 5: Hotspots

Describes the hotspot facility which enables functions to be
performed by clicking on keywords displayed on the screen.

Chapter 6: Setup Menus

Describes all the commands and setup dialog boxes that can
be accessed via pop-up menus in the menu bar.

Chapter 7: DEC VT Emulations

Describes features of the DEC VT emulations.

Chapter 8: BQ 3107 Emulation

Describes features of the Bull BQ 3107 emulation.

Chapter 9: DG410 Emulation

Describes features of the Data General D410 emulation.

Chapter 10: HP700/92 Emulation

Describes features of the Hewlett Packard 700/92 emulation.

Chapter 11: IBM 3270 Emulation

Describes features of the IBM 3270 emulation.

Chapter 12: IBM 5250 Emulation

Describes features of the IBM 5250 emulation.

Chapter 13: IBM 3151 Emulation

Describes features of the IBM 3151 emulation.

1-3

Introduction

Chapter 14: MDIS Prism Emulations

Describes features of the McDonnell Douglas Prism-8, Prism-9
and Prism-12 terminal emulations.

Chapter 15: PT250 Emulation

Describes features of the Prime PT250 emulation.

Chapter 16: Siemens 97801 Emulation

Describes features of the Siemens 97801 emulation.

Chapter 17: Stratus V102 Emulation

Describes features of the Stratus V102 emulation.

Chapter 18: TA6530 Emulation

Describes features of the Tandem 6530 emulation.

Chapter 19: Wyse Emulations

Describes features of the Wyse WY-50, WY-50+ and WY-60
emulations.

Chapter 20: Resources & Command Line Options

Describes how to use resources and command line options to
specify the loading configuration of TeemTalk.

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 emu­lation.

1-4

Introduction

Terms & Conventions

This User's Guide uses the following terms and conventions.

1. 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.

2. 'Click' means quickly press then release the specified mouse button.

3. 'Double click' means quickly press then release the specified mouse button
twice in quick succession.

4. '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.

5. 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 M
key then release both keys.

2-1

Getting Started

2

Getting Started

This chapter describes how to configure TeemTalk for compatibility
with your hardware and the application.

Selecting The Terminal Emulation

When you load TeemTalk for the first time, the DEC VT400 (7-bit) emulation will be
running by default. The current emulation can be changed in one of two ways, either
from the status line or by using a setup dialog box. When an indicator status line with
six buttons is displayed at the bottom of the window, you can change the current DEC
VT terminal emulation to any other DEC VT terminal emulation (VT52, VT100,
VT400 7-Bit or VT400 8-Bit) by clicking the button indicating the current emulation.

All the terminal emulations supported by TeemTalk can be accessed from the Emula-

tion Settings dialog box. This is displayed by selecting Settings in the menu bar then
Emulation... The emulations available are listed in the Alpha Emulation and

Graphics Emulation boxes. To change the current emulation mode, click the pointer on
the name of the emulation required then click Ok. The new setting may be saved so
that TeemTalk will automatically run it when loaded or reset by selecting the Save
Settings option in the File menu.

2-2

Getting Started

Alpha Emulations

The ADDS A2 emulation provides compatibility with software designed to drive the
ADDS Viewpoint A2 terminal, as emulated by the Wyse WY-50/50+/60 terminals.
Refer to the Wyse Emulations chapter for more details.

The AIXTerm emulation provides compatibility with software designed to drive an X
terminal using X Windows.

The ANSI-BBS emulation is a derivative of the ANSI device driver ANSI.SYS
supplied with all DOS based PCs and which provides the screen management for the
DOS console screen. PC based UNIX systems and Bulletin Board Systems (BBS)
often rely on the ANSI emulation when being accessed by a PC. In ANSI-BBS mode
the screen size is adjusted to 25 lines and the Preferred Font is automatically set to
ANSI-BBS. The setting of the ANSI Codepage option in this dialog box determines
the characters available in the ANSI BBS set. Refer to the Setup Menus chapter for
details.

The AT 386 emulation provides compatibility with software designed to drive the
AT&T AT 386 terminal.

The AT&T4410 emulation provides compatibility with software designed to drive the
AT&T Dataspeed 4410 terminal. Refer to the AT&T 4410 Emulation section later.

The BQ3107 emulation provides compatibility with software designed to drive the
Bull BQ 3107 terminal. Refer to the BQ 3107 Emulation chapter for details.

The DG410 emulation enables you to run applications written for the Data General
D410 terminal. Refer to the DG410 Emulation chapter for information on keyboard
mapping.

DOC18 emulates VT220+ (DOC-18). It runs the VT300 8-bit emulation, sets the
numeric keypad to application mode, sets the display to 25 lines and enables a special
character set. The function of the keys F1 to F4 on the numeric keypad are mapped to
the first four function keys in the set of F1 to F12 function keys, and F5 to F12
perform the same functions as the equivalent keys on the VT220 keyboard.

The HP70092 emulation enables you to run applications written for the Hewlett
Packard 700/92, 2392A and 2622A terminals. Refer to the HP700/92 Emulation
chapter for details.

The HZ 1500 emulation provides compatibility with software designed to drive the
Hazeltine 1500 terminal, as emulated by the Wyse WY-50/50+/60 terminals. Refer to
the Wyse Emulations chapter for more details.

The IBM 3151 emulation provides compatibility with software designed to drive the
IBM 3151 terminal. Refer to the IBM 3151 Emulation chapter for information.

The IBM 3270 emulation provides compatibility with software designed to drive the
IBM 3270 terminal. Note that the initial display will be an ASCII text screen known as
the Network Virtual Terminal Mode. You are required to make a host connection
using the Telnet facility supplied with TeemTalk in order to display the IBM 3270

2-3

Getting Started

screen and enable the emulation to function correctly. The setting of the Model option
in the IBM 3270 Settings dialog box determines the size of the display and whether or
not extended attributes are supported (this must only be changed while running the
IBM 3270 emulation and the new setting will not take effect until you save it and
restart TeemTalk). Refer to the IBM 3270 Emulation chapter for more information.

The IBM 5250 emulation provides compatibility with software designed to drive IBM
5250 type alphanumeric terminals. This emulation can be used for connection to an
IBM AS/400, System/36 or System/38. Note that the initial display will be an ASCII
text screen known as the Network Virtual Terminal Mode. You are required to make a
host connection using the Telnet facility supplied with TeemTalk in order to display
the IBM 5250 screen and enable the emulation to function correctly. Refer to the IBM
5250 Emulation chapter for more information.

The ICL7561 emulation is not currently supported by TeemTalk.
The MDI P8/P12 emulation provides compatibility with software designed to drive

the McDonnell Douglas Prism-12 and Prism-8 terminals.
The MDI P9 emulation provides compatibility with software designed to drive the

McDonnell Douglas Prism-9 terminal.
The PT250 emulation provides compatibility with software designed to drive the

Prime PT250 terminal. Refer to the PT250 Emulation chapter for details.
SCO-CONSOLE is an emulation of the SCO UNIX box.
The Siemens 97801 emulation provides compatibility with software designed to drive

the Siemens 97801 terminal. Refer to the Siemens 97801 Emulation chapter for details.
The STRATUS V102 emulation provides compatibility with software designed to

drive the Stratus V102 terminal.
The TA6530 emulation provides compatibility with software designed to drive the

Tandem 6526 and 6530 terminals. You must make a host connection using the Telnet
facility supplied with TeemTalk in order for this mode to function correctly in block
mode applications. Refer to the TA6530 Emulation chapter for details.

The TVI 910+, 920 and 925 emulations provide compatibility with software designed
to drive the TeleVideo 910+, 920 and 925 terminals, respectively, as emulated by the
Wyse WY-50/50+/60 terminals. Refer to the Wyse Emulations chapter for more
details.

The TVI 950 and TVI 955 emulations provide compatibility with software designed
to drive the TeleVideo 950 and 955 terminals, respectively.

The Viewdata 40, Viewdata 80 and Viewdata Split modes enable access to a
viewdata service using one of three display formats, as described in the Viewdata
Mode section later.

The VT52 and VT100 emulations enable you to run applications written for the DEC
VT52 and VT100 terminals, respectively. Refer to the DEC VT Emulations chapter for
more information.

2-4

Getting Started

The VT400 Series-7 and VT400 Series-8 emulations enable you to run applications
written for the DEC VT400 terminal, the difference is in their treatment of 8-bit
control codes. When VT400 Series-7 is selected, all 8-bit codes are converted to their
7-bit equivalents, whereas VT400 Series-8 leaves 8-bit codes unchanged. If you are
using VT200 applications, select VT400 Series-7. Refer to the DEC VT Emulations
chapter for more information.

The WYSE 50, 50+ and 60 emulations provide compatibility with software designed
to drive the Wyse WY-50, WY-50+ and WY-60 terminals, respectively. Refer to the
Wyse Emulations chapter for information on these emulations.

Graphics Emulations

The 4010/4014 emulation enables you to run applications written for the Tektronix
4010 and 4014 terminals.

The Regis emulation enables you to run applications written for the DEC VT340
terminal in ReGIS mode.

The VT640 emulation enables you to run applications written for the Retrographics
VT640 terminal.

The Westward 2119 emulation enables you to run applications written for the
Westward 2119 terminal.

Viewdata Mode

TeemTalk enables you to select one of three display formats for viewdata mode: 40
column, 80 column, or Split Screen. Selecting Viewdata 40 or Viewdata 80 mode
will enable a single viewdata page of 40 or 80 columns wide by 24 lines deep to be
displayed.

Viewdata Split enables simultaneous display of two pages side by side, each page
consisting of 24 lines and 40 columns. Receipt of a clear screen command will move
the cursor to the home position of the opposite page and its contents will be erased
ready for the next page.

The keys mapped as PF1 through PF4 have the following functions in viewdata
mode:

PF1:* PF3: Reveal
PF2:# PF4: Exit to ANSI mode

2-5

Getting Started

AT&T 4410 Emulation

In AT&T 4410 mode the display size is 80 (or 132) columns by 25 lines with a scroll
region of 24 lines. A row of function buttons is displayed along the bottom of the
window. These correspond to the function keys F1 through F8 on the keyboard.

You can action a programmed function either by pressing the function key or click-ing
the equivalent button displayed on the screen. The middle button will toggle display of
the soft buttons on and off when clicked.

To program the function keys, press any F1 - F8 key shifted. The Program Function
Keys menu will be displayed.

Each line relates to one particular function key and its button. The two fields following
the f-key number allow you to enter a two line label of up to sixteen
characters for the equivalent button on the screen. These are followed by the definition
line which contains an escape sequence by default. Each definition can contain up to
50 ASCII characters.

To program an f-key, press the F1 key to move the cursor to the relevant line and use
the cursor keys to move from one section of the line to another. You must press the F1
key to end each definition line entry so that extra space characters are not sent to the
host. Note that using the cursor keys to move to the next line will cause the remainder
of the definition line to be sent as spaces.

When you have finished defining the f-keys, press F7 to save the definitions and exit
from the menu. If you want to exit without saving the settings, press F8.

2-6

Getting Started

Host Communications

TeemTalk can communicate with the operating system shell (STDIN and STDOUT)
or a host through an RS232 port. TeemTalk also includes a telnet driver for remote
host connection so that precise control can be exercised over the information that
TeemTalk receives and transmits. You must use the telnet facility provided by
TeemTalk when using block mode emulations such as IBM 3270.

Initiating A T elnet Session

TeemTalk has its own inbuilt telnet driver so that precise control can be exercised over
the information that TeemTalk receives and transmits. You must use the telnet facility
provided by TeemTalk when using block mode emulations such as IBM 3270.

A telnet session can be initiated from a dialog box while TeemTalk is running or by
using resources or command line options. Note that TeemTalk must be configured so
that it is running the required terminal emulation before initiating a telnet session.

You can initiate a telnet session while TeemTalk is running by displaying the File
menu and selecting the Open Connection option.

The Type list box is used to specify the type of host connection that is to be made:
TCP/IP, SSH2 (optional) or SSL/TLS (optional). The optional SSH (Secure Shell)
client/server protocol is used to encrypt and transmit data securely over a network,
with authentication (proof of client identity) provided by a password and/or key. The
optional SSL (Secure Sockets Layer) protocol enables authenticated and encrypted
communication between clients and servers.

Clicking the Configure or Telnet Options buttons will display additional options
which are described in the sections Telnet Options, SSL Connection Settings and SSH
Connection Settings in the Setup Menus chapter.

A list of hosts currently available for connection will be displayed in the Connect To
box on UNIX based systems. To make a connection, either click on the name in the list
or type it in, then click Connect.

2-7

Getting Started

To save the settings so that they will be automatically reasserted when TeemTalk is
subsequently reset or loaded, display the File menu and select the Save Settings
option.

Note that you can use resources or command line options to initiate a telnet session,
specify the telnet port number, and force TeemTalk to exit when the connection closes.
Refer to the Resources & Command Line Options chapter for details.

Serial Connection

To configure TeemTalk for a serial host connection, display the Settings menu and
select the Serial... option.

The setting of the Use Serial Port option determines whether TeemTalk will commu­nicate with the operating system shell or a host via an RS232 port. Select the option if
you wish to use the serial port. Host communications will be made via the RS232 port
device specified in the Serial Port box. For example:

Sun: /dev/ttya
HP: /dev/tty0
VAX: TTA0:

If an invalid device is specified, or the device cannot be accessed, communication will
be defaulted back to the operating system shell.

When TeemTalk is communicating with the operating system shell, the Parity setting
is used to specify the number of data bits. Selecting one of the 8 bit settings will
prevent the 8th bit from being stripped, while a 7 bit setting will strip the 8th bit. The
other options in this dialog box only apply if TeemTalk is to communicate with a host
via an RS232 serial port.

If TeemTalk is to communicate to a host via the serial port, you must set the baud rate,
stop bits, parity and flow protocol to match that of the host to which you will be
communicating. The Transmit Rate option enables you to specify the maximum

2-8

Getting Started

effective baud rate that TeemTalk transmits at. This is used to artificially reduce data
rates on higher baud rate interfaces.

When the options are set correctly, click Ok to make the changes take effect and close
the dialog box. To save the settings so that they will be automatically reasserted when
TeemTalk is subsequently reset or loaded, display the File menu and select the Save
Settings option.

2-9

Getting Started

Selecting & Using Window Elements

The TeemTalk window consists of various elements which are described in the
following sections.

The Title Bar

The title bar displays the name of your version of TeemTalk software by default. You
may change the title displayed by using the title resource or -title command line option
followed by a space then the title to be assigned. This is useful for identifying each
window when more than one instance of TeemTalk is being run. Refer to the Re-
sources & Command Line Options chapter for more details.

The Menu Bar

The menu bar provides access to a series of commands and dialog boxes which enable
you to perform various functions and configure TeemTalk for compatibility with your
hardware and the application. Three menus may be displayed from the menu bar. To
display a menu, click on its title.

2-10

Getting Started

To select an option in the menu, just click the pointer over it. To close the menu
without selecting an option, move the pointer outside the menu and click the left
mouse button. All the options listed in the menus are described in the Setup Menus
chapter.

Window Resize Commands

The menu bar includes two commands labelled < and > which enable the window size
to be decreased or increased, respectively.

When the < command is clicked, TeemTalk will scan a list of known fonts and select
the next smallest font to that currently being used. The window size is then decreased
so that it contains exactly the same number of rows and columns as before.

When the > command is clicked, TeemTalk will scan a list of known fonts and select
the next largest font to that currently being used. The window size is then increased so
that it contains exactly the same number of rows and columns as before.

You can achieve the same effect using the keyboard by pressing the Meta and < keys
together to decrease the window size, or Meta and > to increase the window size.

Note: The action names for these functions are decrease-font()

and increase-font(). They can be reassigned using the
Translation tables as described in the Keyboard
Configuration chapter.

The window resize commands may be disabled using resources as described in the
Resources & Command Line Options chapter.

2-11

Getting Started

The Scroll Bar

Displayable data is stored in a buffer which may be larger than the window. The scroll
bar down the right edge of the window represents the entire buffer and enables you to
display data that is above or below the current view of the window.

The number of text lines displayed in the window is specified by the defaultLines
resource or -dl command line option (default 24 lines), and the number of lines stored
off-screen in the buffer is specified by the saveLines resource or the -sl command line
option (default 24 lines).

The scroll bar represents the entire buffer and the scroll thumb represents the portion of
the buffer currently displayed in the window, consequently the size of the scroll thumb
will vary.

The window contents can be moved up or down by placing the pointer over the scroll
thumb, holding down the middle mouse button then moving the mouse up or down.

Placing the pointer anywhere in the scroll bar then clicking the left mouse button will
scroll the window contents up the number of lines equal to that from the pointer
position to the top of the window. Clicking the right mouse button will scroll the
window contents down the number of lines equal to that from the pointer position to
the bottom of the window.

Scrolling Using The Keyboard

When you are running one of the DEC 'VT' terminal emulations, you can scroll
vertically by holding down the Ctrl key and pressing the Up or Down Cursor keys.

When you are running one of the DEC 'VT' terminal emulations, it is possible to make
the width of display memory larger than the width of the window by using the Page
Width option in the VT/ANSI/SCO Settings dialog box. When you want to view
columns stored off-screen, you can scroll horizontally by holding down the Ctrl key
and pressing the Left or Right Cursor keys.

The Status Bar

A status bar can be displayed on the last line in the window when running any of the
DEC VT, ANSI or SCO-Console emulations.

You may choose not to display a status bar, or enable a host-writable status line to be
displayed instead. The type of DEC status line displayed is determined by the setting
of the Status Line option in the VT/ANSI/SCO Settings dialog box. (Refer to the
Setup Menus chapter for details.)

The indicator status bar consists of six buttons which show the status of various
operations and enable you to make selections. Some buttons can be clicked using the
mouse pointer to change their state.

2-12

Getting Started

12 3 45 6

Button 1: This button displays the active session (always 1), the current page number

(always 1), and the line,column location of the text cursor.
Clicking the button will activate the Hold Screen function, stopping data

from scrolling in the window. To resume scrolling, click the button again.

Button 2: This button toggles the visibility of the soft buttons displayed at the

bottom of the window on and off.

Button 3: This button indicates whether Overstrike Mode or Insert Mode is

currently selected.
In Overstrike Mode (default), new characters will replace already existing

characters at the cursor position. When Insert Mode is selected, new
characters will be inserted at the cursor position without deleting existing
characters, which will move to the right.

Button 4: Indicates the current DEC VT alpha terminal emulation (VT52, VT100,

VT400 7-Bit or 8-Bit). Clicking the button enables you to select a
different DEC VT alpha terminal emulation mode without having to
display the Emulation Settings dialog box, which will be updated
automatically with the new setting.

Button 5: Indicates whether you are Online to the host or in Local mode. Clicking

the button will toggle between the two modes.

Button 6: Indicates the status of the printer as follows:

None signifies that the printer is not turned on or not connected.
Not Ready signifies that the printer is not ready to receive data for

printing.

Ready signifies that the printer is ready to receive data for printing.
Auto signifies that the emulation is in Auto Print mode in which the

current cursor line is sent to the printer when a command for the cursor to
move to the next line is issued.

Controller signifies that the emulation is in Printer Controller mode in
which the host has direct control over the printer. Print screen commands
issued from the keyboard or mouse will be ignored.

This button does not perform any function when clicked.

2-13

Getting Started

The Soft Buttons

A series of buttons is displayed below the status line at the bottom of the window by
default when TeemTalk is loaded. These can be programmed so that they perform
various functions when clicked.

There are four levels of soft buttons. Each level consists of two rows with six program­mable buttons on each row. This provides a combined total of 48 programmable
buttons. All levels are accessible even if not all are displayed. Levels stored off-screen
can be 'scrolled' into view by clicking the Level button. You can specify how many
levels of soft buttons are actually displayed by using a resource or command line
option.

The soft buttons are programmed using the Keyboard Macros dialog box, which is
displayed by selecting Settings in the menu bar then Keyboard Macros... Refer to the
Setup Menus chapter for information.

You can toggle the visibility of the soft buttons on and off by clicking the second
button in the DEC indicator status line.

The Emulation Workspace

The emulation workspace is the area which emulates the display of the terminal
specified in setup (the DEC VT400 terminal by default) and where work is carried out
with an application.

The number of text lines displayed in the emulation workspace is set to 24 lines with
an indicator status line on the 25th line by default. You can specify the number of lines
displayed by using a resource or command line option. The number of columns that
are displayed and stored in memory can be specified by options in the Terminal /
Display Settings dialog box.

Refer to the section describing the Scroll Bar earlier for information on scrolling lines
and columns stored off-screen into view.

2-14

Getting Started

Notes

3-1

Keyboard Configuration

3

Keyboard Configuration

This chapter describes how to configure TeemTalk for your particular
keyboard, remap key functions and compose special characters.

Introduction

TeemTalk maps the keyboard to be as near as possible to the terminal being emulated.
Illustrations showing the mapping of functions are shown in each terminal emulation
chapter. You can remap the keyboard as required and functions that may not be
represented on the keyboard (Compose Character for example) can be assigned to
specific keys.

Remapping The Keyboard

As the legends on the keycaps may not correspond to the actual functions of the
keys, and the legends themselves may change from keyboard to keyboard, the X
Window System uses 'keysyms' to identify the function of keys. Each key has its
own unique keysym label which generally matches the function indicated by the
legend on the keycap. For example, the keysym for the Return key is Return.

When more than one key share the same function, the keysym includes an indication
of the location of each key on the keyboard. For example, the leftmost Shift key has
the keysym Shift_L, and the rightmost Shift key has the keysym Shift_R.

A list of valid keysyms defined by the X Window System can be found in the
Keysyms appendix. The keysym of a key is used to identify it for reconfiguration. To
find out the keysym for a particular key you should consult the documentation
supplied with the workstation. On some workstations a program called xev is
provided which enables interactive interrogation of a key's keysym.

You can find the keysym value of a key by placing TeemTalk in debug mode using
the -debug command line option or debugMode resource, then pressing a key or key
combination. The following information will be displayed when the F2 key on a Sun 4
keyboard is pressed:

3-2

Keyboard Configuration

Keycode = 13, State = 0, Keysym = 65471

The Keysym value can be directly used in Translation tables as shown in the following
example:

*xteemx320*vt220.Translations: #override \n\

<Key>65471: string("This is the F2 key")

Changing The Function Of A Key

Once the keysym of a particular key is known, you can change the function of that
key by using the Translations resource. This modifies a specified translation table
within the TeemTalk program which is used to assign events to actions. This table
should be placed in the .Xdefaults or application defaults file as described in the
Resources & Command Line Options chapter.

TeemTalk supports two action functions related to keyboard mapping: string and
value.

string("string")

This command will cause the specified string to be sent when the key specified in the
translation table is activated. For example:

string("This is a string action")

value(decimal value of ASCII character)

This command will map the specified key to send the character corresponding to the
ASCII decimal equivalent (ADE) of the value specified. For example:

value(27) will send the 'Escape' character (ESC is ASCII decimal 27).
Some of the values that can be specified do not directly cause characters to be

transmitted but invoke functions within TeemTalk instead. For example:

value(128) will cause TeemTalk to treat the activated key as F1 (function key 1), and
value(-166) will cause TeemTalk to treat the activated key as the Compose Charac-

ter key.

These values are either undefined ADE (ASCII decimal equivalent) codes or values
outside the range of ADE values. The values that TeemTalk expects for various keys
and functions can be ascertained from the Key Reference Numbers appendix.

T ranslation Resour ce Examples

The following example shows how to use the Translations resource to modify the
translation table so that the Compose Character function is assigned to the key that
has the keysym Meta_R.