Trailing-Edge
-
PDP-10 Archives
-
T20_NETW_DECMAIL_MS_821201
-
documentation/ms.doc
There are 8 other files named ms.doc in the archive. Click here to see a list.
Release Notes for DECmail/MS version 10
Larry Campbell
Internal Software Support Group (DIS/ISSG)
This document reflects DECmail/MS version 10(2123)
October, 1982
1.0 SUMMARY
DECmail/MS is a product which provides TOPS-10 and TOPS-20
users with a sophisticated and flexible electronic messaging capa-
bility (such capabilities are frequently called "electronic mail").
DECmail/MS is the generic name for a software package which includes
the program MS along with some ancillary modules which together pro-
vide a comprehensive multinode mail service (and, in the future,
will provide gateways to other electronic mail systems).
This document describes version 10 of DECmail/MS. This is the
first version to appear as a supported, unbundled product of the
Large Systems Product Line. Earlier versions were developed on an
unfunded basis, largely as a hobby for the developer. DECmail/MS
originated from a similar program developed at SRI International
called MM; the two programs diverged very early on, and today dis-
play only superficial similarities.
Release Notes for DECmail/MS version 10 Page 2
2.0 SUMMARY OF COMPONENTS AND ENVIRONMENT
2.1 Undistributed Components
The DECmail/MS documentation may occasionally refer to some
software components which are not distributed with the official
DECmail/MS tape. These components are EMACS, and VMAIL/VMAILR.
2.1.1 EMACS -
EMACS is an extremely powerful and sophisticated editor, built
at MIT on top of a sophisticated variant of TECO known as ITSTECO.
DECmail/MS has facilities which provide a convenient interface
between DECmail/MS and EMACS.
EMACS is distributed only by MIT, and supported only at their
convenience. Digital neither distributes nor supports EMACS. In
the opinion of this author, though, it is the best editor in
existence today and well worth getting a copy.
2.1.2 VMAIL/VMAILR -
VMAIL and VMAILR are two programs, analagous to NMAIL and
DMAILR (see section 2.4.2.1.1), which provide DECmail/MS users with
the ability to exchange messages with users of VAXmail, the unsup-
ported (and primitive) mail utility which comes with VAX/VMS. These
components are being used internally at DEC while we develop the
real solution to cross-systems mail connectivity. At the present
time, we prefer not to distribute this interim solution, but rather
to concentrate on providing the "correct" and globally acceptable
solution to this problem. Distributing interim hacks runs the risk
of diluting this effort.
2.2 Prerequisite Software
DECmail/MS version 10 runs under TOPS-10, version 7.01 or
later, and under TOPS-20, Release 4 or later. It will run on
KS-10/20 or KL-10/20 processors; it will NOT run on KA-10 or KI-10
processors, and it will NOT run under the TENEX or ITS operating
systems.
Release Notes for DECmail/MS version 10 Page 3
Incompatible changes between versions 4A and 10
3.0 INCOMPATIBLE CHANGES BETWEEN VERSIONS 4A AND 10
(This section is provided for those TOPS-20 sites who may have
obtained a copy of MS version 4A. Since version 10 is the first
version of MS to run under TOPS-10, this section is naturally of
little interest to TOPS-10 users, who will probably wish to skip
it.)
. The command SHOW HEADERS has been removed.
. The command RESTORE-DRAFT has been replaced by RETRIEVE
DRAFT (note the change from a hyphenated command to a
two-word command).
. The SAVE-OUTGOING-MESSAGES command has been replaced by
SAVE OUTGOING-MESSAGES (note the change from a hyphenated
command to a two-word command).
. The HEADERS command has been renamed SUMMARIZE.
. The LIST command has been renamed PRINT.
. The SET HEADERS-PERSONAL-NAME-ONLY command has been renamed
SET SUMMARY-PERSONAL-NAME-ONLY.
. The SET HEADERS-ON-PRINTER-OUTPUT command has been renamed
SET SUMMARY-ON-PRINTER-OUTPUT.
. In the output from the SUMMARIZE command, the "From" and
"Subject" fields are now separated by vertical bar "|" in-
stead of space. This makes the truncation of long "From"
fields look less like a bug.
. Version 4 of MS will not be able to reply to mail sent by
version 10 if the address-list feature was used to send the
mail.
. The command LOGOUT-ON-EXIT has been replaced by SET
LOGOUT-ON-EXIT.
. The name of the "In-reply-to" field has been changed to
"Regarding".
. The SET SHOW-TO-IN-HEADERS-COMMAND has been removed. It is
no longer needed, as its purpose is well served by the new
functionality described in section 5.4 of this document.
Release Notes for DECmail/MS version 10 Page 4
Features added between versions 4A and 10
4.0 FEATURES ADDED BETWEEN VERSIONS 4A AND 10
4.1 Pass-through Support
In conjunction with version 10 of DMAILR, the DECNET mail un-
spooler, you can now send mail to DECNET hosts which are not in your
local DECNET (in DECNET Phase II this means nonadjacent hosts).
DMAILR uses the pass-through service (object type 123 decimal) to do
this. The only change required to MS itself was to accept the new
host table format (PS:<SYSTEM>DECNET-HOSTS.TXT) which now includes
routing information; most of the functionality for this resides in
DMAILR.
4.2 SET SUPPRESSED-HEADERS
This command allows you to specify a list of headers whose dis-
play you wish suppressed while MS is displaying a message. This
command and the SET ONLY-HEADERS-SHOWN command are mutually
exclusive; if both are given, the SET ONLY-HEADERS-SHOWN command
rules.
4.3 Improved SEND Command
The SEND command may now be followed on the same line by a list
of addresses, which will go into the "To" list. If you use this
flavor of SEND, MS will not prompt for a "cc" list, on the
assumption that you are trying to send a message quickly. This
means that the following type of EXEC command will now work:
@MS SEND LCAMPBELL
Note that if MS is given a command on the EXEC command line
which invoked MS (as in the above example), it will not bother to
read and parse your MAIL.TXT unless the command you gave it (or a
command in your init file) references your mail. This means that,
with a very large mail file,
@MS SEND LCAMPBELL
will be considerably faster than
@MS
MS>SEND
To: LCAMPBELL
since, in the second case, MS must read and parse your entire mail
file.
Release Notes for DECmail/MS version 10 Page 5
Features added between versions 4A and 10
4.4 Improved SUMMARIZE (formerly HEADERS) Command
The output from the SUMMARIZE command has been improved. If a
message being listed by the SUMMARIZE command was sent by you (the
user running MS), then instead of displaying the "From" field of the
message in the third column, MS will display the "To" field, pre-
ceded by the word "To". For example, consider the following summary
output from MS version 4:
MS>SUMMARIZE 1:4
1 20-Sep LCAMPBELL This msg is from me (268 chars)
2 20-Sep GRANT This msg is from GRANT (255 chars)
3 20-Sep MILLER This msg is from MILLER (312 chars)
4 20-Sep LCAMPBELL This message is from me (300 chars)
MS>
Version 10 of MS would display the summary like this:
MS>SUMMARIZE 1:4
1 20-Sep To: GRANT |This msg is from me (268 chars)
2 20-Sep GRANT |This msg is from GRANT (255 chars)
3 20-Sep MILLER |This msg is from MILLER (312 chars)
4 20-Sep To: OSMAN, MURPHY, HA|This msg is from me (300 chars)
MS>
The messages marked with "To:" were sent by the current user
(LCAMPBELL) and the field displayed is the "To" field, not the
"From" field. Message number 4 illustrates the case where the "To"
field contains more than one name.
This feature, when used in conjunction with the command
SAVE-OUTGOING-MESSAGES (IN FILE) MAIL.TXT (so that messages you send
are filed in your message file) is particularly helpful in keeping
records of mail conversations. You can keep both incoming and out-
going mail in the same file, and by scanning for the word "To:"
before user names, can quickly see which messages are incoming and
which are outgoing. Since replies generated automatically by the
REPLY command have the same subject string as the original message,
it is easy to collect all messages pertaining to a given conver-
sation together.
Release Notes for DECmail/MS version 10 Page 6
Features added between versions 4A and 10
4.5 SET TEXT-SCROLL-REGION
There is a new display option which can be activated with the
SET TEXT-SCROLL-REGION command. When reading messages with this
option activated, only the message text portion of the message will
be scrolled. The header area will remain on the screen without
moving for easy reference. If the header area is too large, though,
this is annoying, as your text scrolls through an excessively small
window. Thus, if the header area is "too big", MS will scroll the
entire screen. "Too big" currently means that fewer than eight
lines would be left in which to display the message after displaying
the headers. You can change this parameter by giving the SET
TEXT-SCROLL-REGION command with a numeric argument.
4.6 Video Display Now Optional
A new command, SET NO VIDEO-MODE, disables all video display
handling, such as clearing the screen and setting scroll regions.
The default is SET VIDEO-MODE.
The SET VIDEO-MODE command has a useful side effect. It forces
MS to reinitialize all its knowledge of your terminal parameters.
Thus, if you detach from a job running MS and later attach to it
with a different terminal, if you give the monitor command:
TERMINAL <terminal-type>
then continue MS and give MS the SET [NO] VIDEO-MODE command, MS
will be able to continue to do its video display properly because it
now knows that you've changed terminal types.
4.7 Support For New Local Mailer (MAILEX)
The old local mailer, MAILER, is being replaced by an improved
version called MAILEX. MS supports both mailers, but if MAILEX
exists on a system MS uses it. MAILEX provides the following
advantages over MAILER:
. Personal names now go in the "From" field, just as with
network mail, and not in a separate "From-the-terminal-of"
line.
. In messages addressed to both local recipients and
recipients on foreign hosts, all local mail is delivered
locally. Previously it all had to go via the network
mailers.
Release Notes for DECmail/MS version 10 Page 7
Features added between versions 4A and 10
4.8 User-defined Header Items
A "header-item" is a keyword known to MS which serves to iden-
tify a specific piece of information in the header area of a mes-
sage. A header-item consists of an alphanumeric string, which is
the name of the header-item, a colon, and some text which is the
data associated with the header-item. The "To" field is an example
of a header-item which has addresses in its data field.
MS has seven header-items wired into it: Date, To, cc, From,
Subject, Reply-to, and In-reply-to. The DEFINE HEADER-ITEM command
allows users to define their own, new header items.
Header-items come in three flavors: optional, required, or
predefined. An optional header-item is one which MS will not prompt
for when sending, but which may be entered by giving the send-level
command INCLUDE. A required header-item is one which MS will prompt
you for, and require that you supply before allowing you to send the
message. A predefined header-item is one which you've supplied in
the DEFINE command, and will be inserted into the message automatic-
ally.
Here is an example of a user defining the header-item
"Telephone" as a predefined header-item containing his telephone
number:
MS>define header-item Telephone predefined text-string 223-8457
There are currently six types of header-items which may be de-
fined: addresses, dates, date-times, times, text strings, and key-
words. The syntax required to define a header-item is:
define header-item <name> <flavor> <type> <optional-value>
<name> := any alphanumeric string
<flavor> := optional | predefined | required
<type> := date | date-and-time | time | address | text-string | keyword
<optional-value> := value of predefined header-item, or list of
keywords for keyword header-items
To delete the definition of a header-item, give the command
DEFINE HEADER-ITEM <name> with no arguments. To delete all
header-item definitions, give the command DEFINE HEADER-ITEM * (this
is similar to the EXEC's DEFINE command).
The SHOW HEADER-ITEMS command will display all currently de-
fined header-items (except, of course, for those seven wired in to
MS). The INCLUDE command is used at send level to include a
header-item which has been declared optional. The ERASE HEADER-ITEM
command may be used at send level to erase a header-item from the
current draft.
Release Notes for DECmail/MS version 10 Page 8
Features added between versions 4A and 10
4.9 Aliases
Users may define aliases for frequently-used addresses with the
DEFINE ALIAS command. The syntax is as follows:
MS>define alias foo (to be) Long-unwieldy-name at 1031
MS>send
To: foo
cc:
Subject: Hi there
Message:
Just testing...
^Z
As with all other commands, the DEFINE command may appear in
your MS.INIT file. To delete an alias, just define it with a null
address (much like the EXEC's DEFINE command). The command DEFINE
ALIAS * will remove all alias definitions.
An alias may consist of either a single address, or a list of
addresses separated by commas. The command SHOW ALIASES will dis-
play a list of all currently defined aliases and their expansions.
4.10 Address Lists
You may define address lists with the DEFINE ADDRESS-LIST com-
mand. This works almost exactly like DEFINE ALIAS, with one excep-
tion: The name of the list is shown in the mail you send. For
example:
MS>define address-list Small-group (to be) Smith, Jones, Chuck
MS>define address-list Whole-group (to be) Small-group, Fred, Joe
Now, sending mail to "small-group" will produce the following "To"
field:
To: Small-group: Smith, Jones, Chuck;
and sending mail to "whole-group" will produce the following "To"
field:
To: Whole-group: Small-group: Smith, Jones, Chuck;, Fred, Joe;
To delete an address-list definition, give the command DEFINE
ADDRESS-LIST <name> with no argument. To delete all address-list
definitions, give the command DEFINE ADDRESS-LIST *.
Release Notes for DECmail/MS version 10 Page 9
Features added between versions 4A and 10
4.11 SET BRIEF-ADDRESS-LIST-DISPLAY
This command causes MS to only display the outermost name of
any address list in the "To" or "cc" fields of messages being dis-
played. This command may be temporarily overridden with the
VERBOSE-TYPE command, much like the SET ONLY-HEADERS-SHOWN command.
4.12 RETRIEVE LAST-MESSAGE
It sometimes happens that you send a message, MS transmits it
successfully, and then you realize belatedly that something was
amiss; perhaps you forgot to include someone in the address lists.
The RETRIEVE LAST-MESSAGE command retrieves a copy of the last mes-
sage successfully sent and places you at send level, so that you can
correct the problem and try again.
4.13 Host Synonyms (applicable Only To DECNET Systems)
System administrators may elect to provide synonyms for hosts
by altering the DECNET-HOSTS.TXT file on SYSTEM:. To define a
synonym, enter the synonym name, and equals sign (), and the "real"
host name. The real name must already have been defined. For
example, to define the synonym "Gus" for host KL2137,
SYSTEM:DECNET-HOSTS.TXT would contain:
KL2137
Gus=KL2137
For more information in the format of SYSTEM:DECNET-HOSTS.TXT,
refer to the section titled "Installation Instructions".
4.14 System MS.INIT
If SYSTEM: contains an MS.INIT, the commands in it will be
processed by MS upon startup if the user does not have a private
MS.INIT. This is especially useful for defining system-wide
aliases, address-lists, and header-items.
Release Notes for DECmail/MS version 10 Page 10
Features added between versions 4A and 10
4.15 New Message-sequence Selectors
The way you specify a message or messages to MS is by using a
construct called a "message sequence". This can be a list of mes-
sage numbers, or a phrase describing a group of messages by content
(e.g., "from smith", "since April 1"). MS version 10 has several
additional facilities for constructing message sequences.
4.15.1 Select Based On Keywords In The Message -
You can now specify message sequences based on keywords within
the text of the message by saying KEYWORD <text>. For instance, to
read all messages containing the word "foobat", you would say:
MS>read keyword foobat
4.15.2 Sort Based On Date And Time -
The message sequence SORTED (BY) DATE-TIME selects messages in
ascending date-time order.
4.15.3 Mixed Numbers And Keywords -
Previously, if you specified any message numbers explicitly in
a message sequence, you were restricted to only numbers and could
not specify any keywords on the same line. Now you can form message
sequences like:
MS>read 1,5,12:14,flagged
4.15.4 First N Messages - -
You can also select the first n messages by saying:
MS>read first n
Release Notes for DECmail/MS version 10 Page 11
Features added between versions 4A and 10
4.16 Nested Command Files
Command files and init files may now be nested. This means
that you may use the TAKE command inside an init file, or a command
file used by the TAKE command.
4.17 Multiword Usernames
MS will now properly handle usernames composed of multiple
words. Of course, this is not particularly relevant to TOPS-20
users since TOPS-20 does not allow spaces in usernames. It is
useful, though, when sending messages to other systems (such as
MULTICS) which do allow spaces in usernames.
4.18 Extended Host Specifications (path Specs)
An "extended host specification" has the form:
HOST1 at HOST2 at HOST3
These are used either to describe a path in a store-and-forward
messaging environment, or to describe a path which crosses gateways.
MS now supports extended host specifications in the following
manner:
1. If you wish to reply to a message whose "From:" field con-
tains an extended host spec, the REPLY command works. No
special actions are required.
2. Because MS validates hostnames (to allow recognition and to
prevent spelling errors), and because making the names of
all hosts in the world available to MS for validation is
impractical, the following restriction exists when typing
in an extended host spec: the entire address, EXCEPT for
the last hostname and the word "at" immediately preceding
it, must be enclosed in double quotes. For example:
To: "Fred Smith at MULTICS-HOST at ARPA-GATEWAY" at MARKET
MS will remove the quotes before sending the mail, but you
must type them to prevent the command scanner from trying
to parse MULTICS-HOST (which MS's host table has most
likely never heard of).
[End of MS.DOC]