unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



dxterm(1X)							   dxterm(1X)



NAME

  dxterm - DECwindows terminal emulator

SYNOPSIS

  dxterm [options]

OPTIONS

  -customization string
      Specifies	a value	for a dxterm resource that overrides a default set-
      ting.  The string	has the	form resource:value.  You can specify this
      option 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.

  -d dispname
      Specifies	the display screen on which dxterm displays its	window.	 If
      the display option is not	specified, dxterm uses the display screen
      specified	by your	DISPLAY	environment variable.  The display option has
      the format hostname:number.  The default is :0.  For more	information,
      see X(1X).

  -display dispname
      Performs the same	function as the	-d option.

  -e command [ options ]
      Specifies	that the named command,	and any	of its specified options, be
      executed in the dxterm window when the window is first created. This
      option must appear last on the dxterm command line.

  -geometry
      Specifies	the width, length, and location	of the dxterm window, in
      columns, rows and	pixels respectively. This option has the format
      [width][xlength][+x][+y].

  -ls Specifies	that dxterm create a login shell rather	than a subshell. If
      this option is present, a	login record is	written	to the utmp and	wtmp
      databases.

  -setup file
      Specifies	the setup file that provides parameters	which control the
      terminal's initial settings.  This file must contain valid dxterm
      resources.  See the X DEFAULTS section below for a list of available
      resources.

  -size	CxR
      Specifies	the size of the	dxterm window in columns (C) and rows (R).

  -xrm string
      Performs the same	function as the	-customization option.


DESCRIPTION

  The dxterm command displays a	window that provides VT320 terminal emulation
  and a	standard terminal type for programs not	directly aware of the X	Win-
  dow System.  The terminal emulator also supports the ReGIS and Sixel
  graphics protocols.

				     Note

       The dxterm terminal emulator does not support the following locales:

	 +  Unicode (.UTF-8) locales

	 +  Latin-9 (.ISO8859-15) locales

  To work around these restrictions, use the dtterm terminal emulator. The
  dtterm terminal emulator is the default terminal emulator for	the Common
  Desktop Environment (CDE).

MENUS

  The menu bar contains	the following items:

    +  File

    +  Edit

    +  Commands

    +  Options

    +  Print

    +  Help

  File Menu


  The File menu	contains the following item:

  Exit
      Shuts down the terminal emulator application: removes all	its windows,
      stops the	process	running	the emulator, and ends any applications.

  Edit Menu


  The Edit menu	contains the following items:

  Copy
      Copies the text selected from the	dxterm window onto the clipboard.

  Paste
      Pastes text selected from	the clipboard into the dxterm window, as if
      it had been typed.

  Select All
      Selects all displayed text.








  Commands Menu


  The Commands menu contains the following items:

  Secure Keyboard
      Prevents processes other than the	owner process from accessing the key-
      board. Selecting this option reverses the	foreground and background
      colors.

  Clear	Lines Off Top
      Erases data recorded by dxterm from the top of the scrolling area.

  Clear	Display
      Clears the display and positions the cursor at the first column and
      first line of the	display.

  Resize Window
      Changes the size of the window to	match the display so that all charac-
      ters in the display are visible.

  Clear	Communications
      Clears the communication buffers.

  Reset	Terminal
      Resets the emulator to the original settings.  For example, sets the
      keyboard action mode to unlocked and the keypad mode to numeric.

  Options Menu


  The dxterm setup features are	grouped	into a number of related categories.
  The Options menu lets	you access the dialog box for each of these
  categories, which correspond to those	for VT320 Set-Up screens.

  The Options menu contains the	following items:

  Window...
      Displays the Window Options dialog box, which contains controls that
      affect the window	features.

  Display...
      Displays the Display Options dialog box, which contains controls that
      affect the appearance of the user's current window.

  General...
      Displays the General Options dialog box, which contains controls for
      commonly changed Customize features.

  Keyboard...
      Displays the Keyboard Options dialog box,	which contains controls	for
      keyboard operating features.

  7-Bit	NRCS Selection...
      Allows you to specify a 7-bit National Replacement Character Set
      (NRCS).

  Graphics...
      Displays the Graphics Options dialog box,	which contains controls	for
      ReGIS and	Sixel graphics.

  Printer...
      Displays the Printer Options dialog box, which contains controls that
      affect printer features.

  Save Options
      Saves the	current	settings to the	file ~/DXterm or ~/DXterm_locale,
      where locale is the current locale (for example, en_US or	ja_JP).	 The
      locale string is appended	to the resource	file name unless the locale
      is C, begins with	en_US, or contains 8859-1. See the RESTRICTIONS	sec-
      tion below for cautions on using this option.

  Restore Options
      Restores the setup configuration from the	most recently read or written
      saved setup file.	 (This item corresponds	to NVR [nonvolatile RAM]
      recall on	a VT320	terminal.)

  Save Named Options...
      Saves the	current	settings in the	file you specify.

  Restore Named	Options...
      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.

  Restore System Options
      Reinitializes the	terminal emulator with the system default charac-
      teristics	defined	by your	system.

  Print	Menu


  The Print menu contains the following	items:

  Print	Text Page
      Prints the text in the current window.

  Print	Selected Text
      Prints the selected information.

  Print	All Text
      Prints the information in	the display and	transcript as text.

  Print	Graphics
      Prints the contents of the display in Sixel format.

  Finish Printing
      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 canceled.  If written to	a file,	the file is closed.
      This option is used with Auto Print mode or Printer Controller mode.

  Cancel Printing
      Stops the	print request.

  Help Menu


  The Help menu	contains the following items:

  Context-Sensitive Help
      Provides information about an object in a	window or a dialog box.	 To
      display context-sensitive	help, choose Context-Sensitive Help 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.

  Overview
      Displays an overview of DECterm along with help on how to	perform
      various functions	using DECterm.

  Using	Help
      Displays information about how to	use the	help system.

  Product Information
      Displays copyright and version information about DECterm.

  Options Dialog Boxes


  The Options dialog boxes represent the state of the terminal.	 At applica-
  tion startup,	the previously saved states for	most terminal features are
  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 states are not stored	in a saved
  setup	file.  These features are restored to their factory default values 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 attri-
  butes:

  Auto Resize Terminal
      Changes the terminal size	to match the window size automatically when-
      ever the window size changes.

  Auto Resize Window
      Changes the window size to match the terminal size automatically when-
      ever the terminal	size changes.

  Terminal Driver Resize
      Changes the terminal size	to match the size known	to the terminal
      driver whenever the size changes in the terminal driver, and vice
      versa.

  Terminal Size
      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.

  Normal Font (80 Columns)
      Uses a normal (non-condensed) font for all column	widths.

  Condensed Font (132 Columns)
      Uses a condensed font for	all column widths.

  Normal/80, Condensed/132
      Uses a normal (non-condensed) font for column widths of 80 characters
      or less, and a condensed font otherwise.

  Big Font
      By default, dxterm uses an 18-pixel font.	 This default can be changed
      by selecting the Other radio button and entering a font name in the
      text field next to this radio button.

  Little Font
      By default, dxterm uses a	14-pixel font. This default can	be changed by
      selecting	the Other radio	button and entering a font name	in the text
      field next to this radio button.

  German Standard Font
      Displays a font that meets the German Technical Supervision Association
      (TUV) requirements.

  Window Title
      Changes the title	displayed in the title bar.

  Icon Name
      Changes the title	displayed in the icon box.

  Display Options Dialog Box


  The Display Options dialog box lets you change the following display attri-
  butes:

  Record Lines Off Top
      Saves lines that are scrolled off	the top	of the display.	 When this
      option is	enabled, any text that scrolls off the top of the display is
      saved in the scrollback buffer. The default number of lines saved	is
      100. To see the lines in this area, scroll the display using the mouse
      in the vertical scrollbar. Or scroll by holding down the Ctrl key	and
      pressing either the up/down arrow	keys or	the Next Page or Previous
      Page keys	(Page Up and Page Down keys on PC-style	keyboards).

  Vertical Scroll Bar
      Displays a vertical scroll bar along the right side of the dxterm	win-
      dow.

  Horizontal Scroll Bar
      Displays a horizontal scroll bar along the bottom	of the dxterm window.

  Vertical Cursor Coupling
      Specifies	that the window	scrolls	vertically so the cursor is visible.

  Horizontal Cursor Coupling
      Specifies	that the window	scrolls	horizontally so	the cursor is visi-
      ble.

  Auto Wrap
      Specifies	that when the cursor reaches the right margin, new characters
      are displayed on the next	line.  If you do not automatically wrap	text,
      when the cursor reaches the right	margin,	each new character deletes
      the previous character.

  Display Cursor
      Specifies	whether	the cursor is displayed.  The default is to display
      the cursor.

  Cursor Blink
      Specifies	whether	the cursor blinks.  The	default	is to have the cursor
      blink.

  Batch	Scroll nnn Lines
      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.

  Record nnn Lines Off Top
      Specifies	how many lines to save when they scroll	off the	top of the
      display (that is,	when the Record	Lines Off Top item is enabled).

  Dark Text, Light Background
      Sets dark	text on	a light	background display.

  Light	Text, Dark Background
      Sets light text on a dark	background display.

  No Status Display
      Suppresses the status line at the	bottom of the window.

  Host Status Display
      Specifies	that a host-writable status line appears at the	bottom of the
      window.

  Block	Cursor
      Specifies	that the text cursor is	a block	that covers the	character
      cell.

  Underline Cursor
      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 attri-
  butes:

  Newline
      Turns on newline mode (NLM), which causes	the Return key to send a line
      feed as well as a	carriage return.  With newline mode, the line feed
      character	moves the cursor to the	start of the line as well as advanc-
      ing it to	the next line.

  Lock UDKs
      Locks the	user-defined keys so that the host system cannot change	these
      definitions.

  Lock User Features
      Stops the	host from changing your	customized settings for	the Auto
      Repeat key and the Foreground and	Background display.

  Local	Echo
      Causes every character to	be echoed to the screen	and sent to the	host.

  Normal Cursor	Keys
      Specifies	that the arrow keys are	set to the characters labeled on the
      keycaps.	The keys are not mapped	to any other functions.

  Appl Cursor Keys
      Specifies	that the arrow keys are	mapped to application-specific func-
      tions.

  Numeric Keypad
      Specifies	that the numeric keypad	is set to the characters labeled on
      the keycaps.

  Application Keypad
      Specifies	that the application keypad is set to function as user-
      defined keys.

  UPSS DEC Supplemental
      Specifies	that dxterm use	the DIGITAL Multinational Character Set
      (DMCS).  To use this character set, set the Character Set	mode menu
      item to 8-bit Characters.	 The default is	8-bit character	mode.

  UPSS ISO Latin-1
      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 Characters.

  8-bit	Multinational Characters
      Specifies	the character set mode to be 8 bits for	use with the ISO
      Latin-1 Character	Set.  The default is 8-bit character mode.

  7-bit	NRCS Characters
      Specifies	the character set mode to be 7 bits for	use with the National
      Replacement Character Sets.  The default is 8-bit	character mode.

  VT300	Mode, 8-bit Controls
      Specifies	that the terminal operates in VT300 mode and transmits 8-bit
      control characters.

  VT300	Mode, 7-bit Controls
      Specifies	that the terminal operates in VT300 mode and transmits 7-bit
      control characters.

  VT100	Mode
      Specifies	that the terminal operates in VT100 mode, using	7-bit charac-
      ters for both input and output.

  VT52 Mode
      Specifies	that the terminal operates in VT52 mode, using 7-bit charac-
      ters for both input and output.

  Terminal ID
      Specifies	the device attributes response (Terminal ID). The device
      attributes response lets the host	system know specific operating attri-
      butes 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.

  Answerback Message
      Specifies	that any text entered into this	field will be sent to the
      host when	dxterm is requested by the host	to send	its answerback mes-
      sage or when the user presses Ctrl-F5.  To include non-printing charac-
      ters in the answerback string, specify the character in hexadecimal
      notation preceded	by a pound sign.  For example, the string #0D sends a
      carriage return character	to the host.  To include a pound sign in the
      answerback message, use the string ##.

  Conceal Answerback Message
      Specifies	that the answerback message entered in the Answerback Message
      text field will not be displayed in the dialog box.  Once	selected,
      this button cannot be deselected.	 The only way to deselect it is	to
      select the Answerback Message text entry field. This action erases the
      previous answerback message.







  Keyboard Options Dialog Box


  The Keyboard Options dialog box lets you change the following	keyboard
  attributes:

  Warning bell
      Specifies	whether	the warning bell sounds	when dxterm receives a BEL
      character	(ASCII 7).  The	default	is that	the bell sounds.

  Margin Bell
      Specifies	whether	the warning bell sounds	when the cursor	reaches	the
      right margin.  The default is that the bell does not sound.

  Ctrl-Q, Ctrl-S = Hold
      Specifies	that the Ctrl-S	and Ctrl-Q key sequences freeze	and unfreeze
      the display.  If this option is not specified, the Ctrl-S	and Ctrl-Q
      key sequences are	transmitted to the host	as data	characters.

  Allow	Quickcopy
      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.

  F11 Key Sends	F11
      Specifies	that the F11 key will send the F11 keycode to the host.

  F11 Sends Escape
      Specifies	that the F11 key will send an escape to	the host.

  Tilde	Key Sends `~
      Specifies	that a left single quotation mark (`) (grave accent) 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	setting	is the default.

  Tilde	Key Sends ESC
      Specifies	that the `~ key	functions as an	escape character (ESC) on a
      keyboard using the North American	or Dutch keyboard dialect. The
      default is to display the	characters as labeled on the keyboard.

  Angle	Brackets Key Sends (<>)
      Specifies	that a left angle bracket (<) is displayed when	you press the
      angle brackets key, and that a right angle bracket (>) is	displayed
      when you press the Shift key and angle brackets key.  This setting is
      the default.

  Angle	Brackets Key Sends `~
      Specifies	that a left single quotation mark (`) (grave accent) 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.

  <X] Delete
      Specifies	that the back arrow key	sends a	delete (ASCII 127) character.
      Depending	on your	terminal settings, pressing this key usually deletes
      the previous character.  The default back	arrow operation	sends a
      delete character.

  <X] Backspace
      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.

  Comma	Key Sends ,,
      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.	It also	specifies that a period	is displayed when you press
      the Shift	key and	the period key on these	keyboards.  This setting is
      the default.

  Comma	Key Sends ,<
      Specifies	that a left angle bracket (<) is displayed when	you press the
      Shift key	and the	comma key, and that a comma is displayed when you
      press only the comma key on a keyboard using the North American or
      Dutch keyboard dialect.  It also specifies that a	right angle bracket
      (>) is displayed when you	press the Shift	key and	the period key,	and
      that a period is displayed when you press	only the period	key on these
      keyboards.

  7-bit	NRCS Selection Dialog Box


  The 7-bit NRCS Selection dialog box lets you select a	National Replacement
  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	Keyboard dia-
  log box from the Session Manager's Customize menu.  For example, to use the
  Spanish NRCS,	select the keyboard in the Session Manager and also select
  the Spanish NRCS in DECterm.

  To select a character	set, click MB1 on the desired entry. The choices are:

       North American
       Flemish
       Canadian	(French)
       British
       Danish
       Finnish
       Austrian/German
       Dutch
       Italian
       Swiss (French)
       Swiss (German)
       Swedish
       Norwegian
       Belgian/French
       Spanish
       Portuguese

  The default character	set is North American.	The Dutch NRCS is no longer
  supported; selecting Dutch is	equivalent to selecting	North American.

  Graphics Dialog Box


  The Graphics Options dialog box lets you change the following	graphics
  attributes:

  Share	Color Map Entries
      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.

  Enable Backing Store
      Specifies	whether	dxterm creates a pixmap	to allow graphics to be
      redrawn when the window is exposed.  The default is On.

  Report Macrograph Contents
      Enables the ReGIS	macrograph report command.  The	default	is Off.

  NN Bit Planes
      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 attri-
  butes:

  Queued Printer
      Specifies	that a queued printer selected in the Options... dialog	box
      should be	used as	the printing destination.

  Printer Port
      By default, the Printer Port option specifies the	local printer port.
      To choose	another	port, enter the	device name in the text	entry box.

  File
      By default, information printed on the screen does not create a file.
      Choosing the File	option saves the printed output	to a file.

  None
      By default, the None option discards the queued job.

  Normal Print Mode
      To print characters use the Print	Screen key or use escape sequences.

  Auto Print Mode
      By default, a line of information	is printed if the cursor leaves	that
      line because of an LF, VT, FF, or	autowrap.

  Printer Controller Mode
      By default, each character is printed as it is received.	If this
      attribute	is not selected, the character is displayed.

  Print	Full Page
      By default, the information on the display is printed but	does not
      include information stored in the	transcript or status line.

  Print	Full Page + Transcript
      By default, the information in the transcript followed by	the informa-
      tion on the display is printed.

  Print	Scroll Region Only
      By default, the information stored in the	scrolling region of the
      display is printed.

  Print	Selection Only
      By default, the information in the selected region of the	display	and
      transcript is printed.

  Print	National Characters Only
      By default, only national	characters are printed.	 Other characters are
      either converted to the corresponding national characters	or the char-
      acters are not printed.

  Print	National + Line	Drawing
      By default, national characters and line drawing characters are
      printed.

  Print	All Characters
      By default, all characters are printed, including	multinational and
      technical	characters.

  Form Feed Terminator
      By default, a form feed (FF) is added at the end of each page. Alter-
      nately, an escape	sequence can be	used.

  Printer To Host
      By default, any character	read on	the printer port is sent back to the
      host application.	 This option is	available only when the	print desti-
      nation is	a printer port device rather than a print queue	or a file.

  Graphics Printing
      By default, graphics (bitmap) and	text are printed.

  Background Printing
      By default, the graphics background color	is printed.  Omitting back-
      ground color saves ink and toner and maximizes printing speed.

  Level	1 Sixel	Graphics
      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 approxi-
      mately 188 x 0.025 mm (7.5 x 0.001 inches).

  Level	2 Sixel	Graphics
      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).

  LA210	Sixel Graphics
      By default, a Sixel introducer with the 9-macro parameter	is selected.
      This results in a	Sixel aspect ratio of 1.02 to 1.

  Compressed Graphics Printing
      By default, a compressed graphics	image is printed.  In Portrait mode,
      the output fits on an 8 x	5 inch page.

  Expanded Graphics Printing
      By default, an expanded image is printed.	 In Portrait mode, the image
      fits on a	13-inch	page.

  Rotated Graphics Printing
      By default, an expanded image, rotated 90-degrees, is printed.  The
      output fits on a 8 x 5 inch page.

  Monochrome Printing
      By default, the Monochrome Printing option prints	in black.

  Color	Printing
      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.

  7-Bit	Printer
      By default, this option sends only 7-bit control sequences to the
      printer.

  8-Bit	Printer
      By default, this option sends 8-bit control sequences to the printer.

  HLS Color Syntax
      By default, the HLS Color	Syntax option specifies	hue, lightness,	and
      saturation (HLS).

  RGB Color Syntax
      By default, the RGB Color	Syntax option selects a	red, green, and	blue
      (RGB) format when	printing.





X DEFAULTS

  The dxterm application reads the values in the default resource file
  (~/DXterm or ~/DXterm_locale)	and uses the appropriate resource specifica-
  tion to customize the	appearance or characteristics of its displayed win-
  dow. The format for a	resource specification is:

       DXterm.main.terminal.resource:  value

  resource
      Specifies	the X resource.

  value
      Specifies	the value that is to be	assigned to the	resource.

  In addition to the general resources listed in X(1X),	the resources avail-
  able for the dxterm work area	are:

  adjustFontSizes
      Specifies	that dxterm selects the	normal or condensed font based on the
      number of	columns	selected.  The default is On.

  allowQuickCopy
      If enabled, the user is allowed to use Quick Copy	to enter text into
      the dxterm window.  This setting is the default.

  allowSendEvents
      This resource is automatically disabled when the Secure Keyboard option
      is selected.  When disabled, dxterm will not accept input	sent from
      other X clients.

  angleBracketsKey
      Specifies	the mapping of the angle brackets (<>) key.  Zero maps the
      key to AngleBrackets (0);	1 maps it to OpenQuoteTilde (1).  The default
      is 0.

  answerbackMessage
      Specifies	the string to send for dxterm's	answerback message.

  applicationCursorKeyMode
      Specifies	that the application running in	the window take	control	of
      the cursor keys.	The default is false.

  applicationKeypadMode
      Specifies	that the application running in	the window take	control	of
      the keypad. The default is false.

  autoResizeTerminal
      Specifies	that dxterm changes the	logical	display	size to	match the
      window size when the user	changes	the window size.  The default is Off.

  autoResizeWindow
      Specifies	that the dxterm	window automatically resize itself to match
      the logical display size whenever	the logical display size changes.
      Note that	this setting may interfere with	other windows on the display.
      The default is On.

  autoWrapEnable
      Specifies	that autowrap mode be enabled.	The default is Off.

  backarrowKey
      Specifies	the back arrow key code.  This code can	be delete (1) or
      backspace	(0).  The default is 1.

  backingStoreEnable
      Specifies	whether	dxterm should create a pixmap to allow graphics	to be
      redrawn when the window is exposed.  The default is On.

  batchScrollCount
      Specifies	how many lines can be scrolled at once.	 The dxterm applica-
      tion never scrolls more than the total number of lines on	the screen at
      once.  The default is 1000.

  bigFontOtherName
      Specifies	the Other font to be used for the Big Font set.

  bigFontSetName
      Specifies	the default font used for the Big Font set.  The default is
      -bitstream-terminal-*-*-*--18-*-*-*-*-*-*-*.  The	font must be a
      fixed-width font.

  bigFontSetSelection
      Specifies	whether	the Default or the Other Big Font is used. Specify on
      to use the Other font and	off to use the Default font.

  bitPlanes
      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.

  columns
      Specifies	the width of the logical display in columns.  The default is
      80.

  concealAnswerback
      Specifies	if the answerback message should be visible in the General
      Options dialog box.

  condensedFont
      Specifies	that the condensed font	should be used.	 The default is	to
      display the normal font (Off).

  controlQSHold
      Specifies	that the Ctrl-S	and the	Ctrl-Q keys hold and release the
      display.	The default is On.

  couplingHorizontal
      Specifies	whether	the window moves horizontally to follow	the text cur-
      sor when the cursor moves	outside	the window. With this setting
      enabled, the cursor is always contained in the window. The default is
      Off.

  couplingVertical
      Specifies	whether	the window moves vertically to follow the text cursor
      when the cursor moves outside the	window.	With this setting enabled,
      the cursor is always contained in	the window. The	default	is Off.

  cursorBlinkEnable
      Specifies	whether	the cursor blinks.  Specify On for a blinking cursor
      or Off for one that does not blink.  The default is On.

  cursorOffTime
      Specifies	the time in milliseconds that the cursor is off	for each
      blink period.  The default is 330	ms.

  cursorOnTime
      Specifies	the time in milliseconds that the cursor is on for each	blink
      period.  The default is 670 ms.

  cursorStyle
      Specifies	the cursor style.  Specify 0 for a block cursor	or 1 for an
      underline	cursor.	 The default is	0.

  doubleClickDelay
      Specifies	the time in milliseconds that can elapse between two succes-
      sive mouse button	clicks so that they are	recognized as a	double (or
      triple) click.  The default is 250 ms.

  eightBitCharacters
      Specifies	that 8-bit characters are used in the VT300 terminal modes.
      If this attribute	is not selected, 7-bit NRCS characters are used.  The
      default is On.

  f11EscapeKey
      Specifies	if the F11 key sends an	Escape character or the	sequence for
      F11. Specify 1 for Escape	and 0 for F11.	The default is 1.

  fontSetSelection
      Specifies	which font is used.  Specify 0 for the Big Font, 1 for the
      Little Font, and 2 for the German	Standard Font.	The default is 1.

  graphicsPrintingEnabled
      Specifies	whether	graphics (Sixel) printing is allowed.  The default is
      On.

  gsFontOtherName
      Specifies	the Other font used for	the German Standard font set.

  gsFontSetName
      Specifies	the default font used for the German Standard font set.	 The
      default is -dec-terminal-*-*-*-GS-14-*-*-*-*-*-*-*

  gsFontSetSelection
      Specifies	whether	the Default or the Other German	Standard font is
      used.  Specify on	to use the Other font and off to use the Default
      font.

  keyboardDialect
      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.

  littleFontOtherName
      Specifies	the Other font used for	the Little Font	set.

  littleFontSetName
      Specifies	the default font used for the Little Font set.	The default
      is -dec-terminal-*-*-*--14-*-*-*-*-*-*-*.	 The font must be a fixed-
      width font.

  littleFontSetSelection
      Specifies	whether	the Default or the Other Little	Font is	used. Specify
      on to use	the Other font and off to use the Default font.

  localEcho
      Specifies	whether	every character	that is	sent to	the host is also
      echoed to	the screen locally.

  lockUDK
      Specifies	that changes to	UDK definitions	are prevented.	The default
      is Off.

  lockUserFeatures
      Specifies	that changes to	user features are prevented.  The default is
      Off.

  loginShell
      Specifies	that a login shell should be started (same as -ls option).
      The default is false.

  macrographReportEnable
      Specifies	that the ReGIS macrograph report command is enabled.  The
      default is Off.

  marginBellEnable
      Specifies	that the margin	bell is	turned on.  The	default	is Off.

  newLineMode
      Specifies	whether	line-feed or newline mode is turned on.	The default
      is line-feed mode.

  openQuoteTildeKey
      Specifies	the mapping of the tilde key (~).  This	mapping	can be either
      ApostropheTilde (0) or Escape (1).  The default is 0.

  periodCommaKeys
      Specifies	the mapping of the period and comma keys.  This	mapping	can
      be either	PeriodComma (0)	or GreaterLessThan (1).	 The default is	0.

  print8BitMode
      Specifies	whether	to use 7 or 8 bit control codes.  The default is to
      use 8 bits (on).

  printBackgroundMode
      Specifies	whether	to print the background	color during graphics print-
      ing. The default is on.

  printColorMode
      Specifies	whether	the colormap is	downloaded during graphics printing.
      The default is on.

  printDataType
      Specifies	which characters are printed.  Specify 0 for National charac-
      ters only, 1 for National	characters plus	line drawing characters, or 2
      for all characters.  The default is 0.

  printDisplayMode
      Specifies	whether	to print the status line.  Specify 0 to	include	the
      status line or 1 to print	only the main display.	The default is 1.

  printExtent
      Specifies	how much to print.  Specify 0 to print the full	page, 1	to
      print the	full page plus the transcript, 2 to print only the scroll
      region, or 3 to print only the selection.	 The default is	0.

  printFormFeedMode
      Specifies	whether	a print	job should be terminated with a	form feed
      character. The default is	on.

  printFormat
      Specifies	the graphics printing format.  Specify 0 for compressed
      printing,	1 for expanded printing, or 2 for rotated printing.  The
      default is 0.

  printHLSColorSyntax
      Specifies	whether	to use HLS (on)	or RBG (off) color descriptions). The
      default is on.

  printMode
      Specifies	the print mode.	 Specify 0 for normal printing,	1 for printer
      controller mode, or 2 for	auto print mode.  The default is 0.

  printSixelLevel
      Specifies	the format of Sixel output.  Specify 0 for level 1 Sixel
      Graphics,	1 for level 2 Sixel Graphics, or 2 for LA210 Sixel Graphics.
      The default is 1.

  printerFileName
      Specifies	the name of the	file to	print to if the	printing destination
      is set to	a file.

  printerPortName
      Specifies	the name of the	printer	port to	print to if the	printing des-
      tination is set to a printer port.

  printerToHostEnabled
      Specifies	whether	printer-to-host	mode is	enabled.  The default is off.

  printingDestination
      Specifies	the printing destination.  Specify 0 to	print to a queue, 1
      to print to a port, 2 to print to	a file,	or 3 to	print to nowhere.
      The default is 0.

  responseDA
      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.

  reverseVideo
      Specifies	that dxterm reverse the	color values for foreground and	back-
      ground.  The default is Off.

  rows
      Specifies	the height of the logical display in rows.  The	default	is
      24.

  saveErasedLines
      Specifies	whether	dxterm should scroll lines into	the transcript
      instead of erasing them.	The default is On.

  saveLinesOffTop
      Specifies	that a transcript of lines be saved off	the top	of a scrolled
      display.	The default is On.

  screenMode
      Specifies	the screen mode.  The screen mode can be dark on light or
      light on dark.  The default is light on dark.

  scrollHorizontal
      Specifies	that a horizontal scroll bar be	displayed in the dxterm	win-
      dow.  The	default	is Off.

  scrollVertical
      Specifies	that a vertical	scroll bar be displayed	in the dxterm window.
      The default is Off.

  secureKeyboard
      Specifies	whether	the secure keyboard feature is enabled.	 The default
      is off.

  selectThreshold
      Specifies	the number of pixels that the mouse has	to be moved while a
      button is	pressed	before it is recognized	as a selection.	 The default
      is 5.

  shareColorMapEntries
      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.

  statusDisplayEnable
      Specifies	that the status	line be	displayed.  The	default	is false.

  syncFrequency
      Specifies	the number of lines scrolled before the	display	is synchron-
      ized.  This setting controls the trade-off between scrolling speed and
      keyboard responsiveness (especially for ^S).  The	default	is 10.

  terminalDriverResize
      Specifies	whether	changing the size of the logical display changes the
      size known to the	terminal driver, and vice versa.  The default is On.

  terminalMode
      Specifies	the terminal operating mode.  The terminal operating mode can
      be VT52 (0), VT100 (1), VT300_7bit (2), or VT300_8bit (3)

  textCursorEnable
      Specifies	that the text cursor be	enabled.  The default is On.

  transcriptSize
      Specifies	the maximum number of lines that can be	recorded off the top
      of the display.  The default is 100.

  useBoldFont
      Specifies	whether	to use a bold font or VT340 style color	for text
      displayed	with the bold attribute.  The default is to use	the bold
      font.

  useWMHints
      Specifies	whether	to set the Window Manager Hints.  When enabled,
      dxterm reports its size in character cells instead of pixels. The
      default is to set	the Window Manager Hints.

  userPreferenceSet
      Specifies	the user preference set	to DEC (0) or ISO (1).	The default
      is 0.

  warningBellEnable
      Specifies	that the warning bell be turned	on.  The default is On.

  whiteSpaceCharacters
      Specifies	the characters which delimit a word when using a double-click
      to select	a word.	 The default is	\ \t\r\n (that is, space, tab, car-
      riage return, and	newline	all delimit a word).

RESTRICTIONS

  When saving dxterm options with the Save Options menu	item, the entire
  resource database is saved to	the default resource file (~/DXterm or
  ~/DXterm_locale). A DECterm will, incorrectly, use the value in this file
  to override other resource specifications. This can cause unexpected
  behavior in any of the following situations:

    +  A dxterm	is displayed on	a screen with a	different depth	from the one
       used when the resource file was created.

    +  Command line switches are used in an attempt to override	settings in
       the resource file.

    +  The -setup switch is used to try	to prevent the default resource	file
       from being read.	(The default resource file is read regardless.)

  To avoid such	problems:

    +  Do not use an unedited resource file created with Save Options. If you
       want to set resources saved in this file, edit the file,	removing all
       resource	specifications except the specific ones	you want to set.

    +  If Save Options created a resource file with the	locale appended	(for
       example,	DXterm_ja_JP), delete ~/DXterm if it exists.

    +  Alternatively, delete the default resource file and do either of	the
       following:

	 -- Create a resource file containing only the resources you want to
	    set	and use	it as an argument to the -setup	switch.

	 -- Use	the -xrm switch	to specify the resources.

  Chinese DECterm software supports using the DEC Hanyu, Big5, or DEC Hanzi
  codeset as terminal code. The	software does not support using	the Taiwanese
  EUC codeset as terminal code.	To process characters in this codeset,
  Chinese DECterm users	should do the following:

   1.  Start the Chinese DECterm software by using the zh_TW.dechanyu locale.
       For example:
	    % /usr/bin/X11/dxterm -xnl zh_TW.dechanyu

   2.  In the DECterm window just started, enter the following commands:
	    % setenv LANG zh_TW.eucTW
	    % stty adec	acode eucTW tcode dechanyu



  At this point, terminal applications can process files that contain
  Taiwanese EUC	characters.

FILES

  ~/DXterm

  /usr/lib/X11/app-defaults/DXterm

SEE ALSO

  X(1X)