Xerox TeemTalk User Manual

TeemTalk

-05W, -07W & -11W

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 4.3.1

November 1999

Part number: TT6TM-4.3.1

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

The material in this user's guide is for information purposes only and is subject to change without notice. Neoware UK Ltd accepts no responsibility for any errors contained herein.

Trademarks

TeemTalk is a registered trademark of Neoware UK Ltd.

ADDS Viewpoint A2 is a trademark of Applied Digital Data Systems Inc.

D100, D200 and D410 are trademarks of Data General. DEC, VT52, VT100, VT131, VT220, VT300, VT320, VT340, VT420, ReGIS,

DECnet, LK250 and LK450 are registered trademarks of Digital Equipment Corporation.

Ethernet is a registered trademark of Xerox Corporation.

Hazeltine is a trademark of Esprit Systems, Inc. HP700/92, HP2392A and HP2622A are trademarks of Hewlett Packard Company.

IBM is a registered trademark of International Business Machines Corporation.

INFOConnect and Unisys are trademarks of Unisys Corporation. Microsoft and MS-DOS are registered trademarks, and Windows and Excel are

trademarks of Microsoft Corporation.

NEWT is a trademark of NetManage, Inc.

OSLAN is a registered trademark of ICL. PathWay is a trademark of the Wollongong Group, Inc.

PC/TCP is a registered trademark of FTP Software, Inc.

PowerStation is a trademark of KEA Systems. Prime is a registered trademark and PT250 is a trademark of Prime Computer, Inc.

Reflection is a registered trademark of Walker Richer & Quinn, 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.

TeleVideo is a registered trademark, and TeleVideo 910, 910+ and 925 are trademarks of TeleVideo Systems, Inc.

Tektronix is a registered trademark of Tektronix, Inc.

Westward is a registered trademark of Telemetrix, Inc.

WordPerfect is a trademark of WordPerfect Corporation. 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

What Is TeemTalk? ........................................................................ 1-1

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

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

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

Running TeemTalk......................................................................... 2-1

Quitting TeemTalk ......................................................................... 2-1

Host Communications ................................................................... 2-3

Creating A Communications Session ............................................... 2-3

Making A Serial Host Connection ............................................. 2-3

Making A Network Host Connection......................................... 2-4

Creating A Connection Template ..................................................... 2-6

Using Environment Variables To Locate Settings Files ........... 2-7

Selecting A Connection Template .................................................... 2-7

Selecting The Terminal Emulation ................................................ 2-9

Tablet & Mouse Configuration ................................................... 2-10

Primary Setup Mode .................................................................... 2-11

The TeemTalk Display ................................................................. 2-12

The Title Bar ................................................................................... 2-12

The Minimize & Maximize Buttons ............................................... 2-13

The Menu Bar .................................................................................. 2-13

Resizing The Window .............................................................. 2-14

The Toolbar ..................................................................................... 2-15

The Scroll Bar ................................................................................. 2-16

The Soft Buttons .............................................................................. 2-16

The Status Bar ................................................................................. 2-19

Contents-1

Contents

The Window Border & Corners ...................................................... 2-20

The Emulation Workspace .............................................................. 2-21

Default Font Sizes .................................................................... 2-21

The Text Cursor ............................................................................... 2-22

The Selection Cursor ....................................................................... 2-22

The Gin Cursor ................................................................................ 2-23

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

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

DEC LK250 Keyboard Drivers ..................................................... 3-8

Keyboard Nationality .................................................................... 3-9

Cursor Keys ................................................................................... 3-9

Remapping The Keyboard ........................................................... 3-10

Programming A Key........................................................................ 3-12

Entering Control Characters ............................................................ 3-13

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

Entering Command Lines ............................................................... 3-14

Changing The Window Focus ......................................................... 3-14

Initiating A Script File .................................................................... 3-14

Action Locally Or Transmit To Host .............................................. 3-14

Default Key Definitions .................................................................. 3-15

Euro Sign ......................................................................................... 3-15

Compose Character Sequences ................................................... 3-16

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

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

Redefining The Mouse Buttons ...................................................... 4-1

Selecting & Copying Text.............................................................. 4-3

Disabling The Copy & Paste Functions ....................................... 4-3

2-Button Mouse Emulating 3-Button ............................................ 4-4

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

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

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

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

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

Contents-2

Contents

The Predefined Button Tools ......................................................... 5-2

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

Adding Button Bitmaps ..................................................................... 5-5

Assigning Functions To Buttons ....................................................... 5-6

Removing Button Tools .................................................................... 5-8

Saving The Button Tools .................................................................. 5-8

Hotspots ............................................................ 6-1

Using Hotspots .............................................................................. 6-1

Defining Hotspots .......................................................................... 6-2

Setup Menus ..................................................... 7-1

Selecting & Closing Menus ........................................................... 7-1

Using The Menus ........................................................................... 7-2

Dialog Boxes ................................................................................. 7-3

Default Settings ............................................................................. 7-4

Creating A Connection Template .................................................. 7-5

Using Environment Variables To Locate Settings Files .................. 7-6

Selecting A Connection Template .................................................... 7-7

Menu Descriptions ........................................................................ 7-8

File Menu ........................................................................................... 7-8

Telnet Options ................................................................................. 7-19

Edit Menu ........................................................................................ 7-21

Settings Menu .................................................................................. 7-24

Emulation Settings .......................................................................... 7-25

Serial Settings .................................................................................. 7-27

NCSI Settings .................................................................................. 7-29

Terminal Settings ............................................................................ 7-31

Dialog Settings ................................................................................ 7-35

Gin Settings ..................................................................................... 7-38

Attributes ......................................................................................... 7-40

Keyboard Macros ............................................................................ 7-44

Euro Sign .................................................................................. 7-49

Soft Buttons ..................................................................................... 7-50

Mouse Button Actions ..................................................................... 7-54

Button Tools .................................................................................... 7-56

Help Menu ....................................................................................... 7-58

Contents-3

Contents

File Transfer....................................................... 8-1

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

Protocols Supported ...................................................................... 8-1

Sending Files ................................................................................. 8-3

Receiving Files .............................................................................. 8-5

Cancelling A File Transfer ........................................................... 8-7

Setting Protocol Parameters ......................................................... 8-8

General Parameters ............................................................................ 8-8

Kermit Parameters ........................................................................... 8-10

ASCII Parameters ............................................................................ 8-12

ZMODEM Parameters..................................................................... 8-14

Kermit Remote Operations .......................................................... 8-17

Local Operation .......................................................................... 8-19

ICL FTF File Transfer ........................................ 9-1

Configuration Requirements ......................................................... 9-1

Sending & Receiving Files ............................................................ 9-2

Transfer Options ........................................................................... 9-4

Remote Host Options ..................................................................... 9-7

FTP File Transfer ............................................. 10-1

The Transfer Procedure .............................................................. 10-1

Menu & Toolbar Options ............................................................ 10-7

The File Menu ................................................................................. 10-7

The Session Menu ......................................................................... 10-10

The Configure Menu ..................................................................... 10-11

The View Menu ............................................................................. 10-12

FTP Initialization File Entries .................................................. 10-13

Use Asynchronous Calls................................................................ 10-13

Disable Delete Command ............................................................. 10-14

FTP Command Line Options .................................................... 10-14

Progress Bar ................................................................................... 10-14

Disabling The Include Subdirectories Option .............................. 10-14

Time Out ........................................................................................ 10-14

Contents-4

Contents

Initialization Commands ................................ 11-1

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

Initialization File ......................................................................... 11-1

Windows 3.1x .................................................................................. 11-1

TeemTalk Private Profile File .................................................. 11-2

Windows 95 & NT .......................................................................... 11-3

Command Line Option Format ................................................... 11-5

Command Summary .................................................................... 11-6

Network Connection .................................................................... 11-8

Telnet Commands ...................................................................... 11-12

Session Configuration ............................................................... 11-13

Display....................................................................................... 11-17

Keyboard & Mouse ................................................................... 11-25

Printing...................................................................................... 11-27

Creating A Script File ..................................... 12-1

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

Initiating A Script File ................................................................ 12-1

Assigning Values To Variables ................................................... 12-3

Script File Examples ................................................................... 12-4

Syntax Conventions ................................................................... 12-12

Script Operators ........................................................................ 12-14

Command Descriptions ............................................................. 12-18

Error Numbers .......................................................................... 12-67

Script Error Trapping Functions .............................................. 12-71

PSET & PGET Parameters & Values ....................................... 12-73

FTU SET & GET Parameters ................................................... 12-86

Dynamic Data Exchange ................................ 13-1

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

DDE Terminology ....................................................................... 13-3

Hot & Warm DDE Links ............................................................. 13-3

Using The Edit Menu DDE Functions ........................................ 13-4

Contents-5

Contents

File Transfer ................................................................................ 13-6

Slave Mode .................................................................................. 13-6

Additional DDE Functions ........................................................ 13-18

DDE Link To A Visual Basic Application ................................. 13-24

Troubleshooting ................................................ A-1

Virtual Key Names ............................................ B-1

Standard Virtual Key Names ......................................................... B-1

DEC VT220 Virtual Key Names.................................................... B-2

Tek Virtual Key Names.................................................................. B-2

Key Reference Numbers .................................. C-1

Character Sets ..................................................D-1

Host Command Summary................................ E-1

VT52 Mode .................................................................................... E-1

ANSI VT100 Mode ......................................................................... E-3

ANSI VT220 Mode ......................................................................... E-6

Tek Mode ....................................................................................... E-7

W3220 Mode................................................................................ E-13

TeemTalk Additional Commands ................................................ E-15

Contents-6

Introduction

This chapter introduces TeemTalk terminal emulation software for Microsoft Windows and the contents of this User's Guide.

What Is TeemTalk?

TeemTalk for Windows provides precise emulation of a wide range of industry standard text and graphics terminals on any PC running Microsoft Windows. Multiple concurrent sessions with different hosts can be conducted over serial RS232 lines or local area networks (LANs) including DECnet, TCP/IP and Novell.

TeemTalk incorporates an impressive range of additional features formulated to increase productivity and reduce network loading. These include file transfer, session capture and replay, dynamic data exchange, a toolbar, hotspots, soft buttons, keyboard mapping, mouse button definition, connection templates, customising capabilities, a comprehensive script language, and an optional Application Programming Interface (API).

1-1

Introduction

About This User's Guide

This User's Guide describes how to use TeemTalk-05W, TeemTalk-07W and TeemTalk-11W version 4.3.1 for Windows 3.1x, 95 and NT. The information contained in the following chapters applies equally to TeemTalk-05W, TeemTalk07W and TeemTalk-11W unless indicated otherwise.

The illustrations in this User's Guide that show the TeemTalk window or dialog boxes are shown in the Windows NT style. The layout for Windows 3.1 and 95 will be very similar, but if their are significant differences then these will be illustrated accordingly.

If you require information on network protocols and facilities, refer to the TeemTalk for Windows Networking Guide.

Chapter 1: Introduction

Introduces TeemTalk for Windows and the contents of this User's Guide.

Chapter 2: Getting Started

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

Chapter 3: Keyboard Configuration

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

Chapter 4: Mouse Functions

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

Chapter 5: The Toolbar

Describes how to use the toolbar and redefine the buttons.

Chapter 6: Hotspots

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

Chapter 7: Setup Menus

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

Chapter 8: File Transfer

Describes how to transfer files using the Kermit, XMODEM, XMODEM-1K, YMODEM Batch, ZMODEM and ASCII protocols.

1-2

Chapter 9: ICL FTF File Transfer

Describes the ICL FTF file transfer utility supported by TeemTalk for Windows 3.1x in all terminal emulation modes.

Chapter 10: FTP File Transfer

Describes the FTP interface for file transfer across Windows Sockets based networks.

Chapter 11: Initialization Commands

Describes commands that can be included in the initialization file and on the command line to specify the loading configuration for TeemTalk.

Chapter 12: Creating A Script File

Describes how to create a script file to automate certain activities such as logging onto remote computers.

Chapter 13: Dynamic Data Exchange

Describes the support of dynamic data exchange (DDE) by TeemTalk.

Appendix A: Troubleshooting

Provides answers to the most commonly asked questions.

Appendix B: Virtual Key Names

Lists all the virtual key names that enable you to include a specific key function in a user definition for key macros, soft buttons, hotspots, etc.

Introduction

Appendix C: Key Reference Numbers

Lists all the valid key reference numbers used for key programming in Tek Primary Setup and host commands, and the script language PSET and PGET commands.

Appendix D: Character Sets

Shows the character set code tables supported by TeemTalk.

Appendix E: Host Command Summary

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

1-3

Introduction

Terms & Conventions

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

1. References to TeemTalk in the main text of this User's Guide apply equally to TeemTalk-05W, TeemTalk-07W and TeemTalk-11W for Windows 3.1x, 95 and NT unless indicated otherwise.

2. Some sections of this User's Guide assume you are using TeemTalk-07W or TeemTalk-07W32 when describing various procedures. References to TT07W in filenames and commands apply to TeemTalk-07W and TeemTalk-07W32 and, unless indicated otherwise, should be substituted with TT05W if you are using TeemTalk-05W or TeemTalk-05W32, or TT11W if you are using TeemTalk-11W or TeemTalk-11W32.

3. An asterisk in a filename or directory name must be substituted with the number indicating the version of your TeemTalk software unless specified otherwise. For example, 07 for TeemTalk-07W.

4. When references to keys are shown linked by a + (plus sign), this means that two or more keys have to be pressed at the same time. For example, 'press Ctrl + M' means press and hold down the Ctrl key, press the M key then release both keys.

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

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

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

1-4

Getting Started

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

Running TeemTalk

To run TeemTalk, display the TeemTalk group window (or the window you specified when installing the software) and select the icon shown below.

Mouse: Double-click the TT05W, TT07W or TT11W icon.

Keyboard: Press Ctrl + Tab until the icon is selected then press Return.

The screen will display a copyright message then the TeemTalk window (shown overleaf) in which the DEC VT100 emulation is running by default.

Quitting TeemTalk

You can quit an instance of TeemTalk in one of two ways, from the File menu when the window is displayed, or the Control menu when the window is displayed or iconized.

Quitting using the File menu:

Mouse: Click on File in the menu bar to display the File menu, then click the

Exit option.

Keyboard: Press Alt + F to display the File menu, then press X to exit.

2-1

Getting Started

Quitting using the Control menu:

Mouse: If the window is displayed, click the box or icon in the top left corner of

the window to display the Control menu, then click the Close option.

If the window is iconized, click the icon to display the Control menu then click the Close option.

Keyboard: If the window is displayed, press Alt + Spacebar to display the

Control menu. Press the down arrow key until the highlight rests over Close then press Return.

If the window is iconized, press Alt + Esc until the icon title is highlighted then Alt + Spacebar to display the Control menu. Press the down arrow key until the highlight rests over Close then press Return.

2-2

Getting Started

Host Communications

Creating A Communications Session

When TeemTalk is loaded for the first time, a dialog box will be displayed which enables you to configure TeemTalk for a serial or network host connection.

Note: If you do not wish to make a host connection at this moment,

just click the Cancel button to close the dialog box. You can display the New Connection dialog box again later by clicking File in the menu bar and selecting New Connection... in the menu.

The Type option specifies whether a serial or network connection is to be made. Clicking the arrow button will display a drop-down list box containing all the possible settings.

The Services option specifies the port or network host node which TeemTalk is to communicate with. This is a text box with an associated drop-down list box. You can either make a selection from the list box or enter a valid host name or internet address in the text box.

Note: If you are unfamiliar with using dialog boxes and setup

menus, refer to the beginning of the Setup Menus chapter.

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 Services list box.

Click the Configure... button to display the Serial Settings dialog box (shown overleaf) and make sure the settings match that of the host.

Click OK to return to the New Connection dialog box then click the Connect button.

2-3

Getting Started

Note: The options in this dialog box are described in the Serial

Settings section in the Setup Menus chapter and only apply when the connection type is set to Serial.

The status bar along the bottom of the TeemTalk window 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.

Making A Network Host Connection

To connect to a network host, select the protocol required in the Type list box:

TeemTalk for Windows 95 and NT:

TCP/IP CTERM WinSock 2 NetBIOS MultiLan ISDN LAT Microsoft SNA TeemTalk-OSI (option)

TeemTalk for Windows 3.1x:

LAT NetBIOS B and W. TCP INFOConnect FTP PC/TCP OSLAN WinSock ISDN Sun PC/NFS TELAPI Ext. NCSI DOSLANTI LAN W/Place BAPI Eicon X25 MultiLan NetManage Interrupt 14 IPX/SPX PathWay INT6B / NASI NetWare for LAT CTERM LanManager TeemTalk-OSI

Note: Refer to the Network Connection chapter in the Networking

Guide for a description of each protocol supported and for any additional configuration required prior to making a connection.

2-4

Getting Started

The Services list box (in the New Connection dialog box) will display the devices on the network which use the currently selected protocol. Click the name of the device required or, in the case of TELAPI, enter an Internet address in the text box (for example, 128.127.126.2). Note that either the host name or IP address may be entered for TCP/IP connections. When Eicon X25 is selected, TeemTalk requires you to enter a valid X25 address as none will be listed.

The Telnet Options button becomes available when a Telnet protocol is selected in the Type list box. The dialog box displayed when this button is clicked is described in the Setup Menus chapter.

Clicking the Connect button or the name of the host in the Services list box twice will cause TeemTalk 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.

Connection to the network host node will close 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. When the host closes the connection a message box will be displayed giving you the option of reconnecting to the network host node, cancelling the message box and returning to TeemTalk, or exiting TeemTalk.

A warning message will be displayed if you attempt to open a new session while a session is already open. If you attempt to exit TeemTalk while a network session is still active, the following message box will be displayed:

Any of these message boxes can be disabled so that the current connection is automatically closed when the host closes the connection, a new session is opened, or TeemTalk is exited. Refer to the Initialization Commands chapter for details.

2-5

Getting Started

Creating A Connection Template

You can save the current session configuration as a connection template. To make TeemTalk automatically attempt to make a host connection using the same settings the next time it is loaded, click the File option in the menu bar to display the File menu, then click the Save Session option.

TeemTalk enables you to create multiple connection templates, any one of which can be used either when TeemTalk is loaded or while it is running. The procedure is as follows:

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

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

3. In the Settings File text box, specify the name of the terminal emulation settings file (and the directory path if different from the default) which is to store settings only affecting the terminal emulation. The default filename is tt*w.nv where * is 05, 07 or 11, depending on your version of TeemTalk.

4. In the Save As File Name text box, specify the name of the workspace settings file (and the directory path if different from the default) which is to store the user preference settings selected by the Saved Items options. The default filename is

tt*w.wsp where * is 05, 07 or 11, depending on your version of TeemTalk.

Note: Splitting the saved settings into two files enables users to

share a common terminal emulation settings file while allowing each user to have their own workspace settings file.

2-6

Getting Started

5. In the Description text box, enter a unique description (up to 132 characters long)

which will be used to identify the connection template for future selection. This description will also appear in the Open Session dialog box.

6. Click the OK button to save the template settings. If you specified the names of

settings files that already exist, a message box will ask you to confirm whether or not you want to overwrite the existing files with the new settings.

Using Environment Variables To Locate Settings Files

When TeemTalk for Windows 95 or NT is installed on a terminal server, environment variables may be used to locate settings files on the client PC. This means that each client may use a different setup configuration, reading and saving settings locally, instead of changing files stored on the server which would affect all clients.

Each client must use the same user environment variable name to specify the directory path for the TeemTalk settings file(s). This name is then specified in the registry on the terminal server, enclosed by % (percentage) characters.

For example, each client has the user environment variable USERPROFILE pointing to a local directory (which may be different on each client). To make the directory specified by USERPROFILE the location of the TeemTalk settings files (.nv and .wsp), the TeemTalk registry entries on the terminal server would look like this:

NvPath: "%USERPROFILE%" WsPath: "%USERPROFILE%"

Selecting A Connection Template

The Open Session option in the File menu displays a dialog box that enables you to select a connection template for TeemTalk to use.

The Description list box displays the one-line descriptions of connection templates that were created using the Save Session As dialog box. The description of the

2-7

Getting Started

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 TeemTalk to use the connection template associated with the chosen description.

You can make TeemTalk automatically use a particular connection template when it is loaded or reset 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.

You can also use the following command line option to override the default connection template used when TeemTalk is loaded:

-se"description"

where description must exactly match the description assigned to a connection template already saved using the Save Session As dialog box. The description must be enclosed by double-quotes.

2-8

Getting Started

Selecting The Terminal Emulation

When you load TeemTalk for the first time, the DEC VT100 emulation will be running by default. All the terminal emulations supported by TeemTalk can be accessed from the Emulation Settings dialog box. This is displayed by selecting

Settings in the menu bar then Emulation... The emulations available are listed in the Emulation list box.

To change the current emulation mode, select the emulation required then click the OK button. The emulation setting may be saved so that TeemTalk will automatically run it when it is loaded or reset by selecting the Save Session option in the File menu.

A brief description of the emulation options follows.

VT52 and VT100 modes enable you to run applications written for the DEC VT52 and VT100 terminals, respectively.

Tek mode provides compatibility with software designed to drive the Tektronix 4100 or 4200 series terminals. Emulation of the Tektronix 4014 terminal can be achieved by selecting this option and setting the Dialog Area Enabled option in the Dialog

Settings dialog box to 0.

Edit mode provides compatibility with software designed to drive the DEC VT100

terminal. In this mode the following features are set to pre-determined conditions:

A. The dialog area is enabled and visible.

B. The dialog area buffer and scrolling region are set to 24 lines.

C. Cursor origin mode is set to Absolute (refer to the description of

the Cursor Origin option in the Dialog Settings dialog box).

2-9

Getting Started

D. Insert/Replace character mode is set to Replace.

E. Keys PF1 through PF4 generate ANSI cursor movement se-

quences.

F. All programmed strings for keys are temporarily disabled.

VT220-7 and VT220-8 modes are emulations of the DEC VT220 terminal, the difference is in their treatment of 8-bit control codes. When VT220-7 is selected, all 8-bit codes are converted to their 7-bit equivalents, whereas VT220-8 leaves 8-bit codes unchanged. If you are using VT200 applications, select VT220-7.

W3220 mode provides compatibility with software designed to drive the Westward 3220 terminal.

Tablet & Mouse Configuration

If you are using a tablet or mouse, you must specify the type of device and the port to which it is connected before TeemTalk will recognize it. To do this, display the Gin Settings dialog box by selecting Gin... in the Settings menu.

The Tablet Type option specifies the graphics input (GIN) device that is attached to your system and the data format that TeemTalk uses to communicate with it.

TeemTalk incorporates several tablet drivers. The following list includes the baud rate, data bits, stop bits and parity settings that are automatically set for the tablet type selected.

MM1201 Summagraphics MM1201

(9600, 8, 1, Odd)

MM1812 Summagraphics MM1812

(9600, 8, 1, Odd)

2-10

Getting Started

Bitpad-Plus Summagraphics Bitpad-Plus

(9600, 7, 1, Even)

Calcomp Calcomp (16 button)

(9600, 7, 1, Even)

Mouse Mouse

(Uses the communication settings specified in the Serial Settings dialog box)

Click the button next to the Tablet Type required then specify the Serial Port Device to which the Gin device is attached. You can save these settings so that TeemTalk will automatically assert them when loaded or reset by clicking the Save Session option in the File menu.

Refer to the Setup Menus chapter for a complete description of the Gin Settings dialog box.

Primary Setup Mode

TeemTalk can be configured for your hardware and application either by using setup dialog boxes displayed from the Settings menu in the menu bar, or by specifying settings in the Tektronix form of setup called Primary Setup.

The easiest way to configure TeemTalk is by using the various dialog boxes displayed from the Settings menu. Some of these are discussed in this chapter and all of them are described in detail in the Setup Menus chapter.

Primary Setup mode is used by those who have experience in programming. No menus are displayed and the only indication that you are in Primary Setup mode is an asterisk (*) character displayed in the first column. Primary Setup mode is toggled on and off either by clicking the Setup button at the bottom of the TeemTalk window or by pressing the keys Alt + Z together. Configuration is achieved by entering a command at the asterisk prompt followed by one or more values. The valid commands that can be entered are listed in the Command Summary appendix alongside the equivalent host commands.

You can display the current setup configuration by entering STAT (short for status) at the asterisk prompt and hitting Return. Changes made to the Primary Setup configuration are automatically reflected in the Settings dialog boxes and vice versa.

2-11

Getting Started

The TeemTalk Display

The TeemTalk window incorporates several special facilities in addition to the standard facilities supported by Microsoft Windows. The illustration below shows the various elements of the window which are described in the following sections.

Control Menu Icon Title Bar

Menu Bar

Text Cursor

Selection Cursor

Soft Buttons

Window Border Window Corner

Toolbar

Emulation Workspace

Status Bar

Shutdown Button

Minimize Button

Scroll Box

Scroll Bar

Scroll Arrow

The Title Bar

The title bar displays the name of your version of TeemTalk software (title), the name of the session currently running (subtitle) in brackets, and an indication of the current host connection (host name, IP address or COM port). You may specify a different title or subtitle on the command line for loading TeemTalk or in the initialization file. Refer to the Initialization Commands chapter for details.

2-12

Getting Started

The Minimize & Maximize Buttons

These buttons are used by the mouse to shrink the window to an icon or increase the window to the maximum size possible while still displaying the number of lines and columns specified in setup, the default setting being 80 columns by 32 lines. (The equivalent keyboard functions are enabled via the Control menu).

Note: The number of lines and columns displayed is affected by

the setting of the Resize Font, Rows and Columns options in the Dialog Settings dialog box. Refer to the Setup Menus chapter for details.

Once the window has been iconized, it can be restored to its original state by doubleclicking the icon.

When the window has been maximized, the maximize button changes to show an up and down arrow. Clicking the button now will restore the window to its previous size.

Note: You can cause the window to be minimized, maximized or

fill the display area when TeemTalk is first started by using an initialization file command or command line option. Refer to the Initialization Commands chapter for details.

The Menu Bar

The menu bar provides access to a series of commands and dialog boxes which enable you to perform various functions and configure TeemTalk for compatibility with the application.

One of four menus may be displayed at any one time. These are headed File, Edit, Settings and Help.

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.

When the menu bar is not displayed you can still display the menus by pressing the following keys:

Alt + F for the File menu Alt + E for the Edit menu Alt + S for the Settings menu Alt + H for the Help menu

2-13

Getting Started

When you display a menu and move the cursor over the menu options, the status bar at the bottom of the window will change to display a brief description of the option at the cursor position.

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

To close a menu:

Mouse: Click anywhere outside the menu.

Keyboard: Press the Alt key.

Resizing The Window

The menu bar also includes two commands for resizing the window.

The << and >> commands enable you to decrease or increase the size of the window to the size of the next smallest or largest font supported while retaining the same number of lines and columns.

2-14

Getting Started

To resize the window:

Mouse: Click the pointer over the << or >> commands.

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

character in one of the menu titles, for example, Alt + F. Press the right arrow key to move the highlight over << or >> and press Return.

The Toolbar

The toolbar and associated floating button palette provide a quick way of actioning commands or displaying setup dialog boxes by just clicking a button. TeemTalk displays a toolbar below the menu bar by default.

The toolbar contains a series of buttons with graphical representations of their functions. These buttons are predefined with functions found in the setup menus. You can redefine all the buttons and add or remove buttons from the toolbar via the Button Tools dialog box. Refer to the chapter entitled The Toolbar for a complete description.

The toolbar can be pulled away from the menu bar and floated on the display by positioning the mouse pointer anywhere in the toolbar except on a button, holding down the left mouse button then dragging the pointer down until the toolbar outline changes shape. Releasing the mouse button will display the floating button palette.

The floating button palette contains the same buttons as the toolbar. You can move and resize the palette in the same way as any other window. To convert the floating button palette back into the toolbar, click the control menu box at the top left corner of the palette window and select Attach. If you click the shutdown button on the floating button palette, you can restore display of the tool buttons by selecting the Button Tools option in the Settings menu and checking the Visible option in the dialog box.

2-15

Getting Started

The Scroll Bar

The scroll bar enables you to display alphanumeric data that is above or below the view of the dialog area. The dialog area is a 'window' into the dialog buffer which is used to store alphanumeric data. The dialog area may fill the entire emulation workspace or consist of only two lines. The scroll bar represents the entire buffer.

You can specify the size of the dialog buffer and the number of lines actually displayed (the dialog area) in the Dialog Settings dialog box, as described in the Setup Menus chapter. The total number of dialog buffer lines may not exceed 100.

A mouse is required to enable scrolling as keyboard commands for moving through the buffer are not supported. The scroll bar includes up and down scroll arrow buttons and a scroll box to enable you to scroll through the buffer.

The scroll arrow buttons allow you to scroll up or down a line at a time or several lines at a time when clicked, depending on the setting of the Burst Scroll option in the Dialog Settings dialog box. Holding down the mouse button while a scroll arrow is selected will enable continuous scrolling.

The scroll box allows you to quickly move through the buffer when it is dragged up or down the scroll bar by placing the pointer over it, holding down the left mouse button then moving the mouse.

Clicking the pointer in the scroll bar above or below the scroll box will cause the previous or next block of data to be displayed. (A block is equal to the number of lines and columns displayed in the window.)

The Soft Buttons

A set of soft buttons is displayed at the bottom of the TeemTalk window by default. These can be programmed so that they perform various functions when clicked.

There are 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. 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. You can specify how many levels of soft buttons are actually displayed by using an initialization file command or command line option.

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

+ 340 hidden pages