VMS Help
SET, TERMINAL

 *Conan The Librarian (sorry for the slow response - running on an old VAX)

    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. This specification is effective
    at your next login and stays in effect until you reboot your VAX
    computer.

    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 - /BLOCK_MODE

       /BLOCK_MODE
       /NOBLOCK_MODE

    Controls whether block mode transmission, local editing, and
    field protection are performed.

 2.7 - /BRDCSTMBX

       /BRDCSTMBX
       /NOBRDCSTMBX

    Controls whether broadcast messages are sent to an associated
    mailbox if one exists.

 2.8 - /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.9 - /COLOR

    Sets the ANSI_COLOR terminal characteristic and identifies
    the terminal as capable of supporting the ANSI color escape
    sequences.

 2.10 - /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.11 - /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.12 - /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.13 - /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.14 - /DIALUP

       /DIALUP
       /NODIALUP (default)

    Controls whether the terminal is a dialup terminal.

 2.15 - /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.16 - /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.17 - /DMA

       /DMA
       /NODMA

    Controls whether direct memory access (DMA) mode is used on a
    controller that supports this feature.

 2.18 - /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.19 - /EDIT_MODE

       /EDIT_MODE
       /NOEDIT_MODE

    Controls whether the terminal can perform ANSI-defined advanced
    editing functions.

 2.20 - /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, refer to the OpenVMS Terminal Fallback Utility
    Manual (available on the Documentation CD-ROM).

 2.21 - /ESCAPE

       /ESCAPE
       /NOESCAPE (default)

    Controls whether escape sequences are validated.

 2.22 - /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, refer to 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.23 - /FORM

       /FORM
       /NOFORM

    Controls whether a form feed is transmitted rather than
    translated into multiple line feeds.

 2.24 - /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.25 - /FULLDUP

       /FULLDUP (default)
       /NOFULLDUP

    Controls whether the terminal operates in full-duplex mode. The
    /FULLDUP qualifier is equivalent to the /NOHALFDUP qualifier.

 2.26 - /HALFDUP

       /HALFDUP
       /NOHALFDUP (default)

    Controls whether the terminal operates in half-duplex mode. The
    /HALFDUP qualifier is equivalent to the /NOFULLDUP qualifier.

 2.27 - /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.28 - /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.29 - /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.30 - /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. Compaq
       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.31 - /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.32 - /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.33 - /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.34 - /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.35 - /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.36 - /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.37 - /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.38 - /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.39 - /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.40 - /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.41 - /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.42 - /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.43 - /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.44 - /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.45 - /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.46 - /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.47 - /REGIS

       /REGIS
       /NOREGIS

    Specifies whether the terminal understands ReGIS graphic
    commands.

 2.48 - /SCOPE

       /SCOPE
       /NOSCOPE

    Controls whether the device is established as a video terminal.
    The /SCOPE qualifier is equivalent to the /NOHARDCOPY qualifier.

 2.49 - /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.50 - /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.51 - /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.52 - /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.53 - /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.54 - /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.55 - /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.56 - /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.57 - /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.58 - /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.59 - /UNKNOWN

    Specifies a terminal type that is unknown to the system, which
    then uses the default terminal characteristics for unknown
    terminals.

 2.60 - /UPPERCASE

       /UPPERCASE
       /NOUPPERCASE

    Controls whether lowercase characters are translated to
    uppercase. The /UPPERCASE qualifier is equivalent to the
    /NOLOWERCASE qualifier.

 2.61 - /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.62 - /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.
  Close     HLB-list     TLB-list     Help  

[legal] [privacy] [GNU] [policy] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.