File TERMINAL.TXT Frank da Cruz and Christine M. Gianone As of: Applies to Kermit 95 1.1.16 Most recent update: 8 April 1998 Copyright (C) 1995, 1998, Trustees of Columbia University in the City of New York. All rights reserved. Kermit 95's SET TERMINAL and related commands. These commands can be issued at the K-95> prompt in the Command window to change most aspects of the terminal emulator. SET BELL { AUDIBLE { BEEP, SYSTEM-SOUNDS }, VISIBLE, NONE } This command tells how bell (beep) characters / noises should be sounded or displayed. VISIBLE means to flash the screen rather than making a noise. AUDIBLE means to make a noise, which can be either the standard "beep", or else "System sounds" that give you three different noises for "information", "warning", and "error". SET COMMAND COLOR Like SET TERMINAL COLOR, except for the Command screen. This command lets you choose the fore- and background colors of the Command screen. See SET TERMINAL COLOR, or type "set command color ?", for a list of colors to choose from. Example: "set command color black white" for black letters on a white background. SET TERMINAL TYPE { ANSI, TTY, VT52, VT100, VT102, VT220, VT320, ... } Choose the type of terminal that Kermit should emulate in the Terminal window. As of version 1.1.13, the complete list of emulations is: AIXTERM For use with IBM AIX hosts ANSI-BBS Standard ANSI BBS character graphics (color) Avatar/0+ Enhanced BBS graphics (color) AT386 UnixWare and Interactive UNIX consoles (color) BA80 Siemens Nixdorf BA80 BETERM BeBox Console DG200 Data General DASHER 200 DG210 Data General DASHER 210 DG217 Data General DASHER 217 HFT IBM High Function Terminal Heath19 Heath/Zenith-19 HP2621 Hewlett Packard 2621A HPTERM Hewlett Packard X-Terminal HZ1500 Hazeltine 1500 LINUX Linux Console QANSI QNX ANSI QNX QNX Console SCOANSI SCO and Linux consoles (color) SNI-97801 Siemens Nixdorf Bildschirmeinheit 97801-5xx for SINIX TTY Teletype TV910+ Televideo 910+ TV925 Televideo 925 TV950 Televideo 950 VC404 Volker Craig 404 VIP7809 Honeywell VIP7809 VT52 Digital Equipment Corporation (DEC) VT52 VT100 DEC VT100 + color VT102 DEC VT102 + color VT220 DEC VT220 + color VT320 DEC VT320 + color WY30 Wyse 30 (and most of 30+ and 35) (*) WY50 Wyse 50 WY60 Wyse 60 (and most of 120, 160, and 350) (*) WY370 Wyse 370 (color) See pages 31-33 of "Kermit 95" and UPDATES.TXT Section 3 for further information. SET TERMINAL ANSWERBACK { OFF, ON } Disables/enables the ENQ/Answerback sequence, which is: K-95 501192 xxxx where "xxxx" is the terminal emulation, such as VT320, and is a carriage return. 501192 is the Kermit software version number. When SET TERM ANSWERBACK is ON, this message is sent automatically by Kermit 95 when a Ctrl-E is received. TERM ANSWERBACK is OFF by default. SET TERMINAL APC { OFF, ON, UNCHECKED } Controls execution of Application Program Commands sent by the host while Kermit-95's terminal screen is active. ON allows execution of "safe" commands and disallows obviously dangerous commands such as DELETE, RENAME, OUTPUT, and RUN. OFF prevents execution of APCs. UNCHECKED allows execution of all commands. OFF is the default. See Section 3.1 of the CKERMIT.UPD file for a full explanation. SET TERMINAL ARROW-KEYS { APPLICATION, CURSOR } Sets the mode for the arrow keys during VT terminal emulation so that they send the "right stuff" when pressed. Normally the host application should put them in the right mode; use this command to force the arrow keys into the desired mode when they do not seem to work with your host application. SET TERMINAL ATTR-BUG { ON, OFF } (invisible) ON (default) says to avoid a bug in Windows 95 by not writing video attributes (color, intensity, etc) into any screen that is not 24x80, 42x80, or 49x80. When Microsoft fixes the Windows 95 bug, you can SET TERM ATTR-BUG ON to allow attributes to be written into screens of any size. (As of 1.1.12 this command is no longer required.) SET TERMINAL ATTRIBUTE { BLINK, PROTECTED, REVERSE, UNDERLINE } { ON, OFF } Determines whether real Blinking, Reverse, and Underline are used in the terminal display. When BLINK is turned OFF, reverse background intensity is used. When REVERSE and UNDERLINE are OFF, the colors selected with SET TERMINAL COLOR { REVERSE, UNDERLINE } are used instead. This command affects the entire current screen and the entire terminal scrollback buffer. SET TERMINAL ATTRIBUTE PROTECTED { BOLD, DIM, INVISIBLE, NORMAL, REVERSE, ... } Tells how protected fields should be shown. SET TERMINAL AUTODOWNLOAD { ON, OFF, KERMIT , ZMODEM } Tells whether Kermit and ZMODEM download initiations should be recognized during terminal emulation (and INPUT command execution). ON, the default, means they are. This feature allows Kermit 95 to switch immediately into Kermit or ZMODEM receive mode and then switch back to terminal emulation automatically when the transfer is finished. This command also applies to automatic uploading when using the Kermit protocol (or more precisely, to automatic Kermit server activation -- see UPDATES.TXT, section 5.1). Special options can be specified separately for Kermit and ZMODEM protocols: C0-CONFLICT { IGNORED-BY-EMULATOR, PROCESSED-BY-EMULATOR } How C0 control characters (such as Ctrl-A or Ctrl-X) are treated by the terminal emulator when they have conflicting interpretations. For example, in DG or Wyse emulation, a Ctrl-A or Ctrl-X starts a host-directed print operation, but Ctrl-A is also the start of a Kermit packet and Ctrl-X is also the start of a ZMODEM packet. PROCESSED-BY-EMULATOR is the default C0-CONFLICT action. NOTE: There are no conflicts in VT or ANSI emulation. DETECTION { PACKET, STRING } The autodownload detection method for this protocol: PACKET (i.e. a valid Kermit of Zmodem packet), or STRING -- that is, a specific string of characters. The default detection method is PACKET, as in prior releases. STRING When SET TERM AUTO { KERMIT, ZMODEM } DETECTION STRING is elected, this command specifies the string that triggers automatic entry into file reception mode for the given protocol. Examples (showing the defaults for each protocol): SET TERM AUTO ZMODEM rz\13 SET TERM AUTO KERMIT READY TO SEND... SET TERMINAL AUTOPAGE { ON, OFF } AUTOPAGE mode is used on Wyse and Televideo terminals. AUTOPAGE mode causes the cursor to move to the top of the next page of terminal memory when it scrolls off the bottom of the current page. In K95, it moves the cursor to the top line from the bottom since K95 only supports a single page of terminal memory. SET TERMINAL AUTOSCROLL { ON, OFF } AUTOSCROLL mode is used on Televideo terminals when the size of a page of terminal memory is larger than the view screen. SET TERMINAL BELL { AUDIBLE, VISIBLE, NONE } Specifies how Control-G (bell) characters are handled. AUDIBLE means a beep is sounded; VISIBLE means the screen is flashed momentarily. This command has been superseded by SET BELL, which applies also to the command screen. SET TERMINAL BYTESIZE { 7, 8 } To use 7- or 8-bit terminal characters between Kermit 95 and the other computer or service in the Terminal screen. NOTE: To use 8-bit characters, you must not have PARITY set to anything other than NONE. SET PARITY NONE is the default. SET TERMINAL CHARACTER-SET [ ] Set the Terminal screen up to translate between the character set used on the other computer and the one used on your PC. Type "set term char ?" for a list of available character sets. NOTE: This command is supplied only for compatibility with UNIX/VMS C-Kermit. In Kermit 95, you should specify the remote and local character sets in two separate commands: SET TERMINAL REMOTE-CHARACTER-SET and SET TERMINAL LOCAL-CHARACTER-SET (q.v.) SET TERMINAL CODE-PAGE nnn This command should not be used in Windows. In OS/2, it actually loads the given code page into your session. Works only for fullscreen sessions. SET TERMINAL COLOR Choose the fore- and background colors for the designated screen part. Type "set terminal color ?" to see a list of screen parts. Colors are: BLACK, BLUE, GREEN, CYAN, RED, MAGENTA, BROWN, LGRAY, DGRAY, LBLUE, LGREEN, LCYAN, LRED, LMAGENTA, YELLOW or WHITE. The L prefix for the color names means Light. SET TERMINAL COLOR ERASE { CURRENT-COLOR, DEFAULT-COLOR } Determines whether the current color as set by the host or the default color as set by the user (SET TERMINAL COLOR TERMINAL) is used to clear the screen when erase commands are received from the host. SET TERMINAL COLOR RESET-ON-ESC[0m { CURRENT-COLOR, DEFAULT-COLOR } Determines whether the current color or the default color is used after an ESC [ 0 m ("reset attributes") command sequence is received from the host. For all emulations except for AT386, the default value is CURRENT-COLOR, meaning that ESC [ 0 m does not affect coloration. DEFAULT-COLOR means that ESC [ 0 m changes to your current SET TERMINAL COLOR TERMINAL color. SET TERMINAL CONTROLS { 7, 8 } Version 1.1.5. Applies to VT220/320 and Wyse 370 emulation. Determines whether function keys, arrow keys, etc, that generate ANSI-format escape sequences should send 8-bit control characters (such as CSI, 155 decimal) or their 7-bit equivalents (such as ESC [ instead of CSI). Default is 7. SET TERMINAL CR-DISPLAY { CRLF, NORMAL } To specify how incoming carriage return (CR) characters are to be displayed on your screen. NORMAL (the default) means a CR is displayed as itself. CRLF means a CR is displayed as a carriage return and a line feed (LF). Use CRLF when incoming lines of text write over each other, for example when two two Kermit programs are connected to each other in "chat" mode. Note: this is like SET TERMINAL CR-DISPLAY, but in the other direction. SET TERMINAL CURSOR { FULL, HALF, UNDERLINE } [ { ON, OFF } ] Selects cursor style and turns the cursor on unless the trailing keyword OFF is included, in which case the cursor is turned off. SET TERMINAL DEBUG { ON, OFF } Controls terminal session debugging. You can also use Alt-D in the Terminal screen to toggle session debugging on and off (see "Kermit 95", p.61). SET TERMINAL ECHO { LOCAL, REMOTE } Specifies which side does the echoing during terminal connection. If every character you type appears twice, then "set term echo remote". If you do not see the characters you type, then "set term echo local". SET TERMINAL ESCAPE-CHARACTER { ENABLED, DISABLED } Since we can use Alt-key or other non-ASCII keys or combinations in Windows to escape back, etc, we don't necessarily need to reserve one ASCII control character for that purpose, even though we do by default -- Ctrl-] -- for compatibility with MS-DOS Kermit. Use SET TERM ESC DISABLED to disable the CONNECT-mode escape character, so you can type all ASCII control characters without having to double any of them. SET TERMINAL HEIGHT Changes the number of rows (lines) to use during terminal emulation, not counting the status line. The only values that work well in Windows 95 are 24, 43, and 49. SET TERMINAL IDLE-SEND [ ] If Kermit 95 is in CONNECT mode and the keyboard has not been touched in the specified number of seconds, Kermit 95 sends the given to the host as if it had been typed. may contain regular characters, backslash codes (control characters, variables, etc). SET TERMINAL KEY [ /LITERAL ] - [ ] Like SET KEY, but specific to the given terminal type or keyboard mode. /LITERAL means that no character-set translations should be applied when using this key. SET TERMINAL KEYBOARD-MODE { NORMAL, EMACS, HEBREW, RUSSIAN, WP } Selects the named special keyboard mode (WP = WordPerfect). SET TERMINAL KEYPAD-MODE { APPLICATION, NUMERIC } To specify the numeric keypad mode for VT terminal emulation (in case the host application does not put the keypad in the right mode automatically -- i.e. use this if your keypad keys do not behave as they should). SET TERMINAL LOCAL-CHARACTER SET Specify the character set used by the session (screen, window, etc) on your PC in which Kermit 95 is running. Kermit 95 translates between this character set and the TERMINAL REMOTE-CHARACTER-SET during terminal emulation. SET TERMINAL LOCKING-SHIFT { OFF, ON } Tells Kermit 95 whether to send Shift-In/Shift-Out (Ctrl-O and Ctrl-N) to switch between 7-bit and 8-bit characters sent during terminal emulation over 7-bit connections. OFF by default. SET TERMINAL MARGIN-BELL { ON [ ], OFF } Allows user to turn typewriter-like margin bell on and off, and when turned ON, also to specify the column at which the bell is rung, e.g. "set term margin-bell on 72". SET TERMINAL NEWLINE-MODE { OFF, ON } Tells what to send when you press the Enter key while in the Terminal screen. Normally only carriage return (CR) is sent. SET TERM NEWLINE ON means to send CR and linefeed (LF). Use this command only if the Enter key does not seem to produce the appropriate effect in the Terminal screen. Note: this is like SET TERMINAL CR-DISPLAY, but in the other direction. SET TERMINAL OUTPUT-PACING Tells how long to pause between sending each character to the host when the Terminal screen is active. Normally not needed but sometimes required to work around TRANSMISSION BLOCKED conditions when using the mouse to paste into the terminal screen. SET TERMINAL REMOTE-CHARACTER SET [ { G0, G1, G2, G3, ALL } ] Specify the character set used by the host or application that Kermit 95 is connected to, and assign it to one of the tables G0 through G3, or to ALL four of them. By default, ASCII is assigned to G0, any other national 7-bit set is assigned to ALL, and any 8-bit set is assigned to G1. The host switches among G0,G1,G2,G3 by setting the 8th bit of a character to 0 or 1, or with Shift-In/Shift-Out, or with escape sequences. The host can also designate characters to the Gn tables, and normally it will do so if it expects to find them there. So in most cases you need not be concerned with what's in G0..G3. This command is to force correct behavior in cases where the host application is doing something wrong. SET TERMINAL ROLL-MODE { INSERT, OVERWRITE } Tells what to do when you have the Terminal screen rolled back and then new data arrives from the communication device: Enter it into the scrollback buffer at the current rollback position (OVERWRITE) or insert it at the end of the buffer (INSERT). The default is INSERT. Typing is allowed during rollback in either mode. SET TERMINAL SCREEN-MODE { NORMAL, REVERSE } When set to REVERSE the foreground and background colors are swapped as well as the application of the foreground and background intensity bits. The default is NORMAL. SET TERMINAL SCREEN-OPTIMIZATION { ON, OFF } ON means only write those cells to the screen that have changed since the last update. OFF means to refresh the entire screen when updating. Choose whichever method performs best on your computer. If you are using a speech or Braille device, you should SET TERMINAL SCREEN-OPTIMIZATION ON. SET TERMINAL SCREEN-UPDATE { FAST, SMOOTH } [ ] Chooses the mechanism used for screen updating and the update frequency. SMOOTH means the screen is repainted every time a character arrives. FAST means the screen is repainted at fixed intervals. Defaults are FAST with an interval of 100 milliseconds (1/10 second). Use SMOOTH to give priority to echoing; use FAST to give priority to throughput and vary the interval to achieve optimum results for your PC. On VT100 and above, the host may use escape sequences to switch Kermit between FAST and SMOOTH; FAST is selected by the Jump-scrolling escape sequence; SMOOTH is selected by the SMOOTH-scrolling sequence. However, note that K95 does not presently implement smooth scrolling in the VT100 sense. If the host switches K95 from SMOOTH to FAST, the most recently specified (or if none, default) update interval is used. If you are using a speech or Braille device, you should SET TERMINAL SCREEN-UPDATE SMOOTH. SET TERMINAL SCROLLBACK Sets size of Terminal screen rollback (scrollback) buffer. includes the active terminal screen. The minimum is 256. The maximum is 2 million. The default is 512. SET TERMINAL SEND-DATA { ON, OFF } Send commands are sent by the host to a terminal to request the contents of a particular region of the display. Since this is a potential security loophole, Kermit 95 by default (OFF) sends spaces instead of the actual contents of the screen. Setting this option to ON instructs Kermit 95 to send the actual data. SET TERMINAL SEND-END-OF-BLOCK { CRLF_ETX US_CR } Specifies the characters to use as end of line and end of block indicators when sending data to the host. The default is US_CR. SET TERMINAL SGR-COLORS { ON, OFF } SGR means Set Graphic Rendition. It is the name of the ANSI X3.64 escape sequence that is used to select normal, reverse, bold, underlined, blinking, or other character-cell attributes, including color, such as we are used to seeing on BBS's when we use "ANSI" terminal emulation. The color-setting SGR sequences, 3;4m, are also recognized by Kermit 95 when it is emulating a VT100 or higher VT terminal model, even though most real VT terminals do not display color, and in fact they ignore these sequences. To make Kermit 95 ignore color setting sequences, in effect turning into a monochrome terminal, use SET TERMINAL SGR-COLORS OFF. This command affects all ANSI-style emulations, including ANSI, SCOANSI, AT386, Wyse 370, and VT100/102/220/320. SET TERMINAL STATUSLINE { ON, OFF } Version 1.1.5. Previously, the Terminal window always had a status line. In version 1.1.5 and later, you can SET TERMINAL STATUSLINE OFF to get rid of it and make one more line available to the host application, for example if it wants to manage its own status line. SET TERMINAL TRANSMIT-TIMEOUT Specifies the maximum amount of time C-Kermit waits before returning to the prompt if your keystrokes can't be transmitted for some reason, such as a flow-control deadlock. SET TERMINAL TRIGGER [ string ] Tells Kermit to look for the given string during all subsequent CONNECT sessions, and if seen, to return to command mode automatically, as if you had escaped back manually. If the string includes any spaces, you must enclose it in braces. Example: SET TERMINAL TRIGGER {NO CARRIER} If a string is to include a literal brace character, precede it with a backslash: ; My modem always makes this noise when the connection is lost: SET TERMINAL TRIGGER |||ppp\{\{\{\{UUUUUUU If you want Kermit to look for more than one string simultaneously, use the following syntax: SET TERMINAL TRIGGER {{string1}{string2}...{stringn}} In this case, Kermit returns to command mode automatically if any of the given strings is encountered. Up to 8 strings may be specified. If the most recent return to command mode was caused by a trigger, the \v(trigger) variable contains the trigger value; otherwise \v(trigger) is empty. The SHOW TRIGGER command displays the SET TERMINAL TRIGGER values as well as the current \v(trigger) value. SET TERMINAL TYPE (See top of this file) SET TERMINAL UNIX-MODE { ON, OFF } This affects emulation of terminals that have a "UNIX mode", currently only the Data General DASHER 217. OFF (the default) means the terminal operates in its native mode, ON switches it to UNIX mode. SET TERMINAL VIDEO-CHANGE { DISABLED, ENABLED, WIN95-SAFE } Tells whether Kermit 95 should change video modes automatically in response to escape sequences from the other computer. DISABLED means it should not; ENABLED means it should. WIN95-SAFE means it should only do so if the requested dimensions are safe to use in Windows 95 (see BUGS.TXT item 2 for details). WIN95-SAFE is the default in Windows 95 as of Kermit 95 1.1.10 and 1.1.11. In Windows NT and IBM OS/2 Warp, as well as Windows 95 in Kermit 95 1.1.12 and later, the default is ENABLED. SET TERMINAL WIDTH Tells how many columns define the terminal size. 80 is the default and the only one that fully works in the first release of Windows 95. 132 can also be selected, but then attributes (color, etc) are not displayed due to a limitation in the Windows 95 console agent (CONAGENT.EXE). SET TERMINAL WRAP { OFF, ON } Tells whether the terminal emulator should automatically wrap long lines on your screen. (End of TERMINAL.TXT)