tcl.term Verb: Access/TCL

tcl.term

Command tcl.term Verb: Access/TCL
Applicable release versions: AP, R83
Category TCL (746)
Description changes or displays the current terminal and printer output characteristics for the current line.
Any parameter may be left intact by entering a null (two consecutive commas). The only exception to this rule is the "tt" (term type) parameter which defines the terminal name. The system recognizes terminal names, so the name may be entered first or last.

The term type parameter may be specified without any other arguments, or in any position of the argument list, since it is the only non-numeric argument.

The arguments allowed are as follows:

"tw" is the terminal width, or the number of print positions per line on the terminal. It must be between 10 and 140. Although most terminals are capable of printing 80 characters per line, the typical setting is 79 to avoid problems with carriage return/line feeds when displaying at the 80th position.

"td" is the terminal depth, in lines.

"ls" is the "line skip". This is the number of blank lines at the bottom of the screen. The value in "td" is added to the value in "ls" and must equal the actual number of lines on the terminal.

"ld" is for "linefeed delays". This is the number of null characters to output after each linefeed. This is typically set to 0 (zero).

"fd" is for "formfeed delays". This is the number of null characters to output after a top-of-form is executed. The "fd" parameter also determines when to eject a page (or clear the screen) between output pages. The following settings are valid:

0 Suppresses page ejects between output pages on both the terminal and the printer.

1 Suppresses page ejects on the terminal only.

2 "Normal mode". Any value of 2 or more clears the screen (or ejects a page on the printer), and sends the corresponding number of nulls.

"bs" is the "backspace" key value. This is the decimal value of the ASCII character to echo to the terminal when the backspace key is pressed. This is typically set to 8 or 21.

"pw" is the current "printer width", or the number of print positions per line on printer output.

"pd" is the "printer depth", or the number of lines per page on printer output.

"tt" is the "terminal type" code. This designates the terminal driver to use and is vital to set prior to invoking any process which attempts to perform any kind of cursor control, such as UP, Pick/BASIC, or PROC.

In Advanced Pick, the terminal driver definitions are located in the "dm,devices," file. To obtain a listing of the available types, enter: "sort only dm,devices,".

In contrast to R83 Pick, terminal types in AP use descriptive names, rather than just a single alphabetic character.
Syntax term tw,td,ls,ld,fd,bs,pw,pd,tt {(option)}
term tt {(option)}
Options c Recompiles the terminal definition from the source.

h Sets high-intensity.

o Creates a FlashBASIC cursor-control module when used with the "c" option. This FlashBASIC module is utilized by code generated with the FlashBASIC compiler. This option will not work with non-terminal device definitions.

k Set the input/output terminal transaltion table (AP 6.1 and later). The name of table is defined in the fourth value of the attribute 1 of the 'devices' item. The name of the translation table is the item-id of an item in the 'keyboards' file.

o Create a FlashBASIC cursor-control module when used with the (C) option. This FlashBASIC module is used by code generated with the FlashBASIC compiler. This option does not work on non terminal device definitions (printers).

r Redisplays resulting term parameters after changing.
Example
term 79,24
Change the terminal width and depth only.

term ,24
Change the terminal depth only.

term ,,,,,,132,62 (r
terminal name: wy-50
product name: WYSE 50
terminal width: 132   printer width: 132
depth: 82            depth: 62
lineskip:    0
lf delay:    1
ff delay:    1
back space:  8
Change the printer width and depth only, and display the resulting changes.

term wy-50
Change the terminal type only.

term wy-50 (c
Change the terminal type and compile the terminal definition from the 
"devices" file.

term ibm3151 (k
Set the terminal type to 'ibm3151' and activate the keyboard 
translation associated to this terminal.
Purpose
Related op.lpi
proc.t
tcl.termp
tcl.set-term
basic.execute
basic.str
tcl.block-print
tcl.choose.term
tcl.term-type
cursor
tcl.wheres
tcl.cls
tcl.setpib0
filename.pibs
tcl.test-cursor
access.sort-label
tcl.shpstat
basic.@.functions
tcl.r83.setup
tcl.mmvideo
basic.system
tcl.list-pibs
filename.devices
access.list
basic.performance
tcl.set-imap
filename.keyboards
ue.0004