To configure a UNIX terminal emulation session, you'll need the connection specifics. At a minimum, you need the Hostname or IP address of the server, and the communications Protocol and Emulation Type the server requires.

There are no generic settings that will work for these options. Each is specific to a given server, as determined by the server administrator.

Connection Settings

First, enter a name for the connection. Then enter the Hostname or IP address and select the Protocol.

The default Port is 23 for telnet, 22 for SSH. On some systems, these values are different from the defaults as an added security measure. In that case, you'll need to enter the correct Port rather than accepting the default.

The Username and Password are required for SSH connections. They are not used by telnet. But they don't need to be entered here for SSH connections. If these fields are left blank, TinyTERM will prompt for each at connection time. The prompt dialogs also offer the option to save each for future use.

The Public Key drop-down allows you to select an SSH key to use with the connection, or to create a new one. For connections that use key authentication, select the key from the drop-down list. Leave this at n/a for telnet connections, or for SSH connections that use password or challenge-response authentication.

Turn on Auto Connect to have this configuration connect automatically when TinyTERM starts. Only one connection configuration may have this set. Turning it on in one connection automatically turns it off in any other that may have Auto Connect set.

With Auto Reconnect on, any time this session disconnects without error, such as when the user logs out, it will reconnect automatically. Turning on Ignore Connection Errors with Auto Reconnect will ignore and hide connection errors. Instead, the session will attempt to reconnect automatically.

The Prevent Disconnect switch prevents the user from disconnecting the session manually. The session only disconnects when the host sends the appropriate signal, such as after logging out.

Enable HTE causes this session to connect via proxy as defined in the Host TE Proxy settings. With Persist HTE Session also enabled, the host proxy maintains the connection to the server, even if TinyTERM loses connection to the proxy server.

Terminal Settings

Select the specific Emulation Type required by your host system and application. The optional Emulation Type String causes TinyTERM to report a terminal type other than the one selected. More information on that feature is in our Knowledge Base.

The Pre Scan Text and Post Scan Text allow you to enter text strings to be sent to the host automatically when a scan is performed. The Pre Scan Text is sent before the scanned data, and the Post Scan Text is sent after. If only a carriage return is needed, the Scan Sends CR switch provides that, in addition to any Post Scan Text.

Multi-byte Decoding determines whether or not TinyTERM uses Unicode character decoding. If this is not set to None, it overrides the Host Code Page setting. FIVE options are available:

• None
• UTF-8
• GP2312 (EUC-CN)
• Chinese Big 5
• Shift JIS

The Host Code Page determines which character set displays when Host UTF-8 Support is set to None. There are 50 code pages available, covering a wide range of languages and regions.

VT100 NRCS is the National Replacement Character Set for VT100 emulation. This determines which language characters the VT100 emulation uses.

VT200 Multinational provides a language-specific display setting for VT220, VT320 and VT420 emulations.

The WRU Answer Back string is sent to the host by TinyTERM Enterprise whenever the WRU Inquire character is received. The default value for the WRU Inquire character below is ASCII 5, Ctrl-E. This may be set to any ASCII value from 0-255, or set to -1 to disable WRU.

The WRU Answer Back string also accepts certain parameters that can send device-specific information to the host. These are documented in their own user guide.

Turn on Hide App Bar to prevent the application title bar from displaying at the top of the screen. A small down arrow at upper right of the emulation screen will bring it back for three seconds in this case.

BS Sends DEL determines the action of the ⌫ key. When off, the key sends sends a backspace (ASCII 8). The ON position causes it to send a Delete character instead (ASCII 127).

Close on disconnect will cause TinyTERM to close automatically when this session is disconnected, either by the user or by the server. It overrides the Auto Reconnect switch.

Turning on Ignore Graphics Parity causes all incoming characters to be read in strict 7-bit ASCII. This is needed by some older host systems.

Turning on Preserve Scale prevents changes to the screen size caused by updating the number of rows and columns in the emulator. This maintains the display at a constant size, regardless of other input. Pinch zoom still works in this mode, though.

The Silence Bell switch can be turned on to silence the BEL character when sent from the host. This is normally the device's default alert sound.

Portrait and Landscape Settings and AccuSpeech Settings have their own documentation.

The Color Settings determine the basic colors of the background, regular text, cursor and bold text.

Saving the Configuration

When finished, tap the back arrow to save the new configuration and return to the main TinyTERM screen. Or tap the Connect button to save the configuration and connect immediately.

Once a configuration is saved, you can launch it by selecting the name from the list of configurations.