Sets the characteristics of a terminal. Entering a qualifier
changes a characteristic; omitting a qualifier leaves the
characteristic unchanged.
Format
SET TERMINAL [device-name[:]]
1 – Parameter
device-name[:]
Specifies the device name of the terminal. The default is
SYS$COMMAND if that device is a terminal. If the device is not
a terminal, an error message is displayed.
2 – Qualifiers
2.1 /ADVANCED_VIDEO
/ADVANCED_VIDEO
/NOADVANCED_VIDEO
Controls whether the terminal has advanced video attributes and
is capable of 132-column video. If the terminal width is set
to 132 columns and you specify the /ADVANCED_VIDEO qualifier,
the terminal page limit is set to 24 lines. If you specify the
/NOADVANCED_VIDEO qualifier, the terminal page limit is set to
14 lines.
2.2 /ALTYPEAHD
Causes the terminal driver to create a permanent, alternate type-
ahead buffer. The system parameter TTY_ALTYPEAHD determines the
size of the type-ahead buffer.
To enable /ALTYPEAHD, you must also set the qualifier /TYPE_
AHEAD.
You should specify SETTERMINAL/PERMANENT/ALTYPEAHD in
SYS$STARTUP:SYSTARTUP_VMS.COM for those communication lines that
require this capability.
To use this feature interactively, specify SET
TERMINAL/PERMANENT/ALTYPEAHD. This specification is effective
at your next login.
2.3 /ANSI_CRT
/ANSI_CRT (default)
/NOANSI_CRT
Controls whether the terminal conforms to ANSI CRT programming
standards. Because ANSI standards are a proper subset of the DEC_
CRT characteristics, the default for all VT100 family terminals
is /ANSI_CRT.
2.4 /APPLICATION_KEYPAD
Specifies that the keypad is to be set to application keypad
mode, which allows you to enter DCL commands defined with the
DEFINE/KEY command. By default, the terminal is set to numeric
keypad mode.
2.5 /AUTOBAUD
/AUTOBAUD
/NOAUTOBAUD
Controls whether the terminal baud rate is set when you log in
and sets the default terminal speed to 9600. You must press
Return two or more times at intervals of at least 1 second for
the baud rate to be determined correctly. If you press a key
other than Return, the /AUTOBAUD qualifier may detect the wrong
baud rate. If this happens, wait for the login procedure to time
out before continuing. The /AUTOBAUD qualifier must be used with
the /PERMANENT qualifier.
The valid baud rates are as follows:
50 150 1800 4800 38400
75 300 2000 7200 57600
110 600 2400 9600 76800
134 1200 3600 19200 115200
2.6 /BACKSPACE
/BACKSPACE=keyword
Controls how the system responds to the backspace key (Ctrl/H) in
line editing mode. There are two possible keywords:
o BACKSPACE (default) - The terminal driver returns the user
to the beginning of the line. (This is the traditional way
OpenVMS has always worked.)
o DELETE - The terminal driver interprets the backspace key as a
delete character instruction.
Note the following exceptions:
- If the terminal is set in PASSALL or PASTHRU mode, the
backspace key is not interpreted as a delete character
instruction.
- If the user issues an IO$_READVBLK with IO$M_NOFILTR or
IO$_READPBLK, the backspace key is not interpreted as a
delete character instruction.
You can use SYSGEN to make /BACKSPACE=DELETE the default for all
terminals by setting the system parameter TTY_DEFCHAR3 to 16.
If the default is set to DELETE, the user can still go to the
start of a line by pressing F12 or by entering the following
sequence: Ctrl/V Ctrl/H Ctrl/H.
If you use SET HOST, both the local node and the remote node must
be capable of responding to your definition of the BACKSPACE key.
2.7 /BLOCK_MODE
/BLOCK_MODE
/NOBLOCK_MODE
Controls whether block mode transmission, local editing, and
field protection are performed.
2.8 /BRDCSTMBX
/BRDCSTMBX
/NOBRDCSTMBX
Controls whether broadcast messages are sent to an associated
mailbox if one exists.
2.9 /BROADCAST
/BROADCAST (default)
/NOBROADCAST
Controls whether reception of broadcast messages (such as those
issued by MAIL and REPLY) is enabled. Specify the /NOBROADCAST
qualifier when you are using a terminal as a noninteractive
device or when you do not want special output to be interrupted
by messages. Use the SET BROADCAST command to exclude certain
types of messages from being broadcast, rather than eliminating
all messages.
2.10 /COLOR
Sets the ANSI_COLOR terminal characteristic and identifies
the terminal as capable of supporting the ANSI color escape
sequences.
2.11 /COMMSYNC
/COMMSYNC
/NOCOMMSYNC (default)
Allows connection of asynchronous printers and other devices
to terminal ports, using standard modem control signals as flow
control. Transmission to the device stops if either data set
ready (DSR) or clear to send (CTS) EIA modem control signals are
dropped. Transmission resumes when both signals are present.
The /COMMSYNC qualifier and the /MODEM qualifier are mutually
exclusive.
The COMMSYNC feature has the following limitations:
o Cannot be used on LAT ports
o Can only be used on ports with full modem control
o Should not be used in conjunction with Xon/Xoff flow control
(the port may hang)
CAUTION
The /COMMSYNC qualifier should never be set on a line with
a modem that is intended for interactive use. The qualifier
disables the modem terminal characteristic that disconnects
a user process from the terminal line in case of a modem
phone line failure. With the /COMMSYNC qualifier enabled,
the next call on the terminal line could be attached to the
previous user's process. Security administrators should
be aware that the characteristic should not be used on
interactive terminal ports. In addition, the /COMMSYNC
qualifier is not supported on a port connected to a LAT
line.
2.12 /CRFILL
/CRFILL[=fill-count]
Generates the specified number of null characters after each
carriage return before transmitting the next meaningful character
(to ensure that the terminal is ready for reception). The value
must be an integer in the range 0 to 9. The default is the
/CRFILL=0 qualifier.
2.13 /DEC_CRT
/DEC_CRT[=(value1,value2,value3)]
/NODEC_CRT[=(value1,value2,value3)]
Controls whether the terminal conforms to DIGITAL VT100-,
VT200-, VT300-, VT400-, or VT500-family standards and supports
the minimum standards, including the additional DIGITAL escape
sequences.
You can specify one of the following values:
1 Requests that the DEC_CRT terminal characteristic be
(default) set.
2 Requests that the DEC_CRT2 terminal characteristic be
set.
3 Requests that the DEC_CRT3 terminal characteristic
be set. A level 3 terminal supports the following
additional features:
o A status line (line 25, at the bottom of the
screen)
o The ISO Latin1 character set
o Terminal state interrogation (describes what state
your terminal is in)
4 Requests that the DEC_CRT4 terminal characteristic
be set. A level 4 terminal supports the following
additional features:
o Extended keyboard
o Key position mode
o Secure reset
o Novice mode
o Selective erase
o On-line transaction processing (OLTP) features:
- Page memory
- Rectangular editing
- Text macros
- Data integrity reports
Note that DEC_CRT2, DEC_CRT3, and DEC_CRT4 are supersets of DEC_
CRT. Clearing DEC_CRT causes DEC_CRT2, DEC_CRT3, and DEC_CRT4
to be cleared. Similarly, setting DEC_CRT4 causes all subsets of
DEC_CRT4 (including ANSI_CRT) to be set.
2.14 /DEVICE_TYPE
/DEVICE_TYPE=terminal-type
Informs the system of the terminal type and sets characteristics
according to the device type specified. You can specify any of
the following terminal types:
UNKNOWN LA100 PRO_SERIES VT102 VT200
FT1-FT8 LA120 VT05 VT105 VT300
LA12 LA210 VT52 VT125 VT400
LA34 LN01K VT55 VT131 VT500
LA36 LN03 VT100 VT132
LA38 LQP02 VT101 VT173
The default characteristics for the VT100-, VT102-, and VT125-
series terminals are as follows:
/ADVANCEDVIDEO /NOALTYPEAHD /ANSI_CRT
/NOAUTOBAUD /NOBLOCK_MODE /NOBRDCSTMBX
/BROADCAST /CRFILL=0 /ECHO
/NOEIGHT_BIT /NOESCAPE /NOFORM
/FULLDUP /NOHOSTSYNC /LFFILL=0
/LOWERCASE /NODMA /PAGE=24
/NOPARITY /NOPASTHRU /NOREADSYN
/SPEED=9600 /TAB /TTSYNC
/TYPE_AHEAD /WIDTH=80 /WRAP
2.15 /DIALUP
/DIALUP
/NODIALUP (default)
Controls whether the terminal is a dialup terminal.
2.16 /DISCONNECT
/DISCONNECT
/NODISCONNECT (default)
Controls whether the process connected to this terminal is
disconnected if the line detects a hangup. The /DISCONNECT
qualifier is valid only when the /PERMANENT qualifier is
specified.
2.17 /DISMISS
/DISMISS
/NODISMISS (default)
Controls whether the terminal driver ignores data that causes a
parity error (instead of terminating the currently outstanding
I/O with an error status).
2.18 /DMA
/DMA
/NODMA
Controls whether direct memory access (DMA) mode is used on a
controller that supports this feature.
2.19 /ECHO
/ECHO (default)
/NOECHO
Controls whether the terminal displays the input it receives.
With the /NOECHO qualifier, the terminal displays only system or
user application output, or both.
2.20 /EDIT_MODE
/EDIT_MODE
/NOEDIT_MODE
Controls whether the terminal can perform ANSI-defined advanced
editing functions.
2.21 /EIGHT_BIT
/EIGHT_BIT
/NOEIGHT_BIT
Controls whether the terminal uses the 8-bit ASCII protocol
rather than the 7-bit ASCII protocol. You can use the Terminal
Fallback Facility (TFF) to set the 8-bit characteristic on
terminals. If the terminal you specify has the TFF enabled,
the /EIGHT_BIT qualifier has no effect. For more information
on terminal fallback, see the OpenVMS Terminal Fallback Utility
Manual (available on the Documentation CD-ROM).
2.22 /ESCAPE
/ESCAPE
/NOESCAPE (default)
Controls whether escape sequences are validated.
2.23 /FALLBACK
/FALLBACK
/NOFALLBACK
Controls whether the 8-bit DEC Multinational character set
characters are displayed on the terminal in their 7-bit
representation. The default depends on the /EIGHTBIT setting
of the terminal. If the OpenVMS Terminal Fallback Facility (TFF)
is enabled, it activates the default character conversion tables
for the named terminal. For more information, see the OpenVMS
Terminal Fallback Utility Manual (available on the Documentation
CD-ROM). If TFF is not enabled on your system, the /FALLBACK
qualifier has no effect and no error message is displayed.
2.24 /FORM
/FORM
/NOFORM
Controls whether a form feed is transmitted rather than
translated into multiple line feeds.
2.25 /FRAME
/FRAME=n
Specifies the number of data bits that the terminal driver
expects for every character that is input or output. The value of
n can be from 5 to 8. The default value depends on the settings
for the terminal established by the /PARITY and /EIGHTBIT
qualifiers.
2.26 /FULLDUP
/FULLDUP (default)
/NOFULLDUP
Controls whether the terminal operates in full-duplex mode. The
/FULLDUP qualifier is equivalent to the /NOHALFDUP qualifier.
2.27 /HALFDUP
/HALFDUP
/NOHALFDUP (default)
Controls whether the terminal operates in half-duplex mode. The
/HALFDUP qualifier is equivalent to the /NOFULLDUP qualifier.
2.28 /HANGUP
/HANGUP
/NOHANGUP (default)
May require LOG_IO (logical I/O) or PHY_IO (physical I/O)
privilege depending on system generation parameter settings.
Controls whether the terminal modem is hung up when you log out.
2.29 /HARDCOPY
/HARDCOPY
/NOHARDCOPY
Controls whether the device is established as a hardcopy terminal
and outputs a backslash (\) when the Delete key is pressed. The
/HARDCOPY qualifier is equivalent to the /NOSCOPE qualifier.
2.30 /HOSTSYNC
/HOSTSYNC
/NOHOSTSYNC (default)
Controls whether system transmission from the terminal is stopped
(by generating a Ctrl/S) when the input buffer is full and
resumed (by generating a Ctrl/Q) when the input buffer is empty.
2.31 /INQUIRE
Sets the device type when the /INQUIRE qualifier is specified
and the DEC_CRT characteristic is set. The SET TERMINAL command
reads the current screen size from the terminal and sets the
corresponding page length and page width values appropriately.
The default device type is UNKNOWN. Works only on DIGITAL
terminals, and not on LA36 or VT05 terminals. Some VT100 family
terminals, including the VT101 and VT105, return a VT100 type
response. LA38 terminals respond as LA43 terminals.
NOTE
The SET TERMINAL/INQUIRE command works correctly on DIGITAL
supplied VT100 and later terminals. Some personal computer
terminal emulators may not work correctly, because they
do not correctly emulate all VT100 escape sequences. VSI
recommends that users who experience problems with these
terminal emulators contact the terminal emulator supplier.
You can include the SET TERMINAL/INQUIRE command in your
LOGIN.COM file to detect the terminal type automatically.
If you specify /INQUIRE=OLD, OpenVMS sets the terminal window
to 24 lines by 80 columns and ignores the real terminal size.
(This is the behavior of the SET TERMINAL/INQUIRE command prior
to OpenVMS Version 6.2.)
CAUTION
This qualifier clears the type-ahead buffer. If the response
sequence is unrecognized, no action message or error message
is displayed. The /INQUIRE qualifier should be used only on
DIGITAL terminals; however, the LA36 and VT05 terminals do
not support this feature.
2.32 /INSERT
Sets the terminal to insert mode. This feature allows you to
insert characters when editing command lines. The default mode is
overstrike, which allows you to type over the current character
when editing a command line. Press Ctrl/A to switch from one mode
to the other.
2.33 /LFFILL
/LFFILL[=fill-count]
Transmits to the terminal the specified number of null characters
after each line feed before transmitting the next meaningful
character (to ensure that the terminal is ready for reception).
The value must be an integer in the range 0 to 9. The default is
installation dependent.
2.34 /LINE_EDITING
/LINE_EDITING
/NOLINE_EDITING
Controls whether advanced line-editing features are enabled for
editing command lines: pressing Return and pressing Ctrl/Z are
recognized as line terminators, as are escape sequences.
2.35 /LOCAL_ECHO
/LOCAL_ECHO
/NOLOCAL_ECHO (default)
Controls whether the terminal echoes characters locally (rather
than the host echoing them) for command level terminal functions.
(Do not use the /LOCAL_ECHO qualifier with utilities that require
control over echoing, such as line editing or EDT's screen mode.)
CAUTION
When logging in to terminals with the LOCAL_ECHO
characteristic, the OpenVMS system has no control over the
echoing of passwords.
2.36 /LOWERCASE
/LOWERCASE
/NOLOWERCASE
Controls whether lowercase characters are passed to the terminal.
The /NOLOWERCASE qualifier translates all input to uppercase. The
/LOWERCASE qualifier is equivalent to the /NOUPPERCASE qualifier.
2.37 /MANUAL
Indicates manual switching of terminal lines to dynamic
asynchronous DDCMP lines when your local terminal emulator does
not support automatic switching. The /MANUAL qualifier should be
specified with the /PROTOCOL=DDCMP and /SWITCH=DECNET qualifiers.
2.38 /MODEM
/MODEM
/NOMODEM
Specifies whether the terminal is connected to a modem or
a cable that supplies standard EIA modem control signals.
If your terminal has the MODEM characteristic, entering SET
TERMINAL/NOMODEM automatically logs you out. The /MODEM qualifier
and the /COMMSYNC qualifier are mutually exclusive.
2.39 /NUMERIC_KEYPAD
/NUMERIC_KEYPAD (default)
Specifies whether the keys of the numeric keypad are used
to type numbers and punctuation marks (/NUMERIC_KEYPAD) or
to enter DCL commands defined with the DEFINE/KEY command
(/APPLICATION_KEYPAD).
2.40 /OVERSTRIKE
/OVERSTRIKE (default)
Sets the terminal to overstrike mode. This feature allows you to
type over the current character when you are editing a command
line. Set your terminal to insert mode if you want to insert
characters when editing command lines. Press Ctrl/A to switch
from one mode to the other.
2.41 /PAGE
/PAGE[=lines-per-page]
Specifies the number of print lines between perforations for
hardcopy terminals. (When the terminal reads a form feed, it
advances the paper to the next perforation.) The value of the
lines-per-page parameter can be from 0 to 255 and defaults to 0
(which treats a form feed as a line feed).
2.42 /PARITY
/PARITY[=option]
/NOPARITY (default)
Controls whether the terminal passes data with only odd or even
parity, where option equals ODD or EVEN. If you specify the
/PARITY qualifier without an option, the value defaults to EVEN.
2.43 /PASTHRU
/PASTHRU
/NOPASTHRU (default)
Controls whether the terminal passes all data (including tabs,
carriage returns, line feeds, and control characters) to an
application program as binary data. The setting of /TTSYNC is
allowed.
Make sure that you spell both these qualifiers exactly as they
appear in the text.
2.44 /PERMANENT
Requires LOG_IO (logical I/O) or PHY_IO (physical I/O) privilege.
Sets characteristics on a permanent basis, that is, over terminal
sessions; however, the characteristics revert to their initial
values if the system is halted and restarted. Use in a system
startup file to establish characteristics for all terminals on
the system.
2.45 /PRINTER_PORT
/PRINTER_PORT
/NOPRINTER_PORT
Specifies whether the terminal has a printer port (an attribute
not set by the SET TERMINAL/INQUIRE command). The default is
installation dependent.
2.46 /PROTOCOL
/PROTOCOL=DDCMP
/PROTOCOL=NONE (default)
On VAX, controls whether the terminal port specified is changed
into an asynchronous DDCMP line. The /PROTOCOL=NONE qualifier
changes an asynchronous DDCMP line back into a terminal line.
Note that /PROTOCOL=DDCMP is a permanent characteristic;
therefore, the /PERMANENT qualifier is not required.
2.47 /READSYNC
/READSYNC
/NOREADSYNC (default)
Controls whether the terminal uses the Ctrl/S and Ctrl/Q
functions to synchronize data transmitted from the terminal.
CAUTION
SET TERMINAL/READSYNC should not be used on LAT terminal
lines. Setting this characteristic may cause unexpected
results.
The default is the /NOREADSYNC qualifier; the system does not
use the Ctrl/S and Ctrl/Q functions to control reads to the
terminal. The /READSYNC qualifier is useful for certain classes
of terminals that demand synchronization or for special-purpose
terminal lines where data synchronization is appropriate.
2.48 /REGIS
/REGIS
/NOREGIS
Specifies whether the terminal understands ReGIS graphic
commands.
2.49 /SCOPE
/SCOPE
/NOSCOPE
Controls whether the device is established as a video terminal.
The /SCOPE qualifier is equivalent to the /NOHARDCOPY qualifier.
2.50 /SECURE_SERVER
/SECURE_SERVER
/NOSECURE_SERVER (default)
Requires either LOG_IO (logical I/O) or PHY_IO (physical I/O)
privilege.
Controls whether the Break key on the terminal logs out the
current process (except on a virtual terminal). With the /SECURE_
SERVER qualifier in effect, pressing the Break key when there
is no current process initiates the login sequence. With the
/NOSECURE_SERVER qualifier in effect, the break is ignored.
On terminals with the AUTOBAUD and SECURE_SERVER characteristics,
pressing the Break key disconnects the current process, but
is not required to start a new login sequence. However,
when the NOAUTOBAUD characteristic is set, the SECURE_SERVER
characteristic requires a break to initiate a new login sequence.
2.51 /SET_SPEED
/SET_SPEED
/NOSET_SPEED
Requires either LOG_IO (logical I/O) or PHY_IO (physical I/O)
privilege.
Controls whether the /SPEED qualifier can be used to change the
terminal speed.
2.52 /SIXEL_GRAPHICS
/SIXEL_GRAPHICS
/NOSIXEL_GRAPHICS
Specifies whether the terminal is capable of displaying graphics
using the sixel graphics protocol. The default is device
dependent.
2.53 /SOFT_CHARACTERS
/SOFT_CHARACTERS
/NOSOFT_CHARACTERS
Specifies whether the terminal is capable of loading a user-
defined character set. The default is device dependent.
2.54 /SPEED
/SPEED=(input-rate,output-rate)
Sets the baud rate at which the terminal receives and transmits
data. If the input and output rates are the same, specify
/SPEED=rate.
Not all terminals support different input and output baud rates.
For specific information on baud rates for your terminal, consult
the manual for that terminal.
The default transmission rates are installation dependent.
The valid values for input and output baud rates are as follows:
50 150 1800 4800 38400
75 300 2000 7200 57600
110 600 2400 9600 76800
134 1200 3600 19200 115200
2.55 /SWITCH
/SWITCH=DECNET
On VAX, causes the terminal lines at each node to be switched
to dynamic asynchronous DDCMP lines, when specified with
the /PROTOCOL=DDCMP qualifier. Note that /SWITCH=DECNET is a
permanent characteristic; therefore, the /PERMANENT qualifier is
not required.
2.56 /SYSPASSWORD
/SYSPASSWORD
/NOSYSPASSWORD (default)
Requires LOG_IO (logical I/O) privilege.
Determines whether the terminal requires that a system password
be entered before the Username: prompt.
2.57 /TAB
/TAB
/NOTAB
Controls whether tab characters are converted to multiple blanks.
The /NOTAB qualifier expands all tab characters to blanks and
assumes tab stops at 8-character intervals. The default is device
dependent.
2.58 /TTSYNC
/TTSYNC (default)
/NOTTSYNC
Controls whether transmitting to the terminal is stopped when
Ctrl/S is pressed and resumes transmission when Ctrl/Q is
pressed.
2.59 /TYPE_AHEAD
/TYPE_AHEAD (default)
/NOTYPE_AHEAD
Controls whether the terminal accepts unsolicited input to the
limit of the type-ahead buffer.
When you specify the /NOTYPE_AHEAD qualifier, the terminal
accepts input only when a program or the system issues a read
to the terminal, such as for user input at the DCL prompt ($).
When you specify the /TYPE_AHEAD qualifier, the amount of data
that can be accepted is governed by the size of the type-ahead
buffer. That size is determined by system generation parameters.
2.60 /UNKNOWN
Specifies a terminal type that is unknown to the system, which
then uses the default terminal characteristics for unknown
terminals.
2.61 /UPPERCASE
/UPPERCASE
/NOUPPERCASE
Controls whether lowercase characters are translated to
uppercase. The /UPPERCASE qualifier is equivalent to the
/NOLOWERCASE qualifier.
2.62 /WIDTH
/WIDTH=characters-per-line
Specifies the maximum characters per line. This value must be
an integer in the range 1 to 511. With the /WRAP qualifier, the
terminal generates a carriage return and line feed when the width
specification is reached.
If the specified width on an ANSI terminal is 132, the screen is
set to 132-character mode. If the terminal does not have advanced
video option (AVO), the page length limit is set to 14 lines.
2.63 /WRAP
/WRAP (default)
/NOWRAP
Controls whether a carriage return and line feed are generated
when the value of the /WIDTH qualifier is reached.
3 – Examples
1.$ SET TERMINAL/DEVICE=VT102
In this example, the SET TERMINAL command establishes the
current terminal as a VT102 terminal and sets the default
characteristics for that terminal type.
2.$ SET TERMINAL/WIDTH=132/PAGE=60/NOBROADCAST
$ TYPE MEMO.DOC
.
.
.
$ SET TERMINAL/DEVICE=LA36
In this example, the first SET TERMINAL command indicates
that the width of terminal lines is 132 characters and that
the size of each page is 60 lines. The /NOBROADCAST qualifier
disables the reception of broadcast messages while the terminal
is printing the file MEMO.DOC. The next SET TERMINAL command
restores the terminal to its default state.