tcl.term

Verb: Access/TCL, Releases: AP and R83

Displays or changes current terminal or printer characteristics.

Syntax

term tw,td,ls,ld,fd,bs,pw,pd,tt {(option)} term tt {(option)}

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.

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.

See Also

Command Name Type Description
op.lpi Command Set number of lines-per-inch.
proc.t Command Terminal addressing and effect function.
tcl.termp Verb: Access Prompts for terminal or printer characteristics.
tcl.set-term Verb: Access Sets default system terminal and printer characteristics.
basic.execute Statement Performs TCL command expression.
basic.str Function Generates string of characters.
tcl.block-print Verb: Access Produces banner on crt or printer.
tcl.choose.term Verb: Access Selects terminal type.
tcl.term-type Verb: Access Sets terminal and printer characteristics automatically.
cursor Definition The thing on the screen that moves when you type.
tcl.wheres Verb: Access Displays execution status and last command for each process.
tcl.cls Verb: Access Clears screen.
tcl.setpib0 Verb: Access Resets port 0 terminal type.
filename.pibs Definition Contains device specifications for each port.
tcl.test-cursor Verb: Access Crt visual effects demo.
access.sort-label Verb: Access Produces formatted and sorted labels.
tcl.shpstat Verb: Access Manipulates shared program status.
basic.@.functions Function Special cursor addressing functions.
tcl.r83.setup Verb: Access Sets user options to r83 defaults.
tcl.mmvideo Verb: Access Utility to test memory mapped monitor.

User Comments

What do you think?

Share your experience or ask a question by using the form below.

Login to leave your comments.