dxterm(1X)dxterm(1X)NAMEdxterm - DECwindows terminal emulator
SYNOPSISdxterm [ flags ]
Specifies a value for a dxterm resource that overrides a default set‐
ting. The string has the form resource:value. You can specify this
flag multiple times to change multiple resources. See the X DEFAULTS
section in this reference page for a list of resources that can be
changed. You can specify both dxterm and shell resources as *resource.
Specifies the display screen on which dxterm displays its window. If
the display flag is not specified, dxterm uses the display screen spec‐
ified by your DISPLAY environment variable. The display flag has the
format hostname:number. The default is :0. For more information, see
X(1X). Is the same as the -d flag. Specifies that the named command,
and any of its specified options, be executed in the dxterm window when
the window is first created. This flag must appear last on the dxterm
command line. Specifies the width, length, and location of the dxterm
window, in columns, rows and pixels respectively. This flag has the
format [width][xlength][+x][+y]. Specifies that dxterm create a login
shell rather than a subshell. Specifies the setup file or files that
provide parameters that control the terminal's initial settings. This
must be a file saved by the Customize/Save function in dxterm. The
default is ~/default.DECterm. Specify -setup "" to prevent
default.DECterm from being read. Specifies the size of the dxterm win‐
dow in columns (C) and rows (R). Is the same as the -customization
The dxterm command displays a window that provides Digital VT320 termi‐
nal emulation and a standard terminal type for programs not aware of
the X Window System directly. The terminal emulator also supports the
ReGIS and sixel graphics protocols.
The menu bar contains the following items:
File Edit Commands Options Print Help
The File menu contains the following item: Shuts down the terminal emu‐
lator application (removes all its windows, stops the process running
the emulator, and ends any applications).
The Edit menu contains the following items: Copies the text selected
from the dxterm window onto the clipboard. Pastes text selected from
the clipboard into the dxterm window, as if it had been typed. Selects
all displayed text.
The Commands menu contains the following items: Prevents processes
other than the owner process from accessing the keyboard. Erases data
recorded by dxterm from the top of the scrolling area. Clears the dis‐
play and positions the cursor at the first column and first line of the
display. Changes the size of the window to match the display so that
all characters in the display are visible. Clears the communication
buffers. Resets the emulator to the original settings. For example,
sets the keyboard action mode to unlocked and the keypad mode to
The dxterm setup features are grouped into a number of related cate‐
gories. The Options menu lets you access the dialog box for each of
these categories (these correspond to VT320 Set-Up screens).
The Options menu contains the following items: Displays the Window
Options dialog box, which contains controls that affect the window fea‐
tures. Displays the Display Options dialog box, which contains con‐
trols that affect the format of the user's current window. Displays
the General Options dialog box, which contains controls for commonly
changed Customize features. Displays the Keyboard Options dialog box,
which contains controls for keyboard operating features. Allows you to
specify a 7-bit National Replacement Character Set (NRCS). Displays
the Graphics Options dialog box that contains controls for ReGIS and
sixel graphics. Displays the Printer Options dialog box, which con‐
tains controls that affect printer features. Saves the current set‐
tings to the file ~/default.DECterm. Restores the setup configuration
from the most recently read or written saved setup file (corresponds to
NVR recall on a VT320 terminal). Saves the current settings in the
file you specify. Opens a different saved setup configuration. The
standard DECwindows file selection dialog box appears, showing a list
of saved setup files in the current directory. Selecting one of these
files and clicking on OK (or double-clicking on the file) reinitializes
the terminal emulator with the configuration stored in that file.
Reinitializes the terminal emulator with the system default character‐
istics defined by your system.
The Print menu contains the following items: Prints the text in the
current window. Prints the selected information. Prints the informa‐
tion in the display and transcript as text. Prints the contents of the
display in sixel format. The Finish Printing option completes a print
job depending on the print destination. If queued to a printer, the job
is submitted. If submitted to a dedicated printer port, the job is can‐
celed. If written to a file, the file is closed. This option is used
with Auto Print mode or Printer Controller mode. The Cancel Printing
option stops the print request.
The Help menu contains the following items: Context-sensitive help is
information about an object in a window or a dialog box. To display
context-sensitive help, choose On Context from the Help menu. The
pointer changes to a question mark. Move the question mark to a menu, a
button, or another object and click MB1. Help for that object appears.
Displays an overview of DECterm along with help on how to perform vari‐
ous functions using DECterm. Displays information about how to use the
help system. Displays copyright and version information about DECterm.
Options Dialog Boxes
The Options dialog boxes represent the state of the terminal. At
application startup, the previously saved state of most terminal fea‐
tures is read from a saved set-up file (which corresponds to VT320
NVR). These feature settings remain constant until you explicitly
change them. You can change terminal operating features directly by
means of the Options dialog boxes. You can also change some of these
features indirectly by means of control functions from the host.
There are a few terminal features whose state is not stored in a saved
setup file. These features are restored to their factory default val‐
ues at application startup, or when you reset the terminal (with Reset
Terminal or DECSTR).
Window Options Dialog Box
The Window Options dialog box lets you change the following window
attributes: Changes the terminal size to match the window size automat‐
ically whenever the window size changes. Changes the window size to
match the terminal size automatically whenever the terminal size
changes. Changes the terminal size to match the size known to the ter‐
minal driver whenever the size changes in the terminal driver, and vice
versa. Displays an 18-point font. Displays a 14-point font. Displays
a font that meets the German Technical Supervision Association (T
requirements. Sets a font to a column width of 80 characters. Sets a
font to a column width of 132 characters. Adjusts the font to match
the width of the terminal automatically. Changes the title displayed
in the title bar. Changes the title displayed in the icon box. Sets
the number of rows and columns that are displayed. You can select 24,
48, or 72 rows and 80 or 132 columns, or enter a custom size in the
numeric entry fields.
Display Options Dialog Box
The Display Options dialog box lets you change the following display
attributes: Saves lines that are scrolled off the top of the display.
When you choose Record Lines Off Top, a filled-in button appears to the
left of the menu selection. Displays a vertical scroll bar along the
right side of the dxterm window. Displays a horizontal scroll bar
along the bottom of the dxterm window. Specifies that the window
scrolls vertically so that the cursor is visible. Specifies that the
window scrolls horizontally so that the cursor is visible. Specifies
that when the cursor reaches the right margin, new characters are dis‐
played on the next line. If you do not automatically wrap text, when
the cursor reaches the right margin each new character deletes the pre‐
vious character. Specifies whether the cursor is displayed. The
default is to display the cursor. Specifies whether the cursor blinks.
The default is to have the cursor blink. Specifies how many lines
scroll at the same time. Increasing the Batch Scroll count improves
performance but makes it harder to read text while it is scrolling.
Specifies how many lines to save when they scroll off the top of the
display (when the Record Lines Off Top item is enabled). Sets dark
text on a light background display. Sets light text on a dark back‐
ground display. Suppresses the status line at the bottom of the win‐
dow. Specifies that a host-writable status line appears at the bottom
of the window. Specifies that the text cursor is a block that covers
the character cell. Specifies that the text cursor is an underline at
the bottom of the character cell.
General Options Dialog Box
The General Options dialog box lets you change the following general
attributes: Turns on new line mode (NLM), which causes the Return key
to send a line feed as well as a carriage return. A line feed charac‐
ter moves the cursor to the start of the line as well as advancing it
to the next line. Locks the user-defined keys so that the host system
cannot change these definitions. Stops the host from changing your
customized settings for the Auto Repeat key and the Foreground and
Background display. Specifies that the arrow keys are set to the char‐
acters labeled on the keycaps. The keys are not mapped to any other
functions. Specifies that the arrow keys are mapped to application-
specific functions. Specifies that the numeric keypad is set to the
characters labeled on the keycaps. Specifies that the application key‐
pad is set to function as user-defined keys. Specifies that dxterm use
the DEC Multinational Character Set. To use this character set, set
the Character Set mode menu item to 8-bit Characters. The default is
the DEC Multinational Character Set. Specifies that dxterm use the
International Standards Organization (ISO) Character Set. To use this
character set, set the Character Set mode menu item to 8-bit Charac‐
ters. Specifies the character set mode to be 8 bits for use with the
DEC Supplemental or ISO Latin-1 Character Set. The default is 8-bit
character mode. Specifies the character set mode to be 7 bits for use
with the National Replacement Character Sets. The default is 8-bit
character mode. Specifies that the terminal operates in VT300 mode and
transmits 8-bit control characters. Specifies that the terminal oper‐
ates in VT300 mode and transmits 7-bit control characters. Specifies
that the terminal operates in VT100 mode, using 7-bit characters for
both input and output. Specifies that the terminal operates in VT52
mode, using 7-bit characters for both input and output. Specifies the
device attributes response (Terminal ID). The device attributes
response lets the host system know specific operating attributes of the
terminal. The Terminal ID can be one of the following:
VT100 VT101 VT102 VT125 VT220 VT240 VT320 VT330 VT340 DECterm ID
The default is DECterm ID.
Keyboard Options Dialog Box
The Keyboard Options dialog box lets you change the following keyboard
attributes: Specifies whether the warning bell sounds when dxterm
receives a BEL character (ASCII 7). The default is that the bell
sounds. Specifies whether the warning bell sounds when the cursor
reaches the right margin. The default is that the bell does not sound.
Specifies whether a character repeats or does not repeat when you hold
the key down. If you set the Lock User Feature menu item, the host
system cannot change this setting. Specifies that the Ctrl-S and
Ctrl-Q keys freeze and unfreeze the display. If this is not specified,
the Ctrl-S and Ctrl-Q keys are transmitted to the host as data charac‐
ters. Specifies whether you can make copies quickly by using the mouse
button rather than cutting and pasting into this window. To perform a
Quickcopy, select an object with MB2 and then release MB2 to insert the
object at the current cursor position. Specifies that a left single
quotation mark (`) is displayed when you press the `~ key and that a
tilde (~) is displayed when you press the Shift key and `~ key on a
keyboard using the North American or Dutch keyboard dialect. This is
the default. Specifies that the `~ key functions as an escape charac‐
ter (ESC) on a keyboard using the North American or Dutch keyboard
dialect. The default is to display the characters as labeled on the
keyboard. Specifies that the F11 key will send the F11 keycode to the
host. Specifies that the F11 key will send an escape to the host.
Specifies that a left angle bracket (<) is displayed when you press the
angle bracket key, and that a right angle bracket (>) is displayed when
you press the Shift key and angle bracket key. This is the default.
Specifies that a left single quotation mark (`) is displayed when you
press the angle brackets key and that a tilde (~) is displayed when you
press the Shift key and angle brackets key. The default is to display
the characters as labeled on the keyboard. Specifies that the back
arrow key sends a delete (ASCII 127) character. Depending on your ter‐
minal settings, this usually deletes the previous character. The
default back arrow operation sends a delete character. Specifies that
the back arrow key sends a backspace (ASCII 8, Ctrl/H). The effect of
this character depends on your terminal settings. The default back
arrow operation sends a delete character. Specifies that a comma is
displayed when you press the Shift key and comma key on a keyboard
using the North American or Dutch keyboard dialect. This is the
default. Specifies that a comma is displayed when you press the Shift
key and comma key, and that a left angle bracket (<) is displayed when
you press just the comma key on a keyboard using the North American or
Dutch keyboard dialect. The default is to display a comma.
7-bit NRCS Selection Dialog Box
The 7-bit NRCS Selection dialog box lets you select a National Replace‐
ment Character Set (NRCS) for use when the terminal is in 7-bit mode.
This selection affects output to the terminal, but not keyboard input.
To select the keyboard dialect, which does affect input, use the Key‐
board dialog box from the Session Manager's Customize menu. For exam‐
ple, to use the Spanish NRCS, select the keyboard in the Session Man‐
ager and also select the Spanish NRCS in DECterm.
To select a character set, click MB1 on the desired entry. The choices
North American Flemish Canadian (French) British Danish Finnish Aus‐
trian/German Dutch Italian Swiss (French) Swiss (German) Swedish Norwe‐
gian Belgian/French Spanish Portugese
The default character set is North American. The Dutch NRCS is no
longer supported; selecting Dutch is equivalent to selecting North
Graphics Dialog Box
The Graphics Options dialog box lets you change the following graphics
attributes: Controls whether dxterm uses shared, read-only colors for
graphics. The default is Off, but the option is forced to On if the
hardware color map is read-only. Specifies whether dxterm creates a
pixmap to allow graphics to be redrawn when the window is exposed. The
default is On. Enables the ReGIS macrograph report command. The
default is Off. Controls the number of bit planes used for graphics.
VT240 emulation requires 2 planes; VT340 emulation requires 4 planes.
On systems with fewer than 8 hardware planes, the default is 2 planes;
on systems with 8 or more hardware planes, the default is 4 planes.
Print Options Dialog Box
The Printer Options dialog box lets you change the following printer
Specifies that a queued printer selected in the Options... dialog box
should be used as the printing destination. By default, the Printer
Port option specifies the local printer port. To choose another port,
enter the device name in the text entry box. By default, information
printed on the screen does not create a file. Choosing the File option
saves the printed output to a file. By default, the None option dis‐
cards the queued job. To print characters use the Print Screen key or
use escape sequences. By default, a line of information is printed if
the cursor leaves that line because of an LF, VT, FF, or autowrap. By
default, each character is printed as it is received. If not selected,
the character is displayed. By default, the information on the display
is printed not including information stored in the transcript or status
line. By default, the information in the transcript followed by the
information on the display is printed. By default, the information
stored in the scrolling region of the display is printed. By default,
the information in the selected region of the display and transcript is
printed. By default, only national characters are printed. Other char‐
acters are either converted to the corresponding national characters or
the characters are not printed. By default, national characters and
line drawing characters are printed. By default, all characters are
printed, including multinational and technical characters. By default,
a FF is added at the end of each page. Alternately, an escape sequence
can be used. By default, any character read on the printer port is
sent back to the host application. This option is available only when
the print destination is a printer port device rather than a print
queue or a file. By default, graphics (bitmap) and text are printed.
By default, the graphics background color is printed. Omitting back‐
ground color saves ink and toner and maximizes printing speed. By
default, a sixel introducer that omits the macro parameter is selected.
This option does not use the Sixel Set Attributes command to set the
aspect ratio and the horizontal grid size. As a result, the sixel
aspect ratio is 2 to 1 and the horizontal grid size is approximately
188 x 0.025 mm (7.5 x 0.001 inches). By default, a sixel aspect ratio
of 1 to 1 with a variable grid size is printed using the Sixel Set
Attributes command (available with Level 2 printers). By default, a
sixel introducer with the 9-macro parameter is selected. This results
in a sixel aspect ratio of 1.02 to 1. By default, a compressed graph‐
ics image is printed. In Portrait mode, the output fits on an 8 x 5
inch page. By default, an expanded image is printed. In Portrait mode,
the image fits on a 13-inch page. By default, an expanded image,
rotated 90-degrees, is printed. The output fits on a 8 x 5 inch page.
By default, the Monochrome Printing option prints in black. By
default, the Color Printing option prints color output. DECterm
includes a color map in virtual memory to allow color printing from a
monochrome system. By default, the HLS Color Syntax option specifies
hue, lightness, and saturation (HLS). By default, the RGB Color Syntax
option selects a red, green, and blue (RGB) format when printed.
The dxterm application uses the values in the .Xdefaults file when you
logged in and uses the appropriate resource specification to customize
the appearance or characteristics of its displayed dxterm window. The
format for a resource specification in the .Xdefaults file is:
[name.]resource: value Specifies the application name or the name
string that restricts the resource assignment to that application or to
a component of an application. If this argument is not specified, the
resource assignment is globally available to all X applications. Spec‐
ifies the X resource. Specifies the value that is to be assigned to
In most cases, the period (.) delimiter should be replaced by an aster‐
isk (*). For more information, see X(1X).
Because each toolkit-based application can consist of a combination of
widgets (for example, push buttons and a scroll bar), you can form the
name string by adding widget class and name identifiers to the string.
For dxterm, the application class is DXterm and the application name is
the name that was specified on the command line (usually dxterm).
For dxterm, the available name identifier is terminal. This name iden‐
tifier specifies the work area of the dxterm window.
In addition to the general resources listed in X(1X), the resources
available for the dxterm work area are: Specifies that dxterm selects
the normal or condensed font based on the number of columns selected.
The default is On. If On, the program can change the size of the
dxterm window. If Off, you can specify a fixed size with the geometry
specification. However, DECterm always turns on this resource even if
you have turned it off, because DECterm resizes its window according to
the font, the number of rows, and the number of columns. Specifies the
mapping of the angle brackets (<>) key. Zero maps the key to Angle‐
Brackets (0); 1 maps it to OpenQuoteTilde (1). The default is 0.
Specifies that the application running in the window take control of
the keypad. The default is false. Specifies that autorepeat be
enabled. The default is On. Specifies that dxterm changes the logical
display size to match the window size when the user changes the window
size. The default is Off. Specifies that the dxterm window automati‐
cally resize itself to match the logical display size whenever the log‐
ical display size changes. Note that this may interfere with other
windows on the display. The default is On. Specifies that autowrap
mode be enabled. The default is Off. Specifies the back arrow key
code. This code can be delete (0) or backspace (1). The default is 0.
Specifies whether dxterm should create a pixmap to allow graphics to be
redrawn when the window is exposed. The default is On. Specifies how
many lines can be scrolled at once. The dxterm application never
scrolls more than the total number of lines on the screen at once. The
default is 1000. Specifies the font used for the "big" font set. The
default is -*-Terminal-*-*-*--18-*-*-*-*-*-*-*. The font must be a
fixed font. Controls the number of bit planes used for graphics; 2
planes are needed for VT240 emulation and 4 planes for VT340 emulation.
The default is 0, which means to use 2 planes on systems with fewer
than 8 hardware planes, and 4 planes on systems with 8 or more hardware
planes. Specifies the width of the logical display in columns. The
default is 80. Specifies that the condensed font should be used. The
default is to display the normal font (Off). Specifies that the Ctrl-S
and the Ctrl-Q keys hold and release the display. The default is On.
Specifies whether the window moves horizontally to follow the text cur‐
sor when the cursor moves outside the window. In this way, the cursor
is always contained in the window. The default is Off. Specifies
whether the window moves vertically to follow the text cursor when the
cursor moves outside the window. In this way, the cursor is always
contained in the window. The default is Off. Specifies whether the
cursor blinks. Specify on for a blinking cursor or off for one that
does not blink. The default is On. Specifies the cursor style. Spec‐
ify 0 for a block cursor or 1 for an underline cursor. The default is
0. Specifies that 8-bit characters are used in the VT300 terminal
modes. If not selected, 7-bit NRCS characters are used. The default
is On. Specifies which font is used. Specify 1 for little and 0 for
big. The default is 1. Specifies the width,length, and location of
the dxterm window. This is the same as the -geometry command line
flag. Specifies the name in the icon box. Specifies the width of the
name in the icon box. Specifies whether the dxterm window is initial‐
ized as an icon. The default is Off. Selects the 7-bit national
replacement character set (NRCS). The choices are: North American (0),
Flemish (1), French Canadian (2), British (3), Danish (4), Finnish (5),
Austrian/German (6), Dutch (7), Italian (8), Swiss French (9), Swiss
German(10), Swedish (11), Norwegian (12), Belgian/French (13), Spanish
(14), Portuguese (15). The default is 0. Specifies the font used for
the "little" font set. The default is -*-Termi‐
nal-*-*-*--14-*-*-*-*-*-*-*. The font must be a fixed font. Specifies
that changes to UDK definitions are prevented. The default is Off.
Specifies that changes to user features are prevented. The default is
Off. Specifies that the ReGIS macrograph report command is enabled.
The default is Off. Specifies that the margin bell is turned on. The
default is Off. Specifies whether line-feed or newline mode is turned
on. The default is line-feed mode. Specifies the mapping of the tilde
key (`~). This mapping can be either ApostropheTilde (0) or Escape
(1). The default is 0. Specifies the mapping of the period and comma
keys. This mapping can be either PeriodComma (0) or GreaterLessThan
(1). The default is 0. Specifies the response to a Device Attributes
(terminal ID) request. The terminal ID can be VT100 (0), VT101 (1),
VT102 (2), VT125 (3), VT220 (4), VT240 (5), VT320 (6), VT330 (9), VT340
(7), or DECterm (8). The default is 8. Specifies that dxterm reverse
the color values for foreground and background. The default is Off.
Specifies the height of the logical display in rows. The default is
24. Specifies whether dxterm should scroll lines into the transcript
instead of erasing them. The default is On. Specifies that a tran‐
script of lines be saved off the top of a scrolled display. The default
is On. Specifies the screen mode. The screen mode can be dark on
light or light on dark. The default is light on dark. Specifies that
a horizontal scroll bar be displayed in the dxterm window. The default
is Off. Specifies that a vertical scroll bar be displayed in the
dxterm window. The default is Off. Controls whether DECterm uses
shared, read-only color map entries for graphics. The default is Off,
but the option is forced on if the hardware color map is read-only.
Specifies that the status line be displayed. The default is false.
Specifies whether changing the size of the logical display changes the
size known to the terminal driver, and vice versa. The default is On.
Specifies the terminal operating mode. The terminal operating mode can
be VT52 (0), VT100 (1), VT300_7bit (2), VT300_8bit (3) Specifies that
the text cursor be enabled. The default is On. Specifies the name in
the title bar. Specifies the maximum number of lines that can be
recorded off the top of the display. The default is 500. Specifies
the user preference set to DEC (0) or ISO (1). The default is 0.
Specifies that the warning bell be turned on. The default is On.