Category : UNIX Files
Archive   : UUPC11XD.ZIP
Filename : MAIL.PRN

September 4, 1992 UUPC/extended 1.11v Mail Command
Reference


Revision and Copyright:
Revision and Copyright:
Revision and Copyright:

This is the 67th revision of this document and applies to version
1.11v of UUPC/extended. This document was last updated on
September 4, 1992 by Katherine E. Williams. Portions of this
documentation are Copyright (c) Andrew H. Derbyshire 1989 and
Copyright (c) Kendra Electronic Wonderworks 1990-1992. Full
copyright information for UUPC/extended appears in the file
README.DOC.


Introduction:
Introduction:
Introduction:

This file describes how to invoke and use the UUPC/extended MAIL
MAIL
MAIL
program. It lists the commands available from the question mark
(?) prompt in when reading MAIL. See tilde.hlp for tilde (~)
escape commands available when sending mail.


Command line options
Command line options
Command line options

The MAIL
MAIL
MAIL program is used for both sending and receiving mail.
The options available depend whether you wish to send or receive
mail. For sending mail interactively, the syntax is:

mail -s "subject" addressees

If the -s "subject" is omitted, the user is prompted for a
subject. Addressees must be specified, and are in the form
listed below. For receiving mail, the syntax is:

mail -f filename
mail -u userid

where filename is the mailbox to be read using the syntax
described below for filenames, or userid is the user id whose
system mailbox is to be read. The default is to read your own
system mailbox.


Types of operands
Types of operands
Types of operands

In the list of available commands, items refers to one or more
items in the mail box. These items can be specified in the
following fashion:

Item Number A single numeric value, the special
character dot (.) to specify the current
item, or the special character dollar sign
($) to specify the last item in the mailbox.
Item range Two Item numbers separated by a hyphen (-).
The items must be in ascending order; for
example, 1-$ is valid, $-1 is not valid.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference

List of items A list of item numbers and/or item ranges,
separated by spaces. The list need not be
in ascending order. An example is: 1-5 8 7
14-17.
Asterisk (*) Selects all items in the mailbox
Subject A slash (/) followed by a subject to search
for, optionally followed by a terminating
slash. Each Subject: or Resent-Subject:
will be searched for the specified string.
An example is /UUPC bugs/
User id A single word (no white space) appearing in
the From or Resent-From lines of the mail
header. Note that if the command accepts
both an item and a userid, you cannot
specify the item as a user id.

Note:
Note:
Note: If the command accepts both an item
and file name and you specify a user id for
the item, you must explicitly provide the
default filename unless the user id includes
the characters at sign (@), percent sign
(%), or exclamation point (!).


Some commands also allow file names as operands. These may be
described in the following fashion:

Simple file An MS-DOS file name with no path name
name
Relative path An MS-DOS file name with one or more back
name slashes (\) which does not begin with a back
slash or drive letter.
Absolute path An MS-DOS file name with one or more back
name slashes (\) which begins with a back slash
or drive letter.
Mailbox A simple file name prefixed by the plus sign
(+) character. This will cause the file be
referenced as if it is the mailbox for the
specified user. For example, +postmast
refers to the mailbox for user postmast.
Relative to A simple file name preceded by a tilde and
your home slash (~/). The file is then referenced by
directory the prepending the home directory listed in
your PERSONAL.RC to the simple file name.
Relative to A simple file name preceded by a tilde, the
another's home userid, and a slash (~userid/). The file is
directory. then referenced by the prepending the home
directory listed in the PASSWD file for user
"userid" to the simple file name.


When sending mail from the MS-DOS command line or via the mail
mail
mail or
forward
forward
forward commands, addressees must be entered. These take the
form:



September 4, 1992 UUPC/extended 1.11v Mail Command
Reference

userid A simple user id, for delivery on the
local system.

userid@node A user id and node combination, for
delivery to userid on system node.

nickname A user or list defined in the user's
ALIASES
ALIASES
ALIASES.
.
.TXT
TXT
TXT file.

If the flag -c
-c
-c is inserted before a user id, then all following
users are delivered as Carbon Copy (Cc:) addressees. If the flag
-b
-b
-b is inserted before a user id, then all following users are
delivered as blind carbon copies; their addresses do not appear
in the mail header. The blind carbon copy flag must follow any
all normal addressees and carbon copy addressees.


Commands available when reading mail:
Commands available when reading mail:
Commands available when reading mail:

Commands are entered in response to the mail question mark prompt
(?); all commands must be separated from their operands, if any,
by white space. Most commands can be abbreviated to a single
character; the commands which cannot be so abbreviated and their
shortest allowable abbreviation are debug
debug
debug (deb
deb
deb), dquit
dquit
dquit (dq
dq
dq),
previous
previous
previous (pre
pre
pre), set
set
set (se
se
se), and status
status
status (st
st
st).

The commands supported by UUPC/extended

are as follows:

empty line If the current mail has not been
touched, then an empty line acts as a
print
print
print command; otherwise, it acts as a
next
next
next command.
! command Executes

command as an MS-DOS command.
If command is omitted, runs an
inferior command processor (which
gives the user a new DOS prompt.)
? Prints a summary of commands
available.
+ integer Alias for down
down
down command.
- integer Alias for up
up
up command.
alias a1 a2 a3 Displays alias information loaded from
user's ALIASES
ALIASES
ALIASES.
.
.TXT
TXT
TXT file for nicknames
a1 a2 a3. If an alias is list of
other aliases, the list is recursively
exploded and displayed. This command
has no default operand; at least one
alias must be specified.
copy items file Copies mail items into file with
headers. Default file is the printer
on device PRN
PRN
PRN.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference

debug integer Sets internal trace level to integer;
default is 0 at start up, 1 if command
is entered with no operands. This can
also be set by the command line flag -
-
-
x.
x.
x.
delete items Sets status of to deleted.
items
Deleted items are ignored when
selecting mail by subject or user id,
and are purged from the mailbox when
quit
quit
quit
the command is issued.
dquit items Short for delete
delete
delete followed by quit.
quit.
quit.
exit Exits mail without updating mailbox;
deleted items are left alone. Compare
this to the quit
quit
quit command.
forward items addrs Resends to
items Note that if
addrs.
askcc
askcc
askcc
the option is set, each item
forwarded will be prompted for Carbon
Copy addressees.
items
go Positions to the last of the items
selected.
headers Displays summary information for all
items in the mailbox.
Headers items Displays summary information for the
selected in the mailbox.
items
help Prints this long help text.
subject addrs
mail -s Interactively send mail to addrs with
addrs
mail optional subject.
next integer Move down in mailbox by integer items.
Default is 1.
previous integer Alias of up
up
up command.
items
print Print items from mailbox, using the
external pager if defined in the
configuration file and ignoring (not
printing) a standard list of RFC-822
fields in the mail header such as
Received: and Message-Id:. Compare
this to the Print
Print
Print type
type
type
, , and Type
Type
Type
commands,
,
,
Print items Print from mailbox, using
items
internal pager and ignoring (not
printing) a standard list of RFC-822
fields in the mail header.
quit Terminates the reading of mail. All
deleted items are purged, and all
other items are saved in the original
mailbox or in =mbox depending on the
setting of the flag.
save
save
save
reply items Interactively sends mail to the
authors of each of the items
requested. Note that each item is
replied to separately, specifying
"reply 1-10" will send ten pieces of
mail to ten people.



September 4, 1992 UUPC/extended 1.11v Mail Command
Reference

save items file Saves the specified items complete
with mail headers into file, and then
deletes the items. Compare this to
the copy
copy
copy and write
write
write commands.
set Sets various boolean options. These
option can also be set in your
PERSONAL
PERSONAL
PERSONAL.
.
.RC
RC
RC file. The options are
listed below under SET OPTIONS
SET OPTIONS
SET OPTIONS.
.
.
status Reports miscellaneous program
information, including:

The version and creation time of
the program
The operating system version
The current address and related
information
The current file name, size, and
date last updated

type items Print items from mailbox, using
external pager if available and
displaying RFC-822 fields suppressed
by the print
print
print command. Compare this to
the print
rint
rint, Print
Print
Print, and Type
Type
Type commands,
,
,
Type items Print items from mailbox, using
internal pager and displaying RFC-822
fields suppressed by the print
print
print and
Print
Print
Print commands.
undelete Changes status of items to unread.
write items file Writes items
items
items to file
file
file without the RFC-
822 headers and then deletes them.
The default file is ~/mbox
~/mbox
~/mbox. Compare
this to the copy
copy
copy and save
save
save commands.
xit Alias for the exit
exit
exit command.

Set options
Set options
Set options

In addition to the commands listed above, a variety of options
can be set in the various configuration files; of special note
are the boolean options specified via options=
options=
options= keyword in the
configuration files, as they can be changed via the set
set
set command.
Options are enabled by specifying their keyword, and disabled by
prefixing the keyword with the characters "no"; the default for
all options is disabled.

Valid boolean options which can be set by the user in the UUPC.RC
file, their PERSONAL.RC file, or via the options
options
options command are as
follows:



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


Option Default operation Operation if set
name




askcc The user must enter all After composing, reply
addressees when invoking to, or forwarding mail,
mail
mail
mail forward
forward
forward
or . the user is prompted for
Additional addressees carbon copy (Cc:)
cannot be added to mail addressees.
generated by .
reply
reply
reply


autoedit When sending mail, the If the user has defined
user is presented with an editor, when sending
the line oriented send mail, the editor is
mail interface. To use a immediately invoked for
full screen editor, the the user to enter mail
user must use the ~e
~e
~e with. The user must exit
(edit) command or exit the editor to include
line oriented data entry mail from the active
to invoke his editor. mailbox.


autoincl Do not automatically When the reply command is
ude include the text of mail invoked, automatically
being replied to. include the text of the
mail being replied to as
if the ~m command was
issued.


autosign When sending mail, the If defined in the user's
user's signature file is configuration file, the
not appended to outgoing signature is
mail automatically. If automatically appended to
defined, the user mail all outgoing mail.
still include the file
via the ~g
~g
~g (include
autograph) command.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


backup Do not create a backup of Before updating or
the file being processed deleting the current file
before rewriting or when exiting mail, rename
deleting it. the existing file to the
same file name with the
extension defined by the
configuration variable
BackupExt
BackupExt
BackupExt.

Note:
Note:
Note: If no extension is
defined, a default
extension of "BAK" is
used.


doskey Under DOS, interactive If installed, the MS-DOS
input is read from the 5.0 DOSKEY program is
console using standard used to read input from
DOS services (INT 21H the console; normal
function 0AH). DOSKEY, DOSKEY functions,
if installed, is ignored. including the ability to
Empty input lines are edit and scroll input,
processed normally. along with macro
expansion, is available.
Empty lines (which can be
generated by DOSKEY macro
processing) are ignored
at the command prompt
unless the expert
expert
expert option
is also set.

Note:
Note:
Note: If DOSKEY is not
installed, when the user
is first prompted for
input the doskey
doskey
doskey option
is reset to nodoskey
nodoskey
nodoskey with
a warning message.


dot When sending mail, When sending mail,
interactive input must be interactive input can be
terminated by the DOS end terminated by a single
of file character (Ctrl- period (.) in column one.
Z).



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


expert All informational Boiler plate messages,
messages are displayed, such as the initial help
and if the option
doskey
doskey
doskey prompt, are suppressed,
is also set, empty input and empty input lines are
lines are ignored in not ignored when the
response to the command doskey
doskey
doskey option is set.
prompt.


forward- Mail sent via the forward
forward
forward If the user has defined
save command is not saved in an outgoing mailbox, then
the user's outgoing mail sent via the forward
forward
forward
mailbox. command is saved in the
same fashion as other
outgoing mail.


fromsep Items in the mailbox must Items in the mailbox can
be separated by a line of be separated only by UUCP
binary ones (1). format lines. The
From
From
From
line of binary ones (1)
required between items by
the default operation of
nofromsep
nofromsep
nofromsep is still
generated when updating
mailboxes.

Note:
Note:
Note: This option must be
set in a system or user
configuration file,
because it only examined
at start up.


pager help
help
help print
print
print
, and type
type
type help
help
help
use print
print
print and
, type
type
type use
the external pager if one the internal pager, and
is defined, and Print
Print
Print Print
Print
Print
and Type
Type
Type
and use the
use the in
Type
Type
Type ternal external pager if one is
pager. defined


purge Empty mailboxes are left Empty mailboxes are
in place when the user deleted when the user
exits mail. exits mail.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


save Mail is left in the If mail is not deleted
user's system mailbox from the user's system
after reading. mailbox after reading, it
is automatically saved in
his file when the
~/mbox
~/mbox
~/mbox
user exits mail.


suppress Display the UUPC/extended Suppress the copyright
- copyright notice at notice at program
copyrigh program startup. startup. This, of
t course, does not suppress
the associated
responsibility.

Note:
Note:
Note: This option must be
set in a system or user
configuration file,
because it only examined
at start up.


undelete The environment variable The DELDIR
DELDIR
DELDIR environment
is reset to a null
DELDIR
DELDIR
DELDIR variable is left alone,
string by , causing
UUPOLL
UUPOLL
UUPOLL causing OS/2 to copy all
files deleted by its deleted files to a hidden
children ( UUPOLL
UUPOLL
UUPOLL
,
UUCICO
UUCICO
UUCICO , directory. This causes a
and CLEAN
CLEAN
CLEAN
UU
UU
UU ) to not be performance and free disk
archived by the OS/2 space impact by saving
ing system for
operat files which the user
later recovery. should never have to
access, much recover.

Note:
Note:
Note: This option must be
set in a system or user
configuration file,
because it is only exam-
ined at UUPOLL
UUPOLL
UUPOLL start up.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


verbose When invoked from mail, When invoked from mail,
only displays error
RMAIL
RMAIL
RMAIL rmail displays both error
messages. messages and nominal
status messages,
including the addresses
mail was delivered to.

Note:
Note:
Note: This option must be
set in a system or user
configuration file,
because it only examined
at start up.




The following system oriented options must apply to all users on
a system and can only
only
only be set in the UUPC.RC file:


Option Default operation Operation if set
name




bang RFC-822 headers are RFC-822 headers are
generated with a generated with UUCP style
name"
"User (User name) node!user
format. format.


collect The size of mail is not The RMAIL delivery and
reported by RMAIL. spooling messages include
the size of the files
delivered.


director Mail for "user" is Mail for "user" is
y delivered to the file delivered to the file
in the directory
user newmail in the user sub-
specified by the maildir=
maildir=
maildir= directory of the
line in the system directory specified by
configuration file. the maildir=
maildir=
maildir= line in the
system configuration
file.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


escape Only Ctrl-Break can be If the Esc (Escape) key
used to exit from UUPOLL is pressed, then the next
or UUCICO. time UUPOLL or UUCICO
polls the type-ahead
buffer the program will
act as if Cntl-Break was
pressed.

Note:
Note:
Note: Enabling this
option effectively
disables type-ahead,
since all characters
except Esc are discarded
with an error message.


history No news history is A history is maintained
maintained. of all news articles read
and posted.

Note:
Note:
Note: history
history
history
The option
is currently ignored.


kanji No translation of Mail which orginates
characters takes place locally is translated
during RMAIL processing. from a 2 byte Kanji code
called Shift-JIS
(Japanese ideogram) to
Kanji in a 7bit subset of
ISO2022 which can be
transmitted via SMTP.
Mail from remote systems
which is delivered
locally is translated
from JIS 7bit back to
Shift-JIS.


monocase Job sequence ids are Job sequence ids are
generated in base 62 generated in base 36
using numerics and upper using numerics and upper
and lower case case alphabetics.
alphabetics.



September 4, 1992 UUPC/extended
1.11v Mail Command
Reference


multitas Processing is optimized Additional processing is
k for speed over system performed to insure
integrity. system integrity. This
additional processing
includes creating lock
files to prevent
concurrent access to
system spool directories,
writing program logs to
temporary files and then
appending the file to the
permanent log file at
program termination, and
movng new mail from the
user's system mailbox
into the user's home
directory when is
MAIL
MAIL
MAIL
first run after the new
mail's arrival.


multique When queuing mail for When queuing mail for
ue other hosts, each ad- other hosts, a single
dressee is delivered file delivered via the
separately. remote UUCP can have
multiple addressees.


snews Incoming news is written Incoming news is written
to seperate files in to a file in the Dir
Dir
Dir
News
News
News
directories based on the directory without examing
news group names listed the ACTIVE file.
in the ACTIVE file
located in the NewsDir
NewsDir
NewsDir
directory.


symmetri When actively polling, UUCICO
UUCICO
UUCICO transmits the
grades
c UUCICO
UUCICO
UUCICO does not transmit maximum grade for file
the maximum grade for transfers allowed by the
file transfers allowed by SYSTEMS
SYSTEMS
SYSTEMS file to the
SYSTEMS
SYSTEMS
SYSTEMS
the file to the remote system at startup.
remote system at startup.


syslog No record is made of The file SYSLOG is
files transferred. written in the spool
directory with a record
for each file transferred
to or from the local
system.



September 4, 1992 UUPC/extended 1.11v Mail Command
Reference