Contents
SolarNet Telnet for Windows Help

The Telnet help system provides an overview of the procedures, commands, and user interface for the SolarNet Telnet for Windows application. Press F1 for information on how to use the Telnet help system.

 Introducing Telnet for Windows

How To...

 Configure Telnet

 Use the Modem Dialer

 Open a Telnet Connection

  Print Telnet Screens

 Transfer Files To and From Your PC

 Use Telnet Commands

 Record and Replay Log Files

 Use WordPerfect Mode

Reference

About the Telnet Interface

Telnet Command QuickReference

About File Transfers

About Modem Switches

About Programming Sequences

Troubleshooting Telnet for Windows

Glossary


 Introducing Telnet for Windows

The SolarNet Telnet for Windows application is a DEC VT320 terminal emulation program for IBM and IBM-compatible personal computers. SolarNet Telnet for Windows duplicates virtually all functions of the DEC VT320, VT220, VT102, VT100, and VT52 terminals.

SolarNet Telnet for Windows uses the TELNET protocol to provide a means of opening one or more sessions with remote hosts over a local area network or a serial connection. SolarNet Telnet for Windows offers many extended features, including:

  Kermit, ASCII, XMODEM, YMODEM, and ZMODEM file transfers

  Extensive command (script) language

  User-configurable key mapping

  Automated modem dialer with Phone Book support

  User-configurable toolbar

  Screen scrollback

  Data logging and replay

  WordPerfect mode(s)

  Color support

  Softkeys

 Dynamic Data Exchange


Configuring Telnet
 Configuring SolarNet Telnet for Windows

To customize a Telnet session:

1.	Pull down the Setup menu.

2.	Select the Telnet function you wish to customize.

For example, to customize the Telnet screen color scheme, choose Color Mapping from the Setup menu. To customize your Telnet terminal configuration, choose Terminal.

3.	Edit the settings in the dialog box that opens.

4.	Choose the Save button in the dialog box in which you are working.

Select one of the following topics for information on how to configure Telnets user interface, connection or application settings, or functions.

User Interface Configuration

Configuring the Telnet Display

Configuring Key Behavior

Configuring Key Mapping

Configuring the Keyboard Type

Configuring Mouse Mapping

Configuring Tab Settings

Configuring Toolbar Settings

Configuring Video Settings

Enabling Maximum Workspace Mode

Connection Configuration

Configuring Your Modem Initialization String

Configuring Port Settings

Configuring a Network Connection

Application Configuration

Entering Telnet Preferences

Entering International Settings

Entering Print Settings

Entering Terminal Settings

Specifying Margin/Warning Bells

Entering Printer Control Strings

Configuring Scrollback Memory

Configuring Search Directories

Configuring Send and Receive Command Strings

Specifying a Settings File Selection

Configuring Softkeys

Function Configuration

Configuring Auto Command Mode

Configuring DDE Command Builder

Configuring Dynamic Data Exchange (DDE)

Configuring File Transfers

Adding a Phone Book Entry

Editing a Phone Book Entry

Deleting a Phone Book Entry

Clearing the Phone Book

Using Softkeys in Phone Book Entries


About Dialog Boxes
Telnet Dialog Boxes

DDE, Softkeys, and Commands

Command File Selection Dialog Box

Command Files Dialog Box

DDE Command Builder Dialog Box

Dynamic Data Exchange (DDE) Dialog Box

Log File Replay Dialog Box

Log File Replay Setup Dialog Box

Record Log File Dialog Box

Settings File Selection Dialog Box

Softkeys Dialog Box

File Transfer

ASCII File Transfer Setup Dialog Box

ASCII Receive File Selection Dialog Box

ASCII Send File Selection Dialog Box

File Receive Selection Dialog Box

File Send Selection Dialog Box

File Transfer Setup Dialog Box

Kermit File Transfer Setup Dialog Box

Kermit Receive File Selection Dialog Box

Kermit Send File Selection Dialog Box

Send and Receive Command Strings Dialog Box

XMODEM File Transfer Setup Dialog Box

XMODEM Receive File Selection Dialog Box

XMODEM Send File Selection Dialog Box

YMODEM File Transfer Dialog Box

YMODEM Receive File Selection Dialog Box

YMODEM Send File Selection Dialog Box

ZMODEM File Transfer Dialog Box

ZMODEM Receive File Selection Dialog Box

ZMODEM Send File Selection Dialog Box

Modem and Connections

Auto Command Mode Setup Dialog Box

Auto Connect Port Dialog Box

Connect Dialog Box

Modem Dialer Dialog Box

Modem Setup Dialog Box

Phone Book Dialog Box

Phone Book Entry Selection Dialog Box

Switch Dialog Box

Port Setup Dialog Box

WINSOCK Setup Dialog Box

Printing

Print Dialog Box

Print File Selection Dialog Box

Print Setup Dialog Box

Printer Control Strings Dialog Box

Terminal Controls and Preferences

Bitmap Selection Dialog Box

Display Setup Dialog Box

First Time Setup Dialog Box

Help File Selection Dialog Box

International Setup Dialog Box

Key Behavior Dialog Box

Key Mapping Dialog Box

Keyboard Type Dialog Box

Margin/Warning Bells Dialog Box

Maximize Workspace Dialog Box

Mouse Mapping Dialog Box

New Keymap, Mousemap, and Toolbar Name Dialog Box

Preferences Dialog Box

Scrollback Memory Setup Dialog Box

Search Directories Dialog Box

Tab Settings Dialog Box

Terminal Setup Dialog Box

Toolbar Settings Dialog Box

Video Attribute and ANSI Color Mapping Dialog Box


Telnet Interface
About the Telnet Interface

 About the Menu Bar

 About Dialog Boxes

 About the Floating Toolbar

 About Keyboard Layouts

 Softkeys


About the Toolbar
About the Floating Toolbar

In addition to the standard Telnet toolbar, Telnet for Windows provides a user-configurable floating toolbar. This toolbar can be placed anywhere on the Windows desktop and can be sized to accommodate almost any configuration. You can define as many as 10 different toolbars, though only one floating toolbar can be visible at a time. The floating toolbar can process keystrokes, Emulator Command Language (ECL) commands, Command Files, and internal functions (tokens).

See Also:	Toolbar Settings Dialog Box

Toolbar Sizing and Location

Creating a New Toolbar

Deleting a Toolbar

Changing a Toolbar's Name

Automatically Sizing All Buttons

Setting the Default Caption Location

Adding a Button

Deleting a Button

Changing a Button

Entering a Caption

Entering the Help

Changing Button Size

Adding a Bitmap

Deleting a Bitmap

Token Strings

Internal Functions


Open a Telnet Connection
 Opening a Telnet Connection

To open a Telnet connection to a remote host:

1.	Open the Connect dialog box by pulling down the Connect menu and choosing Conn./Disc.

2.	Select the COM port or network through which you want to open a Telnet connection.

  To open a serial connection to a remote host, choose the COM port to which your modem is connected. Make sure you configured the COM port settings in the Port Setup dialog box.

  To open a network connection to a remote host, enter the name or IP address of the remote host in the Node Name text box.

By default, Telnet servers listen for connection attempts on port 23. If your server also supports Telnet connections on other ports, you can open a connection to a specific port by entering hostname:port# in the Node Name text box. For example, if host Bartleby supports Telnet connections on port 110, you could enter Bartleby:110 to open a connection to Bartleby.

3.	Click the Setup button. Make any desired parameter changes, then click OK.

4.	Click the Connect button or double-click the COM port or WINSOCK network name.

Telnet connects to the remote host and displays a login prompt.

5.	Enter your user name and password to log into the remote host.

See Also:	Opening an Automatic Telnet Connection

Opening Multiple Telnet Connections

Closing a Telnet Connection


 Closing a Telnet Connection

To close a Telnet connection and disconnect from a remote host:

1.	Choose the Switch command from the Connect menu to make the Telnet instance you wish to disconnect active.

2.	Choose the Conn/Disc command from the Connect menu.

The Connect dialog box is displayed.

3.	Choose the Disconnect button.

The Telnet connection is terminated, the Connect dialog box is closed, and the word "Disconnected" appears in the status bar at the bottom of the Telnet window.


 Opening Multiple Telnet Connections

To make multiple Telnet connections:

1.	Connect to a remote host using the Conn/Disc command on the Connect menu.

2.	Switch back to the Windows Program Manager.

3.	Start another instance of the Telnet program by double-clicking the Telnet icon again.

The window for a second instance of the Telnet program is displayed.

4.	Establish a second connection by using the Conn/Disc command on the Connect menu.

5.	Repeat steps 1 through 3 to open as many as eight Telnet connections.

6.	Use the Switch command from the Connect menu or click the Switch icon to switch between active Telnet connections.


 Opening an Automatic Telnet Connection

To connect to a host automatically when Telnet is started:

1.	Create an emulation command file (.ECF).

2.	Identify the emulation command file as the default file you want Telnet to execute when it runs.


 Printing Telnet Screens

To print the screen output from a Telnet session:

1.	Establish a connection to a remote host.

Refer to the instructions for connecting to a remote host for more information.

2.	Choose the Print Screen command from the Telnet File menu.

The text currently displayed on the Telnet screen is sent to the default printer.


Using Emulator Command Language
Using the Telnet Command Language

The Telnet Emulation Command Language (ECL) is a command/script language similar to DCL, Digital's Command Language for VAX/VMS. You can issue individual Telnet commands by entering them on the command line or by mapping them to keystrokes or toolbar buttons. You can set up commands files, which contain scripts of Telnet commands, to automate tasks such as dialing, file transfers, and data logging.

Executing Telnet Commands from the Command Line

Executing Telnet Commands from a Host Computer

Executing Telnet Commands from a Command File

Cancelling Telnet Commands

See Also:	Command Syntax

Command Quick Reference


Command Language Syntax
Command Syntax

Telnet commands appear in uppercase letters (e.g., WRITE HOST). Arguments shown in brackets [ ] are optional. The standard syntax for Telnet commands is:

COMMAND /OPTIONS(s) argument(s)

Commands are entered at the CMD> prompt and are followed by the command options and arguments. All options begin with a slash (/). Multiple command arguments are separated by spaces. If the argument is a string of characters, then the options must immediately follow the command. A command can be abbreviated to the minimum number of characters required to make it nonambiguous.

Examples:	SEND /FILTER DATA.TXT

SEND DATA.TXT /FILTER

Both forms of the SEND command are valid.

If the argument is a string of characters, the options must immediately follow the command. Character string arguments (referred to as strings) must be enclosed in quotation marks.

Example:	DISPLAY/NOCR "Hello there"

Shows an option with a string argument. The option directly follows the command, and the string (Hello there) is enclosed in quotes.


Command line prompt
Using the Telnet Command Line

To execute commands from the Telnet command line:

1.	Enter Telnet command mode by choosing the Command Line command from the Execute menu or by pressing the CMD key (default is Alt-C).

The Telnet CMD> prompt is displayed on the Telnet status line.

2.	Enter the command you want to use or the name of the command file you want to execute at the command prompt.

For example, CMD>HANGUP hangs up a modem connection.

Entering Multiple Commands

A series of commands can be given by entering interactive command mode. In interactive mode, the command prompt reappears after each command is executed.

You start interactive mode by entering the  INTERACTIVE command at the CMD> command prompt. You end interactive mode by entering the ENDINTERACTIVE command at the CMD> command prompt.

See Also:	Command Quick Reference

Using the Command Language


Executing ECL Commands from a Host
Executing Telnet Commands from a Host

Telnet commands can be executed under host control using a private control sequence.

CSI 5 | ..Command String.. ST

Note:	CSI and ST are 8-bit characters that can only be used on systems that support full 8-bit characters.

ESC [ is the 7-bit equivalent of CSI.

ESC \ is the 7-bit equivalent of ST.

Example:	CSI 5 | HANGUP ST

or

ESC [ 5 | HANGUP ESC \

The host uses these commands in programs, script or command files to hang up a modem connection.


Executing ECL Commands from a Command File
Executing Telnet Commands From a Command File

Command files are text files that contain scripts of Telnet commands. Command files are useful for automating tasks such as file transfers, logins, and defining keyboard configurations.

You can execute command files from the following:

Command line prompt

Key definition

Host computer

Modem dialer

Command file

Softkey

Specifying a Command File

Prefixing a filename with an At symbol (@) tells the emulator to expect a command file. The extension .ECF is automatically appended to the filename if another extension is not specified. The file name can also include a path specification.

Command files can be executes using a search path. Choose the Directories command from the Setup menu to set the command files default directory (search path).

Specifying a path name in the command file specification overrides the default path name.

Default Command File

Enter the name of the command file in the Default Command File field. This file executes whenever the emulator is loaded. Do not enter the @ symbol, or a filename extension. The default extension, .ECF, is appended.

Modem Dialer Execution

Each entry in the Modem Dialer Phone Book can have an associated command file. Once a modem connection is made, the command file executes automatically.

1.	Pull down the Connect menu and choose Dial to display the Modem Dialer.

2.	Click the Edit Phone Book button to display the Phone Book dialog.

3.	Select a phone book entry. This becomes the current entry.

4.	Enter the name of the Command File. Note that a path specification cannot be given.

5.	Click the Accept Changes button.

6.	Save the Phone Book to return to the Modem Dialer dialog box.

The next time this phone book entry is dialed, the command file executes after the connection is made.

Nested Command Files

To specify a command file from within a command file, precede the command file name with the @ symbol. After a nested command file is completed, it returns to the next line of the calling command file.

Comments

Comments are used to document and clearly state the purpose of the file and each line of the emulator command. They are prefixed with the exclamation point (!). Any data to the right of the exclamation point is ignored.

Example:	! This command file logs onto a VAX/VMS system and

! changes to the TEST directory.

WAIT "Username:"	! wait for host prompt

WRITE HOST "USER"	! send username to host

WAIT "Password:"	! wait for host prompt

WRITE HOST "USER_TEST"	! send password to host

! change to test directory

WRITE HOST "SET DEF [.TEST]"

EXIT	! exit command file


Cancelling Telnet Commands

You can cancel Telnet commands and command file execution by choosing the Abort command from the Execute menu or by clicking the Abort icon that appears on the status line whenever a command file is running.


Commands
Telnet Commands

Command	Function

ANSWER	Answer a modem

BREAK	Send a break

CLOSE	Close a file

CLS	Clear screen (short form)

CONTINUE	Resume execution of next command

DELAY	Delay specified time

DELETE SYMBOL	Delete symbol(s)

DIAL	Dial a phone number

DISPLAY	Output data (VT format)

DOS	Execute DOS command

DROPDTR	Drop Data Terminal Ready (DTR)

EMULATE	Enter Emulation mode from command line

ENDINTERACTIVE	End interactive command mode

ERASE SCREEN	Erase the screen

EXIT	Exit to Windows

FLUSH	Flush receive buffer

GOSUB	Execute a subroutine within a command file

GOTO	Go to a command file label

HANGUP	Hang up the modem

HELP	Display Help

IF	Test condition

INQUIRE	Prompt for input

INTERACTIVE	Enter interactive command mode

KERMIT	Enter Kermit mode

LOAD	Load setup file

LOG	Create a log file

MARGIN	Display the split screen scrolling prompt

MODEM	Display the Modem Dialer

ON ABORT	Set condition for ON ABORT

ON DEVICE_ERROR	Set condition for ON DEVICE_ERROR

ON DISCONNECT	Set condition for ON DISCONNECT

ON error-severity	Set condition for ON error levels

OPEN	Open a file

PICTURE	Create or display a graphics image

PRINT EJECT	Eject printer page

PRINT ON/OFF	Continuous print on/off

PRINT SCREEN	Print the text screen

PRINT/CONTROLLER	Pass data directly to the printer

QUIT	Quit to Windows

READ	Read a string from the host or file

REPLAY	Replay an emulator Log file

RETURN	Return from a GOSUB command

SAVE	Save current setup information to disk

SCAN	Display the key names

SCROLLBACK	Enter Scrollback mode

SEND	Send ASCII text file, Answerback message, or line feeds to host

SET ABORT	Set Abort key checking

SET CDELAY	Set delay for sending characters

SET DEVICE_ERROR	Set device error checking

SET DISCONNECT	Set disconnect checking

SET EOF	Set the End of File character

SET HISTORY	Set number of lines stored

SET HOST	Create a session to a remote node

SET LDELAY	Set delay for sending lines

SET MESSAGE	Set message control

SET ON	Set error checking

SET PRINTER	Set printer options

SET PRINTER PORT	Set printer port

SET TERMINAL	Set terminal characteristics

SET TURNAROUND	Set a turnaround character

SET VERIFY	Set verify mode

SHOW SYMBOL	Display local and global symbol values

STOP	Terminate execution of all command files

WAIT	Wait for a host string

WP ON/OFF	Enable/Disable WordPerfect 4.2 mode

WP5 ON/OFF	Enable/Disable WordPerfect 5.x mode

WRITE	Write a string to the host or file

See Also:	Telnet Command Syntax

Using Telnet Commands

Host Execution


Commands; Host Execution
Host Execution

Emulator commands can be executed under host control using a private control sequence.

CSI 5 | Command String ST

Note:	CSI and ST are 8-bit characters. They can only be used on systems that support full 8-bit characters.

ESC [ is the 7-bit equivalent of CSI.

ESC \ is the 7-bit equivalent of ST.


Commands; ANSWER
ANSWER

ANSWER (no arguments)

Waits for a call to be answered by the modem.

Example 1:	DIAL #3	! Dial entry #3 from phone book

DELAY 5	! Delay five seconds

HANGUP	! Hangup the modem line

ANSWER	! Answer the return call

@LOGIN	! Run automated login command file

Dials a security modem, hangs up the connection, and waits to answer the return call.

See Also:	DIAL


Commands; BREAK
BREAK

BREAK (no arguments)

Sends a 200 millisecond communications break to the COM port.

Options:

/LONG	Sends a long (3.5 second) break.


Commands; CLOSE
CLOSE

CLOSE logical-name[:]

where logical-name is a DOS file logical assigned by the OPEN command.

Closes the logical name previously opened with the OPEN command. If CLOSE is not issued, the logical name closes upon exit to Windows.

Options:	/ERROR=label	Process continues at the label if an error occurs.
Example 1:	INQUIRE DATE "Enter current date and time: "

!Get user input into DATE

OPEN/WRITE FILE1 DATA.LOG	! Open PC file DATA.LOG

WRITE FILE1 DATE	! Write DATE into file

CLOSE FILE1	! Close PC file

Puts a date and time stamp on a log file by opening the PC file DATA.LOG, writing the date, and closing the file. DATA.LOG can be added to later using the LOG/APPEND command.

See Also:	OPEN


Commands; CLS
CLS

CLS (no arguments)

Clears the screen. The CLS command performs the same function as the ERASE SCREEN command.

Example 1:	WRITE HOST "ls"	!UNIX command to list the files

DELAY 3	!Delay for command to display

INQUIRE FILENAME "Enter name of file to delete: "

!Prompt user for file to delete

WRITE HOST "rm ''FILENAME'"	!Delete the specified file

CLS	!Clear the screen

This UNIX example lists the contents of a directory, removes the specified file from that directory, and clears the screen.

See Also:	ERASE SCREEN


Commands; CONTINUE
CONTINUE

CONTINUE (no arguments)

Resumes execution on the next line of a command file. Often used with the ON command to ignore error conditions.

Example 1:	ON ERROR THEN CONTINUE

If an error occurs, the command file continues with the next line.


Commands; DELAY
DELAY

DELAY [dd:hh:mm:]ss

Delays the specified amount of time. All the fields, except seconds, are optional. Maximum value is 99:23:59:59.

The DELAY command is intended for command file use. It won't prevent the acceptance of Telnet commands sent from the host computer using a private control sequence.

Options:

/NODISPLAY	Data received from the host is not displayed on the screen during the delay period.

/NOMESSAGE	Disables display of the delay message.

Example 1:	DELAY 5

Delays command file execution for five seconds.

Example 2:	@@LOGIN

DELAY/NODISPLAY 5

WRITE HOST "ACCOUNTING"

EXIT

Runs the command file LOGIN.ECF, prevents all login messages from displaying on the screen, and starts an accounting application on the host.

Example 3:	LOG/OPEN SYSLOG.LOG

DELAY/NOMESSAGE 23:59

LOG/CLOSE SYSLOG.LOG

Opens a PC file SYSLOG.LOG, records host information for one day, and closes the file.


Commands; DELETE SYMBOL
DELETE SYMBOL

DELETE SYMBOL symbol-name

Deletes a symbol name from the local and/or global symbol table. The name of a symbol is required. Wildcarding is supported. The default is /LOCAL.

Options:

/GLOBAL	Deletes the symbol name from the global symbol table.

/LOCAL	Deletes the symbol name from the local symbol table.

Example 1:	DELETE SYMBOL *A

Deletes all the local symbols that end with "A".

Example 2:	DELETE SYMBOL/GLOBAL VARI??

Deletes all the six-letter global symbols that start with "VARI".


Commands; DIAL
DIAL

DIAL number

Dials the specified phone number. The phone number can be an actual phone number including dashes and commas, a name in the phone book, or a phone book entry number.

Example 1:	DIAL 9,1-333-111-2222

Dials 913331112222 with a one-second delay after the 9.

Example 2:	DIAL VAX

Dials the number in the phone book for the entry named VAX.

Example 3:	DIAL #1

Dials the number in the first entry of the phone book.


Commands; DISPLAY
DISPLAY

DISPLAY [[row,column]] [string-expression]

Where:	string-expression is a quoted string, lexical, symbol, or combination of the above joined by plus signs (+) (i.e. "string" + symbol).

Displays single or multiple lines of text to the screen.

DISPLAY can process VT320 escape sequences, lexicals, and symbols as part of the string expression.

An initial cursor position can be optionally specified in brackets [ ] immediately following the DISPLAY command. If specified, the cursor moves to the position indicated before the string displays. A position of 0 positions the cursor at the current row or column.

By default, data is output to the screen. Data can be displayed on status line by using the /STATUS option. DISPLAY sends a carriage return and line feed unless the /NOCR option is used.

Note:	Using cursor positioning while outputting data to the status line can produce unusual results.

Options:

/NOCR	Do not send a carriage return and line feed.

/STATUS	Sends the display string to the status line.

/DIALOG  [string-expression]

Displays the text defined by the string-expression in a dialog box.

Example 1:	DISPLAY "Hello there"

Displays Hello there at the current cursor position.

Example 2:	DISPLAY/NOCR [0,40] "Hello there"

Displays Hello there at the current row, column 40 on the screen.

Example 3:	DISPLAY

or

DISPLAY ""

Outputs a carriage return and line feed at the current cursor position.

Example 4:	DISPLAY/STATUS "<ESC>[?3h" + "132 columns"

Sets the screen to 132 column mode, and displays 132 columns on the status line.

Example 5:	DISPLAY /DIALOG "This is a message to the user."

Yields the following dialog box.

Note:	The D$BLOCK lexical is not supported with the /DIALOG option.

See Also:	INQUIRE


Commands; DOS
DOS

DOS [command_string]

Executes the DOS command_string and returns to Telnet.

If a DOS command string is not specified, the DOS prompt appears. Any valid DOS command can be entered at the DOS prompt. To exit from DOS, type EXIT followed by a carriage return.

If a DOS command is specified, Telnet executes the DOS command and holds the DOS screen. Pressing any key returns to emulation mode.

When the DOS command is issued by the host computer or from a command file, Telnet automatically returns to emulation mode without waiting for keyboard input.

Symbols can be used to assign DOS command strings to a more convenient form. For example,
DIR :== "DOS DIR" creates an emulator command that lists DOS directories. The default .ECF file contains several symbol assignments for simulating DOS commands.

Options:

/NOWAIT	When specified interactively, the DOS screen is not held until a key is pressed. The DOS command executes and returns to Telnet without pausing. It has no effect when used in a command file.

Example 1:	DOS TYPE READ.TXT

Executes the DOS command TYPE and displays the file READ.TXT on the screen.

Example 2:	TYPE :== "DOS TYPE"

TYPE READ.TXT

Creates an Telnet command TYPE, then displays the DOS file READ.TXT on the screen.

Example 3:	DOS/NOWAIT DEL TEST.LOG

Switches to DOS, deletes the TEST.LOG file, and returns to emulation mode.


Commands; DROPDTR
DROPDTR

DROPDTR milliseconds

Drops the DTR (Data Terminal Ready) and RTS (Request to Send) modem control lines for the specified number of milliseconds. If milliseconds is zero or missing DTR and RTS are dropped permanently.


Commands; EMULATE
EMULATE

EMULATE (no arguments)

Enters emulation mode from a command file. Pressing EXIT returns to the calling command file rather than to Windows.

The EMULATE command can be used with the  ON DISCONNECT command to enter emulation mode and return to a command file when the connection is lost or the user logs out.

Options:

/CASE	Forces case sensitivity for the return string comparison. /CASE is invalid without the /RETURN_STRING option.

/LABEL = command file label	Resumes execution of the command at the specified label. /LABEL is invalid without the /RETURN_STRING option.

/RETURN_STRING = string	Allows a command file to enter emulation mode and returns control to the command file when a specific string occurs. Execution of the command file resumes at the line immediately following the EMULATE command unless the /LABEL option is used.

Example 1:	50:	SET DISCONNECT

ON DISCONNECT THEN GOTO 100

EMULATE

EXIT/EM

100:	DISPLAY "ATTEMPTING TO RECONNECT"

@RECONNECT

IF $STATUS GOTO 50

DISPLAY "UNABLE TO RECONNECT"

EXIT/EM

Monitors connect status. If the connection is lost, the command file automatically tries to reconnect.


Commands; END
ENDINTERACTIVE

ENDINTERACTIVE (no arguments)

Terminates interactive mode. This command is not used in command files.

See Also:	INTERACTIVE


Commands; ERASE SCREEN
ERASE SCREEN

ERASE SCREEN (no arguments)

Erases the screen.

Example 1:	ERASE SCREEN

DISPLAY [10,20] "1. Dial modem 1"

DISPLAY [11,20] "2. Dial modem 2"

DISPLAY [13,20] "3. Exit emulator"

INQUIRE [14,20] "Enter menu option number: "

...

Erases the screen before displaying a menu.

See Also:	CLS


Commands; EXIT
EXIT

EXIT [specific-error]

Where specific-error can be an error code, a quoted mnemonic identifier, or a symbol. (for example, EXIT $STATUS)

Terminates processing of the current command file.

EXIT's behavior differs depending on the usage (interactive or command file mode). If used in interactive mode without an error parameter, Telnet exits. If used with a parameter, the message associated with the error parameter displays, and no other action is taken.

If used within a command file without a parameter, the EXIT command passes the error status to the calling routine. If error checking is enabled and an error parameter is provided, EXIT also prints the associated error message.

EXIT passes the status and severity codes of the error to the symbols $STATUS and $SEVERITY, respectively. It also saves the mnemonic for the error in the symbol $STATUSID and the full error message in F$MESSAGE. If the error message has displayed, bit 15 of the $STATUS symbol will be set to 1.

Options:

/EM	Exit Telnet and return to Windows with the corresponding $STATUS code passed to ERRORLEVEL. An exit leaves the modem control signals active.

Example 1:	CMD:EXIT

Exits Telnet.

Example 2:	LOG FILELIST	! Create FILELIST.LOG file

DELAY 1:00:00	! Delay 1 hour

LOG/CLOSE	! Close log file

EXIT	! Exit to emulation mode

Opens FILELIST.LOG, captures host information for 1 hour, closes the log file, and exits to emulation mode.

Example 3:	@@HANGUP

DELAY/NOMESSAGE 2

EXIT/EM

Runs the HANGUP command file, hides all messages and exits Telnet.

See Also:	ON, SET, QUIT


Commands; FLUSH
FLUSH

FLUSH (no arguments)

Empties the receive buffer to the screen. Insures that all data received from the host is removed from the receive buffer and displayed on the screen.

See Also:	WAIT


Commands; GOSUB
GOSUB

GOSUB label_name

Transfers execution to a subroutine label located within the command file. Use the RETURN command to exit the subroutine and resume execution in the calling routine. The calling routine continues at the line following the GOSUB command. (Usable in command procedures only.)

See Also:	IF, RETURN


Commands; GOTO
GOTO

GOTO label-name

Transfers program control to the statement following the specified label. (Usable in command procedures only.)

See Also:	ON, IF


Commands; HANGUP
HANGUP

HANGUP (no arguments)

Hangs up the current modem connection.

Example 1:	SET DISCONNECT

DIAL #1

ON DISCONNECT THEN GOTO BYE_NOW

EMULATE

BYE_NOW:

HANGUP

EXIT/EM

Dials a phone book entry and monitors the connection status. When the connection is lost, the modem is hung up, and Telnet exits to Windows.

See Also:	DIAL


Commands; HELP
HELP

HELP [keyword]

Displays help for emulator operation, features, and commands.

Specifying HELP with no keywords displays Help - Index.


Commands; IF
IF

IF condition THEN statement

Tests the value of an expression and executes the statement following the THEN keyword if the test is TRUE. If FALSE, the THEN statement is ignored, and execution continues with the next command line.

The expression is true if the result:

1)	Has an odd integer value between 32767 and -32767.

2)	Has a character string value that begins with any of the letters Y, y, T, or t.

3)	Has an odd numeric string value between "32767" and "-32767".

The expression is false if the result:

1)	Has an even integer value between 32767 and -32767.

2)	Has a character string value that begins with any letter except Y, y, T, t.

3)	Has an even numeric string value between "32767" and "-32767".

Rules:

1)	Symbols used in IF statements are automatically substituted.

2)	String comparison operators end in the letter S (.EQS., .LES., .GTS., etc.). Integer comparison operators do not end in the letter S (.EQ., .LE., .GT., etc.).

3)	String comparisons are case sensitive. Therefore, CASE and case are considered unequal. To inhibit case sensitivity, create the symbol using an implied literal string (:). The string converts to all caps, and can then be compared. (For example, in the assignment upper := case, the value of upper converts to CASE.)

Example 1:	COUNT = 0

LOOP:	COUNT = COUNT + 1

...

IF COUNT .LE. 10 THEN GOTO LOOP

This routine loops 10 times.

Example 2:	INQUIRE ANS "Want to continue [Y/N] (D:N)"

IF .NOT. ANS THEN EXIT

This routine exits unless ANS = Y.


Commands; INQUIRE
INQUIRE

INQUIRE [[row,column]] symbol-name [prompt-string]

Where prompt-string is a quoted string, lexical, symbol, or combination of the above joined by plus signs (+) (i.e. prompt-string = "string"+symbol).

Outputs a prompt string and waits for input. The input string is stored in the symbol-name specified. By default, the symbol-name is a local symbol. To make the symbol global, use the /GLOBAL qualifier.

Like DISPLAY, INQUIRE can process VT320 escape sequences, lexicals, and symbols in the prompt string.

An initial cursor position can be specified in brackets [ ] immediately following the command. If specified, the cursor moves to the position indicated before the prompt string displays. A cursor position of 0 places the cursor at the current row or column on the screen.

By default, INQUIRE uses the screen. However, INQUIRE uses the status line when the /STATUS option is specified.

Note: 	Using cursor positioning while outputting data to the status line can produce unusual results.

INQUIRE will not send a carriage return or line feed unless it is placed within the prompt string or the /CR option is used for a single line of text.

Options:

/CASE	By default, INQUIRE/KEY is not case sensitive. It will not return the S^ indicator with the key names for alphanumeric keys. Specifying /CASE returns the S^ indicator with uppercase alphanumeric keys. /CASE is only meaningful when used with the /KEY option.

/CR	Send a carriage return at the end of the prompt string.

/DIALOG  symbol-name [prompt-string]

Prompts the user for input from a dialog box rather than from the text emulation window. The user supplies a symbol name and a prompt string. The dialog box displays the prompt string and an edit field in which the user can type the symbol value.

/GLOBAL	The symbol name is defined as global.

/KEY	Reads a single key stroke and returns the ASCII key name for the key pressed. The key name returned is the same name displayed when the key is pressed while in Scan Mode. Key remapping is disabled when the /KEY option is used.

The /KEY option is useful for obtaining a single PC keystroke, such as an arrow key.

/LOCAL	The symbol name is defined as local. This is the default INQUIRE condition.

/MAX=count	Sets the maximum character count for an INQUIRE input line. If the input data exceeds the max count, the extra characters are ignored. The input line is not terminated until a carriage return is entered, unless the /TERMINATE option is specified.

/NOECHO	Input data is not echoed to the screen.

/STATUS	Send the prompt string to the status line.

/TERMINATE	Used with the /MAX option to allow an input line to terminate when the maximum character count is reached. When /TERMINATE is specified, input terminates on a carriage return or when the maximum number of characters is entered. /TERMINATE has no meaning when used without the /MAX option.

Example 1:	TIME_STR="Enter Time:"

INQUIRE/GLOBAL [5,0] TIME TIME_STR

Positions cursor at the 5th line and current column and displays the prompt "Enter Time:". The user input string is stored in the global symbol TIME.

Example 2:	INQUIRE/STATUS TIME "World time: "

Outputs "World time:" to the status line and stores the input string in the local symbol TIME.

Example 3:	INQUIRE/GLOBAL/NOECHO PASSWD "Password: "

Displays the prompt string "Password:". The input string is stored in the global symbol PASSWD. The input string is not echoed when it is entered.

Example 4:	50:	INQUIRE/KEY KEYSTROKE "<CR> <LF>Enter Up Arrow Key: "

IF KEYSTROKE="UP" THEN GOTO 100

GOTO 50

100:	DISPLAY "<CR> <LF>You just pressed the Up Arrow Key"

EXIT

Prompts the user to press the Up Arrow key. The name of the key pressed is stored in KEYSTROKE. A message is displayed once the correct key is pressed. Otherwise, it loops to the beginning for another key press.

Example 5:	WAIT/TIME_OUT=30 "Username:"

WRITE HOST "SMITH"

WAIT/TIME_OUT=30 "Password:"

INQUIRE/LOCAL/NOECHO PASS "Enter your password: "

WRITE HOST " ' ' PASS ' "

PASS = " "

EXIT

Begins the login process and prompts the user for the password. Stores user entry in PASS, sends it to the host, then erases the password from memory. Exits to emulation mode.

Example 6:	INQUIRE /DIALOG THEVAR "This is the prompt string"

This example would yield the following dialog box.

Note:	The D$BLOCK lexical is not supported with the /DIALOG option.

See Also:	DISPLAY


Commands; Interactive
INTERACTIVE

INTERACTIVE (no arguments)

Sets interactive command mode. Interactive mode is used to enter consecutive commands without choosing Command Line from the Execute menu each time. This command has little meaning in command files.

To cancel interactive mode, enter the END (ENDINTERACTIVE) command or Ctrl Z.

See Also:	ENDINTERACTIVE


Commands; KERMIT
KERMIT

KERMIT [kermit command string]

Enters Kermit mode. If the command is entered without a command string, the Kermit: prompt appears.

If a command string is specified, Telnet enters Kermit mode, issues the command, and returns to emulation mode.

Example:	WRITE HOST "KERMIT"

WRITE HOST "SET FILE TYPE BINARY"

WRITE HOST "SERVER"

KERMIT SEND/END TEST.ECF

WRITE HOST

WRITE HOST "EXIT"

This VAX/VMS example starts Kermit in binary transfer mode, uploads the PC file TEST.EXE, and exits Kermit mode.


Commands; LOAD
LOAD

LOAD setup

Loads the specified setup file. Allows emulator setup parameters to be changed from within a command file.

Example:	5:	ERASE SCREEN

DISPLAY [10,20] "1.  Connect to UNIX"

DISPLAY [11,20] "2.  Connect to VMS"

DISPLAY [12,20] "3.  Exit Emulator"

INQUIRE [14,20] SYSTEM "Enter the menu option number: "

IF SYSTEM .EQS. "1" THEN GOTO UNIX

IF SYSTEM .EQS. "2" THEN GOTO VMS

IF SYSTEM .EQS. "3" THEN GOTO EXIT

GOTO 5	! Improper selection made so go to beginning

UNIX:

LOAD UNIX

@ULOGIN

EXIT

VMS:

LOAD VMS

@VLOGIN

EXIT

EXIT:

EXIT/EM

Displays a menu of different host options. Depending on user input, the proper setup file is loaded, the user is logged on and returns to emulation mode, or Telnet is exited.


Commands; LOG
LOG

LOG filename

Opens an emulator log file. A log file captures all data sent to the screen. If the file exists and /OVERWRITE or /APPEND is not specified, an error results. The default is /OPEN. The default log file extension is .LOG.

Options:

/APPEND	Open a log file and append the log data to the end of file. If no file exists, one is created.

/CLOSE	Close the previously opened log file. The filename is not required.

/OPEN	Create a log file.

/OVERWRITE	Open a log file and overwrite any old copies. If no file exists, one is created.

/PROMPT	Displays the interactive log file prompt normally associated with the LOG function key. If logging is already enabled, LOG/PROMPT closes the log file and disables logging. If /PROMPT is used, any other option on the command line is ignored.

/SCREEN	Write the current screen contents to the previously opened log file. This option replaces cursor positioning escape sequences with spaces.

Example 1:	LOG TEST

Creates log file TEST.LOG. If TEST.LOG already exists, an error occurs.

Example 2:	LOG/CLOSE

Closes the log file.

Example 3:	LOG/OVER TEST

Opens TEST.LOG and overwrites any old copies.

Example 4:	INQUIRE TIME "Enter current date and time: "

OPEN/WRITE ERRORS ERRMESS.LOG

WRITE ERRORS TIME

CLOSE ERRORS

LOG/APPEND ERRMESS.LOG

WRITE HOST "BUILD"

WAIT "$"

LOG/CLOSE ERRMESS.LOG

Creates a log file with a date and time stamp which captures error messages generated from running a VMS COM file.

Example 5:	WRITE HOST "MAIL"

WRITE HOST "READ"

LOG/SCREEN MAIL

WRITE HOST "EXIT"

Captures a host mail message into MAIL.LOG.

See Also:	REPLAY


Commands; MARGIN
MARGIN

MARGIN (no arguments)

Displays horizontal split screen scrolling prompt and ruler.


Commands; MODEM
MODEM

MODEM (no arguments)

Displays the Modem Dialer dialog box.


Commands; ON ABORT
ON ABORT

ON ABORT THEN statement

Defines the action taken when the Abort command is issued during a command procedure. The action is taken only if the command processor is enabled for abort error checking. Abort error checking is enabled (SET ABORT) by default.

An ON ABORT action remains in effect until one of the following occurs:

1)	The command procedure exits, which resets to the ON ABORT condition previously specified.

2)	Another ON ABORT command is executed.

3)	The procedure executes the SET NOABORT command.

The default error condition is ON ABORT THEN STOP. If an ABORT action is specified, it overrides actions specified for previous levels, and sets the default action for any following sub levels to EXIT. The error codes and mnemonic identifier are stored in the global symbols $STATUS, $SEVERITY, and $STATUSID, even if error checking is disabled (SET NOABORT).

See Also:	SET ABORT


Commands; ON DEVICE_ERROR
ON DEVICE_ERROR

ON DEVICE_ERROR THEN statement

Defines the course of action when an error occurs from a peripheral device, such as a printer or a plotter. The action is taken only if device error checking is enabled (SET DEVICE_ERROR). By default, device error checking is disabled (SET NODEVICE_ERROR).

An ON DEVICE_ERROR action remains in effect until one of the following occurs:

1)	The command procedure exits, which restores the previous ON DEVICE_ERROR condition.

2)	Another ON DEVICE_ERROR command is executed.

3)	The procedure executes the SET NODEVICE_ERROR command.

The default error condition is ON DEVICE_ERROR THEN STOP. If a DEVICE_ERROR action is specified, it overrides the actions specified for previous levels and sets the default action for any following sub levels to EXIT. When errors occur, the error codes and mnemonic identifier are stored in the global symbols $STATUS, $SEVERITY, and $STATUSID, even if error checking is disabled (SET NODEVICE_ERROR).

See Also:	SET DEVICE_ERROR


Commands; ON DISCONNECT
ON DISCONNECT

ON DISCONNECT THEN statement

Defines the course of action when the communications connection is lost.

When using an RS232 Serial connection, the Carrier Detect signal is monitored to determine the state of the connection. However, if Modem Control is disabled, the state of the connection will not be monitored.

When running over a network, the state of the network virtual circuit is monitored.

The specified action is taken only if disconnect error checking is enabled (SET DISCONNECT). By default, disconnect error checking is disabled (SET NODISCONNECT).

An ON DISCONNECT action remains in effect until one of the following occurs:

1)	The command procedure exits, which restores the previous ON DISCONNECT condition.

2)	Another ON DISCONNECT command is executed.

3)	The procedure executes the SET NODISCONNECT command.

The default error condition is ON DISCONNECT THEN STOP. If a DISCONNECT action is specified, it overrides actions specified for previous levels, and sets the default action for any following sub levels to EXIT. When errors occur, the error codes and mnemonic identifier are stored in the global symbols $STATUS, $SEVERITY, and $STATUSID, even if error checking is disabled (SET NODISCONNECT).

See Also:	SET DISCONNECT


Commands; ON Error
ON ERROR_SEVERITY

ON error_severity THEN statement

Defines the course of action taken when an error occurs that is equal to or greater in severity than the specified error.

The default error condition is ON ERROR THEN EXIT. This condition tells the command process to CONTINUE when a WARNING error occurs, and execute an EXIT command when an ERROR or SEVERE_ERROR condition occurs. The action is taken only if error checking is enabled (SET ON). Error checking is enabled by default.

Severity keywords are listed in order of severity and summarize how the ON command controls error handling:

WARNING	Performed if a WARNING, ERROR, or SEVERE_ERROR occurs.

ERROR	Performed if an ERROR or SEVERE_ERROR occurs unless otherwise specified. Does not affect the handling of warning errors.

SEVERE_ERROR	Performed if a SEVERE_ERROR occurs unless otherwise specified. Does not affect the handling of warning and error conditions.

An ON command action is executed only once. After the ON command action is taken, the ON action is reset to the default (ON ERROR THEN EXIT).

An ON command action can be specified for each active command level. The ON command action applies only within the command procedure in which it is executed. Upon exiting a command procedure, the prior ON error conditions are reestablished to their previous settings. The error codes and mnemonic identifier are stored in the global symbols $STATUS, $SEVERITY, and $STATUSID, even if error checking is disabled (SET NOON).

Note:	If the command file contains a GOTO command to a non-existent label, an EXIT command is executed, regardless of the current ON ERROR assignment.

See Also:	SET ON


Commands; OPEN
OPEN

OPEN logical-name[:] file-specification

where logical-name is the name to be used by other commands to reference the open file and file-specification is the file to open and can include a full path name if desired. The default file extension is .DAT.

Opens a file for read, write, or append operations and assigns a logical name to the file. The OPEN command must precede a READ or WRITE command for file access. The file remains open until the CLOSE command is executed or an exit to Windows occurs. If the command procedure terminates before the file is closed, the file remains open.

The same file can be referenced by several open statements without first being closed. However, each open statement must use a different logical name.

Note:	The logical name HOST does not have to be opened before reading or writing.

Options:

/APPEND	Opens an existing file for write, starting at the end of the file. If the file does not exist, it is created.

If the /READ option is included with /APPEND, the file must already exist. If the file does not exist, an error occurs.

/ERROR=label	Continues the process at the label if an error occurs.

/READ	Opens an existing file for read only, and sets the file data pointer to the beginning of the file. /READ is the default for the OPEN command.

/WRITE	Creates a new file for write only. If the file already exists, it is overwritten when the first WRITE occurs.

If the /READ option is included with /WRITE, an existing file is opened for read and write, starting at the beginning of the file. When /READ is used with /WRITE, the file must already exist. If the file does not exist, an error occurs.

If the /APPEND option is used with /WRITE, the /WRITE option is ignored.

Example 1:	OPEN FILE2 DATA.TXT

Assigns DATA.TXT to the logical FILE2, and opens the file named DATA.TXT for reading. An error results if the file does not exist.

Example 2:	OPEN/WRITE FILE1 C:\320\TEST.DAT

Assigns TEST.DAT to the logical FILE1, and creates a file named TEST.DAT for writing.

Example 3:	TOP:	INQUIRE/STATUS FILE "Enter the data filename: "

OPEN/READ/APPEND/ERROR=ERR DATA 'FILE'

@PROCEDURE

CLOSE DATA

DISPLAY "''FILE' has been updated."

EXIT

ERR:

DISPLAY "''FILE' does not exist"

GOTO TOP

Checks for the filename entered by the user. If the file exists, PROCEDURE.ECF is run. If the file does not exist, an error message displays and the command file starts again at label TOP.

See Also:	CLOSE, READ, WRITE


Commands; PICTURE
PICTURE

PICTURE /CREATE filename

(VT340 graphics mode only.) Saves the current graphics image to a file. By default, Telnet creates the file with the extension .SDF. A path name can be specified as part of the filename.

Options:

/OVERWRITE	Overwrites the specified filename if the file already exists.

/BITMAP	Creates a Windows-compatible device independent bitmap (DIB) file. Images created with /BITMAP cannot be replayed at a later time. This option is available for users who wish to import the graphics into other Windows applications.

Example 1:	PICTURE /CREATE /BITMAP IMAGE.BMP

Creates a DIB image file named IMAGE.BMP.

Example 2:	PICTURE /CREATE /OVERWRITE IMAGE

Creates a graphics picture file named IMAGE.SDF.

Example 3:	PICTURE /DISPLAY filename

Displays a graphics image previously created with the /CREATE command. The emulator will only replay files with the .SDF extension.

Example 4:	PICTURE /DISPLAY IMAGE.SDF

Displays the picture file IMAGE.SDF.


Commands; REPLAY
REPLAY

REPLAY filename

where filename is the name of an emulator log file.

Replays an emulator LOG file. The filename can contain a full path specification and has a default extension of .LOG.

Options:

/PROMPT	Displays the interactive log file prompt normally associated with the REP (Replay) function key.

Example:	REPLAY SESSION.LOG

Plays the log file SESSION.LOG.

See Also:	LOG


Commands; PRINT EJECT
PRINT EJECT

PRINT EJECT (no arguments)

Ejects a page on the printer.


Commands; PRINT ON/OFF
PRINT ON/OFF

PRINT on/off

Toggles Auto Print mode. In Auto Print mode, every line sent to the screen is also sent to the printer.


Commands; PRINT SCREEN
PRINT SCREEN

PRINT SCREEN (no arguments)

Prints the contents of the screen.


Commands; PRINT/CONTROLLER
PRINT/CONTROLLER

PRINT/CONTROLLER state

where state is either ON or OFF.

Sets printer controller mode. In controller print mode, data passes through to the printer without displaying. Lines longer than 132 columns can be printed, and control characters passed, using the /CONTROLLER option.


Commands; QUIT
QUIT

QUIT [specific-error]

where specific-error can be an error code, a quoted mnemonic identifier, or a symbol (e.g., QUIT $STATUS).

Works exactly like the EXIT command except that QUIT drops the modem control signals. See EXIT for detailed description.

Options:

/EM	Quit Telnet with the corresponding $STATUS code passed to ERRORLEVEL.

See Also:	EXIT


Commands; READ
READ

READ logical-name[:] symbol-name

where logical-name is the logical name assigned by an OPEN command or the HOST logical.

Reads an ASCII record from the logical into the specified symbol. If the READ command references a DOS file, the file is read a record at a time. After each read, the file data pointer is positioned to the start of the next record. The maximum record size is 255 characters. Records are terminated by carriage returns. READ is not intended for use with binary files.

Options:

/END_OF_FILE=label	Control is transferred to the label when the end of the file is detected. If this option is not used, and the EOF character is encountered, the process continues at the /ERROR label specified. If neither option is specified, and the EOF character is encountered, the current ON condition is taken. Valid only with a DOS file logical.

/ERROR=label	If an error occurs, control is transferred to the label specified. If the /ERROR option is not used, the current ON condition action is taken.

/NODISPLAY	Does not display data as it is read. Valid only with the HOST logical.

/TIME_OUT=[hh:mm:]ss	Waits for data until the time specified. Valid only with the HOST logical. A timeout error occurs if no data is received from the host within the specified time period. The /TIME_OUT option can be specified simultaneously with the /ERROR option to redirect command execution.

See Also:	OPEN, WAIT, WRITE


Commands; RETURN
RETURN

RETURN (no arguments)

Used to return from a subroutine called by the GOSUB command. Valid only with the GOSUB command.

See Also:	GOSUB


Commands; SAVE
SAVE

SAVE [file_name]

where file_name is the name of a setup file.

Saves the current setup information to disk. If a filename is not included, the setup information is saved to the default setup file (.SET).

The filename can contain a complete path specification. If the filename does not contain a path, the default emulator directory path is used.

Examples:	SAVE

Saves the current setup configuration into the default setup file (.SET) in the Telnet default directory.

SAVE VAX

Saves the current setup configuration into VAX.SET in the Telnet default directory.

SAVE C:\320\UNIX

Saves the current setup into UNIX.SET in the \320 subdirectory.

SAVE \320\

Saves the current setup configuration into the default setup file .SET in subdirectory \320.


Commands; SCAN
SCAN

SCAN (no arguments)

Enters keyboard scan mode. In scan mode, pressing a key displays its key name. Scan mode is useful for identifying key names.


Commands; SCROLLBACK
SCROLLBACK

SCROLLBACK (no arguments)

Displays text that has scrolled off the Telnet screen. The amount of scrollback is specified in the Scrollback dialog box.


Commands; SEND
SEND

SEND filename

Sends an ASCII text file to the host.

Flow control to the host is provided through character delay (SET CDELAY), line delay (SET LDELAY) and use of the turnaround character (SET TURNAROUND).

Options:

/ANSWERBACK	Send the answerback message specified in the Setup - Terminal dialog box to the host. Since the answerback message can be concealed, store your password in the answerback message when automatically sending it to the host in a command file.

Note:	SEND/ANSWERBACK cannot be used with any other qualifiers.

/EOF	Sends an End of File marker at the end of the file. Ctrl Z is the default. The SET EOF command can be used to change the EOF character sent. To send an EOF character without sending data from the file, use SEND/EOF without specifying a filename.

/FILTER	Removes control characters.

Note:	Filter passes CR, LF, VT, HT, and ESC.

/LINEFEED	Normally Telnet does not send line feeds that are immediately preceded by a carriage return. If the /LINEFEED option is specified, all line feeds in the file are sent to the host.

See Also:	SET CDELAY, SET EOF, SET LDELAY, SET TURNAROUND, WRITE


Commands; SET ABORT
SET ABORT

SET [NO]ABORT (no arguments)

Enables or disables error checking of Execute - Abort during execution of a command procedure.

The SET NOABORT command disables abort error checking and resets the ON ABORT error condition to STOP. The error codes and mnemonic identifier are still updated in the global symbols $STATUS, $SEVERITY, and $STATUSID.

The SET ABORT and SET NOABORT commands apply to all command procedure levels. SET ABORT is the default. (Usable in command procedures only.)

Note:	The SET NOABORT command is not recommended, since it can prevent a command procedure from exiting normally. For example, if a command procedure began to loop uncontrollably, control could not be regained from Telnet to stop the command procedure.

Example:	SET NOABORT

LOG SYSMESS

DELAY 15:00:00

LOG/CLOSE

Disables abort key checking, opens PC file SYSMESS.LOG, captures any host data for 15 hours, and closes the file.

See Also:	ON ABORT


Commands; SET CDELAY
SET CDELAY

SET CDELAY ms

Sets a character delay for the SEND and WRITE command. Telnet delays the specified number of milliseconds after sending each character. Specify a character delay when it is necessary to slow down the data rate to prevent overrunning the host's terminal buffer. The default value is zero. Maximum value is 255 milliseconds.

See Also:	SEND, SET LDELAY, SET TURNAROUND, WRITE


Commands; SET DEVICE_ERROR
SET DEVICE_ERROR

SET [NO]DEVICE_ERROR (no arguments)

Enables or disables device error checking. A device error can occur from a peripheral device connected to the serial or parallel port, such as a printer or a plotter.

The SET NODEVICE_ERROR command disables error checking and resets the ON DEVICE_ERROR condition to STOP. The error codes and mnemonic identifier are still updated in the global symbols $STATUS, $SEVERITY, and $STATUSID.

The SET DEVICE_ERROR and SET NODEVICE_ERROR commands apply to all command procedure levels. SET NODEVICE_ERROR is the default. (Usable in command procedures only.)

See Also:	ON DEVICE_ERROR


Commands; SET DISCONNECT
SET DISCONNECT

SET [NO]DISCONNECT (no arguments)

Enables or disables error checking of the communications connection. Disconnect errors can occur when serial or network connections are lost.

The SET NODISCONNECT command disables error checking and resets the ON DISCONNECT error condition to STOP. The error codes and mnemonic identifier are still updated in the global symbols $STATUS, $SEVERITY, and $STATUSID.

The SET DISCONNECT and SET NODISCONNECT commands apply to all command procedure levels. SET NODISCONNECT is the default. (Usable in command procedures only.)

See Also:	ON DISCONNECT


Commands; SET EOF
SET EOF

SET EOF value

where value is the decimal value of the ASCII character. Ctrl Z (26) is the default.

Defines the End of File character sent by the /EOF option of the SEND command.

See Also:	SEND, SET CDELAY, SET LDELAY, SET TURNAROUND


Commands; SET HISTORY
SET HISTORY

SET HISTORY mode = number_of_lines

Where mode is /COMMAND_LINE or /LINE_EDIT.

Sets the number of input lines stored for command line or emulation mode line editing. Setting the number of lines to 0 disables the storing and editing of input lines for the type of editing specified.


Commands; SET HOST
SET HOST

SET HOST

Connects to a remote node. The SET HOST command must be used with one of the following:

/DEFAULT_PORT	Connects to the default port selected in the Auto Connect Port dialog box. If the port is set to None or if you are already connected to the default port, an error is returned.

/LAST_NODE	Connects to the last successfully connected port. If a previous connection did not exist, an error is returned.

/PORT=port node	Connects to the specified port, where

port is COM1, COM2, COM3, COM4, CTERM, LAT, WINSOCK, etc,...

node is the network node name.

/PASSWORD=password

Used only with the /PORT option, the /PASSWORD option allows the connect password to be specified.

Examples: 	SET HOST/PORT=COM3

Connects to COM1.

SET HOST/PORT=WINSOCK WILLY

Connects to the WINSOCK node WILLY.

SET HOST/PORT=LAT MARS /PASSWORD=OPEN_SESAME

Connects to the LAT node MARS with the password OPEN_SESAME.


Commands; SET LDELAY
SET LDELAY

SET LDELAY secs

Sets a line delay for the SEND and WRITE commands. Specifies the number of seconds Telnet should wait after sending a line before sending the next line. The default is zero. Maximum value is 255 seconds.

If a line delay and turnaround character is specified, Telnet waits until it receives the turnaround character or the delay expires, whichever occurs first. If SET NOTURNAROUND is specified, Telnet waits the full delay after each line.

See Also:	SEND, SET CDELAY, SET TURNAROUND, WRITE


Commands; SET MESSAGE
SET MESSAGE

SET [NO]MESSAGE [message_type]

where message_type is INFORMATIONAL, WARNING, ERROR, or SEVERE_ERROR.

Enables or disables the display of messages. The message_type determines the category of message affected. All messages below or equal to the message_type specified are affected. If no message_type options are provided, SET NOMESSAGE affects all messages.

Example:	SET NOMESSAGE = WARNING

Disables informational warning messages.


Commands; SET ON
SET ON

SET [NO]ON (no arguments)

Enables or disables error checking.

The SET NOON command disables error checking and error message display. However, the error codes and mnemonic identifier in the global symbols $STATUS, $SEVERITY, and $STATUSID are updated.

The SET ON and SET NOON commands apply only to the current command level. If the SET NOON is used in a command procedure that calls a second procedure, the default (SET ON) is used while executing the second command procedure. (Usable in command procedures only.)

See Also:	ON Error_Severity


Commands; SET PRINTER
SET PRINTER

SET PRINTER keyword

SET PRINTER port

where port is LPT1, LPT2, LPT3, COM1, COM2, COM3, COM4, or None.

keyword is one of the choices listed in the table below.

Sends the printer control strings defined in the Printer Control Strings dialog box.

Keyword	Description
12CPI	Sends the Enable 12 CPI string to the printer.
16CPI	Sends the Enable 16 CPI (condensed mode) string to the printer.
CONDENSED	Sends the Enable 16 CPI (condensed mode) string to the printer.
DOUBLE	Sends the Double Wide string to the printer.
DRAFT	Sends the Enable Draft Quality string to the printer.
FORM	Enables the form feed option for every print screen.
INITIALIZE	Sends the Initialize string to the printer.
LETTER	Sends the Enable Letter Quality string to the printer.
NO12CPI	Sends the Disable 12 CPI string to the printer.
NO16CPI	Sends the Disable 16 CPI (condensed mode) string to the printer.
NOCONDENSED	Sends the Disable 16 CPI (condensed mode) string to the printer.
NODOUBLE	Sends the Disable Double Wide string to the printer.
NODRAFT	Sends the Disable Draft Quality string to the printer.
NOFORM	Disables the form feed option for every print screen.
NOLETTER	Sends the Disable Letter Quality string to the printer.
NOUD1	Sends the Disable User-Defined #1 string to the printer.
RESET	Sends the Reset string to the printer.
UD1	Sends the Enable User-Defined #1 string to the printer.


Commands; SET TERMINAL
SET TERMINAL

SET TERMINAL characteristic

Sets the terminal characteristics.

Options:

/APPLICATION_KEYPAD	Specifies that the keypad keys send application control functions.

/DATA_BITS=bits	Sets the number of communication data bits. The default is 8 data bits with parity = none.

Where bits is 7 or 8.

/DEVICE=terminal	Selects the DEC terminal to emulate.

Where terminal is VT320_7, VT320_8, VT220_7, VT220_8, VT100, VT102, or VT52.

/[NO]ECHO	Controls display of input from the keyboard. If Echo is set, the data transmitted to the host is locally echoed to the computer screen. If NOECHO is set, the data is not echoed by Telnet. In NOECHO mode the host computer is expected to echo the data. NOECHO is the default. ECHO should be set on half-duplex systems.

/INSERT	Sets the line editing mode to insert. Space is made for new characters that are entered into a line.

/LIMITED_TRANSMIT	Restricts the transmit speed from between 150 and 180 characters per second. Limited transmit can be necessary for some half-duplex systems.

/LINES=rows	Sets the screen height to the desired number of rows.

Where rows is 24 - 50.

/LOCAL	Sets Telnet to local mode. In local mode, all characters entered from the keyboard are sent to the screen display processor. Data is not sent to the host and data received from the host is ignored.

/[NO]MODEM_CONTROL	Enables/disables carrier detect monitoring. Modem control should be disabled when using a direct connection.

/[NO]NEW_LINE	If enabled, generates a line feed whenever a carriage return is entered.

/NUMERIC_KEYPAD	Specifies that the keypad keys send numeric control functions.

/ONLINE	Allows Telnet to communicate with the host. (Disable communications with the /LOCAL option.)

/OVERSTRIKE	Sets the line editing mode to overstrike. New characters entered into the line replace the existing characters. /OVERSTRIKE is the system default.

/[NO]PARITY=type	Sets the communications parity. Setting /NOPARITY is the same as /PARITY=None. Parity = none and Data Bits = 8 is the recommended default.

Where type is Odd, Even, Space, Mark or None.

/PORT=com-port	Selects the communications port.

where com-port is COM1, COM2, COM3, COM4.

/[NO]PROTOCOL=none	Selects the communications flow control protocol. Selecting /NOPROTOCOL is the same as /PROTOCOL=NONE. Xon/Xoff is the protocol used by DEC and most other host systems.

/SPEED=baud_rate	Selects the communications speed.

Where baud_rate is 75, 110, 150, 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, 57600, or 115200.

/STOP_BITS=num	Sets the number of stop bits for each data word. One is the recommended setting.

Where num is 1 or 2.

/UNLIMITED_TRANSMIT	Does not limit the character transmit rate. This is the recommended setting. (The transmit rate can be restricted with the /LIMITED_TRANSMIT option.)

/[NO]WARNING_BELL	Enables/disables a warning bell for operating errors and receipt of a Ctrl G.

/WIDTH=columns	Sets the screen width to 80 or 132 columns. In 132 column mode the screen displays all 132 characters on a line, or horizontally scrolls through the characters depending on the selection in Setup - Display - 132 Column.

Where columns is 80 or 132.

/[NO]WRAP	Controls whether Telnet generates a carriage return and line feed at the end of a line. The end of the line is determined by the /WIDTH option. If NOWRAP is specified, the characters written at the last column position overwrite each other. /WRAP is the default.


Commands; SET TURNAROUND
SET TURNAROUND

SET [NO]TURNAROUND value

Where value is the decimal value of the ASCII character or a quoted character. Line Feed (10) is the default.

Sets the turnaround character for the SEND command. When a turnaround character is specified, Telnet waits for the turnaround character to be received from the host before sending the next line.

Turnaround characters perform flow synchronization and help prevent overrunning the host's terminal input buffer.

If a turnaround character is specified, the SEND operation could hang if a turnaround character is not received. Clicking on Execute - Abort terminates the operation. If a SET LDELAY is specified with the turnaround character, it is used as the maximum time Telnet waits before sending the next line. (Affects the SEND and WRITE command only.)

Example:	SET TURNAROUND = 10

or

SET TURNAROUND = "<LF>"

Sets the turnaround character to a line feed.

See Also:	SEND, SET CDELAY, SET LDELAY


Commands; SET VERIFY
SET VERIFY

SET [NO]VERIFY (no arguments)

When enabled, displays command lines of a command procedure as they execute. Also, enables the display of error messages regardless of whether error checking is disabled. The default is SET NOVERIFY.

Options:

/STATUS	Output command line display to the status line.


Commands; SHOW SYMBOL
SHOW SYMBOL

SHOW SYMBOL [symbol-name]

Displays the local and global values for the specified symbol. If no symbol name is given, all the symbols from the local and global symbol table display. Wildcarding is supported; an asterisk (*) can be used for variable length substitution and a question mark (?) for single letter substitution. The default is SHOW SYMBOL /LOCAL/GLOBAL.

Note: 	Although SHOW SYMBOL displays local and global values, the local value of a symbol overrides the global value when referenced in a command procedure.

Symbol values display on the screen regardless of the message location.

Options:

/GLOBAL	Displays the value(s) from the global symbol table.

/LOCAL	Displays the value(s) from the local symbol table.

Examples:	SHOW SYMBOL *A

Displays all the symbols that end with "A".

SHOW SYMBOL/LOCAL VARI??

Displays all the six letter local symbols that start with "VARI".

See Also:	DELETE SYMBOL


Commands; STOP
STOP

STOP (no arguments)

Terminates the execution of all command files.

See Also:	EXIT


Commands; WAIT
WAIT

WAIT [match-string-expression]

Where match-string-expression is a quoted string, lexical, symbol, or combination of the above joined by plus symbols (+) (i.e., "string" + symbol).

Waits for the match string expression to be received from the host. The string must match the host data exactly, but is not case sensitive unless the /CASE option is specified. WAIT is intended for command file use.

If the WAIT command is issued from the host, it does not prevent Telnet from accepting additional host commands while it is waiting for the string.

Options:

/CASE	Requires the comparison to be case sensitive.

/ERROR=label	Process continues at the label if an error occurs.

/NODISPLAY	Inhibits the display of data from the host.

/NOMESSAGE	Inhibits the display of the WAIT informational message.

/NOSTRING_DISPLAY [match-string-expression]

Inhibits the display of the match string.

/TIME_OUT=[hh:mm:]ss	Sets a time period to wait for the host string match. If the string is not received in the allotted time, the process continues with the next command line. Specifying a /TIME_OUT qualifier without a string will flush data received from the host until no data is received for the time specified. The /TIME_OUT option can be used with the /ERROR option.

See Also:	READ, WRITE


Commands; WP
WP

WP ON/OFF

Enables or disables WordPerfect version 4.2 mode. In WP 4.2 mode, Telnet's keyboard assignments are altered to emulate the PC version of WordPerfect. Keyboard remapping is enabled in WP mode.


Commands; WP5
WP5

WP5 ON/OFF

Enables or disables WordPerfect 5.x mode. WP OFF also disables WP 5.x mode.


Commands; WRITE
WRITE

WRITE logical-name[:] [string-expression]

Where logical-name is a DOS file logical assigned by the OPEN command, or the HOST logical. HOST is a special predefined symbol that points to the COM port selected for communications.

string-expression is a quoted string, lexical, symbol, or combination of the above joined by plus signs (+) (i.e. "string" + symbol).

Writes the string-expression to the logical-name, followed by a carriage return. The maximum record size that can be sent to a logical name is 255 characters. If information is written to a file, the file pointer is positioned after the data written.

Flow control is provided through character delay (SET CDELAY) and line delay (SET LDELAY).

Options:

/ERROR=label	Process continues at the label if an error occurs.

/NOCR	No carriage return is sent after the string. Valid only with the logical HOST. (Generally used to slow communications to the host. A following carriage return is sent separately.)

/UPDATE	Specifies that the data previously READ is to be overwritten. It is valid only when rewriting the previous record read. The new data string must be the same length as the previous string or an error results. Valid only with a DOS file logical that has been opened with the /READ and /WRITE options.

Examples:	WRITE HOST

Sends a carriage return to the host. (Also the same as WRITE HOST "")

WRITE HOST "SET X:==""ABC"""

Sends SET X:=="ABC" to the host.

P1 = XRAY.DAT

WRITE HOST " TYPE ''P1'"

Sends TYPE XRAY.DAT to the host.

READ FILE2 DATA

WRITE/UPDATE FILE2 TEXT

Reads the first record from the logical name FILE2 into the symbol DATA. Then replaces the data just read with the information in symbol TEXT. The data read, and the data in TEXT must be the same length. The DOS file must have been opened using /READ and /WRITE.

See Also:	OPEN, READ, WAIT


DLG
Dialog Boxes


Maximum Workspace dialog box

Function:	Provides information on operating Telnet in Maximum Workspace mode.

Access:	Click the Maximize Workspace icon in the fixed toolbar or pull down the Control menu (the - menu in the upper left corner of the application window) and select Maximize Workspace.

Click fields and buttons of dialog box to display help.


First Setup dialog box
First Time Setup Dialog Box

Function:	Lets you select your keyboard configuration.

Access:	Appears automatically the first time SolarNet Telnet for Windows is started.

Click fields and buttons of dialog box to display help.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Displays Help for the First Time Setup dialog box. Click a field to display a description of the field.


Bitmap Selection Dialog Box

Function:	Lets you select specify the bitmaps available for use in Telnet toolbars.

Access:	Pull down the Setup menu and choose Toolbar. Click the Add button in the Bitmap region of the Toolbar Settings dialog box.

Click fields and buttons of dialog box to display help.


File Name

Select or enter the name of the bitmap file.


Preview

Displays the selected bitmap.


Selects the bitmap and returns to the Toolbar Settings dialog box.


Exits the dialog box without saving any changes.


Displays Help for the Bitmap Selection dialog box. Click a field to display a description of the field.


Print to File Selection Dialog Box

Function:	Lets you name the file to which you want output information printed.

Access:	Choose the Print to File check box on the Print Setup dialog box.

Click fields and buttons of dialog box to display help.


File Name

Select or enter the name of the file.


Prints to the named file.


Exits the dialog box without saving any changes.


Displays Help for the Print File Selection Setup dialog box. Click a field to display a description of the field.


DDE Command Builder Dialog Box

Function:	Lets you select and execute DDE (Dynamic Data Exchange) commands.

Access:	Pull down the Execute menu and choose DDE Command Builder.

Click fields and buttons of dialog box to display help.

See Also:	Using DDE

Advise Data Links

DDE Commands

Server Topics


Client Commands

Select the desired DDE command by choosing the appropriate button located next to the command. As different commands are selected, some of the parameters may become enabled or disabled. This indicates the required parameters for the selected command.


Parameters

Once the desired DDE commands are selected, enter the data for the required parameters. Alternatively, use the drop-down list to select a previously entered command.


The DDE command string is created with the entered parameters, copied to the DDE command line, and executed.


Closes the dialog box.


Allows the DDE command string to be edited before executing. The string is created with the desired parameters, then copied to the DDE command line. The string can then be edited.


Displays Help for the DDE Command Builder dialog box. Click a field to display helpful information.


Using DDE

Data exchanges not requiring ongoing interaction from the operator can be fully automated with DDE. SolarNet Telnet for Windows establishes a link to another application in order to exchange data - after which SolarNet Telnet for Windows and the other application can exchange data without operator involvement.

DDE is used in commands to:

  Start another application.

  Send data to another application.

  Get data from another application.

  Carry out commands in another application.

You can also implement a broad range of local and host application features including:

  Establishing a link to real-time host data, then transferring the information locally to your PC immediately upon change.

  Performing data queries between applications, such as a spreadsheet querying the host for current numbers from its database.

  Creating a compound document, i.e., a Word file with a graphics chart produced by a graphics program, in which the information for the graphics program comes directly from the host. Using DDE, the chart will be updated upon change of the host data, without changing the rest of the document.

When exiting a copy of SolarNet Telnet for Windows any associated links and any client or server DDE conversations are closed.

See Also:	DDE Concepts

Service Names, Topic Names, and Item Names


DDE Concepts

The client initiates a conversation with a server, or sends commands to the server to execute. Both the client and the server can terminate the conversation.

When two applications exchange DDE messages, they are engaged in a conversation. The messages that are passed back and forth are transactions.

SolarNet Telnet for Windows can engage in several conversations at the same time, acting as the client in some and as the server in others. Conversations can be between the same application, different applications, or even other emulator instances.

DDE transactions can be one-time data transfers, continuous "links" in which applications update each other as data changes, or commands executed by the receiving program. Not all servers allow execution of commands. Consult your DDE program's documentation.


Service Names, Topic Names, and Item Names

Before initiating a conversation, both applications must agree upon the service, topic, and item names. The DDE syntax of the client application determines how the server recognizes these names.

Service	Conversations are identified by a service name and topic. The default name can be overridden by means of the Dynamic Data Exchange (DDE) dialog box or the command SET DDESERVERNAME. This can be used when running multiple copies of SolarNet Telnet for Windows simultaneously, and client applications need to distinguish between them in order to talk to the window running on the desired host with the appropriate settings.

Topic	Data is classified into a topic in order to exchange multiple data items. A topic is usually a file name for applications operating on file-based documents. Other applications use application-specific names. Topic and data items are used when a client application begins a conversation with SolarNet Telnet for Windows as the DDE server.

Item	All requests must reference an item name which matches a client request to the proper server response. The data item values can be passed from the server to the client and vice versa.


DDE Commands

DDE commands appear in uppercase letters (for example, DDE CONNECT). The standard syntax is:

DDE CONNECT "service name" "topic name" variable

DDE commands fall into one of three transaction types: connection, disconnection, or data transfer. The commands can be used in command files to communicate with a DDE server application. All commands provide client support.

Command	Function
DDE CONNECT	Initiates a conversation between the client and the server.
DDE DISCONNECT	Disconnects the specified conversation.
DDE DISCONNECTALL	Disconnects all conversations.
DDE EXECUTE	Sends commands to the server to be executed.
DDE POKE	Sends a data value item to the server.
DDE REQUEST	Requests the value of a data item from the server.
DDE ADVISE	Creates an Advise Data Link between SolarNet Telnet for Windows (the client) and the server application.
DDE UNADVISE	Removes an existing Advise Data Link for the specified item.
DDE TOPICS	Builds a list of DDE server applications and topics that are currently running.

DDE Server Operation

Command	Function
SET [NO]DDEAUTOINITIALIZE	Sets the DDE autoinitialize feature to on or off.
SET [NO]DDEAPPENDINSTANCE	Sets the DDE append instance feature to on or off.
SET DDECLIENTTIMEOUT	Sets the timeout value, in seconds, for the DDE client commands.
SET DDESERVERNAME	Sets the name that SolarNet Telnet for Windows responds to as a DDE server.


DDE Advise Data Links
Advise Data Links

An advise data link is an extension of DDE REQUEST. It automatically updates the client's data item whenever the data item of the server changes. This automatic updating continues until the data link or the DDE conversation is terminated. The number of links is currently limited to 20 for all conversations.


DDE Server Topic
Server Topics

DDE clients can address SolarNet Telnet for Windows as a server during a conversation. Topics and data items are used when a client application starts a DDE conversation, the way these are compiled into actual DDE commands is determined by the DDE syntax of the client's application.

SolarNet Telnet for Windows supports the following topics:

System

ECL

Settings


System Topic

Permits a DDE client to ask a server, such as SolarNet Telnet for Windows, which topic names, item names, and data formats it supports. It also provides general information about the application's DDE support and accesses SolarNet Telnet for Windows's DDE server status.

System topic items are accessed with DDE data requests. Each request returns a specific type data.

To find out which servers are present and the kinds of information they can provide, a client can request a conversation on the System topic with the service name set to NULL ("").


ECL Topic

The ECL (Emulator Command Language) topic allows access to SolarNet Telnet for Windows's command language when it is acting as a DDE server. This allows development of sophisticated systems of execution control and dynamic data exchange between other applications and SolarNet Telnet for Windows (and hence host computers and networks).


Settings Topic

The Settings topic provides query access to a limited number of settings within SolarNet Telnet for Windows. Valid data item names in this topic include SolarNet Telnet for Windows command language SET parameters. Requesting the value of a Settings parameter returns a text string containing the current value of that setting. The Settings topic supports DDE REQUEST only (DDE ADVISE or DDE POKE are not supported).

The data items currently supported include:

SERVERNAME

TERMINAL /WIDTH

TERMINAL /LINES

Example:	DDE CONNECT "VT$DDE"

"SETTINGS" CONV

DDE REQUEST 'CONV' "TERMINAL /LINES"

RESULT DDE DISCONNECT CONV

The variable RESULT would contain the current number of display lines for the server instance of SolarNet Telnet for Windows.


Modem Dialer Dialog Box

Function:	Lets you open a modem connection to a host computer. You can dial your modem by selecting a Phone Book entry or by entering a telephone number manually.

Access:	Pull down the Connect menu and choose Dial or choose the Modem icon on the Telnet toolbar.

Click fields and buttons of dialog box to display help.

See Also:	Select Phone Book Entry

Phone Book


Alternate Dial

Enters a modem phone number directly into the Modem Dialer.


Phone Book Entry

Shows the entry number, name, phone number, command file and settings file of the currently selected Phone Book entry.

These fields cannot be edited. To edit Phone Book entries, you must click the Edit Phone Book button and update the Phone Book dialog box.


Status

Displays dialing, modem connection, and error messages.


Abort Button

Cancels a call in progress. Abort cannot be used after the "Connection successful" message is displayed in the Status box.


Answer Button

Readies Telnet to answer an incoming call.


Dial Button

Dials the currently displayed Phone Book entry.


<<Dial Button

Dials the Alternate Dial number.


Edit Phone Book Button

Displays the Phone Book dialog box, where you can add, edit, or delete Phone Book entries.


Hang Up Button

Hangs up a modem connection.


Select Phone Entry Button

Opens the Phone Book Entry Selection dialog box, which lets you select the phone number you want the Modem Dialer to use.


Name

(Optional) The number's reference name. The name must start with an alphabetical character but can include any non-control character. The maximum length is 15 characters.


Number

The number to dial. The phone number can include dashes or spaces for readability, or any valid Hayes AT command. The maximum length is 35 characters.

You can include softkey references in a phone number. For example, you can use a softkey reference to include your phone card number in the dialing sequence.

Enter a P as the first digit of the number for pulse dialing. Otherwise, tone dialing is used.


Command File

A command file specification can be entered to execute automatically after a successful connect. Command file names can be eight characters long. Do not enter the .ECF extension.


Settings File

(Optional) Specifies the settings file to load before the phone number is dialed.


Closes the dialog box.


Displays Help for the Modem Dialer dialog box. Click a field to display a description of the field.


Select Phone Entry dialog box
Phone Book Entry Selection Dialog Box

Function:	Select a previously saved Phone Book entry for display in the Modem Dialer.

Access:	Pull down the Connect menu and choose Dial. When the Modem Dialer dialog box opens, click the Select Phone Entry button.

Click fields and buttons of dialog box to display help.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Phone Book Entry Selection dialog box. Click a field to display a description of the field.


Phone Book Dialog Box

Function:	Stores phone numbers for the Modem Dialer.

Access:	Pull down the Connect menu and choose Dial. When the Modem Dialer dialog box opens, click the Edit Phone Book button.

Click fields and buttons of dialog box to display help.


Current Entry

Clicking on an <unspecified> entry in the list selects the current entry.


Name

An optional name can be entered as part of the entry. Enter a name as a reference for the entry.

The name must start with an alphabetical character but can include any non-control character. The maximum length for the name is 15 characters.


Number

Enter the phone number to dial. The phone number can include spaces or dashes for readability. A comma can be entered to specify a delay. The maximum length for a phone number is 35 characters.


Softkey

References to softkeys can be included in the phone number string to insert a phone card number, access code or credit card information into a dialing sequence.

Softkeys are referenced in a number with the following syntax:

<S:n>

where n is the number of the Softkey string.

Example:	Current Softkey: 1  *70

Softkey #1 is defined in the Softkeys dialog box to disable call waiting.

Number:   <S:1>1709-444-9999

When the entry containing this number is dialed, Softkey 1 is expanded and the command to disable call waiting is sent to the telephone system before dialing the number.

If pulse dialing is desired, enter a P as the first digit of the phone number. Otherwise tone dialing is used.


Command File

An optional command file specification can be entered as part of the entry. If a command file is entered, it will be executed automatically.

Command file names can be up to eight characters long. Do not enter a file name extension: the default .ECF extension is assumed.


Settings File

An optional settings file specification can also be entered as part of the entry. If a settings file is entered, it will be loaded before dialing the number.


Accept Changes Button

Accepts the changes.


Discard Changes Button

Returns the original entry information.


Delete Button

To delete a Phone Book entry, choose the entry and click the Delete button.


Clear All Phone Book Entries Button

To clear the entire Phone Book click the Clear All Phone Book Entries button. A dialog box presents the following notice:

Are you sure you want to erase all your Phone Book entries?

Click the Yes button to confirm the clear operation or click the No button to cancel it.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Phone Book dialog box. Click a field to display a description of the field.


Command File Selection Dialog Box

Function:	Lets you select and execute a command file.

Access:	Pull down the File menu and choose Command.

Click fields and buttons of dialog box to display help.


File Name

Selects the command file to execute.


File Information

Displays information specific to the selected file(s).


Displays Windows' Connect Network Drive dialog box. This allows the user to connect to a shared directory when running Windows for Workgroups.


Executes the selected command file.


Exits the dialog box without saving any changes.


Opens the selected file for editing in Windows Notepad.


Displays Help for the Command File Selection Setup dialog box. Click a field to display helpful information.


Record Log File Dialog Box

Function:	Lets you record all data sent to Telnet from the host into a file on the PC.

Access:	Pull down the File menu and choose Record Log File.

Click fields and buttons of dialog box to display help.

See Also:	Log File Recording Tips

Log File Replay Setup Dialog Box.


Append

Selects append mode. If selected, the data recorded is appended to the end of the existing log file.


Log Filename

Specifies the name of the log file where the data is recorded.


Overwrite Protection

When enabled, prompts for overwrite confirmation if the specified log file already exists.


Text Only

Records only the text and ignores the control characters.


Opens the log file and enables recording. LOG appears on the status line.


Exits the dialog box without saving any changes.


Displays Help for the Record Log File dialog box. Click a field to display a description of the field.


Log File Replay Dialog Box

Function:	Lets you replay a previously recorded log file.

Access:	Pull down the File menu and choose Replay Log File.

Click fields and buttons of dialog box to display help.

See Also:	Record Log File Dialog Box


File Name

Select or enter the name of the log file to replay.


Replays the log file.


Exits the dialog box without saving any changes.


Displays Help for the Log File Replay dialog box. Click a field to display a description of the field.


Settings File Selection Dialog Box

Function:	Lets you create or select the settings file you want Telnet to use during a session.

Access:	Pull down the File menu and choose Settings.

Click fields and buttons of dialog box to display help.


File Name

Select or enter the name of the settings file to load or save. A settings file must have a .CNF extension to be recognized by SolarNet Telnet for Windows.


Loads the specified settings file's menu selections.


Exits the dialog box without saving any changes.


Saves the settings for the settings file named in the File Name field.


Displays Help for the Settings File Selection dialog box. Click a field to display a description of the field.


Help File Selection Dialog Box

Function:	Lets you select a help file.

Click fields and buttons of dialog box to display help.


File Name

Selects the help file.


Selects the named help file to be executed when the mouse or key action is taken.


Exits the dialog box without saving any changes.


Displays Help for the Help File Selection Setup dialog box. Click a field to display a description of the field.


Exiting
Exit

Exits SolarNet Telnet for Windows, closes the application window, and disconnects all sessions.


Print Dialog Box

Function:	Specifies what information should be sent to the default printer.

Access:	Click the Print icon on the Telnet toolbar or pull down the File menu and choose Print.

Click fields and buttons of dialog box to display help.


Device

The default printer selected in the Windows Print Manager.


Range to Print

Screen	Prints only the text on the screen.
Scrollback	Print the text in scrollback.
Selected	If this box is checked, selects the entire screen. Choose Save Now from the Setup menu to save this option as enabled.


Exits the dialog box and begins printing.


Exits the dialog box without saving any changes.


Displays Help for the Print dialog box. Click a field to display a description of the field.


Printer Setup dialog box
Print Setup Dialog Box

Function:	Selects various options for the printer.

Access:	Pull down the File menu and choose Print Setup.

Click fields and buttons of dialog box to display help.


Printer

Displays the list of printers installed in the Windows Printers Control Panel.


Automatic Condensed Print

Enables automatic print compression when printing in 132-column mode. SolarNet Telnet for Windows sends the Set 16 CPI (characters per inch) string prior to all print operations. At the end of the print operation, the Reset 16 CPI String is sent to the printer.


Print to File

When this box is initially enabled, the Print to File Selection dialog box appears. Select or enter the name of the file. The default extension of .PRN is used. When the OK button is clicked, the file name is displayed next to the Print to File option.


Automatic Close on Print Screen

If checked, the printer is closed after each print screen. If this option is unchecked, the printer closes after the time specified by Idle Time before Close option.


Form Feed on Close

If enabled, the printer is sent a form feed after every print screen.


Print Mode

Normal	Prints the entire contents of the screen.

Auto	Sends each line of text displayed on the screen to the printer.

Controller	Passes all host information directly to the printer without displaying it on the screen.


Enable Passthrough

Sends native printer control sequences to the printer. The printer uses its internal fonts. This mode of printing is faster than normal Windows printing.


Idle Time Before Close

The idle timer monitors the printer activity. When printing is inactive for the specified length of time, SolarNet Telnet for Windows closes the print job and ejects the page.

If the timer is set to manual, the Close button (that appears on the status line), must be used to close the print job.


Printer Control Strings

Click the Control Strings button to display the Printer Control Strings dialog box.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays the Windows Print Setup dialog box.


Displays Help for the Print Setup dialog box. Click a field to display a description of the field.


Printer Control Strings Dialog Box

Function:	Specifies the character strings used to control printer functions. Most printer control strings have an enable and disable string that selects a printer feature and a disable string that deselects a printer feature.

Access:	Pull down the File menu and select Print Setup. Click the Printer Control Strings button on the Print Setup dialog box.

Click fields and buttons of dialog box to display help.


12 Pitch String

Set	Selects 12 characters per inch. The 12 CPI string is sent by the SET PRINTER 12CPI command.

Reset	Resets 12 characters per inch. It is sent by the SET PRINTER NO12CPI command.


16 Pitch String

Set	Selects 16, 16.5, or 17 characters per inch (condensed mode). The 16 CPI string is sent by the SET PRINTER 16CPI or SET PRINTER CONDENSED command.

Reset	Resets 16 CPI mode. It is sent by the SET PRINTER NO16CPI or SET PRINTER NOCONDENSED command.


Double Wide String

Set	Enables double wide character print mode. The Double Wide String is sent by the SET PRINTER DOUBLE command.

Reset	Disables double wide character print mode. It is sent by the SET PRINTER NODOUBLE command.


Draft Quality String

Set	Enables draft quality print mode. The Draft Quality String is sent by the SET PRINTER DRAFT command.

Reset	Resets draft quality mode. It is sent by the SET PRINTER NODRAFT command.


Initialization String

The initialization string can be used to select a printer connected to a printer sharing device and select a printer feature, such as condensed print, prior to sending the printer data.

The initialize string is sent to the printer, at the beginning of printer output, when a print job is initiated.


Letter Quality String

Set	Enables letter quality print mode. The Letter Quality String is sent by the SET PRINTER LETTER command.

Reset	Resets letter quality mode. It is sent by the SET PRINTER NOLETTER command.


Reset String

The Reset String can be used to deselect a printer attached to a printer sharing device and reset a printer feature that was enabled by the initialize string.

The Reset String is sent to the printer when a print job is terminated.


User-Defined String

Set	The string sent when the SET PRINTER UD1 command is issued. The User-Defined String selects a printer feature not covered by one of the other printer control strings.

Reset	Resets the feature selected by the enable string. It is sent by the SET PRINTER NOUD1 command.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Printer Control Strings dialog box. Click a field to display a description of the field.


Video Attributes and ANSI Color Mapping dialog box
Video Attribute and ANSI Color Mapping

Function:	Selects the color options for SolarNet Telnet for Windows.

Access:	Pull down the Setup menu and choose Color Mapping.

Click fields and buttons of dialog box to display help.


Color Palette Control

The color palette shows the possible colors for text foreground and background.


Color Support

SolarNet Telnet for Windows can display the screen in the normal black text on a white background or you can map colors to different text attributes.

If Color Support is selected, SolarNet Telnet for Windows displays separate colors for background, text, and video attribute combinations.

Color Support should be disabled (default) on PCs with monochrome monitors that emulate a color graphics monitor.


Selecting Colors

Foreground and background colors can be selected for attributes such as normal, bold, reverse and underlined.

To select the colors, position the cursor to the foreground or background column of the video attribute to be set. Click the up or down arrow until the number matches the desired color in the Color Palette Control.


Attribute Control

In addition to assigning colors to video attributes, attributes can be enabled to display as follows:

Bold	Bolds the characters by increasing font width.
Underline	Draws a line under the characters.
Blink	Blinks the characters.

Attribute Control options affect both color and monochrome systems.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Video Attribute and ANSI Color Mapping dialog box. Click a field to display a description of the field.


Command Files Dialog Box

Function:	Determines the command file to be executed when SolarNet Telnet for Windows loads.

Access:	Pull down the Setup menu and choose Command Files.

Click fields and buttons of dialog box to display help.


Default Command File

The name of the command file to be executed automatically when SolarNet Telnet for Windows loads.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Command Files dialog box. Click a field to display a description of the field.


DDE dialog box
Dynamic Data Exchange (DDE) Dialog Box

Function:	Lets you specify default settings for Telnet DDE transactions.

Access:	Pull down the Setup menu and choose DDE.

Click fields and buttons of dialog box to display help.


Append Instance

When enabled, appends an instance number to the end of the server name. The instance executed first is assigned number one.


Server Enable

Allows SolarNet Telnet for Windows to act as a DDE server.


Server Name

The name that SolarNet Telnet for Windows responds to as a server.


Timeout

The time that SolarNet Telnet for Windows waits, after sending a message to the client, to receive an acknowledgment.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the DDE dialog box. Click a field to display a description of the field.


Search Directories Dialog Box

Function:	Specifies the directories you want to use for holding Telnet command files and for storing files transferred from other computers.

Access:	Pull down the Setup menu and choose Directories.

Click fields and buttons of dialog box to display help.


Command Files

Enter the directory paths containing command files that you wish to read from multiple locations. Separate each path name with a semicolon.


File Transfer Directory

Enter a single directory path to be used as the default PC File Name directory in the File Transfer Setup.

Note:	If either option is empty the default path is defined by the Working Directory entry in SolarNet Telnet for Windows's Properties dialog box. To access the Properties dialog box from the Program Manager, click the SolarNet Telnet for Windows icon, pull down the File menu, and choose Properties.


Current Settings File

The path and file name of your current settings file.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Search Directories dialog box. Click a field to display a description of the field.


Display Setup Dialog Box

Function:	Selects options that affect the way the features appear or act on the screen.

Access:	Pull down the Setup menu and choose Display.

Click fields and buttons of dialog box to display help.


Auto Wrap

Enables or disables Auto Wrap. If disabled, the characters written to the last column of the screen overwrite each other. If enabled, the next received character after a full line wraps to the beginning of the next line.


Character Set

Selects the DEC supplemental character set. DEC Multinational is normally selected.


Columns

Sets the display width to 80 or 132 columns.


Cursor

Selects visible or invisible cursor.


Cursor Type

Selects a block or underline cursor.


Display Lines

Selects the number of lines that are displayed on the Telnet screen.


Jump Scrolling

Determines the number of lines scrolled when updating the screen.


PC Fonts

Selects the PC character set, which includes line drawing characters.


Reverse Screen

Disables or enables reverse video screen display on monochrome systems.


Scrolling

Determines if the screen scrolling is fast or slow.

Fast	Fast corresponds to the VT320 Jump Scroll mode.

Slow	Slow scroll is substituted for the VT320 smooth scroll. In Slow Scroll mode, SolarNet Telnet for Windows delays after each line feed to slow the display scroll speed. The length of the delay is determined by the Slow Scroll Delay option.


Slow Scroll Delay

The amount of time, in milliseconds, SolarNet Telnet for Windows delays before scrolling a new line of text onto the display. This parameter is ignored unless Slow Scroll mode is set. A maximum value of 999 milliseconds (approximately 1 second) is allowed.


Full Screen 132 Column Mode

This option can only be enabled when using the VGA (640 x 480) or EGA (640 x 350) Windows driver.

If enabled, SolarNet Telnet for Windows uses a special font that intermixes characters 4 and 5 dots wide to produce the highest resolution 132-column display possible on an EGA or VGA monitor. This font always produces a full-width emulation window. If disabled, all characters are written using a 4-dot wide font. This font doesn't produce a full-width emulation window and offers better performance than the full screen font. However, it is not as readable.


Host Writable Status Line

Enabling the status line adds one line to the emulation window and allows the host program to write on the line.


Show Cursor Row/Column

Displays the cursor's current row and column position on the status line.


Tabs

Click the Tabs button to display the Tab Settings dialog box.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Display Setup dialog box. Click a field to display a description of the field.


Tab Settings Dialog Box

Function:	Specifies the placement of the tab settings for the Telnet window.

Access:	Click the Tabs button on the Display Setup dialog box.

Click fields and buttons of dialog box to display help.


Set Every Button

Sets tabs every n spaces, where n is a number, in the range 1--20, you select in the spin box.

You can add individual tab settings by clicking the appropriate location on the tab ruler.


Clear All Button

Clears all tab settings. You can clear individual tab settings by clicking a tab marker arrow on the ruler.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Tab Settings dialog box. Click a field to display a description of the field.


File Transfer Setup Dialog Box

Function:	Specifies file transfer settings for the selected protocol. The display of the protocol-specific fields depends on the protocol you select in the Protocol list. Choose a protocol in the figure below to display its specific setup.

Access:	Pull down the Setup menu and choose File Transfer.

Click fields and buttons of dialog box to display help. To display help for a different file transfer protocol, click an entry in the Protocol list and click the Help button.


ASCII File Transfer Setup Dialog Box

Function:	Sets the parameters used for ASCII file transfer.

Access:	Pull down the Setup menu and choose File Transfer. Choose ASCII in the Protocol list.

Click fields and buttons of dialog box to display help.


Protocol

Lists the protocols available for file transfer.


Overwrite Protection

This setting determines what action will be taken if the file being received already exists. The available options are as follows:

None	The file is overwritten without any notification.
Prompt	You are prompted to select the action to take.
Rename	The new file is renamed by appending a number to the name.
Cancel	The file is not transferred and the file transfer will be terminated.


Partial Files

A partial (incomplete) file can result when a transfer is aborted due to an error or operator intervention. Selecting Keep will cause the incomplete file to be stored on your disk. Selecting Discard will throw away partial files, leaving no trace of the file on your disk. Discard is the recommended setting.


Command Mode

When Auto Command Mode is enabled, the file transfer program sends the commands stored in Auto Command Mode Setup to the host to start the host transfer program automatically.


Set Defaults Button

Sets the file transfer settings for the selected protocol to their default values .


Selected Host

Selects the operating system of the remote host, which determines the Auto Command Mode commands and file transfer options appropriate for the host computer. You can choose the Set Defaults button to enter default settings after you select the appropriate operating system.


Command Delay

Some operating systems, such as RSX-11M, cannot accept file transfer commands at the speed SolarNet Telnet for Windows sends them. Entering a Command Delay (in milliseconds) slows down the rate that command lines are sent. A delay of 1000 delays SolarNet Telnet for Windows 1000 milliseconds (one second) after issuing each command. A maximum delay of 9999 milliseconds (9.999 seconds) can be entered.


End of File String

Telnet uses the EOF (End of File) string to signal that a file transmission is complete. Reception of the EOF string causes the host utility program to save the file and exit. The default selection depends on the host.


Host Cancel Character

If a file receive is cancelled, the Host Cancel character is sent to the host to terminate the transfer.


Host Prompt String

During an incoming file transfer, Telnet watches for the Host Prompt string. If it detects the Host Prompt string, Telnet terminates the incoming file transfer. This string is used to gracefully end ASCII transfers without putting the host prompt into the file's data. The default string depends on the host system.


Echo Check

SolarNet Telnet for Windows waits for the echo from each character transmitted before sending a new character. Selecting this option slows the transfer down significantly. Use this option only as a last resort.


End of Line Delay

Specifies the number of milliseconds to delay after each carriage return. Enter 0 to 999 milliseconds. The default selection depends on the host, but is normally set to zero.


Outgoing Character Delay

Some hosts, especially half-duplex systems, cannot accept characters at the full baud rate. To bypass this problem, use a Character Delay. Enter 1 to 99 milliseconds of delay for each transmitted character.


Pad Null Lines

If enabled, SolarNet Telnet for Windows pads empty lines of text by inserting a single space before the carriage return.


Strip Line Feed

Setting this option strips all line feeds that follow carriage returns. Enable this option for most systems.


Turnaround Character

Telnet waits for a turnaround character to be echoed after sending a carriage return. Waiting for a turnaround character ensures each line transmitted is received by the host without having to specify a character or end of line delay.

The normal turnaround character is a Line Feed. To disable this option, delete all characters in the string.


Send and Receive Command Strings... Button

Displays the ASCII Send and Receive Command Strings dialog box.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the ASCII Setup dialog box. Click a field to display a description of the field.


Send and Receive Command Strings Dialog Box

Click fields and buttons of dialog box to display help.


Show Receive Cmds Button

Displays the receive commands. The receive commands start a utility on the host that transmits a file to the terminal port.


Show Send Cmds Button

Displays the send commands. The transmit commands start a utility on the host that creates a file and receives data from the terminal port.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the ASCII Send and Receive Command Strings dialog box. Click a field to display a description of the field.


Kermit File Transfer Setup Dialog Box

Function:	Sets the parameters for Kermit file transfers.

Access:	Pull down the Setup menu and choose File Transfer. Choose Kermit in the Protocol list box.

Click fields and buttons of dialog box to display help.


End of Line Character

The control character that indicates the end of a line (packet terminator). The default is a carriage return.


Error Checking

Selects the error check protocol to be used for file transfer. If the host program does not support the protocol selected, it renegotiates the error checking protocol. CRC is the default.


Handshake Character

Used for half-duplex systems that require a handshake or turnaround character. The default value is none. Normal values for the turnaround character are Xon, Xoff, CR, LF, or Bell.


Maximum Retries

The number of times Kermit attempts a packet retransmission before giving up. The default is nine (9) retries.


Packet Size

Sets the maximum number of characters in a Kermit data packet. The maximum packet size is 2048 bytes. Sizes over 94 require Long Packet support from the host Kermit program. Larger packet sizes increase the performance of the file transfer.


Pad Character

The character that pads outgoing packets. Normally padding is not required. However, it is useful when working with half-duplex or slow host systems. Null is the default character. Pad characters are not sent if the pad count is zero.


Pad Count

The number of pad characters sent prior to sending the packet. Padding is seldom required. The default is zero.


Start of Packet

The control character indicating the start of a Kermit packet. SOH (Ctrl+A) is the default character. Change this field only when the host Kermit program requires a different character. If the Start of Packet character is incorrect, SolarNet Telnet for Windows Kermit won't be able to communicate with the host Kermit.


8-Bit Character Prefix

The character indicating that an 8-bit character follows. The default character is (&).


Control Character Prefix

The character that indicates control encoding. The default character is (#).


Repeat Character Prefix

The character indicating that a repeated character sequence follows. The default character is (~).


Repeated Character

Enables the compression of data by using a repeat count when sending the same character multiple times.


Request 8-Bit Prefixing

Enables the conversion of 8-bit binary information to 7-bit data with a prefix character. Enable this option when sending binary information over a communication link that only supports 7-bit data.


Windows

The number of sliding windows Kermit will attempt to use during file transfer. Using several windows increases the transfer rate by allowing Kermit to overlap packets and acknowledgments. If the host Kermit program does not support sliding windows, this parameter is negotiated to one (1). The default is three (3).


Automatic End After Transfer

If enabled, causes SolarNet Telnet for Windows to send an end packet (if required) to the Kermit server when the Done button is clicked. The end packet causes the host Kermit to exit server mode.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Kermit Setup dialog box. Click a field to display a description of the field.


XMODEM File Transfer Setup Dialog Box

Function:	Sets the parameters used for XMODEM file transfer.

Access:	Pull down the Setup menu and choose File Transfer. Choose XMODEM in the Protocol list box.

Click fields and buttons of dialog box to display help.


Error Checking

The type of error checking to be used. For basic XMODEM, select CRC or Checksum. To send 1K (1024-byte) packets with CRC (only choice available) select CRC/1K. If CRC/1K is not selected, 128-byte packets are used. Select CRC/1K only when transferring to a host XMODEM program that supports 1K packets.


Timeout

The length of time XMODEM will wait for a packet before retransmitting.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the XMODEM Setup dialog box. Click a field to display a description of the field.


YMODEM File Transfer Setup Dialog Box

Function:	Sets the parameters used for YMODEM file transfer.

Access:	Pull down the Setup menu and choose File Transfer. Choose YMODEM in the Protocol list box.

Click fields and buttons of dialog box to display help.


Timeout

The length of time YMODEM will wait for a packet before retransmitting.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the YMODEM Setup dialog box. Click a field to display a description of the field.


ZMODEM File Transfer Setup Dialog Box

Function:	Sets the parameters used for ZMODEM file transfer.

Access:	Pull down the Setup menu and choose File Transfer. Choose ZMODEM in the Protocol list box.

Click fields and buttons of dialog box to display help.


Error Checking

Select 16-bit CRC or 32-bit CRC (default).


Timeout

The length of time ZMODEM will wait for a packet before retransmitting.


Packet Size

The size of the data packet exchanged between the host and the PC during file transfer. The maximum size is 16385 and the minimum is 1024 (default).


Automatic Download Start

If enabled, the host ZMODEM program can automatically initiate the download of a file (transfer a file to the PC) when SolarNet Telnet for Windows is in emulation mode. This feature is used by most bulletin boards supporting ZMODEM.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the XMODEM Setup dialog box. Click a field to display a description of the field.


Auto Command Mode Setup Dialog Box

Function:	Configures the commands necessary to support Auto Command mode for file transfer operations. Auto Command mode eliminates the need to send commands to the host computer to start the file transfer program

Each file transfer protocol has its own Auto Command mode configuration. Clicking the Set Defaults button installs a set of commonly used commands for each protocol. These can be edited to work for your host system.

Access:	Pull down the Setup menu and choose File Transfer. Choose the appropriate file transfer protocol in the Protocol list box. Click the Auto CMD Setup button.

Click fields and buttons of dialog box to display help.

See Also:	Send Command Strings

Receive Command Strings


Send Command Strings

Send Command strings are sent when a File Send operation starts. Enter the commands necessary to start the host's receive file program, receive a file, and then to exit.

Use a single asterisk in place of the file name (the actual file name is substituted for the asterisk when the file transfer is started). When starting Kermit in server mode, do not use the asterisk, the Kermit server protocol handles the file names.


Receive Command Strings

These are the commands sent when a File Receive operation starts. Operates the same as Send Command Strings, except you enter the commands necessary to start the host's send file program and then send a file.


Turnaround Character

Prevents data overrun and ensures that each line transmitted is received by the host. Waits for a turnaround character to be echoed by the host after sending a carriage return. The default turnaround character is a Line Feed.

To disable, delete all characters in the field.


Command Delay

Some operating systems, such as RSX-11M, cannot accept file transfer commands at the speed Telnet sends them. A command delay (entered in milliseconds) slows the command line send rate, (i.e., 1000 delays for one second after issuing each command). A maximum delay of 9.999 seconds can be entered.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Auto Command Mode Setup dialog box. Click a field to display a description of the field.


International Setup Dialog Box

Function:	Specifies the keyboard and character set you want to use.

Access:	Pull down the Setup menu and choose International.

Click fields and buttons of dialog box to display help.


Windows Keyboard Driver

Displays the name of the Windows keyboard driver.


Character Set Mode

8-Bit International	Selects the DEC Multinational or the Korean character set.

7-Bit National	Selects the 7-bit National Replacement Character Set.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the International Setup dialog box. Click a field to display a description of the field.


Keyboard Behavior dialog box
Key Behavior Dialog Box

Function:	Specifies how your PC will interpret signals from your keyboard.

Access:	Pull down the Setup menu and choose Keyboard. When the secondary menu appears, choose Key Behavior.

Click fields and buttons of dialog box to display help.


Backspace Key

Backspace	Sets the Backspace key to generate the backspace (08 Hex) code and Shift Backspace to generate the delete (7F Hex) code.
Delete	Sets the Backspace key to generate the delete (7F Hex) code and Shift Backspace to generate the backspace (08 Hex) code.


IBM Keypad

Uses the unshifted IBM keypad keys 2, 4, 6, and 8 (keypad arrow keys) as numeric keypad keys or arrow keys. The IBM Keypad parameter determines the initial function of the 2, 4, 6, and 8 keypad keys.

Arrows	The keypad 2, 4, 6, and 8 keys generate the VT320 arrow key codes. The Shift 2, 4, 6, and 8 keys generate the numeric values.
Numeric	The keypad 2, 4, 6, and 8 keys generate the VT320 codes for the numeric values. The codes generated depend upon the VT320 Keypad mode in effect (Numeric or Application). The Shift 2, 4, 6, and 8 keys generate the VT320 arrow key codes.


Cursor Pad

Allows manual control of the codes generated by the VT320 cursor pad. The cursor pad is normally controlled by the host computer. This setup parameter is not saved in the settings file. Each time SolarNet Telnet for Windows is loaded it is set to the default value - Normal.

Application	The keypad generates control sequences used by application programs.

Normal	The keypad generates the numeric values printed on the keys.


Keypad

Allows manual control of the codes generated by the VT320 keypad. The Keypad mode is normally controlled by the host computer. This setup parameter is not saved in the settings file. Each time SolarNet Telnet for Windows is loaded it is set to the default value - Numeric.

Application	The keypad generates control sequences used by application programs.

Numeric	The keypad generates the numeric values printed on the keys.


Menu Bar Accelerator Key Operation

Specifies the operation of the accelerator keys.

Alt Key Only	Pressing and releasing the Alt key moves the cursor up to the menu bar. The arrow keys or the underlined letter can then be used to select the option of interest.
Alt Key + Letter Key	Pressing the Alt key plus the underlined letter of the menu bar option displays the associated drop down menu or dialog box.
Off	Uses the mouse to make menu bar selections. All default emulator key definitions are available when this option is selected.


Return Key

Selects the characters sent to the host when the Return key is pressed.

CR	Sends a carriage return to the host (normal setting).
CR/LF	Sends a carriage return and line feed to the host.
LF	Sends a line feed to the host.
New Line	Sends a carriage return and line feed to the host. If a line feed is received from the host, a carriage return is added. This option can be used in conjunction with the other three options.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Key Behavior dialog box. Click a field to display a description of the field.


Margin/Warning Bells Dialog Box

Function:	Specifies when you want your PC to issue audio signals.

Access:	Pull down the Setup menu and choose Keyboard. When the secondary menu appears, choose Margin/Warning Bells.

Click fields and buttons of dialog box to display help.


Margin Bell

If enabled, the margin bell sounds when the cursor is eight columns from the end of the current line. The Margin Bell only sounds during input.


Warning Bell

If enabled, SolarNet Telnet for Windows generates a bell tone for operating errors and receipt of a Ctrl G character.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Margin/Warning Bells dialog box. Click a field to display a description of the field.


Softkeys Dialog Box

Function:	Specifies the signals Telnet should send to a host computer when it encounters a softkey.

Access:	Pull down the Setup menu and choose Keyboard. When the secondary menu appears, choose Softkeys.

Click fields and buttons of dialog box to display help.


Current Softkey

Allows user-defined strings to be entered into Softkeys 1--12 (defaults are Ctrl F1--Ctrl F12). The strings are sent to the host computer by pressing the keys assigned as Softkeys. A maximum of 62 characters can be entered. The string can contain carriage returns, line feeds, control characters, and softkey commands.

Select a Current Softkey number, position the typing cursor and enter the strings.


Accept Changes to Current Softkey Button

Saves the softkey contents.


Discard Changes to Current Softkeys Button

Ignores any changes you have made, or exits that softkey without entering a string.


Erase Current Softkey Button

Clears the contents of an individual softkey.


Clear All Softkey Entries Button

Clears the contents of all defined softkeys.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Softkeys dialog box. Click a field to display a description of the field.


Keyboard Type Dialog Box

Function:	Specifies the type of keyboard you are using, which determines default key assignments.

Access:	Pull down the Setup menu and choose Keyboard. When the secondary menu appears, choose Type.

Click fields and buttons of dialog box to display help.


Keyboard

Selects the keyboard type and establishes the default key assignments.

AT	Selects the AT keyboard configuration.
Enhanced	Selects the Enhanced keyboard.
LK250	Selects a DEC LK250 keyboard.
LK450	Selects a DEC LK450 keyboard.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Keyboard Type dialog box. Click a field to display a description of the field.


Log File Replay Setup Dialog Box

Function:	Specifies the conditions under which Telnet pauses during the replay of a log file.

Access:	Pull down the Setup menu and choose Log Replay.

Click fields and buttons of dialog box to display help.


Pause On

This parameter is used to enter a comparison string. When the string is matched by data in the replay file, a replay pause occurs. The string can be up to 25 characters in length and can include control characters.

To disable the comparison string, clear the field by pressing the Del key.


Pause on Clear Screen

Pauses the log file replay each time the screen is cleared.


Pause on Every Page

Pauses the log file replay when a new page of text is scrolled onto the screen. This option may not work properly with log files that display text using direct cursor positioning.


Replay Rate

Sets the replay speed rate for log files.

KEY	APPROXIMATE RATE

1	  300 characters per second

2	1200 characters per second

3	2400 characters per second

4	4800 characters per second

5	9600 characters per second

6	Maximum


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Log File Replay dialog box. Click a field to display a description of the field.


Modem Setup Dialog Box

Function:	Sets the initialization string used by the Modem Dialer.

Access:	Pull down the Setup menu and choose Modem.

Click fields and buttons of dialog box to display help.


Initialization String

The Initialization String is sent to the modem prior to the dialing commands. It can be used to set or adjust modem parameters. Otherwise, it is not needed and should be left blank.

Example:	Initialization String ATS7=45S10=1000, where

S7=45	Changes the time the modem waits, after dialing, for a carrier from the remote modem, to 45 seconds.

S10=1000	Changes the loss of carrier detect time to 1 second (1000 milliseconds).


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Modem Setup dialog box. Click a field to display a description of the field.


Mouse Mapping Dialog Box

Function:	Assigns functions to the mouse buttons.

Access:	Pull down the Setup menu and choose Mouse.

Click fields and buttons of dialog box to display help.

Through the Mouse Mapping dialog box, the mouse clicks can be configured to perform the same functions as the Floating Toolbar buttons. A mouse click can be defined to send a string, a VT320 keystroke, a mouse position report, execute a command file, or perform an emulator function, such as Exit.

Mouse clicks are only redefined while the mouse cursor is in the emulation window. If the mouse cursor is moved outside the emulation window, the mouse buttons perform their normal Windows functions.

See Also

Token Strings

Internal Functions

Mouse Functions


Current Mousemap

The name of the currently selected mouse map.


New Button

Creates a new mouse map. When this button is clicked, the Mouse Map Name dialog box appears. Enter the new mouse map name, then click OK.


Rename Button

Used to change the current mouse map's name. When clicked, this button displays the Mouse Map Name dialog box. Change the mouse map's name, then click OK.


Delete Button

Deletes the currently selected mouse map. All the data for the current mouse map is deleted from the MOUSE.INI file.


Action

Selects the mouse button action to reprogram. As the button selection is changed, any current information is displayed in the fields below.


Set To

Selects the type of action the button is to perform.

Command	Allows the user to define a ECL command to be executed when the button is pressed.
Command File	Specifies that a command file will be executed when the button is pressed.
Help File	Launches a specified help file.
Internal Function	Special functions used for the fixed toolbar.  See Internal Functions.
Mouse Function	Allows the user to assign special mouse actions to a mouse button.
Mouse Position Report	Sends a special string to the host indicating the mouse position in alpha cursor coordinates. Example: <ESC>PR[RR,CC]<CR> Where: RR is the ASCII row and CC is the column.
Nothing	Ignores any button action (disables the button).
String	Allows the user to define a string that will be sent to the host when the button is clicked.
Token	VT keys and emulator functions are represented by tokens.
Switch Toolbar	Switches to a different toolbar.


Set To Data

The Set To Data depends on the Set To type specified above. The actions are listed below:

Command	Enter an ECL command to be executed when the button is clicked.
Command File	Enter the path name of a command file or click Browse to display the Command File Selection dialog box. Select a command file then click OK.
Help File	Enter the path name of a help file or click Browse to display the Help File Selection dialog box. Select a help file then click OK.
Internal Function	Enter the name of an internal function to execute. When the cursor is placed on the data field, a list appears to allow selection of valid functions. Invalid function names are ignored. See Internal Functions.
Mouse Function	Enter the name of the mouse function for the button to perform. When the cursor is placed on the data field, a list appears to allow selection of valid functions. Invalid mouse function names are ignored.
Mouse Position Report	The Set To Data field is disabled for this selection. Nothing can be entered.
Nothing	The Set To Data field is disabled for this selection. Nothing can be entered.
String	A simple ASCII string can be entered. This string is sent to the host when the button is clicked. Special characters can be entered by specifying the ASCII value and enclosing it inside angle brackets << >>.
Token	Click on this field to display a two lists of valid tokens: VT Tokens and Emulator Tokens. Select the desired token from one of the lists. The selected token is appended to any existing data in the token field. Token names may be entered manually by enclosing the token name in a pair of square brackets [ ]. Also, ASCII strings may be combined with token names by editing the token data string. A token string can be up to 255 characters long. A "beep" indicates that additional characters will make the string too long.
Switch Toolbar	Enter the name of an alternate toolbar to switch to.


Browse Button

Displays a Help File or Command File selection dialog depending on the option selected in the Set To box.

Note:	Be sure to click the Add or Change button before selecting another button from the list, otherwise all changes to the current button will be lost.


Clear Button

Resets the defaults for the currently selected action.


Clear All Button

Resets the defaults for all mouse actions.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Mouse Settings dialog box. Click a field to display a description of the field.


Mouse Functions

Mouse functions are internal routines that handle specific tasks related to mouse button operation.

Note:	Only one mouse button can be assigned to a particular mouse function. When selecting a mouse function for a button, SolarNet Telnet for Windows resets all other mouse buttons with the same mouse function.

The mouse functions consist of the following.

Name	Function
Mark	Selects text by the pressing and holding of the assigned button. Release the button when finished selecting.
Mark Column	Marks blocks of text using column mode.
Send	Sends the text contained in the selected area.


Preferences Dialog Box

Function:	Specifies window placement, scrolling options, and toolbar location for the Telnet application.

Access:	Pull down the Setup menu and choose Preferences.

Click fields and buttons of dialog box to display help.


Auto Scroll (pan to follow cursor)

Enables or disables horizontal and vertical scrolling to follow the cursor when it is positioned outside the window.


Emulation Window

Selects the way the emulation window appears on the screen.


Fixed Toolbar

Specifies the location of the fixed toolbar for the Telnet application .


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Preferences dialog box. Click a field to display a description of the field.


Scrollback Memory Setup Dialog Box

Function:	Specifies how much memory you want SolarNet Telnet for Windows to allocate to scroll memory.

Access:	Pull down the Setup menu and choose Scrollback.

Click fields and buttons of dialog box to display help.

See Also:	Using the Scrollback Function


Scrollback Memory Size

Sets the amount of memory allocated to scroll memory, in the range 10--999K.

If Scroll Memory is enabled when the size is changed, the memory size is modified immediately. If there is insufficient free memory, the request is reduced to use the available memory. If the allocation fails entirely, Telnet displays an error message.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Scrollback Memory dialog box. Click a field to display a description of the field.


Terminal Setup Dialog Box

Function:	Specifies the type of terminal you want SolarNet Telnet for Windows to emulate.

Access:	Pull down the Setup menu and choose Terminal.

Click fields and buttons of dialog box to display help.


Control Sequence Debug

Control Sequence Debug mode is a substitute for VT320 Display Controls mode.

When debug mode is enabled, and DEBUG is pressed, VT320 control sequences display on the bottom line of the screen before they are executed. Pressing any key executes the sequence. Pressing DEBUG again allows control sequences to execute without being displayed.


Terminal Status

Selects Online or Local mode. In Local mode, SolarNet Telnet for Windows doesn't send data to the host or process data received from the host. However, any keys typed are echoed to the screen. Online mode allows SolarNet Telnet for Windows to communicate with the host system.


User-Defined Keys (UDKs)

Locks or unlocks the user-defined keys. Locking the keys prevents downloading and protects the current key contents. UDKs can be locked by the host system but can only be unlocked through the setup menu. When the keys are unlocked, the host can download function keys F1--F20 with user-defined strings.


User Features

Locks or unlocks SolarNet Telnet for Windows User Preference Features, which include:

Slow or Fast Scroll

Normal or Reverse Screen

Selecting Lock instructs SolarNet Telnet for Windows to ignore any control sequences that affect the User Preference Features.


Auto Answerback

Enables or disables the sending of the Answerback Message automatically when a communication connection is established. Modem Control must be ON if Auto Answerback is enabled. Disable is the default value.


Conceal Message

If Conceal Answerback is selected, the Answerback Message is not displayed on the screen. Instead, the word " Concealed>" appears in place of the message. Once an Answerback Message is concealed, it can only be made visible by entering a new message.


Message

The Answerback Message is sent on receipt of an ENQ code, when you choose Send Answerback from the Execute menu, or when you enter the SEND ANSWERBACK command. It is generally used as a security measure by host computer systems to identify certain terminals or users.


Type/ID

Displays the terminal type and the terminal ID name. The following terminal types are available:

VT320

VT220

VT102

VT100

VT52

SCO-ANSI

BBS-ANSI


7-bit Key Codes

SolarNet Telnet for Windows sends only 7-bit control sequences to the host, but still interprets all 7-bit and 8-bit control sequences and characters received.


8-bit Key Codes

Eight-bit control sequences are transmitted to the host computer by SolarNet Telnet for Windows.

Note:	VT320 8-bit mode is not a communication setting. It is an operating environment. To select 8-bit communications, configure SolarNet Telnet for Windows to 8 Data Bits and No Parity.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the Terminal Setup dialog box. Click a field to display a description of the field.


Key Mapping Dialog Box

Function:	Configures the keyboard to perform such functions as sending a string or a VT320 keystroke, executing a command file, accessing a help file, switching between multiple toolbars, or performing an emulator function.

Access:	Pull down the Setup menu and choose Keyboard. When the secondary menu appears, choose Key Mapping.

Click fields and buttons of dialog box to display help.


Current Keymap

This section deals with the keymaps as whole entities. The name of the current keyboard map is listed in the Current Keymap list box.


New Button

Creates a new keymap. When this button is clicked, the Keymap Name dialog box opens. Enter the new keymap name, then click OK.


Rename Button

Used to change the current keymap's name. When clicked, this button opens the Keymap Name dialog box. Change the keymap's name, then click OK.


Delete Button

Deletes the currently selected keymap. All data for the current keymap is deleted from the SETTINGS.INI file.


Keyboard

The middle of the dialog box displays the layout for the keyboard selected in Setup - Keyboard - Type. To select a key to be defined, use the mouse to choose the desired key(s). (You can precede each definition with Alt, Shift, Ctrl or any combination of the three.)


Mapped Keys

Displays the list of mapped keys.


Current Key

Each keystroke selection made in the keyboard section is displayed in this section.


Set To

Selects the action for the key to perform when it is pressed. The selections are as follows:

Command	Allows the user to define an ECL command to be executed when the key is pressed.
Command File	Specifies that a command file will be executed when the key is pressed.
Help File	Launches a specified help file.
Internal Function	Special functions used for the fixed toolbar. See Internal Functions.
Nothing	Ignores any key action (disables the key).
String	Allows the user to define a string that will be sent to the host when the key is pressed.
Token	VT keys and emulator functions are represented by tokens.
Switch Toolbar	Switches to a different toolbar.


Set To Data field

This field is located below the Set To box. What appears in this field depends on the Set To selection above.

Command	Enter an ECL command to be executed when the button is clicked.
Command File	Enter the path name of a command file or click Browse to display the Command File Selection dialog box. Select a command file then click OK.
Help File	Enter the path name of a help file or click Browse to display the Help File Selection dialog box. Select a help file then click OK.
Internal Function	Enter the name of an internal function to execute. When the cursor is placed on the data field, a list appears to allow selection of valid functions. Invalid function names are ignored. See Internal Functions.
Nothing	The Set To Data field is disabled for this selection. Nothing can be entered.
String	A simple ASCII string can be entered. This string is sent to the host when the button is clicked. Special characters can be entered by specifying the ASCII value and enclosing it inside angle brackets << >>.
Token	Click on this field to display a two lists of valid tokens: VT Tokens and Emulator Tokens. Select the desired token from one of the lists. The selected token is appended to any existing data in the token field. Token names may be entered manually by enclosing the token name in a pair of square brackets [ ]. Also, ASCII strings may be combined with token names by editing the token data string. A token string can be up to 255 characters long. A "beep" indicates that additional characters will make the string too long.
Switch Toolbar	Enter the name of an alternate toolbar to switch to.


Add Button

When you are satisfied with the key combination, click the Add button. The key definition displays in the Mapped Keys list box, and the keystroke combination is highlighted so that it won't be defined twice.


Change Button

Changes the existing configuration for the currently selected keystroke.


Delete Button

Deletes the currently selected keystroke. The remaining keystrokes are moved to fill the empty space.


Browse Button

Displays a Help File or Command File selection dialog depending on the option selected in the Set To box.

Note:	Be sure to click the Add or Change button before selecting another button from the list, otherwise all changes to the current button will be lost.


Exits the dialog box and saves your selections.


Exits the dialog box without saving any changes.


Displays Help for the Key Mapping dialog box. Click a field to display a description of the field.


Internal Functions

Internal functions are routines that handle specific tasks that cannot be performed by tokens or ECL commands. Some functions allow buttons to remain pressed to indicate the current selection.

Name	Function
132	Toggles between 80 and 132 column modes.
Dial	Opens the Modem Dialer dialog box.
Exit	Exits SolarNet Telnet for Windows.
Help	Opens the help file.
Hold	Enables or disables the flow of incoming data.
Max_Workspace	Maximizes the workspace.
Print	Opens the Print dialog box.
Receive Files	Opens the File Receive Selection dialog box.
Scrollback	Enables or disables the display of scrollbars.
Send File	Opens the File Send Selection dialog box.
Switch	Switches to the next instance (if any).
WordPerfect	Toggles between normal and WP modes.


Tokens

Tokens are used by SolarNet Telnet for Windows to represent VT keys or emulator functions. They are divided into two categories:

VT Tokens are DEC VT terminal function keys.

Emulator tokens perform a function such as Exit, Send a Break, or Maximize Workspace mode.


New Map dialog box
New Keymap, Mousemap, and Toolbar Name

Function:	Assigns a new name to a keymap, mousemap, or toolbar.

Access:	Click the Rename button on the Key Mapping dialog box.

Click fields and buttons of dialog box to display help.


Name

Enter the new name for the keymap, mousemap, or toolbar.


Exits the dialog box and saves your selections.


Exits the dialog box without saving any changes.


Displays Help for this dialog box. Click a field to display a description of the field.


Toolbar Settings Dialog Box

Function:	Lets you configure the optional floating toolbar for the Telnet application.

Access:	Pull down the Setup menu and choose Toolbar.

Click fields and buttons of dialog box to display help.

See Also:	Toolbar Sizing and Location

Creating a New Toolbar

Deleting a Toolbar

Changing a Toolbar's Name

Automatically Sizing All Buttons

Setting the Default Caption Location

Adding a Button

Deleting a Button

Changing a Button

Entering a Caption

Entering the Help Text

Changing Button Size

Adding a Bitmap

Deleting a Bitmap

Token Strings

Internal Functions


Toolbar Sizing and Location

The floating toolbar is contained within its own window that can be moved and resized. Clicking one of the toolbar's buttons performs its assigned function.

To move the toolbar, drag it to the desired location.

The toolbar can be resized in the typical Windows manner; use mouse button 1 to grab a border and drag it to the desired size.


Show Toolbar

Enable this option to display the toolbar


Current Toolbar

The name of the currently selected toolbar.


Auto Size

Enables or disables Automatic Sizing. When enabled, all buttons are automatically sized to the size of the largest button in the current toolbar. The Auto Size feature can be overridden for individual buttons by manually changing the size of the button. See Changing Button Size for more information.


Caption

This list box is used to specify the default location of the caption text for the entire toolbar.


New Button

Creates a new toolbar. When this button is clicked, the Toolbar Name dialog box appears. Enter the new toolbar name, then click OK.


Rename Button

Used to change the current toolbar's name. When clicked, this button displays the Toolbar Name dialog box. Change the toolbar's name, then click OK.


Delete Button

Deletes the currently selected toolbar. All data for the current toolbar is deleted from the TOOLBAR.INI file.


Current

This area contains a representation of the new button. In addition, this area is used for custom button sizing. The button's border contains three white boxes that can be used to size the button with the mouse.


Caption

Contains the current caption for the button. This field may be blank.


Caption Location

Specifies the location of the caption text for the current button. This selected location overrides the setting for the entire toolbar. The location can be one of the following:

Default	Use the caption location specified for the entire toolbar.
Right	Places the caption to the right of the bitmap.
Below	Centers the caption below the bitmap.
Left	Places the caption to the left of the bitmap.
Above	Centers the caption above the bitmap.
Overlay	Centers the caption on top of the bitmap.
Off	Turns the caption off. The caption does not display, but it is not removed from the button.


Set To

Selects the action for the button to perform when it is clicked. The selections are as follows:

Command	Allows the user to define a ECL command to be executed when the button is clicked.
Command File	Specifies that a command file will be executed when the button is clicked.
Help File	Launches a specified help file.
Internal Function	Special functions used for the fixed toolbar. See Internal Functions.
Nothing	Ignores any button action (disables the button).
String	Allows the user to define a string that will be sent to the host when the button is clicked.
Token	VT keys and emulator functions are represented by tokens.
Switch Toolbar	Switches to a different toolbar.


Set To Data field

This field is located below the Set To box. What appears in this field depends on the Set To selection above.

Command	Enter an ECL command to be executed when the button is clicked.
Command File	Enter the path name of a command file or click Browse to display the Command File Selection dialog box. Select a command file then click OK.
Help File	Enter the path name of a help file or click Browse to display the Help File Selection dialog box. Select a help file then click OK.
Internal Function	Enter the name of an internal function to execute. When the cursor is placed on the data field, a list appears to allow selection of valid functions. Invalid function names are ignored. See Also Internal Functions.
Nothing	The Set To Data field is disabled for this selection. Nothing can be entered.
String	A simple ASCII string can be entered. This string is sent to the host when the button is clicked. Special characters can be entered by specifying the ASCII value and enclosing it inside angle brackets << >>.
Token	Click on this field to display two lists of valid tokens: VT Tokens and Emulator Tokens. Select the desired token from one of the lists. The selected token is appended to any existing data in the token field. Token names may be entered manually by enclosing the token name in a pair of square brackets [ ]. Also, ASCII strings may be combined with token names by editing the token data string. A token string can be up to 255 characters long. A "beep" indicates that additional characters will make the string too long.
Switch Toolbar	Enter the name of an alternate toolbar to switch to.


Help Text

Contains help text for the button. The help text displays on the status line when a toolbar button is clicked.


Add Button

Adds a new button to the end of the button list.


Change Button

Changes the existing configuration for the currently selected button.


Clear Button

Clears all information about the current button.


Delete Button

Deletes the currently selected button. The remaining buttons are moved to fill the empty space.


Browse Button

Displays a Help File or Command File selection dialog depending on the option selected in the Set To box.

Note:	Be sure to click the Add or Change button before selecting another button from the list, otherwise all changes to the current button will be lost.


Add... Button

Click this button to display the Bitmap Selection dialog box. Through this dialog box, additional bitmaps can be added to the horizontal bitmap list.


Delete Button

Deletes the currently selected bitmap. This button may be disabled if the selected bitmap is already in use by a toolbar.


Exits the dialog box and saves your selections to the TOOLBAR.INI file.


Exits the dialog box without saving any changes.


Displays Help for the Toolbar Settings dialog box. Click a field to display a description of the field.


Creating a New Toolbar

To create a new toolbar:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Open the Toolbar Name dialog box by clicking the New button in the Current Toolbar box.

3.	Enter the name of the toolbar in the Toolbar Name text box.

4.	Click the OK button to create the new toolbar.

Note:	When a new toolbar is created, all currently displayed buttons are erased.


Deleting a Toolbar

To delete a toolbar:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to delete.

3.	Click the Delete button in the Current Toolbar box.

4.	When a confirmation dialog box appears, click the Yes button to delete the selected toolbar.


Changing a Toolbar's Name

To change a toolbar's name:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to change.

3.	Click the Rename button in the toolbar section.

The Toolbar Name dialog box appears.

4.	Enter the new name of the toolbar.

5.	Click the OK button to accept the new name.


Automatically Sizing Toolbar Buttons

Automatic button sizing makes all buttons in the toolbar the same size. Automatic button sizing is useful in creating a specific button layout.

To turn automatic button sizing on or off:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to update.

3.	Click the Automatic Sizing check box on and off to toggle the setting.

When Automatic Sizing is enabled, a checkmark appears in the Auto Size box.


Setting the Default Caption Location

The Default Caption Location selection sets the location of the captions for all buttons in the toolbar. This setting only affects the buttons with a caption location set to Default.

To change the default location:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to modify.

3.	Use the Caption drop-down list to select a default caption position.

You can choose Right, Below, Left, Above, Overlay, or Off.


Adding a Button

To add a button to the toolbar:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to modify.

3.	Select the button you want to modify from the scrolling list on the left side of the dialog box.

4.	If you want to redefine the button, click the Clear button to delete its current settings.

You should skip this step if you want to edit the settings for a button.

5.	Enter settings for the new button.

To set up a button, you select a bitmap, specify the text and position for the button caption, specify the button action, and enter help text for the button.

6.	Click the Add button to add the button to the end of the toolbar button list.


Deleting a Button

To delete a button from a toolbar:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to modify.

3.	Select the button you want to modify from the scrolling list on the left side of the dialog box.

4.	Click the Delete button to delete the button from the toolbar.


Changing a Button

To change a buttons setting:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Use the Current Toolbar drop-down list to select the name of the toolbar you want to modify.

3.	Select the button you want to modify from the scrolling list on the left side of the dialog box.

4.	If you want to redefine the button, click the Clear button to delete its current settings.

You should skip this step if you want to edit the settings for a button.

5.	Enter settings for the new button.

To set up a button, you select a bitmap, specify the text and position for the button caption, specify the button action, and enter help text for the button.

6.	Click the Change button to update the settings for the button.


Entering a Caption

Enter a caption for the button by typing characters into the Caption field. As each character is typed, the caption in the current button will change automatically. The size of the button may also change to reflect the new caption.

The caption may be 20 characters long unless the button size becomes too big. If the button becomes too big, a "beep" will occur to indicate that no more characters can be entered.


Entering the Help Text

Enter help text for the button by typing characters into the Help Text field. This text is displayed on the status line when the button is clicked. The help text can be up to 80 characters long.


Changing Button Size

The size of a button can be changed easily. The current button is drawn with 3 white rectangles on the right and bottom edges. These "handles" can be dragged with the mouse to increase or decrease the button size.

The custom sizes are stored in the TOOLBAR.INI file when the toolbar is saved.

To set a button back to its original size, drag a "handle" to the upper-left corner of the button. When the mouse button is released, the button snaps back to the calculated size.


Adding a Bitmap to the Bitmap List

To add a bitmap to the bitmap list:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Click the Add button located in the Bitmap section at the bottom of the dialog box.

The Bitmap dialog box appears.

3.	Select one or more bitmaps from the list.

4.	Click the OK button to add the selected bitmaps to the end of the toolbar bitmap list.


Deleting a Bitmap

To delete a bitmap from the bitmap list:

1.	Open the Toolbar Settings dialog box by pulling down the Setup menu and choosing Toolbar.

2.	Select the bitmap you want to delete from the bitmap scrolling list at the bottom of the dialog box.

3.	Click the Delete button in the Bitmap box.

The selected bitmap is deleted from the list.


Connect Dialog Box

Function:	Opens a Telnet connection from your PC to a remote host.

Access:	Pull down the Connect menu and choose Conn/Disc.

Click fields and buttons of dialog box to display help.

See Also:	Opening a Telnet Connection

Auto Connect Port

WINSOCK Setup


Port Name

Selects the connection source.

COM1--COM4	Uses the standard PC serial ports.

WINSOCK	Provides connectivity using any of several protocols. WINSOCK is a standard network interface that many network protocol providers have available for their protocol stacks. Normally WINSOCK gives the user access to a TCP/IP stack.


Node Name

The Node Name field only appears when you select a network (WINSOCK) connection. Enter or select the name or IP address of the remote host to which you want to open a Telnet connection.


Exit on Disconnect

Exits SolarNet Telnet for Windows when the instance is disconnected.


Status

Displays the connection status.


Creates a connection to the selected port or network.


Disconnects the selected instance.


Displays the Port Setup dialog box when a COM port is selected. Displays the WINSOCK Setup dialog box when a WINSOCK (network) connection is selected. Displays the Auto Connect dialog box when Auto Connect is selected.


Exits the dialog box.


Displays Help for the Connect dialog box. Click a field to display a description of the field.


Auto Connect Port Dialog Box

Function:	Configures the connection that Telnet for Windows opens automatically when the program is started.

Access:	Pull down the Connect menu and choose Conn/Disc. Select Auto Connect as the port name. Click the Setup button.

Click fields and buttons of dialog box to display help.


Port

Select the desired COM port or network protocol. If a network protocol is desired, a host name or IP address is also required.


Command File

When SolarNet Telnet for Windows starts and autoconnects to a port, it executes the specified command file. If an Auto Connect Port is not selected, the Command File option is ignored.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays the Port Setup dialog box when a COM port is selected. Displays the WINSOCK Setup dialog box when a WINSOCK (network) connection is selected.


Displays Help for the Auto Connect Port dialog box. Click a field to display a description of the field.


Port Setup Dialog Box

Function:	Selects the parameters for the selected COM port. You can select different parameters for each COM port.

Access:	Pull down the Connect menu and choose Conn/Disc. Select a communications port (COM1--COM4). Click the Setup button.

Click fields and buttons of dialog box to display help.


Baud Rate

Selects the transmission speed for the COM port. Options are 115200, 57600, 38400, 19200, 9600, 4800, 2400, 1200, 600, 300, and 110.


Parity

Specifies the parity setting for the COM port. Parity options are:

None	No parity bit. Use this setting when using eight data bits.
Odd	Odd parity.
Even	Even parity.
Space	Forces parity bit to a 0. Recommended for 7-bit environments that don't require odd or even parity.
Mark	Forces parity bit to a 1.


Data Bits

Selects 7 or 8 data bits. 7 bits is usually required when parity is set to odd or even.


Stop Bits

Sets the number of stop bits for each data word to 1 or 2. A stop bit setting of 1 is correct for most systems.


Flow Control

Selects Xon/Xoff, RTS/CTS, or None as the communications flow control protocol.

None	Disables all receive buffer control. In this mode, characters are lost if SolarNet Telnet for Windows can't process characters fast enough to prevent the receive buffer from overflowing. Set the receive buffer size above 3168 characters.
RTS/CTS	A hardware flow control mode. When the "Stop" level is reached, SolarNet Telnet for Windows drops the RTS (Request To Send) modem control signal. When the receive buffer character count falls below the "Start" level, RTS is enabled. If CTS is disabled, SolarNet Telnet for Windows cannot send characters.
Xon/Xoff	The flow control method used by all DEC computers and most other computer systems. Xon/Xoff sends a DC3 (Ctrl S) character to the host when the receive buffer reaches the "Stop" level. When the receive buffer character count falls below the "Start" level, a DC1 (Ctrl Q) is sent to the host.


Int 14 Redirection

Determines whether or not the serial port is redirected to an INT 14 redirection.


Local Echo

Sends the data transmitted to the host computer to the PC's screen. Local Echo should be enabled when communicating with half-duplex computer systems.


Modem Control

Determines if the modem connect status is monitored. Disable modem control when using a direct connection to the host computer unless the port is configured for full modem control. Modem Control is recommended when using a modem.

Disabled	The modem status signals are not monitored. However, SolarNet Telnet for Windows always raises the DTR and RTS modem signals when loaded. The status line shows ONLINE when Modem Control is disabled.

Enabled	Monitors the carrier detect line. If the connection terminates, the status line changes to OFFLINE and the message CONNECTION LOST appears.


Transmit Limited

Enables or disables limited transmit speed.

Enabled	Limited transmit restricts SolarNet Telnet for Windows transmit speed from between 150 and 180 characters per second, regardless of the configured transmission rate. This places a nominal interrupt burden on the host computer's operating system. Limited transmit may be necessary for proper communication with some half-duplex systems; this is particularly true for proper operation of the Softkeys.

Unlimited	Doesn't limit the transmit rate. SolarNet Telnet for Windows sends characters as fast as the transmission rate allows. This is the normal mode of operation.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the COM Port Setup dialog box. Click a field to display a description of the field.


WINSOCK Setup Dialog Box

Function:	Selects the parameters for a WINSOCK (network) connection.

Access:	Pull down the Connect menu and choose Conn/Disc. Select WINSOCK. Click the Setup button.

Click fields and buttons of dialog box to display help.


Data Mode

Selects 7-bit or 8-bit data communications. If 7-bit is selected, the most significant bit (bit 7) of each character sent or received is set to 0. Select 8-bit when transferring binary files or using VT220/VT320 8-bit mode.


Prompt Login

Sends a carriage return to the host after a successful new connection. Most host systems output a login message automatically without enabling this field. However, for host systems that do not, enable this option.


Exits the dialog box and saves your selections until you exit SolarNet Telnet for Windows.


Exits the dialog box without saving any changes.


Displays Help for the WINSOCK Setup dialog box. Click a field to display a description of the field.


Switch Dialog Box

Function:	Lets you switch between instances of SolarNet Telnet for Windows.

Access:	Choose the Switch icon or pull down the Connect menu and choose Switch.

Click fields and buttons of dialog box to display help.


Instance Name

Lists the number and the name of all open instances.


Switches between instances.


Exits the dialog box without saving any changes.


Displays Help for the Switch dialog box. Click a field to display a description of the field.


Recording Tips
Log File Recording Tips

Programming

Some experimentation with the replay programming may be necessary to achieve the desired results. The following are guidelines for setting programming options:

Select the desired replay rate and use HOLD to stop the replay at the desired places.

Selecting Pause on Every Page in the Log File Replay Setup dialog box causes a replay pause after each page of text.

Menu Driven Applications

Pauses for menu driven applications require some consideration. The display techniques vary widely between programs. One or more options may be required simultaneously to program the desired pauses.

Selecting Pause on Clear Screen in the Log File Replay Setup dialog box works for many menu driven applications by causing an automatic pause before clearing each screen.

Many menu programs clear the screen one line at a time. These programs will not pause when the screen is cleared.

If the replay does not pause when the screen is cleared, examine the application screens for a string that appears near the bottom of every screen. Enter the string in the Pause On field in the Log File Replay Setup dialog box .


Using the Scrollback Function

The scrollback display is manipulated through the vertical scrollbar. To move one line, click the arrows at the ends of the scrollbar. To move a page, click in the gray area near the ends of the scrollbar.

If the scrollbar is not displayed, click the scrollbar button on the status line. If the screen is maximized, the scrollbar may shrink to allow a full screen display. Clicking the scrollbar button may expand the scrollbar to full length, but will also change the font size.

The scrollbar button rotates the scrollbar through three modes:

Invisible

Visible and full length.

Visible, shrunk, and located in the frame.


 Logging And Replay

The Log function writes all data that appears on the screen into a log file on the disk. The log file contains all screen data and control sequences received by Telnet.

The Replay function lets you play back a previously recorded log file offline from the host computer system. The log file can be replayed at six different rates. You can program the log file  to stop on every page, new screen, or user defined string. The replay can also be paused at any time using the HOLD command.

How To...

Record a Log File

Replay a Log File


 Softkeys

Softkeys are functions keys that can be associated with ASCII text strings. Each string can contain control characters, delays, programming commands, or references to command files. A maximum of 62 characters can be entered as a softkey string.

The twelve available softkeys are represented by the token names SKEY1 - SKEY12. When a softkey is pressed, Telnet transmits the string to the COM port, which executes any softkey commands embedded in the softkeys tring. Softkey Pauses and Waits display a message on the status line of the screen when they are executed.

You use the Softkeys dialog box to define your own softkey strings. To cancel the execution of a softkey, pull down the Execute menu and choose Abort.

Softkeys and the Modem Dialer

Softkeys can be executed automatically by the Modem Dialer. To execute a softkey when connecting to a host computer, enter the softkey number in the Command File field in the Modem Dialer dialog box. The format for a softkey number is:

<S:n>

where n is the number of the softkey.

Softkeys can also be inserted as part of a phone number in a phone book entry. When the Modem Dialer is dialing the number, it expands the Softkey and sends the contents to the modem. Softkeys are useful for storing phone card number and other dialing information.

Softkey Programming Commands

Command	Action
<P:n>	Pause n seconds.
<B:>	Short break (200 milliseconds).
<B:L>	Long break (2 seconds).
<K:>	Invoke Kermit. The Kermit prompt appears immediately after the K command is executed.
<W:ssssss>	Wait for string ssssss. Causes Telnet to wait until the specified string occurs in the receive data. The string can be 25 characters long. The comparison is not case sensitive.
<S:c>	Sends character c out the communications port. Used to send < or > characters since they normally cannot be sent.
<@command file>	Executes the command file specified. The filename can include a DOS path specification.
Examples

Example 1:	<CR><W:Username:>NAME<CR>PASSWORD<CR>

Automatically logs onto the host.

Where:	<CR> is the character sent when the carriage return is pressed.

<W:Username:> is the Softkey Wait command. This command causes Telnet to wait until the string "USERNAME:" (not case sensitive) occurs in the receive data.

NAME is the name sent to the host after the string "USERNAME:" has been received.

PASSWORD is a password.

Example 2:	ATDT4441234<CR><P:10><CR>NAME<CR>PASSWORD<CR>

Automatically dials a modem and logs onto the host.

Where:	ATDT4441234 gives the autodial command.

<CR> is the character sent when the carriage return is pressed.

<P:10> gives a 10 second pause.

NAME is the username.

PASSWORD is a password.

Example 3:	KERMIT<CR>SET FILE TYPE BIN<CR>SERVER<CR><K:>

Sets up a Kermit transfer for a binary SEND or RECEIVE command.


WordPerfect
 WordPerfect Mode

Telnet for Windows includes a WordPerfect (WP) mode that you can use when you are running VAX/VMS WordPerfect versions 4.2 or 5.x.

When you activate WP mode, you can use the same keystrokes for the VAX version of WordPerfect as you use for the PC version of WordPerfect. When you are in WP mode, Telnet sends the appropriate VT320 keystrokes to the VAX for each WP key pressed. The emulation is so exact that you can use your PC WordPerfect template when operating with the VAX version.

Since many of the WP assignments overlap normal Telnet assignments, several emulator keys do not operate in WP mode. If an emulator key is not assigned to a WP function, it works normally.

How To...

Enter WordPerfect Mode

Enter WordPerfect Mode from a Host Computer

Terminate WordPerfect Mode

Terminate WordPerfect Mode from a Host Computer


Enter WordPerfect Mode
 Entering WordPerfect Mode

To enter WP mode:

Pull down the Execute menu and choose WordPerfect 4.2 or WordPerfect 5.x.

or

Type WP ON or WP5 ON at the Telnet CMD> prompt.

When WordPefect 4.2 mode is enabled, WP is displayed on the Telnet status line. When WordPerfect 5.x mode is enabled, WP5 is displayed on the status line.


Terminate WordPerfect Mode
 Terminating WordPerfect Mode

To terminate WP mode:

Pull down the Execute menu and choose WordPerfect 4.2 or WordPerfect 5.x.

or

Type WP OFF at the CMD> prompt.


Record a Log File
 Recording a Log File

To record a log file:

1.	Pull down the File menu and choose Record Log File.

The Record Log File dialog box opens.

2.	Enter a filename for the log file.

The log file name can include a complete DOS path specification. If a file name extension is not specified, .LOG is used by default.

3.	Select the options you wish to use for this log file.

Append -- Add new log information to the end of an existing log file.

Overwrite Protection -- Notify you if the file you specified in step 2 already exists.

Text Only -- Record text only; ignore control characters.

5.	Choose the OK button.

Telnet for Windows begins recording the log file. You are returned to the Telnet main window, and all incoming information in your Telnet session is recorded from this point on.

6.	Stop recording by choosing the Record Log File command again.


Replay a Log File
 Replaying a Log File

To replay a previously recorded log file:

1.	Pull down the File menu and choose Replay Log File.

The Log File Replay Selection dialog box opens.

2.	Enter the name of the log file in the File Name field.

The log filename can include a complete DOS path name.

3.	Click the OK button to start replaying the log file.

4.	Pause the replay by clicking the Hold button in the bottom right corner of the Telnet screen.

When a replay pause occurs, the following message appears:

Replay Pause	(CR = Continue, Q = Quit, P = Print Screen)

Press carriage return to continue, Q to terminate the replay operation, or P to print the screen.

5.	Terminate replay by clicking the Stop button or by answering Q to the replay pause prompt.

See Also:	Log File Replay Setup dialog box

Programming

Some experimentation with the replay programming may be necessary to achieve the desired results. The following are guidelines for setting programming options:

Select the desired replay rate and use HOLD to stop the replay at the desired places.

Selecting Pause on Every Page in the Log File Replay dialog box causes a replay pause after each page of text.

Menu Driven Applications

Pauses for menu driven applications require some consideration. The display techniques vary widely between programs. One or more options may be required simultaneously to program the desired pauses.

Selecting Pause on Clear Screen in the Log File Replay dialog box works for many menu driven applications by causing an automatic pause before clearing each screen.

Many menu programs clear the screen one line at a time. These programs will not pause when the screen is cleared.

If the replay does not pause when the screen is cleared, examine the application screens for a string that appears near the bottom of every screen. Enter the string in the Pause On field in the Log File Replay dialog box.


Enter WordPerfect Mode from a Host Computer
 Entering WordPerfect Mode from a Host Computer

To enter WordPerfect 4.2 mode from the host computer, send one of the following commands:

CSI 3 ; 1 |

or

ESC [ 3 ; 1 |

To enter WordPerfect 5.x mode from the host computer, send one of the following commands:

CSI 5 | WP5 ON ST

or

ESC [ 5 | WP5 ON ESC \

A checkmark appears next to the appropriate WordPerfect command on the Execute menu when WordPerfect mode is on.


Terminate WordPerfect Mode from a Host Computer
 Terminating WordPerfect Mode from a Host Computer

To terminate WordPerfect mode from the host computer, send one of the following commands:

CSI 3 ; 0 |

or

ESC [ 3 ; 0 |


Overview
 About File Transfers

SolarNet Telnet for Windows supports several protocols for transferring files between your PC and a remote host. Click one of the following entries to display information about a file transfer protocol.

ASCII File Transfer Overview

Kermit File Transfer Overview

XMODEM File Transfer Overview

YMODEM File Transfer Overview

ZMODEM File Transfer Overview

Error-free file transfer protocols, which include Kermit, XMODEM, YMODEM, and ZMODEM, provide correct delivery of binary and ASCII information. One or more of these protocols are usually supported by host systems and bulletin boards. Use of an error-free protocol is recommended over ASCII transfers due to the increased performance and reliability.

Transferring files with an error-free file transfer protocol requires several transactions:

1.	Your PC opens a connection to a remote host and readies the host for file transfer.

2.	Your PC identifies the files to send or receive to the remote host.

3.	The file sender (PC or host) breaks the file into smaller pieces, called packets. The file sender transmits the file over the Telnet connection one packet at a time.

4.	The file recipient inspects each packet as it arrives; acknowledging those that are readable and rejecting (NAKing) those that are damaged. When the sender receives an acknowledgement for a packet, it sends the next packet to the recipient. If the sender receives a NAK for a packet, it sends the rejected packet again. If a packet is retransmitted and rejected too many times or if an acknowledgment is not received, the file transfer fails.

5.	When the file transfer is complete, the sender transmits an End of File message to the recipient.


Commands
 Kermit Commands

The following table lists the available Telnet Kermit commands. For a list of the commands available on your host Kermit, please see your host Kermit manual or help system.

Command	Function
BYE	Logout the host and exit to Windows
CONNECT	Return to Emulation mode
DOS	Execute DOS command
END	End Kermit server session
EXIT	Exit to Windows
FINISH	Tell server to exit
GET	Receive files from server
HELP	Lists Kermit commands
LOGOUT	Tell server to logout
RECEIVE	Non-server receive file
SEND	Sends file to remote Kermit


BYE

BYE (no arguments)

Tells the remote server to log out, exits Telnet, and terminates the host session. Same as the LOGOUT command.


CONNECT

CONNECT (no arguments)

Exits from Telnet Kermit mode and returns to host Kermit mode. Does not send any commands to the host Kermit. (Equivalent to clicking the Kermit button while in host Kermit mode).


DOS

DOS [DOS_command_string]

Displays a DOS Shell window.

If a DOS command string is not specified, an active DOS Shell window appears. Any valid DOS command can be entered at the DOS prompt. To exit from DOS, type EXIT.

If a DOS command is specified, an active DOS Shell window displays the result of the command. Click on the upper left corner of the window and select Close to return to emulation mode.

When a DOS command is issued by the host computer or from a command file, Telnet automatically returns without waiting for keyboard input.


END

END (no arguments)

Tells the host server to exit and returns to Emulation mode. The host returns to the Kermit prompt or to the system prompt. The action taken depends on the host Kermit implementation.


EXIT

EXIT (no arguments)

Exits to Windows without sending any commands to the host Kermit.


FINISH

FINISH (no arguments)

Tells the host server to exit. Telnet remains in Kermit mode. The host returns to the Kermit prompt or to the system prompt. The action taken depends on the host Kermit implementation.


GET

GET [switches] s-file [d-file]

Sends a GET command to the server. The server then sends the file(s) matching the s-file (source) specification to the PC.

The optional d-file (destination) specification renames the source file to the d-filename on the PC.

To receive multiple files, separate the filenames with commas or use wildcards.

Examples:	GET *.DAT    \DATA\*.*

GET *.DAT    \DATA\

GET *.DAT    \DATA

Transfers all .DAT files from the host to the \DATA subdirectory.

Options:

/END	Terminates server mode and returns to emulation mode after successful file transfer.

/EOF	Stores a DOS End of File character (Ctrl Z) as the last character of the files transferred.

/LOGOUT	Terminates the host session and returns to emulation mode after successful file transfer.


HELP

HELP (no arguments)

Displays help for the Kermit commands.


LOGOUT

LOGOUT (no arguments)

Tells the remote server to log out, exits Telnet, and terminates the host session. Same as the BYE command.


RECEIVE

RECEIVE [switches] [d-file]

Receives files from a host running Kermit in non-server mode. Before a RECEIVE command can be issued, the SEND command must be given to the host Kermit. Wildcarding is supported. When using wildcards in the host SEND command, do not specify a destination filename. A destination filename is only required if you wish to rename the host file being sent.

Example:	RECEIVE \DATA\

Transfers all files sent to the PC's \DATA subdirectory. When using the RECEIVE command, you must include the trailing backslash (\) on the path specification.

Options:

/EOF	Store a DOS End of File Character (Ctrl Z) as the last character of the file.


SEND

SEND [switches] s-file [d-file]

Sends the source files specified to the host Kermit. Works with server or non-server Kermit programs. If the host Kermit isn't in server mode, issue the RECEIVE command to the host Kermit before issuing the SEND command.

The file can be renamed or sent to a particular directory on the host by supplying the optional destination field.

Example:	SEND *.DAT [TEST]

Transfers all .DAT files to the [TEST] subdirectory on a VMS host.

If host directory strings are used in destination file specification, the host Kermit shouldn't translate filenames. To disable filename translation, issue the following command to the host Kermit: SET FILE NAMING UNTRANSLATED

Note:	The command's syntax may vary on other systems or it may not be supported.

Options:

/END	Terminates server mode and returns to emulation mode after successful file transfer.

/LOGOUT	Terminates the host session and returns to emulation mode after successful file transfer.

/NOEOF	Do not send an EOF (Ctrl Z) character to the host even if the Ctrl Z is in the DOS file.


Examples
 Kermit Command Line Examples

Receive File Examples

Example 1:	$KERMIT

Kermit:SERVER

Click on CMD

CMD:KERMIT

EM-Kermit:GET TEST.DAT

EM-Kermit:END

Kermit:EXIT

Receives the file TEST.DAT from the host, ends server mode and exits the host Kermit.

Example 2:	$KERMIT

Kermit:SERVER

Click on CMD

CMD:KERMIT GET/END ABC.DAT,DEF.DAT

Kermit:EXIT

Receives files ABC.DAT and DEF.DAT from the host, ends server mode and exits the host Kermit.

Example 3:	$KERMIT

Kermit:SERVER

Click on CMD

CMD:KERMIT GET/END *.*

Kermit:EXIT

Requests all the files in the host's default directory, ends server mode and exits the host Kermit.

Example 4:	$KERMIT

Kermit:SERVER

Click on KER

EM-Kermit:GET/END [VAXDIR]X.DAT

Kermit:EXIT

Receives file X.DAT from the VAX directory [VAXDIR], ends server mode and exits the host Kermit.

Example 5:	$KERMIT

Kermit:RECEIVE

Click on KER

EM-Kermit:GET TEST.TXT

EM-Kermit:CONNECT

Kermit:EXIT

Receives file TEST.TXT from the current host directory and exits the host Kermit.

Send File Examples

Example 1:	$KERMIT

Kermit:SERVER

Click on KER

EM-Kermit:SEND/END X.DAT [VAXDIR]X.DAT

Kermit:EXIT

Sends file X.DAT to the [VAXDIR] directory on the VAX, ends server mode and exits the host VAX Kermit.

Example 2:	$KERMIT

Kermit:RECEIVE

Click on KER

EM-Kermit:SEND \FILES\*.*

EM-Kermit:CONNECT

Kermit:EXIT

Sends all the files in the \FILES directory to the host, ends server mode and exits the host Kermit.

Example 3:	$KERMIT

Kermit:SERVER

Click on CMD

CMD:KERMIT

EM-Kermit:SEND TEST.DAT

EM-Kermit:END

Kermit:EXIT

Sends the file TEST.DAT to the host, ends server mode and exits the host Kermit.

Example 4:	$KERMIT

Kermit:SERVER

Click on CMD

CMD:KERMIT SEND/END ABC.DAT,DEF.DAT

Kermit:EXIT

Sends files ABC.DAT and DEF.DAT to the host, ends server mode and exits the host Kermit.

Example 5:	$KERMIT

Kermit:SERVER

Click on KER

Kermit:EXIT

Sends all the files in the \FILES directory to the host, ends server mode and exits the host Kermit.


File Formats
 Kermit File Formats

Kermit supports three types of file formats: text (ASCII), binary, and fixed length - 512 byte records. The default format is ASCII. If you are transferring files that are not text files, you must tell the Kermit program.

Specify binary when sending non-ASCII files that move between systems. Use binary when backing up a PC directory to a directory. WordPerfect document files also require binary format.

Use fixed format when moving executable files between systems or when 512 fixed length files are required.

Use the following host Kermit commands to set the file format when inside Kermit:

SET FILE TYPE ASCII

SET FILE TYPE BINARY

SET FILE TYPE FIXED


Transferring Files
 Transferring Files Using Kermit

Send/Server Mode

1.	Start Kermit on the host computer by entering the host command to execute Kermit.

2.	Put Kermit into server mode by typing SERVER.

3.	Enter EM-Kermit mode.

4.	Use the SEND command to send the desired files to the host.

5.	Type END to end server mode when all of the files have been transferred.

Send/Non-Server Mode

1.	Start Kermit on the host computer by entering the host command to execute Kermit.

2.	Type RECEIVE to put the host Kermit into receive mode.

3.	Enter EM-Kermit mode.

4.	Use the SEND command to send the desired files to the host.

5.	Return to host Kermit mode by typing CONNECT.

6.	Exit from the host Kermit program.


Receive/Server Mode

1.	Start Kermit on the host computer by entering the host command to execute Kermit.

2.	Put Kermit into server mode by typing SERVER.

3.	Enter EM-Kermit mode.

4.	Use the GET command to retrieve the desired file from the host.

5.	Type END when all the files have been transferred.

Receive/Non-Server Mode

1.	Start Kermit on the host computer by entering the host command to execute Kermit.

2.	Type SEND followed by the file specification.

3.	Enter EM-Kermit mode.

4.	Type RECEIVE to retrieve the files from the host.

5.	Exit EM-Kermit mode.

6.	Exit from the host Kermit program.

Additional Information

When transferring a file between the PC and a host (remote) computer system using ASCII mode, the following scenario usually takes place:

1.	A host utility program is started to receive or transmit ASCII data via the terminal port used by the PC.

Example:	TYPE filename

Sends data from a host file to the terminal port.

Copy TT: filename

Receives data from the terminal port into a file.

2.	The PC is instructed to send or receive data.

3.	The data is sent or received.

This process is automated with the ASCII protocol when Auto Command Mode is enabled (recommended).

Once the ASCII Transfer Setup is configured, only the filenames are required to transfer files. The host commands are issued automatically.

Telnet can connect to many types of host computers, though each type may require a different setup. Recommended settings for ASCII file transfer with many host systems are pre-programmed. Select the commands for a pre-programmed host through the Selected Hosts list box, then click the Set Defaults button. If your host system is not included the hosts list, you should be able to program the Auto Cmd Mode Setup for successful operation.


 File Send Selection Dialog Box

Function:	Specifies settings for file transfers. The fields and operation of the File Send Selection dialog box depends on the file transfer protocol you select.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the file transfer protocol you want to use to send the file to the remote host.

Click fields and buttons of dialog box to display help.

Note:	Throughout this section, when entering host commands is described, it is possible to avoid these steps by using Auto Command Mode.

See Also:

File Transfer Directory

Send File


 File Receive Selection Dialog Box

Function:	Specifies settings for incoming file transfers. The fields and operation of the File Receive Selection dialog box depends on the file transfer protocol you select.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the file transfer protocol you want to use to transfer files from the remote host.

Click fields and buttons of dialog box to display help.

Note:	Throughout this section, when entering host commands is described, it is possible to avoid these steps by using Auto Command Mode.

See Also:	File Transfer Directory

Receive File


File Transfer Directory

When you display the File Send or Receive Selection dialog boxes, the default file transfer directory is used to display the list of PC files. If the file transfer directory is changed, the new directory is remembered until you exit Telnet. When Telnet is restarted, the file transfer directory is set back to the default. Normally the default file transfer directory is the directory where Telnet was installed. However, the normal default can be overridden by updating a new file transfer directory in the Search Directories dialog box.


Receiving Files
Receiving Files with Kermit

To receive a file using the Kermit protocol:

1.	Start the host file transfer program.

Examples:	$KERMIT

Kermit:SERVER

Starts Kermit in Server mode on a VAX/VMS host.

$XMODEM

ST TEST.DAT

Starts XMODEM and starts sending the text file TEST.DAT.

2.	Pull down the File menu and choose Receive to display the File Receive Selection dialog box.

3.	Choose the transfer protocol that you want to use.

If are using Kermit, select Server or Non-Server mode.

4.	If the Host File name input box appears, enter the name of the host file to transfer. If the Host File name input box is not visible, enter the name for the PC file.

5.	If the host file is the same name as an existing PC file, you may select the host files using the mouse. To select files using the mouse, click the desired directory in the Directories list. Next, select a file from the File list by clicking the name once . Click the name again to deselect the file.

6.	Click the OK button to start the transfer. (If a filename is double-clicked, the file is selected and the transfer begins immediately.)

You may rename the file as it is transferred by entering a PC file name. A PC file name is not required, if left blank, the file name on the host computer will be the same as the host file name.

Normally, files are received from the host's default directory. However, you can receive files from a directory other than the default directory by including a host directory specification in the host file name specification. If you are using Kermit and wish to enter the host directory, you must have entered the host's Kermit command for literal file naming or Kermit will not translate the directory name correctly.

Kermit commands vary between hosts. However, here are two examples of setting literal file naming:

SET FILE NAMING UNTRANSLATED

SET FILE NAMING LITERAL

7.	Send the files.


Receive File Status Dialog Box

The Receive File Status dialog box is displayed while the transfer is in progress. The status box displays all or some of the following information depending on the protocol selected.

The From and To filenames.

The percentage of data transferred.

The estimated time of the transfer and the amount of time remaining in the transfer.

The transfer throughput in characters per second.

The byte count (in K-bytes) of data transferred.

The current packet count and packet size.

The number of times a packet has been retransmitted or NAKed.

The status of the transfer and error messages.

The file transfer can be aborted by clicking the Abort button.

To "roll-up" the Status dialog box, click the triangular-shaped arrow in the upper-right corner. The dialog box will roll up, and the percentage of the transfer will display in the caption. Click on the arrow again to unroll the dialog box.

Additional file transfer information will also appear in Telnet's message box. The message box is automatically popped up during file transfers.

After the file transfer is complete, click Done to return to emulation mode or click Close to return to the File Send Selection dialog box.


Sending Files

To send a file:

1.	Start the host file transfer program.

Examples:	$KERMIT

Kermit:SERVER

Starts Kermit in Server mode on a VAX/VMS host.

$XMODEM

RT TEST.DAT

Starts XMODEM and asks to receive the text file TEST.DAT.

2.	Pull down the File menu and choose Send to display the File Send Selection dialog box. Verify that the appropriate file transfer protocol is selected. If are using Kermit, select Server or Non-Server mode.

3.	Select the PC files to send by entering the PC file name or using the mouse. When entering the PC File Name, wildcards and path names can be used.

If wildcards are used, pressing Return updates the file list to display the selected files.

To select files using the mouse, click the desired directory in the Directories list. Next, select a file from the File list by clicking once on the name. Click on the name again to deselect the file.

To select multiple file individually, hold down the Ctrl key while clicking file names. To select a range of files, click and hold the mouse button on the first file, drag the mouse to include the last file, then release.

Note:	If a filename is double-clicked, the file is selected and the transfer begins immediately.

4.	If a Host File Name input box exists, you can rename the file as it is transferred by entering a valid host name. If the host file name is left blank, the file name on the host computer will be the same as the PC file name.

Normally, files are sent to the host's default directory. However, you may send the file to other than the default directory by editing the host file name to include the host's directory specification after selecting the files to send. If you are using Kermit and wish to enter the host directory, you must have entered the KERMIT command for literal file naming or Kermit will not translate the directory name correctly.

Kermit commands vary between hosts. However, here are two examples of setting literal file naming:

SET FILE NAMING UNTRANSLATED

SET FILE NAMING LITERAL

5.	Send the files.


Send File Status Dialog Box

The Send File Status dialog box is displayed while the transfer is in progress. The status box displays all or some of the following information depending on the protocol selected.

The From and To filenames.

The percentage of data transferred.

The estimated time of the transfer and the amount of time remaining in the transfer.

The transfer throughput in characters per second.

The byte count (in K-bytes) of data transferred.

The current packet count and packet size.

The number of times a packet has been retransmitted or NAKed.

The status of the transfer and error messages.

The file transfer can be aborted by clicking Abort. Aborting a file transfer may cause the Kermit server to exit server mode.

To "roll-up" the Status dialog box, click the triangular-shaped arrow in the upper-right corner. The dialog box will roll up, and the percentage of the transfer will display in the caption. Click on the arrow again to unroll the dialog box.

Additional file transfer information will also appear in Telnet's message box. The message box is automatically popped up during file transfers.

After the file transfer is complete, click Done to return to emulation mode or click Close to return to the File Send Selection dialog box.


 Kermit Send File Selection Dialog Box

Function:	Specifies settings for Kermit file transfers.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the Kermit file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the Kermit Setup is configured properly.


Sending Files in Kermit Server Mode

In Server mode, Telnet Kermit communicates with a host Kermit that is in server mode. This allows multiple file transfers without entering a host command each time.

Before attempting to send a file to the host computer system, be sure your Kermit settings are properly configured.

To send a file:

1.	Put the host into Server mode.

Example:	$ KERMIT

Kermit-32: SERVER

Starts the Server on a VAX/VMS host.

Note:	To send binary files, the host Server must be in binary mode. See your host Kermit documentation for detailed information.

2.	Pull down the File menu and choose Send. When the Send file selection dialog box appears, choose the Kermit file transfer protocol.


Sending Files in Kermit Non-Server Mode
Sending Files/Non-Server Mode

In Non-Server mode, only one file transaction can take place at a time. Also, the commands for the remote computer must be entered manually.

Before attempting to send a file to the host computer system, be sure your Kermit settings are properly configured.

To send a file:

1.	Prepare the host Kermit.

Example:	$ KERMIT

Kermit-32: RECEIVE

Host Kermit is ready to receive files.

2.	Pull down the File menu and choose Send. When the Send file selection dialog box appears, choose the Kermit file transfer protocol.


Protocol

Lists the protocols available for file transfer.


PC File Name

Select the PC files to send. Enter the filename into the PC File Name text box. Wildcards and path names can be used. If wildcards are used, pressing Return updates the File list to display the selected files.

To select files using the mouse, click the desired directory in the Directories list. Next, select a file from the Files list by clicking once on the name. Click on the name again to deselect the file.

Multiple sequential files can be selected by clicking the first file, dragging the cursor, and clicking the last file to select. Another option is to click the first file, press the Shift key and click the last file.

To select multiple non-sequential files, hold down the Ctrl key and click each file. To deselect a selected file, click the file while holding the Ctrl key.

Note:	If a filename is double-clicked, the file is selected and the transfer begins.


Host File Name

Enter the name of the file to be created on the host in the Host File Name input box. If the host filename is left blank, the host file is assigned the same name as the PC file.

To send multiple files to a host directory that is not the default directory, enter the host directory specification into the PC File Name input box. Do not include a file specification.


Non-Server

Selects non-server mode.


Server Options

End	Enabling END causes an END packet to be sent to the host after the file transfer. The END packet will cause the host Kermit to exit server mode. If Automatic End After Transfer is enabled in the Kermit Protocol Setup, enabling the END option is unnecessary.

Logoff	If enabled, a logoff packet is sent when the transfer is complete. The logout packet causes the host to exit Kermit, perform a user logout and disconnect.


End Button

When clicked, terminates Server mode and ends the file transfer.


No EOF

If enabled, a trailing Ctrl Z (EOF) is stripped from the file sent to the host.


File Information

Displays information specific to the selected file(s).


Invert Button

Inverts the selection of files.


Clear Button

Clears the selection of files.


Displays Windows' Connect Network Drive dialog box. This allows the user to connect to a shared directory when running Windows for Workgroups.


To send the selected file(s), click OK. Once the transfer begins, the Send File Status dialog box is displayed.


Displays the file transfer setup dialog box.


Exits the dialog box without performing a file transfer.


Displays Help on the file transfer selection dialog box. Click on any field to find helpful information.


File Send Status dialog box
{ [image] Send File Status Dialog Box

Function:	Displays information about a file transfer in process. The content of the Send File Status dialog box depends on the protocol being used.

Access:	Displayed automatically during a file transfer.

Click fields and buttons of dialog box to display help.

To "roll-up" the Status dialog box, click the triangular-shaped arrow in the upper-right corner. The dialog box will roll up, and the percentage of the transfer will display in the caption. Click the arrow again to unroll the dialog box.


From

The origin of the file(s) being transferred.


To

The destination of the file(s) being transferred.


Percentage

The percentage of data transferred.


Estimated Time

The estimated time of the transfer.


Time Remaining

The amount of time remaining in the transfer.


Throughput

The transfer throughput in characters per second.


Byte Count

The number of kilobytes of data transferred.


Block #

The current block count.


Block Size

The current block size.


Retries

The number of times Kermit has retransmitted or NAKed a packet.


Status

A Status (i.e., transferred or not transferred) and transfer time message is displayed for each file. If more than fifty messages appear, the oldest lines are discarded to make room for more. The top line of the Status box displays the message "Note: Prior messages have been discarded...".

Error messages may also appear in the Status box.


The file transfer can be aborted by clicking Abort. Aborting a file transfer may cause the Kermit server to exit server mode.


When the transfer is complete, click Close to return to the Send File Selection dialog box.


When the transfer is complete, click Done to return to emulation mode.


 Kermit Receive File Selection Dialog Box

Function:	Specifies settings for incoming Kermit file transfers.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the Kermit file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to receive a file from the host computer system, be sure the Kermit Setup is properly configured.


Receiving Files in Kermit Server Mode
Receiving Files/Server Mode

Before attempting to send a file to the host computer system, be sure the Setup - File Transfer - Kermit dialog box is properly configured.

To receive a file:

1.	Put the host into Server mode.

Example:	$KERMIT

Kermit:SERVER

Starts the Server on a VAX/VMS host.

2.	Pull down the File menu and choose Receive to display the Receive File Selection dialog box.


Receiving Files in Kermit Non-Server Mode
Receiving Files/Non-Server Mode

Before attempting to send a file to the host computer system, be sure the Setup - File Transfer - Kermit dialog box is properly configured.

To receive a file:

1.	Prepare the host Kermit to send files.

Example:	$KERMIT

Kermit:SEND

2.	Pull down the File menu and choose Receive to display the Receive File Selection dialog box.


Protocol

Lists the protocols available for file transfer.


Error Checking

Displays the method of error checking selected in the File Transfer Setup.


Host File Name

Select the file to receive. Enter the filename into the From input box. A complete host directory and file specification can be entered. Wildcards are supported.


PC File Name

Enter the name of the host file to be created or overwritten on the PC into the PC File Name input box. If the host filename is left blank, the PC file is assigned the same name as the host file. If the host filename is an invalid PC filename, then a PC filename must be specified.


Server

The following options can be enabled before receiving files.

End	Automatically terminates Server mode when the transfer is complete.

Logout	Automatically terminates Server mode and logs off the host.


Add EOF

Adds a DOS EOF (Ctrl Z) as the last character of the files transferred.


File Information

Displays information specific to the selected file(s).


End Button

To terminate Server mode and end the transfer, click End.


Invert Button

Inverts the selection of files.


Clear Button

Clears the selection of files.


Displays Windows' Connect Network Drive dialog box. This allows the user to connect to a shared directory when running Windows for Workgroups.


To receive the selected files, click Receive. Once the transfer begins, the Receive File Status dialog box is displayed.


Displays the file transfer setup dialog box.


Exits the dialog box without performing a file transfer.


Displays Help on the file transfer selection dialog box. Click on any field to find helpful information.


 Receive File Status Dialog Box

Function:	Displays information about the status of an incoming file transfer.

Access:	Displayed automatically during an incoming file transfer.

Click fields and buttons of dialog box to display help.

To "roll-up" the Status dialog box, click the triangular-shaped arrow in the upper-right corner. The dialog box will roll up, and the percentage of the transfer will display in the caption. Click on the arrow again to unroll the dialog box.

Additional file transfer information will also appear in Telnet's message box. The message box is automatically popped up during file transfers.


From

The origin of the file(s) being transferred.


To

The destination of the file(s) being transferred.


Percentage

The percentage of data transferred.


Elapsed Time

The amount of time that the transfer has taken.


Throughput

The transfer throughput in characters per second.


Byte Count

The number of kilobytes of data transferred.


Block #

The current block count.


Block Size

The current block size.


Retries

The number of times Kermit has retransmitted or NAKed a packet.


The file transfer can be aborted by clicking Abort. Aborting a file transfer may cause the Kermit server to exit server mode.


When the transfer is complete, click Close to return to the Send File Selection dialog box.


When the transfer is complete, click Done to return to emulation mode.


Send Command Strings

The send file commands are used to start a utility on the host that creates a file and receives data from the terminal port. Some commonly used utilities are Create, Copy, and text editors in Line Insert mode.

The following special symbols are used to program the send file command field:

Normally, * is the only symbol used in programming commands. The # and ~ are available to add flexibility.

Note:	If the only command in the command line field is ~ (Send/Receive data symbol), data is sent without sending the carriage return. By default, a carriage return is always sent.

Example 1:	COPY TT: *

Sends:	Copy TT: filename

File data

EOF String

Example 2:	EDIT #

INSERT

~

Sends:	EDIT filename

INSERT

File data

EOF String

Example 3:	COPY TT: *

PRINT #

Sends:	COPY TT: filename

File data

EOF String

PRINT filename

If a data transmit symbol (* or ~) is not encountered while sending the send file commands, the data is sent after the last command.


Receive Command Strings

The receive commands are used to start a utility on the host that sends a file to the terminal port. Some commonly used utilities are Copy and Type.

The following special symbols are used to program the receive command field:

Normally the * is the only symbol used in programming commands. The # and ~ are available to add flexibility.

Note:	If the only command in the command line field is ~ (Send/Receive data symbol) data is received without sending the carriage return. Blanking the commands field sends a carriage return.

Example:	Type *

Sends: Type filename


 XMODEM Send File Selection Dialog Box

Function:	Specifies settings for XMODEM file transfers.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the XMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the XMODEM Setup is configured properly.


XMODEM Overview
 XMODEM File Transfer Overview

Before using XMODEM, an XMODEM file transfer program must be installed on the host computer system.

XMODEM can be operated in Auto or Manual mode. Manual mode requires the host XMODEM startup and transfer commands to be entered before transferring a file. In Auto mode (the normal mode), Telnet issues all of the XMODEM host transfer commands. You supply only the filenames.

See Also:	XMODEM File Transfer Setup Dialog Box

XMODEM Send File Selection Dialog Box

XMODEM Receive File Selection Dialog Box


 XMODEM Receive File Selection Dialog Box

Function:	Specifies settings for incoming XMODEM file transfers.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the XMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to receive a file from the host computer system, be sure the XMODEM Setup is properly configured.


YMODEM Overview
 YMODEM File Transfer Overview

Before using YMODEM, a YMODEM file transfer program must be installed on the host computer system.

YMODEM can be operated in Auto or Manual mode. Manual mode requires the host YMODEM startup and transfer commands to be entered before transferring a file. In Auto mode (the normal mode), Telnet issues all of the YMODEM host transfer commands. You supply only the filenames.

See Also:	YMODEM File Transfer Setup Dialog Box

YMODEM Send File Selection Dialog Box

YMODEM Receive File Selection Dialog Box


 YMODEM Send File Selection Dialog Box

Function:	Specifies settings for YMODEM file transfers.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the YMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the YMODEM Setup is configured properly.


 YMODEM Receive File Selection Dialog Box

Function:	Specifies settings for incoming YMODEM file transfers.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the YMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to receive a file from the host computer system, be sure the YMODEM Setup is properly configured.


ZMODEM Overview
 ZMODEM File Transfer Overview

ZMODEM can be operated in Auto or Manual mode. Manual mode requires the host ZMODEM startup and transfer commands to be entered before transferring a file. In Auto mode (the normal mode), Telnet issues all of the ZMODEM host transfer commands. You supply only the filenames.

ZMODEM receives can be initiated automatically by a host or bulletin board computer system when Telnet is in emulation mode. If Telnet receives a ZMODEM transfer command and the Automatic Download Start option is enabled, Telnet will automatically begin to transfer the files.

Before using ZMODEM, a ZMODEM file transfer program must be installed on the host computer system.

See Also:	ZMODEM File Transfer Setup Dialog Box

ZMODEM Send File Selection Dialog Box

ZMODEM Receive File Selection Dialog Box


 ZMODEM Send File Selection Dialog Box

Function:	Specifies settings for ZMODEM file transfers.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the ZMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the ZMODEM Setup is configured properly.


 ZMODEM Receive File Selection Dialog Box

Function:	Specifies settings for incoming ZMODEM file transfers.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the ZMODEM file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to receive a file from the host computer system, be sure the ZMODEM Setup is properly configured.


ASCII Overview
 ASCII File Transfer Overview

ASCII transfer moves text files between computer systems using standard file utilities. ASCII transfers are not guaranteed to be error free and should only be used for sending or receiving text files (that is, files that do not contain binary coded information).

When transferring a file between the PC and a host (remote) computer system, the following scenario usually takes place:

1.	A host utility program is started to receive or transmit ASCII data via the terminal port used by the PC.

Example:	TYPE filename

Sends data from a host file to the terminal port.

Copy TT: filename

Receives data from the terminal port into a file.

2.	The PC is instructed to send or receive data.

3.	The data is sent or received.

This process is automated with Telnet's ASCII file transfer system. Once ASCII Setup has been configured, only the filenames are required to transfer files. Telnet issues the host commands automatically.

See Also:	ASCII File Transfer Setup Dialog Box

ASCII Send File Selection Dialog Box

ASCII Receive File Selection Dialog Box

Send File Status Dialog Box

Send Command Strings

Sending Files/Manual Mode

Sending Files/Auto Mode


 ASCII Send File Selection Dialog Box

Function:	Specifies settings for ASCII file transfers.

Access:	Pull down the File menu and choose Send. When the File Send Selection dialog box appears, choose the ASCII file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the ASCII Setup is properly configured.


 ASCII Receive File Selection Dialog Box

Function:	Specifies settings for incoming ASCII file transfers.

Access:	Pull down the File menu and choose Receive. When the File Receive Selection dialog box appears, choose the ASCII file transfer protocol.

Click fields and buttons of dialog box to display help.

Before attempting to send a file to the host computer system, be sure the Setup - File Transfer - ASCII dialog box is properly configured.


Kermit Overview
 Kermit File Transfer Overview

The Kermit file transfer program lets you move files between machines of different architectures and operating systems.

How To...

Transfer Files Using Kermit

Receiving Files in Server Mode

Receiving Files in Non-Server Mode

Abort Kermit Transfers

Reference

Kermit Commands

Command Line Examples

File Formats

Receive File Selection Dialog Box

Receive File Status Dialog Box

File Send Selection Dialog Box

Send File Status Dialog Box

Receive File Status Dialog Box

Before you use Kermit, you should verify that a Kermit file transfer program is installed on the host computer.


Cancelling a File Transfer
 Cancelling a Kermit File Transfer

You can cancel a Kermit file transfer by clicking the Abort button on the Telnet status line. Aborting a transfer may cause the Kermit server to exit server mode.


Glossary

A	ANSI

ASCII

Asynchronous

B	Baud

Binary

Bit

Byte

C	Character Attributes

Character Sets

Cursor

D	Default

Default Directory

Dialog Box

DEC Multinational Character Set

DEC Special Graphics Character Set

DEC Supplemental Graphics Character Set

Download

E	Echo

F	Full-Duplex

H	Half-Duplex

Hardcopy

Host System

I	ISO Latin-1 Supplemental Set

Instance

K	K-Byte (KB)

Kermit

L	Local Echo

M	Mode

Modem

N	National Replacement Character Sets (NRC)

O	Online

P	Packet

Parity Bit

Port

Protocol

R	Remote Host

Remote Server

Root Directory

S	Scrollback

Server Mode

Softkey

Strapable Options

T	Transparent Mode

U	Upload

X	XMODEM


ANSI

American National Standards Institution. The standard command codes for color and character attributes.


ASCII

American Standard Code for Information Interchange. ASCII is the character set used by most computers.


Asynchronous

A communications mode that uses variable time intervals between characters in a message.


Baud

A unit of data communications rate that signifies the speed of the transmitted data bits. One bit of data per second equals one baud. 1200 bits of data per second equals 1200 baud.


Binary

The method of representing numbers in base two.


Bit

Bit is short for binary digit. A bit is the smallest information unit in a computer system. The value of a bit is either 0 or 1. Eight bits equals one byte.


Byte

A sequence of eight adjacent bits operated upon as a unit.


Character Attribute

Display features that affect the appearance of characters on the screen, (i.e., bold, blink, underline,...)


Character Set

A group of graphics characters stored as a unit in the terminal.


Cursor

A bar of light indicating where the next character is going to appear on the screen.


Default

The standard setting used if no options are chosen or if a necessary parameter is omitted.


Default Directory

The current DOS directory. It is the directory used for file operations if no other directory path is specified.


Dialog Box

A box that either requests or provides information. Some present warnings or explain why a command can't be completed. Dialog box is used synonymously with menu.


DEC Multinational Character Set

Telnets default character set. The DEC Multinational set consists of the ASCII and DEC Supplemental sets.


DEC Special Graphics Character Set

The DEC Special Graphics set is comprised of ASCII characters and special symbols. It is also referred to as the VT100 Line Drawing Character set.


DEC Supplemental Graphics Character Set

One of two character sets that comprise the DEC Multinational set. The DEC Supplemental set contains foreign characters and special symbols.


Download

The movement of files from the host to Telnet.


Echo

The character that appears on the screen in response to a typed character indicating that the computer has received and processed the data sent to it.


Full-Duplex

A data link capable of carrying data in both directions simultaneously.


Half-Duplex

A data link capable of carrying data in only one direction at a time.


Hardcopy

A permanent copy of the displayed data. Hardcopy usually refers to a print or plot.


Host System

A computer or terminal server that is connected to Telnet.


ISO Latin-1 Supplemental Character Set

An eight-bit multinational character set. The ISO Latin-1 set consists of 96 graphics characters, most of which are similar to the DEC Supplemental Graphics set. This set can only be used in VT300 mode.


Instance

An active connection between Telnet and a host.


K-Byte (KB)

Kilobyte. A kilobyte is equal to 1024 bytes of information.


Kermit

A file transfer protocol, developed by Columbia University. Kermit is designed to support file transfer between nearly all types of computer systems.

Kermit ensures reliable, error-free transmissions, despite telephone and data line noise.


Local Echo

Online response of a character within the terminal that is indicated on the display. Local Echo is required in lieu of computer response echo.


Mode

The operating state of the terminal.


Modem

A contraction of the words modulator-demodulator. A modem modulates and demodulates signals transmitted and received over a phone line. A modem is used at the host and terminal end of a connecting telephone line.


National Replacement Character Set (NRC)

Telnet supports twelve NRC sets. Each 7-bit character set contains 94 graphic characters. The NRC sets resemble the ASCII character set. However, some ASCII characters are replaced for a particular European language or dialect,


Online

The state of operation in which Telnet can communicate with the host system.


Packet

A Kermit file transfer term defined as a piece of file or document. Kermit breaks a file into groups of information, called packets, before transmission. When all the packets are received, the file transfer is complete.


Parity Bit

In 7-bit data communications, the eighth bit in a byte used for error detection. A parity bit is added to the end of a byte so the total number of 1s is either always even (even parity), or odd (odd parity); and the total number of bits is eight.


Port

The portion of the computer used for transmission or reception of data.


Protocol

A set of rules governing orderly communications between devices.


Remote Host

The terminal or mainframe that is communicating with Telnet.


Remote Server

A remote host in server mode.


Root Directory

The directory that the PC starts in immediately after booting.

Example:	C:\


Scrollback

A feature that allows a user to view text that has scrolled off the screen.


Server Mode

A state of readiness for unlimited file transfer. Without server mode, only one file transaction can take place.

Server mode must be exited when file transfer is complete.


Softkey

A softkey is a function key that can be loaded with ASCII text strings. Each string can contain control characters, delays, programming commands or references to command files.

When a softkey is pressed, the softkey string is transmitted to the communications port and any softkey commands encountered are executed.


Strapable Options

Strapable options are standard options that involve a simple wired plug that can be easily changed.


Transparent Mode

An operating mode that displays control codes as graphic characters, in order to debug applications. Transparent mode is also known as Displays Control mode.


Upload

The movement of files from Telnet to the host.


XMODEM

A communications protocol used for file transfer. XMODEM is a public domain protocol written by Ward Christiansen.


Keyboard Layouts
Keyboards

SolarNet Telnet for Windows supports several PC keyboards, including the following:

AT Keyboard

DEC LK250/LK450 Keyboards

Enhanced Keyboard

You use the the Keyboard Type dialog box to select the type of keyboard you want to use.

See Also:	Token List


Keyboard Token List
Token List

PC keys activate emulator functions and send VT320 control sequences to the host. The emulator uses the concept of keys and tokens to map keystrokes to VT320 control sequences. Keys are physical PC keyboards. Tokens are mnemonics that represent Telnet or VT320 functions.

VT320 functions exist on the VT320 keyboard and are emulated by SolarNet Telnet for Windows. PF1 and Setup are examples of VT320 function keys. The following table identifies the default VT320 token associated with keys on the VT320 keyboard.

VT320 Token	VT320 Key
BACKSPACE	Backspace
COMPOSE	Compose
DELETE	Delete
DO	Do
ESCAPE	Escape
FIND	Find
HOLD SCREEN	Hold screen
INSERT HERE	Insert here
LINE FEED	Line feed
NULL	Null
NEXT SCREEN	Next screen
PREVIOUS SCREEN	Previous screen
REMOVE	Remove
SELECT	Select
VT HELP	Help
KP0 - KP9	Keypad 0 - 9
KP COMMA	Keypad comma
KP ENTER	Keypad enter
KP MINUS	Keypad minus
KP PERIOD	Keypad period
PF1 - PF4	PF1 - PF4
UP ARROW	Up arrow
DOWN ARROW	Down arrow
LEFT ARROW	Left arrow
RIGHT ARROW	Right arrow
UDK1 - UDK20	UDK 1-20
VTF6-VTF20	F6 - F20

Telnet functions are unique to the SolarNet Telnet for Windows application and do not correspond to keys on a VT320 keyboard. For example, Kermit is a Telnet function. The following table identifies the function of each emulator token.

Emulator Token	Emulator Function
ANSWERBACK	Send answerback message
BREAK	Send a short break
CMD	Emulator command line
DDE	DDE command line
DEBUG	Debug on/off
DROP_DTR	Drops DTR for 2 seconds
EDIT COPY	Copy selected text to Clipboard
EDIT PASTE	Paste information from Clipboard
EDIT SEND	Send selected text to host
EXIT	Exit the emulator
4014 MODE	Enter TEK 4014 mode (Tektronix only)
HELP	Help
KERMIT	Kermit command line
KP NUMLOCK	Keypad Numeric toggle
KP NUMERIC	Keypad top numeric mode
KP FUNCTION	Keypad top function mode
LINE EDIT	Line edit mode
LONG BREAK	Sends a long break
LOG	Log File
MAX WORKSPACE	Toggle maximizes the workspace
MODEM DIALER	Modem Dialer dialog box
PRINT AUTO	Continuous print mode (auto)
PRINT CONTINUE	Continuous print mode
PRINT CONTROL	Controller print mode
PRINT SCREEN	Print contents of the screen
REPLAY LOG	Log file replay
SOFTKEY 1 - 12	Softkey 1 - Softkey 12
VT MODE	VT terminal mode


AT Keyboard Layout
AT Keyboard

To use the AT keyboard, open the Keyboard Type dialog box and select AT.

The following table lists the default VT320 tokens for the AT keyboard. Note that you can use the Key Mapping dialog box to change the VT320 token associated with a function key or key combination.

VT320 Token	Key
PF1	Esc
PF2	Num Lock
PF3	Scroll Lock
PF4	Sys Req
KP0 - KP9	Keypad 0 - 9
KP COMMA	Keypad Minus
KP ENTER	Keypad Plus
KP MINUS	PrtSc
KP PERIOD	Keypad Period
DO	Alt Scroll Lock
FIND	Alt Keypad 7
INSERT HERE	Alt Keypad 8
NEXT SCREEN	Alt Keypad 6
PREVIOUS SCREEN	Alt Keypad 5
REMOVE	Alt Keypad 9
SELECT	Alt Keypad 4
VT HELP	Alt Num Lock
UP ARROW	Shift Keypad 8 or F5
DOWN ARROW	Shift Keypad 2 or F6
LEFT ARROW	Shift Keypad 4 or F7
RIGHT ARROW	Shift Keypad 6 or F8
BACKSPACE	Shift Del
COMPOSE	Alt F1
DELETE	Del
HOLD SCREEN	F1
LINE FEED	Shift Return or F4
PRTAUTO	Alt F4
PRTSCR	F4
UDK6 - UDK10	Alt Shift 6 -0
UDK11 - UDK20	Alt Shift Q - P
VTF6 - VTF10	Alt 6 - 0
VTF11 - VTF20	Alt Q - P
The following table lists the default Telnet tokens for the AT keyboard. Note that you can use the Key Mapping dialog box to change the Telnet token associated with a function key or key combination.

Telnet Token	Key
ABORT	Alt A
BREAK	Alt B
CMD	Alt C
DEBUG	Alt F10
DROP_DTR	Alt D
ESC	F2
KERMIT	Alt K
LONG BREAK	Alt Shift B
LOG	Alt L
MODEM DIALER	Alt M
REPLAY	Alt ;
SCRBCK	Alt S
SOFTKEY 1 - 12	Ctrl F1 - F12


DEC LK250 Keyboard Layout
DEC LK250/LK450 Keyboards

The DEC LK250/LK450 keyboards provide perfect DEC VT320 function key emulation. To use the DEC LK250 or LK450 keyboard, open the Keyboard Type dialog box and select LK250 or LK450.

Note:	When these keyboards are used on an IBM AT or compatible, the emulator automatically switches the keyboard between DEC and PC Mode. However, the PC or XT cannot send the mode switch command to the keyboard. If you are using the LK250 or LK450 on a PC or XT, use Alt F17 to switch the keyboard between modes manually.

The following table lists the default VT320 tokens for the DEC LK250 and LK450 keyboards. Note that you can use the Key Mapping dialog box to change the VT320 token associated with a function key or key combination.

VT320 Token	Key
PF1 - PF4	PF1 - PF4
KP0 - KP9	Keypad 0 - 9
KP COMMA	Keypad Comma
KP ENTER	Keypad Enter
KP MINUS	Keypad Minus
KP PERIOD	Keypad Period
DO	Do
FIND	Find
INSERT HERE	Insert Here
NEXT SCREEN	Next
PREVIOUS SCREEN	Prev
REMOVE	Remove
SELECT	Select
VT HELP	Help
UP ARROW	Up Arrow
DOWN ARROW	Down Arrow
LEFT ARROW	Left Arrow
RIGHT ARROW	Right Arrow
BACKSPACE	Shift Backspace
COMPOSE	Alt Compose
DELETE	Backspace
HOLD SCREEN	F1
LINE FEED	Shift Return
PRTAUTO	Alt F2
PRTSCR	F2
UDK6 - UDK20	Shift F6 - F20
VTF6-VTF20	F6 - F20
The following table lists the default Telnet tokens for the DEC LK250 and LK450 keyboards. Note that you can use the Key Mapping dialog box to change the Telnet token associated with a function key or key combination.

Emulator Token	Key
ABORT	Alt A
BREAK	Alt B
CMD	Alt C
DEBUG	Alt `
DROP_DTR	Alt D
ESC	Compose
KERMIT	Alt K
LONG BREAK	Alt Shift B
LOG	Alt L
MODEM DIALER	Alt M
REPLAY	Alt ;
SCRBCK	Alt S
SOFTKEY 1 - 12	Ctrl F1 - F12


Enhanced Keyboard Layout
Enhanced Keyboard

The Enhanced keyboard closely resembles an actual VT320 keyboard. Therefore, the emulator can provide near-perfect VT320 keyboard emulation.

To use the Enhanced keyboard, open the Keyboard Type dialog box and select Enhanced.

The following table lists the default VT320 tokens for the Enhanced keyboard. Note that you can use the Key Mapping dialog box to change the VT320 token associated with a function key or key combination.

VT320 Token	Key
PF1	Num Lock
PF2	Keypad Slash
PF3	Keypad Asterisk
PF4	Keypad Minus
KP0 - KP9	Keypad 0 - 9
KP COMMA	Pause
KP ENTER	Keypad Enter
KP MINUS	Keypad Plus
KP PERIOD	Keypad Period
DO	Scroll Lock
FIND	Insert
INSERT HERE	Home
NEXT SCREEN	Page Down
PREVIOUS SCREEN	End
REMOVE	Page Up
SELECT	Delete
VT HELP	F5
UP ARROW	Up Arrow
DOWN ARROW	Down Arrow
LEFT ARROW	Left Arrow
RIGHT ARROW	Right Arrow
BACKSPACE	Shift Backspace
COMPOSE	Alt ESC
DELETE	Backspace
HOLD SCREEN	F1
LINE FEED	Shift Enter
PRTAUTO	Alt F2
PRTSCR	F2
UDK6 - UDK12	Shift F6 - F12
UDK13 - UDK20	Alt Shift F3 - F10
VTF6 - VTF12	F6 - F12
VTF13 -VTF20	Alt F3 - F10
F4	VTF14
F5	VTF15 (Help)
Alt F6-Alt F10	VTF16-VTF20

The following table lists the default Telnet tokens for the Enhanced keyboard. Note that you can use the Key Mapping dialog box to change the Telnet token associated with a function key or key combination.

Telnet Tokens	Key
ABORT	Alt A
BREAK	Alt B
CMD	Alt C
DEBUG	Alt `
DROP_DTR	Alt D
ESC	Escape
KERMIT	Alt K
LONG BREAK	Alt Shift B
LOG	Alt L
MODEM DIALER	Alt M
REPLAY	Alt ;
SOFTKEY 1 - 12	Ctrl F1 - F12


Modem Dialer
Using the Modem Dialer

SolarNet Telnet for Windows includes a modem dialer that supports all Hayes and Hayes-compatible modems. You can program non-Hayes-compatible modems by typing modem commands on the keyboard or by storing them in emulator command files.

The Phone Book linked to the modem dialer can store up to 15 numbers in a phone directory. You can use the dial a number, answer an incoming call, and hang up a connection. Telnet for Windows supports only one Phone Book. You cannot create a separate Phone Book for each setup file.

How To...

Dial the Modem

Dialing via a Phone Book Entry

Dialling a Manually Entered Number

Dialing with the Emulator Keyboard

Cancel a Call in Progress

Hang Up a Connection


Dialing
Dialing the Modem

You can dial your modem by selecting a Phone Book Entry or by dialling a manually entered telephone number in the Alternate Dial text box of the Modem Dialer dialog box.

Once a connection is established, Telnet for Windows automatically returns to Emulation mode. If the Phone Book entry includes a setup file, Telnet loads the setup file before dialing. If the entry includes a command file or softkey reference, Telnet executes the file or softkey as soon as it enters emulation mode.

If a connection is made, the following messages appears:

Connected to "name"

Connection successful (then)

Returning to emulation mode

If a connection cannot be made, the following message appears:

No connection - call failed

The Modem Dialer sends several commands to the modem when dialing a number to ensure that the modem is in the correct programming state. As a result, once the Modem Dialer is used, the modem does not echo modem commands and reports status as numeric digits.

To restore the modem to its default state, send the modem a reset command from the keyboard by typing ATZ while in emulation mode.

See Also:	Dialing with the Emulator Keyboard


Select Phone Book Entry
Selecting a Phone Book Entry

To select an entry from the Phone Book:

1.	Choose the Select Phone Entry button to display the Phone Book Entry Selection dialog box.

2.	Choose the Phone Book entry you want to use.

3.	Click the OK button. The entry you selected appears in the Modem Dialer.

4.	Click the Dial button. The following Status box messages appear:

Calling "name"

Dialing "number"


Alternate Dial
Entering a Telephone Number Manually

The Alternate Dial text box lets you enter a modem phone number directly into the Modem Dialer dialog box. For example, you always try dialing Phone Book entry 1 first. If it is busy, you choose a second number. Entering an Alternate Dial number gives immediate access to both modem numbers at once.

To dial a manually entered telephone number:

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Enter the telephone number you want the modem to dial in the Alternate Dial Number text box.

3.	Click the <<Dial button, which is to the immediate right of the Alternate Dial Number text box.

Do not click the Dial button in the upper right corner of the Modem Dialer dialog box.


Aborting a Call
Cancelling a Call in Progress

To cancel a call in progress, choose the button in the Modem Dialer dialog box.

You cannot cancel a call after the connection has been completed and the following message appears:

Connection successful


Hanging Up a Connection

To hang up (terminate) a Telnet connection, click the Hang Up button on the Modem Dialer dialog box. The following message appears:

Hanging up connection

Telnet attempts to hang up the modem by dropping DTR. If this is unsuccessful, the program sends a series of disconnect commands to the modem. This insures that the Modem Dialer can hang up all Hayes-compatible or nearly Hayes compatible modems.

If the hang up is successful, the following message appears:

Call terminated

If the program senses that the Carrier Detect line from the modem is still on after performing the hang up sequence, the following message appears:

Hang up failed


Answer Incoming Call
Answering an Incoming Call

You can configure the Modem Dialer to answer an incoming call from another computer. To answer an incoming call:

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Choose the Answer button.

Telnet for Windows sends configuration commands to your modem to configure it to answer an incoming call. The following message appears in the Status field.

Waiting for incoming call - (click ABORT to cancel)

3.	When the modem reports that it has accepted an incoming call, Telnet for Windows displays the following message in the Status field:

Call answered - returning to emulation mode

You can use the Modem Setup dialog box to configure your modem to answer incoming calls automatically. Refer to your modem documentation for the correct command to use for auto-answer mode.


Add Phone Book Entry
Adding a Phone Book Entry

To add an entry to the Phone Book.

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Click the Edit Phone Book button to open the Phone Book dialog box.

3.	Select one of the entries in the scrolling list.

Entries that are currently unused have <unspecified> in the name and telephone number fields.

4.	(Optional) Enter the name of the connection in the Name text box.

The name must start with an alphabetical character but can include any non-control character. Names for Phone Book entries can be up to 15 characters in length.

5.	Enter the telephone number to be dialed in the Number text box.

The phone number can include spaces or dashes for readability. A comma can be entered to specify a delay. The maximum length is 35 characters.

Softkey references can be included to insert a phone card number or other information into a dialing sequence.

Phone numbers are normally dialed using tone dialing. If you are using a pulse-dialed telephone line, enter P as the first character of the telephone number string.

6.	(Optional) Enter the name of a command file in the Command File text box.

Command filenames can be up to eight characters long. Do not enter a filename extension: the default .ECF extension is assumed. If a command file is entered, it will be executed automatically when the Phone Book entry is used.

7.	(Optional) Enter the name of a setup file in the Settings File text box.

If a setup file is entered, it will be loaded before dialing the number.

8.	Click the Accept Changes button to record the new Phone Book entry.

9.	When you are finished entering Phone Book entries, click the OK button.


Edit Phone Book Entry
Editing a Phone Book Entry

To edit a Phone Book entry:

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Click the Edit Phone Book button to open the Phone Book dialog box.

3.	Select the entry you want to edit from the scrolling list.

4.	Update the information associated with the Phone Book entry.

5.	Click the Accept Changes button to store the updated entry information.

6.	When you are finished editing Phone Book entries, click the OK button.


Delete Phone Book Entry
Deleting a Phone Book Entry

To delete a Phone Book entry:

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Click the Edit Phone Book button to open the Phone Book dialog box.

3.	Select the entry you want to delete from the scrolling list.

4.	Click the Delete button.

5.	Click the OK button to modify the Phone Book file.


Clear Phone Book
Clearing the Phone Book

To clear the entire Phone Book:

1.	Open the Modem Dialer dialog box by pulling down the Connect menu and choosing Dial or by clicking the Modem Dialer icon on the Telnet toolbar.

2.	Click the Edit Phone Book button to open the Phone Book dialog box.

3.	Select the entry you want to edit from the scrolling list.

4.	Click the Clear All Phone Book Entries button.

A box appears with the following notice:

Are you sure you want to erase all your phone book entries?

5.	Click the Yes button to confirm that you want to clear the Phone Book.

6.	When you are finished, click the OK button.


Using Softkeys in Phone Book
Using Softkeys in Phone Book Entries

You can include softkeys within Phone Book entries to include telephone access codes and credit card dialing information in dialing strings.

To place a Softkey reference into a number, use the following syntax:

<S:n>, where n is the number of the Softkey string.

For example, assume that you want to use a softkey to disable call waiting on your telephone line. You would define a softkey (1) for the modem command *70. You would then include the softkey reference in the dial string for a Phone Book entry: <S:1>1709-444-9999. When the entry containing this number is dialed, Softkey 1 is expanded and the command to disable call waiting is sent to the telephone system before the telephone number is dialed.


Modem Switches

When using a modem, enable the Modem Control option in the Port Setup dialog box.

Note:	If Modem Control is disabled, the Modem Dialer does not monitor the Carrier Detect line from the modem. This allows dialing on communications systems or modems that force Carrier Detect on.

The following are the recommended settings for Hayes-compatible modems:

Select DTR support

Select English result codes (vs. Numeric)

Enable result codes

Enable answering incoming calls

Enable Carrier Detect to reflect the connection status (vs. Forced high)


Use Keyboard To Dial
Using the Keyboard to Dial

You can dial telephone numbers from within Emulation mode by typing modem commands on the keyboard. For example, typing ATDT5552222 followed by a carriage return instructs a Hayes-compatible modem to dial the number 555-2222.

Consult your modem documentation for a complete list of the commands your modem recognizes.

Note:	Some modems require uppercase letters. If necessary, set Caps Lock on before dialing from the keyboard.


Troubleshooting

If you have been unable to communicate successfully with the host computer or with your modem, here are some of the common solutions.

No response when any key is pressed

  Incorrect COM (serial) port selected in the Port Setup dialog box.

  Incorrect baud rate selected in the Port Setup dialog box.

  Flow control is off on the Host system. Press Ctrl Q (Xon) to clear the flow control.

  More than one serial communications interface is assigned the same COM port. Look at the jumpers on the serial board to make sure that each is set for a unique COM port. Consult the serial board documentation.

  Incorrect RS232 cable. Try another cable, or try attaching a "null modem" cable.

Garbage characters appear on the screen

  A DOS memory resident program or a Windows background program is causing a conflict. Or, there may be interrupt conflicts from a caching program, keyboard driver or screen saver. Try removing all TSRs and drivers from CONFIG.SYS and AUTOEXEC.BAT memory. Exit all other Windows programs. If this fixes the problem, reload each individually (or in small groups), until the conflicting program is discovered.

  Incorrect baud rate selected the Port Setup dialog box.

  Incorrect parity selection. Most full screen editors require the emulator to be set to 8-bits/ No parity, or 7-bits/Space parity. Be sure the host and the emulator are set to the same combination.

  Bad modem connection.

Dropping characters

  The host system does not use Xon/Xoff flow control. Reduce the baud rate.

  A DOS memory resident program or a Windows background program is causing a conflict. Or, there may be interrupt conflicts from a caching program, keyboard driver or screen saver. Try removing all TSRs and drivers from CONFIG.SYS and AUTOEXEC.BAT memory. Exit all other Windows programs. If this fixes the problem, reload each individually (or in small groups), until the conflicting program is discovered.

  The PC has a hardware problem. If possible, try running the emulator on another PC.

  More than one serial communications interface is assigned the same COM port. Look at the jumpers on the serial board to make sure that each is set for a unique COM port. Consult the serial board documentation.

Modem does not respond or "Modem not ready or did not respond correctly" appears when dialing a number using the modem dialer

  Modem is not connected properly.

  Incorrect baud rate selected in the Port Setup dialog box.

  Modem requires uppercase commands.

  Modem needs to be reset. Switch the modem off, then on. For internal modems, switch the PC off, wait a moment, then turn it back on.

  Incorrect COM port selected in the Port Setup dialog box.

  Modem switches are set incorrectly.

Modem does not echo commands to the screen

  The modem switches are set for No Echo or the modem is programmed for No Echo. Set the command echo switch on the modem to the echo position or send the modem the Echo On command. The Echo On command for most Hayes modems is ATE1.

  The Modem Dialer program sets the modem to No Echo. Therefore, after using the Modem Dialer with a Hayes modem, an ATE1 command is required to enable command echo.

The status line indicates "ONLINE" when the modem is not connected to a host computer

  Modem Control has not been enabled in the Port Setup dialog box.

  The Carrier Detect line from the modem is high (on). Often, if the modem is off or not connected to the PC, the Carrier Detect line will be detected as high. (The word 'high' refers to a voltage level: high = on, low = off).

  The cable is wired incorrectly. Try another cable.

The modem will not hang up when I drop DTR by choosing Drop DTR from the Execute menu.

  The modem switches are set to ignore the DTR signal - change the modem switches.

  Some modems, such as the Anchor Signalman Mark XII, ignore the DTR lead. Be sure your modem is not one of these. This type of modem can be hung up by using the +++ Online command, waiting 1 second for the OK, and then issuing an ATZ command. The Modem Dialer hangs up these types of modems automatically.

  DTR is not wired correctly in the RS232 cable. Try another cable.

"Already connect to host (modem's carrier detect is high)" appears when trying to dial

  You already have an active modem connection.

  The modem switches are set to force Carrier Detect on. Carrier Detect is the signal that indicates a connection. Check your modem manual for the switch that controls the Carrier Detect signal. Set the switch so the Carrier Detect signal follows the state of the connection (not forced high).

  If connected to a network, phone system, or modem that always forces Carrier Detect on, turn Modem Control off to use the modem dialer. The Modem Control option is located in the Port Setup dialog box.

Note:	When Modem Control is off, the status of the connection is not monitored. If the connection is lost, you will not receive a message.


Programming Sequences

Click one of the following topics to display information on

ANSI Color Sequences

Private Escape Sequences

VT320 Escape Sequences

VT100 Escape Sequences

VT52 Escape Sequences


ANSI Color Sequences

The emulator supports ANSI color mode in addition to video attribute color mapping. Video attribute color mapping is mapping of colors to normal VT320 monochrome attributes such as bold, reverse video, and underline. Video attribute mapping is configured using the Video Attribute and ANSI Color Mapping dialog box.

ANSI color support allows the character, character cell, and screen background colors to be selected directly by sending control sequences from the host.

ANSI colors are selected through extensions to the VT320 Set Character Attributes control sequence.

Set Character Attributes and ANSI Colors

<CSI> Ps;Ps...m

Character Attributes

Ps = 0	Resets all colors and video attributes to defaults
Ps = 1	Bold on.
Ps = 4	Underscore on. Always uses the selected colors.
Ps = 5	Blink on
Ps = 7	Reverse video on. Always uses the selected colors.
Ps = 22	Bold off, normal intensity
Ps = 24	Underscore off
Ps = 25	Blink off
Ps = 27	Reverse video off, positive image
Character Colors (low intensity unless bolded)

Ps = 30	Black
Ps = 31	Red
Ps = 32	Green
Ps = 33	Yellow (displays as brown unless bolded)
Ps = 34	Blue
Ps = 35	Magenta
Ps = 36	Cyan
Ps = 37	White
Ps = 39	White
Character Cell Color (always low intensity colors)

Ps = 40	Sets the cell color to the current background color
Ps = 41	Red
Ps = 42	Green
Ps = 43	Yellow (displays as brown)
Ps = 44	Blue
Ps = 45	Magenta
Ps = 46	Cyan
Ps = 47	White
Ps = 49	Sets the cell color to the current background color

Direct Index Control Using a Prefix

< index	Specifies the character color index

= index	Specifies the character cell color index

> index	Specifies the screen background index

ANSI Color Indexes

0 = black

1 = red

2 = green

3 = yellow

4 = blue

5 = magenta

6 = cyan

7 = white

The following examples use the command DISPLAY to test character attributes and colors locally.

Example 1:	CMD:DISPLAY "<CSI>1;35mBold magenta characters<CSI>0m"

or

CMD:DISPLAY "<CSI>1;<5mBold magenta characters<CSI>0m"

Displays the character string in bold magenta characters at the current cursor position.

Example 2:	CMD:DISPLAY "<CSI>5;7mReverse blinking characters<CSI>25m"

Displays the character string using the blink attribute, 5, and the reverse video attribute, 7. After the characters are displayed, the blink is turned off, 25. Subsequent characters display in reverse video.

Example 3:	CMD:DISPLAY "<CSI>1;33;43mYellow chars in brown cell<CSI>0m"

Displays the character string using the bold attribute and character color 33 to give yellow characters. The character cell color, 43, shows as brown directly around each character.


Private Sequences
Private Escape Sequences

Escape Sequence	Function
CSI 0;0|	Enable Status Line
CSI 0;1|	Disable Status Line
CSI 0;2|	Erase Status Line
CSI 0;3;Pc|..String..<ST>	Write Status Line
CSI 2;n|	Set/Reset Local Echo
CSI 2;1;n|	Enable/Disable Exit
CSI 3;n|	Set/Reset WP mode
CSI 4;pl|	Set Printer Port
CSI 5|..Cmd String..<ST>	Do Emulator Command
CSI 6|	Request Product ID


VT320 Programming Sequences
VT320 Escape Sequences

C1 Control

Character Attributes

Character Sets

Compatibility Level

Cursor Movement

Editing

Erase

LEDs

Line Size

Modes

Printing

Reports

Reset

Scrolling Region

Tab Stops

User-Defined Keys


C1 Control

Escape Sequence	Function
ESC space F	7-bit C1 control transmission
ESC space G	8-bit C1 control transmission


Character Attributes

Escape Sequence	Function
CSΙ Ps;... m	Character attributes
Ps = 0	All attributes off
Ps = 1	Bold on
Ps = 4	Underscore on
Ps = 5	Blink on
Ps = 7	Reverse Video on
Ps = 2 2	Normal Intensity
Ps = 2 4	Not Underscored
Ps = 2 5	Not Blinking
Ps = 2 7	Positive Image
CSΙ " q	All Non-graphic off
CSΙ 0 " q	All Non-graphic off
CSΙ 1 " q	All Non-erasable on
CSΙ 2 " q	All Non-erasable off


Character Sets

ESC <Intermediate> <Final>

Intermediate

To Select	Use
94 Character Set
G0	(
G1	)
G2	*
G3	+
96 Character Set
G1	-
G2	.
G3	/

Final

To Select	Use
ASCII (94)	B
DEC Supplemental Graphic (94)	%5
ISO Latin-1 Supplemental (96)	A
User-preferred supplemental (94)	<
DEC Special Graphic	0
British National Replacement (94)	A


Compatibility Level

Escape Sequence	Function
CSΙ 61"p	Level 1 (VT100)
CSΙ 62"p	Level 3 (VT300 8-bit)
CSΙ 62;0"p	Level 3 (VT300 8-bit)
CSΙ 62;1"p	Level 3 (VT300 7-bit)
CSΙ 62;2"p	Level 3 (VT300 8-bit)
CSΙ 63"p	Level 3 (VT300 8-bit)
CSΙ 63;0"p	Level 3 (VT300 8-bit)
CSΙ 63;1"p	Level 3 (VT300 7-bit)
CSΙ 63;2"p	Level 3 (VT300 8-bit)


Cursor Movement

Escape Sequence	Function
CSΙ Pn A	Up
CSΙ Pn B	Down
CSΙ Pn C	Right
CSΙ Pn D	Left
CSΙ Pl;Pc H	Direct cursor addressing
CSΙ Pl;Pc f	Direct cursor addressing
CSΙ H	Home
CSΙ f	Home
ΙND	Index
ESC D	Index
NEL	New Line
ESC E	New Line
RΙ	Reverse Index
ESC M	Reverse Index
ESC 7	Save cursor attributes
ESC 8	Restore cursor attributes


Editing

Escape Sequence	Function
CSI Pn P	Delete Pn characters
CSI Pn @	Insert Pn characters
CSI Pn L	Insert Pn lines
CSI Pn M	Delete Pn lines


Erase

Escape Sequence	Function
CSI Pn X	From cursor for the next Pn characters
CSI K	Cursor to end of line
CSI 0 K	Cursor to end of line
CSI 1 K	Beginning of line to cursor
CSI 2 K	Entire line
CSI J	Cursor to end of screen
CSI 0 J	Cursor to end of screen
CSI 1 J	Beginning screen to cursor
CSI 2 J	Erase entire screen
CSI ? K	Selective erase to end of line
CSI ? 0 K	Selective erase to end of line
CSI ? 1 K	Selective erase from beginning of line
CSI ? 2 K	Selective erase entire line
CSI ? J	Selective erase to end of screen
CSI ? 0 J	Selective erase to end of screen
CSI ? 1 J	Selective erase from top of screen
CSI ? 2 J	Selective erase entire screen


LEDs

Escape Sequence	Function
CSI Ps;Ps q	Programmable LEDs
Ps = 0	All LEDs off
Ps = 1	L1 on
Ps = 2	L2 on
Ps = 3	L3 on
Ps = 4	L4 on


Line Size

Escape Sequence	Function
ESC #3	Double height - top half
ESC #4	Double height - bottom half
ESC #5	Single width - single height
ESC #6	Double width - single height


Modes

Escape Sequence		Function
Set	Reset	Mode Name
CSI 2h	CSI 2l	Keyboard Action
CSI 4h	CSI 4l	Insert/Replace
CSI 12h	CSI 12l	Send/Receive
CSI 20h	CSI 20l	Line feed/new line
CSI ?1h	CSI ?1l	Cursor key
	CSI ?2l	VT52
CSI ?3h	CSI ?3l	Column
CSI ?4h	CSI ?4l	Scrolling
CSI ?5h	CSI ?5l	Screen
CSI ?6h	CSI ?6l	Origin
CSI ?7h	CSI ?7l	Auto Wrap
CSI ?8h	CSI ?8l	Auto repeat
CSI ?9h	CSI ?9l	Interlace
CSI ?18h	CSI ?18l	Form Feed
CSI ?19h	CSI ?19l	Screen Print
CSI ?25h	CSI ?25l	Text cursor
CSI ?42h	CSI ?42l	Character Set
CSI ?66h	CSI ?66l	Numeric keypad
CSI ?67h	CSI ?67l	Backarrow key
CSI Ps $ }		Select status display
Ps = 0		main display
Ps = 1		status line
CSI Ps $ ~		Select status line type
Ps = 0		none
Ps = 1		indicator
Ps = 2		host-writable
ESC =	ESC >	Keypad


Printing

Escape Sequence	Function
CSI i	Print Screen
CSI 0i	Print Screen
CSI 4i	Print Controller mode off
CSI 5i	Print Controller mode on
CSI ?1i	Print Cursor Line
CSI ?4i	Auto Print mode off
CSI ?5i	Auto Print mode on


Reports

Reports are sent by the emulator in response to requests from the host computer.

Host Directives (host to Telnet)	Emulator Reports (Telnet to host)	Function
CSI c or CSI 0 c	CSI ? Psc ; Ps1 ; ...Psn c Psc Operating level 1, 6  level 1 (VT100) 62, 63 level 3 (VT300) Ps1...Psn Extensions 1 132 columns 2 printer port 6 selective erase 7 soft character set 8 user-defined keys	Primary Device Attributes
CSI > c or CSI > 0 c	CSI > Pp ; Pv ; Po c Pp Identification code 24 VT320 Pv Firmware version Po Hardware options 0 no options	Secondary Device Attributes
CSI 5 n	CSI 0 n No malfunction CSI 3 n Malfunction	Operating Status
CSI 6 n	CSI Pl ; Pc R Pl Line number Pc Column number	Cursor Position
CSI ? 15 n	CSI ? 13 n No printer CSI ? 10 n Printer ready CSI ? 11 n Printer not ready	Printer Status
CSI ? 25 n	CSI ? 20 n UDKs unlocked CSI ? 21 n UDKs locked	UDK Status (VT300 mode only)
CSI ? 26 n	CSI ? 27 ; Pd n Pd Keyboard dialect 1 North American	Keyboard Dialect
CSI Ps $ u Ps Report request 0 ignored 1 terminal state report	DCS 1$s D..D<checksums 1 and 2> ST D..D Report data	Terminal State Reports (VT300 mode only)
DCS Ps $ p D..D ST Ps Data string format 0 error 1 terminal state report D..D Restored data		Restore terminal state
		Presentation State Reports (VT300 mode only)
CSI Ps $ w Ps Report request 0 error 1 cursor information report 2 tab stop reportt	DCS 1 $ u D..D ST D..D Data string DCS 2 $ u D..D ST D..D Tab stops	Cursor information report Tab stop report
DCS Ps $ t D...D ST Ps Data string format 0 error 1 cursor information report 2 tab stop report D...D Data string		Restore presentation state
CSI Pa $ p Pa ANSI mode	CSI Pa ; Ps $ y Pa ANSI mode Ps Mode state 0 unknown state 1 set 2 reset 3 permanently set 4 permanently reset	Mode Settings (VT300 mode only)
CSI ? Pd $ p Pd DEC private mode	CSI ? Pd ; Ps $ y Pd DEC private mode Ps Mode state 0 unknown state 1 set 2 reset 3 permanently set 4 permanently reset
CSI Pa ; ...Pa h Pa ANSI mode CSI ?Pd ; ...Pd h Pd DEC private mode		Set mode
CSI Pa ; ...Pa l Pa ANSI mode CSI ? Pd ;... Pd l Pd DEC private mode		Reset mode
DCS $ q D..D ST D..D Intermediate and/or final characters of function	DCS Ps $ r D..D ST Ps Request validity 0 invalid request 1 valid request D..D Intermediate and/or final characters of function.	Control Function Settings (VT300 mode only)
ESC 7 ESC 8		Cursor Settings Save cursor Restore cursor
CSI & u	DCS 0 ! u % 5 ST DEC Supplemental Graphic DCS 1 ! u A ST ISO Latin-1 supplemental	User-preferred Supplemental Set (VT300 mode only)
ANSI Modes

Pa	MODE
2	Keyboard action
3	Control representation
4	Insert/replace
10	Horizontal editing
12	Send/receive
20	Line feed/new line
DEC Private Modes

Pd	MODE
1	Cursor keys
2	ANSI
3	Column
4	Scrolling
5	Screen
6	Origin
7	Autowrap
8	Autorepeat
18	Print form feed
19	Printer extent
25	Text cursor enable
42	NRC set
66	Numeric keypad
67	Backarrow key
68	Keyboard usage


Reset

Escape Sequence	Function
ESC c	Hard terminal reset
CSI ! p	Soft terminal reset


Scrolling Region

Escape Sequence	Function
CSI Pt; Pb r	Define scroll region


TAB Stops

Escape Sequence	Function
HTS	Set tab at current column
ESC H	Set tab at current column
CSI g	Clear at current column
CSI 0 g	Clear at current column
CSI 3 g	Clear all tabs


User-Defined Keys

Escape Sequence

DCS Pc;Pl | ky1/st1;ky2/st2;...kyn/stn ST


VT100 Programming Sequences
VT100 Escape Sequences

Character Attributes

Character Sets

Cursor Movement

Erase

LEDs

Line Size

Modes

Reports

Reset

Scrolling Region

Tab Stops


Character Attributes

Escape Sequence	Function
ESC [ Ps;... m	Character attributes
Ps = 0	All attributes off
Ps = 1	Bold on
Ps = 4	Underscore on
Ps = 5	Blink on
Ps = 7	Reverse video on


Character Sets

Escape Sequence	Function
G0	G1
ESC ( A	ESC ) A	UK set
ESC ( B	ESC ) B	US ASCII set
ESC ( 0	ESC ) 0	Special Graphics set
ESC ( 1	ESC ) 1	Alternate ROM
ESC ( 2	ESC ) 2	Alternate ROM Special Graphics set


Cursor Movement

Escape Sequence	Function
ESC [ Pn A	Up
ESC [ Pn B	Down
ESC [ Pn C	Right
ESC [ Pn D	Left
ESC [ Pl;Pc; H	Direct cursor addressing
ESC [ Pl;Pc; f	Direct cursor addressing
ESC D	Index
ESC E	New line
ESC M	Reverse index
ESC 7	Save cursor - attributes
ESC 8	Restore cursor - attributes


Erase

Escape Sequence	Function
ESC [ K	Cursor to end of line
ESC [ 0 K	Cursor to end of line
ESC [ 1 K	Beginning of line to cursor
ESC [ 2 K	Entire line
ESC [ J	Cursor to end of screen
ESC [ 0 J	Cursor to end of screen
ESC [ 1 J	Beginning of screen to cursor
ESC [ 2 J	Erase entire screen


LEDs

Escape Sequence	Function
ESC [ Ps;Ps q	Programmable LEDs
Ps = 0	All LEDs off
Ps = 1	L1 on
Ps = 2	L2 on
Ps = 3	L3 on
Ps = 4	L4 on


Line Size

Escape Sequence	Function
ESC #3	Double height - top half
ESC #4	Double height - bottom half
ESC #5	Single width - single height
ESC #6	Double width - single height


Modes

Escape Sequence		Function
Set	Reset	Mode Name
ESC[20h	ESC[20l	Line feed/new line
ESC[?1h	ESC[?1l	Cursor key
ESC[?3h	ESC[?3l	Column
ESC[?4h	ESC[?4l	Scrolling
ESC[?5h	ESC[?5l	Screen
ESC[?6h	ESC[?6l	Origin
ESC[?7h	ESC[?7l	Wraparound
ESC[?8h	ESC[?8l	Auto repeat
ESC[?9h	ESC[?9l	Interlace
ESC 1	ESC 2	Graphic process option
ESC =	ESC >	Keypad


Reports

Escape Sequence	Function
ESC [ 6 n	Invoke cursor position
ESC [ Pl;Pc R	Respond cursor position
ESC [ c	Invoke status report
ESC [ 0 c	Invoke status report
ESC [ ?1; Ps c	Respond status report
ESC Z	Invoke What are you
ESC [ ?1; Ps c	Respond What are you
Ps = 0	Base VT100
Ps = 1	STP
Ps = 2	AVO
Ps = 3	AVO and STP
Ps = 4	GPO
Ps = 5	GPO and STP
Ps = 6	GPO and AVO
Ps = 7	GPO, STP, and AVO


Reset

Escape Sequence	Function
ESC c	Reset


Scrolling Region

Escape Sequence	Function
ESC [ Pt; Pb r	Define scroll region


TAB Stops

Escape Sequence	Function
ESC H	Set tab at current column
ESC [ g	Clear at current column
ESC [ 0 g	Clear at current column
ESC [ 3 g	Clear all tabs


VT52 Programming Sequences
VT52 Escape Sequences

Escape Sequence	Function
ESC A	Cursor up
ESC B	Cursor down
ESC C	Cursor right
ESC D	Cursor left
ESC F	Enter graphics mode
ESC G	Exit graphics mode
ESC H	Cursor to home position
ESC I	Reverse line feed
ESC J	Erase to end of screen
ESC K	Erase to end of line
ESC Y	Direct cursor address
ESC Z	Identify
ESC =	Enter alternate keypad mode
ESC >	Exit alternate keypad mode
ESC <	Enter ANSI mode
ESC ^	Enter auto print mode
ESC _	Exit auto print mode
ESC W	Enter printer controller mode
ESC X	Exit printer controller mode
ESC ]	Print screen
ESC V	Print cursor line


Drop Down Menus
Telnet Menus

The menu bar for the SolarNet Telnet for Windows application consists of the following:

File menu lists features requiring file name input

Edit menu lists the Windows Clipboard functions

Setup menu provides commands that customize Telnet to your PC and host computer

Execute menu lists Telnet commands and features

Connect menu provides commands for establishing and terminating Telnet connections, dialing entries from the Phone Book, and switching between Telnet sessions

Help menu provides access to the various on-line help options


Edit Menu

The Edit menu lists the Windows Clipboard functions.

The Edit menu provides the following commands:

Copy copies selected text to the Clipboard.

Paste places a copy of the current Clipboard contents at the current cursor position.

Send sends the contents of the Clipboard to the host computer. Carriage returns are sent at the end of each line.

Select All selects the current screen and all of the scrollback data.

Select Screen selects all the text on the screen.


Copy

Copies selected text to the Clipboard.


Paste

Places a copy of the current Clipboard contents at the current cursor position.


Send

Sends the contents of the Clipboard to the host computer. Carriage returns are sent at the end of each line.


Select All

Selects the current screen and all of the scrollback data.


Select Screen

Selects all the text on the screen.


Execute Menu

The Execute menu lists Telnet commands and features.

The Execute menu provides the following commands:

Abort cancels file transfers, Telnet commands and command file execution.

Break (short) sends a 200 millisecond communications break to the communications port.

Break (long) sends a 3.5 second break to the communications port.

Clear Communications releases a hold condition and sends flow control on.

Command Line displays the Telnet command line prompt (CMD:). Telnet commands and command files are executed at the CMD: prompt.

Drop DTR drops the Data Terminal Ready (DTR) and Request to Send (RTS) modem control signals.

Maximize Workspace enables and disables the Maximize Workspace mode, which resizes the work area of the Telnet window by "hiding" the menu bar, status line, message line and fixed toolbar. See Enabling and Disabling Maximum Workspace Mode for information on how to use the Maximize Workspace command.

Reset resets the terminal Telnet to its default settings.

Send Answerback sends the Answerback message to the host. You use the Terminal dialog box to specify an answerback message.

WordPerfect 4.2 Mode toggles WordPerfect 4.2 mode on and off. In WP mode, the VAX/VMS WordPerfect version 4.2 can be operated using the PC keystrokes.

WordPerfect 5.x Mode toggles WordPerfect 5.x mode on and off. In WP5 mode, the VAX/VMS WordPerfect version 5.x can be operated using the PC keystrokes.


Abort

Aborts file transfers, Telnet commands and command file execution.


Break (short)

Sends a 200 millisecond communications break to the communications port.


Break (long)

Sends a 3.5 second break to the communications port.


Clear Communications

Releases a hold condition and sends flow control on.


Command Line

Displays the Telnet command line prompt (CMD:). Telnet commands and command files are executed at the CMD: prompt.


Drop DTR

Drops the Data Terminal Ready (DTR) and Request to Send (RTS) modem control signals.


Maximize Workspace

Maximize workspace mode maximizes the emulation window (working area) by "hiding" the menu bar, status line, message line and fixed toolbar.

See Enabling and Disabling Maximum Workspace Mode for information on how to use the Maximize Workspace command

Note:	All Telnet  menus are always available through the Control Menu.


Reset

The following occurs during a reset:

The scrolling region is set to 24 lines.

The UDKs are cleared.

Down-line loaded characters are cleared.

The screen is erased and the cursor is set to [1,1].

Video attributes are set to normal.

All characters are set to erasable.

The default character set is selected.


Send Answerback

Sends the Answerback message to the host. You use the Terminal dialog box to specify an answerback message.


WordPerfect 4.2 Mode

Toggles WordPerfect 4.2 mode on and off. In WP mode, the VAX/VMS WordPerfect version 4.2 can be operated using the PC keystrokes.


WordPerfect 5.x Mode

Toggles WordPerfect 5.x mode on and off. In WP5 mode, the VAX/VMS WordPerfect version 5.x can be operated using the PC keystrokes.


File Menu

The File menu lists different features requiring filename input.

The File menu provides the following commands:

Command opens the Command File Selection dialog box, which lets you select and execute a command file.

Record Log File opens the Record Log File dialog box, which lets you record all data received during a Telnet session to a log file.

Replay Log File opens the Log File Replay Selection dialog box, which lets you replay a log file during a Telnet session.

Settings opens the Settings File Selection dialog box, which lets you select the configuration file you want Telnet to use during a session.

Send opens the File Send Selection dialog box, which lets you select the file transfer protocol (ASCII, Kermit, or Xmodem) you want to use and the name of the file you want to send.

Receive opens the File Receive Selection dialog box, which lets you select the file transfer protocol (ASCII, Kermit, or Xmodem) you want to use and the name of the file you want to receive.

Print opens the Print dialog box, which lets you send Telnet output to a specified printer.

Printer Setup opens the Print Setup dialog box, which lets you select the printer to which you want to send Telnet output.

Exit  Exits Telnet and closes the application window.


Exit

Exits the Telnet and closes the application window.


Help Menu

The Help menu provides access to various on-line help options.

The Help menu provides the following commands:

About displays release information about the SolarNet Telnet for Windows application.

Index lists all Telnet help topics. You can search for help topics alphabetically or by keyword.

Kermit displays help for Kermit file transfers.

Keyboard displays help for the various keyboard configurations supported by Telnet.

Using Help gives instructions on using the Microsoft Windows Help feature. See the Microsoft Windows documentation for detailed information on the Help feature.

You can also access help by clicking the Question Mark button on the Telnet toolbar or by pressing the Help button in any dialog box.

Toolbar Help button


About

Displays release information about the SolarNet Telnet for Windows application.


Index

Lists all Telnet help topics. Cross-referencing and searching are supported.


Kermit

Displays help for Kermit file transfer.


Keyboard

Displays help for the various keyboard configurations.


Using Help

Gives instructions on using the Microsoft Windows Help feature. See the Microsoft Windows documentation for detailed information on the Help feature.


Setup Menu

The Setup menu contains different categories that customize Telnet to your PC and host computer.

The Setup menu provides the following commands:

Color Mapping opens the Video Attribute and ANSI Color Mapping dialog box, which lets you select color options for SolarNet Telnet for Windows.

Command Files opens the Command Files dialog box, which lets you specify the command file Telnet runs when you start the application.

DDE opens the Dynamic Data Exchange dialog box, which lets you specify default settings for Telnet DDE transactions.

Directories opens the Search Directories dialog box, which lets you specify the directories you want to use for holding Telnet command files and for storing files transferred from other computers.

Display opens the Display Setup dialog box, which lets you specify how the Telnet window presents information.

File Transfer opens the File Transfer Setup dialog box, which lets you specify protocol settings for ASCII, Kermit, Ymodem, Ymodem, or Zmodem file transfers.

International opens the International Setup dialog box, which lets you specify the Windows keyboard driver and character set that you want to use for Telnet sessions.

Keyboard opens the a secondary menu that lets you configure key mapping, key behavior, warning bells, softkeys, and keyboard type.

Log Replay opens the Log File Replay Setup dialog box, which lets you replay a previously recorded log file.

Modem opens the Modem Setup dialog box, which lets you specify the initialization string you want the Modem Dialer to use to configure your modem.

Mouse opens the Mouse Mapping dialog box, which lets you assign different functions to the buttons on your mouse.

Preferences opens the Preferences dialog box, which lets you specify how information should be displayed and the position of the Toolbar in a Telnet window.

Scrollback opens the Scrollback Memory Setup dialog box, which lets you specify how much memory you want Telnet to allocate for scrolled information.

Terminal opens the Terminal Setup dialog box, which lets you specify the type of terminal you want Telnet to emulate.

Toolbar opens the Toolbar Settings dialog box, which lets you configure the floating toolbar for the Telnet application.

Save on Exit saves the modified Telnet configuration when you exit the application.

Save Now saves the modified Telnet configuration immediately.


Keyboard


Save Now

Saves the setup configuration immediately.


Save on Exit

Saves the setup configuration upon exit.


Connect_Menu
Connect Menu

The Connect menu provides commands for establishing and terminating Telnet connections, dialing entries from the phone book, and switching between established Telnet connections.

The Connect menu provides the following commands:

Conn./Disc. opens the Connect dialog box, which lets you select initiate a Telnet session.

Dial opens the Modem Dialer dialog box, which lets you open a serial connection to a remote computer.

Switch opens the Switch dialog box, which lets you switch between Telnet sessions.


Using XXX
Enabling Maximum Workspace Mode

To enable or disable Maximize Workspace mode, do one of the following:

Click the Maximize icon on the Telnet toolbar.

Pull down the Execute menu and choose Maximize Workspace.

Open the Control menu (located in the upper-left corner of the Telnet title bar) and choose Maximize Workspace.

Maximize Workspace is automatically disabled whenever you issue a CMD (Alt C) or Kermit (Alt K) command.