DataMuseum.dk

Presents historical artifacts from the history of:

DKUUG/EUUG Conference tapes

This is an automatic "excavation" of a thematic subset of
artifacts from Datamuseum.dk's BitArchive.

See our Wiki for more about DKUUG/EUUG Conference tapes

Excavated with: AutoArchaeologist - Free & Open Source Software.


top - metrics - download
Index: T r

⟦d95432b9c⟧ TextFile

    Length: 83221 (0x14515)
    Types: TextFile
    Names: »realwork.tty«

Derivation

└─⟦9ae75bfbd⟧ Bits:30007242 EUUGD3: Starter Kit
    └─⟦1c9ac1d5e⟧ »EurOpenD3/mail/mh/papers-tty.tar.Z« 
        └─⟦ecde7fae8⟧ 
            └─⟦this⟧ »realwork.tty« 

TextFile





                                                   MH.5:

                          How  to  process  200  messages  a  day

                           and  still  get  some  real  work  done./


                                            Marshall T. Rose

                                Member, Research Technical Staff

                          Northrop Research and Technology Centery



                                             John L. Romine

                                     Computing Support Group

                     Department of Information and Computer Science

                                   University of California, Irvinez



                                                Abstract


        The  UCI  version  of  the  Rand  Message  Handling  System  (MH)  is  dis-

        cussed.  MH is a powerful user agent which operates in the ARPA Internet

        and UUCP environments.  In addition to the usual functions provided

        by similar programs, MH has several distinguishing characteristics which

        give the user additional message handling capability.  In particular, MH

        provides  mechanisms  for  maintaining  an  organized  mail  environment,

        tailoring its behavior, and extending its functions.


        This document describes MH from several perspectives.  Particular em-

        phasis is given to:  the MH user environment, advanced features of MH

        which  have  proven  to  be  particularly  useful  for  sophisticated  users  of

        electronic mail, the user interface issues in MH, and the mh.5 distribu-

        tion.  The paper concludes with a summary of the authors' experiences

        with MH, and a discussion of future areas of enhancement.



_____________________________________
./ Alternate title: MH: Your Key to Success.
y One Research Park, Palos Verdes Peninsula, CA 90274. Telephone: 213/377-4811.

Computer mail: MRose% NRTC@USC-ECL, : : :!fucbvax!ucivax,trwrbg!nrtc!mrose.
z University of California at Irvine, Irvine, CA 92717. Telephone: 714/856-6852.

Computer mail: J-Romine@USC-ECL, : : :!fucbvax,trwrbg!ucivax!jromine.
\f



                                                   MH.5:

                          How  to  process  200  messages  a  day

                             and  still  get  some  real  work  done



Introduction

        The UCI version of the Rand Message Handling System, MH, is a software

system  that  performs  two  functions:  first_,  it  interfaces  a  user  to  a  message

transport system, so the user may receive and send mail; second___, it permits the

user to maintain an organized mail environment to facilitate the composition of

new messages and the reading of old messages.  In short, while not responsible for

the delivery of messages, MH aids the user in handling mail.


        MH  was  originally  developed  by  the  Rand  Corporation,  and  initially  was

proprietary  software.   The  Department  of  Information  and  Computer  Science

at  University  of  California,  Irvine,  shortly  after  joining  the  Computer  Science

Network (CSnet), acquired a copy of MH, and began additional development of

the software.  Since that time, the Rand Corporation has declared MH to be in the

public domain, and the UCI version of MH has passed through four major releases.

The current version, mh.5, is available from U.C. Irvine for a nominal distribution

fee, or may be retrieved from the University of Delaware via anonymous FTP.


        Much credit must be given to the initial designers and implementors of MH:

Bruce Borden, Stockton Gaines, and Norman Shapiro.  Although MH has suffered

significant  development  at  UCI  since  Rand's  initial  release,  the  fundamental

concepts  of  MH's  environs  have  remained  nearly  unchanged.   In  addition,  the

authors of the current release gratefully acknowledge the comments of the many

sites which have run various releases of MH in the past.  In particular, the dozen

or so beta test sites for mh.5 provided tremendous help in stabilizing the current

release.


        MH  runs  on  different  versions  of  the  UNIX1  operating  system  (such  as

Berkeley  4.2bsd  and  various  flavors  of  v7).   In  addition,  MH  supports  four

different  message  transport  interfaces:  SendMail[EAllm83],  the  standard  mailer

for 4.2bsd systems; MMDF[DCroc79] and MMDF-II[DKing84], the Multi-Channel

Memo Distribution Facility developed by the University of Delaware which forms

the software-backbone for CSnet[DCome83] mail relay service; SMTP, the ARPA

Internet Simple Mail Transfer Protocol[SMTP]; and, a stand-alone delivery system.



_____________________________________
1  UNIX is a trademark of AT&T Bell Laboratories.



                                                       1
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              2


        This  paper  is  organized  in  a  straight-forward  fashion:  Initially,  the  MH

philosophy  of  mail  handling  is  presented,  along  with  a  description  of  the

environment which the MH user is given to process mail.  Following this, certain

advanced features of MH are discussed in more detail, such as facilities for selecting

messages, and "advanced" concepts in draft handling.  In addition, user interface

issues in mail handling are addressed, and the merits of MH's approach is critically

examined.  Next, the mh.5 distribution package is described.  Finally, we conclude

by discussing the authors' experience with MH development and introducing areas

where MH may be further developed.


        Although  familiarity  with  MH  is  not  assumed  on  the  part  of  the  reader,

some knowledge of the UNIX operating system is useful.  Appendix A gives a short

synopsis of the MH commands.



The MH Philosophy

        Although MH has many traits which tend to distinguish it from other systems

which handle mail, there is a single fundamental design decision which influences

the interface between MH and the user:  MH differs from most other systems in

that it is composed of many small programs instead of one very large one.  This

architecture gives MH much of its strength, since intermediate and advanced users

are able to take advantage of this flexibility.


        The key to this flexibility is that the UNIX shell (usually the C shell or the

Bourne shell), is the user's interface to MH. This means that when handling mail,

the entire power of the shell is at the user's disposal, in addition to the facilities

which MH provides.  Hence,  the user may intersperse mail handling commands

with other commands in an arbitrary fashion, making use of command handling

capabilities which the user's shell provides.


        Furthermore, rather than storing messages in a complicated data structure

within a monolithic file, each message in MH is a UNIX file, and each folder (an

object  which  holds  groups  of  messages)  in  MH  is  a  UNIX  directory.   That  is,

the directory- and file-structure of UNIX is used directly.  As a result, any UNIX

file-handling command can be applied to any message.


        To the novice, this may not make much sense or may not seem important.

However,  as  users  of  MH  become  more  experienced,  they  find  this  capability

attractive.  In addition, this approach is often quite pleasing to system implemen-

tors,  because  it  minimizes  the  amount  of  coding  to  be  performed,  and  given  a

modular design, changes to the software system can be maintained easily.  There

are,  however,  performance penalties to be paid with this scheme.  This issue is

considered later in the paper.


        Having described how MH fits into the UNIX environment, we now discuss

the mail handling environment which is available to the MH user.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              3


The MH Environs

        In the $ HOME       directory of each MH user, a file named .mh_profile     contains

static information about the user's MH environment, and default arguments for

MH programs.  For the latter case, each line of profile takes the form:


           program-name: options


Each MH program consults the user's .mh_profile     for its options.  These options

are consulted prior to evaluating any command-line arguments, and so provide the

MH user the capability to customize the defaults for each command.  Futher, by

using the UNIX link facility, different names can be given to the same command.

Since each MH command looks in the .mh_profile     for a component with the name

by  which  it  was  invoked,  it's  possible  to  have  different  defaults  for  the  same

program.  For example, it is not uncommon to link prompter (a simple prompting

editor front-end) under the name rapid in the user's bin/   directory, and add to the

.mh_profile    :


           rapid: -prepend -rapid


As a result, when prompter is invoked as rapid, it automatically uses the `-prepend'

and `-rapid'      options.


        The profile component ``Path:''       is the path to the user's MH-directory,

usually Mail.  In addition to containing the user's folders, the MH-directory also

contains skeletons and templates used by the MH programs, and the user's context

file.  This latter file has the same format as the user's .mh_profile    , and contains the

dynamic, context-dependent information about the user's environment.  Whenever

MH looks for an MH-specific file, such as a template or skeleton, it first consults

the user's MH-directory, and then a system-wide library area.


        The MH user always has a current folder, which is the folder in which the user

is currently (or was last) working.  Since any MH program which deals with folders

implicitly manipulates this information, the name of the current folder is stored in

the context    component ``Current-Folder:''            .  Every folder has a current message

known as `cur'   .  These values are the defaults for MH commands which accept

folder and/or messages arguments.


        MH programs make use of a set of envariables which further customize their

behavior.  The $ MH    envariable, if present, specifies the name of an alternate profile

for the user.  This allows a user of MH to easily maintain multiple mail-handling

environments.


        In terms of command syntax, most MH commands accept an optional folder

argument, such as `+outbox'      .  Unlike most UNIX commands, all MH commands

have  switches  which  are  words,  rather  than  single  letters.   Switches  may  be

abbreviated  to  the  least  unambiguous  prefix.  All  MH  commands  also  support
\f

   Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              4
 _______________________________________________________________________________________________________________

  1   %  inc
  2   Incorporating  new  mail  into  inbox...
  3
  4       1+  03/16  Rand  MH  System      MH  transcript   <<Here's  the  body  of  a  sample  m
  5
  6   %  show
  7   (Message  inbox:1)
  8   To:  jromine@uci-icsa
  9   Subject:  MH  transcript
10    Date:  16  Mar  85  18:28:59  PST  (Sat)
11    From:  Rand  MH  System  <mh@uci-icsa>
12
13    Here's  the  body  of  a  sample  message.
14    %  repl
15    To:  Rand  MH  System  <mh@uci-icsa>
16    cc:  jromine@uci-icsa
17    Subject:  Re:  MH  transcript
18    In-reply-to:  Your  message  of  16  Mar  85  18:28:59  PST  (Sat).
19    --------
20    Thanks  for  the  test.
21
22    /JLR
23    ^D
24
25    What  now?  send
26    %  comp
27    To:  MRose@UCI
28    cc:
29    Subject:  sample  comp
30    --------
31    Here's  a  sample  compose  for  the  MH  transcript.
32
33    /JLR
34    ^D
35
36    What  now?  send  -verbose
37      --  Posting  for  All  Recipients  --
38       --  Local  Recipients  --
39       MRose:  address  ok
40      --  Recipient  Copies  Posted  --
41    Message  Processed


                                                  Figure 1

 _____________________________________________An_MH_Session_____________________________________________________



 a  `-help'     switch,  which  lists  the  syntax  of  the  command  along  with  available

 switches, and the version number of the command.  Most MH commands also take

 a `msg'    or `msgs'     argument which takes the form of a message number (``1''   ), a

 message range (``1-2''     ), a standard sequence name (``cur''     ), or a user-defined

 sequence name (``select''      ).
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              5


An MH Transcript

        Figure 1 contains a transcript of a simple MH session.  First, inc is run to

incorporate the new mail into the user's ``+inbox''       folder.


        A  scan  listing  of  the  mail  is  printed  while  it  is  being  incorporated.  (The

user could run scan explicitly to generate additional scan listings later on.)  The

scan  listing  gives  the  message  number,  followed  by  the  date,  message  sender,

and subject.  (If the message originated from the user generating the listing, the

``to:''      addressee is displayed instead of the sender.)  If the subject is short, the

first part of the message body is displayed after the characters ``<<''    .  The plus

sign (`+') after the message number indicates the current message.


        The user show s the message, and decides to repl y.  A reply draft is created

using  the  headers  of  the  message  being  replied-to,  using  the  default  replcomps

template.  The  default  editor,  prompter,  is  called  to  edit  the  draft.  When  an

EOT is typed, prompter exits and the user is left at the What  now?  prompt.  The

option send is chosen.  Since there were no problems in posting the draft with the

message transport system, no additional output is produced.  (MH is not verbose

by default.)


        The  user  then  decides  to  compose  a  new  message.  The  default  skeleton,

components      ,  is  copied  to  the  draft,  and  prompter  is  once  again  called.   After

entering the addresses, subject, and body, the user then send s the draft   from the

What  now?  prompt, using ``send -verbose''           , which causes MH to list out the

message addresses as it submits them to the message transport system.



Some MH Features

        We now consider certain advanced features in MH. These features have been

chosen to demonstrate some useful capabilities available to the MH user.


Message Sequences and Selection

        MH  has  several  built-in  message  sequence  names,  which  may  be  used

anywhere a `msg'     or `msgs'     argument is expected.  These are:  `cur'   , `next'    ,

`prev'    , `first'     , `last'    , and `all'   .  Message ranges may also be specified.  For

example, `all'     is actually `first-last'        , and `+mh last:5'         references the last

five messages in your `+mh'    folder.  A powerful capability of MH is the ability to use

not only the pre-defined message sequence names, but also arbitrary user-defined

message sequence names.


        Although all MH programs recognize user-defined sequences when appropriate,

the  pick  and  mark  commands  can  create  and  modify  user-defined  message

sequences.  The mark command allows low-level manipulation of sequences, and is

not particularly interesting in our discussion.


        The pick command selects certain messages out of a folder.  The criteria used

for selection may be a search string and/or a date range.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              6


        Searching  is  performed  on  either  a  specific  header  in  the  message  (e.g.,

``To:''     ), or anywhere within the message.  By default, pick lists out the message

numbers that matched the selection criteria.  Thus, pick is useful in backquoted

operations to the shell.  For example, to scan all the messages in the current folder

from "frated", the MH user issues the command:


           scan `pick -from frated`


To  perform  more  complicated  message  selection,  user-defined  sequences  are

employed.  Supplying a `-sequence name'           argument to pick, will cause it to define

the sequence `name'     as those messages matched.


        Giving  pick  a  list  of  messages  causes  it  to  limit  its  search  to  just  those

messages.  For example, to find all the messages in the current folder from "frated"

also dated before friday:


           pick -from frated -sequence select

           pick select -before friday -sequence select


With the first pick command, the sequence ``select''        is defined to be all those

messages from "frated".  In the second command, only those messages already in

the ``select''       sequence are searched, and the ``select''       sequence is redefined

to be only those messages which are also dated before friday.  Those messages could

then be show n with:


           show select


When  a  `-sequence name'           argument  is  given  to  pick,  the  default  behavior  _

listing the message numbers matched _ is inhibited.  To re-enable this behavior,

the `-list'     option may be given.  As a result, advanced users of MH often put the

following line in their .mh_profile    :


           pick: -sequence select -list


which allows them to easily make use of the `select'      sequence as the messages

last selected with pick.


        Often it is desirable to act upon those messages which are not members of

a given sequence.  For this purpose, the ``Sequence-Negation:''               profile entry

is useful.  If the name of a user-defined sequence is prefixed with the value of the

sequence-negation profile entry, MH commands will operate upon those messages

which are not members of that sequence.  For example, given a profile entry of:


           Sequence-Negation: not


those messages which are not in the `select'      sequence could be scan'd with:


           scan notselect
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              7


        Obviously, some confusion could result if an attempt was made to define a se-

quence name which began with the sequence-negation string (e.g., ``notselect''        ).

For this reason, MH users will often use a single character, which their shell doesn't

interpret, as their sequence-negation string (e.g., up-caret (`^') for C Shell users,

and exclamation-mark (`!')  for Bourne shell users).


        MH also provides a way of automatically remembering the last message list

given to an MH command.  This facility is implemented by using a profile entry

called ``Previous-Sequence:''              .


Draft Handling

        After  the  initial  edit  of  a  message  draft,  the  comp,  dist,  forw,  and  repl

programs give the user a What  now?  prompt.  The valid responses include:  edit to

re-edit the draft, quit to exit without sending the draft, send to send the draft, and

push to send the draft in the background.


        When the send option is given, the draft is posted with the message transport

system.  If there problems posting the draft, the What  now?  prompt is re-issued, so

errors in the draft may be corrected.


        Since posting the draft can be slow, the push option allows the MH user to

send the draft in the background, and return immediately to the shell.  If there are

problems posting the message, the user will not see the diagnostics produced by

the message transport system.  For this reason, if push is used instead of send, and

the message is not successfully posted, MH mails a message to the user containing

any diagnostics which the message transport system produced along with a copy

of the message.  Later, the draft may be re-edited by entering ``comp -use''        .


        A relatively new feature of MH is the ability to use a folder to store multiple

drafts.  These drafts are kept in an ordinary MH folder, and may be operated upon

by MH commands.  To enable this feature, the MH user selects a folder-name for

the draft-folder, and creates an entry in the .mh_profile    :


           Draft-Folder: +foldername


From this point on, when a message is composed, the draft will be created as a

message in that folder, instead of using the draft   file in the user's MH directory.

Unfortunately, if posting problems occur on a message which has been push'd, it

may be difficult to re-edit the draft with ``comp -use''        .  This might be the case

if the user had started composing another message, while that first draft was being

posted.  In  that  event,  the  current-message  in  the  draft-folder  would  no  longer

point to the failed draft.


        There is a solution for this problem, however.  By default, push assumes the

`-forward'        option,  which  says  that  if  the  message  draft  fails  to  be  posted,  it
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              8


should be forwarded back to the user in the error report which push generates.

The failed draft may then be extracted with the burst program (discussed later).


BBoards

        MH has a convenient interface to the UCI BBoards facility[MRose84a].2  This

facility  permits  the  efficient  distribution  of  interest  group  messages  on  a  single

host, to a group of hosts under a single administration, and to the ARPA Internet

community.


        Although most readers are probably familiar with the concept of an interest

group in the Internet context, a brief description is now given.  Observant readers

will notice that the distributed nature of the "network news" (a.k.a. USENET)

tends to avoid many of the problems described below.


        Described simply, an interest group is composed of a number of subscribers

with a common interest.  These subscribers post mail to a single address, known

as the distribution address (e.g., MH-Workers@UCI. From this distribution address,

a copy of the message is sent to each subscriber.  Each group has a moderator,

who is the person that runs the group.  This moderator can usually be reached at

a special address, known as the request address (e.g., MH-Workers-Request@UCI).

Usually,  the  responsibilities  of  the  moderator  are  quite  simple,  since  the  mail

system handles distribution to subscribers automatically.  In some interest groups,

instead of each separate message being distributed directly to subscribers, a batch

of (hopefully related) messages are put into a digest format by the moderator and

then sent to the subscribers.  (This is similar to a newsletter format.)  Although

this requires more work on the part of the moderator and introduces delays, such

groups tend to be better organized.


        Unfortunately, some problems arise with the scheme outlined above.  First,

if two users on the same host subscribe to the same interest group, two copies of

the message are delivered.  This is wasteful of both processor and disk resources at

that host.


        Second, some groups carry a lot of traffic.  Although subscription to a group

does indicate interest on the part of a subscriber, it is usually not interesting to get

50 or so messages delivered each day to the user's private maildrop, interspersed

with personal mail,  which is likely to be of a much more important and timely

nature.


        Third, if a subscriber's address in a distribution list becomes "bad" somehow

and causes failed mail to be returned, the originator of the message is normally

notified.  It is not uncommon for a large list to have several bogus addresses.  This

results in the originator being flooded with "error messages" from mailers across


_____________________________________
2  The UCI BBoards facility can run under either the MMDF or SendMail, or in a more restricted

form under stand-alone MH.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985              9


the Internet stating that a given address on the list was bad.  Needless to say, the

originator usually does not care if the bogus addresses got a copy of the message

or not.  The originator is merely interested in posting a message to the group at

large.  On the other hand, the moderator of the group does care if there are bogus

addresses on the list, but ironically does not receive notification.


        To solve these problems, the UCI BBoards facility introduces a new entity

into the picture:  a distribution channel.  All interest group mail is handled by the

special mail system component.  The distribution address for an interest-group

maps mail for that interest-group to the distribution channel, which then performs

several actions.  First, if local delivery is to be performed, a copy of the message is

placed in a global maildrop for the interest group with a timestamp and a unique

number.  Local users can read messages posted for the interest group by reading

this "public" maildrop.  Second, if further distribution is to take place, a copy of

the message is sent to the distribution address in such a way that if any of the

addresses are bogus, failure notices will be returned to the local maintainer of the

group address list, rather than the originator of the message.


        This scheme has several advantages:  First, messages delivered to the local

host are processed and saved once in a globally accessible area.  The UCI BBoards

facility supports software which allows a user to query an interest group for new

messages and to read and process those messages in the MH-style.  Second, once

a host administrator subscribes to an interest group, each user may join or quit

the list's readership without contacting anyone.  Third, a hierarchical distribution

scheme can be constructed to reduce the amount of delivery effort.  Finally, errors

are prevented from propagating.  When an address on the distribution list goes

bad, the list moderator who is responsible for the address is notified.  If a local

moderator does not exist,  then the local PostMaster is notified (not the global

group moderator).


        In addition to solving the problems outlined above, the UCI BBoards facility

supports several other capabilities.  BBoards may be automatically archived in

order  to  conserve  disk  space  and  reduce  processing  time  when  reading  current

items.   Also,  the  archives  can  be  separately  maintained  on  tape  for  access  by

interested researchers.


        Special  alias  files  may  be  generated  which  allow  the  MH  user  to  shorten

address entry.  For example, instead of sending to SF-Lovers@Rutgers, a user of

MH usually sends to ``SF-Lovers''          and the MH aliasing facility automatically

makes the appropriate expansion in the headers of the outgoing message.  Hence,

the user need only know the name of an interest group and not its global network

address.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             10


        Finally, the UCI BBoards facility supports private interest groups using the

UNIX  group  access  mechanism.  This  allows  a  group  of  people  on  the  same  or

different machines to conduct a private discussion.


        The practical upshot of all this is that the UCI BBoards facility automates the

vast majority of BBoards handling from the point of view of both the PostMaster

and the user.


        MH provides three programs to deal with interest groups.  The bbc program

is used to check on the status of one or more groups, and to optionally start an

MH shell on those groups which the user is interested in.  The bbl program can be

used to manually perform maintenance on a discussion group beyond the normal

automatic  capabilities  of  the  UCI  BBoards  facility.  Finally,  the  msh  program

implements  an  MH  shell  for  reading  BBoards,  in  which  nearly  all  of  the  MH

commands are implemented in a single program.


        Observant  readers  may  note  that  the  use  of  msh  is  contrary  to  the  MH

philosophy of using relatively small, single-purpose programs.  Sadly, the authors

admit that this is true.  In an effort to minimize use of system resources however,

BBoards are kept in maildrop format instead of folders.3  Some research has gone

into overcoming this problem to restore MH's purity of purpose, but all solutions

proposed  to  date  are  either  unworkable  or  require  significant  recoding  of  MH's

internals.


Bursting

        Internet interest group mail is often sent out in digest form.  The experienced

MH user may wish to deal with the digest messages on an individual basis, however.

The burst program allows the MH user to extract these digest messages, and store

each as an individual MH message.


        Burst will also extract forwarded messages generated by forw (or the forwarded

message  in  the  error  report  generated  by  push,  as  described  above).  Although

burst cannot always decapsulate messages encapsulated by sites not running MH,

it adheres to the proposed standard described in [MRose85b].



_____________________________________
3  When the message transport system delivers a message to a user it stores it in a single file, called

a maildrop. Since many messages may be present in a single maildrop, (in theory) there is a unique
string acting as a separator between messages in the maildrop.  Although this is convenient for
storage of messages, it makes retrieval more difficult unless a separate index into the maildrop is
kept. This latter approach is taken by the msg program available with MMDF-II and by msh as well.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             11


Distributed Mail

        The  ARPA  Internet  community  consists  of  many  types  of  heterogeneous

nodes.  Some  hosts  are  large  mainframe  computers,  others  are  personal  work-

stations.  All  communicate  using  the  milstd  TCP/IP  protocol  suite[IP, TCP].

Messages which conform to the Standard for the Format of ARPA Internet Text

Messages[DCroc82] are exchanged using the Simple Mail Transfer Protocol[SMTP].


        On smaller nodes in the ARPA Internet, it is often impractical to maintain

a message transport system (e.g., SendMail).  For example, a workstation may not

have sufficient resources (cycles, disk space) in order to permit an SMTP server

and associated local mail delivery system to be kept resident and continuously

running.  Furthermore, the workstation could be off-net for extended periods of

time.  Similarly, it may be expensive (or impossible) to keep a personal computer

interconnected to an IP-style network for long periods of time.  In other words, the

node is lacking the resource known as "connectivity".


        Despite  this,  it  is  often  desirable  to  be  able  to  manage  mail  with  MH  on

these smaller nodes, and they often support a user agent to aid the tasks of mail

handling.  To solve this problem,  a network node which can support a message

transport  entity  (known  as  service  host)  offers  a  maildrop  service  to  these  less

endowed nodes (known as client hosts).  The Post Office Protocol[JReyn84] (POP)

is intended to permit a workstation to dynamically access a maildrop on a service

host to pick-up mail.4  The level of access includes the ability to determine the

number of messages in the maildrop and the size of each message, as well as to

retrieve and delete individual messages.  More sophisticated implementations of the

POP server are able to distinguish between the header and body portion of each

message, and send n lines of a message to the POP client.  This capability is useful

in thinly connected environments where conservation of bandwidth is important.

By utilizing a more intelligent POP client, a user may generate "scan listings" and

decide dynamically which messages are worth taking delivery on.  The philosophy

of the POP is to put intelligence in the POP clients and not the POP servers.


        The current release of MH supports the above model fully.  A POP client

program is available to retrieve a maildrop from a POP service host.  In addition,

using  the  SMTP  configuration  for  delivery  in  MH  (either  in  conjunction  with

SendMail  or  the  MMDF),  a  user  is  able  to  specify  a  search-list  of  service  hosts

(and/or networks) to try to post mail.  Using this search-list, when an MH user

posts a draft,  the post program will attempt to establish an SMTP connection

with  each  host  in  the  search-list  to  post  the  message  until  it  succeeds.  Initial


_____________________________________
4  Actually, there are three different descriptions of the POP. The first, cited in [JReyn84], was the

original description of the protocol, which suffered from certain problems. Since then, two alternate
descriptions have been developed. The official revision of the POP[MButl85], and the revision of the
POP which MH uses (which is documented in an internal memorandum in the MH release).  This
paper considers the POP in the context of the MH release.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             12


experimentation  using  the  POP  and  MH  in  a  local  network  environment  has

proved quite successful.



User Interface Issues in MH

        At this point, it is perhaps useful to take a step backwards and examine the

success and problems of MH's approach to user interfaces.


Creeping Featurism

        A complaint often heard about systems which undergo substantial develop-

ment by many people over a number of years, is that more and more options are

introduced which add little to the functionality but greatly increase the amount of

information a user needs to know in order to get useful work done.  This is usually

referred to as creeping featurism.


        Unfortunately MH, having undergone six years of off-and-on development by

ten or so well-meaning programmers (the present authors included), suffers mightily

from this.  For example, the send command has twenty-five visible switches, and at

least nine hidden switches, for a total of thirty-four.  The poor user who types


           send -help


watches the options scroll off the screen (since the `-help'      switch also lists out

four other lines of information).5   The sad part is that all of these switches are

useful in one form or another.


        There are a lot of good things to be said for the "one program, one function"

philosophy of system design.  In the MH case, however, each program really does

only  one  mail  handling  activity  (with  a  few  minor  exceptions).   The  options

associated with each command are present to modify the program's behavior to

perform similar, but slightly different tasks.  In further defense of MH, note that

there are 32 MH commands at present, all performing different tasks.


        The problem with creeping featurism though, is that while the functionality

of the system increases sub-linearly, the complexity of the system increases linearly.

That is, although the number of switches that a program takes might double, it is

unlikely that the program's functionality or capabilities will double.



_____________________________________
5  Recently, this was fixed by compressing the way in which switches are presented. The solution is

only temporary however, as send will no doubt acquire an endless number of switches in the years
to come.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             13
_______________________________________________________________________________________________________________

To:
cc:
Bcc:
Fcc:  outbox
Fcc:
Subject:
Reply-To:
--------


                                                 Figure 2

______________________________________________Draft_Skeleton___________________________________________________

_______________________________________________________________________________________________________________

To:  <reply-to_from>
cc:  <?to_cc><to>,<cc>
Fcc:  +outbox
Fcc:  <?fcc><fcc>
Subject:  <?subject>Re:  <subject>
In-reply-to:  <?date><?message-id>Your  message  of  <date>.
       <message-id>
In-reply-to:  <?date><!message-id>Your  message  of  <date>.
--------


                                                 Figure 3

_____________________________________________Reply_Template____________________________________________________



Templates versus Switches

        One  way  to  trim  the  explosion  of  available  options,  while  still  increasing

functionality, is to introduce options with a richer domain.  Hence, instead of using

options which take on or off forms or simple numeric or string values, the possible

values which an option might take on is given a large space.  There are several ways

that this might be accomplished.


        The comp,  dist,  and forw programs use draft skeletons (simple form fill-in

files) to construct the general format of the draft being composed.  An example of

a draft skeleton used for composing new messages (by comp) is shown in Figure 2.

The approach is to let the user specify (and later edit) both arbitrary headers of

draft and the body of the draft.  Note while most of the fields are empty, the first

``Fcc:''       field already contains a value.  By using the simple prompting editor,

prompter, the user can speedily enter the headers of the message.  The prompter

program given the skeleton in Figure 2 would prompt the user for the contents

of each field, except for the second ``fcc:''     , which it would include verbatim.

It would then read the body of the message up to an end-of-file.  Naturally, the

MH user is free to use any editor to edit any part of the draft (headers or body).

This example demonstrates the flexibility achieved by not limiting what headers a

draft may contain (which most mail sending programs do), while still retaining the

simplicity of being able to treat the entire message draft as a UNIX file.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             14
_______________________________________________________________________________________________________________

From:  <?me>Message  Agent  "<<me>>
To:  <reply-to_from>
Fcc:  +rcvtrip
Fcc:  <?fcc><fcc>
Subject:  <?subject>BEEP!  Re:  <subject>
Subject:  <!subject>BEEP!
In-reply-to:  <?date><?message-id>Your  message  of  <date>.
       <message-id>
In-reply-to:  <?date><!message-id>Your  message  of  <date>.
--------


      This  is  an  automatic  reply.   Feel  free  to  send  additional  mail,  as  only
      this  one  notice  will  be  generated.


      I  am  attending  the  USENIX  Summer  '85  conference  in  Portland,  Oregon.
      I  expect  to  be  reading  mail  again  on  the  16th  of  June.


/mtr


                                                 Figure 4

__________________________________The_tripcomps______Reply_Template____________________________________________



        Another  more  interesting  approach  is  used  by  the  repl  command,  which

constructs a draft in reply-to a previously received message.  Instead of adding

switches to indicate which fields of the draft should be derived from the message

being replied-to, and how they should be derived, a single option, the ability to

specify a template, was made available.  An example of a reply template is shown

in Figure 3.  Put simply,  based on the presence of certain fields in the message

being replied-to, and a few switches given by the user, using the reply template,

repl generates the reply draft automatically.


        This facility, for example, can be used to generate automatic replies.6  One

function  might  be  to  write  a  rcvtrip  shell  script  which  automatically  answered

messages when mail wasn't being read for a period of time (e.g., while attending a

conference).  An example of a reply template at the heart of such a script is shown

in Figure 4.


        Finally, another application might be to utilize the highly useful letter bomb

protocol.7  The important thing to note about this template is that it generates

not only the headers of the reply draft (with a creative ``Reply-to:''         address),

but the body as well.  Hence, the commands


           repl -form bombcomps -noedit ; rmm


_____________________________________
6  MH supports the notion of a user-defined mail hook which is invoked each time a user receives

mail.
7  The  authors  wish  to  credit  Ron  Natalie  of  the  Ballistics  Research  Laboratory  in  Aberdeen,

Maryland for formalizing the use of this protocol in the ARPA Internet community.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             15
_______________________________________________________________________________________________________________

To:  <reply-to_from>
cc:  <?to_cc><to>,<cc>
Fcc:  +outbox
Fcc:  <?fcc><fcc>
Subject:  <?subject>Re:  <subject>
In-reply-to:  <?date><?message-id>Your  message  of  <date>.
       <message-id>
In-reply-to:  <?date><!message-id>Your  message  of  <date>.
Reply-To:  /dev/null
--------


                                   "
                                  *-XXX
                                   /    XX
                                           X
                                              X
                                               X
                                               X
                                               X
                                          IIIIIIIII
                                          IIIIIIIII
                                          IIIIIIIII
                                          IIIIIIIII
                                          XXXXXXXXX
                                XXXXXXXXXXXXXXXXXXXXXXX
                            XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                   XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
              XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
            XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
            XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
            XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
              XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
               XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                   XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                    XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                            XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
                                XXXXXXXXXXXXXXXXXXXXXXX
                                          XXXXXXXXX


                                                 Figure 5

_________________________________The_bombcomps________Reply_Template___________________________________________



           What now? push
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             16
_______________________________________________________________________________________________________________

width=80,length=0,overflowtext=,overflowoffset=10
Date:leftadjust,compress,compwidth=9
Subject:leftadjust,compress,compwidth=9
From:leftadjust,compress,compwidth=9
To:leftadjust,compress,compwidth=9
cc:leftadjust,compress,compwidth=9
Resent-Note:leftadjust,compwidth=9
:
body:nocomponent,overflowoffset=0


                                                 Figure 6

____________________________________________Display_Template___________________________________________________



are very handy for dealing with disturbing mail in a straight-forward manner.  Of

course, repl could be linked to bomb in the user's bin/   directory and an appropriate

line could be added to the user's MH profile, in order to further shorten type-in.


        A variation on the reply template is the display template.  A display template,

as used by the mhl program, contains instructions on how to format a message.  In

addition to being used by show, et. al., the forw program can also use a display

template to format each message being forwarded.  Similarly, although repl uses a

reply template to construct the draft being composed, it also may use a display

template to format the body of the message being replied-to for enclosure in the

reply.  Furthermore, the post program may use a display template to format the

body of a blind-carbon-copy.  An example of a display template used for formatting

forwarded messages is shown in Figure 6.


        As with reply templates, display templates can offer a lot of functionality.

For example, the one line display template:


           body:nocomponent,overflowtext=,overflowoffset=0,width=10000


can be used to extract the body of a message, while ignoring the headers.  Hence,

if a shar archive arrived in the mail, a convenient way to unpack it, assuming the

above display template was called mhl.body     , would be:


           show -form mhl.body _ sh



        The biggest win with display templates, of course, is that all those annoying

header lines which mailers everywhere generate can be simply and easily filtered

out.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             17


Modularity versus Monolithicity

        Since MH is a set of programs which perform separate tasks, as opposed to

being a single, monolithic program, the power of the shell is used directly to aid in

mail-handling.  One powerful capability which this design achieves is the ability to

extend the MH command set, by developing shell scripts which use the standard

MH programs to accomplish complicated or specialized tasks.


        For  example,  in  the  MH  distribution  there  is  a  shell  script  called  mpick

(shown in Figure 7) which tries to locate all the messages which pertain to a given

discussion, by looking at the ``Message-ID:''           and ``In-reply-to:''           headers,

to find matching message-ids.8


        Unfortunately, some parts of MH are somewhat monolithic.  An example of

this is the What  now?  prompt.  There are only a few options at this prompt, and

one cannot give a normal shell command.  Some MH users seem to feel that more

options should be added to the What  now?  prompt, such as an insert-file option.  It

was argued that just about any editor would allow you to insert a file, and another

What  now?  option was not needed.  These users persisted, however, so the problem

was solved, by writing a trivial shell script "editor" (see Figure 8) which could be

invoked by the edit option:


           What  now? edit append filename



        A better interface at this point is really needed, however.  One possibility is to

simply pass any unrecognized commands on to a shell for interpretation, supplying

the  path  name  of  the  draft  file  as  an  argument.  A  solution  which  shows  more

promise is to give you a sub-shell instead of the What  now?  prompt,  and setup

certain envariables so that the MH commands would act upon the draft   by default.

For example, show with no `msgs'     arguments would show the draft instead of the

current message.  This alternative has recently been implemented and is under

testing.



The MH Distribution

        The  mh.5  distribution  is  now  briefly  described,  both  in  terms  of  static

configuration methods and dynamic tailoring.  Appendix B describes the mechanics

of receiving an mh.5 distribution.



_____________________________________
8  Note that the shell scripts included in the MH distribution are written for the Bourne shell, and

have a `:' as the first character of the first line, so they will be portable to all versions of UNIX, not
just those which support the Berkeley `# !' enhancement.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             18
_______________________________________________________________________________________________________________

:  'mpick  -  relate  messages  /mtr'
PATH=:/bin:/usr/bin:/usr/ucb:/usr/local:/usr/local/lib/mh;  export  PATH
F=""  M=""  S=""


for  A  in  $*
do
      case  $A  in
           -*)       S="$S  $A"  ;;


           +*_@*)   case  $F  in
                           "")   F=$A  ;;
                           *)    echo  "mpick:  only  one  folder  at  a  time"  1>&2
                                  exit  1  ;;
                      esac  ;;


           *)        M="$M  $A"  ;;
      esac
done


S="$S  -sequence  hits  -list  -nozero"


if  mark  $F  all  -add  -sequence  hits;
      then  mark  $F  all  -delete  -sequence  hits;
      else  exit  1;
fi


for  A  in  $-M-cur"
do
      for  C  in  `mhpath  $F  $A`
      do
           if  [  -r  $C  ];
                then
                      I=`mhl  -form  mhl.msgid  $C`;
                      case  $I  in
                           "")   echo  "no  message-id  in  message  `basename  $C`"  1>&2  ;;
                           *)    pick  --in-reply-to  "$I"  $S  ;;
                      esac
                else
                      echo  "message  $A  doesn't  exist"  1>&2;  exit  1;
           fi
      done
done


exit  0


                                                 Figure 7

____________________________________________The_mpick_Script___________________________________________________



Configurable MH

        The  MH  distribution  currently  runs  on  a  large  number  of  different  UNIX

versions, ranging from MicroSoft XENIX to Berkeley 4.2bsd.  All the code which
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             19
_______________________________________________________________________________________________________________

:  'append  -  stupid  append  editor  for  MH  -  /jlr'
case  $#  in
    1_2)  case  $#  in
                1)  F=$1;  echo  -n  "Append  file:  "  1>&2;  read  A  ;;
                2)  F=$2;  A=$1  ;;
           esac
           cat  $A  <  /dev/null  >>  $F  ;;
       *)  echo  "append:  arg  count"  1>&2  ;  exit  1  ;;
esac
exit


                                                 Figure 8

___________________________________________The_append_Editor___________________________________________________

_______________________________________________________________________________________________________________

bin       /usr/local
bboards  on
editor   /usr/local/prompter
etc       /usr/local/lib/mh
mail      /usr/spool/mail
manuals  local
mts       sendmail/smtp
news      off
options  BSD42
options  MHE  NETWORK
options  UCI


                                                 Figure 9

___________________________________Sample_MH_Configuration_File________________________________________________



is specific to a particular target environment is enabled via the C-preprocessor

``# ifdef''       mechanism, so compilation under different versions of UNIX is trivial.

There are, however, a large number of compile-time options which may vary from

site to site, so an automated configuration method was needed.


        The MH-installer must create a configuration file,  which contains a list of

the compile-time options and the values which are desired for them.  Compile-time

options include the installation location for MH, what kind of message transport

system is to be used, and the default editor for the installation.  An example of

such a configuration file is shown in Figure 9.


        After creating this file (several examples are included in the distribution), the

installer runs the mhconfig program, which customizes the Makefile    s and some of

the programs, for that site's particular installation.  No hand-editing of any source

code should be necessary, under normal circumstances.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             20
_______________________________________________________________________________________________________________

mmdfldir:          /usr/spool/mail
mmdflfil:
mmdelim1:          "001"001"001"001"n
mmdelim2:          "001"001"001"001"n
mmailid:           0
lockstyle:        0
lockldir:


hostable:          /usr/local/lib/mh/hosts
servers:           localhost  "01localnet


                                                Figure 10

_______________________________________Sample_MTS_Tailor_File__________________________________________________



Interface to the Message Transport System

        MH will run with a number of message transport systems, including SendMail,

MMDF-II, and a small stand-alone system.  One flexible method of posting mail

is through an SMTP connection.  There are a couple of major wins in using this

configuration:  First, none of the MH programs need to know where the interface

programs to the message transport system are located, which makes them easier

to move between systems.  Second, mail can be posted on relay hosts, and the local

host of an MH user may not need a message transport system at all (as alluded to

in the preceeding discussion on the POP).


        Those parts of MH which interact with the local message transport agent

read additional tailoring information when they start.9  This information includes

the location of standard and alternate maildrops, maildrop delimiter strings, the

locking  directory  and  locking  style,  and  other  tailoring  information  specific  for

the particular message transport system in use (e.g., the default server search-list

when mail is posted with the SMTP). In most cases, by using a tailor file, each site

running a similar MH configuration is able to simply transfer MH binaries between

hosts.  An example of such a tailor file is shown in Figure 10.


        A  continuing  question  which  is  often  raised  is  how  intelligent  should  user

agents (like MH and UCB Mail ) be with respect to the environment in which they

operate.  At present, MH likes to determine the official hostnames for addresses

when posting mail.  Many argue that this is improper or unnecessary behavior

for  a  user  agent,  and  that  the  local  message  transport  agent  should  handle

these  functions.   Unfortunately,  this  implies  that  the  message  transport  agent

should munge headers when mail is posted to remove local host aliases and only

permit address fields with fully-qualified addresses.  Sadly, neither SendMail nor

MMDF-II  really  gets  this  right  (flames  to  /dev/null     please).   The  current  MH

maintainers believe that the resolution of host aliases to official names should be

a well-supported interface with the local message transport agent.  However,  to

_____________________________________
9  This simple facility is based on a more extensive tailoring capability found in MMDF-II.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             21


provide equal time to those who hold opposite views, MH supports a configuration

option called ``DUMB''       which disables MH's attempts to resolve addresses into

fully-qualified strings.



Concluding Remarks

        While MH has undergone significant development since the original Rand

release, the authors have tried to keep the fundamental concepts of MH unchanged.

The authors have continually had to battle against well-meaning MH users who

wanted to make MH more like other (less powerful) user agents.  More and more

"features"  were  often  suggested  for  MH,  usually  at  the  expense  of  making  MH

less  general,  and  more  specific.  In  nearly  all  cases,  the  "features"  which  these

users wanted were already present in MH in a slightly different form, or could be

realized by simply writing a short shell script.  A classic example is the repeated

requests  by  one  user  to  have  dist  take  a  list  of  messages  rather  than  a  single

message and distribute each one of them in turn.  A simple shell script which called

dist repeatedly, perhaps with "canned" arguments so the user typed in addressing

information only once, would easily meet this request.


        A number of MH comands have a large number of options.  When adding

options, the authors have tried to make the options general, while still accomodating

the  requests  of  specific  users.   An  example  of  a  specific  request  which  was

implemented  as  a  general  feature  is  the  ``Previous-Sequence''              profile  entry

(mentioned above).  If you use this profile entry, every MH command is forced to

write out context    changes, making every command somewhat slower.  Since only a

few users wanted this capability, it was implemented in such a way that users who

didn't want it, didn't have to pay the cost of slowing down every MH command.


        MH has a powerful tailoring capability provided by the .mh_profile    .  Using

profile entries, users may customize their own environment without affecting others.

Novice users often take advantage of the MH-tailoring capabilities to try to make

MH work similarly to other user agents they've used.  This has the advantage of

allowing them to quickly begin using MH to handle their mail.  However, since these

novice users don't take advantange of all the capabilities of MH, they frequently

will complain about things they think can't be done with MH, or could be done

"better" some other way.  Fortunately,  as these users become more experienced

with  both  MH  and  UNIX,  they  can  modify  their  environment  to  take  better

advantage of all of MH's capabilities.  Novice MH users who see features lacking

are encouraged to take a better look at what MH can do, instead of trying to make

MH into something it isn't.  This may sound rather inflammatory, but it would

really be a much nicer world for us all if users of software systems would read the

manual prior to asking questions.


        For  a  moment,  let's  consider  the  evolution  of  one  MH  feature  which  has

proved  itself  to  be  very  useful.  As  users  began  employing  MH  to  handle  their
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             22


mail, the number of messages that could be processed in a given amount of time

increased greatly.  As the volume of messages increased however, it became clear

that  some  MH  operations  were  too  slow,  in  particular  the  interaction  with  the

(slow) message transport system.  To overcome this problem, the push option was

added at the What  now?  prompt.  Originally, this option was hidden from novice

users and did little more than send the message in the background:  any output

generated by the background send process would be printed asyncronously on the

terminal.  If a message failed posting with the message transport system, it would

simply be left in the draft   file.


        Gradually, other features were added to push.  Since users wanted to be able

to send more than one draft at a time,  push was changed to optionally rename

the draft file before posting it.  (This is what the hidden `-unique'       option does.)

Having message transport system diagnostics written asyncronously on the user's

terminal was annoying, so push was made to intercept these diagnostics, and mail

the user a report containing them.  Although the diagnostic report mailed back by

push contains the name of the draft which failed, a useful added feature was the

ability to have push include the failed draft as well.  Eventually, the draft-folder

mechanism  was  implemented  to  make  handling  multiple  message  drafts  much

easier.


TODO

        There are, no doubt, a number of improvements which could be made to MH.

At the present time, what further development should MH suffer?  Although not

by any means inclusive, here's a list:


           1.  Performance Enhancements

               Hardware  gets  faster  all  the  time,  but  people  always  complain  that

               software is too slow.  Owing to its user interface style, MH is somewhat

               slower than monolithic programs like UCB Mail.  It would be nice if MH

               could be tuned or accelerated somehow.


           2.  Port to System 5

               MH  runs  on  4.2bsd  UNIX  and  Version  7  variants.  It  should  not  be

               difficult to port MH to a SYS5 environment.  This should significantly

               increase the number of hosts on which MH can run.  The authors, lacking

               a SYS5 machine (and experience with SYS5) to perform the port, are

               actively seeking a System 5 guru to attempt this feat.


           3.  Interface to the Network News

               Not all sites that run MH are in the ARPA Internet, and as such the

               UCI BBoards facility may not be of much use to them.  A good MH

               interface to the network news would allow users on hosts with a news

               feed to employ the same interface for reading and sending both mail

               and news.
\f

Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             23


         4.  Programmed Instruction for Beginners

             The complexity of MH is often intimidating to new users.  It would be

             nice to develop a set of learn lessons for those users who don't like man

             pages and non-interactive tutorials.


         5.  Message List Expansion

             At  present,  when  a  list  of  messages  is  given  to  an  MH  command,  it

             expands the list and processes each message in numerical order rather

             than the order in which the messages were given (e.g., ``show 2 1''

             show s message 1 and then message 2).  It would be nice if MH processed

             messages in the order they were given.


         6.  Context Changes

             In nearly all cases, an MH command does not write out context changes

             until it is about to exit successfully.  There is some controversy as to

             whether this is the correct behavior in all cases.  Some argue that once

             an MH command has fully parsed its argument list, the context should

             be updated.
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             24


                                               References



[DCome83]        D.  Comer.   The  Computer  Science  Research  Network  CSnet:  A

                 History  and  Status  Report.  Communications  of  the  ACM  26,  10

                 (October, 1983), 747-753.



[DCroc79]        D.H.  Crocker,  E.S.  Szurkowski,  D.J.  Farber.   An  Internetwork

                 Memo  Distribution  Facility  _  MMDF.  Appearing  in  Proceedings,

                 Sixth Data Communications Symposium, Asilomar, 1979, pp. 18-25.



[DCroc82]        D.H.  Crocker.   Standard  for  the  Format  of  ARPA  Internet  Text

                 Messages.  Request  for  Comments  822.  ARPA  Internet  Network

                 Information Center (NIC), SRI International (August, 1982).



[DKing84]        D.P.  Kingston,  III.   MMDFII:  A  Technical  Review.  Appearing  in

                 Proceedings  Usenix  Summer  '84  Conference,  Salt  Lake  City,  Utah,

                 1984, pp. 32-41.



[EAllm83]        E.  Allman.    SENDMAIL  _  An  Internetwork  Mail  Router.

                 Britton-Lee, Inc., Berkeley, California (July, 1983).



[IP]             Internet  Protocol.  Request  for  Comments  791  (milstd  1777).

                 Appearing in Internet Protocol Transition Workbook, ARPA Internet

                 Network Information Center (NIC), SRI International, 1981.



[JReyn84]        J.K.  Reynolds.   Post  Office  Protocol.  Request  for  Comments  918.

                 ARPA Internet Network Information Center (NIC), SRI International

                 (October, 1984).



[MButl85]        M. Butler,  J.B. Postel,  et. al.   Post Office Protocol - Version 2.

                 Request  for  Comments  937.  ARPA  Internet  Network  Information

                 Center (NIC), SRI International (February, 1985).



[MRose84a]       M.T.  Rose.   The  Rand  MH  Message  Handling  System:  The  UCI

                 BBoards Facility. Department of Computer and Information Sciences,

                 University of Delaware (October, 1984).



[MRose85b]       M.T.  Rose,  E.A.  Stefferud.   Proposed  Standard  for  Message

                 Encapsulation. Request for Comments 934. ARPA Internet Network

                 Information Center (NIC), SRI International (January, 1985).
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             25


[SMTP]           Simple  Mail  Transfer  Protocol.  Request  for  Comments  821.  ARPA

                 Internet  Network  Information  Center  (NIC),  SRI  International

                 (August, 1982).



[TCP]            Transmission Control Protocol. Request for Comments 793 (milstd

                 1778). Appearing in Internet Protocol Transition Workbook, ARPA

                 Internet Network Information Center (NIC), SRI International, 1981.
\f



                                                     Appendix  A

                                                  MH  Commands



               MH is composed of several UNIX programs, which in theory are fairly simple

       and single-purposed.  These commands are functionally grouped below:


                                                    Composing_Mail_________

     comp:     compose a message

               A program to originate a message.  Usually, a special prompting editor front-

               end, prompter, is used to fill-in a composition template with the addressees

               of the message, subject, and so forth.


       dist :  redistribute a message to additional addresses

               A program that re-enters a message previously received by the user into the

               message transport system.  Only new addresses are added; the body of the

               message is not changed in any way.


      forw :   forward messages

               A program that encapsulates one or more messages in a new message draft.

               In addition, the user may add initial and/or closing comments.


       repl :  reply to a message

               A program that constructs a reply to a message using a reply template.  The

               template mechanism has sufficient generality to permit the user to "program"

               the  form  of  the  reply  draft  based  on  the  contents  of  the  message  being

               replied-to.


      send :   send a message

               A  program  that  posts  a  draft  with  the  message  transport  system.   The

               send program is usually invoked by one of the four preceding programs, and

               performs simple front-end pre-processing prior to invoking the post program.

               For  example,  if  invoked  in  push'd  mode,  send  will  immediately  relinquish

               control of the user's terminal and post the message in the background.  If

               the posting fails, send will send back a failure notice to the user.  If the user

               had push'd the sending of the draft, then by default the draft being sent is

               encapsulated in the failure notice.  This permits easy burst'ing of the failure

               notice to retrieve the original draft.  Otherwise, if the posting was successful,

               the draft is marked as having been sent.


whatnow :      prompting front-end for send

               A program which is called by comp, et.  al., after the initial draft has been



                                                             26
\f

           Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             27


                 generated.  The  MH  user  can  specify  a  different  whatnow  program,  which

                 yields considerable extensibility.


      whom:      report to whom a message would go

                 A program which examines the addresses of the draft and expands all user-

                 defined aliases contained therein.  Optionally,  whom may actually interact

                 with  the  message  transport  system  to  determine  the  validity  of  the  final

                 addresses.  This program is also usually invoked by comp, et. al.


                                                        Posting_Mail______

           ali : list mail aliases

                 A simple front-end to the MH aliasing mechanism.


           ap:   parse addresses 822-style

                 A  useful  debugging  tool  for  PostMasters  who  wish  to  examine  how  MH

                 interprets an Internet address.


    conflict :   search for alias/password conflicts

                 Another program used by system administrators to check the consistency of

                 MH alias files, and portions of the local message transport agent.


install-mh:      initialize the MH environment

                 A program which is automatically executed the first time a user issues an MH

                 command.  This program performs once-only initialization of the user's MH

                 environment.


    mhmail :     send or read mail

                 A simple program generally used by other programs to generate messages.

                 The mhmail command is similar in purpose to the old BellMail program.


         post :  deliver a message

                 A  complex  MH  back-end  that  interacts  with  the  local  message  transport

                 agent to enter messages through the posting slot.  (See the description of send

                 above).


                                                        Reading_Mail_______

          inc:   incorporate new mail

                 A program that interacts with the local message transport agent to retrieve

                 messages from the user's maildrop.


    msgchk :     check for waiting mail

                 A program which reports the status of mail waiting in the user's maildrop.


        show :   show (list) messages

                 A program which lists messages to its standard output (usually the user's

                 terminal), possibly invoking another program to do the actual listing.  Most

                 users of MH have show automatically call the mhl program to format the
\f

      Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             28


            message.   The  next  and  prev  programs  are  simply  ``show next''         and

            ``show prev''        , respectively.


    mhl :   produce formatted listings of MH messages

            A program which displays a message as directed by a template.  This permits

            the user to filter out uninteresting headers and re-arrange other headers to a

            particular preference.  In addition to being invoked by show, the mhl program

            is optionally also invoked by forw to format each message being forwarded;

            invoked  by  repl  to  format  the  body  of  a  message  being  replied-to,  if  that

            message is being included in the reply draft; and, invoked by post to format

            a message being sent as a blind-carbon-copy.


   rmm:     remove messages

            A program that removes messages from an MH folder, optionally running a

            user-defined program instead of deleting them.  If no program is given, the

            messages are "softly" removed, so they may possibly be recovered later.


   scan:    produce a one-line-per-message scan listing

            A program that generates a scan listing for messages.  Each line of the listing

            contains date, source, subject, and possibly the initial body of the message.


                                                 Folder_Handling_______

 folder :   set/list current folder/message

            A program used to list information concerning the current folder, or set the

            current folder and/or message.


folders :   list all folders

            A program to list information on all folders (actually, just a special case of

            the folder command).  Since the MH folder structure may be recursive, the

            user can indicate that folders should recursively examine all folders.


   refile:  file message(s) in (an)other folder(s)

            A program to move (or copy) messages from a source folder to one or more

            destination folders.


    rmf :   remove folder

            A program that deletes a folder and all messages therein.


                                                Message_Selection_______

   anno:    annotate messages

            A  program  to  arbitrarily  annotate  messages.  If  the  user  so  desires,  after

            distributing,  forwarding,  or  replying-to  a  message,  MH  will  automatically

            attach an annotation to the original message indicating the date and addresses.


  mark :    mark messages

            A program to manipulate user-defined sequences (lists of messages).  Usually,

            mark is not employed directly by the MH user.
\f

       Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             29


     pick :  select messages by content

             A  program  to  examine  a  list  of  messages  and  choose  those  which  meet

             a  particular  selection  criterion.  The  pick  program  is  often  used  in  UNIX

             back-quoted operations to pass message sequences to other MH commands.


  sortm:     sort messages

             A program to sort a list of messages according to the date given in a particular

             field.


                                           Distribution_List_Handling__________

      bbc:   check on BBoards

             A  front-end  to  run  msh  on  a  list  of  distribution  lists  which  the  user  isn't

             current on.


      bbl :  manage a BBoard

             A  (depreciated)  program  used  to  manually  manage  the  local  archives  of

             a  distribution  list.  These  functions  (archiving,  expunging)  are  performed

             automatically by MH.


   burst :   explode digests into messages

             A program used to decapsulate messages from ARPA Internet digests.  In

             addition,  messages  which  have  been  encapsulated  during  forwarding  (i.e.,

             with forw ) can also be decapsulated using burst.10


     msh:    MH shell (and BBoard reader)

             A  monolithic  program  used  to  implement  MH  commands  on  messages

             arranged in a single file (maildrop format).  Useful since distribution lists are

             kept in this format to minimize consumption of system resources.


    pack :   compress a folder into a single file

             A program which takes messages stored in MH format and places them in a

             single file (using the same format known by msh).


                                      Interface_to_the_UNIX_File_System_____________

mhpath:      print full pathnames of MH messages and folders

             A program which maps MH-style names into the UNIX file naming convention.



     _____________________________________
    10  Similarly, blind-carbon-copies may be decapsulated, though only socially mature users should do

     so.
\f



                                              Appendix  B

                                     Distribution  Mechanics



        The mh.5 distribution is available in two forms:


           1.  Anonymous FTP

               If  you  can  FTP  to  the  ARPA  Internet,  use  anonymous  FTP  to  the

               ARPAnet host UDel-Huey [10.2.0.96] and retrieve the file portal/mh.5-

               tar.  This is a tar image of size 2.1 MB (approximately).


           2.  9-track tape, 1600 bpi, tar format

               Otherwise, you can send $ 50.00 to the address below.  This covers the

               cost of a magtape,  handling,  and shipping.  In addition,  you'll get a

               laser-printed hard-copy of the MH documentation.  The documentation

               includes installation guide, MH Tutorial, MH User's Manual, changes

               document (from mh.4 to mh.5), and BBoards Manual.


               If you go with this option, be sure to include your USPS address with

               your check.  Checks should be made payable to


                                 Regents of the University of California


               It's also a good idea (though not mandatory) to send a computer mail

               message to Bug-MH@UCI when you send your check via USPS to ensure

               minimal turn-around time.  The distribution address is:


                   Support Group

                   Attn:  MH Distribution

                   Department of Information and Computer Science

                   University of California, Irvine

                   Irvine, CA 92717



                   714/856-6852



               Sadly, if you just want the hard-copies of the documentation, you still

               have to pay the $ 50.00.  The tar image has the documentation source

               (the man is in ROFF format, but the rest are in TEX format).


In addition,  there is some hope that mh.5,  or a successor,  might be found in a

future 4.x Berkeley distribution.



                                                      30
\f

  Reprinted from Proceedings, Summer Usenix Conference and Exhibition, Portland, Oregon, June, 1985             31


        Although MH is not "supported" per se, it does have a bug reporting address.

Normally, the address Bug-MH@UCI is used to report bugs and bug fixes.  There are

however, two discussion groups which concern themselves with MH:


           1.  MH-Users@UCI

               A discussion group for the MH user community at large.  Appropriate

               topics include:  questions about how to use MH, tips on MH usage, and

               exchange of MH shell scripts.  All requests to be added to or deleted

               from this list, along with problems, questions and suggestions, should

               be sent to MH-Users-Request@UCI.


           2.  MH-Workers@UCI

               A discussion group for MH maintainers and experts.  Appropriate topics

               include:  questions on how to configure MH, tips on MH configuration,

               exchange of MH bug reports (and fixes).  All requests to be added to or

               deleted from this list, along with problems, questions and suggestions,

               should be sent to MH-Workers-Request@UCI.


The ``UCI''      host is also known as ``ucivax''      , so a possible UUCP path might

be : : :!ucbvax!ucivax!bug-mh.


        Updates to MH are published on the MH-Workers list in the form of context

diffs, and the appropriate distribution images are updated as well.
\f





                                                Contents



                                                                                                         Page

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       1

The MH Philosophy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       2

        The MH Environs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       3

        An MH Transcript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       5

Some MH Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       5

        Message Sequences and Selection  . . . . . . . . . . . . . . . . . . . . . . .       5

        Draft Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       7

        BBoards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .       8

        Bursting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      10

        Distributed Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      11

User Interface Issues in MH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      12

        Creeping Featurism . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      12

        Templates versus Switches. . . . . . . . . . . . . . . . . . . . . . . . . . . .      13

        Modularity versus Monolithicity . . . . . . . . . . . . . . . . . . . . . . . .      17

The MH Distribution  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      17

        Configurable MH  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      18

        Interface to the Message Transport System  . . . . . . . . . . . . . . . . .      20

Concluding Remarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      21

        TODO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      22

References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      24

Appendix A: MH Commands  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .      26

Appendix B: Distribution Mechanics. . . . . . . . . . . . . . . . . . . . . . . . .      30



_____________________________________
This document (version #1.43) was TEXset April 12, 1990 with DISS.STY v103.



                                                       i