mterm(1) X11 R4.11MU05 mterm(1)
NAME
mterm - terminal emulator for X with VT100, DG D216, D410, and VT52
modes
SYNOPSIS
mterm [-toolkitoption ...] [-option ...]
DESCRIPTION
Mterm emulates a Data General Dasher 216 or 410 terminal with both
VT100 and DG modes. It runs under the X Window System using a Motif-
style interface with support for scrolling through screen history,
selections for cut and paste with other X applications, and a
resizeable window. Mterm also includes a search facility to allow you
to search the current screen and history for text. Pass through
printing, screen printing, and logging are also supported.
Access to local host:
Mterm provides access to the local DG/UX host using a
command shell such as /bin/csh or /bin/sh. The user's
SHELL environment variable determines which shell is used
on startup. If the SHELL variable is not defined, /bin/csh
is used.
Access to remote machines:
Mterm provides access to remote machines over a lan or
async connection. For lan connection, the user must run
another program such as telnet, or rlogin. Async access to
another host is directly supported with the -async option;
no other process is required for async access.
Each instance of Mterm can be customized using command-line options
and resources; many Mterm features can be customized by both command-
line options and X resources. Resources are generally useful to
define several features commonly used or used as a group. Command-
line options are more useful for exceptions to these common features.
For more information about resources and resource files see the man
page for Xdefaults and X.
OVERVIEW OF X OPTIONS
All standard X Toolkit options apply to Mterm. These include the
following: -display, -name, -geometry, -title, -iconic, -xrm, -fg,
and -bg. (See X(1) for more information about these options.)
MTERM COMMAND-LINE OPTIONS
There is a corresponding resource for each option, but a command-line
setting always has precedence over the resource setting.
-version Print out the version of Mterm.
-ab Set the bell to be audible (beep) - this is the default.
+ab Turn the audio characteristic of the bell off.
-ah Allows Mterm to scroll the window in the horizontal
direction to keep the cursor displayed. This is the
default.
+ah Do not allow horizontal scrolling to keep the cursor
displayed.
-async Start Mterm with a connection to a serial line. (See -tty
option.) When the tty line is opened a lock file is
created as /usr/spool/lock/LK.000.<major>.<minor>, where
<major> is the major device number and <minor> is the minor
device number. (See FILES.)
+async Start Mterm with a connection to the local child process.
This is the default.
-backspace keyvalue
Define which key is the backspace key. By default mterm
uses the BACKSPACE key. Some users may wish to use the
DELETE key instead. To use the DELETE key you would start
Mterm with '-backspace 8'. (8 is the value of the DELETE
key).
-baud rate
Set the async baud rate. Supported rates are 110, 134,
150, 300, 600, 1200, 1800, 2400, 4800, 9600, 19200 and
38400. The default is 9600.
-bbf font Define the bold blink font. If no bold blink font is
specified, the default bold blink font will be used. If an
invalid bold blink font is specified, the bold font will be
used. (See the Mterm online help for more information).
-bc count Set the number of beeps/flashes for the bell. Defaults to
one beep and/or flash.
-bf font Define the bold font. If no bold font is specified, the
default bold font will be used. If an invalid bold font is
specified, the dim font will be used. (See the Mterm online
help for more information).
-blinkFont font
Define the blink font. If no blink font is specified, the
default blink font will be used. If an invalid blink font
is specified, the dim font will be used. (See the Mterm
online help for more information).
-bs keyvalue
Define backspace to be bs (backspace) or delete. This
option only determines what code is sent when the key is
pressed, it does not do an stty setting like -backspace
does. The default is bs.
-C Redirect system console messages to the Mterm window. This
option is only available without the -async option.
-colorSet color set
Define which color set to use. A color set maps colors to
display attributes. For instance you can have bold be red,
and dim be blue. Mono workstations will ignore this
command. No default color sets are provided. You must use
the mterm Color Set Editor to define some color sets before
using this option. More information is available from the
on-line help system. For the color editor to be available
on 24 bit systems you must start X11 with the -cc 3 command
line option. The X11 command line can be found in the
/var/X11/xdm/Xservers file.
-columns columns
Set the maximum number of columns (i.e. maximum width) for
vt100 and vt52 mode. The default value is 0, which causes
Mterm to match the window size.
-cursorPosor-cp
Display the current cursor row and column position as part
of the window menu title. When using this option the window
title will be truncated to 256 characters to make room for
the row/column information. This feature is off by
default. +cursorPosor+cp Turn the display of the current
cursor row and column position off. This is the default.
-debug Output debugging information. If logging is on, record all
data sent to and received from the child process. This
option is intended for mterm development and testing
purposes ONLY.
+debug Turn debugging off. This is the default.
-xrDebug Output resource file debugging information. This option is
intended for development purposes ONLY.
+xrDebug Turn the resource file debugging off. This is the default.
-df font Define the dim font. If no dim font is specified, the
default blink font will be used. If an invalid dim font is
specified, Mterm exits with an appropriate error message.
(See the Mterm online help for more information).
-d216 Provide DG D216 emulation. The window and screen are set to
24 rows and 80 columns. This is useful for connection to
AOS/VS(tm) or AOS/VS II(tm) systems.
-d410 Provide DG D410 emulation. The screen size is set to 24
rows and 160 columns. The window size (what you see of the
screen) is set to 24 rows and 81 columns. The rest of the
screen can be viewed by resizing the window or moving the
horizontal scroll bar. This is useful for connection to
AOS/VS(tm) or AOS/VS II(tm) systems.
-d216mid code
Set the value of the model id code returned when in DG D216
mode. Do not include the first character of the model id
code, as it is supplied by Mterm (<036>). Changing the
model id can cause undesirable results.
-d410mid code
Set the value of the model id code returned when in DG D410
mode. Do not include the first character of the model id
code, as it is supplied by Mterm (<036>). Changing the
model id can cause undesirable results.
-e commandline
Define the executable (and its arguments) to be run in the
Mterm window. When used, this must be the last option on
the command line. Everything after the -e is used as the
executable command line for the new process.
-fc charset
Use the given font character set (e.g. iso8859-1) in the
font name template. WARNING: Use this option only with the
default fonts; it will NOT work if any of the font name
resources have been set. (See the Mterm online help for
more information).
-fd dpi Use the given font dpi (i.e. dots per inch, usually 75 or
100) in the font name template. WARNING: Use this option
only with the default fonts; it will NOT work if any of the
font name resources have been set. (See the Mterm online
help for more information).
-ff family
Use the given font family (e.g. courier, times or
helvetica) in the font name template. WARNING: Use this
option only with the default fonts; it will NOT work if any
of the font name resources have been set. (See the Mterm
online help for more information).
-flowControl mode
Set flow control to none, cts (hardware), or xon
(software). The default is cts.
-fm maker Set the font maker (e.g. adobe, dec or sun) in the font
name template. WARNING: Use this option only with the
default fonts; it will NOT work if any of the font name
resources have been set. (See the Mterm online help for
more information).
-fs size Use the given font size for Mterm. Supported values are 8,
10, 12, 14, 18, and 24, with a default value of 14.
WARNING: If you have specified any of the fonts to be used,
you must set the font size to match the specified fonts. If
the font size is not set to match the specified fonts,
characters will not be displayed properly on the screen.
(See the Mterm online help for more information).
-fw width Use the given font width in the font name template. This
width is the unweighted arithmetic mean width of all glyphs
in the font. WARNING: Use this option only with the
default fonts; it will NOT work if any of the font name
resources have been set. (See the Mterm online help for
more information).
-ic When in d410 mode, Mterm will normally change the window
size to 24x135 when it receives a command to go to
compressed mode. This allows all of the characters to be
displayed. The -ic (ignoreCompress) option tells mterm to
ignore the requests to change between compressed and normal
modes.
+ic Allow mterm to recognize requests to change between
compressed and normal modes. This is the default.
-in name Set the icon name to name.
-lf file Use file for logging the Mterm session when logging is
turned on. Logging can be controlled using the "Logging"
dialog box. Logfile size is limited to available disk
space. Two Mterms cannot open the same logfile at the same
time. The default logfile name is $HOME/mterm.log.
-logging Record the current Mterm session in the logfile.
+logging Turn logging off. This is the default.
-ls Start up a login shell in the Mterm window (i.e. tell the
shell to read the user's .login or .profile).
+ls Start a normal subshell in the Mterm window. This is the
default.
-mp path This resource defines where your macro files are located.
The default is .mtermMacros in your home directory. ~ and
$HOME are not supported in this pathname. This option
overrides Mterm.macroPath.
-nl keyvalue
Define your <Enter> key to be cr, nl, or crnl. The default
is cr.
-parity parity
Select even, odd, or none as the type pf parity desired for
an async connection.
-pc lp -c %$1s
Mterm supports print pass thru by creating a temporary file
of the data that was to go to the printer, and then
executing a command against the temporary file. The -pc
commandline option and the printCommand resource define the
command used to print (or copy/move/etc.) the temporary
file. To insert the name of the temporary file in the print
command use '%$1s'. The default value sends the file to
your default printer after making a copy of it. Mterm
deletes the temporary file after the command has been
executed. That is why lp commands must use the -c option.
The print command should be quoted.
-pm Use a popup menu to display the menus.
+pm Use a menu bar to display the menus. This is the default.
-rl Remove (over-ride) an existing lock file if it is owned by
the user.
+rl Recognize an existing lock file. This is the default.
-rows rows
Set the maximum number of rows (i.e. maximum height) for an
vt100 or vt52 window. The default value is 0, which causes
Mterm to match to the window size.
-sc Save cleared screens. Normally lines are saved into the
history buffer only when they are scrolled off the top of
the screen, not when the screen is cleared. With the -sc
switch, cleared screens are also saved to the history
buffer.
+sc Don't save cleared screens (default).
-sd delay Set the delay in smooth scrolling at the end of a line to
delay (in hundredths of a second).
-sf file Use file for saving Mterm screens and history. You can
save screens and/or history by selecting 'Save Screen' from
the 'File' menu. The default file name is $HOME/mterm.scrn.
-sl lines Set the number of lines to be saved in the screen's history
buffer. The default value is 125 lines.
-ss Set scroll mode to smooth. This forces the screen to be
updated for every line/column that is scrolled. This slows
down scrolling and provides a smoother looking scroll.
+ss Turn smooth scrolling off. This allows the screen to be
updated in bursts which speeds up scrolling (default).
-stopBits bits
Determine the number of stop bits to use. Valid options are
7 or 8.
-strip Strip the high bit
+strip Don't Strip the high bit
-tty line Use line as async line instead of TTY.
-uk keymap
Use keymap to redefine the keyboard. keymap is a resource
set by the user in standard translation table format. More
information on translations can be found in Chapter 7 of
the X Toolkit Intrinsics Programming Manual for X Version
11.
-ut Make an entry in utmp for the Mterm session. This option
is only available without the -async option. This is the
default.
+ut Don't make a utmp entry for the Mterm session.
-vb Set the bell to be visible (flash).
+vb Turn the visual characteristic of the bell off. This is
the default.
-vt52 Provide D216/VT52 emulation in the text window.
-vt100 Provide D216/VT100 emulation in the text window. This is
the default.
-vt100mid code
Set the value of the model id code returned when in Vt100
mode. Do not include the first character of the model id
code, as it is supplied by Mterm (<033>). Changing the
model id can cause undesirable results.
-7bit Set the word length to 7 bits. The compose menu and the
compose key do not function in 7 bit mode. Only
international characters on your keyboard can be generated.
-8bit Set the word length to 8 bits - this is the default. In 8
bit mode the compose menu and the compose key are
available. All international characters can be generated.
OPTION EXAMPLES
Several examples of mterm usage are given below.
mterm -version
Print out version information:
Executable path: /usr/bin/X11/mterm
Date built: Tue April 16, 1991 at 12:00 PM
Executable version: 1.10_01
Resource file version: 1.10_01
Help file version: 1.10_01
mterm -sl 300 -fs 18
Start an Mterm in VT100 mode with 300 lines of history and
font size 18. This is useful for a local shell session, for
example.
mterm -async -tty /dev/tty21 -d216 -baud 9600 -fs 14
Connect to a remote host via the async tty line /dev/tty21 and
use 9600 baud. The font size will be 14. This example is
appropriate for using Mterm to connect to an AOS/VS (tm) host
over an async connection.
mterm -name bigmachine -fs 10
Use X resources with prefix "bigmachine" for Mterm settings,
but force the font size to 10. This could be a setup for
connections to a remote machine called "bigmachine." (See
X(1) for more information on X resources and the -name
option.)
OVERVIEW OF X RESOURCES
X resources allow the user to customize all or some of the instances
of Mterm. In the following templates, rname is the name of a
resource (eg. foreground) and rvalue is its value (eg. white), and
iname is an instance name for Mterm.
Mterm*rname : rvalue
Resource entry applying to all instances of Mterm. These
are called class resources because they start with "Mterm,"
the class name of Mterm.
iname*rname : rvalue
Resource entry applying to instances of Mterm started with
mterm -name iname.
X(1) and Xdefaults(5) for a complete discussion of resources.
Several X resources are shared by all X Toolkit-based applications,
including the following: Mterm*geometry, Mterm*foreground, and
Mterm*background. (For a description of these and other standard X
Toolkit resources see X(1).)
MTERM RESOURCES
Note that each resource is more fully discussed under the
corresponding command-line option.
Mterm.allowHScroll: boolean
If boolean is true, Mterm will scroll the window
horizontally to keep the cursor displayed. The default
value is true. (See -ah option.)
Mterm.asyncTty: /dev/tty??
Use the indicated tty for async connection. (See -tty
option.)
Mterm.audibleBell:flag
If flag is true, make the bell signal audible. Defaults to
true. (See the -ab and +ab options.)
Mterm.baud: baud
(See -baud option.)
Mterm.backspace: value
Set the backspace to value. (See -backspace option.)
Mterm.bellCount: count
(See -bc option.)
Mterm.blinkFont: font
Use the given blink font for Mterm. (See -blinkFont
option.)
Mterm.boldFont: font
Use the given bold font for Mterm. (See -bf option.)
Mterm.boldBlinkFont: font
Use the given blink bold font for Mterm. (See -bbf
option.)
Mterm.bs: bs
Set value for the <BACKSPACE> key. (See -bs option)
Mterm.childProcess:process
Set command line for local process. The default is
/bin/csh. (See the -e option.)
Mterm.colorSet: colorSet
Define which color set to use. (See the -color option.)
Mterm.columns:columns
Use the given number of columns in vt100 and vt52 mode.
(See -columns option.)
Mterm.console: boolean
If boolean is true, Mterm redirects console output to the
Mterm window. The default value is false. (See the -C
option.)
Mterm.cursorPos: boolean
If boolean is true, Mterm will display the cursor
row/column as part of the window title. The default is
false.
Mterm.debug: boolean
If boolean is true, debugging information is output. This
option is intended for development purposes ONLY. Defaults
to false. (See the -debug and +debug options.)
Mterm.xrDebug: boolean
If boolean is true, resource file debugging information is
output. This option is intended for development purposes
ONLY. Defaults to false. (See the -xrDebug and +xrDebug
options.)
Mterm.dimFont: font
Use the given dim font for Mterm. (See -df option.)
Mterm.d216ModelId: modelid
(See the -d216mid option.)
Mterm.d410ModelId: modelid
(See the -d410mid option.)
Mterm.emulationMode:mode
Select vt100, d216, d410 or vt52 as the emulation mode for
Mterm. Mterm.emulationMode:vt100 is equivalent to the
-vt100 option, Mterm.emulationMode:d216 is equivalent to
the -d216 option, Mterm.emulationMode:d410 is equivalent to
the -d410 option and Mterm.emulationMode:vt52 is equivalent
to the -vt52 option.
Mterm.flowControl: cts
Defines the type of flow control to be used. (See
-flowControl option)
Mterm.fontCharset: charset
(See the -fc option.)
Mterm.fontDpi: dpi
(See the -fd option.)
Mterm.fontFamily: family
(See the -ff option.)
Mterm.fontMaker: maker
(See the -fm option.)
Mterm.fontSize: size
(See the -fs option.)
Mterm.fontWidth: width
(See the -fw option.)
Mterm.iconName: name
(See -in option.)
Mterm.ignoreCompress: boolean
(See the -ic and +ic options.)
Mterm.logFile: file
(See the -lf option.)
Mterm.logging: boolean
If boolean is true, the Mterm session is recorded in the
logfile. Defaults to false. (See -logging and +logging
options.)
Mterm.loginShell: boolean
If boolean is true, the shell started in the Mterm window
will read the user's .login or .profile at startup.
Defaults to false. (See -ls and +ls options.)
Mterm.macroPath: path
Define location of the mterm macro directory. (See -mp
option)
Mterm*mouseCursor: name
Use the specified cursor inside the Mterm text area. Valid
entries include: any of the standard cursor shapes listed
in the X11/cursorfont.h file (minus the XC_ prefix), a
bitmap file name, or a font name and glyph index. Defaults
to center_ptr.
Mterm.nl: cr
Set value for the <Enter> key. (See -nl option)
Mterm.popupMenu: boolean
(See -pm and +pm options.)
Mterm.printCommand:lp -c %$1s
(See -pc option.)
Mterm.removeLock: boolean
(See -rl option.)
Mterm.rows: rows
Use the given number of rows for maximum height in vt100
and vt52 mode. (See -rows option.)
Mterm.saveCleared: boolean
If boolean is true, any cleared screens are saved.
Defaults to false. (See -sc and +sc options.)
Mterm.saveFile: file
(See the -sf option.)
Mterm.saveLines: lines
(See -sl option.)
Mterm*scrollBarPlacement: position
Scroll bar placement can be BOTTOM_RIGHT (default),
BOTTOM_LEFT, TOP_RIGHT, or TOP_LEFT.
Mterm.scrollDelay: delay
(See -sd option.)
Mterm.smoothScroll: boolean
If boolean is true, smooth scrolling will be used. If
boolean is false, jump scrolling will be used. Defaults to
false. (See -ss and +ss options.)
Mterm.strip: false
Strips the high bit, making all characters 7 bit ASCII
characters (See -strip option)
Mterm.userKeymap: keymap
Use keymap to redefine the keyboard. keymap is a resource
set by the user in standard translation table format. More
information on translations can be found in Chapter 7 of
the X Toolkit Intrinsics Programming Manual for X Version
11. (See the -uk option.)
Mterm.utmpInhibit: boolean
If boolean is false, Mterm makes a utmp entry for the
session; if boolean is true, the entry is not made. The
default value is true. (See the -ut and +ut options.)
Mterm.visualBell:flag
If flag is true, make the bell signal visually. Defaults
to false. (See the -vb and +vb options.)
Mterm.vt100ModelId: modelid
(See the -vt100mid option.)
Mterm.wordLength: bits
Set the word length to 7 bits or 8 bits. Defaults to 8
bits. (See -7bit and -8bit options.)
RESOURCE EXAMPLES
Example 1: class resources
Mterm.fontSize: 18
Mterm*background: black
Mterm*foreground: white
Mterm.saveLines: 300
Mterm.geometry: +0-0
Description:
The default settings for all instances of Mterm will be
font size 18, reverse video, save 300 lines of history, and
start with location in the lower left of the screen.
Example 2: resources for local (child) session
small.fontSize: 10
small.geometry: +0+0
Description:
With the entries of Examples 1 and 2 in effect, any
instance of Mterm started with "mterm -name small" will use
font size 10, reverse video, save 300 lines of history and
start in the upper left of the screen.
Example 3: resources for async connection
asyncTerm.fontSize: 12
asyncTerm.baudRate: 9600
asyncTerm.childType: async
asyncTerm.ttyLine: /dev/tty21
asyncTerm.emulationMode: d216
Description:
With the entries of Examples 1, 2, and 3 in effect, any
instance of Mterm started with "mterm -name asyncTerm" will
be just like that of example 1, except that it will use
font size 12, a baud rate of 9600, an async connection on
/dev/tty21, and DG emulation. This is suitable for an
async connection to an AOS/VS host(tm).
MTERM KEYBOARD MAPPINGS
Mterm remaps the Aviion keyboard to duplicate as closely as possible
the terminal being emulated. In addition, you can redefine keys to
match your own individual needs by using the userKeymap resource or
the -uk command line option. You can also capture keystrokes by
pressing <CTRL><INS>. Type <CTRL><INS> again to terminate keystroke
capture. Up to 128 keystrokes will be recorded. You can play back the
recorded keystrokes by pressing <ALT><INS>. The bell will beep once
when starting capture, and twice when terminating capture.
<SHFT><ALT><INS> will paste the current cut buffer contents.
<SHFT><CTRL><INS> will paste the current cut buffer contents with
control characters stripped. This can be accomplished with the mouse
by pressing <CTRL> B2.
D216/D410 mode:
C1 Insert
C2 PgUp
C3 Delete
C4 PgDn
Home Home or <CTRL>H
Erase EOL End or <CTRL>K
Erase Page <ALT>End or <CTRL>L
SPCL Pause
CR <CTRL><ENTER>
(Shifted versions of C1-C4 are also supported)
Function keys 11 thru 15 are available as ALT-F1 thru ALT-F5. All
shift and control combinations are supported. However, some mwm
keyboard accelerator settings can effect the action of the functions.
See the Warnings section below for details.
VT100/VT52 mode:
PF1 Alt-Home
PF2 Alt-PgUp
PF3 Alt-End
PF4 Alt-PgDn
F1 thru F12 carry the xterm function keys F1 thru F12.
In VT100 mode, all keys not needed for VT100/xterm emulation will
return their D216 value. Thus <SHIFT><F1> will return the same
character sequence in VT100 mode as it does in D216 mode because the
VT100 and xterm have no value for <SHIFT><F1>.
To generate a break condition, press <ALT><B> or <ALT><b>. The
default break duration is set to 0, which uses the system defaults.
The break duration can be set by the -bd command line option and the
breakDuration resource. The argument represents tenths of a second.
More information about keyboard mapping can be found in
/usr/lib/X11/app-defaults/Mterm.
ENVIRONMENT VARIABLES
HOME Used by the logging facility to determine where to put the
log file if the default logfile pathname is used
($HOME/mterm.log). Also used to locate the colorset file
.mtermrc.
KBD_LANG Allows user to define the keyboard nationality. Only needed
if Mterm is run on a host other than the users workstation.
The following are valid entries: KBD (Keyboard), US, UK,
FRENCH, GERMAN, SWEDISH, SPANISH, DANISH
SWISS,FINNISH,FRENCH_CANADIAN, ITALIAN. If KBD_LANG has no
value, does not exist, or is set to KBD, the keyboard
language will be used if possible.
LANG Used by Mterm to determine which xhelp directory to use for
help files. Currently only the 'C' (US) directory is
supplied. If LANG is set to a language that Mterm help
files are not available for, Mterm will use the 'C' (US)
directory.
SHELL User's selection of command shell such as sh(1) and csh(1).
This option can be overwritten by the Mterm*childProcess
resource or the -e command-line option.
XHELPPATH Allows user to define which xhelp directory to get help and
text from. Only needed if you don't want the installed
help files. If XHELPPATH is not set, the help files and
text will come from /usr/opt/X11/xhelp/C/Mterm/helpfile.
Mterm requires the helpfile as it contains all help and
ASCII text used by Mterm.
FILES
/usr/lib/X11/app-defaults/Mterm
default resource file for Mterm.
$HOME/mterm.log
default log file for Mterm.
$HOME/.mtermrc
contains color sets used to map display attributes to
colors. Up to 20 different color sets can be defined using
the mterm color editor. The editor is located on the
options menu. No default color sets are provided. You must
use the mterm Color Set Editor to define some color sets
before using this option.
/usr/spool/uucp/LK.000.<major>.<minor>
async tty lock file. This file contains the PID of the
mterm process that has locked this tty.
/usr/lib/xhelp/C/Mterm
this directory contains links to the help files
/usr/opt/X11/xhelp/C/Mterm/helpfile
Help, error, warning, and prompt text. You cannot modify
this ascii text file without rebuilding the helpfile.inx
and helpfile.toc files.
/usr/opt/X11/xhelp/C/Mterm/helpfile.inx
Index file for the helpfile.
/usr/opt/X11/xhelp/C/Mterm/helpfile.toc
Table of Contents file for the helpfile.
/usr/opt/X11/lib/fonts/misc/mterm*.snf
Fonts used by Mterm as suppliments to the 8859 character
set.
DIAGNOSTICS
Mterm will provide an error code and exit when a fatal error is
encountered. Here is a list of the error codes and their meanings:
5 Not enough memory.
6 The tty port selected is already locked by another user.
There is a lockfile in /usr/spool/locks indicating that the
requested async line is already in use. Only one user can use
the line at a time. If you doubt that the line is in use,
consult your system administrator. Normal termination of mterm
will remove any lockfiles it creates. Using the -rl option
will prevent this error message from occurring if the user
owns the lockfile.
7 The environment variable KBD_LANG has an invalid value.
8 Mterm is unable to read the keyboard language. Use KBD_LANG.
9 The mterm resource file (/usr/lib/X11/app-defaults/Mterm) is
of an incorrect rev. mterm -ver will give more information.
10 The tty port can't be opened. Check access control.
11 The lock file used during async connections can't be created.
12 The pty file can't be opened.
13 The process specified with -e can't be executed.
14 Mterm was unable to set line characteristics on the tty or pty
connection.
15 Mterm can't start the user's shell program (sh/csh/bash/etc.)
16 Mterm can't get display information from X.
17 Mterm can't get application context information from X.
18 The mterm text (help) files are not installed.
19 The resource emulationMode has an invalid value.
20 A character set needed by mterm was not found in the resource
file.
21 Mterm could not find a font it was told to use. This occurs
when a bad font size is given with the -fs option or the
*fontSize resource.
22 Mterm could not find a resource it needed.
24 An I/O error occurred with X.
COPYRIGHT
Copyright (C) Data General Corporation, 1990-1996. All Rights
Reserved. Licensed Material-Property of Data General Corporation.
This software is made available solely pursuant to the terms of a DGC
license agreement which governs its use.
WARNINGS
Mterm is rev locked to the DG/UX operating system. Should you
encounter problems, first make sure that the rev of Mterm matches the
rev of the operating system.
D410 mode:
The D410 has a screen size of 81 x 24. If you size the mterm
window smaller than 81 x 24, you will get unwanted horizontal
scrolling.
Async connections:
If you exit or kill an Mterm that is using an async connection
without first exiting the application you were running, the
application will remain active on the async line. This can
cause problems with screen display. The application may have
already sent control codes to the terminal to get it
configured correctly. When a new terminal session establishes
a connection with an application that is already running, the
terminal may not be correctly configured for the application.
Some applications (such as CEO) support a refresh key
(<CTRL><L> in CEO). Pressing this key lets the application
know to reconfigure the terminal.
When using mterm in async mode, make sure that no other
process is using the same async port. In particular make sure
that ttymon is not monitoring the same port that you are
trying to use mterm on. The two process will try and steal
characters from one another, causing unpredictable results.
^Z and ^Y in VT100 mode:
When in Vt100 mode, the susp and dsusp characters (^Z and ^Y)
can cause a 'hang' if the -e option was used and the argument
was not a shell. The process can not be restarted by using the
'fg' command, since a shell was not functioning when the
suspend was requested.
Mode menu item:
The options|mode menu item will give undesirable results if
you select it and switch to vt100 or vt52 mode after you have
started a child other than a shell. In particular doing a
change mode to vt100 or vt52 mode after a telnet, vi, or
rlogin session has been started will give undesirable results.
Mterm must change the line characteristics when switching from
one mode to another. If a child process has been started that
resets the characteristics, incompatabilites occur. It is
generally safe to switch to a DG mode at any time. It is
generally safe to switch to VT mode if you have not started a
child process other than your shell. It is recommended that
you put mterm in the mode of the target system before you
start any child process necessary to connect you to the remote
system.
Changing emulation mode from the mterm menu system will not
reset the TERM environment variable to the new terminal type.
You may need to use the reset command to set the tty
characteristics to a usable state. Consult the reset(1) and
stty(1) man pages.
Keyboard accelerators on function keys:
Keyboard accelerators for mwm can interfere with keyboard
mappings in Mterm. The key sequences for Alt-F1, Alt-F2, Alt-
F3, Alt-F4 and Alt-F5 under DG emulation should produce F11,
F12, F13, F14 and F15 key values, but the default settings for
mwm take over some of these key combinations. We recommend
setting your mwm accelerators differently as follows:
Create/modify the file $HOME/.mwmrc to contain alternate menu
settings. Here is one possible example:
# (sample portion of $HOME/.mwmrc file)
#
# Mterm Window Menu Description
Menu MtermWindowMenu
{
"Restore" _R Alt<Key>R f.normalize
"Size" _S Alt<Key>S f.resize
"Iconify" _I Alt<Key>I f.minimize
"Fullsize" _F Alt<Key>F f.maximize
"Lower" _L Alt<Key>L f.lower
no-label f.separator
"Close" _C Alt<Key>C f.kill
}
Also create/modify your personal resource file to include the
following lines:
# (sample portion of user's resource file)
#
Mwm*Mterm*windowMenu: MtermWindowMenu
To use this menu in all of your windows use the following line:
# (sample portion of user's resource file)
#
Mwm*windowMenu: MtermWindowMenu
Changes to a user's resource file relating to mwm take effect
after (1) you do xrdb -load resourcefile and (2) quit and
restart mwm. Changes to the $HOME/.mwmrc file only require
that you restart mwm. See mwm(1) for more details on setting
your mwm accelerators. See X(1) and xrdb(1) for information
on setting resources.
Accessing AOS, RDOS, AOS/VS and AOS/VS II hosts:
Any time you are accessing AOS, RDOS, AOS/VS, or AOS/VS II
systems you should use the -d216 or -d410 mterm option. This
allows mterm to emulate
a Data General D216 terminal. AOS, AOS/VS, and AOS/VS II rev
1.xx systems should have NAS turned off. The command to do
this is CHAR/OFF/NAS. AOS/VS II rev 2.xx should have NAS and
XLT turned off. The command to do this is CHAR/OFF/NAS/XLT.
You should not be using the dgxterm keymap file provided with
DG/UX.
Telnet to AOS/VS hosts:
Connecting to AOS/VS using telnet will allow only limited
functionality. The AOS/VS telnet program does not support
control codes. The support for full-screen telnet is a feature
of AOS/VS II rev 2.xx. AOS/VS does not support full-screen
telnet. Only AOS/VS II rev 2.00 or greater will allow Mterm
telnet users to access an mv and get full screen support. Full
screen support is needed to run most applications, including
CEO(tm). If you need full D216 functionality to an AOS or
AOS/VS system you must use an async connection or a terminal
server connection. Note: Any AOS/VS II machine must have
TCP/IP II loaded for mterm to run correctly.
24 bit color systems:
For the color editor to be available on 24 bit systems you
must start X11 with the -cc 3 command line option. The X11
command line can be found in the /var/X11/xdm/Xservers file.
Using font command-line options and resources:
We do not recommend using any of the template options (-fc -fd
-ff -fm -fs -fw), or the corresponding resources, except to
set the font size. Most users will want to use the default
fonts or font name options instead (e.g. -df). The template
options/resources CANNOT be used with font name
options/resources; use them only with the default fonts. All
fonts specified must be the same size to get predictable
behavior from the emulator. Also, any fonts different from
point sizes 8, 10 , 12, 14, 18 or 24 will not work correctly
in a D410. Operating Mterm without the full font set could
cause some characters to be incorrectly displayed. At a
minimum, the following fonts must be available for Mterm to
execute:
-adobe-courier-medium-r-normal--14-140-75-75-m-90-iso8859-1
fixed
BUGS
Reverse video
The Standard Xt option for reverse video, -rv, does not
work. To get reverse video, use the -bg and -fg command
line switches or the Mterm*background and Mterm*forground
resources in your resource file. Selecting the toggle
video option in the View menu will also reverse the current
background and foreground colors.
SEE ALSO
X(1), csh(1), mwm(1), rlogin(1), sh(1), telnet(1), xrdb(1), xterm(1).
Licensed material--property of copyright holder(s)