#-h- htc.fmt          868  asc  06-aug-83 11:50:52  system (the system)
.so ~bin/manhdr
.hd Htc (mail) 2-Feb-82
provide help on teleconference topics
.sy
htc [-av] [topic]
.ds
'htc' provides help to users concerning the available
teleconference topics.
If no topic name is specified, the relevant information is displayed for
the general teleconference.
.sp
If the '-a' flag is specified, the appropriate information is displayed
for all known teleconference topics.
Specification of the '-v' flag causes the help information
provided by the teleconference administrator for the
relevant teleconference topic to be displayed instead of its name.
.sp
By default, the topic names in non-verbose mode are displayed in five
columns if the standard output is a terminal and in one column if not.
.fl
~msg/*nfo - the files which contain the help information for the
various topics.
.sa
tc(1) - teleconference reading utility
.di

.au
Joe Sventek
#-h- mail.fmt        1158  asc  06-aug-83 11:50:54  system (the system)
.so ~bin/manhdr
.hd Mail (mail) 11-Nov-81
utility for sending mail to local users
.sy
mail [-b] [-ssubject] address [address]
.ds
`mail' permits a user to send mail to the addresses provided
in the argument list.  It is especially useful for sending mail
from a program, since the body of the message will be read from
standard input.  If the standard input is not redirected, `sndmsg'
is spawned to permit the user to compose the mail.  In addition to
sending a copy of the mail to each address in the command line,
a blind carbon copy is placed in the file author.cpy in the user's
home directory, unless the -b flag has been specified.
.sp
If the `-s' option is specified, the remainder of the command argument
is placed in the "Subject:" field of the message.
If standard input is not redirected and the `-s' option has not
been specified, the user is prompted for the subject string.
.fl
three temporary files are used by mail
.sa
users - a program to list users on current host
.br
postmn - a program which notifies user of existence of mail
.br
msg - the utility for reading and sorting one's mail
.br
sndmsg - create mail utility
.au
Joe Sventek
.bu
#-h- mretry.fmt       908  asc  06-aug-83 11:50:57  system (the system)
.so ~bin/manhdr
.hd Mretry (mail) 18-Mar-82
re-submit mail saved by composition programs
.sy
mretry [file] ...
.ds
`mretry' attempts to re-submit messages which were saved
by `sndmsg' and `mail' when the mail delivery system did not respond
to the delivery request.  (This action should only be necessary if
the mail system was not restarted after a reboot of the system, or if
there is some dire problem with the mail system.)
If no filename is specified, `mretry' looks for the file `dead.ltr' in
the user's home directory, which is the
place where the composition utilities place
dead letters.  If the re-submission is successful, the file is deleted.
.sp
The composition utilities and `mretry' expect the file to have a very
special format, so the `file' argument should only be specified if
the user has renamed ~/dead.ltr.
.fl
~/dead.ltr
.sa
sndmsg - mail composition utility
.di

.au
Joe Sventek
.bu

#-h- msg.fmt         1276  asc  06-aug-83 11:51:00  system (the system)
.so ~bin/manhdr
.hd Msg (mail) 11-Jan-79
utility for manipulating message files
.sy
msg [-fn] [-p[n]] [file]
.ds
`msg' is a message file editor.
The message files which it can work on are those
used by the utility `sndmsg', as well as files created by `msg'.  There are two
files in a user's home directory which are used by `sndmsg' and `msg' - mymail
and mbox.  If `msg' is invoked without a file argument, `msg' will initially
read mymail.  mbox is the file where the messages from mymail are saved
by default.  The -f switch is used to change the number of fill characters
written to the terminal whenever a carriage-return, line-feed pair is
written.  The -p switch can be used to change the page size (number of
lines per screenful) for `msg' to use when displaying long output.  The default
is 22 lines.

A primer is available, and may be had by the execution of the following shell
script:

% msgprim

This will cause a copy of the primer to be displayed on standard output.
.fl
mymail - messages sent using the `sndmsg' utility reside here.
.br
mbox - default file for saving messages from mymail.
.br
one scratch file is used by `msg'.
.sa
sndmsg - the utility for sending mail to other users
.br
msplit - the utility for salvaging message files
.au
Joe Sventek
.bu
#-h- msplit.fmt       792  asc  06-aug-83 11:51:02  system (the system)
.so ~bin/manhdr
.hd Msplit (mail) 11-Jan-79
utility for salvaging message files
.sy
msplit <file [-v] [root]
.ds
msplit reads the standard input file, which presumably has more messages on
it than msg can handle, and splits it up into files which contain a
fixed number of messages.  The files created are named rootaa, rootab, ...,
where root defaults to "tmsg" if none is specified on the command line.  If
the -v (verbose) option is selected, then the name of each file is displayed
on ERROUT as it is created.  You should immediately use msg on these
temporaries to place the messages in appropriate files.  In particular, the
input file to msplit should be overwritten, since it is too large already.
.fl
none
.sa
msg - the utility for reading and sorting one's mail
.au
Joe Sventek
.bu
#-h- postmn.fmt       729  asc  06-aug-83 11:51:05  system (the system)
.so ~bin/manhdr
.hd Postmn (mail) 25-Aug-80
report the presence of mail
.sy
postmn [-h [file]]
.ds
postmn looks to see if the requestor has received any mail.  If so, it reports
that fact upon the standard output file with the comment
.sp
You have Software Tools mail
.sp
If the `-h' flag is specified, the message headers for the messages are
displayed on standard output, instead of the comment above.  If the
optional trailing file name is specified, the headers for the messages in
that file are displayed.
.fl
.sa
.nf
sndmsg - utility for sending mail
msg - utility for reading and filing mail
resolve - utility for querying the mail database about users
users - utility for listing valid mail users
.fi
.au
Joe Sventek
.bu
#-h- resolve.fmt      517  asc  06-aug-83 11:51:07  system (the system)
.so ~bin/manhdr
.hd Resolve (mail) 8-Jun-79
resolve mail system user names
.sy
resolve expression [expression ...]
.ds
resolve searches the mail database for lines matching the text pattern
"expression". (Valid text patterns are the same as for find.)  Resolve
will display on the standard output all lines which match any one of
the given expressions.
.fl
.sa
find - search a file for text patterns
.br
mail - software tools mail facility
.br
users - list users to whom mail may be sent
.di
none
.au
Joe Sventek
.bu
#-h- sndmsg.fmt      5329  asc  06-aug-83 11:51:13  system (the system)
.so ~bin/manhdr
.hd Sndmsg (mail) 11-Nov-81
utility for sending mail to other users
.sy
sndmsg
.ds
`sndmsg' is the utility used to send mail to other users of the mail system.
The user is prompted for all of the necessary input in the following manner:
.sp
.in +5
.ti -3
1. The list of To addresses
.ti -3
2. The list of cc (carbon copy) addresses
.ti -3
3. The list of bcc (blind carbon copy) addresses
.ti -3
4. The subject of the message
.ti -3
5. Whether a return receipt is desired
.ti -3
6. The body of the message
.sp
.in -5
The responses to the To, cc and bcc prompts consist of user-names separated
by commas.
`sndmsg' will continue to prompt for each type of address until it receives
a bare carriage return, signifying end of that list.
The subject field may be a string of any length and content.
.sp
It is possible to request that a return receipt be sent to you when the
addressee(s) first read the message.
This capability is enabled by responding positively (by typing y[es]) to
the prompt
.sp
Do you want a return receipt? [y/n]
.sp
The resulting receipts will be from "THE-MAIL-SYSTEM" and contain the
date, subject and message-id of the original message in the body of
the receipt.
If you did not specify yourself as one of the recipients of the message in
one of the three address lists, your address will be added to the bcc list
by sndmsg; you will be notified of this action when it occurs.
Note that this feature ONLY works if the recipient is also an user of the
Software Tools Mail System.  Recipients on other systems will only see
an extra header line of the form

X-ST-Return-Receipt-Requested:

in the message.
.sp
To create the body of the message, the user is then placed in a simple
command interpreter, which prompts for input as:
.sp
sm>
.sp
Valid inputs to this interpreter are:
.sp
.in +3
.nf
a[ppend]        - append terminal input to message.
b[cc]           - add addresses to Bcc: field.
c[c]            - add addresses to cc: field.
e[dit][ editor] - edit the message using 'editor'.
h[elp]          - print this display.
i[nsert]        - insert terminal input at beginning of message.
l[ist] t[o]/c[c]/b[cc]/h[eader]/m[essage]/a[ll]
q[uit][!]       - quit ... don't send message.
r[ead] file     - include contents of 'file' at end of message.
s[end][!]       - send message and exit.
t[o]            - add addresses to To: field.
?               - synonym for help.
<newline>       - does nothing.
.fi
.sp
.in -3
Any other input results in an error message.
.sp
All of the commands can be truncated to the first character, although
typing more of them is permitted.
The input to the `append' and `insert' commands is terminated when a line
consisting of a single period ('.') is input.
If an editor name is not specified in the `edit'
command, then `ed' is spawned.
When adding addresses with the `to', 'cc' and 'bcc' commands, the dialogue
is identical to that used in the initial prompting sequence.
If the `q' or `s' command is given, the user is asked to verify that the
request was genuine.  This can be eliminated if an exclamation
mark ('!') is appended to the command (`q!' or `s!').
Invocation of the send command causes `sndmsg' to send the message
to the delivery system, and will cause `sndmsg' exit upon the
completion of this request.
If the person(s) you are sending mail to are currently logged in, they
will receive the message
.sp
.ti +5
Software Tools mail has arrived from `<your name>'
.sp
if it is possible to support this feature on your system.
.sp
Addresses:
.sp
.in +2
Valid addresses in response to the To:, cc: and bcc: prompts are of the
form
.sp
.ce 2
name[ at host[ via host] ...]
name[@host[@host]...]
.sp
`name' can be any of the user names displayed by the `users' command, as
well as, any of the alias names found in `~/malias' (the mail alias file
in your home directory) and in `malias' (the alias file in the current
working directory).
When one (or more) host names are specified, the mail delivery system on
each host attempts to send the mail on to the rightmost host, with the
mail eventually being delivered to `name'.
.sp
Comments may be embedded in an address by surrounding the comment with
parentheses, as in
.sp
.ce
j (Joe Sventek) at lbl-unix
.sp
.ti -2
Aliases:
.sp
The format of aliases in ~/malias and malias are:
.sp
.ce
alias_name: address[,address]...;
.sp
If the alias occupies more than one line, a trailing comma (',') indicates
that the alias is continued onto the next line, as for the address lists
given in response to the To:, cc: and bcc: prompts.
.sp
.ti -2
Network operation:
.sp
To determine the valid users on a particular host (<host>), execute the
following command:
.sp
.ce
% echo "users -v" | mail "rmtxeq at <host>"
.sp
Of course, if it is necessary for the user to route the message to <host>,
the appropriate `via host[ via host]...' information can be added to
the above address.
You will receive the output of the users command run on <host> as a return
message.
.in -2
.fl
three scratch files are used by `sndmsg'.
.sa
msg - the message editor
.br
ed - the text editor
.br
users - display valid mail recipients
.au
Joe Sventek
.bu
Previous versions of sndmsg permitted a `print' command at sm> command level.
This command is still legal, and will inform the user to use the

list message

command instead.
#-h- tc.fmt          5119  asc  06-aug-83 11:51:20  system (the system)
.so ~bin/manhdr
.hd Tc (mail) 2-Feb-82
display entries in one or more teleconference topics
.sy
tc [-<n>] {p|t}[v] [topic] [entry] ...
.ds
'tc' permits the user to display the table-of-contents and
the entries of the teleconferences known to the system.
The 'p' command is used to cause the specified entries to be printed
on the standard output, while the 't' command causes the table of contents
of the particular topic to be displayed on standard output.  If the
topic name is not specified, then the general teleconference will be
used.  Legal values for 'entry' are:
.sp
.in +4
.ti -2
n the number of the entry desired
.sp
.ti -4
n-m the range of entry numbers desired.  If 'm' is omitted, the entries from
'n' to the last one will be displayed.  If all of the entries are desired,
specifying "1-" will do the trick.
A colon may be used instead of the dash, as in 3:10.
.sp
.in -4
If no entry numbers are specified, 'tc' will consult the file 'tc.env'
in the user's home directory to determine which entries this user
has seen in the particular teleconference.  If there are any unread
entries, 'tc' will display those.  After reading new entries in the
teleconference with the 'p' command, 'tc' updates the 'tc.env' file to reflect
the last read entry.
.sp
If the special topic name 'all' is used, 'tc' will perform the appropriate
command for all topics listed in the 'tc.env' file.  In this case, only
unread entries will be displayed, ignoring any entries
specified in the command line.
.sp
Before displaying the output of the command to the user, 'tc' checks to
see whether the user has READ access to the particular teleconference.
If not, an appropriate error message is displayed and the program
exits.  The 'htc' utility may be used to gather help information on
a particular topic.
.sp
By default, 'tc' masks the existence of extraneous header lines from the
teleconference entries when displaying them via the 'p' command.  These
header lines are usually inserted by mail delivery agents as the message
wends it way to your system.  If you truly desire to see these additional
lines, a 'v' may be appended to the 'p' command, as in
.sp
.ce
tc pv unix-wizards 748-773
.sp
If the 'v' modifier is specified with the 't' command, it is ignored.
.sp
By default, 'tc' pages the output to the terminal.  It pauses for confirmation
after each entry printed, as well as after every 22 lines within long entries.
If the standard output is not to a terminal, the paging is turned off.  In
addition, the user may change the page size to a terminal with the '-<n>'
switch, where <n> is replaced by the number of lines desired.  Specifying
a value of 0 causes paging to be discontinued.  This switch may be used
anywhere in the command line.
.sp
Submissions to teleconference topics
.sp
To submit an entry to a teleconference, use the `sndmsg' utility to send
the entry to the address:
.sp
.ce
tc_topic
.sp
If the _topic is omitted, the entry will be submitted to the general
teleconference.
One may also send a message to the teleconference guru via using the
following address:
.sp
.ce
tc_topic-request
.sp
Again, if the _topic is omitted, the message is forwarded to the guru
for the general teleconference topic.
.fl
~/tc.env - the user's tc environment file
.br
~msg/topic* - the suite
of files in ~msg which represent the teleconference topic.
.sa
htc(1) - help utility for the teleconference data-base
.br
sndmsg(1) - send message utility
.di
.in +5
.ti -5
Topic does not exist: <topic_name>
.br
An invalid topic name has been specified, either in the command line or the
user has tampered with the tc.env file.
.sp
.ti -5
Read access denied to '<user>' for topic: <topic_name>
.br
The user has attempted to peruse entries in a topic for which he does not
have READ access.
.sp
.ti -5
Invalid list of entries for topic: <topic_name>
.ti -5
Entry list: entry entry entry ...
.ti -5
Bad char:                ^
.br
An invalid entry has been specified in the command line.  tc displays the
entry list, with a caret (^) marking the character which caused the error.
Try again, with the error corrected.
.sp
.ti -5
Cannot open file for teleconference topic: <topic_name>
.br
For some reason, tc could not access the teleconference data-base.  Contact
the system manager concerning this matter.
.sp
.ti -5
Improper format for teleconference file - topic: <topic_name>
.br
Someone or something has tampered with the teleconference data-base file.
Please notify the system manager immediately.
.sp
.ti -5
/directory/tc.env: cannot open
.br
For some reason, tc cannot access your tc environment file.  Please check the
protection mask on the file, as well as whether there is space left on
your chunk of the disk.
.sp
.ti -5
Cannot create temp file for updating tc.env
.br
For some reason, the temp file used to update tc.env could not be created.
Have the system manager check the status of the tools scratch directory
disk.
.sp
.ti -5
Error updating tc.env file
.br
The scratch file with the updated version of tc.env could not be renamed
to tc.env.  Check the protection mask on the file.
.in -5
.au
Joe Sventek
.bu

#-h- users.fmt        935  asc  06-aug-83 11:51:23  system (the system)
.so ~bin/manhdr
.hd Users (mail) 25-Aug-80
list valid mail users
.sy
users [-{<n> | v}]
.ds
`users lists the valid addresses on the current host to whom mail may be
sent.
First, the user names found in ~msg/address are listed, followed by
the aliases found in ~msg/malias.
.sp
Specification of the `-v' flag causes any verbose information associated
with the name or alias to be displayed with the name as a comment string
(see the manual entry for sndmsg for more details).
.sp
In the non-verbose mode, the addresses are displayed in 5 columns if
standard output is to a terminal, or 1 column if not.
Specification of the `-<n>' option forces the output to be displayed
in `<n>' columns.
.fl
~msg/address, ~msg/malias
.sa
.nf
sndmsg - utility to send mail
msg - utility for reading and filing mail
postmn - utility to check for the existence of mail
resolve - utility to query information concering mail users
.fi
.au
Joe Sventek
.bu