Configuration File Keyword Reference - Terminal Emulation Settings

Items in this list configure terminal emulation settings for ssh and ssh2 command line sessions. These settings can be implemented by adding them manually to the Secure Shell configuration file, or by using the -o switch on the command line.

NOTE:These settings affect command line terminal sessions only; they have no affect on terminal sessions running in the Reflection user interface.

The configuration file is organized into sections, each identified by a Host keyword. Each section specifies settings to be used for all connections made using the specified host or SSH configuration scheme.

The configuration file consists of keywords followed by values. Configuration options may be separated by white space or by optional white space and exactly one equal sign (=). Keywords are case-insensitive and arguments are case-sensitive.

Any line starting with a number sign (#) is a comment. Any empty line is ignored.

Quotation marks are required around string arguments that include spaces. Terminal emulation keywords and arguments are not case-sensitive.

NOTE:Keywords for configuring Secure Shell connections are available in a separate list. See Configuration File Keyword Reference - Secure Shell Settings.

AnswerBackMessage

When AutoAnswerback is set to 'yes', AnswerBackMessagespecifies the string that is sent to the host in response to an answerback request (the ENQ character-ASCII 5).

  • Possible String Values: A string value of up to 30 characters.
  • Default: "" (null string)
  • Sample syntax:
AutoAnswerback yes
AnswerbackMessage "My answer back string"
AutoAnswerback

When AutoAnswerbackis set to yes, the message string specified using theAnswerBackMessagekeyword is automatically sent to the host after a connection is made.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
AutoAnswerback yes
AnswerbackMessage "My answer back string"
AutoWrap

Determines what happens when the cursor reaches the right margin. When set to yes, characters will wrap to the next line automatically when the cursor reaches the right margin of the terminal window. When set to no, the cursor is not automatically advanced when it reaches the right margin-as you type additional characters, each character overwrites the previous character until you move the cursor.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
AutoWrap yes
BackspaceKeyIsDel

Specifies the behavior of the backspace key. When set to no, the backspace key transmits a backspace (ASCII 8) character. When set to yes, the backspace key transmits the delete (ASCII 127) character.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
BackspaceKeyIsDel yes
CursorKeyMode

Specifies how the client handles keys on the cursor keypad. When set to no, the cursor keypad is set to normal mode-the cursor keypad keys transmit cursor escape sequences. When set to yes, the cursor keypad is set to application mode-cursor keypad keys will transmit application escape sequences.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
CursorKeyMode yes
CursorStyle

Specifies the cursor style.

  • Possible String Values: Block, Blockblink, Line, Lineblink
  • Default: Lineblink
  • Sample syntax:
CursorStyle Block
CursorVisible

Specifies whether the cursor is visible. When set to no, the cursor is not visible in the terminal window.

  • Possible Values: yes or no
  • Default: yes
  • Sample syntax:
CursorVisible no
DisplayCols

Sets the number of columns in the terminal window.

  • Possible Values: The minimum is 80. The maximum usable value depends on your monitor size and display settings.
  • Default: Determined by the current command window size.
  • Sample syntax:
DisplayCols 120
DisplayRows

Sets the number of rows in the terminal window.

  • Possible Values: The minimum is 24. The maximum usable value depends on your monitor size and display settings.
  • Default: Determined by the current command window size.
  • Sample syntax:
DisplayRows 30
HostCharacterSet

Specifies a non-default host character set.

Possible String Values:

  • PC437_English
  • PC737_Greek
  • PC775_Baltic
  • PC850_Multilingual
  • PC852_Slavic
  • PC855_Cyrillic
  • PC857_Turkish
  • PC858_Multilingual_Euro
  • PC860_Portuguese
  • PC861_Icelandic
  • PC862_Hebrew
  • PC863_CanadianFrench
  • PC864_Arabic
  • PC865_Nordic
  • PC866_Cyrillic
  • PC869_ModernGreek
  • PC932_Shift_JIS
  • PC936_SimplifiedChinese
  • PC949_Korean
  • PC950_TraditionalChinese
  • DECMultinational
  • UCS2
  • Windows1250
  • Windows1251
  • Windows1252
  • Windows1253
  • Windows1254
  • Windows1255
  • Windows1256
  • Windows1257
  • Windows1258
  • Korean_Johab
  • ISOLatin_1
  • ISOLatin_2
  • ISOLatin_3
  • ISO_Baltic
  • ISO_Cyrillic
  • ISO_Arabic
  • ISO_Greek
  • ISO_Hebrew
  • ISOLatin_5
  • ISOLatin_9
  • ISO2022_JIS
  • ISO2022_JIS-Allow
  • ISO2022_JIS-X0201_1989
  • ISO2022_Korean
  • ISO2022_SimplifiedChinese
  • ISO2022_TraditionalChinese
  • EUC_Japanese
  • EUC_SimplifiedChinese
  • EUC_Korean
  • EUC_TraditionalChinese
  • GB2312_SimplifiedChinese
  • GB18030_SimplifiedChinese
  • UTF7
  • UTF8

Default: PC437_English

Sample syntax:

HostCharacterSet EUC_Japanese
InsertMode

Specifies whether typing is in insert or replace mode. When set to no, typing replaces existing characters at the cursor location. When set to yes, new characters are inserted at the cursor location, and existing characters are moved to the right.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
InsertMode yes
InverseVideo

Specifies whether the terminal window uses inverse video. When set to yes, foreground and background colors for all screen attributes are reversed.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
InverseVideo yes
KeyBoardActionMode

Specifies whether the keyboard is available. When set to yes, the keyboard is locked and cannot be used.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
KeyBoardActionMode yes
MarginBell

Determines whether a margin bell sounds. When set to yes, the bell sounds when the cursor is eight characters from the right margin. Set this setting to no to prevent sounding the margin bell.

  • Possible Values: yes or no
  • Default: yes
  • Sample syntax:
MarginBell no
NewLine

Specifies whether the client is in linefeed or newline mode. When set to no (linefeed mode), pressing the Enter key sends only a carriage return. Received linefeeds, formfeeds, and vertical tabs move the cursor down one line in the current column. When set to yes (newline mode), pressing the Enter key sends both a carriage return and a linefeed. Received formfeeds, and vertical tabs move the cursor to the first column of the next line.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
NewLine yes
NRCSet

Use one of the supported string values to specify a different National Replacement Character set. You must also set the UseNRC keyword to yes to enable this.

Possible String Values:

  • British
  • Finnish
  • French
  • CanadianFrench
  • German
  • Italian
  • Norwegian
  • Portuguese
  • EuropeanSpanish
  • Swedish
  • SwissGerman
  • Default: ASCII
  • Sample syntax:
UseNRC yes
NRCSet British
NumericKeyPadMode

Specifies how the client handles the keys on the numeric key pad. When set to yes, the keypad is set to numeric mode — the keypad keys transmit numeric values when pressed. When set to no, the keypad is set to application mode — the keypad keys transmit application escape sequences such as home, up, and right.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
NumericKeyPadMode no
OriginMode

Specifies the cursor's home position. When set to no, the cursor's home position is at the upper-left hand corner of the terminal window. When set to yes the cursor's home position is relative to the terminal windows margin settings.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
OriginMode yes
SevenBitControls

Specifies how 8-bit C1 control codes are transmitted. When set to yes, 7-bit equivalents are transmitted for the 8-bit C1 control codes. When set to no, 8-bit C1 control codes are transmitted.

NOTE:The default value for HostCharacterSet for the sshcommand line client is PC437_English. If you want to send C1 controls, you need to set HostCharacterSet to DECMultinational or one of the ISOLatin character sets.

  • Possible Values: yes or no
  • Default: yes
  • Sample syntax:
SevenBitControls no
TerminalModel

Specifies which terminal type the client emulates.

  • Possible String Values: vt52, vt102, vt220
  • Default: vt220
  • Sample syntax:
TerminalModel vt102
UseNRC

When this is set to yes, you can specify a National Replacement Character set using the NRCSet keyword.

  • Possible Values: yes or no
  • Default: no
  • Sample syntax:
UseNRC yes
NRCSet British
UseANSIColor

When set to yes, ANSI color escape sequences are supported.

  • Possible Values: yes or no
  • Default: yes
  • Sample syntax:
UseANSIColor no
WarningBell

Specifies whether a warning bell sounds. When set to yes, the bell sounds when a bell character (ASCII 7) is received from the host or entered from the keyboard. Set this setting to no to prevent sounding the warning bell.

  • Possible Values: yes or no
  • Default: yes
  • Sample syntax:
WarningBell no