Copyright: ® FTP Software, Inc. 1995. All rights reserved.
Citation: ® Copyright FTP Software, Inc. 1995. All rights reserved.


Contents
TNVT Help Contents

Overview

Step-byStep Instructions

Concepts


Introducing TNVT

What is TNVT?

What is a Session?


Step-by-Step Instructions

Managing Sessions

Capture Session Output to a File

Close a Session

Create a New Session

Cut and Paste Session Output

Define a Session As You Create It

Delete a Session

Open an Existing Session

Print from a Session

Save a Session

Set General Session Parameters

Set Parameters for a New Session

Creating and Displaying Special Characters

Display Special Characters

Send Special Characters to the Host

Use International Keyboards

Using and Creating Scripts

Create a Script Using Teach Mode

Use Scripts

Write a Script Using Scripting Language

Customizing TNVT

Change Fonts

Change Screen Colors

Customize TNVT to Connect on Startup

Remap the Display

Remap the Keyboard

Set Emulation Preferences

Set Terminal Preferences

Troubleshooting Remote Login


Concepts

Commands

Commands Menu Commands

Edit Menu Commands

Script Menu Commands

Session Menu Commands

Settings Menu Commands

Reference

Downloading Programmable VT Function Keys

PC to VT Function Key Mappings

VT320 Compose Sequences


What is TNVT?

Use TNVT to connect your PC to a remote UNIX, VMS, or other system using DEC VT terminal emulation. When your PC is connected, your PC and keyboard act as though they are directly connected to the remote host, allowing you access to all the applications and services that it offers.

Before you log in to a remote host with TNVT

1.	Know the hostname or Internet address of a remote host to which you want to connect. This host must run a Telnet server. To find out, ask the person who administers the remote host.

2.	Verify with the administrator for the remote host that the appropriate account information (for example, username and password) is established for you on that host. You need this login information when you make a connection to that remote host.

3.	Know the file naming conventions, case sensitivity rules, and wildcard syntax on the remote host and your PC.

4.	Define a session with the remote host.

Related Topics

What is a Session?

Introduction

Step-by-Step

Concepts


What is a Session?

A session is the set of interactions between your system and a remote host during a connection. TNVT lets you customize and save information about a session so that the application can use the same information for future connections.

You can create session definitions for several remote hosts and then choose which session or sessions you want to use when you start TNVT. You also can change characteristics of an existing session and save the changes for future use.

It is sometimes useful to open a session and make changes to it before connecting to the remote host. For example, you may prefer to set the keyboard and display characteristics before the connection is established. When there are already configured sessions, however, you can immediately connect to the remote host using a previously defined session.

FTP and TNVT save session definitions to a file named SESSION.INI in the directory that contains your application files. Because these applications share the same session definitions by default, when you create a new session, the session becomes available to both applications. Likewise, when you delete a session, it is no longer available to either of these applications.

Related Topics

What is TNVT?

Introduction

Step-by-Step

Concepts


The Commands Menu

Use Commands to control the state of the current session and to send Telnet commands to the remote host.

Some remote hosts do not support every option offered on the Commands menu. Also, the response to some commands may vary depending on how the remote host interprets the command. Ask your network administrator what options are available on systems at your site.

Use this command	To do this

Connect	Establish a connection to the remote host defined in the current session.

You can use Connect when a session is open but not connected. For example, if you opened a session to modify its parameters, choose Connect to make a connection that uses the new parameters.

Disconnect	Gracefully terminate a connection to a remote host, and keep the session open.

After you choose Disconnect, you can change the current session parameters and reconnect to the same host, or you can close the current session.

Send Telnet Are You There Request

Request a response from the remote host. Use this command if the connection is open, but the remote host does not appear to be responding. Responses can vary depending on the remote host.

Send Telnet Abort Output

Request that the remote host stop sending output from the currently executing process.

Send Telnet Interrupt Process

Send a Telnet interrupt process command to the remote host.

The response depends on the process that is running on the remote host when you send the command. In all cases, the connection remains open unless you explicitly close it.

Send Telnet Break	Send a Telnet break command to the server.

Negotiate Binary Mode On

Request that TNVT negotiate for a session in which the Telnet binary option is on. In binary mode, all data is in 8-bit format and is interpreted literally, without modification or filtering.

Note that selecting this option does not guarantee that the request will succeed. Negotiate Binary Mode On remains selected regardless of whether the session actually enters binary mode.

Negotiate Binary Mode Off

Request that TNVT negotiate for a session in which the Telnet binary option is off. This is the default for Telnet connections.

Abort Telnet Connection

Quit without gracefully closing the connection. Use this option only if problems on the remote host or on the network prevent you from logging out properly.

When you use Commands...

After you interrupt or stop a process, TNVT continues to display text. There may be a delay before you see a response from the remote system.


The Settings Menu

Use Settings to change session parameters during an active session, set the terminal type, and create and save keyboard and display remapping files that you can use with any session.

To make session definitions reusable, from the Session menu, choose Save or Save As before you close the session.

Use this command	To do this

General	Change the default parameters associated with a session, such as remote host, port, username, and password. The username and password settings are used only for scripting.

Terminal Preferences	Configure behavior of the numeric keypad, cursor keys, BACKSPACE, and ENTER keys. Change the number of columns in the screen display. Turn automatic line wrap on or off. Change the scroll rate.

Terminal Emulation	Change the terminal type or terminal emulation.

Keyboard Remapping	Assign new behavior to your PC keys by changing codes that the keys send to the remote host. You can map the keyboard so that when you press a key on your PC keyboard, the TNVT sends a value that you define, such as for a function key or escape sequence.

Display Remapping	Customize the display of characters that TNVT receives from the remote host.

Character Sets	Change the default character set for the current session.

Colors	Change screen colors for the current session.

Fonts	Select the correct font for your monitor. TNVT fonts work with EGA, VGA, and SuperVGA monitors. To maintain compatibility with the 80-column by 25-line terminal emulation software, you can select only fixed-width fonts.

TTF Auto Scaling	Allow automatic resizing of a TrueType font that you are using with the current session. This feature is available only with Windows version 3.1 or greater. When you resize the terminal emulation window, or when TNVT receives a request from the remote host to change the screen size, the font adjusts to fit the new window size.

Toolbar	Display or hide the TNVT toolbar.

High Priority	Improve the performance of TNVT when it is being used with a CPU-intensive application (for example, certain X server implementations) that adversely affect its speed.


Capture Session Output to a File

From the Session menu, choose Capture to File to record session output in a file on your PC.

In addition to writing remote system output to the file, TNVT records the session name and the name of the remote host to which you are connected. If a connection closes, is reset, or reopens, the file also includes that information.

When an output file is open, an "o" appears in the status line at the bottom of your terminal window and a check mark appears next to the Capture to File option.

To open an output file

1.	Open the session whose output you want to capture.

2.	From the Session menu, choose Capture to File.

TNVT displays the Open File dialog box.

3.	In the File Name box, type a name for the output file. The default filename extension is .OUT. For example, type this: c:\vtoutput\host_a.out

--or--

Browse through the directory structure and select a filename.

4.	Choose OK.

5.	If the file you specify already exists, TNVT prompts you to verify that you want to overwrite it. Choose OK to overwrite the contents of the file with output from the current session.

--or--

Choose Cancel if you do not want to overwrite the file.

To close an open output file

From the Session menu, choose Capture to File.

--or--

Let the output file close automatically when you close the session.

Related Topics

Open an Existing Session

Print from a Session

Introduction

Step-by-Step

Concepts


Set Parameters for a New Session

Use the Session Parameters dialog to view or change the default characteristics of a new session.

To save session definitions

From the Session menu, choose Save or Save As.

Related Topics

Change Screen Colors

Remap the Display

Remap the Keyboard

Set Emulation Preferences

Set Terminal Preferences

Introduction

Step-by-Step

Concepts


Print from a Session

If your PC is connected to a printer, either locally or over the network, you can print terminal emulation screens during a session. The emulator sends data to the default printer port.

Note that you must install and configure a printer in Windows before you can use this option.

To print the current screen display

From the Session menu, choose Print Screen.

TNVT prints the lines that are currently visible in the terminal emulation window. (If you resized your window to display only four lines, TNVT prints those four lines.)

To print the scrollback buffer contents

From the Session menu, choose Print Scrollback Buffer.

TNVT prints the current contents of the terminal emulation scrollback buffer. Depending on the size of the scrollback buffer, the printed copy may include more information than you see on your screen.

To change printer options

1.	From the Session menu, choose Printer Setup.

2.	 Select a different printer and set other options, such as paper size and number of copies.

To save jobs to a file when auto print is being used

1.	From the Settings menu, choose Terminal Emulation.

2.	Clear Print File on Auto Print Off.

To print saved print jobs

From the Session menu, choose Print Current Spool File.

This entry is highlighted whenever data has been saved to a spool file when auto print is being used. After you print this file, TNVT deletes the file and begins saving print jobs to a newly created spool file.

To print immediately when auto print is being used

1.	From the Settings menu, choose Terminal Emulation.

2.	Select Print File on Auto Print Off.

Related Topics

Capture Session Output to a File

Session Menu Commands

Setting Emulation Preferences

Introduction

Step-by-Step

Concepts


Set Terminal Preferences

Use the Terminal Preferences dialog box to customize your terminal.

To change the behavior of your keyboard and display during a session, from the Settings menu, choose Terminal Preferences.

Related Topics

Set Emulation Preferences

Introduction

Step-by-Step

Concepts


Set Emulation Preferences

Use the Terminal Emulation dialog box to change terminal emulation settings.

To request a different terminal type, or to change other terminal emulation characteristics, from the Settings menu, choose Terminal Emulation. To set the correct characteristics for each session, find out what terminal types and features are supported by the remote systems to which you want to connect.

Related Topics

Set Terminal Preferences

Introduction

Step-by-Step

Concepts


Remap the Keyboard

Use the Keyboard Remapping dialog box to customize key mappings.

To customize key mappings for a terminal emulation session, from the Settings menu, choose Keyboard Remapping. The Keyboard Remapping dialog box lets you redefine the character, string, or control sequences that TNVT sends to the remote host when you press a key.

If a keyboard remapping file is in use, the file's name appears in the title bar of the Keyboard Remapping dialog box. Use the File menu to create a new keyboard remapping file, open an existing file, or save changes to a file. Use the Mappings menu to restore default mappings for all keys, list keyboard mappings, or modify a key's shift state.

You can also define the keyboard remapping file to be used as the default for all sessions.

To use an existing keyboard remapping file

1.	From the File menu, choose Open.

2.	Type the name of the keyboard remapping file you want to use.

--or--

Browse through the directory structure and select a filename.

3.	Choose OK.

The file you select becomes part of the active session definition. You can use it without modification or you can change it.

4.	To return to your session, choose OK.

--or--

From the File menu, choose Exit.

To use an external default keyboard remapping file

This feature allows lets you change the values that keys are mapped to by default,  without using a keyboard remapping file.

1.	From the File menu, choose Open.

2.	Type the name of the keyboard remapping file you want to use as a default.

--or--

Browse through the directory structure and select a filename.

3.	Choose OK.

The file you select becomes part of the active session definition. You can use it without modification or you can change it.

4.	To return to your session, choose OK.

--or--

From the File menu, choose Exit.

To use the same map file for subsequent instances of this session

From the Session menu in the TNVT main window, choose Save.

To create new key mappings

1.	From the keyboard display, select the key that you want to map.

If you have previously mapped the key, or if the key is mapped by default, the Current Mapping box indicates what the key currently sends. You cannot change this box.

If you select a dead key, the name of the key (for example, "grave accent" or "umlaut") is displayed instead of the symbol.

2.	If you want the mapping to apply when you press the key along with another key, such as SHIFT, CTRL, or ALT, at Key to Map, select the appropriate box or boxes.

3.	In the New Mapping box, enter any combination of text strings, special characters, control sequences, and function keys that you want to send to the remote host when you press the key. You can choose an item in any of the list boxes to append it to the contents of the New Mapping box.

4.	Choose Map to redefine the key.

A confirmation dialog box appears, prompting you to confirm the mapping.

5.	If you want to map the key, choose Yes.

--or--

If you do not want to map the key, choose No.

Repeat steps 1 through 5 to map additional keys.

6.	When you finish mapping keys, save the changes to a file.

--or--

Choose OK to return to the current session and use the mappings for the current session only.

To save mappings to a file

1.	From the File menu, choose Save or Save As.

2.	If the file is new or if you chose Save As, type a name in the File Name box. The default filename extension is .KYB. For example, type this:

c:\keymaps\mymap.kyb

3.	If you want to protect the file from further modification, select Read Only.

4.	Choose OK to save the file.

You can use the same file for subsequent instances of the session. After you exit from the Keyboard Remapping dialog box, from the Session menu, choose Save.

To list current mappings

From the Mappings menu, choose List.

TNVT displays a listing of all keys that you have mapped for the current session.

To restore all default key mappings

If you decide to discontinue use of a keyboard remapping file for this session, you can return to the default mappings for all keys.

1.	From the Mappings menu, choose Reset All.

If you have mapped keys since last saving mappings to a file, a confirmation dialog box appears, prompting you to confirm saving the mappings.

2.	If you want to save your current mappings to a file, choose Yes.

--or--

If you do not want to save your current mappings to a file, choose No.

To restore a default key mapping

If you have mapped a key, you can choose to restore its default mapping value.

1.	From the keyboard display, select the key whose default mapping value you want to restore.

The Current Mapping box indicates what the key currently sends.

2.	Choose the Reset button.

A confirmation dialog box appears, prompting you to confirm the mapping.

3.	If you want to map the key, choose Yes.

--or--

If you do not want to map the key, choose No.

The Current Mapping box updates to indicate the key's default mapping value.

Related Topics

Keyboard Remapping Examples

List Current Key Mappings

Modify Key Shift States

Send Special Characters to the Host

Use International Keyboards

Introduction

Step-by-Step

Concepts


Modify Key Shift States

Use the Sensitivity to Caps Lock or Num Lock dialog box to modify the behavior of a key.

You can use the CAPS LOCK and NUM LOCK keys together with the SHIFT, CTRL, and ALT keys to modify the behavior of a key. Specifically, you can modify the mapping of a key so that when CAPS LOCK or NUM LOCK is on and you press the key, the value sent is the mapping assigned to the shifted state of that key (that is, a chosen combination of SHIFT, CTRL, or ALT together with the key).

To modify a Key's Shift State

1.	From the key display box, select the key or keys you want to modify.

The keys you select are highlighted.

If you select one key, its sensitivity and behavior are displayed. If you select more than one key, no information is displayed.

2.	From the New sensitivity box, select a lock state.

3.	From the New Behavior box, select a shift state.

4.	Choose Set.

TNVT prompts you to confirm the key mapping modification, then displays the key's sensitivity and new behavior.

To cancel a Key's Shift State

From the key display list box, choose Cancel.

Any modifications you made, as well as the dialog, are canceled.

Related Topics

Keyboard Remapping Examples

List Current Key Mappings

Remap the Keyboard

Introduction

Step-by-Step

Concepts


Keyboard Remapping Examples

These are some keyboard remapping examples for use with TNVT.

Mapping a Key to a Text String

To map the CTRL+P key combination to send the remote host a UNIX print command, use this procedure:

1.	In the keyboard display, select the P key. At Key to Map, select the Ctrl box.

If you have previously mapped the key, the Current Mapping box indicates what the key currently sends. You cannot change this box.

2.	In the New Mapping box, type the UNIX print command, options, and the name of the print file exactly as you would type it on the remote host command line. For example,

lpr -P printer1 test.lpr

sends the contents of the file test.lpr to the printer named printer1.

3.	In the VT Keys box, choose the ENTER key to append it to the print command (this causes TNVT to send the ENTER key sequence to the remote host). After you add the ENTER key, the New Mapping box displays this:

lpr -P printer1 test.lpr<Enter>

4.	Choose Map.

A confirmation dialog box appears, prompting you to confirm the mapping.

5.	Choose Yes.

Now you can press CTRL+P to send the print command to the UNIX host.

Mapping a Key to a VT Function

To map the NUM LOCK key to the VT320 function key PF1, use this procedure:

1.	In the keyboard display, select the NUM LOCK key.

If you have previously redefined the key, the Current Mapping box indicates what the key currently sends. You cannot change this box.

2.	In the VT Keys box, choose PF1 to insert it into the New Mapping box.

3.	Choose Map.

A confirmation dialog box appears, prompting you to confirm the mapping.

4.	Choose Yes.

Now you can use the NUM LOCK key as the VT320 function key PF1.

Mapping a Key to a PC Function

To map the F12 key to perform the NUM LOCK function on your PC, use this procedure:

1.	In the keyboard display, select the F12 key.

If you have previously redefined the key, the Current Mapping box indicates what the key currently sends. You cannot change this box.

2.	In the PC Keys box, choose NUM LOCK to insert it into the New Mapping box.

3.	Choose Map.

A confirmation dialog box appears, prompting you to confirm the mapping.

4.	Choose Yes.

Now you can use the F12 key in place of the NUM LOCK key.

Mapping an Accent Mark As a Single Character

To map an accent mark alone as a character, use this procedure:

1.	Press the dead key that corresponds to the accent mark you want.

2.	In the Current Mapping box, press the space bar after the dead key.

The accent mark appears by itself.

Related Topics

List Current Key Mappings

Modify Key Shift States

PC to VT Function Key Mappings

Remap the Keyboard

Send Special Characters to the Host

Use International Keyboards

Introduction

Step-by-Step

Concepts


Change Screen Colors

Use the Colors dialog box to change your screen colors.

To change the screen colors, from the Settings menu, choose Colors. You can specify colors for four types of characters.

Choose	To change the colors for

Normal	Characters that have no special display characteristics.

Bold	Characters whose brightness is intensified on a real VT terminal.

Blink	Characters that flash on and off on a real VT terminal.

Bold and Blink	Characters that have intensified brightness and that flash on and off on a real VT terminal.

To change colors

1.	Choose a character type from the Attributes list.

2.	To change the text color, select a color from the Foreground Color palette.

The attribute name changes color to reflect your selection.

3.	To change the background color, select a color from the Background Color palette.

The background of the attribute name changes color to reflect your selection.

Repeat steps 1 through 3 to change the colors for other types of characters.

To save your changes

Choose OK to exit from the Colors dialog box and apply the colors you have chosen to the current session.

To save the changes for use with subsequent sessions, from the Session menu, choose Save.

To return to default colors

Choose Defaults to return all characters to their default colors.


Customize TNVT to Connect on Startup

Using Program Manager, you can set up TNVT to automatically connect to a remote host when you choose the TNVT icon. You can set session parameters by specifying options on the startup command line.

To customize the icon

1.	Select the TNVT icon.

2.	From the File menu in Program Manager, choose Properties. Program Manager displays the Program Item Properties dialog box.

3.	In the description box, change the name of the icon to reflect how you have customized it. For example, if the command line specifies a connection to host ABC, you might rename the icon ABClogin.

4.	In the command line box, specify the filename WTNVT.EXE, followed by any command line options and arguments you want to use.

To use command line options

If you have already defined and saved a session in TNVT, you can supply its name on the startup command line, in the following format:

-S session_name	Connect to a remote host using parameters defined in a previously saved session. No other command line options are necessary or valid if you use this option.

If you do not want to use a predefined session, specify one or more of the following options:

[t ttype | x ttype] host [port]

where

host [port]	Specifies the name or Internet address of the remote host to which you want to connect. This argument must be last. You also can specify an alternative port number after the hostname (the default Telnet port is 23).

-t ttype	Specifies the beginning point in a list that TNVT uses when negotiating with the remote host for a terminal type. Normally, TNVT first offers a terminal type of VT320, then VT220, then VT100, then VT52, then IBMPC, and then ANSI. Specify a ttype keyword of VT220, VT100, VT52, IBMPC, or ANSI to change the starting point in the list.

-x ttype	Requests that TNVT negotiate with the remote host for a single specific terminal type. Valid ttype keywords are VT320, VT220, VT100, VT52, IBMPC, and ANSI.

To create several icons:

You can create several TNVT icons and use each one to establish a separate session. To create a new icon:

1.	Select the WinApps program window to make it the active window.

2.	From the File menu in Program Manager, choose New.

3.	In the New box, select Program Item and choose OK.

Program Manager displays the Program Item Properties dialog box.

4.	In the description box, name the icon to reflect how you have customized it. For example, if the command line specifies a connection to host ABC, you might name the icon ABClogin.

5.	In the command line box, specify the filename WTNVT.EXE, followed by any command line options you want to use.


Troubleshooting Remote Login

Here are some common situations that you might encounter while using TNVT and descriptions of how to respond.

You receive the following message:

Line n of keyboard remapping file is longer than 255 bytes. Rest of line bypassed.

Edit the indicated line of your keyboard remapping file so that it contains 255 characters or fewer.

The remote UNIX system does not recognize your terminal type.

TNVT negotiates for a terminal type using standard terminal identifiers. If these standard identifiers do not exist in the remote host's database, you need to supply an alternate identifier that does exist.

Find a VT100, VT220, VT320, or IBM PC terminal ID in the remote host's terminal information file (if you are uncertain about how to find this information, ask the administrator of the remote system).

In the Terminal Emulation dialog box, specify a valid terminal ID.

You see strange graphic characters instead of line drawing characters when using SCO ANSI terminal emulation.

Change the font to Terminal font.

Line drawing characters and international characters do not print properly.

For proper printing of line drawing and international characters, you must be using the display fonts supplied by FTP and your printer must be configured for the code page 850 symbol set. You can configure this through your printer's control panel or in WIN.INI settings. See the documentation for your printer for details.

If you are running the printer off a WLPD server, you can set up a queue that will prefix the print job with the proper escape sequences to configure the printer.

If the Windows print driver overrides your symbol set information, try using the generic/text print driver. This driver uses the tty.dat file that ships with Windows. You can get an edited version for use with WTNVT to support extended characters from the FTP BBS or by contacting support@ftp.com.

If you choose to use fonts other than those supplied by FTP, make sure the printer font closely matches your selection. First try to use the specific print driver; if it does not work, try the generic/text print driver. Non-FTP fonts may not display the correct characters for VT220 line drawing graphics.

Extended characters do not display properly in a TNVT session

For extended characters to display properly, the terminal characteristics must be set on the host as follows.

After you have connected to the host, enter the following command on the host:

stty -a

If the output shows cs8 and -istrip, the settings are correct.

If the output shows cs7 and istrip, the eighth bit will be stripped and the wrong character will be echoed back.

To correct the setting, enter the following command on the host:

stty cs8 -istrip


The Session Menu

Use Session to create and manage connections to remote systems.

You can define communication parameters under a convenient name, then reuse the definition when you want to log in to a remote host.

Use this command	To do this

New	Define a new session.

At a minimum, you must identify a remote host. Then you can accept the default settings for the session, or you can modify them.

Open	Open a previously defined session. Typically, you use Open to establish a connection. You also can open a session and change its parameters without connecting to the remote system.

Save	Save the current session definition in a session initialization file.

Saving a session lets you reuse it and automatically establish its settings each time you open the session.

Save As	Save the current session definition under a new name.

Close	End the current session. After you close one session, you can create a new session, open an existing session, or exit from the application.

Delete	Delete a defined session.

Capture to File	Record a session's output in a file on your PC.

Print Screen	Print the current contents of the terminal emulation window.

Print Scrollback Buffer	Print the current contents of the terminal emulation scrollback buffer. Depending on the size of the scrollback buffer, the printed copy may include more information than you see on your screen.

Print Current Spool File	Print the spool file that you requested TNVT create when auto print is being used.

This entry is highlighted whenever data has been saved to a spool file when auto print is being used. After you print this file, TNVT deletes the file and begins saving print jobs to a newly created spool file.

Printer Setup	Select a different printer to use for printing the screen display, and set other options, such as paper size and number of copies.

Exit on Disconnect	Exit from the application when the current Telnet connection closes.

Exit	Exit from the application.


The Edit Menu

Use Edit to transfer text between the local system clipboard and your terminal emulation window. Select the text using the mouse. You can copy and paste selected text within the terminal emulation window, or you can transfer text between a local file and the remote system.

You can conveniently use Edit menu commands to copy small amounts of text between your system and a remote host. However, you should use FTP to transfer entire files.

Use this command	To do this

Copy	Copy selected text from the terminal emulation window to the clipboard. You also can copy by pressing the right mouse button.

Paste	Send text from the clipboard to the remote host over the Telnet connection.

Select All	Copy to the clipboard all the text from the scrollback buffer and the terminal emulation window.


Create a New Session

Use the New dialog box to define a new session. Open a previously defined session with the Open dialog box.

If you are connecting your PC to a remote host for the first time, you must create and open a session. The session defines the interactions between your PC and the remote host. You can save the session definition and reuse it for future connections.

To create and open a new session

From the Session menu, choose New.

--or--

Choose the New button from the Open dialog box that you see when you start TNVT.

At a minimum, you must supply the name or address of the remote host to which you want to connect. You can either leave default settings for the session in effect or change the defaults before you connect to the remote host.

To use default parameters

1.	In the Host Name or IP Address box, type the name or Internet address of the remote host.

2.	Choose Connect to open the session and immediately connect to the remote host.

To modify default parameters

1.	Choose Session Parameters to see more options for defining the session.

2.	After you exit from the Session Parameters dialog box, choose Connect to open the session and immediately connect to the remote host.

To save session definitions

From the Session menu, choose Save or Save As while the current session is open.

Related Topics

Set Parameters for a New Session

Introduction

Step-by-Step

Concepts


Define a Session As You Create It

You can define or change session parameters when you create a new session. You can specify an alternate port number for the connection, and set keyboard, display, and emulation characteristics before you open the session.

To define parameters for a new session

1.	Choose New from the Session menu.

--or--

Choose the New button from the Open dialog box that you see when you start TNVT.

2.	In the Host Name or IP Address box, type the name or Internet address of the remote host.

3.	Choose Session Parameters.

4.	In the Session Parameters dialog box, change one or more of the options.

5.	Choose OK when you are finished making changes.

6.	In the New dialog box, choose Connect to open the session and immediately connect to the remote host.

--or--

Choose Customize to open the session without connecting so you can change settings.

To save session definitions

From the Session menu, choose Save or Save As while the current session is open.

Related Topics

Remap the Display

Remap the Keyboard

Set Parameters for a New Session

Introduction

Step-by-Step

Concepts


Remap the Display

To customize the display of characters in a session, choose Display Remapping from the Settings menu.

If a display remapping file is in use, the file's name appears in the title bar of the Display Remapping dialog box. Use the File menu to create a new file, open an existing file, save changes to a file, or return to using the default mappings.

Normally, the terminal emulator takes a character received from the remote host and maps it to the same character for display on your screen.

To select a standard character set for the display, choose Character Sets from the Settings menu. For example, if you want a session to display characters in a 7-bit French or Spanish character set, you can choose Character Sets from the Settings menu and select the character set; you do not have to remap the display.

To select a standard character set

1.	Choose Character Sets from the Settings menu.

2.	In the Character Sets dialog box, select a character set mode (multinational or national) and a character set.

To use an existing display remapping file

1.	Choose Open from the File menu.

2.	Type the name of the display remapping file you want to use.

--or--

Browse through the directory structure and select a filename.

3.	Choose OK.

The file you select becomes part of the active session definition. You can use it without modification or you can change it.

4.	To return to your session, choose OK.

--or--

From the File menu, choose Exit.

5.	If you want to use the same remapping file for subsequent instances of this session, from the Session menu in the main window, choose Save.

To remap a character

1.	In the Current Mappings box, select the character whose mapping you want to redefine.

This column	Shows this

Receive	A character and its hexadecimal value.

Display	What the terminal emulator displays when it receives that hexadecimal value from the remote host.

2.	In the Map To box, double-click a character to replace the character highlighted in the Display column of the Current Mappings box.

--or--

Select a character in the Map To box; then select Map.

Repeat these steps for as many characters as you want to map.

When you finish mapping characters, you can either save the changes to a file, or choose OK to return to the session and use the mappings for the current session only.

To return to the default mapping for a character

Select the character in the Current Mappings box; then choose Default.

To save your mappings to a file

1.	Choose Save from the File menu.

2.	Type a name in the File Name box. The default filename extension is .DIS. For example, type this:

c:\displays\newmap.dis

3.	If you want to protect the file from further modification, select Read Only.

4.	Choose OK to save the file.

5.	To return to your session, choose OK.

--or--

Choose Exit from the File menu.

If you want to use the same remapping file for subsequent instances of this session, from the Session menu in the main window, choose Save.

To restore default mappings

If you decide to discontinue use of a display remapping file for this session, you can return to the default mappings for all characters. To do so, from the File menu, choose Use Defaults.

To switch to using another file

1.	From the File menu, choose Open.

2.	Type the name of the display remapping file you want to use.

--or--

Scroll through the list of files and select one.

3.	Choose OK. The newly opened file becomes part of the active session.

Related Topics

Remap the Keyboard

Settings Menu Commands

Introduction

Step-by-Step

Concepts


List Current Key Mappings

The List Mappings dialog box shows keys that you have mapped during the current session. You can save these mappings to a file or use them for the current session only.

To list key mappings

From the Mappings menu, choose List.

If a keyboard remapping file is open, the list includes the contents of the file in addition to the mappings you have made but not yet saved. You cannot edit this list.

To change an existing mapping

Map the key to something different.

The new mapping overwrites the current mapping.

Related Topics

Modify Key Shift States

Remap the Keyboard

Introduction

Step-by-Step

Concepts


Change Fonts

By default, the terminal emulator chooses a font that is best suited for the display mode you selected with the Windows setup program. You can change the font by choosing Fonts from the Settings menu.

Fonts are supported on EGA, VGA, and SuperVGA monitors. You can select a font that does not match the display mode set on your system. However, be aware that not all fonts and modes are appropriate for use with terminal emulation.

If you are using Windows version 3.1 or greater, you can select a TrueType font that resizes automatically when the size of the terminal emulation window changes.

To change the font

1.	From the Settings menu, choose Fonts.

2.	In the Font box, select a font that is compatible with your system's display mode.

The Sample box displays an example of text in the font you selected.

3.	In the Font Style and Size boxes, select a font style and font size.

4.	Choose OK to close the Font dialog box.

To use a resizable font

1.	From the Settings menu, choose Fonts.

2.	In the Font box, select a TrueType font (one that has a TT symbol preceding its name).

The Sample box displays an example of text in the font you selected.

3.	In the Font Style and Size boxes, select a font style and font size.

4.	Choose OK to close the Font dialog box.

5.	From the Settings menu, select TTF Auto Scaling.

A check mark in front of the option means it is selected. Also, a TT appears in the status line at the bottom of your terminal emulation window when this option is selected.

Now the size of the font adjusts automatically when you change the size of the terminal emulation window.

To view or change the display mode

1.	From the Program Manager Main window, select Windows Setup.

2.	From the Options menu, choose Change System Settings.

Refer to Windows documentation for more information about changing the display mode.


Open an Existing Session

Use the Open dialog box to open a previously defined session. Define a new session with the New dialog box.

To open a session that is already defined, from the Session menu, choose Open. When a session is open, you can connect to a remote system, change session definitions, or save the session under a new name.

You can open only one session at a time in any instance of this application. Choose the application icon to start another instance and open another session.

To open a session and connect to a remote system

1.	Select a session from the list displayed in the Sessions Available box.

The Host box displays the name of the remote system defined for the current session, and the Port box displays the Telnet port number. You can type a new hostname or port number to connect to a different host or port.

2.	Choose Connect to immediately log in to the remote system.

The title bar displays the session name and current status.

To open a session without connecting to a remote system

1.	Select a session from the list displayed in the Sessions Available box.

2.	Choose Customize to open the session without connecting to a remote system.

The title bar displays the session name and current status.

When a session is open,

To perform this task	Do this

Connect to a remote system	From Commands, choose Connect.

Change session characteristics	From Settings, choose any option.

Save the session	From Session, choose Save or Save As.

End the session	From Session, choose Close.

Related Topics

Close a Session

Create a New Session

Save a Session

Introduction

Step-by-Step

Concepts


Save a Session

To record a session definition, from the Session menu, choose Save or Save As. The information is stored in a session initialization file.

Once you define and save a new session, you can simply use its name to connect to a remote system. If you make changes to an existing session, you must save the session again if you want the changes to carry over to subsequent instances of the session.

To save a session

While a session is open, from the Session menu, choose Save.

To save a session under a new name

1.	While a session is open, from the Session menu, choose Save As.

2.	In the New Session Name box, type the new name of the session.

You can use no more than 32 characters including spaces.

3.	Choose OK.

The new session name and current session parameters are saved in the session initialization file.

Related Topics

Close a Session

Introduction

Step-by-Step

Concepts


Close a Session

To end a session without exiting the application, from the Session menu, choose Close. Once a session is closed, you can open another session or exit from the application. Only one session can be open at a time in a given instance of the application.

Typing exit at the prompt on the remote host logs you out of the remote host but does not exit from TNVT. You still need to close the session or exit from TNVT, when you can save changes to the current session.

To close a session without exiting TNVT

1.	If you want to save session definitions, from the Session menu, choose Save or Save As.

2.	From the Session menu, choose Close.

If you changed session definitions without saving them, the application displays a prompt that gives you the opportunity to save them.

To close a session and exit TNVT

1.	If you want to save session definitions, from the Session menu, choose Save or Save As.

2.	From the Session menu, choose Exit.

If you changed session definitions without saving them, the application displays a prompt that gives you the opportunity to save them.

Related Topics

Create a New Session

Open An Existing Session

Save a Session

Introduction

Step-by-Step

Concepts


Delete a Session

Use the Delete dialog box to delete a defined session.

Deleting a session erases its definition from the session initialization file. Note that other FTP applications may use the session initialization file. By deleting a session definition, you make the session unavailable to those applications as well.

To delete a session

1.	From the Session menu, choose Delete.

2.	In the Delete dialog box, select a session name from the Current Sessions list.

3.	Choose Delete.

The application prompts you to verify that you want to delete the session.

4.	Choose OK to delete the session.

--or--

Choose Cancel if you decide you do not want to delete it.

Repeat steps 2 through 4 to delete additional sessions.

When you finish deleting sessions, choose Cancel to exit from the Delete dialog box.


Write a Script Using Scripting Language

TNVT uses the TRAC scripting language. TRAC is a powerful language for experienced programmers. Most users will find TNVT's Teach Mode to be a more convenient way to create scripts.

To write a new script using TRAC scripting language

1.	From the Script menu, choose New.

The Notepad editor opens.

2.	Use the Notepad editor to write the script.

For information about the TRAC scripting language commands, see the Trac Programmingmanual.

For information about the Notepad editor, see your Windows documentation.

3.	Save the completed script by choosing Save from the File menu.

To edit a script

1.	From the Script menu, choose Open.

2.	Select the script that you want to edit.

3.	Choose OK.

The Notepad editor opens, with the script that you selected.

4.	Use the Notepad editor to make your changes.

For information about the TRAC scripting language commands, see the Trac Programmingmanual.

For information about the Notepad editor, see your Windows documentation.

5.	Save the script by choosing Save from the File menu.

The script is now available for you to run in this session and in future sessions.

Related Topics

Create a Script Using Teach Mode

Use Scripts

Introduction

Step-by-Step

Concepts


Using Scripts
Use Scripts

You can run an existing script, assign a script to run when you open a session, or unassign a script you assigned in an earlier session.

To run an existing script

1.	From the Script menu, choose Run.

2.	Select the script you want to run.

To stop a running script and return to TNVT, choose Stop from the Script menu.

To create a login script for a new session and assign it as the startup script

Follow the procedure for creating a login script for a new session in Create a Script Using Teach Mode. This procedure automatically assigns the login script as the startup script.

To assign a startup script from an open session

If you already have a session open, you can assign a startup script to run every time you connect to that session in the future.

1.	Choose Startup Script from the Script menu.

2.	From the popup menu choose Assign.

3.	Select the script you want to run in future connections of that session, and choose OK.

4.	Save the current session before closing the connection.

The script you selected will run the next time you connect to a host using that session.

To assign a script when creating a new session without starting Teach mode

When you create a new session, one of the options you can select is to assign a startup script to run every time you connect to that session. The script file should already exist, or you should create the script before the next time you connect to that session.

1.	Choose New from the File menu.

2.	In the New dialog box, choose Session Parameters.

3.	In Startup Script File, enter the name of a script file or select a script from the list, and choose OK.

4.	Save the current session before closing the connection.

The script you specify will run the next time you connect to a host using that session.

To unassign a script

1.	Choose Startup Script from the Script menu.

2.	From the popup menu, choose Unassign.

3.	Save the current session before closing the connection.

There will no longer be a startup script associated with that session. You can assign another script at any time.

Related Topics

Create a Script Using Teach Mode

Write a Script Using Scripting Language

Introduction

Step-by-Step

Concepts


Create a Script Using Teach Mode

TNVT has a Teach mode in which you "teach" TNVT what actions you want to perform during a session. TNVT then writes a script to carry out those same actions, in the same sequence, automatically.

For example, to teach TNVT how to log in to a remote host, start a database application, run a series of database commands, exit the application, and log out, you would perform each of those actions manually while TNVT is in Teach mode.

In Teach mode, TNVT also monitors the network information about the session and incorporates that information into the script that it creates.

To create a login script for a new session

1.	From the Session menu, choose New.

2.	Enter the new session information.

3.	Choose the Create Startup Script button.

4.	Teach mode starts. A message box informs you that you will need to set maximum timeout and the default prompt. Choose OK to open the Prompt dialog box, where you enter this information.

In the Prompt dialog box, the Prompt box displays queries from Teach mode (such as the value for maximum timeout) or the current prompt from the remote host. The Prompt box also asks how you want to respond to the query or prompt. Enter your responses to each query or prompt in the bottom half of this dialog box.

5.	Confirm or change the value for maximum timeout and choose OK.

6.	Confirm or change the value for the default prompt and choose OK.

TNVT connects to the target system, capturing the login information along with the rest of the actions you perform in Teach mode.

7.	In the Prompt dialog box, the Prompt box displays the current prompt from the remote host and asks how you want to respond to it. Enter your responses to each prompt from the remote host in this dialog box.

8.	Enter your username or select "Use my username here" from the list. Choose OK.

9.	Before entering your password, make sure the Hide Input box is selected so that your password will not be displayed in plaintext. Then enter your password or select, "Use my password here" from the list and choose OK.

10.When you have performed all the actions that you want to have included in the script, stop Teach mode by choosing "I am done with this teaching session" from the list of responses and choose OK.

Note: You must always choose the response "I am done with this teaching session" to finish your script. Also remember to do this when you include a logout command as part of the script.

11. In the Save dialog box, enter a name for the new script. The default filename extension (.scr) is shown.

12. Save the session.

When you create a login script this way, by choosing the Create Startup Script button on the New dialog box, the script is automatically assigned as the startup script for this session.

The script is now available for you to run in this session and in future sessions.

To create a login script for an existing session in Teach mode

1.	Open a session but do not connect to the remote host.

When you create a login script, do not connect to the host yourself; let TNVT automatically make the connection in Teach mode so that the login script can capture the initial login information.

2.	From the Script menu, choose Start Teach Mode.

3.	Follow steps 4-11 in "To create a login script for a new session."

The difference between that procedure and this one is that now you must explicitly assign the script to be the startup script.

4.	Assign the script to be the startup script for this session. From the Script menu choose Startup Script, and from the popup menu choose Assign. Select the script from the dialog box.

5.	Save the session.

The script is now available for you to run in this session and in future sessions.

To create a new script by teaching TNVT

Use this procedure to create a script after you have logged in to the remote host.

1.	Open a session, connect to the remote host, and log in as appropriate.

2.	From the Script menu, choose Start Teach Mode.

3.	A message box informs you that you will need to set the maximum timeout and the default prompt. Choose OK to open the Prompt dialog box, where you enter this information.

In the Prompt dialog box, the Prompt box displays queries from Teach mode (such as the value for maximum timeout) or the current prompt from the remote host. The Prompt box also asks how you want to respond to the query or prompt. Enter your responses to each query or prompt in this dialog box.

You can respond by entering information such as a host command in the text field, or by selecting from a list of options. Some responses will open a dialog box, where you can enter additional information.

4.	Confirm or change the value for maximum timeout and choose OK.

5.	Confirm or change the value for the default prompt and choose OK.

6.	The Prompt box displays the current prompt from the host and asks how you want to respond to it.

7.	Choose from the list or enter information in the text field. After each response, choose OK.

You will see the command executed on the host as if you had entered normally.

8.	Repeat steps 6 and 7 until you have performed all the actions that you want to have included in the script.

9.	Stop Teach mode by choosing "I am done with this teaching session" from the list of responses and choose OK.

Note: You must always choose the response "I am done with this teaching session" to finish your script. Also remember to do this when you include a logout command as part of the script.

10. In the Save dialog box, enter a name for the script. The default filename extension (.scr) is shown.

11. Save the session.

The script is now available for you to run in this session and in future sessions.

To cancel Teach mode

In the Prompt dialog box, choose the response, "Abort this teaching session."

--or--

From the Script menu, choose Stop.

Teach mode stops and the script is discarded.

To modify a script

To change an existing script, "teach" TNVT a new script to replace the old.

Follow the procedure for creating a new script using Teach mode. When saving the script, give the new script the same name as the script you want to replace. A dialog box will ask you to confirm that you want to overwrite the old script.

Related Topics

Use Scripts

Introduction

Step-by-Step

Concepts


The Script Menu

Use Script to compose, edit, and run scripts. Also use Script to assign a script to run when you start a session, or to unassign a script that you had previously assigned.

Use this command	To do this

Run	Run an existing script.

Start Teach Mode	Teach TNVT how to log into that specific session. The Teach command builds a script based on both your actions and the current network information.

Stop	Stop a running script. Also stops Teach mode.

New	Create a new script.

Open	Open an existing script.

Startup Script	Choose Assign Startup Script or Unassign Startup Script.

Assign Startup Script	Assign a script to run when you connect a session to a remote host.

Unassign Startup Script	Unassign a previously assigned startup script.


Use International Keyboards

If you configure an international keyboard through Windows, you can use that keyboard layout in TNVT.

When the Windows international keyboard driver is enabled, you will notice some differences in TNVT's Keyboard Remapping dialog box:

--	The keyboard layout that is displayed depends on the layout that you configure in Windows. Alphanumeric keys will be labeled appropriately for the keyboard layout. With some keyboard layouts, the function key names are translated; with other layouts, the key names are not translated. (This feature is determined by the Windows keyboard driver, not TNVT.)

--	The ALT key on the right side of the keyboard is mapped to the ALT-GRAPHIC function (ALT-GR in the PC Keys box). Pressing ALT-GR has the same effect as pressing CTRL and ALT simultaneously. When you select this key in the Keyboard Remapping dialog box, the Current Mapping box displays ALT (a Windows limitation), but the key actually is mapped to ALT-GR.

To set up international keyboard

Follow the standard Windows procedure for selecting a keyboard layout:

1.	In the Windows Control Panel, double-click the International icon.

2.	Select the keyboard layout you want to use, and choose OK .

Related Topics

Display Special Characters

Remap the Keyboard

Send Special Characters to the Host

VT320 Compose Sequences

Introduction

Step-by-Step

Concepts


Send Special Characters to the Host

You can send to a remote host characters that do not appear on the keyboard. For example, you can send characters with accent marks, ligatures (diphthongs), or special characters like currency symbols, superscripts, and fractions.

The characters that are displayed on your screen depend on your current configuration (display mapping, character sets, and fonts).

You can use any of the following methods to send special characters to the host:

--	Use the VT Compose key to send a sequence of characters. By default, ALT+F6 is defined as the compose key, but you can assign another key to this function with the Keyboard Remapping dialog box.

Note: The ALT key on the right side of the keyboard is mapped to the ALT-GRAPHIC function, not to Compose.

--	Use the PC dead key to combine two characters into one visible character.

--	Select from the available keys in the DEC multinational character set. In the Keyboard Remapping dialog box, the Text List box lists the keys available in the DEC multinational character set. The keys listed depend on the settings currently configured for your TNVT session.

To create composite characters with the compose key

1.	Press the Compose key.

2.	Type one of the characters of the sequence you want to create.

The order in which you enter the characters is significant in only a few sequences, such as ligatures (diphthongs) and fractions. Refer to VT320 Compose Sequences for a complete list of VT compose sequences.

The status line displays "Compose" to indicate that Compose mode is active. The character that you entered is not displayed.

3.	Type the other character of the sequence.

The composite character is sent to the host.

If you enter an invalid compose character sequence, a beep will be sounded, and no character will be displayed.

To create composite characters with dead keys

1.	Type the dead key that corresponds to the accent mark or symbol you want.

The character that you entered is not displayed. (This is the origin of the term, "dead key".)

2.	Type the letter that you want to combine with the accent mark.

The composite character is created and sent to the host.

If you enter an invalid character sequence, the two characters you typed will appear side by side. For example, if you enter a circumflex and then the letter z, and this sequence is not recognized by the keyboard driver, the result is a circumflex followed by a z (instead of a circumflex over the z).

You cannot embed a dead key sequence within a compose key sequence.

To generate an accent mark as a single character

1.	Press the dead key that corresponds to the accent mark you want.

2.	Press the space bar.

To cancel a compose sequence

If you started a compose sequence and you want to cancel it, press the Delete key. This cancels the compose sequence and stops Compose mode.

If you press the Compose key while already in Compose mode, the first sequence is canceled and a new compose sequence is started.

Also, pressing any of the following keys cancels a compose sequence and the keys perform their usual function:

--	Tab

--	Return

--	Enter

--	Function keys on the top row of the keyboard

--	Combinations of Ctrl and another key

--	Decimal point (.) on the numeric keyboard

Related Topics

Display Special Characters

Remap the Keyboard

Use International Keyboards

VT320 Compose Sequences

Introduction

Step-by-Step

Concepts


Teach Mode

Use the Prompt dialog box to create a script interactively. Also use this dialog box to respond to a TNVT script that requires user input.

To start Teach mode, from the Script menu, choose Start Teach Mode.

The Prompt dialog box opens. Use the Prompt dialog box to respond to each prompt from the host.

Related Topics

Create a Script Using Teach Mode

Use Scripts

Introduction

Step-by-Step

Concepts


Display Special Characters

Use the Character Sets dialog box to select the character set that your current VT320 session displays.

You can select between two 8-bit character sets and among 12 national character sets. The 8-bit character sets are ISO Latin-1 and the DEC Multinational set, also known as the DEC Supplemental Graphic character set.

An 8-bit (256-byte) character set byte has two parts. The left side, by default, is the ASCII character set. The right side is either the DEC Multinational set or ISO Latin-1.

In VT220 terminal emulation, you can use the DEC Multinational set and all the VT320 national character sets except Portuguese.

To select a character set

1.	From the Settings menu choose Character Sets.

2.	At Multinational Character Set Preference, select either Multinational or National.

3.	If you selected Multinational, select DEC Multinational or ISO Latin-1.

--or--

If you selected National, select a language from the list.

Related Topics

Remap the Display

Remap the Keyboard

Send Special Characters to the Host

Use International Keyboards

VT320 Compose Sequences

Introduction

Step-by-Step

Concepts


Set General Session Parameters

Use the General dialog box to change the default parameters associated with a session.

To change default settings for current session

1.	From the Settings menu, choose General.

2.	Enter the new values.

The username and password settings are used only for scripting.

3.	Choose OK.

Related Topics

Set Parameters for a New Session

Use Scripts

Introduction

Step-by-Step

Concepts


Special Keys
PC to VT Function Key Mappings

The following is a listing of VT keys and the PC keys you press to emulate their functions during a TNVT session. "Keypad" refers to the auxiliary (numeric) keypad to the right of the main keypad.

Note that some VT functions keys (F1, F3, F4, and F5) do not have corresponding PC key mappings because they are used for hardware functions on a real VT terminal.

VT Key	PC Key

Cursor Control Keys

Up arrow	F5 or keypad 8 (or up arrow on enhanced keyboards)

Down arrow	F6 or keypad 2 (or down arrow on enhanced keyboards)

Left arrow	F7 or keypad 4 (or left arrow on enhanced keyboards)

Right arrow	F8 or keypad 6 (or right arrow on enhanced keyboards)

Auxiliary Keypad Keys

0	0

1	1

2	2 (with NUM LOCK on)

3	3

4	4 (with NUM LOCK on)

5	5

6	6 (with NUM LOCK on)

7	7

8	8 (with NUM LOCK on)

9	9

. (period)	. (period)

ENTER	ENTER (or +)

, (comma)	- (or ,)

- (hyphen)	* (PRINT SCRN)

PF Keys (VT100, VT220, and VT320 Modes Only)

PF1	F1

PF2	F2

PF3	F3

PF4	F4

Function Keys (VT220 and VT320 Modes Only)

F2	CTRL+F2

F6	CTRL+F6

F7	CTRL+F7

F8	CTRL+F8

F9	CTRL+F9

F10	CTRL+F10

F11	ALT+CTRL+F1

F12	ALT+CTRL+F2

F13	ALT+CTRL+F3

F14	ALT+CTRL+F4

F15 (Help)	ALT+CTRL+F5

F16 (Do)	ALT+CTRL+F6

F17	ALT+CTRL+F7

F18	ALT+CTRL+F8

F19	ALT+CTRL+F9

F20	ALT+CTRL+F10

Programmable Function Keys (VT220 and VT320 Modes Only)

SHIFT+F6	SHIFT+F6

SHIFT+F7	SHIFT+F7

SHIFT+F8	SHIFT+F8

SHIFT+F9	SHIFT+F9

SHIFT+F10	SHIFT+F10

SHIFT+F11	ALT+SHIFT+F1

SHIFT+F12	ALT+SHIFT+F2

SHIFT+F13	ALT+SHIFT+F3

SHIFT+F14	ALT+SHIFT+F4

SHIFT+F15	ALT+SHIFT+F5

SHIFT+F16	ALT+SHIFT+F6

SHIFT+F17	ALT+SHIFT+F7

SHIFT+F18	ALT+SHIFT+F8

SHIFT+F19	ALT+SHIFT+F9

SHIFT+F20	ALT+SHIFT+F10

Editing Keys (VT220 and VT320 Modes Only)

Find	ALT+F (or INSERT key on enhanced keyboards)

Insert	ALT+I (or HOME key on enhanced keyboards)

Remove	ALT+R (or PAGE UP key on enhanced keyboards)

Select	DELETE key on enhanced keyboards

Previous Screen 	ALT+P (or END key on enhanced keyboards)

Next Screen	ALT+N (or PAGE DOWN key on enhanced keyboards)

Other VT320 Keys

Compose	ALT+F6

Related Topics

Downloading Programmable VT Function Keys

Introduction

Step-by-Step

Concepts


Cut and Paste Session Output

You can copy and paste text within the terminal emulation window.

You can also transfer small amounts of text between the local system a remote host by copying and pasting to or from a window on the local system from or to the terminal emulation window. However, to transfer entire files use the FTP application.

To copy and paste text

1.	Select the text using the mouse.

2.	Choose Copy from the Edit menu of whichever application has the text you are copying.

3.	Put the cursor where you want the text (in the terminal emulation window or in the window for another application) and choose Paste from the Edit menu.

To copy all the text from the scrollback buffer and the terminal emulation window

From the Edit menu, choose Select All.

This selects everything in the terminal emulation window, including text that has scrolled out of view, and puts it in the clipboard. You can then paste the text into other Windows applications.

Related Topics

Edit Menu Commands

Introduction

Step-by-Step

Concepts


VT320 Compose Sequences

To create the character shown in the Character column of the tables below, press the Compose key and then type the characters in the Sequence column.

You must be using an appropriate keyboard driver (set through the Windows Control Panel) to produce these characters. For the characters to be displayed on your screen, you must also select the appropriate character sets; from the TNVT Settings menu, choose Character Sets.

To cancel a compose sequence

Press the Delete key.

Compose Sequences for Multinational Characters

To display characters from Multinational character sets

1.	Choose Character Sets from the Settings menu.

The Character Sets dialog box appears.

2.	Select the Multinational button.

3.	Select DEC Multinational from the list.

You can use the diaeresis (¨) and ring (°) characters in a compose sequence (for example, to generate Ä) only if you have a keyboard driver that produces these symbols in a single keystroke. You cannot embed a dead key sequence within a compose sequence.

The order in which you type the characters in the right column does not matter except where indicated, such as for ligatures (diphthongs) and fractions. In the table, *** means you must enter the characters in the order shown in the Sequence column.

Character	Name	Sequence
"	quotation mark	" space
#	number sign	++
'	apostrophe	' space
@	commercial at	AA or aa
[	opening bracket	((
\	backslash	// or /<
]	closing bracket	))
ˆ	circumflex accent	ˆ space
`	grave accent	` space
{	opening brace	(-
|	vertical line	/ˆ
}	closing brace	)-
˜	tilde	˜ space
¡	inverted !	!!
¢	cent sign	C/ or C| or c/ or c|
£	pound sign	L- or L= or  l- or l=
¥	yen sign	Y- or Y= or  y- or y=
§	section sign	SO or S! or S0 or  so or s! or s0
¤	currency sign	XO or X0 or xo or x0
©	copyright sign	CO or C0
ª	feminine ordinal	A_ or a_
«	open angle brackets	<<
°	degree sign	0ˆ
±	plus or minus sign	+-
²	superscript 2	2ˆ
³	superscript 3	3ˆ
µ	micro sign	/U or /u ***
¶	paragraph sign	P! or p!
	middle dot	.ˆ
¹	superscript 1	1ˆ
º	masculine ordinal	O_ or o_
»	closed angle brackets	>>
¼	fraction one-quarter	1 4 ***
½	fraction one-half	1 2 ***
¿	inverted ?	??
À	A grave	A`
Á	A acute	A'
Â	A circumflex	Aˆ
Ã	A tilde	A˜
Ä	A umlaut	A" or ¨A
Å	A ring	A* or A°
Æ	A E diphthong	AE ***
Ç	C cedilla	C, (comma)
È	E grave	E`
É	E acute	E'
Ê	E circumflex	Eˆ
Ë	E umlaut	E" or ¨E
Ì	I grave	I`
Í	I acute	I'
Î	I circumflex	Iˆ
Ï	I umlaut	I" or ¨I
Ñ	N tilde	N˜
Ò	O grave	O`
Ó	O acute	O'
Ô	O circumflex	Oˆ
Õ	O tilde	O˜
Ö	O umlaut	O" or ¨O
Œ	O E diphthong	OE ***
Ø	O slash	o/
Ù	U grave	U`
Ú	U acute	U'
Û	U circumflex	Uˆ
Ü	U umlaut	U" or ¨U
Ÿ	Y umlaut	Y" or ¨Y
ß	German small sharp s	ss
à	a grave	a`
á	a acute	a'
â	a circumflex	aˆ
ã	a tilde	a˜
ä	a umlaut	a" or ¨a
å	a ring	a* or a°
æ	a e diphthong	ae ***
ç	c cedilla	c , (comma)
è	e grave	e`
é	e acute	e'
ê	e circumflex	eˆ
ë	e umlaut	e" or ¨e
ì	i grave	i`
í	i acute	i'
î	i circumflex	iˆ
ï	i umlaut	i" or ¨i
ñ	n tilde	n˜
ò	o grave	o`
ó	o acute	o'
ô	o circumflex	oˆ
õ	o tilde	o˜
ö	o umlaut	o" or ¨o
œ	o e diphthong	oe ***
ø	o slash	o/
ù	u grave	u`
ú	u acute	u'
û	u circumflex	uˆ
ü	u umlaut	u" or ¨u
ÿ	y umlaut	y" or ¨y
ISO CHARACTERS

To display ISO characters

1.	Choose Character Sets from the Settings menu.

The Character Sets dialog box appears.

2.	Select the Multinational button.

3.	Select ISO Latin-1 from the list.

Character	Name	Sequence
	no break space	space space
¦	broken vertical bar	|| or !ˆ
¬	logical not	- , ***
­	soft (syllable) hyphen	--
®	registered trademark	R O
	macron	-ˆ
¾	fraction three quarters	3 4 ***
÷	division sign	-:
×	multiplication sign	x x
´	acute accent	' '
¸	cedilla	,,
¨	diaeresis	" "
Ý	Y acute	Y'
ý	y acute	y'
Þ	capital Icelandic thorn	TH
þ	small Icelandic thorn	th
Ð	capital Icelandic Eth	- D
ð	small Icelandic Eth	- d
Compose Sequences for National Character Sets

To display characters from National character sets

1.	Choose Character Sets from the Settings menu.

The Character Sets dialog box appears.

2.	Select the National button.

3.	Select the desired language from the list.

British

£	pound sign	L- or L= or  l- or l=
`	grave accent	` space
Danish

#	number sign	++
'	apostrophe	' space
@	commercial at	AA or aa
`	grave accent	` space
                Dutch

£	pound sign	L- or L= or  l- or l=
'	apostrophe	' space
¼	fraction one-quarter	1 4 ***
½	fraction one-half	1 2 ***
¾	fraction three-quarters	3 4 ***
ij	i j sign	ij ***
f	Florin	f- ***
`	grave accent	` space
´	acute accent	' '
¨	diaeresis	" "
 Finnish

#	number sign	++
'	apostrophe	' space
Flemish and French/Belgian

£	pound sign	L- or L= or  l- or l=
'	apostrophe	' space
`	grave accent	` space
French Canadian

'	apostrophe	' space
à	a grave	a`
â	a circumflex	aˆ
è	e grave	e`
ê	e circumflex	eˆ
î	i circumflex	iˆ
ô	o circumflex	oˆ
ù	u grave	u`
û	u circumflex	uˆ
German/Austrian

'	apostrophe	' space
`	grave accent	` space
Italian

'	apostrophe	' space
Norwegian

'	apostrophe	' space
`	grave accent	` space
Portuguese (not supported in VT220 terminal emulation)

'	apostrophe	' space
`	grave accent	` space
Ã	A tilde	A˜
Õ	O tilde	O˜
ã	a tilde	a˜
õ	o tilde	o˜
Spanish

£	pound sign	L- or L= or  l- or l=
'	apostrophe	' space
§	section sign	SO or S! or S0 or  so or s! or s0
`	grave accent	` space
˜	tilde	˜ space
Swedish

#	number sign	++
'	apostrophe	' space
É	E acute	E'
é	e acute	e'
Swiss (French) and Swiss (German)

'	apostrophe	' space
ê	e circumflex	eˆ
î	i circumflex	iˆ
ô	o circumflex	oˆ
ù	u grave	u`
û	u circumflex	uˆ
Related Topics

Remap the Display

Remap the Keyboard

Send Special Characters to the Host

Use International Keyboards

Introduction

Step-by-Step

Concepts


Downloading Programmable VT Function Keys

You can redefine the programmable VT320/220 function keys (F6 through F20) for terminal emulation by sending control sequences from the remote host.

If the remote host is a UNIX system, the easiest method is to create a file containing the control sequences on the remote host, then use the UNIX cat command to send (download) the contents of the file across the network to your PC.

Note that to be able to generate and see unprintable ASCII escape sequences in your text file, you must use a text editor in literal mode. For example, in the vi editor, use the Ctrl+V command to enter literal mode.

The format of a key definition control sequence is as follows

start-character clear-parameter ; lock-parameter | key# / string end-character

where

start-character	Is a control character indicating that what follows is a device control string. To generate the 7-bit ASCII representation of this unprintable control character, press Esc+P while using a text editor in literal mode. The character appears as ^[P in your file.

clear-parameter	Specifies which of the programmable function keys (F6 through F20) to clear. A value of 0 clears the definition of all programmable function keys before loading new values onto the keys. A value of 1 clears only keys for which there are new definitions. A semicolon separates this parameter from the lock parameter.

lock-parameter	Specifies whether or not the key definitions can change during the session. A value of 0 prevents redefinition of the key (locks it). A value of 1 means that the key definition is modifiable. A vertical bar separates this parameter from the remainder of the control sequence.

key#	Identifies the key to define. The function keys have the following identifiers:

Key	Identifier

F6	17

F7	18

F8	19

F9	20

F10	21

F11	23

F12	24

F13	25

F14	26

F15	28

F16	29

F17	31

F18	32

F19	33

F20	34

string	Specifies the hexadecimal value of the ASCII string that you want the key to send. A slash separates the key identifier and its associated string. You can define several pairs of key identifiers and strings, separating each pair with a semicolon.

end-character	Indicates the end of the control sequence. To generate the 7-bit ASCII representation of this unprintable control character, press Esc+\ while using a text editor in literal mode. The character appears as ^[\ in your file.

Example: Reprogramming a Function Key to Execute a Command

The following control string redefines the F12 function key to execute the command ls -la with a carriage return (that is, to display a directory listing):

 ^[P1;1|24/6C73202D6C610D^[\

In this example,

^[P	Is the beginning control sequence.

1	Indicates that you want to clear only the specified function key.

1	Leaves the key redefinition open to change during the session.

24	Indicates that you are redefining the F12 function key.

6c73202d6c610D	Is the hexadecimal expression of the ls -la command string and carriage return. (Note that the space is coded.)

 6c 73 20 2d 6c 61  0D

 l  s      -  l  a  <CR>

^[\	Is the sequence terminator.

Example: Reprogramming a Function Key to Execute Other Function Keys

You can program a function key to send multiple function key sequences. For example, the following string indicates that you want to simulate pressing the F6 key followed by the F7 key on the remote host.

 1B 5B 31 37 7E 1B 5B 31 38 7E

 ^  [  1  7  ~  ^  [  1  8  ~

For a more detailed description of redefining programmable function keys, refer to the VT220 Programmers Reference Manual.

To invoke a reprogrammed function key

Press the Shift key followed by the function key.

For example, if you have reprogrammed the F12 key, invoke it by pressing the Shift key followed by the F12 key

Related Topics

PC to VT Function Key Mappings

Introduction

Step-by-Step

Concepts


Port
Port: A connecting point to a service offered by a host. By convention, hosts that offer Telnet services use port 23.


Terminal Emulation
Terminal emulation: A software process that allows your PC to send and interpret the terminal character and display codes supported on a remote host. To the remote host, your PC is no longer an independent processor. Instead, the remote host treats your PC as if it were a locally attached terminal. When terminal emulation is off, character interpretation does not take place.


Internet Address
Internet address: An Internet Protocol (IP) number that uniquely identifies a computer on a network. The form of an Internet address is four groups of numbers separated by periods, for example, 128.127.55.55.


Host
Host: A system on a local area network that offers services and applications to other systems. Typically, the host runs a server, or daemon, that manages communication between your PC and the host.


Interrupt Process Command
Interrupt Process command: A Telnet command that terminates a running program on the remote host.


EGA
EGA: The Enhanced Graphics Adapter standard supports low-resolution displays.


VGA
VGA: The Video Graphics Adapter standard supports high-resolution displays.


SuperVGA
SuperVGA: The Super Video Graphics Adapter standard supports very high-resolution displays.


Telnet Break Command
Break command: A Telnet command that emulates a break key or attention signal on the remote host.  Not all servers support this feature.


Default Settings
Default settings: By default, TNVT

•	Uses port 23 to communicate with a remote host

•	Uses the DEC multinational character set

•	Emulates a DEC VT320 terminal in 7-bit mode with an

80-column wide screen

•	Uses white background and black foreground screen colors for

normal characters

•	Sends a VT100 terminal ID when in VT-100 mode in reply to a

query from the remote host

•	Sets the auxiliary keypad to numeric mode

•	Interprets the arrow keys as cursor control keys

•	Sends the code for a delete character when you press the

BACKSPACE key

•	Sends the control codes for a carriage return and line feed when

you press the ENTER key

•	Truncates characters that extend past the length of a line

•	Uses remote echo mode

•	Sends each character to the remote host as you type it

•	Sounds your system's bell when the remote host requests it


Terminal Types
TNVT can emulate the following types of terminals:

•	VT320 with 7-bit controls (default)

•	VT320 with 8-bit controls

•	VT220 with 7-bit controls

•	VT220 with 8-bit controls

•	VT100 using the DEC character set

•	VT100 using the HFT character set

•	VT52

•	SCO ANSI

•	IBM PC


session.ini
SESSION.INI: A file that contains session definitions. You must explicitly save session definitions to be able to use them again. Otherwise, parameters you define and changes that you make affect the current session only. Several FTP applications may use SESSION.INI. Changes that you make in one application may be available to other applications. You may  edit the SESSION.INI file to view the state of sessions that are currently saved on your system. It is possible to edit the PCTCP.INI file so that different applications point to different session files.


Extended ASCII Character
Extended ASCII: Characters with decimal values in the range 128 through 255 (hexadecimal 0x80 through 0xFF). Unlike standard ASCII characters (the common set of letters and numbers used by all PCs), extended ASCII characters include accented letters, graphics symbols and other special characters.


Lock State
Lock state: A setting that specifies which, if any, lock key will affect the key's modified shift state.

Valid lock states are Caps Lock, Num Lock, and None.


Shift State
Shift state: A setting that specifies a key's modified behavior when CAPS LOCK or NUM LOCK is on. Valid shift states are:

•	VT52

•	SHIFT

•	CTRL

•	CTRL SHIFT

•	ALT

•	ALT SHIFT

•	ALT CTRL

•	ALT CTRL SHIFT


Script
Script: A collection of commands that are executed one at a time in the order they appear in the file. Scripts are also known as command and batch files, or macros.


Dead Key
Dead key: A key that, when pressed, does not display a character, but is combined with the keystroke that follows it to create a composite character. Dead keys are usually used to create letters with accent marks. Sometimes also called non-escaping key.


Compose Key
Compose key: The key on the PC keyboard that is mapped to the VT compose key function. On a VT terminal, a compose key lets you combine two or three keystrokes to create a character that is not available on the keyboard. For example, use the compose key to create a letter with an accent mark or a symbol (such as a currency sign), or a ligature. The default compose key for TNVT is ALT-F6.


Composite Character
Composite character: A character created by combining two or three keystrokes using the Compose keyor a dead key.


Scrollback Buffer
Scrollback buffer: The number of lines that TNVT uses to capture data that has scrolled beyond the border of the terminal window.


Auto Print
Auto print: A VT220/VT320 feature that takes the output from an application on the host, displays it to the screen, and stores it in a spool file. With auto print on, everything displayed on the screen is captured in a spool file. Then, when turn auto print is turned off, the data in the spool file is sent to your printer.


Spool File
Spool file: A temporary file used to store the output of an auto print or print controller escape sequence until the output is sent to the printer.


Default Prompt
Default prompt: The prompt character (or characters) on the remote host. The default prompt that Teach mode expects is the > character. If the remote host uses a different prompt, enter it in the Prompt dialog box in response to Teach mode's query when you start Teach mode.


Maximum Timeout
Maximum timeout: The number of seconds that can pass without network activity or without your responding to a prompt before Teach mode redisplays the Prompt dialog box. The default is 30 seconds. To set a different value, enter it in the Prompt dialog box in response to Teach mode's query when you start Teach mode.


account name: The name or word that identifes who is billed for this session on a computer system.


case sensitivity: The ability of a program to evalutate the difference between the capitalized and non-capitalized versions of a character. Case sensitive programs treat for example, cat and Cat, as distinct items.

It matters how you enter file and variable names on a case sensitive operating system (such as the UNIX operating system). If you want to view a file named Cat, and you enter the characters cat,  the system displays the file named cat if one exists, or gives you an error message. It does not display a file named Cat. Case sensitivity also effects the way that files are listed when sorted in alphabetical order.

.


filename conventions: A TCP/IP network usually contains computers that run different operating systems. Each operating system has different conventions for naming files. For example, both the number and kinds of characters that can be used in a name are often subject to limits.

When you use some TCP/IP supported services such as telnet and ftp, use the filenaming conventions in effect on the host system to work with files that are on the host.


hostname: The name of a networked computer.

The hostname is one form of the computers TCP/IP network address; the other is its complete numeric network address.You can access a computer by its hostname or its numeric network address.


toolbar: A group of buttons that appears below the menu bar. These buttons let you gain access quickly to the application's features.


IP address: A number that uniquely identifies a networked computer that uses the TCP/IP communication protocol. The Internet Protocol is defined in RFC 791.


MIB-II: The Management Information Base (MIB) database used by an SNMP MIB agent to store information about the network operations of your PC. MIB-II (or MIB version 2) is the second version of the Internet-standard MIB. RFC 1213 defines the format of MIB-II.


packet:

A single network message with its associated header, addressing information, data, and optional trailer. Also known as a "frame" or "datagram".


password: A word or string of characters that you supply in order to login to another system on a network. Systems that accept the username "anonymous" often require you to provide your e-mail address as the password.


permissions: On UNIX sytems, the long file listing (ls -l)  that shows who has access to a file and what rights (read, write, and execute) are given.


protocol window: Some OnNet applications support a window dedicated to displaying the interactions between your PC and the remote host (the protocol). You can display the window usually from a View, Settings, or Options menu.


remote host: A networked computer that makes a service available to other computers on the network. Typical host services include transferring files, printing files, and managing logins from remote users.


SNMP community: A relationship between an SNMP agent and one or more SNMP management stations.


SNMP community name: A unique name shared by the members of an SNMP community.


SNMP message: A packet of data, consisting of an SNMP community name and SNMP commands and operands.


status bar: A message area, typically at the bottom of the application window, that provides information about the component that is currently selected, or the state of the application.


session: A session comprises the interactions between your PC and a remote host  beginning with the initial connection and ending when you or the host explicitly disconnect.

Some OnNet applications allow you to configure sessions, that is, automatically send parameters such as your username and password to the remote host..


TCP (Transmission Control Protocol): A Transport layer, connection-oriented, end-to-end protocol that provides reliable, sequenced, and nonduplicated delivery of bytes to a remote or a local user. TCP provides reliable byte stream communication between pairs of processes in hosts attached to interconnected networks.


time out: A period of time when a connection between a PC and a  host computer is allowed to be idle or unused, or when a PC can attempt to make a connection to a networked host..

When the time period elapses, the host closes the idle connection, or the PC reports that it failed to connect to a host.


UDP (User Datagram Protocol): A Transport layer, connection-less mode protocol providing a (potentially unreliable, unsequenced, and/or duplicated) datagram communication for delivery of packets to a remote or a local user. UDP provides a procedure for a process to send messages to other processes with a minimum of protocol mechanism.


username: A name required for login to a remote system.


wildcard:  A character such as * or ? that represents one or more characters in a filename. In a network, each operating system supports its own wildcard characters and syntax. When you use wildcards on a remote host, follow the conventions that apply to that host.