Telnet_SSH Menu Options

The Telnet_SSH menu bar displays five items: Commands, Edit, Options, View, and Help. They are described below.

The Help Menu

The Help menu contains the following menu commands:

Contents

Displays the Telnet help file.

About

Displays copyright, version and program information about Telnet_SSH.

The Commands Menu

The Commands menu contains the following menu commands:

Connect

The Connect item displays the Telnet Connect Host dialog box so you can specify the remote system you want to communicate with. You can also connect to a port or service to use other than the standard Telnet port. This is useful when the Telnet client is being used to access something other than a Telnet daemon.

This command is not available when you are already connected to a remote system.

Once you connect to the remote system, the title bar in the Telnet_SSH window shows the remote system name.

Disconnect

The Disconnect item ends the connection to a remote system so you can connect to another system or end your session. This command is not available when you are not connected to a remote system.

Interrupt Process

This command sends the Telnet Interrupt Process command (IP control function) to the remote host. This command (which suspends, interrupts, aborts, or terminates the operation of a user process) tells the host to stop the current process to which the terminal is connected. This function is frequently used when a user believes his process is in an unending loop, or when an unwanted process has been inadvertently activated.

Abort Output

This command sends the Telnet Abort Output command (AO control function) to the remote host. This command tells the host to run to completion the current process, which is generating output, but without sending the output to the user's terminal from the host. Further, this function typically clears any output already produced but not yet actually sent to the user's terminal.

Break

This command sends the Telnet Break command (BREAK control function) to the remote host. This command (intended to indicate that the Break Key or the Attention Key was hit) tells the host to stop what it is doing.

Are You There

This command sends the Telnet Are You There command (AYT control function) to the remote host. This command determines if the connection with the host is still up and the system is running. This command tells the host to send back to the user's terminal some visible evidence that the command was received. This function may be invoked by the user when the system is unexpectedly 'silent' for a long time, because of the unanticipated (by the user) length of a computation, an unusually heavy system load, etc.

Pause Output

This command pauses output (it sends Ctrl+S to the host). The Resume Output item then becomes active and can be selected.

Resume Output

This command resumes output (it sends Ctrl+Q to the host) after output has been paused.

Exit

The Exit item terminates the Telnet_SSH session.

The Edit Menu

The Edit menu displays two commands that allow you to edit the lines you type in a Telnet_SSH window: Erase Character and Erase Line. Also there are two standard commands, Copy and Paste, for text operations with the Microsoft Windows' clipboard.

Erase Character

The host should delete the last preceding undeleted character or print position from the data stream being supplied by the user. A print position may contain several characters that are the result of overstrikes, or of sequences such as <char1> BS <char2>...

Erase Line

The host should delete all the data in the current line of input, i.e. characters from the data stream back to, but not including, the last CR LF sequence sent over the TELNET connection.

Copy

To copy text onto the clipboard, leaving the original text intact and replacing the previous clipboard contents, select the text you want to copy, and choose Copy. This command is unavailable until you have selected text.

Paste

When there is text in the clipboard, you can use Paste to insert a copy of the clipboard contents at the insertion point to the Telnet_SSH window, or to another Microsoft Windows application. This command is not available if the clipboard is empty.

There are several ways in using Copy and Paste. The first example will be to show using your mouse.

1. In your Telnet window, scroll over with your mouse to the text you want to select.
2. Then click your left mouse button and hold it down to select the text you want to copy.
3. Once the text has been highlighted in a box frame, right click your mouse button to see the Copy to clipboard option, and then click on this button.
4. Your text has now been copied to the Microsoft clipboard, and you can now choose where you want to paste it.
5. Click on where you want the text to be pasted, and then right click on the mouse and click on the Paste from clipboard button. The original text that you copied was now pasted into the area you selected.

The second example will be to show using Menus.

1. With the same text to copy, you can highlight the text again. You will see a solid clear box appear around the selected text.
2. Click on the "Edit Menu" and then click on "Copy". This has now copied the selected text to the clipboard.
3. Now click to where you want the copied text pasted to. Click on the "Edit Menu" again and then click "Paste". This will paste the text into your chosen location.

To Copy and Paste, you can also use key combinations, "Ctrl+C"/"Ctrl+V" or "Ctrl_L+Shift_L+C"/"Ctrl_L+Shift_L+V".
For more information, see settings CtrlCVmode and QuickClipBoard.

See also settings SelectRect and FineSelectMode that you can use to specify different modes for text selection in your Telnet window.

Save ExtScreen

• To File
  This option lets you save the output buffer of your session into a file.



• To Clipboard
  This option lets you send the output buffer of your session to Clipboard.



• To File and View
  This option allows you to save the output buffer of your session into a file and then to invoke Notepad for you to view or edit the text.
  
  For example, to save a Telnet screen that you want to be written to a file, do the following as you are working in your Telnet window:
  1. Click on "EDIT", then click on "Save ExtScreen" and then click on "To File and View".
  2. Then choose which location you want to save the file to and also what name you want to call the file.
  3. After entering the file name and location where you are saving the Telnet screen, press the Save button. After this the screen shot has been saved. Then you will see a Notepad window with the screen content appear.

The View Menu

With options from this menu, you can navigate through the output buffer of your session. For additional information, refer to subsection Details of a Session in section Starting and Terminating Telnet_SSH.

The Actual Screen is the one that always displays the last line of the session's output. In this screen, you can only input your commands.

The First Extend Screen option displays lines for the first screen of the output buffer. The Prec Extend Screen option displays lines for the preceding screen (if any) from the current one. The Next Extend Screen option takes you to the next screen (if any) from the current one.

These options are only used for reviewing (not for entering) information and moving to screens. They suspend output into the output buffer and disable your input. To resume output and enable input, use the Actual Screen option.

To navigate through the output buffer, you can also use the Notepad-like view-key combinations.

The Find option lets you search text in the output buffer like you do that when using Notepad.

The Options Menu

Telnet_SSH allows you to personalize your settings and automatically use them every time you establish a connection to a remote computer. This is accomplished by storing your personalized settings in the corresponding ini-files. The Options menu displays items that you can choose to specify particular implementations of Telnet_SSH. Normally they do not have to be changed.

The Settings Option

You can specify the terminal emulation settings for the current connection by choosing the Settings item on the Options menu from the main window.

Also, you can click the Settings button in the Telnet Connect Host dialog box where you can also make some initial settings for your session (that are described in subsection Details of a Session in section Starting and Terminating Telnet_SSH).

The Telnet Settings window presents you with a dialog of six tabs that allow you to view and modify the current terminal emulation settings. The tabs are described below.

The Keys Tab

If Enter is pressed

Options in this group box define the end-of-line sequence sent when you press the Return or Enter key.

If Backspace is pressed

Options in this group box specify whether the Backspace key will be interpreted as Erase Character, Backspace, or Delete.

Add LF after CR received

This option allows you to modify (or not) the CR code received over the network.

Auto wraparound

If this check box is enabled, input text will be automatically wrapped on the next line when your string is too long (i.e. any characters received when the cursor is at the right margin will be displayed on the next line).

Otherwise, input is stopped so you cannot enter more characters (i.e. any characters received when the cursor is at the right margin will be displayed just to the left of the right margin, replacing the current character displayed there).

Keyboard Layout

Options in this group box specify which keyboard layout will be used: PC layout or VT layout.

Local Echo

Some Telnet daemons may not support the standard Telnet protocol (and do not send a symbol of a pressed key). With the Use Local Echo check box enabled, you can display a key character regardless response from that Telnet daemon.

The Type Tab

Terminal Refresh

This group box allows you to change values of parameters that control the screen buffer output and modify the characteristics of your keyboard.

The Time delay (msec) parameter sets the time interval (20...1000) that defines when to display lines with character(s) received.

The Screen Renovation Rate parameter sets the ratio (5%...100%) of screen changes (e.g. characters entered or modified) to full screen that defines when the screen area modified will be re-displayed.

Terminal Type

This option allows you to change emulation modes for the Telnet_SSH session by selecting one of the available modes from the Terminal Type list. The mode must correspond to that assigned in the TERM() command when logging in. Telnet_SSH adjusts your system so that your computer, keyboard, and terminal perform just as the specified terminal does. The modes are popular control sets used in terminals originally manufactured by Digital Equipment Corporation (DEC). If you are not sure which terminal to select, select VT-100 (ANSI escape sequences).

The Text Tab

You can specify the lines of text that you want to be retained in memory so that you can scroll through it in the window. Options in this group box let you specify the number of lines (24/36/48) and columns (80/132) that will appear in the Telnet_SSH window.

DRCS 8-bit

When this radio button is enabled, you define to work in the 8-bit environment and send the 8-bit control sequences and graphic characters (Multinational character transmission mode), including supplemental characters.

In this mode, you can download soft character sets from the host system into the terminal. The soft character set is also known as a dynamically redefinable character set (DRCS). This feature lets you design your own soft character sets for use with the terminal.

You can use the DECDLD control string command to down-line load one or more characters of a specified 94- or 96-character DRCS with a specified logical pixel pattern.

NRCS 7-bit

When this radio button is enabled, you choose to work in the 7-bit environment only. Select one of the 7-bit character sets from the National Replacement Character Sets (NRCS) pull-down list box to allow for country/region's replacement characters to be sent in the 7-bit escape/control sequences (National character transmission mode).

The following NRC sets are available:

• ASCII
• DEC Special Graphics
• DEC Supplemental
• British
• Dutch
• Finnish
• Norwegian/Danish
• Swedish
• French
• French Canadian
• German
• Italian
• Spanish
• Swiss

In VT100 mode, VT52 mode, or when 7-bit NRCS characters is selected (through Set-Up or the DECNRCM command), only ASCII, NRC sets, and DEC Special Graphic characters are available.

Default Font

Characters in the Telnet_SSH window appear in the specified font, size, and colors. Options in this group box allow you to change font parameters used to display text in the Telnet_SSH window.

Browse

When you press this button, the Font standard dialog box appears. This dialog box changes the font name, style, and size of text displayed in the Telnet_SSH window. Also, you can choose a desired font script, color, and effects (strikeout and underline).

When you press the Background button, the Color standard dialog box appears. You can define your color for your background. The Colors tab allows you to customize the color of your screen by emulating the color of the host's attributes. The colors you set in this tab are not altered by the colors settings you make in the Windows Control Panel.

The Text Tab for the XTERM Type

You use this tab to select font and specify screen size. Also, you can choose one of the three modes to define appearance of your font against window size (for the XTERM terminal type only).

The XTERM terminal emulation provides the 16-colors mode instead of B/W one.

Rows

This field lets you specify the number of rows that will appear in your emulation window.

Columns

This field lets you specify the number of columns that will appear in your emulation window.

The Set Window Size Box

In this box, you can select one of the three modes to define appearance of your font against window size.

• Standard
  The row and column numbers define the size of your actual screen (see section The View Menu). The values are read in from the ini-file (first from the terminal definition file, Terminfo.ini).
  
  In this mode, your initial window size will only be defined by the screen size and font size selected. The window displays scrollbars when its size is less than that of the screen.
  
  The Wide screen check box toggles the number of columns between 80 and 132.



• Change WinSize
  The row and column numbers you specified define the size of actual screen (see section The View Menu). You may type in up to 1024 rows of 132 columns each.
  In this mode, font appearance will not be changed when you change your window size. The window displays scrollbars when its size is less than that of the screen.
  
  With the Fit to screen check box selected, an application window is fully displayed on the PC's screen (i.e., it does not cross screen boundaries). If necessary, Scroll Bars are created.
  
  With the Dynamic resize check box selected, the "no scrollbar" mode is provided. The actual Rows and Columns numbers are dynamically being changed while window resizing.



• Change Font Size
  The row and column numbers you specified define the size of actual screen (see section The View Menu). You may type in up to 1024 rows of 132 columns each.
  In this mode, font appearance will be changed according to your window size. The window displays the entire screen.
  
  With the Proportional check box selected, the vertical dimension will only define font appearance. Otherwise, both dimensions of your window will define it.

The User Defined Tab

This tab allows any functional key to be programmed with a user-defined sequence. User-defined keys (UDKs) are a subset of functional keys.

The UDK group box contains a list box with currently defined keys for a current emulation mode. This box allows you to map key symbols to the Unshifted, Shifted, Mode Switched, and Shift-Mode Switched states of the key. You can select a key symbol and then clear (with the Clear button), define or re-define its function value (in the Definition edit field).

You can use UDKs like a macro defined for a functional key: whenever you want to forward a user-defined control string to a host you press the key combination to activate the value. (Also see the List Assigned Functions dialog box in the Keyboard Mapping option below for already defined functional keys.)

Note: some function key combinations are reserved by MS Windows and cannot be redefined.

Upon terminating Telnet_SSH sessions or pressing OK, UDKs are stored in the terminfo.ini file (in the emulation mode section; see Appendix B for details), so they will be defaults for the next session when the file will be read in.

Lock against future definition

Use this check box to lock/unlock UDKs listed against future redefinition (from a remote host).

Definition

This edit field is used to enter new control string codes for UDKs. The string can include any combination of escape sequences, control sequences, or text (without any separating character). The string should be in valid format for the terminal emulation mode. You can scroll the field left or right as needed to allow longer strings to be entered.

Set

This button assigns the value entered in the Definition field to the UDK currently selected in the list box (for the current terminal emulation mode). This key combination will activate the value whenever it is pressed.

Clear

This button removes a value for a currently selected UDK.

Clear All

Click this button to delete the mapping for all UDKs listed.

OK

Pressing OK saves current UDK settings and quits the dialog box.

Cancel

You can cancel any changes you made to the dialog box by clicking on this button.

The Keyboard Mapping Option

By using the Keyboard Mapping Option (i.e. keymap editor invoking), you can load, change (re-define keys and create a new keyboard layout), and save any keyboard definition file.

Keyboard files are text files that define the X Protocol Key Symbols (Keysyms) which are mapped to keys on your keyboard. By default, they have the extension KMF, and are located in the home directory. You specify the KMF file to be used by all WinaXe Plus's programs in the XSettings window.

The keyboard mapping file format uses scancodes which allow the terminal to transmit make and break codes for each keystroke corresponding to the hardware scan codes used by PC keyboards (scan set 1). Make means when the key is pressed; break means when the key is released. The Keyboard Mapping File Format is described in Appendix A.

The Keyboard Mapping dialog box of the keymap editor allows you to map Keysyms, Characters, or Compose Key Sequences to existing keys on your keyboard.

Keysyms is the encoding of a symbol to a key that exists on a physical keyboard.

Compose Key Sequences are key combinations to produce special Keysyms such as accented characters. These Keysyms are generated by typing two keystrokes. The first key is known as a composing key. Each Compose Sequence consists of two key combinations which generate a new pseudo key.

Modifiers are keys that modify the action of other keys. They are not to be confused with a Keysym. In X Keys they include Shift, Lock, Control, and Mod1 through Mod5. Mod1 through Mod5 are the logical keynames for modifier keys that vary from workstation to workstation. Caution should be used when assigning modifiers to latching keys (NumLock, ScrollLock, or CapsLock). Modifiers mapped to these keys should not be used to modify keys in compose sequences.

The upper portion of the Keyboard Mapping dialog box contains a standard keyboard layout. The currently loaded keyboard mapping file name and the terminal emulation mode are displayed at the top of the window.

On the KeyPad group box, the KeyPad layout is shown according to the PC Layout and VT Layout radio buttons states. You can toggle between them to change the KeyPad layout.

NumLock

If you enable the NumLock check box, the numeric keypad keys will work as they normally do on your PC (local latched mode). If this option is not checked, the behavior of NumLock is determined by the remote host.

Load

When you press this button, the Open standard dialog box to open files appears, allowing you to select and load a keyboard mapping file for viewing and modifying.

Save As

When you press this button, the Save As standard dialog box to save files appears, which allows you to save your current keyboard mapping under a new filename.

Select Function type

On this list box, you can select one of the function types: XK_symbol, Character, or Composer to display all values available for it in the Function list box.

Function

On this list box, you can select a value for:

• Assigning it to a key with the Set button
• Modifying it with the Edit function button.

If the Function type selected is XK_symbol, a list is displayed containing all of the XKeysyms available.

If the Function type selected is Character, a list is displayed containing all of the characters available (including accented characters) with its (decimal/hex) keycode pairs.

If the Function type selected is Composer, a list is displayed containing all of the Compose Key Sequences available.

Set

When you click a key on the keyboard layout, it appears in the Current Key group box with its current definitions:

• Normal (unshifted/unmodified)
• Shifted
• Modified (with the Alt GR key).

When you have a value highlighted on the Function list box (of type: XK_symbol, Character, or Composer) and a key selected on the keyboard layout, you can press the Set button to change current values assigned to the key and displayed on the Current Key group box to the new value (according to the radio buttons' states).

Undo

Use this button to immediately restore the previous key value every time you press the Set button.

List Assigned Functions

When you press this button, a dialog box appears that allows you to view a list of functions already assigned to functional keys (for the current terminal emulation mode). The list contains function names (X Keysyms), function values (code sequences), and comments on them.

Edit function

When you have a highlighted function of either the XK_symbol or Composer type, you can press the Edit function button to change the value to define a new key sequence for the function (and current terminal emulation mode). The New value dialog box will appear on your screen.

The Function group box shows the currently selected function.

Value

This edit field is used to enter a new string for the selected function. The string can include decimal codes (in the range of 0...255) separated with the comma character (as in the List Assigned Functions dialog box). The string should be in valid KMF format described in Appendix A.

Preview

This field displays a comment value for a selected function.

Comments

Use this field to enter a new comment for the function you define.

Set

This button stores new values you entered and exits the dialog.

Cancel

You can cancel any changes you made to the dialog box by clicking on this button.

The Forwarding Option

Port forwarding is the concept of connecting a logical port on a local machine to a port on a remote machine over a secure (encrypted) channel. All requests for services sent to the local port are then forwarded across the secure channel to the corresponding port on the remote machine.

Port forwarding of arbitrary TCP/IP connections over the secure channel can be used for secure connections to electronic purses or going through firewalls. Port forwarding is a powerful tool that allows you to secure TCP/IP traffic by using Telnet_SSH' SSH1/SSH2 protocol support. This means that you can encrypt application data for insecure network traffic using protocols like SMTP, POP, and IMAP.

Telnet_SSH supports X11 forwarding. This feature allows X Window traffic between the X server and X client (forwarding X Window packets through the SSH session) to be encrypted.

In general, with any port forwarded by Telnet_SSH for an application, the application needs to be configured to use 127.0.0.1 (otherwise known as "localhost" or "loopback") as its application server address. Hostname and port configuration needs to be done in both Telnet_SSH and the client application (e.g., e-mail). After connecting with this session, the client application traffic is encrypted to the SSH server as long as Telnet_SSH is running. If the connection to the SSH server is broken or closed, the forwarded ports will no longer be forwarded, and the client applications may receive an error when they try to connect to the local port.

It is important to understand that the client data is only encrypted between the machine that Telnet_SSH is running on and the SSH server that Telnet_SSH is connected to. Any data moving from the SSH server across the network to another server is not encrypted.

The Forwarding option presents you with the Forwarding Setup window (for the SSH1/SSH2 protocol mode):

The Port Forwarding Box

Add

This button allows you to add entries into the Port Forwarding list. When you press the button, the empty SSH Port Forwarding window will appear, and you can specify new port forwarding settings.

Edit

This button allows you to modify an entry selected on the Port Forwarding list. When you press the button, the SSH Port Forwarding window will appear, and you can modify current settings for the entry.

Remove

This button allows you to remove selected entries from the Port Forwarding list.

The X Forwarding Box

Display remote X applications on local X server

This check box specifies whether X11 connections will be automatically redirected over the secure channel. This feature allows X Window traffic between the X server and X client (forwarding X Window packets through the SSH session) to be encrypted.

X11 forwarding is the process of transporting X11 data over an encrypted channel from a remote machine to a local machine. In this mode, the SSH server automatically sets the DISPLAY environment variable on the server machine, and forwards any X11 connections over the secure channel. Fake Xauthority information is automatically generated and forwarded to the remote machine (your PC); the local client automatically examines incoming X11 connections and replaces the fake authorization data with the real data (never telling the remote machine the real information).

Note: the X Forwarding option allows Telnet_SSH to accept X11 data from the remote machine and forward it to the X server running on the local machine. Telnet_SSH does not work as an X server. The local X server must be running before any X11 sessions can be displayed. If you are using Xhost authority access on the local X server, you will need to add address 127.0.0.1 (otherwise known as "localhost" or "loopback") to your server's Xhost list.

The DISPLAY variable indicates the location of the X11 server. It is automatically set by SSH to point to a value of the form "hostname:n" where hostname indicates the host where the shell runs (the server machine), and n is an integer greater than zero (a display number). This is normal, and happens because SSH creates a "proxy" X server on the server machine for forwarding the connections over the encrypted channel. The SSH server uses this special value to forward X11 connections over the secure channel. The user should normally not set DISPLAY explicitly, as that will render the X11 connection insecure (and will require the user to manually copy any required authorization cookies).

If the user is using X11 (the DISPLAY environment variable is set), the connection to the X11 display is automatically forwarded to the remote side in such a way that any X11 programs started from the shell (or command) will go through the encrypted channel, and the connection to the real X server will be made from the local machine.

When you press the Add or Edit buttons in the Forwarding Setup window the SSH Port Forwarding window will appear:

This dialog box lets you specify data for port forwarding. Ports may be defined either by their port number or by their service name.

Arbitrary TCP/IP ports can be redirected through the encrypted channel in both directions (e.g., for e-cash transactions).

Forward local port

Specifies that the given TCP/IP port on the local (client) machine be forwarded to the given host and port on the remote side. This works by allocating a socket to be listened port on the local side, and whenever a connection is made to this port, the connection is forwarded over the secure channel and is made to host:hostport from the remote machine.

When enabled, this radio button allows you to enter the local port in the entry field or select its service name from the corresponding drop-down list box.

To remote machine

Enter the remote host name or IP address.

port

Enter the remote host port in the entry field or select its service name from the corresponding drop-down list box.

Forward remote server port

Specifies that the given TCP/IP port on the remote (server) host be forwarded to the given host and port on the local side. This works by allocating a socket to listen to port on the remote side, and whenever a connection is made to this port, the connection is forwarded over the secure channel, and is made to host:hostport from the local machine.

When enabled, this radio button allows you to enter the remote port in the entry field or select its service name from the corresponding drop-down list box.

To local machine

Enter the local machine name or IP address.

port

Enter the local machine port in the entry field or select its service name from the corresponding drop-down list box.

The Save FWD Settings Option

When you press this button (for SSH1/SSH2 protocol mode), the Forwarding settings you have made will be stored. They will take effect immediately for the current connection, otherwise - with the new session.