TTCHAR
Return type, lines, and width of a terminal
|
|
|
VSupported on OpenVMS
|
xcall TTCHAR(channel, [type], [lines], [width][, attributes])
Arguments
channel
The channel on which the terminal is open. (n)
type
(optional) A field containing a string that identifies the type of the terminal opened on channel. (a)
lines
(optional) The variable that will be loaded with the number of lines per screen page. (n)
width
(optional) The variable that will be loaded with the number of characters per line. (n)
attributes
(optional) The variable that will be loaded with the decimal codes of other terminal attributes. (a51)
Discussion
The TTCHAR subroutine returns the type, number of lines per page, number of characters per line, and other attributes of a terminal.
The terminal settings are obtained from the system when the channel is opened. If the terminal characteristics change while the channel is open, TTCHAR still returns the original information from when the channel was first opened. If the terminal characteristics are set improperly, TTCHAR returns incorrect information.
The following table indicates the position within the attributes argument of each code that TTCHAR returns. A value of one indicates the presence of the attribute. A value of zero indicates the attribute’s absence. See your OpenVMS I/O User’s Reference Manual for detailed information about the meaning of each attribute.
Attribute Positions in Attributes |
|||
---|---|---|---|
Attribute |
Position |
Attribute |
Position |
SCOPE |
1 |
TTSYNCH |
27 |
ANSICRT |
2 |
HALFDUP |
28 |
DECCRT |
3 |
XON |
29 |
AVO |
4 |
<reserved> |
30 |
BLOCK |
5 |
NOBRDCST |
31 |
EDIT |
6 |
BRDCSTMBX |
32 |
REGIS |
7 |
MBXDSABLE |
33 |
LOWER |
8 |
NOTYPEAHD |
34 |
WRAP |
9 |
ALTYPEAHD |
35 |
MECHFORM |
10 |
SETSPEED |
36 |
MECHTAB |
11 |
EDITING |
37 |
PASSALL |
12 |
INSERT |
38 |
EIGHTBIT |
13 |
FALLBACK |
39 |
CMA |
14 |
DIALUP |
40 |
NOECHO |
15 |
SECURE |
41 |
LOCALECHO |
16 |
DISCONNECT |
42 |
ESCAPE |
17 |
PASTHRU |
43 |
REMOTE |
18 |
SIXEL |
44 |
MODEM |
19 |
DRCS |
45 |
AUTOBAUD |
20 |
PRINTER |
46 |
HANGUP |
21 |
APP_KEYPAD |
47 |
MODHANGUP |
22 |
SYSPWD |
48 |
CRFILL |
23 |
TT_DECCRT2 |
49 |
LFFIL24 |
24 |
TT_DECCRT3 |
50 |
HOSTSYNC |
25 |
TT_DECCRT4 |
51 |
READSYNC |
26 |
|
|
Examples
The following example returns the type of terminal, along with the number of vertical lines and the width of each line on the terminal.
proc open(1, o, "tt:") xcall sho_term(1) end subroutine sho_term tt_ch ,d ;Terminal channel record term ,a30 ;Terminal type lines ,d3 ;Vertical lines for terminal width ,d3 ;Width of line buff ,a80 bufflen ,d2 proc xcall ttchar(tt_ch, term, lines, width) xcall s_bld(buff, bufflen, & "Your terminal is a %a, with %d lines of " + "%d characters", & term, lines, width) writes(tt_ch, buff(1:bufflen)) xreturn endsubroutine