Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

X(1)

csh(1)

mwm(1)

rlogin(1)

sh(1)

telnet(1)

xrdb(1)

xterm(1)



mterm(1)                                                 mterm(1)


NAME
       mterm  - terminal emulator for X with VT100, DG D216, D410
       and VT52 modes

SYNOPSIS
       mterm [-toolkitoption ..] [-option ..]

DESCRIPTION
       Mterm 5.4.2  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 win-
       dow. Mterm also includes a search facility to allow you to
       search the current screen and history for text.

       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 tel-
                 net, 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 informa-
       tion 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.



DG/UX                          X11                              1




mterm(1)                                                 mterm(1)


       -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 hori-
                 zontal 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  in  /usr/spool/uucp  as
                 LCK..ttyxx.  (See FILES.)

       +async    Start Mterm with a connection to the local child
                 process.  This is the default.

       -backspace key_value
                 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.

       -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  speci-
                 fied,  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).

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

       -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



DG/UX                          X11                              2




mterm(1)                                                 mterm(1)


                 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  sys-
                 tems  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 win-
                 dow size.

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

       -d216     Provide DG D216 emulation. The window and screen
                 are set to 24 rows and 80 columns.  This is use-
                 ful  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 hor-
                 izontal scroll bar.  This is useful for  connec-
                 tion 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 char-
                 acter 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



DG/UX                          X11                              3




mterm(1)                                                 mterm(1)


                 in DG D410 mode.  Do not include the first char-
                 acter of the model id code, as it is supplied by
                 Mterm (<036>).  Changing the model id can  cause
                 undesirable results.

       -e command_line
                 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, usu-
                 ally  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.   WARN-
                 ING:  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).

       -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 infor-
                 mation).

       -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: 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  informa-
                 tion).

       -fw width Use  the  given font width in the font name tem-
                 plate. This width is the  unweighted  arithmetic
                 mean  width of all glyphs in the font.  WARNING:
                 Use this option only with the default fonts;  it



DG/UX                          X11                              4




mterm(1)                                                 mterm(1)


                 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.

       -blinkFont font
                 Define the blink font. If no blink font is spec-
                 ified, 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).

       -in name  Set the icon name to name.

       -lf file  Use file for logging the Mterm session when log-
                 ging is turned on.  Logging  can  be  controlled
                 using the "Logging" dialog box.  Logfile size is
                 limited to available disk space. Two Mterms can-
                 not  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.

       -df font  Define the dim font. If no dim  font  is  speci-
                 fied, 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).

       -pm       Use a popup menu to display the menus.

       +pm       Use a menu bar to display the menus. This is the
                 default.




DG/UX                          X11                              5




mterm(1)                                                 mterm(1)


       -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  pro-
                 vides a smoother looking scroll.

       +ss       Turn  smooth  scrolling  off.  This  allows  the
                 screen to be updated in bursts which  speeds  up
                 scrolling (default).

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




DG/UX                          X11                              6




mterm(1)                                                 mterm(1)


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

       -vt100    Provide D216/VT100 emulation in the text window.
                 This is the default.

       -vt52     Provide D216/VT52 emulation in the text  window.

       -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 key-
                 board 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 his-
              tory 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.)



DG/UX                          X11                              7




mterm(1)                                                 mterm(1)


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  descrip-
       tion  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.

       When  in  d410 mode, Mterm will not normally scroll the
                 window in the
                 horizontal  direction  to  keep  the cursor dis-
                 played. To enable horizontal scrolling, use  the
                 -ah switch. Mterm will then scroll the window to
                 keep the cursor displayed.

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




DG/UX                          X11                              8




mterm(1)                                                 mterm(1)


       Mterm*backspace: value
                 Set  the  backspace  to  value.  (See -backspace
                 oprion.)

       Mterm*bellCount: count
                 (See -bc 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*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 out-
                 put to the Mterm window.  The default  value  is
                 false.  (See the -C option.)

       Mterm*d216ModelId: model_id
                 (See the -d216mid option.)

       Mterm*d410ModelId: model_id
                 (See the -d410mid option.)

       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*emulationMode:mode
                 Select vt100, d216, d410 or vt52 as  the  emula-
                 tion  mode for Mterm.  Mterm*emulationMode:vt100
                 is   equivalent   to    the    -vt100    option,



DG/UX                          X11                              9




mterm(1)                                                 mterm(1)


                 Mterm*emulationMode:d216  is  equivalent  to the
                 -d216 option, Mterm*emulationMode:d410 is equiv-
                 alent     to     the     -d410     option    and
                 Mterm*emulationMode:vt52 is  equivalent  to  the
                 -vt52 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*blinkFont: font
                 Use  the  given  blink  font  for  Mterm.   (See
                 -blinkFont option.)

       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*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



DG/UX                          X11                             10




mterm(1)                                                 mterm(1)


                 center_ptr.

       Mterm*dimFont: font
                 Use the given dim  font  for  Mterm.   (See  -df
                 option.)

       Mterm*popupMenu: boolean
                 (See -pm and +pm options.)

       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*userKeymap: keymap
                 Use  keymap to redefine the keyboard. keymap  is
                 a resource set by the user in standard  transla-
                 tion  table format. More information on transla-
                 tions 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.)




DG/UX                          X11                             11




mterm(1)                                                 mterm(1)


       Mterm*visualBell:flag
                 If  flag is true, make the bell signal visually.
                 Defaults  to  false.   (See  the  -vb  and   +vb
                 options.)

       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



DG/UX                          X11                             12




mterm(1)                                                 mterm(1)


       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.

       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-Insert
              PF2      Alt-PgUp
              PF3      Alt-Delete
              PF4      Alt-PgDn

       F1 thru F12 carry the xterm function keys F1 thru F12.

       In VT100 mode, all keys not needed for VT100/xterm  emula-
       tion  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 .5 seconds. The break
       duration can be changed by modifying the argument  in  the
       Cb_BreakAP() command found in the Mterm resource file. The
       argument represents tenths of a second.

       More information about keyboard mapping can  be  found  in
       /usr/lib/X11/app-defaults/Mterm.





DG/UX                          X11                             13




mterm(1)                                                 mterm(1)


ENVIRONMENT VARIABLES
       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 com-
                 mand-line option.

       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.

       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  XHELP-
                 PATH  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.

       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.

       HOME      Used by the logging facility to determine  where
                 to put the log file if the default logfile path-
                 name is used  ($HOME/mterm.log).  Also  used  to
                 locate the colorset file .mtermrc.

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 edi-
                 tor. 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/LCK..ttyNN
                 async tty lock file for /dev/ttyNN




DG/UX                          X11                             14




mterm(1)                                                 mterm(1)


       /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 can-
                 not modify this ascii text file without rebuild-
                 ing 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        lock-
              file,/usr/spool/uucp/LCK..ttyNN, indicating that an
              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. Nor-
              mal 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.



DG/UX                          X11                             15




mterm(1)                                                 mterm(1)


       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 occured with X.



COPYRIGHT
       Copyright  (C)  Data  General Corporation, 1990-1992.  All
       Rights Reserved.  Licensed Material-Property of Data  Gen-
       eral  Corporation.  This software is made available solely
       pursuant to the terms of a  DGC  license  agreement  which
       governs its use.





















DG/UX                          X11                             16




mterm(1)                                                 mterm(1)


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 ses-
              sion 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.

       ^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 susspend
              was requested.

       Change mode:
              Changing emulation mode from the mterm menu  system
              will not reset the TERM environment variable to the
              new terminal type.

       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  fol-
              lows:

              Create/modify  the  file  $HOME/.mwmrc  to  contain
              alternate menu settings. Here is one possible exam-
              ple:
                   # (sample portion of $HOME/.mwmrc file)

                   # Mterm Window Menu Description



DG/UX                          X11                             17




mterm(1)                                                 mterm(1)


                   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
              resource_file  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 informtation 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



DG/UX                          X11                             18




mterm(1)                                                 mterm(1)


              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 sys-
              tems 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  corre-
              sponding  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).












DG/UX                          X11                             19


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026