 Mocha W32 Telnet Help Index

How To ...

Vt220 keyboard mapping

Change keyboard mapping

Change character mapping

Press F18 in an application

Use shift and ctrl with function keys in the Toolbar

Parameters to Mocha W32 Telnet

Use different configurations

Check for latest version

Order Mocha W32 Telnet

Technical Support

Commands

File menu

Edit menu

View menu

Settings

Help menu


File menu commands

The File menu offers the following commands:

Connect	Connect to Host.
Disconnect	Close a connection to a Host.
Print Screen	Print current screen.
Print Setup	Selects a printer and printer connection.
Sending	Send the active screen through electronic mail.
Logfile	Capture screen data to a file or send data from a file as keyboard input to the host.
Exit	Exits Mocha W32 Telnet.


Edit menu commands

The Edit menu offers the following commands:

Copy	Copies data from the screen to the clipboard.
Paste	Pastes data from the clipboard into the screen at cursor position.
Reset Terminal	Reset the display to a known state. The state of the connection is unchanged.
Ctrl+C and CTRL+V	Selects if keys CTRL C and CTRL V should be enabled.


View menu commands

The View menu offers the following commands:

Toolbar	Shows or hides the toolbar.
Status Bar	Shows or hides the status bar.
Scroll Bar	Shows or hides the scroll bar.
Screen width 132	Select if 24*80 or 24*132 screen size.


Settings menu commands

The Settings menu is used to define the configuration of Mocha Telnet. At Exit from Mocha Telnet the configuration is saved automatically.

Font	Select font type and size to use in the display.
Font for 24*132	Select font type and size to use in the display when in 24*132 mode.
Colors	Define colors in the display.
Proxy Configuration	It is possible to connect via a proxy server. This menu is used to configure the proxy communication.
Auto Login	Save login id and password here, to speed up the login procedure.
Reset Configuration	Reset all parameters to installation defaults.
License	Add license key, to make Your Mocha W32 Telnet legal.
Mapping Files	Keyboard and data mapping files are saved ASCII files.
Printer	Select font for printer.
Termtype	Selects telnet terminal type and default size.
Local Echo	Defines if characters typed on the keyboard should be echoed local on the screen.
Autowrap	If the cursor should jump to next line at position 80, can be defined.
Swap LF to CRL	Select if the Return key should send CR or CRLF.


Help menu commands

The Help menu offers the following commands, which provide you assistance with this application:

Help Topics	Offers you an index to topics on which you can get help.
About	Displays the version and license information of Mocha Telnet.


Connect
Connect command (File menu)

Use this command to create a new connection to a Host.

  Host : Name of the host. Either an TCP/IP address as 155.22.11.2 or a symbolic name.

  Port :  Most Telnet applications uses port 23.

  Use as default host :

     If this checkbox is enabled, Mocha Telnet will login without user action, when it is started.

     (Only if no host parameter is given as parameter to mtelnet.exe)


Disconnect
Disconnect command (File menu)

Use this command to disconnect from a Host.


File Exit command
Exit command (File menu)

Use this command to end your Mocha W32 Telnet session.  You can also use the Close command on the application Control menu.


Sending  command
Sending command (File menu)

Use this command to send a copy of the screen as an electronic mail.


termtype
Term Type (Settings menu)

Use this command to define the telnet Terminal type. As default it is VT220. This type is send to the Host on session setup, and will be saved as the environment variable TERM.

In this dialog box it is also possible to force Mocha W32 Telnet to start in 24 * 132 mode.


copy
Copy command (Edit menu)

Use this command to copy selected data onto the clipboard.  This command is unavailable if there is no data currently selected. Data is selected with pressing the left mouse key and moving the mouse over the area to select.

Also key CTRL+C can be used for this operation.

Copying data to the clipboard replaces the contents previously stored there.


copy
Ctrl C and Ctrl V  (Edit menu)

Use this command to define if the standard Windows-95 key for copy and paste should be enabled.


paste
Paste command (Edit menu)

Use this command to insert a copy of the clipboard contents at the cursor.  This command is unavailable if the clipboard is empty. Also the right mouse key or CTRL V can be used to paste data.


reset configuration
Reset Terminal command (Edit menu)

Use this command to reset the terminal to a known state. If the user has send a binary file to the screen, the screen could look less friendly.


View Toolbar command
Toolbar command (View menu)

Use this command to display and hide the Toolbar, which includes buttons for some of the most common commands in Mocha W32 Telnet.

See Toolbar for help on using the toolbar.


Screen size command
Screen width 132 (View menu)

Use this command to force the screen between 24 * 80 and 24 *132 mode. In most cases the host will request Mocha W32 Telnet for the correct size. See also Termtype for how to define the startup screen size.


Toolbar

The toolbar is displayed across the top of the application window, below the menu bar.  The toolbar provides quick mouse access to many tools used in Mocha W32 Telnet.

To hide or display the Toolbar, choose Toolbar from the View menu.

The Function keys F1 - F20 can be selected with the mouse in the toolbar. Remark it is possible

to use ctrl and shift together with the mouse. As an example, hold down shift key and select F9 with the mouse. The result will be as if Key F9 + Shift were pressed.


logfile
Logfile (File menu)

These 2 functions can be used to copy small amount of data to/from a Host. Large data files should be copied with a file transport protocol and not the telnet protocol.

It is possible to save all screen data from the Host in a raw format to a file. Select Logfile - Save to file in the menu, and choice either a new file or an existing file to append screen data to. Stop the data capture with selecting the menu element again.

A file can be used as keyboard input. Select Logfile - Read from file in the menu, and choice an existing file. Now all data in this file is send raw direct to the Host.


View Status Bar Command
Status Bar command (View menu)

Use this command to display and hide the Status Bar, which describes the action to be executed by the selected menu item or depressed toolbar button, and keyboard latch state. A check mark appears next to the menu item when the Status Bar is displayed.

See Status Bar for help on using the status bar.


Status Bar

The status bar is displayed at the bottom of the Mocha W32 Telnet window.  To display or hide the status bar, use the Status Bar command in the View menu.

The left area of the status bar describes actions of menu items as you use the arrow keys to navigate through menus.  This area similarly shows messages that describe the actions of toolbar buttons as you depress them, before releasing them.  If after viewing the description of the toolbar button command you wish not to execute the command, then release the mouse button while the pointer is off the toolbar button.

The right areas of the status bar indicate the current cursor position and if CTRL or SHIFT keys are latched down:


Scroll bar

Displayed at the right edge of the document window. You can use the mouse to scroll the latest 200 lines.


about
About command (Help menu)

Use this command to display license and version number of your copy of Mocha W32 Telnet


Title Bar

The title bar is located along the top of a window.  It contains the Mocha W32 Telnet name and

 the host connected to.


No Help Available

No help is available for this area of the window.


screen fonts
Font

Changes font, style (such as bold and italic), font size, color, and font effects.

Tab Options

Font

Type or select a font name. The  list is  the non proportionally spaced fonts available in your system. The screen will be scaled to the font, giving a display of 24*80 or 24*132 characters.

Font Style

Select a style. To use the default type style for a given font, select Regular.

Size

Type or select a size.

Color

Type or select one of the 16 predefined colors. Can also be defined from the Color menu

Preview

Shows the effects of the formatting you specify before you apply it to the document.


Color

It is possible to customize most colors in Mocha W32 Telnet. Select a color with the mouse and click Ok.


proxy setup
Proxy Configuration

It is possible to use a Telnet proxy host as gateway to other hosts. Mocha W32 Telnet will connect to the proxy host and issue a new login sequence. As there is a limited standard for how to issue this login sequence, it has been designed very dynamic for Mocha W32 Telnet.

Options

Proxy host

IP address of the proxy host

Proxy port

Port number of the Telnet server daemon on the proxy server

Proxy syntax

Format of the connect string to send at login.

    $1 :  host

    $2 :  port

    \abc = octal value. (LF = \012 and CR = \015)

Example:

  proxy host = myproxy

  proxy port = 911

  proxy syntax =\012Connnect $1:$2\015\012

  In the connect dialog host name wintermute and port 23 is given.

  Mocha W32 Telnet will connect to myproxy port 911, and send the connect

  sequence: <LF>Connect wintermute:23<CR><LF>

Connect through a proxy server

Use this checkbox to enable the use of a proxy server.


Auto Login

To make it easier for the novice to use Mocha W32 Telnet to connect to a single host, it is possible to define an automatic login sequence. Of course there is not much security involved doing it!

Options

Search and Response

It is possible to define a search string, and a response string which is send back to the host on a match.

Example:

Search : Login          Response : anonymous\012

Search : Password    Response: mypassword\012

To include characters as CR and LF, use the octale notation :

\abc = octal value. (LF = \012 and CR = \015)


Reset Configuration

Reset all Configuration parameters in  Mocha W32 Telnet.


License

After ordering Mocha W32 Telnet from MochaSoft, a license key will be received. Enter the key together with the Company Name given on the Order. As there is link between the Company name and license key it is important to enter both very careful.


keyboard file
Mapping Files

The ASCII keyboard file contains the codes send from all Function keys (F1 -F20). In this dialog window it is possible to select another file. Also the names of the files used to map characters between the host code page and Mocha Telnet can be changed in this dialog window. See also   Character mapping


printer configuration
Printer

Changes font, style (such as bold and italic) and font size for the printer.

Tab Options

Font

Type or select a font name. The  list is  the non proportionally spaced fonts available in your system.

Font Style

Select a style. To use the default type style for a given font, select Regular.

Size

Type or select a size.


Local Echo

It is possible to let all characters typed on the keyboard be displayed on the screen as default. Normally this is not a good idea. If the host wants to run in this mode, it can ask Mocha W32 Telnet direct. Most hosts will overwrite this parameter in the startup negotiation.


Autowrap

Autowrap defines, if the cursor should jump to the start of the next line, when it exceeds the end of a line.


Swap LF to CRLF

This parameter defines if <RETURN> key should send <cr> <lf> or just <cr>.


order Mocha W32 Telnet
How to Order Mocha W32 Telnet

It is possible to buy Mocha W32 Telnet via the Internet. Visit www.mochasoft.dk , and get the latest information about the products and prices. Also check out the Java version of Mocha Telnet.


version
How to Check for latest Version

Visit the MochaSoft home page at www.mochasoft.dk, and receive information about the latest development of the product. The version of Your copy of Mocha W32 Telnet can be checked in menu help-about.


startup parameters
Parameters to Mocha W32 Telnet

Mocha W32 Telnet can be started with a set of parameters:

/H host     : make a connection to ‘host’

/P port      : don’t use default Telnet port 23 on the host, but number ‘port’

/C number : select a configuration. Default is number  1. Values 1 - 9 is legal.

/S1            : Secure mode. Not possible to save the configuration on exit.

/R1            : Selection of host to connect is restricted. Use /H option to define the host name.

/N name    : Name will be displayed at first position of the title. As default the Host name is displayed.


configuration
Use different configurations

It is possible to use Mocha W32 Telnet with up to 9 different configurations. As an example a red background for host Unix1 and a black background for host Unix2.

Use the parameter /C  , see Parameters to Mocha W32 Telnet  to startup with an unique configuration.


Change keyboard mapping

Mocha W32 Telnet comes with a default VT220 keyboard. It is possible to customize all function keys with a keyboard mapping file. See Keyboard FileThe  syntax of the file is

# is a comment

<keyname> <key code>

Possible keyname:

UP	arrow up
DOWN	arrow down
RIGHT	arrow right
LEFT	arrow left
HOME	HOME key
END	END key
PGUP	Page Up key
PGDN	Page Down key
INSERT	INSERT key
BACKSPACE	Backspace key (<--)
DELETE	DELETE key
f1 - f20	function key f1 - f20
F1 - F20	function key f1 - f20 + SHIFT
cf1 - cf20	function key f1 - f20 + CTRL
CF1 - CF20	function key f1 - f20 + SHIFT + CTRL

Possible keycode:

A keycode can contain normal ASCII characters and \abc to define any value in octal. As an example \033 is ESC (27 decimal).  Space characters should be written as \040

Example:

# VT220 keymap

# \033 = ESC

# f1 = f1 key , F1 = shift F1

# cf1 = f1 + ctrl  CF1 = shift f1 + ctrl

UP   \033[A

DOWN \033[B

RIGHT \033[C

LEFT \033[D

f1   \033[11~

f2   \033[12~


How to Press F18 in an application

A standard PC keyboard will only have keys F1 - F12. To select keys higher than F12, following default mapping is used:

Shift F1	= F11
Shift F2	= F12
Shift F3	= F13
Shift F4	= F14
Shift F5	= F15
Shift F6	= F16
Shift F7	= F17
Shift F8	= F18
Shift F9	= F19
Shift F10	= F20

Remark, it is possible to change the default mapping. See Keyboard mapping


Use shift and ctrl with function keys in the toolbar

In the toolbar (below the menu bar) it is possible to press function keys F1 - F20.  Also SHIFT and CTRL can be used, to generate 80 different keys.


keyboard mapping
VT220 Keyboard mapping

Mocha W32 Telnet comes with a default VT220 keyboard.

 PC-Key     VT220-Key          PC-Key          VT220-Key

-------------------------------      -----------------------------------

  f1              f1                         crtl f1              PF1

  f2              f2                         ctrl f2              PF2

  f3              f3                         ctrl f3              PF3

  f4              f4                         ctrl f4              PF4

  f5              f5                         ctrl f5              PF1 vt52 mode

  f6              f6                         ctrl f6              PF2 vt52 mode

  f7              f7                         ctrl f7              PF3 vt52 mode

  f8              f8                         ctrl f8              PF4 vt52 mode

  f9              f9                         ctrl f9              -

  f10            f10                       ctrl f10             -

  f11            f11                       ctrl f11             -

  f12            f12                       ctrl f12             -

 PC-Key     VT220-Key          PC-Key          VT220-Key

-------------------------------      ------------------------------------

  shift f1        f11                     crtl shift f1        -

  shift f2        f12                     ctrl shift f2        -

  shift f3        f13                     ctrl shift f3        -

  shift f4        f14                     ctrl shift f4        -

  shift f5        f15                     ctrl shift f5        -

  shift f6        f16                     ctrl shift f6        -

  shift f7        f17                     ctrl shift f7        -

  shift f8        f18                     ctrl shift f8        -

  shift f9        f19                     ctrl shift f9        -

  shift f10      f20                     ctrl shift f10       -

  shift f11      f11                     ctrl shift f11       -

  shift f12      f12                     ctrl shift f12       -

The auxiliary keypad can also be used, and there is no change in the positions for these keys between PC and Vt220 keyboard. Keys PF1 - PF4 are  moved to ctrl f1 - f4

Editing keys:

 PC-Key                VT220-Key

----------------------------------------

HOME	FIND
END	SELECT
PAGE UP	PREV SCREEN
PAGE DOWN	NEXT SCREEN
INSERT	INSERT HERE
DELETE	REMOVE


Reference

Mocha W32 Telnet is an application written for Windows-95/NT. It makes it possible to connect to a host via TCP/IP with the Telnet protocol and emulate a VT220 terminal.


Technical Support

Visit the MochaSoft home page at www.mochasoft.dk, and receive information about how to contact MochaSoft.


Character mapping

It is possible to customize the mapping of characters between the Host and Mocha telnet. The default file ‘nettopc.map’ contains the mapping of Characters from the Host to Mocha Telnet and file ‘pctonet.map’ contains the mapping of data from Mocha Telnet to the Host.

Both files are simple ASCII files. The syntax is:

# is a comment

xxx yyy

where xxx is the decimal value (leading 0 as 020, gives the octal number 20) which will be translated to decimal value yyy.

If someone wants to change all incoming ‘1’ to ‘9’, in file nettopc.map add

   49  57

See also menu option  Mapping Files


File Print command
Print command (File menu)

Use this command to print a copy of the screen.   This command presents a Print dialog box, where you may specify the number of copies, the destination printer, and other printer setup options.


Print dialog box

The following options allow you to specify how the screen should be printed:

Printer

This is the active printer and printer connection.  Choose the Setup option to change the printer and printer connection.

Setup

Displays a Print Setup dialog box, so  you can select a printer and printer connection.

Copies

Specify the number of copies you want to print for the above page range.


Print Progress Dialog

The Printing dialog box is shown during the time that Mocha W32 Telnet is sending output to the printer.  The page number indicates the progress of the printing.

To abort printing, choose Cancel.


File Print Setup command
Print Setup command (File menu)

Use this command to select a printer and a printer connection.  This command presents a Print Setup dialog box, where you specify the printer and its connection.


Print Setup dialog box

The following options allow you to select the destination printer and its connection.

Printer

Select the printer you want to use.  Choose the Default Printer; or choose the Specific Printer option and select one of the current installed printers shown in the box.  You install printers and configure ports using the Windows Control Panel.

Orientation

Choose Portrait or Landscape.

Paper Size

Select the size of paper that the document is to be printed on.

Paper Source

Some printers offer multiple trays for different paper sources.  Specify the tray here.

Options

Displays a dialog box where you can make additional choices about printing, specific to the type of printer you have selected.

Network...

Choose this button to connect to a network location, assigning it a new drive letter.


File Page Setup Command
Page Setup command (File menu)