This error means that TinyTERM successfully connected to the server, but the login was denied. There are several possible causes:

• The username or password may have been typed incorrectly. Retype them both and verify the spelling on each.
• The wrong SSH connection method may be set. If the server accepts only RSA connections, but TinyTERM is using the username and password, this error will result. The reverse, using RSA to connect to a server set for username/password login, will also cause the error.
• The permissions on the file $HOME/.ssh/authorized_keys may be incorrect, and the file should be owned by the affected user. The permissions must be set to -rw——-, which can be done with this command:

chmod 600 authorized_keys

• Permissions to the $HOME and $HOME/.ssh should also be checked, and should not be writable by other users, which can be achieved by these commands:

chmod go-w $HOME/.ssh
chmod go-w $HOME

You can also view this information in a screencast by clicking here.

Century Software, Inc., now has screencasts on our website, video recordings that demonstrate different TinyTERM features and capabilities. The topics covered are:

• How to Configure an SSH Session for Password Authentication 
• How to Configure an SSH Session for RSA Authentication
• Preventing Disconnect Before Logout
• Troubleshooting Network Connection Errors
• Preventing Changes to the Connection Settings
• Printing to Your Windows Printers
• Troubleshooting SSH Connections
• Customizing the Keyboard
• Empty Directory in SecureFT
• TinyTERM Starts Minimized
• Using the Macro Recorder
• Installing TERM for UNIX
• Managing Multiple Host Connections
• Licensing a TinyTERM Evaluation Install
• Using Automatic Login
• Licensing and Registering TinyTERM 4.6
• Managing Licenses Using the New Customer Portal
• Changing the Printer Font Size
• Automating Deployment with MSI Installation

When connecting via SSH with an RSA key, you might see this message:

Connection failed (969) – Private key decryption failed

There are a couple of possible causes for this:

• You entered the wrong username or pass phrase. The RSA key is unique to the user on the host system, and requires a specific pass phrase. If either of these does not match the RSA key, the key will not decrypt properly.
• You have the wrong RSA key loaded in TinyTERM for the server. Each host requires its own RSA key, even if the username is the same for multiple systems.

To fix the error, verify the username and pass phrase you are using. Make sure there are no typos in either. If that does not help, you’ll need to double-check the RSA key you have loaded, and may need to regenerate it.

You can now view a screencast on this topic.

To make an SSH connection in TinyTERM Plus 4.x, do the following:

1. From TinyTERM’s Edit menu, select Session Properties.
2. Under Connection type, select SSH. (If SSH is not available, you have TinyTERM rather than TinyTERM Plus.)
3. In the Emulation drop-down list, select the terminal emulation required by your host.
4. In the Host name, IP address, or phone number box, enter the hostname or IP address of the server.
5. Click OK to close the Session Properties dialog.
6. From TinyTERM’s File menu, select Save Session.
7. Click the Connect button.
8. A login dialog will come up. Enter your username and password, then click OK.
9. If this is the first time you’ve used TinyTERM to connect to the particular host, a fingerprint dialog will come up. Click OK to continue connecting.

For video instructions, please see this screencast.

TERM for SCO UNIX  and TERM for Linux version 6.28 also have the ability to connect via SSH. To do this, you’ll need to start TERM from the command line like so:

term -lssh:user@host.or.ip

Replace “user” with the appropriate username, and “host.or.ip” with the hostname or IP address of the target system.

Before you can install TERM for UNIX from CD-ROM, you must mount the CD. Most UNIX platforms support SCSI or ISO 9660 CD-ROM drives. To find out whether or not the drive is recognized on the system, change directories to the /dev or /dev/dsk directory and type:

ls -l cd*

The permissions and device names will be displayed out, similar to the following example:

brw-rw-rw 1 root sys 51, Oct 28 08:16 cd0

In this case the CD-ROM device is cd0. Determine which device corresponds to your drive.

Mount the TERM for UNIX CD from the root directory by typing:

mount /dev/cd0 /mnt

Use the correct path for the CD-ROM device and the mount directory you prefer to use if not /mnt. Then change directories to /mnt/termunix and type ls to list the files and directories on the CD. Change directories again, this time to the directory that contains files for your platform:

Directory	Platform	TERM Version
ai	IBM PS/2 (AIX)	6.2.2
av	Data General 4000	6.2.3
h8	HP 9000 Series 700, 8×7	6.2.5
i6/3.x	IBM RS6000 (AIX 3.x)	6.2.3
i6/4.1	IBM RS6000 (AIX 4.1)	6.2.5
i6/4.2	IBM RS6000 (AIX 4.2 and higher)	6.2.5
ia	Altos Series 686, 886, 1086 SCO Xenix 286 Unisys IT, PW2 (XENIX)	6.1
m8	Motorola Delta Series 3000	6.2.5
mr	Motorola Delta Serives 8000, MPC	6.1
n4	NCR 3000	6.2.3
s4/solaris	Solaris	6.2.5
s4/sunos	SunOS	6.2.5
tu	Texas Instruments TI 1500	6.1
u3	Altos Series 500, 1000, 2000 Coherent 386 UNIX Convergent Tech Server (SPC 386) Intel 320 Interactive UNIX System V/386 SCO UNIX 5.x and higher	6.28
u3/old	SCO XENIX 386 Unisys 6000/3x, 6000/5x, 6000/6x Univel UnixWare	6.2.5b
u6	Sequent Series (PTX) Unisys 6000/70	6.2.2

For example, if your platform is SCO OpenServer 6, you would change to the u3 directory.

Next, copy the files from your chosen directory to the /tmp directory. Then change to the /tmp directory and extract each *.tar file separately with tar xvf:

tar xvf termu3.tar

At this point you can install TERM by running the install shell script:

/bin/sh ./install

Please note that on some CD releases, the files are in upper case. Any commands must refer to files in the correct case, upper or lower.

This information is also available in a screencast.

The keyboard may be remapped to suit specific needs for each user. In addition, more than one keyboard mapping may be set up, and keyboard mappings may be distributed to other PCs. This document addresses keyboard mapping in Windows versions of TERM and TinyTERM.

To change the keyboard scheme
From the TinyTERM 3.x or TERM 7.x Configure menu, select Keyboard. The Keyboard Select dialog box is then displayed.

In TinyTERM 4.x, from the Edit menu select Session Properties, then the Keyboard tab.

From the drop-down list, select the keyboard scheme to load. To have the selected scheme take effect, click the OK button. To leave the keyboard scheme as is, click the Cancel button.

Edit
To edit an existing keyboard scheme, select it and click the Edit button. In TinyTERM 3.x or TERM 7.x, it will be saved under the same name automatically. In TinyTERM 4.x, click the Save As button when done editing, then give the same name it had before.

After clicking the Edit button, the Keyboard Editor dialog box comes up. Some of the buttons in this dialog box are described below. The more obvious buttons — such as Cancel — are not described in the interest of document length.

Create a new keyboard scheme
To create a new keyboard mapping scheme in TinyTERM 3.x or TERM 7.x, type a description in the Keyboard Scheme edit field and click the Edit button. In TinyTERM 4.x, click the Save As button and give the scheme a new name.

The keyboard editor
All the keys in the keyboard edit window accept several actions:

• Any key can be dragged and dropped on any other key to change the destination key to send the sequence of the source key. The label on the destination key will change to the new value, and the font will be bold to show that the key has been changed.
• Any key can be clicked on and the key name will appear in the Keyname list box for manual editing.
• When the Alt, Shift or Ctrl key is clicked, the keyboard will redraw to display the keys modified by the selected key. Shift and Ctrl may be combined, but Alt is used alone. Keys that do not display a value are generally not mappable, except for the space bar.

The key chart
Clicking the Chart Open button opens the TCS chart. Characters from the chart can be dragged to keys in the keyboard editor. The target key will be set to the value of the character dragged and dropped. Each page of the TCS chart can be viewed by clicking the buttons labeled 1, 2, 3 and 4 on the right side of the chart.

The functions chart can be displayed by clicking the F Button. TinyTERM functions can be dragged from this chart to any key.

Set button
This button can be used to set or apply the contents of the Value Viewer text box to the selected key.

The Reset button
Clicking this button resets the selected key to its default value.

The Clipboard
The Clipboard is a temporary holding area for keys and values. Use the clipboard to drag keys and values from modified keys to unmodified keys and to drag keys and values from unmodified keys to modified keys. More information is available here.

Copy keyboard mappings
To copy keyboard mappings to other PCs running TinyTERM 3.x or TERM 7.x, simply copy the current .tap file and the keyboard.dat file to a network or floppy drive. The files can then be copied onto the other PCs.

For TinyTERM 4.x, simply copy the keyboard.dat file. No other files are needed for the keyboard schemes.

Common macro values

Macro	Meaning	Keyboard
\E or ^[	Escape	Esc
^M or \r	Enter or carriage return	Enter
\n or ^J	line feed	Ctrl-J
^	control	Ctrl
\x##	hex string	(n/a)

Example
Typing Ctrl-E in TinyTERM 3.x executes the internal command ECMD by default. To remap Ctrl-E to the value ^E, do the following:

1. Open the Keyboard Editor.
2. After selecting the correct keyboard scheme, click the Edit button.
3. Click the CTRL key on the keyboard map.
4. Click the key labeled FN1 where the E key should be.
5. Notice under Keyname that “^E” is displayed, and in Value is shown “<ECMD>”.
6. Remove <ECMD> in the Value box.
7. Click the Chart Open button.
8. Click on the club symbol in the chart (5th symbol on the first row), then drag the symbol to the Value Viewer box. The club symbol on an ASCII chart is the same as ^E.
9. The club symbol will be displayed in the Value Viewer box. The Value will display “<517>”, which is the internal TCS value.
10. Click the Set button, then click OK. Typing Ctrl-E will now send ^E.

You can also view this information in a screencast by clicking here.

In contrast to other Century Software, Inc., products, TinyTERM Web Server requires several additional steps after it’s installed.

First, you’ll install TinyTERM Web Server on an administrator’s PC (the “administrator copy”). This is a full copy of the TinyTERM Emulator, licensed for install on a single PC only. It allows you to create and modify .tpx connection files, as well as the .dat files used by TinyTERM. The administrator copy also includes a TinyTERM Web Server overview in the file C:\Program Files\Century\TinyTERM\ttws_admin\index.htm.

Once you have the administrator copy installed and your .tpx files created, you will need to upload them to the web server, together with some framing HTML code. A sample upload structure is available in the administrator copy as the directory C:\Program Files\Century\TinyTERM\ttwc.

You will also need to upload the TinyTERM Web Server Client install program. You’ll find that on your TinyTERM CD, in either the zipse or the downloadable directory, depending on the version you have. Each user must install the TinyTERM Web Server Client in order to access the .tpx files you’ve uploaded. It has no user interface and includes no default connection files, so it can only be used for Web-based connections. It includes both an ActiveX control for Internet Explorer and a Netscape plugin.

Once the end user has the TinyTERM Web Server Client installed, clicking a link to a .tpx file will offer the choice to open the file, or save it to disk. Select the option to open the file, and set the browser not to ask the question again for that file type. TinyTERM will open in the browser, using the connection parameters specified in the .tpx file.

Please note that TinyTERM Web Server does not change the look and feel of the host application. It’s still a character-based display.

Additional information is available in this screencast.

You can map TERM Script Language commands to a key in any version of TERM. Simply use the SETKEY command. For example, to map the command XMIT “This is a test” to Ctrl-F8, the command is:

setkey cf8 “@@xmit “This is a test””

To map multiple commands to a single key, put them all in a script file. You can then map that file to a key with the DO command. For example, to map the script myscript.cmd to the F5 function key, the command is:

setkey f5 “@@do myscript.cmd”

CScript handles this through the keyboard mapper instead. To map one or more script commands to a key, change the Action field to COMMAND, then enter the commands in one long string. For example:

te.cls();te.displaynl(“Hello World!”);

If you need to map a script to a key, use the CompileFile() command:

CompileFile(“scriptname.cs”);

You can also view this information in a screencast by clicking here.

If you need to repeat the same keyboard actions repeatedly in TinyTERM 4.x, the CScript scripting language can do it. In TinyTERM 4.30 and higher, you can do this automatically through the Macro Recorder.

This tool copies the keys you type in, watches for responses from the host system, and records it all to a CScript file. To use the Macro Recorder:

1. On the Tools menu, click Macro Recorder.
2. In the list box, type a name for the macro. If you accept the default name, the ## signs will be replaced by numbers; e.g., KeyMac00.cs. Every new macro will be assigned a new number, one higher than the last macro created.
3. Click the Record button to begin recording.
4. Type the commands and other keystrokes you wish to record. You must hit Enter at least once, or the macro will not be recorded.
5. Click the Pause button to temporarily halt recording and to start recording again later.
6. Click the Stop button to end recording and write the macro file.

There are two ways to execute the resulting macro:

1. Open the Macro Recorder. In the list box, type the name of the macro. Click the Play button.
2. Click on Tools | Execute Script File. Select the macro from the list of scripts, then click the Open button.

If the macro isn’t doing quite what you expected, you can record a new macro or edit the existing one. To edit, go to the Tools menu and select Script Editor. Click the Open button to select your macro, then edit it as you need to.

You can also view a screencast that demonstrates this process. For more information on script commands, see the TinyTERM Programmers Reference Manual. You can also contact our Support department for help writing and debugging macros and other CScript files.

CR 130, added in TinyTERM 4.30
CR 724, not enabled in TN3270 or TN5250
CR 800, must hit Enter

If you need to map the same function to several keys in TinyTERM for Windows, with only minor changes to each one, you can speed up the process so you don’t have to type the same thing repeatedly. Once you’ve mapped the first key, use the mouse to drag it to the Clipboard in the Keyboard Mapper. You’ll find it in the lower left-hand corner of the “Edit Keyboard Map” dialog box. This copies the entire key to the clipboard. You can then drag the Clipboard to any number of keys, making them all the same. Once that’s done, click on each of the keys you remapped to change them individually.

You can also view this information in a screencast by clicking here.