HP Neoware e140 Thin Client User Manual

TeemTalk® 5.0

for Windows CE & XPe

User's Guide

USA

Neoware, Inc. 3200 Horizon Drive King of Prussia, PA 19406 Tel: +1-610-277-8300 Fax: +1-610-771-4200 Email: info@neoware.com

Neoware UK Ltd The Stables, Cosgrove Milton Keynes MK19 7JJ Tel: +44 (0) 1908 267111 Fax: +44 (0) 1908 267112 Email: teem-info@neoware.com

TeemTalk

Software Support

Telephone: +1-610-277-8300

Web: http://www.neoware.com/support/

Software Version 5.0.1

October 2004

Neoware UK Ltd, The Stables, Cosgrove, Milton Keynes, MK19 7JJ Tel: +44 (0) 1908 267111 Fax: +44 (0) 1908 267112

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

(eay@cryptsoft.com)

The material in this manual 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. AIX is a registered trademark of International Business Machines Corporation. D100, D200 and D410 are trademarks of Data General. Dataspeed is a registered trademark of AT&T. DEC, VT52, VT100, VT131, VT220, VT300, VT320 and VT340 are registered

trademarks of Digital Equipment Corporation. Hazeltine is a trademark of Esprit Systems, Inc. HP700/92, HP700/94, HP700/96, HP2392A and HP2622A are trademarks of Hewlett

Packard Company. IBM is a registered trademark of International Business Machines Corporation. Microsoft and MS-DOS are registered trademarks, and Windows and Excel are

trademarks of Microsoft Corporation. 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, PC-NFS and NFS are registered trademarks of Sun Microsystems, Inc. Tandem, NonStop and LXN are trademarks of Tandem Computers Inc. Tektronix is a registered trademark of Tektronix, Inc. TeleVideo is a registered trademark, and TeleVideo 910, 910+, 925, 950 and 955 are

trademarks of TeleVideo Systems, Inc. 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. All other product names are trademarks of their respective manufacturers.

written consent from Neoware UK Ltd.

Contents

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

About This User's Guide ............................................................... 1-1

Terms & Conventions .................................................................... 1-3

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

WBT Session Configuration .......................................................... 2-1

Using The Connection Wizard .......................................................... 2-1

Terminal Emulation Configuration ................................................... 2-4

Emulation Options ...................................................................... 2-4

Graphics Mode ............................................................................ 2-6

DEC Suite Options ..................................................................... 2-6

BQ 3107 Option .......................................................................... 2-7

HP 700-92/96 Option .................................................................. 2-7

IBM 3151 Option ........................................................................ 2-7

IBM 3270 Options ...................................................................... 2-7

IBM 5250 Options ...................................................................... 2-8

TCP/IP Connection Settings ............................................................. 2-9

TN3270 Options ....................................................................... 2-11

TN5250 Options ....................................................................... 2-13

5250 Printer Options ................................................................. 2-15

SSL Connection Settings ................................................................. 2-18

Notes About Certificates .......................................................... 2-19

SSH Connection Settings ................................................................ 2-21

SSH Key File Permissions ........................................................ 2-25

Modem Connection Settings ........................................................... 2-26

Serial Connection Settings .............................................................. 2-27

Automate Login Process ................................................................. 2-29

Printer Port Settings......................................................................... 2-31

GUI Overrides ................................................................................. 2-36

Aux Port Settings ............................................................................. 2-38

Contents-1

Contents

Session Management (Windows XPe) ......................................... 2-39

Logged On As System Administrator ............................................. 2-39

Logged On As A User ..................................................................... 2-39

TeemTalk for Windows CE Display ............................................ 2-41

Setup Menus (Windows CE) ........................................................... 2-41

The Button Tools (Windows CE) ................................................... 2-42

The Soft Buttons (Windows CE) .................................................... 2-43

TeemTalk for Windows XPe Display .......................................... 2-44

The Menu Bar (Windows XPe) ....................................................... 2-44

The Toolbar (Windows XPe) .......................................................... 2-45

The Soft Buttons (Windows XPe) ................................................... 2-45

The Status Bar ............................................................................. 2-46

Hotspots ....................................................................................... 2-47

AT&T 4410 Emulation ................................................................ 2-48

Viewdata Mode ............................................................................ 2-49

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

Keyboard Mapping ........................................................................ 3-1

Defining Key Functions ................................................................. 3-1

Defining A Key Or Key Combination .............................................. 3-2

Key Combinations & Sequences ....................................................... 3-3

Specifying Characters ....................................................................... 3-3

Compose Character Sequences ..................................................... 3-4

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

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

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

Selecting & Copying Text.............................................................. 4-2

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

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

Show & Action Hotspots ............................................................... 4-3

Emulating Middle Mouse Button .................................................. 4-3

The Toolbar ........................................................ 5-1

Using The Toolbar ........................................................................ 5-1

The Predefined Button Tools ......................................................... 5-1

Contents-2

Contents

Redefining The Toolbar................................................................. 5-3

Adding Buttons .................................................................................. 5-3

Adding A Space Between Buttons .................................................... 5-4

Removing A Button Or Space........................................................... 5-4

Saving The Button Tools .................................................................. 5-4

Assigning User-Defined Functions ................................................... 5-5

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

Displaying & Closing Menus ........................................................ 6-1

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

Dialog Boxes ................................................................................. 6-3

Default Settings ............................................................................. 6-4

Specifying Characters In Setup Entries ........................................ 6-4

Creating A Connection Template (CE) ......................................... 6-5

Selecting A Connection Template (CE)......................................... 6-6

Saving The Session Configuration (XPe) ...................................... 6-6

Save Using Current Session Name ................................................... 6-6

Save Using New Session Name ........................................................ 6-7

Selecting A Session Configuration (XPe) ...................................... 6-7

Menu Descriptions ........................................................................ 6-9

File Menu ........................................................................................... 6-9

Edit Menu ........................................................................................6-23

Settings Menu .................................................................................. 6-24

Emulation Settings .......................................................................... 6-26

HP 700-92/96 Settings ..................................................................... 6-30

PT250 Settings ................................................................................. 6-36

IBM 3151 Settings ........................................................................... 6-39

Wyse Settings .................................................................................. 6-43

TA6530 Settings .............................................................................. 6-48

IBM 3270 Settings ........................................................................... 6-50

Notice Board Setup ......................................................................... 6-54

IBM 5250 Settings ........................................................................... 6-56

Unisys T27 Settings ......................................................................... 6-61

General Settings ........................................................................ 6-61

Environments Settings .............................................................. 6-63

Tab Settings .............................................................................. 6-68

BQ 3107 Settings ............................................................................. 6-69

Serial Settings .................................................................................. 6-72

Contents-3

Contents

Auxport Setup .................................................................................. 6-74

Terminal Settings ............................................................................ 6-75

Tab Stops ......................................................................................... 6-82

Local Editing ................................................................................... 6-83

Block Transmission ......................................................................... 6-85

Tek 4014 Settings ............................................................................ 6-89

GIN Mouse Definitions ................................................................... 6-91

Attributes ......................................................................................... 6-92

Define Keyboard Macros ................................................................ 6-97

Defining A Key Or Key Combination ..................................... 6-98

Specifying Characters ............................................................... 6-99

Soft Buttons ...................................................................................6-100

Programming A Soft Button ................................................... 6-101

Specifying Characters ............................................................. 6-102

Mouse Button Actions ................................................................... 6-103

Button Tools .................................................................................. 6-105

Adding Buttons ....................................................................... 6-105

Adding A Space Between Buttons ......................................... 6-106

Removing A Button Or Space ................................................ 6-106

Saving The Button Tools ........................................................ 6-106

Assigning User-Defined Functions ........................................ 6-106

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

Session Configuration ................................................................... 7-1

WBT Mode ........................................................................................ 7-1

Non-WBT Mode ................................................................................ 7-2

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

Horizontal Scrolling ...................................................................... 7-5

Keyboard Mapping ........................................................................ 7-5

Typing Direction For Hebrew Language .......................................... 7-8

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

Session Configuration ................................................................... 8-1

WBT Mode ........................................................................................ 8-1

Non-WBT Mode ................................................................................ 8-2

The Status Bar ............................................................................... 8-3

Keyboard Mapping ........................................................................ 8-4

Contents-4

Contents

DG 410/412 Emulation ...................................... 9-1

Session Configuration ................................................................... 9-1

WBT Mode ........................................................................................ 9-1

Non-WBT Mode ................................................................................ 9-2

Keyboard Mapping ........................................................................ 9-3

Key Functions .................................................................................... 9-3

Key Codes .......................................................................................... 9-5

HP 700-92/96 Emulation ................................. 10-1

Session Configuration ................................................................. 10-1

WBT Mode ...................................................................................... 10-1

Non-WBT Mode .............................................................................. 10-2

Display Configuration ................................................................. 10-3

Keyboard Mapping ...................................................................... 10-3

Buttons & Function Keys ............................................................ 10-5

Mode Selection ................................................................................ 10-5

Configuration Selection .................................................................. 10-8

Device Control................................................................................. 10-8

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

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

Key Programming ..................................................................... 10-13

Character Display Attributes .................................................... 10-16

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

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

Session Configuration ................................................................. 11-1

WBT Mode ...................................................................................... 11-1

Non-WBT Mode .............................................................................. 11-2

Network Virtual Terminal Mode ................................................. 11-4

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

SysReq Key Support .................................................................... 11-4

The Status Line ............................................................................ 11-5

Text Display Options ................................................................... 11-9

Keyboard Mapping .................................................................... 11-10

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

Recording Keystrokes ................................................................... 11-12

Contents-5

Contents

Playback Keystrokes ..................................................................... 11-13

Editing Macros .............................................................................. 11-13

Error Codes .................................................................................... 11-14

Notice Board Facility ................................................................ 11-15

Introduction ................................................................................... 11-15

Key Functions ................................................................................ 11-15

Copying Screen Data To The Display .......................................... 11-15

Copying Screen Data To A Function Key .................................... 11-16

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

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

Session Configuration ................................................................. 12-1

WBT Mode ...................................................................................... 12-1

Non-WBT Mode .............................................................................. 12-3

Network Virtual Terminal Mode ................................................. 12-5

The Status Line ............................................................................ 12-5

Keyboard Mapping ...................................................................... 12-6

Word Processing Mode ................................................................... 12-6

Text Display Options ................................................................... 12-8

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

Recording Keystrokes ..................................................................... 12-9

Playback Keystrokes ..................................................................... 12-10

Error Codes .................................................................................... 12-10

Fax Image Support .................................................................... 12-11

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

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

Session Configuration ................................................................. 13-1

WBT Mode ...................................................................................... 13-1

Non-WBT Mode .............................................................................. 13-2

The Status Bar ............................................................................. 13-3

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

Defining Function Keys ............................................................... 13-6

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

Session Configuration ................................................................. 14-1

WBT Mode ...................................................................................... 14-1

Contents-6

Contents

Non-WBT Mode .............................................................................. 14-2

Keyboard Mapping ...................................................................... 14-3

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

Session Configuration ................................................................. 15-1

WBT Mode ...................................................................................... 15-1

Non-WBT Mode .............................................................................. 15-2

The Status Line ............................................................................ 15-3

Keyboard Mapping ...................................................................... 15-5

Displaying Alternate Characters ................................................ 15-7

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

Session Configuration ................................................................. 16-1

WBT Mode ...................................................................................... 16-1

Non-WBT Mode .............................................................................. 16-2

Keyboard Mapping ...................................................................... 16-3

TA6530 Emulation ........................................... 17-1

Session Configuration ................................................................. 17-1

WBT Mode ...................................................................................... 17-1

Non-WBT Mode .............................................................................. 17-2

The Status Line ............................................................................ 17-3

Operating Modes ......................................................................... 17-4

The Rule Cursor .......................................................................... 17-5

Keyboard Mapping ...................................................................... 17-5

Unisys T27 Emulation ..................................... 18-1

Session Configuration ................................................................. 18-1

WBT Mode ...................................................................................... 18-1

Non-WBT Mode .............................................................................. 18-2

The Status Bar ............................................................................. 18-3

Keyboard Mapping ...................................................................... 18-4

Wyse Emulations ............................................ 19-1

Session Configuration ................................................................. 19-1

WBT Mode ...................................................................................... 19-1

Contents-7

Contents

Non-WBT Mode .............................................................................. 19-2

Display Format ........................................................................... 19-4

Status Line Messages .................................................................. 19-4

Keyboard Mapping ...................................................................... 19-5

Initialization Commands ................................ 20-1

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

Command Summary .................................................................... 20-2

Host Connection .......................................................................... 20-5

Session Configuration ................................................................. 20-7

Display......................................................................................... 20-9

Keyboard & Mouse ................................................................... 20-20

Auxiliary Port ............................................................................ 20-21

Virtual Key Names ............................................A-1

Character Sets ..................................................B-1

Host Command Summary................................ C-1

Product Specification .......................................D-1

Contents-8

Introduction

This chapter introduces the contents of this User's Guide.

About This User's Guide

This User's Guide describes how to use TeemTalk version 5.0 for Windows CE and XPe. Most of the functionality is the same for both Windows CE and XPe versions, but where there are differences, the text will indicate them. Most of the dialog box illustrations show the Windows CE version of TeemTalk.

Note that your version of TeemTalk may not support every emulation or feature described in this User's Guide.

The User's Guide is divided into the following chapters and appendices:

Chapter 1: Introduction

Introduces the contents of this User's Guide.

Chapter 2: Getting Started

Describes how to configure a session and describes various display features.

Chapter 3: Keyboard Configuration

Describes how to assign functions to keys and how to use the Compose Character function to generate special characters.

Chapter 4: Mouse Functions

Describes the special functions assigned to the left mouse button and how to redefine them.

Chapter 5: The Toolbar

Describes how to use the TeemTalk for Windows XPe toolbar and assign functions to the buttons.

Chapter 6: Setup Menus

Describes all the commands and setup dialog boxes that can be accessed via drop-down menus in the command bar.

1-1

Introduction

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: DG 410/412 Emulation

Describes features of the Data General D410/412 emulation.

Chapter 10: HP700-92/96 Emulation

Describes features of the Hewlett Packard HP700/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.

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: TA6530 Emulation

Describes features of the Tandem 6530 emulation.

Chapter 18: Unisys T27 Emulation

Describes features of the Unisys T27 emulation.

Chapter 19: Wyse Emulations

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

Chapter 20: Initialization Commands

Describes commands that can be included in the registry and on the command line to specify the emulator start-up configuration.

Appendix A: Virtual Key Names

Lists all the virtual key names that enable you to include a specific key function in a user definition.

Appendix B: Character Sets

Shows the supported character set code tables.

1-2

Appendix C: Host Command Summary

Lists the host commands that are supported in each terminal emulation mode.

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. When references to keys on the keyboard 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 Alt + F' means press and hold down the Alt key, press the F key then release both keys.

2. 'Click' means position the mouse pointer over an element on the display then quickly press and release the specified mouse button.

3. 'Double click' means position the mouse pointer over an element on the display then quickly press and 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.

Introduction

1-3

Introduction

Notes

1-4

Getting Started

This chapter describes how to configure a session and describes various display features.

WBT Session Configuration

Using The Connection Wizard

This section describes the basic procedure for creating a session configuration in WBT mode. The options available are described in detail in the following sections.

1. Click the Configure tab in the Terminal Connection Manager then click the Add button to display the New Connection dialog box.

2. Select Terminal Emulation Client and click OK. The Connection Information dialog box will be displayed.

3. Specify the language to be used in all menus and dialog boxes by making a selection in the Operating Language list at the bottom of the dialog box.

2-1

Getting Started

4. Enter a name which will identify this session configuration for future selection in

the Connection Name box.

5. Select the terminal emulation required in the Emulation list box.

6. If additional configuration options are displayed, make the relevant selections. Refer to the Terminal Emulation Configuration section later in this chapter for details.

Clicking the International Settings button will display keyboard language and character set options for the selected terminal emulation. Refer to the relevant emulation settings dialog box description in the Setup Menus chapter for details. (Note that the DEC VT options are located in the Emulation and Terminal Settings dialog boxes.)

7. Click Next to display the Host Information dialog box.

2-2

For a TCP/IP connection, click the TCP/IP button and enter the name or internet address of the host computer in the Host Name box. Selecting the Host Rollover On Connection Fail option will present four Host Name entry boxes. The emulator will attempt to connect to each specified host in turn until one is successful. Click Advanced for Telnet options. Refer to the TCP/IP Connection Settings section later in this chapter for details.

For a modem connection, click the Modem button then click Advanced to display configuration options. Refer to the Modem Connection Settings section later in this chapter for details.

For a serial connection, click the Serial button, specify the communications port in the Connect To box, then click Advanced for additional serial options. Refer to the Serial Connection Settings section later in this chapter for details.

Getting Started

The optional SSL (Secure Sockets Layer) protocol enables authenticated and encrypted communication between clients and servers. Refer to the SSL Connec- tion section later in this chapter for details.

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. To enable an SSH connection, this option must be selected and the Telnet Port Number option set to the host's SSH port (22 is the default for SSH). When a Telnet connection is initiated, the SSH Connec- tion dialog box will be displayed prompting the user for authentication. Refer to the SSH Connection section later in this chapter for details.

Make the relevant selections then click OK to return to the Host Information dialog box, then click Next to display the Advanced Options dialog box.

8. The Advanced Options dialog box provides access to additional settings which

are described later in this chapter.

If you are running TeemTalk for Windows XPe and are logged on as system administrator, there will be two Session stored... options to enable a session to be created or modified either for yourself (current user) only, or for all users. Refer to the Session Management section later in this chapter for details.

9. When you have made your selections, click Finish to return to the Terminal Connection Manager.

10. In the Terminal Connection Manager, display the Connections list, select the session name you specified earlier in step 4, then click the Connect button.

2-3

Getting Started

Terminal Emulation Configuration

Emulation Options

The Emulation options in the Connection Wizard Connection Information dialog box are as follows:

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

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

The ATT4410 emulation provides compatibility with software designed to drive the AT&T Dataspeed 4410 terminal. Refer to the AT&T 4410 Emulation section later in this chapter for details.

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

The DG 410/412 emulation provides compatibility with software designed to drive the Data General D410 and D412 terminals. Refer to the DG 410/412 Emulation chapter for details.

The HP 700-92/96 emulation provides compatibility with software designed to drive the Hewlett Packard 700/92, 2392A, 2622A, 70094 and 70096 terminals. This emulation is described in detail in the HP 700-92/96 Emulation chapter.

The HZ1500 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 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 on this emulation.

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 Network Virtual Terminal mode (NVT mode for short). The setting of the IBM 3270 Model option determines the size of the display and whether or not extended attributes are supported. Refer to the IBM 3270 Emulation chapter for details.

2-4

Getting Started

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 Network Virtual Terminal mode (NVT mode for short). Refer to the IBM 5250 Emulation chapter for details.

The MDI P12\P8 emulation provides compatibility with software designed to drive the McDonnell Douglas Prism-12 and Prism-8 terminals. Refer to the MDIS Prism Emulations chapter for details.

The MDI Prism-9 emulation provides compatibility with software designed to drive the McDonnell Douglas Prism-9 terminal. Refer to the MDIS Prism Emulations chapter for details.

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 6530 terminal. This emulation is described in the TA6530 Emulation chapter.

The TVI 910, TVI 920 and TVI 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 details.

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

The Unisys T27 emulation provides compatibility with software designed to drive the Unisys T27 terminal. Refer to the Unisys T27 Emulation chapter for details.

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 in this chapter.

The VT PCTerm emulation provides compatibility with software designed for the PC Term mode supported by DEC. This is the same as the VT510 emulation except that keyboard scan codes are sent on key press/release instead of ASCII codes by default.

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

The VT500 7-Bit and VT500 8-Bit emulations enable you to run applications written for the DEC VT320 terminal, the difference is in their treatment of 8-bit control codes.

2-5

Getting Started

When VT500 7-Bit is selected, all 8-bit codes are converted to their 7-bit equivalents, whereas VT500 8-Bit leaves 8-bit codes unchanged. If you are using VT200 applications, select VT500 7-Bit. Refer to the DEC VT Emulations chapter for details.

The VT+HP220 emulation is based on the VT500 terminal series and includes the HP function keys F1 - F8 (not user programmable). The terminal ID is set to VT220.

The VT100+ emulation is an enhanced version of the VT100 emulation that provides additional functionality such as colours. It is the same as the VT-UTF8 emulation except that it only supports ASCII characters 0-127 (decimal).

The VT-UTF8 emulation is an enhanced version of the VT100 emulation that supports non-English and drawing characters. It supports localization of the singlebyte and double-byte character sets and all other languages supported by Windows. Additional functionality, such as colours, is also provided.

The WY50, WY50+ and WY60 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.

The WYSE PCTerm emulation provides compatibility with software designed for the PC Term personality supported by Wyse. Keyboard scan codes are sent on key press/ release instead of ASCII codes by default.

Graphics Mode

The Graphics Mode option is only available if your version of TeemTalk supports graphics emulations and the Emulation option is set to one of the DEC VT, Ansi BBS, AIXTerm, AT 386 or Sco Console emulations. The setting determines the graphics mode that will be entered when the host sends graphics commands.

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

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

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

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

DEC Suite Options

The VT Terminal ID option applies to the DEC VT emulations. It specifies what is reported back to the host in response to a terminal identification request. (Note that not all features of the specified terminal may be supported.)

The Cursor Moves Right to Left option applies to the DEC VT, Ansi BBS, AIXTerm, AT 386 and Sco Console emulations. It enables you change the direction in which the text cursor moves across the display.

2-6

Getting Started

The High Function Terminal option is displayed when the AIXTerm emulation is selected. This enables you to switch between HFT (High Function Terminal) mode (default) and VT100 mode.

BQ 3107 Option

The VIP Mode option enables you to set the VIP mode to 7700 or 7760.

HP 700-92/96 Option

The HP Model option specifies what is reported back to the host in response to a terminal identification request. This can be set to 70092 (default), 2392A, 2622A, 70094 or 70096. (Not all features of the specified terminal may be supported.)

IBM 3151 Option

The setting of the IBM 3151 Model option identifies the terminal model being emulated in response to a terminal identification request from the host. Model 11 supports only one viewport containing 24 or 25 rows and 80 columns. Model 31 supports up to three viewports (80 or 132 columns wide) and pass-through printing.

IBM 3270 Options

The setting of the IBM 3270 Model option specifies what is reported back to the host in response to a terminal identification request. (Note that not all features of the specified terminal may be supported.) TN3287 printing is supported by selecting 3287-1.

One of four display sizes can be selected:

3278/9-2 24 rows by 80 columns 3278/9-3 32 rows by 80 columns 3278/9-4 43 rows by 80 columns 3278/9-5 27 rows by 132 columns

3278 settings with the E extension provide support for the following extended

attributes (these are supported by the 3279 as standard):

3270 Field Attributes Extended Highlighting Foreground Colour Query Reply Inbound Structured Fields

The setting of the Left Ctrl acts as Reset Key option determines whether or not the left Control key performs the same function as the Reset key.

2-7

Getting Started

The setting of the Right Ctrl acts as Enter Key option determines whether or not the right Control key performs the same function as the keypad Enter key.

IBM 5250 Options

The IBM 5250 Model option specifies what is reported back to the host in response to a terminal identification request. (Note that not all features of the specified terminal may be supported.) The terminal models and their display characteristics are listed below:

Model Display Rows x Columns

5291_1 Monochrome 24 x 80 5292_2 Colour 24 x 80 5251_11 Monochrome 24 x 80 3179_2 Colour 24 x 80 (default) 3196_A1 Monochrome 24 x 80 3180_2 Monochrome 24 x 80 and 27 x 132 3477_FC Colour 24 x 80 and 27 x 132 3477_FG Monochrome 24 x 80 and 27 x 132 3486_BA Monochrome 24 x 80 3487_HA Monochrome 24 x 80 3487_HC Colour 24 x 80 5555_B01 Monochrome 24 x 80 5555_C01 Colour 24 x 80

The printer models are listed below:

3812-1 Single byte printer 5553-B01 Double byte printer

If double byte character sets (e.g. Japanese) are supported and you wish to use them, then select either 5555_B01 (monochrome) or 5555_C01 (colour) for display, or 5553-B01 for printing.

The setting of the IBM 5250 Monochrome option will match the normal display characteristic of the selected IBM 5250 model by default. Note that the emulation of all IBM 5250 models supports both monochrome and colour display. When monochrome is selected, characters will be displayed in green and intense fields will be displayed in white. When monochrome is not selected, the settings specified in the Attributes dialog box (described in the Setup Menus chapter) will be used for the display.

The setting of the Left Ctrl acts as Reset Key option determines whether or not the left Control key performs the same function as the Reset key.

The setting of the Right Ctrl acts as Enter Key option determines whether or not the right Control key performs the same function as the keypad Enter key.

The setting of the Carriage Return acts as Enter Key option determines whether or not the Return key performs the same function as the keypad Enter key.

2-8

Getting Started

TCP/IP Connection Settings

The TCP/IP Telnet Configuration dialog box can be displayed from the Connection Wizard Host Information dialog box by setting the Connection Type to TCP/IP then clicking the Advanced button, or the New Connection dialog box when in nonWBT mode by selecting TCP/IP in the Type list box then clicking the Configure button.

Note that the options available and the default settings depend on the current terminal emulation.

Host Port Number

This enables you to specify the Telnet port number. The default Telnet port number, 23, can be substituted with any valid 16 bit port number. Specifying a number outside the valid range will cause the setting to default to 1.

If an SSH (Secure Shell) connection is to be made, set this to the host's SSH port number (22 is the default for SSH).

Local Port Number

This enables you to specify the local Telnet port number if required. Setting this to 0 will cause the number to be allocated automatically.

Telnet Name

This enables you to override the name that will be reported for the terminal type over Telnet.

Enable Keep Alives

Selecting this option will prevent the session from being disconnected from the host by an inactivity timeout.

2-9

Getting Started

Connection Timeout (Secs:)

This enables you to specify how many seconds the emulator has to attempt to make a host connection before it either attempts to connect to the next host (if Host Rollover is specified in the Host Connection dialog box) or it issues a Connection Failed message. The default 0 setting will cause the emulator to use the stack default timeout.

Suppress Echo

When selected, this will will prevent the emulator from generating the Telnet echo option on connection.

Suppress 3270 Regime

When running the IBM 3270 emulation, the setting of this option determines whether or not support for the Telnet "3270 regime" option is suppressed.

Suppress TN3270E

When running the IBM 3270 emulation, the setting of this option determines whether or not support of TN3270E is suppressed. When this option is not selected (i.e. TN3270E is not suppressed), additional options are available by clicking the 3270 Options button. These are described in the TN3270 Options section.

Suppress TN5250E

When running the IBM 5250 emulation, the setting of this option determines whether or not support of TN5250E is suppressed. When this option is not selected (i.e. TN5250E is not suppressed), additional options are available by clicking the 5250 Options button. These are described in the TN5250 Options section.

Force Negotiation

These settings determine whether or not the Telnet Binary or EOR options are supported. Both are set to no by default.

No Will not force any negotiations. It will leave it up to the

host to decide what to do.

DO Will force negotiation. The host will be informed that the

option is supported.

DONT Will force negotiation. A negotiation packet will be sent

to the host telling it that the option is not supported.

Break Settings

The setting of these options determine whether or not a timing mark (TM) and/or carriage return (CR) is sent with a Telnet break packet. A timing mark is sent by default.

2-10

Getting Started

Send Location

This enables you to enter the location of this terminal which may be used by the host to provide a list of users currently logged in giving their name and location.

TN3270 Options

This dialog box is displayed by clicking the 3270 Options button in the TCP/IP Telnet Configuration dialog box when TN3270 is not suppressed.

Connect

This specifies the name of the device which the server will be requested to assign to the Telnet session; it may be used when requesting either a terminal or a printer session.

You can return the local host name by entering %s after the device name. To return the user name, enter %u after the device name. You can specify how many characters of the name is returned in each case. For example, %.3s will return the first three characters of the local host name, and %-.3s will return the last three characters.

To automatically assign a new device name for each successive connection, either enter %dN% after the name, where N is a decimal value, or %xN%, where N is a hexadecimal value. Each time the host requests the device name a counter will be substituted into the device name. If the host rejects the device name as in use the counter will be incremented modulus N and the name retried until all possibilities have been tried, at which point the emulation will report a device name rejected error.

For example, TEST%d4% will give TEST1 on all connections until the host rejects the name as in use, in which case TEST2 will be used. If this is already in use then TEST3 is used, or if already in use then TEST0. These values are preserved over

2-11

Getting Started

power off, so the first connection of any given power on may not be TEST1. Assume that the start point is random.

Note: There are separate counters for the IBM 3270 and IBM 5250

emulations.

When you achieve a TN3270E connection, the LU device name that you are connected as will be displayed on the status line. If the specified device is rejected by the server or host, then an error message box will be displayed indicating the reason.

Associate

This is available when the IBM 3270 Model option is set to 3287-1 (a printer). It is used to request that the device name of the printer associated with a particular terminal is assigned to this Telnet session. The name of the terminal is specified here. (This is implemented as described in RFC 1647.)

TN3270E Options

TN3270E in implemented as described in RFC 1647. These options should not be changed unless required by your System Administrator.

The Bind setting determines whether or not the server is allowed to send the SNA Bind image and Unbind notification to the emulator.

When Responses is selected, positive and negative response handling is supported. It allows the server to reflect to the emulator any and all definite, exception, and no response requests sent by the host application.

When SysReq is selected, some (or all, depending on the server) of the functions of the SysReq key will be emulated and the server in an SNA environment.

The LU1 and LU3 Printer options are available when the IBM 3270 Model option is set to 3287-1 (a printer). They enable you to specify which printer type(s) to support.

2-12

Getting Started

TN5250 Options

This dialog box is displayed by clicking the 5250 Options button in the TCP/IP Telnet Configuration dialog box when TN5250 is not suppressed and the IBM 5250 Model is not set to 3812-1 or 5553-B01 (printers). Refer to the next section for 5250 Printer Options.

Device Name

This enables you to enter the name of the device which the server will be requested to assign to this Telnet session.

For example, TEST%d4% will give TEST1 on first connect, TEST2 on second,

TEST3 on third, TEST0 on fourth, TEST1 on fifth and so on.

TEST%d100% will give TEST1 on first connect, TEST2 on second, ... TEST99 on

99th, TEST0 on 100th, TEST1 on 101st and so on.

These values are preserved over power off, so the first connection of any given power on may not be TEST1. Assume that the start point is random. In addition there is a single counter for the unit so concurrent sessions will start from subsequent values. For example, if session one uses TEST1 then session two will use TEST2.

Where a device name collision occurs (i.e. the device name is already in use on the host) the host will ask again for the device name during the same connection. In this

2-13

Getting Started

case TEST1, TEST2, ... may all be tried in one connection until the host accepts one, or all possibilities have been tried. In the latter case the same name is sent twice in succession to indicate to the host all names have been tried.

If concurrent 5250 sessions are started before a previous session has negotiated an acceptable device name, it is possible that the two sessions will access the counter simultaneously and not all possible names will be tried by each session. This should not cause a problem unless the separate sessions use different modulo values (for example, session one device name TEST%d4% and session two device name ANOTHER%d100%) or are connecting to different hosts.

Note: There are separate counters for the IBM 3270 and IBM 5250

emulations.

Password, Library, Menu

User

These options enable you to specify the initial entries required on the standard startup screen so that it can be bypassed. Each entry can be a maximum of ten characters.

Program

This enables you to specify the name of the initial program to run. The entry can be a maximum of ten characters.

2-14

Getting Started

5250 Printer Options

This dialog box is displayed by clicking the 5250 Options button in the TCP/IP Telnet Configuration dialog box when TN5250 is not suppressed and the IBM 5250 Model is set to 3812-1 (a printer).

Device Name

Specifies the name of the printer device.

IGC Feature

This is always set to Don't Report.

Transform

Specifies whether the printer will use the host print transform function to generate ASCII printer data. This is always set to Yes. The Mfg. Type and Model option must specify the printer manufacturer, type and model.

Mfg. Type and Model

Specifies the manufacturer, type and model of the printer. The entry must exactly match an AS400 printer type string, including the * (asterisk) character. The following valid entries are for the IBM AS/400 V3R1. Note that the list can change according to AS/400 settings.

*IBM2380 *IBM2381 *IBM2390 *IBM2391 *IBM3812 *IBM3816 *IBM3912HP *IBM3916HP *IBM39302 *IBM39303 *IBM4019 *IBM4019HP *IBM4029 *IBM4029HP *IBM4037 *IBM4039HP *IBM4070 *IBM4070EP *IBM4072 *IBM4076 *IBM42011 *IBM42012 *IBM42013 *IBM42021 *IBM42022 *IBM42023 *IBM42071 *IBM42072 *IBM42081 *IBM42082 *IBM4212 *IBM4216 *IBM4226 *IBM4230 *IBM4232

2-15

Getting Started

*IBM47121 *IBM47122 *IBM47221 *IBM47222 *IBM4770 *IBM5152 *IBM5201 *IBM5202 *IBM5204 *IBM5216 *IBM6404 *IBM6404EP *IBM6408 *IBM6408EP *IBM6412 *IBM6412EP *HPII *HPIID *HPIIP *HPIII *HPIIID *HPIIIP *HPIIISI *HP4 *HP310 *HP500 *HP520 *HP550C *HP560C *HPPAINT *CPQPM15 *CPQPM20 *EPAP2250 *EPAP3250 *EPAP5000 *EPAP5500 *EPDFX5000 *EPDFX8000 *EPFX850 *EPFX870 *EPFX1170 *EPLX810 *EPLQ510 *EPLQ570 *EPLQ860 *EPLQ870 *EPLQ1070 *EPLQ1170 *EPLQ2550 *EPSQ870 *EPSQ1170 *EPEPL7000 *EPEPL8000 *NECP2 *NECP2200 *NECP2200XE *NECP5200 *NECP5300 *NECP6200 *NECP6300 *OKI184IBM *OKI320IBM *OKI321IBM *OKI390IBM *OKI391IBM *OKI393IBM *OKI590IBM *OKI591IBM *OKI400 *OKI800 *OKI810 *OKI820 *OKI3410 *PAN1123EP *PAN1124EP *PAN1124IEP *PAN1180EP *PAN1180IEP *PAN1191EP *PAN1624EP *PAN1654EP *PAN1695EP *PAN2123EP *PAN2124EP *PAN2180EP *PAN2624EP *PAN4410HP *PAN4420HP *PAN4430HP *PAN4450IHP *PAN4451HP

*MSGQ Name

Specifies the name of the message queue to which operational messages for the printer are to be sent.

*MSGQ Library

Specifies the message queue library.

Font

Specifies the font identifier and point size used by the single-byte printer (e.g. 11).

Formfeed

This is always set to Don't Report. The Paper Source 1 option is used to specify the paper format to be used.

Paper Source 1 & 2

These options specify the paper format to be used. The possible settings are:

Don't Report No value returned.

*NONE No paper source is defined.

*MFR The system determines the paper type used based on

the manufacturer, type and model of the printer.

*LET Letter-sized paper (8.5 x 11 inches).

2-16

*LEGL Legal-sized paper (8.5 x 14 inches).

*EXEC Executive-sized paper (7.25 x 10.5 inches).

*A4 A4-sized paper (210 mm x 297 mm).

*A5 A5-sized paper (148 mm x 210 mm).

*B5 B5-sized paper (182 mm x 257 mm).

*C80 Continuous-form paper, 8.0 inches wide

(Paper Source 1 only).

*C132 Continuous-form paper, 13.2 inches wide

(Paper Source 1 only).

*A3 A3-sized paper (297 mm x 420 mm).

*B4 B4-sized paper (257 mm x 364 mm).

*LEDG Ledger-sized paper (11 inches x 17 inches).

Envelope Hopper

This specifies the envelope format to be used. The possible settings are:

Don't Report No value returned.

*NONE No envelope source is defined.

*MFR The system determines the envelope type used based on

the manufacturer, type and model of the printer.

*B5 B5-sized envelopes (176mm x 250mm).

*MON Monarch-sized envelopes (3.875 x 7.5 inches).

*N9 Number 9-sized envelopes (3.875 x 8.875 inches).

*N10 Number 10-sized envelopes (4.125 x 9.5 inches).

*C5 C5-sized envelopes (162mm x 229mm).

*DL DL-sized envelopes (110mm x 220mm).

Getting Started

ASCII 899 Support

Specifies whether the single-byte printer has ASCII code page 899 installed. Selecting Don't Report will cause no value to be returned.

WSCST Name

Specifies the name of the object containing pointers to the work station customizing tables.

WSCST Library

Specifies the library name of the object containing pointers to the work station customizing tables.

2-17

Getting Started

SSL Connection Settings

The optional SSL (Secure Sockets Layer) protocol enables authenticated and encrypted communication between clients and servers.

Before anyone can connect to a server the system administrator must make available a copy of the root certificate used to sign the server’s identity certificate and the number of the telnet port the server is listening on (the default for secure telnet is 992).

Additionally the system administrator may issue each user or terminal with their own password protected client certificate.

To make an SSL connection:

1. Select the SSL option in the Connection Wizard Host Information dialog box, or from the New Connection dialog Type list box when running TeemTalk.

2. Display the Telnet Options dialog box and change the port to the number specified by the system administrator then click OK.

3. Click the Advanced or Configure button to display the SSL Connection dialog box.

4. If you have not already installed the root certificate you will have been given to verify the server you are going to connect to, click Add under Root Certificates and choose the file containing the certificate. This will import the certificate and add its name to the list.

5. If the server you are going to connect to requires you to have a client certificate, choose the relevant certificate from the Client Certificate drop down list.

6. If you have not already installed your client certificate, click Add under Client Certificate and choose the file containing the certificate. This will import the certificate and add its name to the list.

2-18

Getting Started

7. You may optionally enter your Password for the client certificate here too. If you check Save this password will be stored, encrypted, along with the certificate itself. Please note this is a security risk as anyone who can acquire a copy of your registry will be able to use your certificate.

8. Once you have configured the certificates click OK and then Connect in the New Connection dialog box.

9. Login as usual when the telnet login prompt appears.

Error Messages

Could not connect TCP/IP socket.

The most likely causes of this error are that the service is not running on the server or the port number is incorrect.

Could not connect SSL socket. Please check that your client certificate is correct.

This message is returned if the server refuses the SSL connection. The most likely causes are that the server is expecting a client certificate but none has been specified or the client certificate specified is invalid for some reason. This error may also be seen if the server is running an incompatible version of SSL. TeemTalk currently supports SSL2, SSL3 and TLS.

The server’s certificate cannot be verified.

The server’s identity certificate was not signed by any of the root certificates installed in TeemTalk. TeemTalk will not connect to a host it cannot verify.

Common name does not match host name.

The common name is part of the server’s certificate. SSL assumes this will match the host name given in the Host Name box in the Connection Wizard, or Connect To box in the New Connection dialog box. If they do not match TeemTalk will not connect to the host.

Notes About Certificates

The SSL Protocol uses three types of certificate:

1. Server certificates. These are always sent by the server to the client to validate the server’s identity. SSL handles them internally and they are never saved on the client.

2. Client certificates. These are sent by the client, only if the server requests them, and validate the client’s identity. The client will need to store these locally. Usually a client will only have one certificate to validate it on a particular server but different servers may require different client certificates.

2-19

Getting Started

3. CA (Certificate Authority) or root certificates. These are used to authenticate the other two types. The client will need to store these locally.

Storage of Certificates

TeemTalk stores its certificates in the Registry as binary values. The following keys are used:

HKEY_CURRENT_USER\Software\Neoware\Security\SSL\CA Certificates HKEY_CURRENT_USER\Software\Neoware\Security\SSL\Client Certificates

CA (root) Certificates are stored unencrypted. The value name in the registry is in the form HHHHHHHH.UU where HHHHHHHH is the hash of the certificate's internal name and UU is a unique number. The UU section is to allow different certificates which happen to have the same hash value co-exist. This follows the convention used by openSSL file based system. TeemTalk will automatically discard any duplicate certificates.

Client Certificates are stored encrypted. The value name may be any valid string of characters.

Acquiring New Certificates

There are two ways a client may acquire new certificates. They may be added directly to the registry keys detailed above or they may be installed on the file system and imported manually by TeemTalk.

Adding to the Registry

New CA (root) Certificates should be added to the CA Certificates key with a value name in the form NEWXXXXXXXX where XXXXXXXX is a unique number. Whenever it uses its certificate's, TeemTalk first scans the registry for any value name NEW*. If it finds one it checks that it is not a duplicate and then renames it with the correct hash.unique name.

New Client certificates should be added to the Client Certificate key. They may be given any value name. Obviously if a value already exists with the same name it will be overwritten. TeemTalk uses this value name to identify the certificate to the user and to link particular certificates to particular sessions.

Importing from the File System

The SSL Connection dialog box allows users to add both CA and Client certificates by picking files from the file system. These files should be in PEM certificate format and the Client file should include both the certificate and the encrypted private key.

An imported client certificate’s registry name will be the original filename minus any path or extension.

2-20

Getting Started

SSH Connection Settings

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.

To enable an SSH connection, select the SSH option in the Connection Wizard Host Information dialog box or, when running TeemTalk, in the New Connection dialog box Type list box. The Telnet Port Number option must be set to the host's SSH port (22 is the default for SSH).

SSH Connection using Username and Password

1. Select the SSH option in the Connection Wizard Host Information dialog box, or from the New Connection dialog Type list box when running TeemTalk.

2. Display the Telnet Options dialog box and change the Port Number to the host's SSH port (22 is the default for SSH) then click OK.

3. Click the Advanced or Configure button to display the SSH Connection dialog box.

4. Enter your username and password, ensuring that Password is selected. Then click OK.

5. Click the Connect button. TeemTalk will attempt to make the connection.

If the username and/or password are invalid, TeemTalk will prompt you to re-enter them. (Note that some servers will not allow you to change the username at this point.) To work round this, if you see your username is incorrect, click Cancel to abort the connection and then restart as step 1.

If your password has expired, TeemTalk will prompt you to enter a new one.

2-21

Getting Started

SSH Connection to an openSSH Server using a Key File

1. Select the SSH option in the Connection Wizard Host Information dialog box, or from the New Connection dialog Type list box when running TeemTalk.

2. Display the Telnet Options dialog box and change the Port Number to the host's SSH port (22 is the default for SSH) then click OK.

3. Click the Advanced or Configure button to display the SSH Connection dialog box.

4. If you have already created a keyfile, go to step 19.

5. To create a new key file, click Generate Key to display the SSH Key Generation dialog box.

2-22

Getting Started

6. Enter a Filename. This is the name the key will be stored under in the registry and the name displayed in the Keyfile drop down list in the previous dialog box.

7. Select the type of key you wish to create. openSSH servers support both DSA and RSA keys. Other servers may only support one or the other.

8. Both key generation algorithms require a group of large prime numbers to generate the key. Generating these primes can take a several minutes. As the same primes can be used for generating different keys we have split generating primes and generating keys into two separate options. Clicking New Group will generate a new set of primes for the selected algorithm. Clicking New Key will create a new key of the algorithm type specified using the existing group of primes. If no group of primes already exists for that algorithm the New Key option will generate them automatically. The two algorithms do not share the same prime number group because they require their primes to be generated in different ways.

9. Click Generate Key to create a new key. You will be prompted for a passphrase to encrypt your private key.

10. Enter the Passphrase and Confirm it.

If you check the Save box your password will be stored, encrypted, in the registry along with your key. Please bear in mind that this is a security risk. Although noone will be able to read your password in the registry, anyone who can get a copy of your registry settings can use them to logon as you.

11. The Key generated is actually a private/public key pair. The private key, and optionally the password to decrypt it, will be stored in your registry. The public key will be displayed in the SSH Key Generation dialog box.

2-23

Getting Started

12. To make use of your key you need to copy it on to the server.

13. Select all in the text box and then copy to put the key into the Windows clipboard.

14. Logon to your server using username and password.

15. In your home directory you need to have a sub-directory called .ssh. You may have to create this directory yourself. Within the .ssh directory you need a file called authorized_keys. Again if it is not there you will have to create it.

16. Using whatever editor is available on your server you need to paste the key into the file and save it.

17. If the authorized_keys file does not exist you can just do the following:

cat > authorized_keys Edit | Paste from the TeemTalk menu. Control C

18. Finally logon and restart from step 1.

19. Select your key file from the drop down list.

20. Enter your passphrase (if it has not been saved) and click OK.

21. Click the Connect button. TeemTalk will attempt to connect to the host.

2-24

Getting Started

SSH Connection to an SSH Communications Security Tectia Server using a Key File

1. Follow the instructions in the previous section for using a keyfile with openSSH up to and including step 12.

2. If they do not already exist you need to create a directory ~/.ssh2 and a text file within it called authorization.

3. Create another text file and paste your key into it. For example:

cat > mykey.pub Control V Control C

4. Add the following line to the authorization file :

key mykey.pub

5. You then have to edit your key file as follows:

Remove ssh-dsa or ssh-rsa from the start of the key.

Remove Comment from the end of the key.

Insert the following lines before the key:

—— BEGIN SSH2 PUBLIC KEY —— Subject: Your name Comment:

And add the following line after the key:

—— END SSH2 PUBLIC KEY ——

6. You should then be able to connect to the server using your keyfile.

SSH Key File Permissions

If you find that public key authentication does not work when you have copied your public key to authorized_keys, it is probably because the file permissions on $HOME, $HOME/.ssh or $HOME/.ssh/authorized_keys are more permissive than SSH allows by default. This may be resolved by executing the following on the server:

$ chmod go-w $HOME $HOME/.ssh $ chmod 600 $HOME/.ssh/authorized_keys

If this is not possible for some reason, an alternative is to set StrictModes no in sshd_config, however this is not recommended.

More information can be found at http://www.openssh.com/faq.html.

2-25

Getting Started

Modem Connection Settings

The Modem Settings dialog box can be displayed from the Connection Wizard Host Information dialog box by setting the Connection Type to Modem then clicking the Advanced button, or the New Connection dialog box when in non-WBT mode by

selecting Modem in the Type list box then clicking the Configure button.

This enables you to define a particular modem configuration which can be saved under a specific name for future selection in the Host Information dialog box.

1. If this is a new configuration, enter a name to identify it in the Configuration Name box.

2. Select a Modem from the list box below. The Configure button provides access to the standard Microsoft dialog boxes for specifying port settings and call options.

3. Enter the Country Code, Area Code and Telephone Number.

4. Click the Dialing Properties button to display the standard Microsoft dialog boxes for specifying a variety of dialing formats.

5. If you want the country and area codes to be ignored when dialing, select Force

Local. If you want the area code dialed even if you are in that area, select Force long distance.

6. Click OK to save the settings and the name you assigned to this configuration will appear in the Modem configuration selection box in the main Host Information dialog box.

2-26

Getting Started

Serial Connection Settings

The Serial Configuration dialog box can be displayed from the Connection Wizard Host Information dialog box by setting the Connection Type to Serial then clicking

the Advanced button, or the New Connection dialog box when in non-WBT mode by selecting Serial in the Type list box then clicking the Configure button.

Baud Rate

Factory default: 9600

This specifies the transmit and receive baud rates for the port selected for host communications.

Parity

Factory default: None

This option specifies the parity mode for each transmitted character. If the number of Data Bits is 8, set this option to None.

Selecting Odd will cause an eighth bit to be added with a value of 1 if the previous 7 bits add up to an even number, and 0 if the previous 7 bits add up to an odd number. Selecting Even will cause an eighth bit to be added with a value of 1 if the previous 7 bits add up to an odd number, and 0 if the previous 7 bits add up to an even number. Mark parity will set every eighth bit to 1 and Space parity every bit to 0.

Flow Control

Factory default: Input

This option specifies the type of flow control used by the line port to communicate readiness to transmit or receive data from the host.

None - No flow control Input - XON/XOFF on received data Output - XON/XOFF on transmitted data In/Out - XON/XOFF on transmitted & received data Hardware - DTR/CTS hardware flow control.

2-27

Getting Started

Data Bits

Factory default: 8

This option specifies the number of data bits sent for each transmitted character.

Stop Bits

Factory default: 1

This specifies the number of stop bits sent for each transmitted character.

Transmit Rate

Factory default: Unlimited

The setting of this option determines the maximum effective baud rate that the emulatortransmits terminal reports and data sent as a result of pasting data to the host.

Local Echo

Factory default: Unselected

The setting of this option determines whether keyboard entered characters are displayed on the screen as well as sent to the host. When unselected, characters are not displayed when they are transmitted unless the host 'echoes' them back.

2-28

Getting Started

Automate Login Process

The Automate Login Process dialog box enables you to automate part or all of the host login procedure.

The settings in this dialog box enable you to specify what is sent to the host in response to prompts displayed on the screen.

1. If an initiation string is required by the host when you first make a connection,

select the Set Initiation String option, enter the required characters in the Initiate with box (the Respond With box in the illustration above), then click the Add button. The initiation string will be added to the Script window on the right.

2. The Wait For options enable you to specify the prompt or keyboard locked or

unlocked command that the automatic login process is to wait for before proceeding. Some systems are case sensitive, so make sure your Text entries follow the correct conventions for your system.

Note: When running the IBM 3270 or IBM 5250 emulation, Text

entries are only applicable in NVT mode.

3. Enter the response required in the Respond With box. In order for a text entry to

be sent to the host it must be followed by a carriage return command. This is specified by selecting C. Return in the list of predefined commands in the list box below then clicking the Insert button. A <CR> will appear in the Respond With box.

You can also enter a predefined key function in the Respond With box by selecting Key Definition in the list of predefined commands in the list box below, selecting one of the virtual key names listed in the box below that, then clicking the Insert button. The Virtual Key Names appendix lists the predefined key functions available for each emulation.

2-29

Getting Started

The list of predefined commands that can be inserted include UserName (indicated by <UN>) and Password (indicated by <PW>). Selecting either of these will cause a dialog box to pop-up when logging on to the host prompting the user to enter a name or password, respectively. You can also delay the script response by 2 seconds by inserting Delay (2s) (indicated by <D>) or 0.255 seconds by inserting Pause (0.255) (indicated by <P>).

4. When you have finished specifying the response to a particular prompt, click the Add button to add the definition to the Script window on the right.

The script will perform the actions in the order displayed in the Script window. To change the order of the script lines, use the up and down arrow buttons to the right of the Script window.

5. Repeat this procedure for each prompt as required.

If you want to edit one of the script lines, select the line in the Script window then click Remove to send it to the edit boxes on the left. Make the change(s) then click Add to send it back to the script. Note that this will now be the last line of the script.

6. When the Script window contains all the required responses to the relevant prompts in the correct order, click Finish.

2-30

Getting Started

Printer Port Settings

The Printer Port Settings dialog box provides several print options. The options available depend on whether you are running TeemTalk for Windows CE or XPe.

TeemTalk for Windows CE

TeemTalk for Windows XPe

2-31

Getting Started

CE - Direct Print Data To The Print Manager

The Current System Printer Driver box displays the name of the currently selected system printer when both the Use Network Printer (LPR) and Print Direct To Port options are not selected.

Clicking the Configure button will display a Print Manager dialog box which enables you to specify printer settings.

If you find a through print results in data being split into lines, each treated as a separate print job, specify a time in the Seconds Close Delay box (e.g. 5 seconds). This will enable the next line of data to be sent before the print job is assumed to have finished and therefore prevents the print job from being closed prematurely. When set to 0, printing will not start until a ‘print end of job’ command is received from the host. Entering any other number will cause printing to start after the specified number of seconds have elapsed, regardless of whether the ‘print end of job’ command has been received from the host. If you require the port to be kept open all the time (to stop the printer resetting) enter -1 (minus one).

XPe - Direct Print Data To The Print Manager

The Printer list box lists the printers handled by the Print Manager. You can select from this list when the Use Network Printer (LPR) option is not selected.

Clicking the Advanced button will display the standard Print Manager dialog box which enables you to specify printer settings.

The Microsoft Windows Print Manager normally controls all print formatting, translates host characters to supported printer characters, and also provides a spooling facility. A disadvantage of using the Print Manager is that any print formatting escape sequences received from the host are stripped. If you want to use the Print Manager but disable its print formatting process so that the original escape sequences from the host are retained, select the PassThru option. (Note that the PassThru option will be unselectable if the printer driver currently selected does not support this facility.)

If you find a through print results in data being split into lines, each treated as a separate print job, specify a time in the Seconds Close Delay box (e.g. 5 seconds). This will enable the next line of data to be sent before the print job is assumed to have finished and therefore prevents the print job from being closed prematurely. When set to 0, TeemTalk will not start printing until it receives a ‘print end of job’ command from the host. Entering any other number will cause TeemTalk to print after the specified number of seconds have elapsed, regardless of whether the ‘print end of job’ command has been received from the host. If you require the port to be kept open all the time (to stop the printer resetting) enter -1 (minus one).

2-32

Getting Started

Direct Print Data To A Specific Port

To direct print data to a specific port, select Print Direct To Port and specify the Printer Port.

Selecting the FormFeed Terminator option will cause the printer to advance the paper to the top of the form when it has finished printing.

The Output Character Set option enables you to specify the character set used for printing when Print Direct To Port is selected. This allows non-ISO Latin-1 printers to be used.

Selecting Auto Line Feed will cause the printer to print at the beginning of the next line when a carriage return command is received.

When a serial port is selected, clicking the Configure button will display a dialog box in which you can specify the baud rate, parity, flow control, data bits and stop bits settings. These options are described in the Serial Settings section.

If supported, clicking the Advanced button will display a dialog box that enables you to send printer-specific commands to specify, for example, font size, colour, or page header and footer.

2-33

Getting Started

CE - Direct Print Data To A Network Printer

To direct print data to a printer on the network when running Windows CE, select Use Network Printer (LPR) and enter the LPD Hostname. Clicking the Configure

button will display a dialog box which enables you to specify various print settings.

You must specify the Printer Name. The Job Name and User Name entries are optional (the User Name will default to root if none is specified). The Number of Copies to print is set to 1 by default. You can specify how many times the LPR protocol will attempt to execute the print job before cancelling by setting the number of Retries and the number of seconds delay between each attempt. When Add Banner is selected, information about this print job will be printed with it. You can display a message box which will indicate the progress of the print job by selecting Debug Information.

If supported, clicking the Advanced button will display a dialog box that enables you to send printer-specific commands to specify, for example, font size, colour, or page header and footer.

2-34

Getting Started

XPe - Direct Print Data To A Network Printer

To direct print data to a printer on the network when running Windows XPe, select Use Network Printer (LPR) and enter the LPD Hostname. Clicking the Configure button will display a dialog box which enables you to specify various print settings.

You must specify the Printer Name. The Job Name and User Name entries are optional (the User Name will default to root if none is specified). You can specify how many times the LPR protocol will attempt to execute the print job before cancelling by setting the number of Retries and the number of seconds delay between each attempt.

Clicking the Advanced button will display a dialog box that enables you to send printer-specific commands to specify, for example, font size, colour, or page header and footer. When Add Banner is selected, information about this print job will be printed with it. You can display a message box which will indicate the progress of the print job by selecting Debug Information.

2-35

Getting Started

GUI Overrides

The GUI Overrides dialog box enables you to disable various GUI items and also enables you to specify how the emulator responds when the host closes the connection.

Clicking the Disable Elements button will display another dialog box enabling you to disable any of the command bar elements.

The Disable Status Bar and Disable Scroll Bar options allow you to disable the status bar and scroll bar, respectively.

The Disable Clipboard Accelerators option will disable the Ctrl + C (copy) and Ctrl + V (paste) keyboard commands.

The Action on Host Close options enable you to specify how the emulator responds when the host closes the connection. Selecting Display Options will cause a dialog box to be displayed with the following three options. Selecting Shutdown will cause the emulator to shutdown. Selecting Stay Alive will keep the emulator running.

2-36

Getting Started

Selecting Reconnect will cause the emulator to attempt to reconnect to the host.

By default, a warning message will be displayed if you attempt to exit the emulator while a host connection is still active. You can disable this message by selecting the No connection warning on close option.

If supported, the optional Enable PC-Style Windowing option enables multiple windows to be displayed when running CE version 4.2 and above.

The Mouse Cursor Style option enables you to choose from a range of cursor styles.

2-37

Getting Started

Aux Port Settings

The Aux Port Settings dialog box enables you to specify a COM or LPT port for bidirectional output when in any DEC VT mode, ANSI BBS, Sco Console, HP 70092/96 or IBM 3151 mode.

The Functionality options enable you to set the auxiliary port as bidirectional and specify that it is to be opened at start-up.

Clicking the Configure button will display a dialog box in which you can specify settings for the COM port. The options in it are described in the Serial Settings section earlier in this chapter.

2-38

Getting Started

Session Management (Windows XPe)

The way that TeemTalk for Windows XPe sessions are created or modified depends on whether you are logged on as a system administrator, or as a user without administrative privileges.

Logged On As System Administrator

If you are logged on as a system administrator, you can either create a unique session only for your own use, or you can create session templates that are available to all users of the system. The session templates can only be modified by the system administrator. However, a user can load a session template, change the setup settings then save the session to create their own local copy based on the template. This copy will have the same name as the session template.

In order to create a new session, TeemTalk must be started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu).

To create a session only for your own use, select the Session stored for current user only option in the Save Session As dialog box before saving the session.

To create a session template for all users, select the Session stored for all users of system option in the Save Session As dialog box before saving the session.

When TeemTalk is started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu), the name of each available session template will be listed in the Open Session dialog box together with the letter T to indicate that they are templates.

When a user loads a template, modifies the settings then saves the session, a local copy of the template will be made with the same name, but with the changed settings. This copy will replace the template in the list of session configurations displayed in the Open Session dialog box. Note that the T template indicator will no longer be displayed. If the user deletes this session, the original template will be listed instead. The user cannot delete session templates.

Logged On As A User

If you are logged on as a user without administrative privileges, you can load a session template created by the system administrator, modify the setup to suit your requirements, then save a local copy of it.

2-39

Getting Started

When you load a template, modify the settings then save the session, a local copy of the template will be made with the same name, but with the changed settings. This copy will replace the template in the list of session configurations displayed in the Open Session dialog box. Note that the T template indicator will no longer be displayed. If you delete this session, the original template will be listed instead. As a user you cannot delete session templates.

2-40

Getting Started

TeemTalk for Windows CE Display

The TeemTalk for Windows CE command bar provides access to a series of menus and buttons that enable you to configure the terminal emulator and perform various functions.

Note: The buttons available depend on whether or not you are in

WBT mode.

Setup Menus (Windows CE)

Three menus can be displayed from the command bar. These are headed File, Edit and Settings.

Note: The options available in the menus depend on whether or not

you are in WBT mode.

Refer to the Setup Menus chapter for a complete discussion on selecting and using the options in these menus.

2-41

Getting Started

The Button Tools (Windows CE)

The TeemTalk for Windows CE button tools provide a quick way of actioning commands or displaying setup dialog boxes by just clicking a button.

Displays the New Connection dialog box for making a serial or network host connection.

Closes the current host connection.

Displays the Open Session dialog box. This enables you to load a particular setup configuration.

Saves the current session configuration.

Displays the Printer Setup dialog box.

Displays the Print Screen dialog box for producing a hardcopy of screen data in a particular format.

2-42

Copies selected data to the clipboard.

Pastes clipboard data at the current cursor position.

Displays help information.

Toggles display of the soft buttons on and off and selects the level.

Getting Started

The Soft Buttons (Windows CE)

A set of soft buttons are provided which can be programmed so that they perform various functions when clicked. You can toggle between command bar and soft button display either by clicking the following buttons:

or by pressing the keys Ctrl + Alt + Left Cursor or Ctrl + Alt + Right Cursor. (Note that you can assign these functions to any other keys using the virtual key names CB_NEXT and CB_PREV.)

You can define up to four soft button levels. Level 1 is displayed by default. Each level consists of twelve programmable buttons, providing a combined total of 48 programmable buttons. Levels stored off-screen can be 'scrolled' into view by clicking one of the arrow buttons.

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

2-43

Getting Started

TeemTalk for Windows XPe Display

The Menu Bar (Windows XPe)

The TeemTalk for Windows XPe menu bar provides access to three menus that enable you to perform various functions and configure TeemTalk for compatibility with the application.

Note: The options available in the menus depend on your version

of TeemTalk.

To display a menu:

Mouse: Click the title of the menu required.

Keyboard: Hold down the Alt key and press the key bearing the underlined

character in the menu title. For example, pressing Alt + F will display the File menu.

Refer to the Setup Menus chapter for a complete description of all the menu options.

2-44

Getting Started

The Toolbar (Windows XPe)

A toolbar is displayed below the TeemTalk for Windows XPe menu bar. This displays a series of buttons which provide a quick way of actioning commands or displaying setup dialog boxes when clicked.

You can redefine all the buttons and add or remove buttons from the toolbar using the Button Tools dialog box. Refer to the chapter entitled The Toolbar for a complete description of all the default buttons and how to redefine the toolbar.

The Soft Buttons (Windows XPe)

A set of soft buttons can be displayed along the bottom of the TeemTalk for Windows XPe window. These can be programmed so that they perform various functions when clicked.

There are four soft button levels. Each level consists of twelve programmable buttons, providing a combined total of 48 programmable buttons. You can display all four levels at the same time if required. All levels are accessible even if not all are displayed, levels stored off-screen can be 'scrolled' into view by clicking the Level button.

The soft buttons are programmed using the Soft Buttons dialog box, which is displayed by selecting Settings in the menu bar then Soft Buttons... The setting of the Visible Levels option determines how many soft button levels are displayed. Refer to the Setup Menus chapter for information on programming the buttons.

2-45

Getting Started

The Status Bar

Along the bottom of the display is a status bar which shows the status of various operations and enables you to switch between modes. The information displayed in the status bar depends on the current terminal emulation. The following description applies when running any of the DEC VT terminal emulations, though some of the fields and buttons will be applicable to other emulations as well.

12 3 4 5 6 78 9 10 11

Item 1: This displays two LEDs. The first LED indicates whether or not you are

connected to the host. It will show red when not connected and green when you are connected. The second LED indicates whether or not data is being sent to or from the host. It will show dull green when there is no activity, red when data is being sent to the host, and bright green when data is being received from the host.

Item 2: This button enables you to switch between Local and Online mode. The

label indicates the mode you will switch to if the button is clicked.

Item 3: This button enables you to Pause or Resume scrolling data in the window.

The label indicates the action that will be taken if the button is clicked.

Item 4: Indicates the current terminal emulation.

Item 5: This displays the active session (always 1), the current page number

(always 1), and the line,column location of the text cursor.

Item 6: This 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.

Item 7: This will display Edit when the terminal emulation is in Edit mode.

Item 8: This will display the time in 24 hour format when in DEC VT500 mode if

the VT525 set time command has been received from the host.

Item 9: Indicates the status of the printer as follows:

None signifies that the printer is not turned on or not connected, or not installed in Microsoft Windows.

2-46

Getting Started

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.

ErrGen indicates that an error has occurred and a message box will be displayed indicating the error.

Item 10: This indicates the keyboard mode. It will be blank when the keyboard is in

normal mode and will display DEC when in DEC mode. You can toggle between normal and DEC mode by pressing the keys Alt + Num Lock together.

Item 11: Indicates the status of the aux port as follows:

Ready indicates that the aux port is ready for bidirectional output.

In Use indicates that the aux port is currently busy.

Hotspots

A hotspot facility is provided which enables you to invoke a function by clicking on a keyword displayed on the screen. For example, an application may display information relating to keys you can press to perform a particular function. Instead of pressing the key on the keyboard, you could invoke the function by holding down the Control key and clicking the mouse pointer on the key name on the display (assuming default mouse configuration).

Hotspots are supported in ALL terminal emulation modes. A set of default keywords is provided for each mode. These keywords relate to key functions specific to the emulation. For example, in VT500 mode you can tap on the word Help displayed on the screen and the emulator will execute the function associated with the Help key.

You can identify hotspots that are currently present in display memory by assigning the Show Hotspots function to a key + mouse button combination using the Mouse Button Actions dialog box (refer to the Mouse Functions chapter for details). Holding down the relevant key and left mouse button will cause all colour attributes to be temporarily removed from the display and the hotspots will be highlighted with a red background. Releasing the key and left mouse button will return the display to its original state.

2-47

Getting Started

AT&T 4410 Emulation

When running the AT&T 4410 emulation 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 has no function 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-48

Getting Started

Viewdata Mode

You can select one of three display formats for viewdata mode: 40 column, 80 column, or Split Screen. Selecting Viewdata 40 or 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-49

Getting Started

Notes

2-50

Keyboard Configuration

This chapter describes how to configure the keyboard, define key functions and compose special characters.

Keyboard Mapping

The keyboard is mapped as close as possible to the terminal being emulated. An llustration showing the mapping of key functions on the 101/102 key Enhanced AT style keyboard layout is shown in each terminal emulation chapter.

Special key functions supported by each terminal emulation can be mapped to keys using the predefined macros listed in the Define Key Macros dialog box as described in the next section.

Defining Key Functions

You can redefine the function of keys on the keyboard using the Define Keyboard Macros dialog box which is displayed by selecting Keyboard Macros in the Settings

menu.

3-1

Keyboard Configuration

This enables you to redefine the function of most of the keys on your keyboard, including the key combinations listed below:

Key Alt + Key Shift + Key Alt + Shift + Key Control + Key Alt + Control + Key Control + Shift + Key Alt + Control + Shift + Key

Each definition may contain a string of up to 127 characters. The combined total of all the characters that may be programmed into keys is determined by the 127 character limit per definition and the amount of memory available in your PC.

The Predefined Macros box enables you to select from a list of standard functions associated with the current terminal emulation. Clicking the arrow button will display a list box in which the names of valid key functions (called virtual key names) are shown. The Virtual Key Names appendix lists all the functions and associated virtual key names for each terminal emulation.

A key macro may be actioned automatically on start-up, or transmitted to the host or actioned locally when the key or key combination is pressed. This is determined by selecting Normal, Remote, Local or Startup in the list box when defining the key. Selecting Normal will cause the macro to be processed according to the current operating mode when the key or key combination is pressed.

The Current Macro Definitions box displays the key and key combinations that are currently defined. The Type column indicates whether the macro is processed as normal (blank), remote (R), local (L) or on start-up (S).

You can remove the selected definition or delete all the definitions by clicking the relevant Remove button.

Defining A Key Or Key Combination

1. Click in the Program Key box then press the key or key combination to define. The current definition will be displayed.

2. Click in the With box then enter the new definition, or make a selection from the list of Predefined Macros then click Apply.

3. Specify how the macro is to be processed by selecting either Normal, Remote, Local or Startup in the list box.

4. Click the Add button to accept the definition. The new definition will be added to the Current Macro Definitions list.

5. To save the definitions, click OK to exit, then select Save Session As in the File menu, make sure the Keyboard Macros box is checked, then click OK.

3-2

Keyboard Configuration

Key Combinations & Sequences

You can program a key to perform the function of a combination or sequence of keys. For example, you can cause the F1 key to perform the same function as pressing the keys Alt + F4 together, or pressing the keys F2 then F3 then F4.

Keys are identified by their virtual key names as listed in the Virtual Key Names appendix. The virtual key name has to be enclosed by the < and > characters in the key definition box. You may omit the VK_ and VT_ (etc.) parts of the virtual key name.

To program a key so that it performs the same function as pressing two or more other keys together, type the < character followed by the virtual key names linked together with + (plus sign) characters and ending with the > character.

For example, to program the F1 key so that when it is pressed it performs the same function as pressing the keys Alt + F4 together, enter the following characters in the key definition box: <ALT+F4>

To program a key so that it performs the same function as pressing a sequence of keys one after the other, enter each virtual key name in the order required, enclosing each virtual key name with the < and > characters. Each enclosed virtual key name must immediately follow the previous enclosed virtual key name with no spaces. For example, to program the A key so that when it is pressed it performs the same function as pressing the keys F2 then F3 then F4 enter the following characters in the key definition box: <F2><F3><F4>

Specifying Characters

There are various ways in which you can specify a particular character. For example, the ESC character can be specified using any one of the following five entries:

_027 Decimal value (underscore character followed by a 3-digit number). \033 Octal value (backslash character followed by a 3-digit number). \u001B Unicode value (backslash and u characters then unicode value). ^[ Control key value (^ represents the control key on the keyboard). \e Additional value for ESC.

The following 'backslash' values can be used:

\u Unicode introducer \r Carriage return \n Line feed \e Escape

Note that as the \ and ^ characters are used as value introducers, to enter these as character values you need to precede them with a backslash character, i.e. enter \ as \\ and ^ as \^.

The Euro character can be specified by entering the unicode value \u20ac.

3-3

Keyboard Configuration

Compose Character Sequences

Compose character sequences can be used to generate codes for characters not shown on your keyboard. The characters that can be composed depend on the setting of the

Character Set Mode option in the Emulation Settings dialog box and the Preferred Char. Set option in the Terminal Settings dialog box.

When Character Set Mode is is set to National, only characters found in the character set that corresponds to the selected keyboard nationality can be composed. When Multinational is selected, the emulator is in Multinational mode and characters from all national keyboard layouts may be composed.

The tables of characters that are used in Multinational mode depend on the setting of the Preferred Char. Set option. When this is set to DEC-MCS, the ASCII (7-bit) and DEC Additional (8-bit) character sets are used. When this option is set to ISO Latin-1, the ASCII (7-bit) and ISO Latin-1 Additional (8-bit) character sets are used. The Character Sets appendix shows all the tables of characters that may be selected.

If a character is a diacritical symbol (e.g. ´ or ¨) and this symbol does not appear on the keyboard, an equivalent character can be used in some cases. The diacritical symbols and the possible substitutes are shown below. There are no equivalents for the circumflex accent and tilde mark.

Diacritical Mark Equivalent Character

´ Acute accent ' Apostrophe ¨ Umlaut " Double quote ` Grave accent ' Single quote ° Ring mark * Asterisk or degree sign

To compose a character, first find the character you wish to compose in the left hand column of the following tables. The two characters shown in the right hand column are the keys that are used to create it. Several alternatives may be given for generating the same character. A compose sequence is initiated by pressing the keys Alt + C together, followed by the key bearing the first character then the key bearing the second character.

Note: The compose character sequence can also be initiated by

pressing a key defined with the COMPOSE virtual key name.

A compose character sequence may be abandoned before completion by pressing the Delete key. Pressing Alt + C (or the key defined with the COMPOSE virtual key name) again before completing a compose character sequence will cause it to be abandoned and a second sequence to be started. An invalid compose character sequence will cause the bell to sound.

3-4

Keyboard Configuration

The following tables use several conventions:

The keys bearing the characters used to compose a special character may be pressed in any order unless (in order) is specified.

(DEC Multinat.) indicates that the character can only be composed if the Character Set Mode option in the Emulation Settings dialog box is set to Multinational, and the Preferred Char. Set option in the Terminal Settings dialog box is set to DEC-MCS.

(Latin-1) indicates that the character can only be composed if the Character Set Mode option in the Emulation Settings dialog box is set to Multinational and the Preferred Char. Set option in the Terminal Settings dialog

box is set to ISO Latin-1.

If a nationality is specified with the character description, for example

(Dutch), then the character can only be composed when the Character Set Mode option in the Emulation Settings dialog box is set to National and the

system is configured for the relevant language.

3-5

Keyboard Configuration

COMPOSE CHARACTER SEQUENCES

" #

[ \ ]

` { | }

¢ £ ¥

quotation mark

number sign

apostrophe

commercial at

a a or A A or a A

opening bracket

back slash

closing bracket

circumflex accent

grave accent

opening brace

vertical line

closing brace

tilde

inverted !

cent sign

pound sign

yen sign

section sign

National includes

currency sign

s o S !

(National & Multinational)

¨ space

+ +

' space

a a or A A

(Multinational)

(National)

( (

/ <

/ /

) )

^ space

` space

( -

/ ^

) -

~ space

! !

c / or C /

C |

c | l -

L -

L =

l = y -

Y -

y = or Y =

S O or s !

s 0 or S 0

s O or S o

x o or X O

X 0

x 0 c o

C O

c 0 or C 0

¿ À

Á Â Ã

feminine ordinal indicator

double open angle brackets

degree sign

plus or minus sign

superscript 2

superscript 3

micro sign

paragraph sign

centred period

superscript 1

masculine ordinal indicator

double closed angle brackets

fraction one quarter

fraction one half

fraction threequarters (Dutch)

Florin (Dutch)

i j sign (Dutch)

inverted ?

A grave

A acute

A circumflex

A tilde

a -

< <

0 ^ space

+ -

2 ^

3 ^ / u or / U

(in order)

p !

. ^

1 ^

o _

> > 1 4

(in order)

1 2

(in order)

3 4

(in order)

f l

(in order)

i j

(in order)

? ?

A `

A '

A ^

A ~

A _

(Multinational)

(National)

P !

O _

3-6

Keyboard Configuration

COMPOSE CHARACTER SEQUENCES (continued)

Ä Å

Ç È É Ê Ë

Ì Í Î Ï

Ñ Ò Ó

A umlaut

A ring

A E diphthong

C cedilla

E grave

E acute

E circumflex

E umlaut

I grave

I acute

I circumflex

I umlaut

N tilde

O grave

O acute

A " or ¨ A A * or A

(degree sign)

A E

(in order)

/ u or / U

(in order)

E `

E '

E ^

E "

¨ E

I `

I '

I ^

I "

¨ I

N ~

O `

O '

U circumflex

Ü Ÿ ß

à á â ã ä å

ç è é ê

U umlaut

Y umlaut (DEC Multinat.)

German small sharp s

a grave

a acute

a circumflex

a tilde

a umlaut

a ring

a e diphthong

c cedilla

e grave

e acute

e circumflex

U ^

¨ U

U "

Y "

¨ Y

s s

a `

a '

a ^

a ~

a "

¨ a

a * or a

(degree sign)

a e

(in order)

c ,

(comma)

e `

e '

e ^

Ô Õ Ö

O circumflex

O tilde

O umlaut

O E diphthong (DEC Multinat.)

O slash

U grave

U acute

O ^

O ~

O "

O E

(in order)

O /

U `

U '

¨ O

ì í î

ï ñ ò

e umlaut

i grave

i acute

i circumflex

i umlaut

n tilde

o grave

e "

i `

i '

i ^

i "

n ~

o `

¨ e

¨ i

3-7

Keyboard Configuration

COMPOSE CHARACTER SEQUENCES (continued)

ó ô õ ö

ø ù ú û ü ÿ

o acute

o circumflex

o tilde

o umlaut

o e diphthong (DEC Multinat.)

o slash

u grave

u acute

u circumflex

u umlaut

y umlaut

no break space (Latin-1)

broken vertical bar (Latin-1)

logical not (Latin-1)

o '

o ^

o ~

¨ o

o " o e

(in order)

o /

u `

u '

u ^

¨ u

u "

¨ y

y "

space space

| | or ! ^

- ,

(in order)

soft (syllable)

—

hyphen (Latin-1)

registered trade-

mark (Latin-1)

macron

–

(Latin-1)

three quarters

(Latin-1)

division sign

(Latin-1)

multiplication sign (Latin-1)

acute accent

(Latin-1)

dieresis (umlaut)

(Latin-1)

Y acute

(Latin-1)

y acute

(Latin-1)

capital Icelandic thorn (Latin-1)

small Icelandic thorn (Latin-1)

capital Icelandic

Eth (Latin-1)

small Icelandic Eth (Latin-1)

- -

R O

_ ^

- ^

3 4

(in order)

- :

x x

' '

" "

" space

Y '

y ' T H

(in order)

t h

(in order)

- D

- d

3-8

Mouse Functions

This chapter describes the special functions assigned to the mouse and how to redefine them.

Introduction

You can assign up to six special functions to the left and right mouse buttons when used in conjunction with modifier keys. The following functions are defined by default:

Left Button Right Button

Normal: Select Edit Copy

Shift: Extend Selection Edit Paste

Control: Action Hotspot Unassigned

Control + Shift: Select Rectangle Unassigned

Alt: Move Cursor Send Keyword

Double Click: Select Word Unassigned

Redefining Mouse Functions

You can redefine the functions assigned to the mouse buttons using the Mouse Button Actions dialog box, which is displayed from the Settings menu.

4-1

Mouse Functions

This enables you to specify the functions of the left and right mouse buttons when clicked on their own or in conjunction with modifier keys. You can assign up to six functions to each button, either entering your own definition in the same format as described for keyboard macros and soft buttons, or selecting from a list of standard built-in functions. Clicking one of the arrow buttons will display a drop-down list box which lists all the standard functions that can be assigned:

Unassigned Send CR Select Send Keyword Extend Selection Middle Button Edit Copy Select Rectangle Edit Paste Select Word Show Hotspots Select and Copy Action Hotspot Cursor Select Move Cursor Rectangular Select and Copy

The setting of the Highlight When Actioned option determines whether or not a visual indication is given that a function has been actioned when a hotspot is clicked.

Selecting & Copying Text

You can use the mouse buttons to copy and paste text. The region of the display that will be selected for copying depends on whether you use the Select, Select and Copy, Select Rectangle, Rectangular Select and Copy or Select Word function.

The Select function will select all text from the start position to the finish position, working left to right across the entire width of the display, whereas the Select Rectan- gle function will only select text contained within the rectangular area defined by the start position (top left corner) and the finish position (bottom right corner). The Select Word function will cause the word under the mouse cursor to be selected.

The Select and Copy function is the same as Select but will also copy the selected data to the Clipboard automatically. The Rectangular Select and Copy function is the same as Select Rectangle but will also copy the selected data to the Clipboard automatically.

Moving The Cursor In Block Mode

When the emulator is in any of the local block modes you can use the mouse instead of the cursor keys to position the text cursor using the Move Cursor function. To position the text cursor, move the mouse pointer to the position required, hold down the Alt key then click the left mouse button.

The Cursor Select function does the same as Move Cursor, but when running the IBM 3270 or IBM 5250 emulation it also performs a cursor select.

4-2

Mouse Functions

Send Keyword

The Send Keyword function enables you to click on any delimited word displayed on the screen and it will be sent to the host, as long as the word is not already defined as a hotspot. Keyword delimiters are space, NULL, / , : = ( ) [ and ].

Show & Action Hotspots

A hotspot facility is provided which enables you to invoke a function by clicking the mouse pointer on a keyword displayed on the screen. For example, an application may display information relating to keys you can press to perform a particular function. Instead of pressing the key on the keyboard, you could invoke the function by holding down the Alt key and clicking the mouse pointer on the displayed key name (assuming default mouse configuration).

Hotspots are supported in ALL terminal emulation modes. A set of default hotspot keywords is provided for each mode. These relate to key functions specific to the emulation. For example, in VT500 mode you can click on the word Help displayed on the screen and the emulator will execute the function associated with the Help key.

You can identify hotspots that are currently present in display memory by using the Show Hotspots function. All colour attributes will be temporarily removed from the display and the hotspots will be highlighted with a red background.

Emulating Middle Mouse Button

You can assign the function of the middle button found on a three button mouse to any button or button and key combination by using the Middle Button option.

4-3

Mouse Functions

Notes

4-4

The Toolbar

This chapter describes how to use and redefine the TeemTalk for Windows XPe toolbar.

Using The Toolbar

The TeemTalk for Windows XPe toolbar provides a quick way of actioning commands or displaying setup dialog boxes by just clicking a button.

The Toolbar

You can customize the toolbar by adding or removing buttons to suit your requirements using the Button Tools dialog box, which is displayed from the Settings menu.

The Predefined Button Tools

The toolbar displayed by default contains a series of buttons defined with functions found in the setup menus. These functions are listed below and described in the Setup Menus chapter.

Displays the New Connection dialog box for making a serial or network host connection.

Displays the Open Session dialog box. This enables you to load a particular setup configuration.

Displays the Save Session As dialog box. This enables you to specify how the current session configuration is to be saved.

5-1

The Toolbar

Copies selected data to the clipboard.

Pastes clipboard data at the current cursor position.

Displays the Printer Setup dialog box. This enables you to select any printer that is configured in Microsoft Windows.

Will produce a hardcopy of screen data.

Displays the Attributes dialog box. This enables you to specify the colours used in the emulation workspace and how text with attributes is displayed.

Displays the Keyboard Macros dialog box. This shows the mapping of your keyboard and enables you to redefine the function of keys.

Displays the Soft Buttons dialog box for defining the function of soft buttons.

5-2

Displays the Mouse Button Actions dialog box for assigning up to six functions to the left mouse button.

Displays the Button Tools dialog box for redefining the toolbar.

Displays information about your version of TeemTalk.

The Toolbar

Redefining The Toolbar

Selecting Button Tools from the Settings menu will display a dialog box that enables you to redefine the toolbar.

The Current Tool box displays the toolbar button and its function that is currently selected for editing, or located where a new button is to be inserted to its left in the toolbar. Clicking the down-arrow button to the right will display all the current toolbar buttons in order in a box below. This enables you to select a new button position for display in the Current Tool box. Click the down-arrow button again to return to the Button and Command selection display.

The Visible option enables you to specify whether or not the toolbar is displayed.

Adding Buttons

1. Click the down-arrow button to the right of the Current Tool box to display the

buttons currently in the toolbar.

2. Click on the button which will be to the right of the new button to be added so that

it is displayed in the Current Tool box.

3. Click the down-arrow button again to display the Command options.

4. Select a button bitmap from the Buttons list.

You can add your own bitmaps to the standard bitmap list by clicking the Add Custom Bitmap button and selecting the bitmap files to load. Buttons will be automatically generated using the bitmaps in these files.

5-3

The Toolbar

5. Specify the command to be performed when this button is clicked either by

selecting from the Commands list or by typing your own definition in the Current Tool text box.

6. Click the Insert at Current button.

7. Click OK when you have finished. The toolbar will immediately be updated.

Adding A Space Between Buttons

1. Click the down-arrow button to the right of the Current Tool box to display the

buttons currently in the toolbar.

2. Click on the button which will be to the right of the space to be added so that it is

displayed in the Current Tool box.

3. Click the down-arrow button again to display the Command options.

4. Select the [Space] option at the top of the Commands list box.

5. Click the Insert at Current button.

6. Click OK when you have finished. The toolbar will immediately be updated.

Removing A Button Or Space

1. Click the down-arrow button to the right of the Current Tool box to display the

buttons currently in the toolbar.

2. Click on the button or space to be deleted so that it is displayed in the Current Tool box.

3. Click the down-arrow button again to display the Command options.

4. Click the Delete Current button to remove the button or space from the toolbar.

5. Click OK when you have finished.

Saving The Button Tools

When you have finished defining button tools you can save them so that they will be reasserted when the emulator is loaded or reset by selecting Save Session in the File menu.

5-4

The Toolbar

Assigning User-Defined Functions

You can enter a definition of your own in the Current Tool text box. The definition can contain key functions and control characters to be actioned as well as normal text.

Specifying Key Functions

You can cause a key function to be actioned by including the virtual key name of the key enclosed by the < and > characters. You may omit the VK_ and VT_ parts (etc.) of the virtual key name. For example, the Enter key would be specified as <ENTER>.

To send the function of a key combination, type the < character followed by the virtual key names linked together with + characters and ending with the > character. For example, Alt F4 would be specified as <ALT+F4>.

To send the function of a sequence of keys one after the other, enter each virtual key name in the order required, enclosing each virtual key name with the < and > characters. Each enclosed virtual key name must immediately follow the previous enclosed virtual key name with no spaces. For example, F2 then F3 then F4 would be specified as <F2><F3><F4>.

Specifying Characters

There are various ways in which you can specify a particular character. For example, the ESC character can be specified using any one of the following five entries:

The following 'backslash' values can be used:

\u Unicode introducer \r Carriage return \n Line feed \e Escape

Note that as the \ and ^ characters are used as value introducers, to enter these as character values you need to precede them with a backslash character, i.e. enter \ as \\ and ^ as \^.

The Euro character can be specified by entering the unicode value \u20ac.

5-5

The Toolbar

Notes

5-6

Setup Menus

This chapter describes the options available in the setup menus and dialog boxes.

Displaying & Closing Menus

The following menus can be displayed from the command bar:

Note: The options available in the menus depend on whether or not

you are in WBT mode.

To display a menu:

Mouse: Click on the title of the menu required.

Keyboard: Hold down the Alt key and press the key bearing the underlined

character in the menu title. For example, pressing Alt + F will display the File menu.

6-1

Setup Menus

To close a menu:

Mouse: Click anywhere outside the menu.

Keyboard: Press the Alt key.

Using The Menus

The menu options follow several conventions:

Options that are displayed dimmed are not applicable to the current mode of operation and cannot be selected. An example of this is the IBM 5250 option in the Settings menu. This can only be selected when the IBM 5250 emulation is running.

Options that include an underlined character may be actioned by pressing the key bearing that character. For example, pressing the X key while the File menu is displayed will cause the emulator to shut down.

Options that are not followed by an ellipsis (...) perform a particular function when selected. For example, selecting Reset Terminal in the File menu will perform a terminal reset.

Options that are followed by an ellipsis indicate that a dialog box will be displayed with all the selections applicable to that option. For example, selecting Emulation... in the Settings menu will display a dialog box in which you can specify various emulation settings.

To select a menu option:

Mouse: Click the menu option.

Keyboard: Method 1: If the option includes an underlined character, press the key

bearing that character. For example, pressing X while the File menu is displayed will cause the emulator to shut down.

Method 2: Use the up or down arrow keys to highlight the option required then hit Return.

6-2

Setup Menus

Dialog Boxes

Selecting an option which is followed by an ellipsis (...) will cause a dialog box to be displayed. The example shown below is displayed by selecting the Block Transmission... option in the Settings menu.

There are four basic methods for changing settings within the dialog boxes.

Options preceded by a check box, such as Send Unprotected Only in the example above, are true or selected when the box contains a ✔, and false or unselected when the box is empty. Click the pointer in the box to toggle the setting on or off, or press the spacebar on the keyboard.

When a group of options preceded by round buttons are enclosed in a box, such as the PF Key Effect options in the example above, only one of these options is selected or true at any one time. The currently selected option is indicated by a button with a dark centre. These buttons behave just like radio buttons in that clicking one will cause the previously selected button to be deselected.

Some options require you to type information in a text box, such as the End of Line Characters option.

When an option has many possible settings, these will be shown in a list box. The Alpha Emulation option in the Emulation Settings dialog box is an example of this. To make a selection using the mouse, click the arrow button to display a drop-down list box then click on the setting required. If the list is long a scroll bar may be displayed. To make a selection using the keyboard, press the up or down cursor keys to cycle through the available settings until the one required is highlighted in the box.

6-3

Setup Menus

To select a dialog box option:

Mouse: Click the check box, button or list box. The current setting is highlighted

or surrounded by a dotted rectangle, or both.

Keyboard: Move to the option to be changed either by holding down the Alt key

and pressing the key bearing the character underlined in the option, if one is displayed, or press the Tab key to move forward through the options (left to right, top to bottom), or Shift + Tab to move backwards, until the required option is highlighted. Press the Spacebar to toggle check boxes or buttons on or off.

To close a dialog box without actioning changes:

Mouse: Click the Cancel button.

Keyboard: Press the Tab or Shift + Tab keys to move the cursor until it rests over

the Cancel button and press Return or the Spacebar.

To close a dialog box and action changes:

Mouse: Click the OK button.

Keyboard: Press Return.

Default Settings

You can restore the factory default settings of all the setup options by selecting the Factory Default option in the File menu.

Some dialog boxes include a Default button to enable the default settings of options contained in the dialog box to be reasserted.

Specifying Characters In Setup Entries

There are various ways in which you can specify a particular character in a setup entry. For example, the ESC character can be specified using any one of the following five entries:

6-4

Setup Menus

The following 'backslash' values can be used:

\u Unicode introducer \r Carriage return \n Line feed \e Escape

Note that as the \ and ^ characters are used as value introducers, to enter these as character values you need to precede them with a backslash character, i.e. enter \ as \\ and ^ as \^.

The Euro character can be specified by entering the unicode value \u20ac.

Creating A Connection Template (CE)

When running TeemTalk for Windows CE, you can save the current session configuration as a connection template. To make the emulator automatically attempt to make a host connection using the same settings the next time it is loaded, display the File menu and select the Save Session option.

You can create multiple connection templates when the terminal is not in WBT mode, any one of which can be selected for use. The procedure is as follows:

1. In the File menu, select the Save Session As... option to display the following

dialog box.

2. In the Saved Items box, indicate which settings are to be saved by checking the

boxes next to the relevant options.

3. In the Save As File Name text box, enter a descriptive name to enable it to be identified for future selection. This description will be listed in the Open Session dialog box.

4. Click the OK button to save the template settings. If you specified a descriptive name that already exists, a message box will ask you to confirm whether or not you want to overwrite the existing name with the new settings.

6-5

Setup Menus

Selecting A Connection Template (CE)

The Open Session dialog box enables you to select a connection template to use when the terminal is not in WBT mode. This is displayed by selecting Open Session... in the File menu.

The Description list box displays the names of connection templates that were created using the Save Session As dialog box. The descriptive name of the connection template currently in use is highlighted. The factory default connection template is Untitled. Clicking one of the descriptions then the OK button will cause the dialog box to close and the connection template associated with the chosen description will be actioned.

You can specify a particular connection template to use by default by clicking the required description, checking the Save As Default check box, then clicking the OK button. To delete a connection template, select the description then click the Delete button.

Saving The Session Configuration (XPe)

When running TeemTalk for Windows XPe, you can either save the session configuration using the current session name, or you can save it under a new session name if TeemTalk was started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu).

Save Using Current Session Name

To save the session configuration using the current session name, select Save Session in the File menu. If you were using a session template and modified the settings, a local copy of the template will be made with the same name, but with the changed settings. This copy will replace the template in the list of session configurations displayed in the Open Session dialog box. Note that the T template indicator will no longer be displayed.

6-6

Setup Menus

Save Using New Session Name

If TeemTalk for Windows XPe was started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu), you can save the session configuration under a new name:

1. In the File menu, select Save Session As... option to display the following dialog box.

2. In the Saved Items box, indicate which settings are to be saved by checking the boxes next to the relevant options.

3. In the Save As File Name text box, enter a descriptive name (up to 132 characters long) to enable it to be identified for future selection. This description will be listed in the Open Session dialog box.

4. Click the OK button to save the session. If you specified a session name that already exists, a message box will ask you to confirm whether you want to overwrite the existing session name with the new settings.

Selecting A Session Configuration (XPe)

If TeemTalk for Windows XPe was started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu), you can use the Open Session dialog box to select a session configuration for TeemTalk to load. This is displayed by selecting Open Session... in the File menu.

6-7

Setup Menus

The Defined Sessions list box displays one-line descriptions of session configurations that were created using the TeemTalk Connection Wizard or the Save Session As dialog box when running TeemTalk. The session configuration currently loaded is highlighted. Clicking on a defined session then the OK button will cause TeemTalk to load that session configuration.

The session configuration that TeemTalk will load by default on startup is indicated by a letter D next to its name. You can change the default selection by selecting the required session description then clicking the Save As Default button.

Session templates created by the system administrator are indicated by the letter T after the session name. Refer to the Session Management section in the Getting Started chapter for details.

You can delete any session configurations except templates by selecting the description then clicking the Delete button. Note that if the session deleted was a copy of a template (which will have the same name), the template version will reappear in the Defined Sessions list, as indicated by the letter T.

6-8

Setup Menus

Menu Descriptions

The following pages describe the options available in all the menus and associated dialog boxes. The descriptions begin by showing the menu or dialog box as it is displayed on the screen. The factory default setting is shown below each option title where applicable.

File Menu

Factory Default...

This will restore the factory default settings of all the setup options. A message box will be displayed asking you to confirm whether or not you want to assert the factory default settings. Click the OK button to assert the factory defaults.

Reset Terminal

This will reset the current terminal emulation mode.

6-9

Setup Menus

New Connection...

(Not available in WBT mode)

Factory default: Serial, Com 1

This will display a dialog box that enables you to make a host connection.

The Type list box specifies the type of host connection that is to be made.

The Connect To box specifies the port or host to communicate with. You can either make a selection from the list or enter a valid host name or internet address.

The host connection will be closed if you change the settings in the New Connection dialog box and attempt to connect, if you log out of the host, or the host closes the connection. Warning messages will be displayed if the host closes the connection, or you attempt to open a new session or exit the emulator while a session is open.

Making A Serial Host Connection

To connect to a serial host, select Serial in the Type list box (default), then select the Com port required in the Connect To list box. Click the Configure... button to

display the Serial Settings dialog box and make sure the settings match that of the host. Click OK then Connect.

Note: These options are described in the Serial Settings section

later in this chapter and only apply when the connection type is set to Serial.

6-10

Setup Menus

Making A Network Host Connection

To connect to a network host node, select TCP/IP in the Type list box. The Connect To box will display the available devices on the network. Select the name of the device

required or enter the host name or IP address. If the session was created using the Connection Wizard and the Host Rollover On Connection Fail option was selected, you can specify up to three more hosts in the boxes below. The emulator will attempt to connect to each specified host in turn until one is successful.

Clicking the Telnet Options button will display a dialog box with additional options. These are described in the Getting Started chapter.

Clicking the Connect button or the name of the host in the Connect To list box twice will cause the emulator to attempt to connect to the specified host. If a connection cannot be made because the network driver is not installed or the host node name is invalid, an error message will indicate this. Failure to connect for any other reason will result in a Connection Failed message.

Making A Modem Host Connection

For a modem connection, click the Modem button then click Advanced to display configuration options. Refer to the Modem Connection Settings section in chapter 2 for details. When you have made the relevant selections, click OK then Connect.

6-11

Setup Menus

Making An SSL Or SSH Host Connection (if supported)

The optional SSL (Secure Sockets Layer) protocol enables authenticated and encrypted communication between clients and servers. Refer to the SSL Connection section in the Getting Started chapter for details.

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. To enable an SSH connection, this option must be selected and the Telnet Port Number option set to the host's SSH port (22 is the default for SSH). When a Telnet connection is initiated, the SSH Connection dialog box will be displayed prompting the user for authentication. Refer to the SSH Connection section in the Getting Started chapter for details.

Open Session...

(Not available in WBT mode)

TeemTalk for Windows CE

This enables you to select a connection template. The following dialog box will be displayed.

The Description list box displays the names of connection templates that were created using the Save Session As dialog box. The name of the connection template currently in use is highlighted. The factory default connection template is Untitled. Selecting one of the descriptions then clicking the OK button will cause the dialog box to close and the connection template associated with the chosen description to be actioned.

TeemTalk for Windows XPe

This option is only available if TeemTalk for Windows XPe was started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu). It enables you to select a session configuration for TeemTalk to load. The following dialog box will be displayed.

6-12

Setup Menus

Session templates created by the system administrator are indicated by the letter T after the session name. Refer to the Session Management section in the Getting Started chapter for details.

Close Session

(Not available in WBT mode)

This will close the current session.

Save S

Selecting this option will save the current session configuration.

ession

TeemTalk for Windows XPe

If you were using a session template and modified the settings, a local copy of the template will be made with the same name, but with the changed settings. This copy will replace the template in the list of session configurations displayed in the Open Session dialog box. Note that the T template indicator will no longer be displayed.

6-13

Setup Menus

Save Session As...

(Not available in WBT mode)

TeemTalk for Windows CE

This will display a dialog box that enables you to save the current session configuration as a connection template.

You can create multiple connection templates, any one of which can be selected for use. The procedure is as follows:

1. In the Saved Items box, indicate which settings are to be saved by checking the

boxes next to the relevant options.

2. In the Save As File Name text box, enter a descriptive name to enable it to be identified for future selection. This description will be listed in the Open Session dialog box.

3. Click the OK button to save the template settings. If you specified a descriptive name that already exists, a message box will ask you to confirm whether or not you want to overwrite the existing name with the new settings.

TeemTalk for Windows XPe

This option is only available if TeemTalk for Windows XPe was started without a session (i.e. not started by clicking on a desktop icon or by selecting a session from the Start menu). It will display a dialog box that enables you to save the current session configuration under a new name.

The procedure is as follows:

1. In the Saved Items box, indicate which settings are to be saved by checking the boxes next to the relevant options.

2. In the Save As File Name text box, enter a descriptive name (up to 132 characters long) to enable it to be identified for future selection. This description will be listed in the Open Session dialog box.

6-14

Setup Menus

3. Click the OK button to save the session. If you specified a session name that

already exists, a message box will ask you to confirm whether you want to overwrite the existing session name with the new settings.

Startup Options...

(Not available in WBT mode)

The following dialog box will be displayed when this option is selected.

This enables you specify whether the emulator is to make a host connection using the default connection template, display the New Connection dialog box, or display the Open Session dialog box when it is loaded (but not when it is reset). Refer to the relevant descriptions earlier in this section for information on these dialog boxes.

Printer Setup...

This will display a dialog box that enables you to specify print settings. The options available depend on whether you are running TeemTalk for Windows CE or XPe.

6-15

Setup Menus

TeemTalk for Windows CE

TeemTalk for Windows XPe

6-16

HP Neoware e140 Thin Client User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Contents

Introduction

About This User's Guide

Terms & Conventions

Getting Started

WBT Session Configuration

Using The Connection Wizard

2. Select Terminal Emulation Client and click OK. The Connection Information dialog box will be displayed.

Terminal Emulation Configuration

Emulation Options

Graphics Mode

DEC Suite Options

BQ 3107 Option

HP 700-92/96 Option

IBM 3151 Option

IBM 3270 Options

IBM 5250 Options

TCP/IP Connection Settings

TN3270 Options

TN5250 Options

5250 Printer Options

SSL Connection Settings

Notes About Certificates

SSH Connection Settings

SSH Key File Permissions

Modem Connection Settings

The Modem Settings dialog box can be displayed from the Connection Wizard Host Information dialog box by setting the Connection Type to Modem then clicking the Advanced button, or the New Connection dialog box when in non-WBT mode by

Serial Connection Settings

Flow Control

Local Echo

Automate Login Process

Printer Port Settings

Clicking the Advanced button will display the standard Print Manager dialog box which enables you to specify printer settings.

GUI Overrides

The GUI Overrides dialog box enables you to disable various GUI items and also enables you to specify how the emulator responds when the host closes the connection.

Aux Port Settings

Session Management (Windows XPe)

Logged On As System Administrator

Logged On As A User

TeemTalk for Windows CE Display

Setup Menus (Windows CE)

The Button Tools (Windows CE)

The Soft Buttons (Windows CE)

TeemTalk for Windows XPe Display

The Menu Bar (Windows XPe)

The Toolbar (Windows XPe)

The Soft Buttons (Windows XPe)

The Status Bar

Hotspots

AT&T 4410 Emulation

Viewdata Mode

Keyboard Configuration

Keyboard Mapping

Defining Key Functions

You can redefine the function of keys on the keyboard using the Define Keyboard Macros dialog box which is displayed by selecting Keyboard Macros in the Settings

Defining A Key Or Key Combination

Key Combinations & Sequences

Specifying Characters

Compose Character Sequences

Mouse Functions

Introduction

Redefining Mouse Functions

Selecting & Copying Text

You can use the mouse buttons to copy and paste text. The region of the display that will be selected for copying depends on whether you use the Select, Select and Copy, Select Rectangle, Rectangular Select and Copy or Select Word function.

Moving The Cursor In Block Mode

Send Keyword

The Send Keyword function enables you to click on any delimited word displayed on the screen and it will be sent to the host, as long as the word is not already defined as a hotspot. Keyword delimiters are space, NULL, / , : = ( ) [ and ].

Show & Action Hotspots

You can identify hotspots that are currently present in display memory by using the Show Hotspots function. All colour attributes will be temporarily removed from the display and the hotspots will be highlighted with a red background.

Emulating Middle Mouse Button

The Toolbar

Using The Toolbar

The Predefined Button Tools

Redefining The Toolbar

Adding Buttons

Adding A Space Between Buttons