Contents

This file documents CRT version 1.1B1.

Introduction

What is CRT?

System Requirements

Command Line Usage

File Menu Commands

New Window

Connect

Disconnect

Print

Page Setup

Print Setup

Log Session

Trace Options

Exit

Edit Menu Commands

Copy

Paste

Copy & Paste

Clear Scrollback

Clear Screen

Reset

Preferences Menu Commands

Session

Global

Status Bar

Save Settings On Exit

Save Settings Now

Support

License Registration

Reporting Problems

Other Support Issues


What is CRT?

CRT is a terminal emulator that supports both the rlogin and telnet protocol.

CRTs feature include:

Named sessions allow the user to have different preferences for different hosts

Faithful VT100, VT102, VT220, and ANSI emulation, including:

double width and double height fonts

80/132 column switching

VT line drawing

bold, underline, and reverse attributes

VT100 and VT220 keyboard emulation

optional ANSI color

xterm extensions for mouse support and changing title bar

SOCKS firewall support (telnet only)

Generic telnet proxy firewall support

Telnet supports window size change (NAWS)

Telnet supports local flow control (LFLOW)

ZModem file transfer over telnet, upload and download

Printing: auto print, selection, and screen

User defined foreground, background, and bold colors

User defined keymaps

Emacs mode maps <alt><key> to send <esc><key>

Copy and paste, including an auto copy option

Size of scrollback buffer is user defined

Command line usage is compatible with Netscape and Mosaic

Individual sessions may be logged to a file


System Requirements

1.	CRT requires a minimum of a 386 based machine with 8 megabytes of RAM.

2.	CRT requires one of the following Windows operating systems:

Microsoft Windows NT - version 3.5 or greater.

Windows 95.

Windows 3.1 - operating in enhanced mode with Win32s (version 1.20 or later).

Windows for Workgroups - operating in enhanced mode with Win32s (version 1.20 or later).

3.	CRT requires a winsock.dll (compliant with version 1.1 of the WINSOCK standard).

4.	CRT requires a TCP/IP stack. Both Windows 95 and Windows NT 3.5 include one. Under Windows 95 and Windows NT, the TCP/IP stack must be 32-bit.


Command Line Usage

For a named session:

CRT.EXE [ /C session_name ]

For a default telnet session:

CRT.EXE [ /TELNET ] [ hostname [ port ] ]

For a default rlogin session:

CRT.EXE /RLOGIN [ hostname [ /L user ] ]

For a default telnet session via a SOCKS firewall:

CRT.EXE /SOCKS [ hostname ] [ port ] ]

For a default telnet via a telnet proxy firewall:

CRT.EXE /PROXY [ hostname ] [ port ] ]


New Window

Open another CRT Window.


Connect

Displays the connect dialog.

From the connect dialog, you can connect to a remote host using the rlogin or telnet protocol.  You can also connect via a firewall by specifying proxy or socks as the protocol.

From the connect dialog, you can create, edit, and delete sessions.

Each session saved includes a comprehensive set of preferences, including: protocol, hostname, emulation, size, font, colors, options, etc.

The order of the session list can be rearranged by using the up and down buttons.

Note: The proxy protocol is provided for users who need to establish a telnet connection via a telnet proxy. Like telnet, you must specify the remote hostname and remote port. In addition, you must have previously configured the telnet proxy via the preferences/global dialog.

Note: The socks protocol is provided for users who need to establish a telnet connection via a SOCKS firewall. Like telnet, you must specify the remote hostname and remote port. In addition, you must have previously configured the SOCKS hostname and port via the preferences/global dialog.

This command is not available when you are connected.


Disconnect

Terminates the current connection.

This command is not available when you are not connected.


Print

The Print menu consists of three sub menus:

Auto Print	print each line as it is received
Screen	print the current screen
Selection	print the current selection


Page Setup

Display the Page Setup dialog to adjust the printer margins.


Print Setup

Display the standard printer setup dialog.


Log Session

Selecting this command toggles whether the current session is logged to a file.  By default, logging is turned off.

If you turn logging on, you will be prompted for a filename.  The default filename may be specified via the configuration dialog.


Trace Options

Selecting this command toggles whether the telnet option negotiation is echoed to the screen.  This can be useful in determining a telnet servers capabilities.


Exit

Quits CRT.

If you select Exit while connected, you will be asked whether you wish to terminate the current connection.


Copy

Copies the current selection onto the Clipboard. The previous contents of the Clipboard is lost.

This operation is also available via the right mouse button.

This command is not available until you have made a selection with the mouse.


Paste

Sends the current contents of the Clipboard to the remote site as if it had been typed.

This operation is also available via the right mouse button.

This command is not available if the Clipboard is empty.


Copy & Paste

Copy the current selection onto the Clipboard and immediately send the selection to the remote site as if it had been typed.

This operation is also available via the right mouse button.

This command is not available until you have made a selection with the mouse.


Clear Scrollback

Clear the terminals scrollback buffer. This has no effect on the current screen.

This operation is also available via the right mouse button.


Clear Screen

Clear the current screen. This has no effect on the scrollback buffer.

This operation is also available via the right mouse button.


Reset

Reset the terminal, including:

clear the scrollback buffer,
clear the screen, and
reset the VT100 emulator.

This operation is also available via the right mouse button.


Configure
Session

This section describes the session dialog box. The dialog has seven sections: Session, Emulation, Fonts, Options, Files, Keyboard, and Advanced.

Session

From the first tab of the dialog, you can specify:

Name	this is the current sessions name
Protocol	telnet, rlogin, proxy, or socks
Hostname	hostname to connect to
Port or Username	port for telnet or username for rlogin
Title bar	a session specific title bar

Emulation

From the second tab of the dialog, you can specify:

the emulation,
the number of rows and columns displayed in the terminal window,
the number of rows saved in the scrollback buffer, and
the emulation modes.

The emulation modes are:

Numeric or Application keypad mode,
Line Wrap,
New line mode (CR sends CR/LF), and
Cursor key mode.

Fonts

From the third tab of the dialog, you can specify which font to use in the terminal window. The fonts are grouped into three categories: VT fonts, ANSI fonts, and Windows fonts.

Use must choose a VT font if you want CRT to display VT100 line drawing characters correctly.

The ANSI fonts include the graphic characters used with ANSI emulation.

From this section of the session dialog you can specify the foreground and background of the terminal text. You can also specify the color used for bold. By default, bold is the same as the foreground and overstrike bold is on.

Options

From the fourth tab of the dialog box, you can specify the following options:

backspace sends delete,
delete sends backspace,
audio bell,
visual bell,
blinking cursor,
emacs mode,
jump scroll,
scroll to clear screen,
close on disconnect,
clear on disconnect.

Emacs mode maps <alt><key> to send <esc><key>.

Scroll to clear screen preserves the current screen in the scroll buffer prior to processing the clear screen operation.

Files

From the fifth tab of the dialog box, you can specify:

the receive directory for ZModem downloads,
the log filename,
whether to prompt for the filename when logging is turned on, and
whether to truncate or append to the file, if the log file already exists.

Keyboard

From the sixth tab of the dialog box, you can map Fn, ctrl+Fn, and shift+Fn to send an arbitrary string.

The string to be sent can include \ddd, where ddd represents the octal representation of a character. In addition, \r sends CR, \n sends LF, \b sends a backspace, and \e sends an escape. Alt+Fn and combinations like ctrl+shift+Fn are not supported.

You can also specify either a built-in or custom keymap. There are three built-in keymaps: Default, VT100, and VT220. When the VT100 Keymap is selected, the keypad will emulate the VT100 keypad. When The VT220 Keymap is selected, the VT220 keypad and VT220 function keys are emulated.

Advanced

From the last tab of the dialog box, you can specify:

Terminal Type
Initial Position
Direct pass through printing to port

When the Terminal Type option is set, instead of sending the emulation (vt100, vt220, or ansi) as the terminal type, the specified string is sent.

When the Direct pass through printing to port option is set, when the pass through escape sequence is received, the characters received are not interpreted and sent directly to the selected printer port.


Custom Keymap

A CRT keymap file as the following format:

  modifiers   virtual_key   string (or function)

modifiers:

At least one modifer is required.

  - N is none

  - E is extended key

  - S is shift

  - C is control

N is only used if there is no E, S, or C.

E is used to distinguish between keys that occur twice on the keyboard. For example: insert, delete, and enter.

virtual_key:

Here is the list of virtual keys that CRT recognizes:

    VK_A .. VK_Z	0x41 .. 0x5A

    VK_0 .. VK_9	0x30 .. 0x39

    VK_ADD	0x6B
    VK_APPS	0x5D
    VK_BACK	0x08
    VK_CANCEL	0x03
    VK_CAPITAL	0x14
    VK_CLEAR	0x0C
    VK_CONTROL	0x11
    VK_DECIMAL	0x6E
    VK_DELETE	0x2E
    VK_DIVIDE	0x6F
    VK_DOWN	0x28
    VK_END	0x23
    VK_ESCAPE	0x1B
    VK_EXECUTE	0x2B
    VK_F1	0x70
    VK_F2	0x71
    VK_F3	0x72
    VK_F4	0x73
    VK_F5	0x74
    VK_F6	0x75
    VK_F7	0x76
    VK_F8	0x77
    VK_F9	0x78
    VK_F10	0x79
    VK_F11	0x7A
    VK_F12	0x7B
    VK_F13	0x7C
    VK_F14	0x7D
    VK_F15	0x7E
    VK_F16	0x7F
    VK_F17	0x80
    VK_F18	0x81
    VK_F19	0x82
    VK_F20	0x83
    VK_F21	0x84
    VK_F22	0x85
    VK_F23	0x86
    VK_F24	0x87
    VK_HELP	0x2F
    VK_HOME	0x24
    VK_INSERT	0x2D
    VK_MULTIPLY	0x6A
    VK_NEXT	0x22
    VK_NUMLOCK	0x90
    VK_NUMPAD0	0x60
    VK_NUMPAD1	0x61
    VK_NUMPAD2	0x62
    VK_NUMPAD3	0x63
    VK_NUMPAD4	0x64
    VK_NUMPAD5	0x65
    VK_NUMPAD6	0x66
    VK_NUMPAD7	0x67
    VK_NUMPAD8	0x68
    VK_NUMPAD9	0x69
    VK_PAUSE	0x13
    VK_PRINT	0x2A
    VK_PRIOR	0x21
    VK_RETURN	0x0D
    VK_SCROLL	0x91
    VK_SELECT	0x29
    VK_SEPARATOR	0x6C
    VK_SHIFT	0x10
    VK_SNAPSHOT	0x2C
    VK_SPACE	0x20
    VK_SUBTRACT	0x6D
    VK_TAB	0x09
    VK_UP	0x26

string (or function):

If the virtual key is pressed with the corresponding modifiers, then the associated string is sent as if the user had typed it. The string can include characters represented in octal notation. For example, <escape>OP, would be represented as:
     "\033OP"
The quotes are required.

Also CRT defines several functions. Functions are simply pre-defined behavior. For example, VT_CURSOR_UP is the VT100 behavior of the cursor up key. Depending on the current cursor key mode, this function sends one of two escape sequences even though it is the same key sequence.

Custom Keymap Example:

Here is a keymap file that is equivalent to the built-in VT100 keymap:

; VT100.KEY	(for use with an PC-101 keyboard)
;
; Turn on VT100 Keypad behavior

E	VK_NUMLOCK	"\033OP"
E	VK_DIVIDE	"\033OQ"
N	VK_MULTIPLY	"\033OR"
N	VK_SUBTRACT	"\033OS"

; keypad when numlock on
;
N	VK_NUMPAD0	VT_KEYPAD_0
N	VK_NUMPAD1	VT_KEYPAD_1
N	VK_NUMPAD2	VT_KEYPAD_2
N	VK_NUMPAD3	VT_KEYPAD_3
N	VK_NUMPAD4	VT_KEYPAD_4
N	VK_NUMPAD5	VT_KEYPAD_5
N	VK_NUMPAD6	VT_KEYPAD_6
N	VK_NUMPAD7	VT_KEYPAD_7
N	VK_NUMPAD8	VT_KEYPAD_8
N	VK_NUMPAD9	VT_KEYPAD_9
N	VK_DECIMAL	VT_KEYPAD_PERIOD

; keypad when numlock off
;
N	VK_INSERT	VT_KEYPAD_0
N	VK_END	VT_KEYPAD_1
N	VK_DOWN	VT_KEYPAD_2
N	VK_NEXT	VT_KEYPAD_3
N	VK_LEFT	VT_KEYPAD_4
N	VK_CLEAR	VT_KEYPAD_5
N	VK_RIGHT	VT_KEYPAD_6
N	VK_HOME	VT_KEYPAD_7
N	VK_UP	VT_KEYPAD_8
N	VK_PRIOR	VT_KEYPAD_9
N	VK_DELETE	VT_KEYPAD_PERIOD

; other keypad
E	VK_RETURN	VT_KEYPAD_ENTER

; non-keypad cursor keys
E	VK_UP	VT_CURSOR_UP
E	VK_DOWN	VT_CURSOR_DOWN
E	VK_LEFT	VT_CURSOR_LEFT
E	VK_RIGHT	VT_CURSOR_RIGHT


Global

The global preferences dialog includes two tabs: options and firewall.

Options

The two global options are:

Copy on select
Connection closed dialog

This section of the dialog displays the current session config file.  In CRT 1.1B1, changing this field does not change the session config file.

Firewall

The firewall dialog allows you to configure CRT to use either a SOCKS firewall or a telnet proxy.

To configure the SOCKS firewall, simply specify the hostname and port (usually 1080) of your SOCKS firewall.

To configure CRT to use the telnet proxy, you must specify the host, port, prompt, and command appropriate for your specific telnet proxy. For example, for the TIS Firewall toolkit, the prompt would be, tn-gw> and the command would be c %h %p\r. When the proxy protocol is used, CRT will substitute the hostname for %h and the port for %p. The \r represents a carriage return.


Status Bar

Show or hide the status bar.

When displayed, the status bar is below CRTs text window.  Informational text, such as brief menu descriptions, is displayed in the status bar.


Save Settings On Exit

Save the configuration settings when CRT exits.


Save Settings Now

Save the configuration settings now.


License Registration

The following information  is for individual licenses. For information on site licenses, send e-mail to support@vandyke.com.

Upon receipt of payment we will send you one license key for each copy of CRT paid for. The new license key(s) will have no expiration. The license(s) key will be sent to you via e-mail or postal mail. Note, no disk will be sent. All updates to the software will be made available via anonymous ftp.

Individual licenses for CRT are $30.00 (U.S.). Three payment methods are available:

Ordering by check:

To order by check, send the order form (click here)  and a check to:

Van Dyke Technologies
P.O. Box 37457
Albuquerque, NM  87176

CompuServe Registration:

If you have a CompuServe account, you can have the registration fee added to your CompuServe bill. Just type GO SWREG. Specify registration id 7102 for Windows 3.1; or, registration id 7103 for Windows 95/NT.

Ordering by Credit Card:

You can order with MC, Visa, Amex, or Discover from Public (software) Library:

Phone:      800-2424-PsL or 713-524-6394
FAX:        713-524-6398
CIS Email:  71355,470
U.S. Mail:  PsL, P.O. Box 35705, Houston, TX 77235-5705

The above numbers are for credit card orders only.

The authors of CRT cannot be reached at these numbers.

Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support, volume discounts, dealer pricing, site licenses, non-credit card orders, etc., must be directed to Van Dyke Technologies, P.O. Box 37457, Albuquerque, NM 87176 or support@vandyke.com.

PsL will notify us the day of your order and we will send you the license key(s) directly.

PsL's product number for either version of CRT is 14206.

After calling PsL, send email to support@vandyke.com if you want your license keys emailed to you.


Reporting Problems

Please send any bug reports to support@vandyke.com.

Please describe the problem in as much detail as possible. Also include:

version of CRT (as shown in the About dialog box)
TCP/IP package and version
operating system and version
CPU and memory configuration

We try to respond to all bug reports within 72 hours. In addition, we will try resolve the problem as quickly as possible.


Other Support Issues

We are very interested in hearing from our users. If at any time you have a suggestion or comment about CRT, please send e-mail to support@vandyke.com.

For the latest information on CRT and Van Dyke Technologies, check out our home page:

http://www.vandyke.com

To receive announcements of new versions of CRT via e-mail, send e-mail to:

crt-announce-request@vandyke.com


Order Form

To print the order form click on Print Topic in the File menu. Payments must be in US dollars drawn on a US bank, or you can send international postal money orders in US dollars.

Send this order form and a check to:

Van Dyke Technologies
P.O. Box 37457
Albuquerque, NM  87176

CRT 1.0 Single Copy         _____  copies at $30.00 each = ________

New Mexico Residents add 5.8125% sales tax               + ________

                                      Total Payment        ________

Name: ______________________________________Date:__________________

Company: __________________________________________________________

Address: __________________________________________________________

City, State, Zip: _________________________________________________

Country: __________________________________________________________

E-Mail Address: ___________________________________________________

Comments: _________________________________________________________