Updated and reviewed April 2011
SET TERM{INAL} with no further arguments displays the current terminal settings, e.g.:
.SET TERM
Current terminal settings for TSKAAA are:
Terminal driver: PCTDVG
Baud rate: 19200
Terminal width: 80
Terminal height: 24
Foreground color: 6
Background color: 0
Beveling: Auto
Sys bg color None
Win bg color 0
Win text color None
Otherwise you may specify one of the variables in the table below, along with one of the allowed values, to update the terminal settings accordingly, e.g.
.SET TERM BCOLOR 2
.SET TERM HEIGHT 32
.SET TERMINAL DRIVER AM75Z
|
Variable |
Values |
Description |
|
FCOLOR n |
n |
Set foreground color to n, where n is 0 to 7. Requires Windows or color emulation. |
|
BCOLOR n |
n |
Set background color to n where n is 0 to 7. Requires Windows or color emulation. |
|
HEIGHT n |
n |
Set height (number of rows) to any value of less than 51. See Comments, below. |
|
WIDTH n |
n |
Set width (number of columns) to any value of less than 161, less than 40 not recommended. A-Shell/Windows or ATE. |
|
BEVEL |
off, auto, program |
Set beveling option to off, auto or program. A-Shell/Windows only. |
|
SYSBCOLOR n |
n |
Link background color n to Windows dialog/button color (gray), where n is 0 to 7. A-Shell/Windows or ATE. |
|
WINs n |
n |
Link background color n to Windows edit box color (white) , where n is 0 to 7. A-Shell/Windows or ATE. |
|
WINTXTCLR n |
n |
Link foreground color n to Windows text color (black) , where n is 0 to 7. A-Shell/Windows or ATE. |
|
TSTATUS |
on / off |
Turn top status line on/off. A-Shell/Windows or ATE. |
|
BSTATUS |
on / off |
Turn bottom status line on/off. A-Shell/Windows or ATE. |
|
WSTATUS |
on / off |
Turn Windows status line on/off. A-Shell/Windows or ATE. |
|
DRIVER |
name |
Set the TERM envrionment variable and internal terminal driver |
Comments
The HEIGHT option is particularly complicated in its dependencies. For A-Shell/Windows and ATE (with any of the "G" emulations), the height may be adjusted from 1 to 50 rows. For remote terminal connections (A-Shell/UNIX or ATSD), if the terminal/emulator is AM75, the valid options are 24 and 50. However, if the emulator is ZTERM v144+, and the TERM environment variable is set to "AM75Z", then the valid options are 24-50. The DRIVER option may be used to set the terminal environment variable (which also resets the terminal and internal driver accordingly).
Note that terminal height/width can also be set via the TAB(-5,rows) and TAB(-6,cols) commands.
History
2004 August, A-Shell 4.9.897: SET.LIT supports two new commands to link A-Shell color palette numbers to Windows desktop colors, to go along with the existing SET TERM:
SET TERM WINBCOLOR n
SET TERM WINTXTCLR n
The first (WINBCOLOR) sets the "Window Background" color n, which is typically used for the background of small windows such as edit boxes, checkboxes, and listboxes (typically white).
The second (WINTXTCLR) sets the "Window Text" color n, which is typically used for text both on buttons and in edit boxes and listboxes (typically black). Note that the n here is taken from the foreground palette (unlike WINBCOLOR and SYSBCOLOR which both refer to color numbers from the background palette).
Along with SYSBCOLOR, these can now be used via ATE on UNIX servers.