From:	CRDGW2::CRDGW2::MRGATE::"SMTP::DRYCAS.CLUB.CC.CMU.EDU::VMSNET-REQUEST" 15-MAR-1991 05:54:17.99
To:	ARISIA::EVERHART
CC:	
Subj:	Mail_uucp.hlp in runoff format

From:	vmsnet-request@DRYCAS.CLUB.CC.CMU.EDU@SMTP@CRDGW2
To:	everhart@arisia@MRGATE

Received:  by crdgw1.ge.com (5.57/GE 1.91)
	 id AA14035; Fri, 15 Mar 91 05:40:38 EST
Resent-From: vmsnet-request@DRYCAS.CLUB.CC.CMU.EDU
Resent-Message-Id:  <9103151040.AA14035@crdgw1.ge.com>
Return-Path: uucp@mccall.uucp
Received: from harris.cis.ksu.edu by DRYCAS.CLUB.CC.CMU.EDU with PMDF#10209;
 Fri, 15 Mar 1991 05:32 EST
Received: from deimos.cis.ksu.edu by harris.cis.ksu.edu (5.58) id AA00811; Fri,
 15 Mar 91 04:31:25 CST
Received: by deimos.cis.ksu.edu (5.58a-3B15) id AA04701; Fri, 15 Mar 91
 04:45:15 EST
Received: by mccall.com (DECUS UUCP /1.3-1/2.5/); Fri, 15 Mar 91 00:25:58 CST
Resent-Date: Fri, 15 Mar 1991 05:32 EST
Date: 14 Mar 91 20:03:01 GMT
From: ake@dayton.saic.com (Earle Ake)
Subject: Mail_uucp.hlp in runoff format
To: mccall!vmsnet-newsgate
Errors-To: vmsnet-request@DRYCAS.CLUB.CC.CMU.EDU
Reply-To: vmsnet@DRYCAS.CLUB.CC.CMU.EDU
Message-Id: <1991Mar14.160301.1535@dayton.saic.com>
X-Vms-To: vmsnet-newsgate@mccall.uucp
Organization: Science Applications Intl. Corp., Dayton, Ohio


	Kent Brodie had written a file called mail_uucp.hlp which could be
installed in the library sys$help:mailhelp.hlb to provide online help while
in mail.  I decided to take that one step further and converted it to runoff
format so the help was nicely formatted.  The right edge of the text is not
jagged anymore.  Here is the rnh file for producing the hlp file.  Instructions
are at the top of the included file in comments.


Earle
_____________________________________________________________________________
             ____ ____    ___
Earle Ake   /___ /___/ / /     Science Applications International Corporation
           ____//   / / /__                 Dayton, Ohio
-----------------------------------------------------------------------------
Internet: ake@dayton.saic.com        uucp: dayvb!ake         SPAN: 28284::ake


$! ------------------ CUT HERE -----------------------
$ v='f$verify(f$trnlnm("SHARE_VERIFY"))'
$!
$! This archive created by VMS_SHARE Version 7.2-007  22-FEB-1990
$!   On 14-MAR-1991 13:31:16.42   By user AKE (Earle Ake - SAIC (513) 429-6500)
$!
$! This VMS_SHARE Written by:
$!    Andy Harper, Kings College London UK
$!
$! Acknowledgements to:
$!    James Gray       - Original VMS_SHARE
$!    Michael Bednarek - Original Concept and implementation
$!
$! TO UNPACK THIS SHARE FILE, CONCATENATE ALL PARTS IN ORDER
$! AND EXECUTE AS A COMMAND PROCEDURE  (  @name  )
$!
$! THE FOLLOWING FILE(S) WILL BE CREATED AFTER UNPACKING:
$!       1. MAIL_UUCP.RNH;4
$!
$set="set"
$set symbol/scope=(nolocal,noglobal)
$f=f$parse("SHARE_TEMP","SYS$SCRATCH:.TMP_"+f$getjpi("","PID"))
$e="write sys$error  ""%UNPACK"", "
$w="write sys$output ""%UNPACK"", "
$ if f$trnlnm("SHARE_LOG") then $ w = "!"
$ ve=f$getsyi("version")
$ if ve-f$extract(0,1,ve) .ges. "4.4" then $ goto START
$ e "-E-OLDVER, Must run at least VMS 4.4"
$ v=f$verify(v)
$ exit 44
$UNPACK: SUBROUTINE ! P1=filename, P2=checksum
$ if f$search(P1) .eqs. "" then $ goto file_absent
$ e "-W-EXISTS, File ''P1' exists. Skipped."
$ delete 'f'*
$ exit
$file_absent:
$ if f$parse(P1) .nes. "" then $ goto dirok
$ dn=f$parse(P1,,,"DIRECTORY")
$ w "-I-CREDIR, Creating directory ''dn'."
$ create/dir 'dn'
$ if $status then $ goto dirok
$ e "-E-CREDIRFAIL, Unable to create ''dn'. File skipped."
$ delete 'f'*
$ exit
$dirok:
$ w "-I-PROCESS, Processing file ''P1'."
$ if .not. f$verify() then $ define/user sys$output nl:
$ EDIT/TPU/NOSEC/NODIS/COM=SYS$INPUT 'f'/OUT='P1'
PROCEDURE Unpacker ON_ERROR ENDON_ERROR;SET(FACILITY_NAME,"UNPACK");SET(
SUCCESS,OFF);SET(INFORMATIONAL,OFF);f:=GET_INFO(COMMAND_LINE,"file_name");b:=
CREATE_BUFFER(f,f);p:=SPAN(" ")@r&LINE_END;POSITION(BEGINNING_OF(b));
LOOP EXITIF SEARCH(p,FORWARD)=0;POSITION(r);ERASE(r);ENDLOOP;POSITION(
BEGINNING_OF(b));g:=0;LOOP EXITIF MARK(NONE)=END_OF(b);x:=ERASE_CHARACTER(1);
IF g=0 THEN IF x="X" THEN MOVE_VERTICAL(1);ENDIF;IF x="V" THEN APPEND_LINE;
MOVE_HORIZONTAL(-CURRENT_OFFSET);MOVE_VERTICAL(1);ENDIF;IF x="+" THEN g:=1;
ERASE_LINE;ENDIF;ELSE IF x="-" THEN IF INDEX(CURRENT_LINE,"+-+-+-+-+-+-+-+")=
1 THEN g:=0;ENDIF;ENDIF;ERASE_LINE;ENDIF;ENDLOOP;t:="0123456789ABCDEF";
POSITION(BEGINNING_OF(b));LOOP r:=SEARCH("`",FORWARD);EXITIF r=0;POSITION(r);
ERASE(r);x1:=INDEX(t,ERASE_CHARACTER(1))-1;x2:=INDEX(t,ERASE_CHARACTER(1))-1;
COPY_TEXT(ASCII(16*x1+x2));ENDLOOP;WRITE_FILE(b,GET_INFO(COMMAND_LINE,
"output_file"));ENDPROCEDURE;Unpacker;QUIT;
$ delete/nolog 'f'*
$ CHECKSUM 'P1'
$ IF CHECKSUM$CHECKSUM .eqs. P2 THEN $ EXIT
$ e "-E-CHKSMFAIL, Checksum of ''P1' failed."
$ ENDSUBROUTINE
$START:
$ create 'f'
X.! File: mail_uucp.rnh
X.!
X.! This runoff help file is meant to expand on the information available
X.! to the mail user.  It provides him with information on sending mail throu
Vgh
X.! the uucp mail handler, mail addressing, and signature files.  To make thi
Vs
X.! help text available when the user types 'HELP' while in mail, do:
X.!
X.! $ runoff mail_uucp.rnh
X.! $ library/help/log sys$help:mailhelp mail_uucp.hlp
X.!
X1 Internet
X.br
X VMS MAIL on this system may be used to send and receive mail to the`20
X worldwide uucp (uucp to uucp copy) and Internet networks, and to other`20
X networks gatewayed to them.  See the UUCP topic for more details.`20
X.br
X1 UUCP
X.br
X VMS MAIL on this system may be used to send and receive mail to the`20
X worldwide uucp (uucp to uucp copy) and Internet networks, and to other`20
X networks gatewayed to them. `20
X.br .rm -2
X2 Sending__Mail
X.br
X Users on uucp and Internet sites generally have addresses of the form
X.bl .lm +8
Xusername@systemname
X.bl .lm -8
X where "systemname" is usually (but not always) a series of names separated`
V20
X by dots, e.g.
X.bl .lm +8
Xjeh@crash.cts.com
X.bl .lm -8
X To send mail to such an address, use VMS MAIL in the usual way, but answer
X the "To:" prompt with an entry of the form UUCP%"username@systemname".
X For example,`20
X.bl .lt
X        MAIL> send
X        To:     UUCP%"jeh@crash.cts.com"
X        Subj:   this is a test
X.el .bl
X This format is specific, and the quotes must be used exactly as
X shown in the examples.  A missing trailing quote will cause VMSmail`20
X to exit with an error message (earlier versions would simply hang;
X type ctrl-Y to escape). `20
X.bl
X Some uucp users have "bang form" addresses which consist of a series of
X uucp hostnames, separated by !'s (which are pronounced "bang" when reading
X such addresses aloud), with their username at the end, as in`20
X.bl .lm +8
Xdecwrl!simpact!jeh
X.bl .lm -8
X These addresses may also be used, as follows:
X.bl .lt
X        MAIL> send
X        To:     UUCP%"decwrl!simpact!jeh"
X        Subj:   this is a test
X.el .bl
X See the "Addressing" topic for information on more complex addresses.
X.br
X2 Receiving__Mail
X.br
X To tell people how to send mail to you, you will have to give them your
X network address.  In the Internet address form
X.bl .lm +8
Xuser@system
X.bl .lm -8
X the "user" part is simply your VMS username.  The "system" part is,`20
X however, *not* the local DECnet nodename (at least not usually). `20
X.bl
X To find out your system's name in Internet terms, issue the following`20
X command from the DCL prompt:
X.bl .lm +8
X$ SHOW LOGICAL UUCP__DOMAIN__NAME
X.bl .lm -8
X The translation of this logical name is your system's name from the`20
X Internet's point of view.  Thus, if this name translates to the string`20
X.bl .lm +8
Xcrash.cts.com
X.bl .lm -8
X (it won't, because that name is already in use, but never mind; this is`20
X just an example), and your user name is JSMITH, your network address is
X.bl .lm +8
Xjsmith@crash.cts.com
X.bl .lm -8
X When you send network mail, you usually want your recipient to be able`20
X to reply to you.  The uucp mailer will automatically precede your`20
X message with an Internet-compatible "From:" line that shows your address;`2
V0
X this will usually allow replies to work correctly.  However, some network`2
V0
X "gateways" modify the "From" information in such a way as to make the`20
X mail unreplyable.  It is therefore advisable to include your network`20
X address in the text of your message (usually as part of your "signature";`2
V0
X see the entry for "Signatures").
X.br
X2 More__on__Addressing
X.br
X For most Internet sites, anywhere that VMSmail asks for an address, you can
X respond with`20
X.bl .lm +8
X        UUCP%"user@site"
X.bl .lm -8
X where site is usually something like machine.organization.domain,
X but may be as simple as a uucp host name, and user is a username on`20
X that system.
X.bl
X A series of uucp addresses may be used, separated by commas, and possibly
X mixed with local and remote (reached via DECNet) user names, as follows:
X.bl .lt
X        MAIL> send
X        To:     UUCP%"jeh@crash.cts.com",UUCP%"ta2@esther",LABVAX::SYSTEM
X        Subj:   this is a test
X.el .bl
X Under VMS Version 5, uucp addresses may also be used in response to the CC:
X prompt.
X.bl
X If someone gives you an address like
X.bl .lm +8
Xremhost!user
X.bl .lm -8
X you can generally use a VMSmail "To:" address of
X.bl .lm +8
XUUCP%"user@remhost"
X.bl .lm -8
X If you get something in the more complex form shown previously,
X.bl .lm +8
Xwell-known-host!intermediate-host!...!...!theirhost!user
X.bl .lm -8
X you can try sending to UUCP%"user@theirhost" first; if that
X doesn't work, just wrap UUCP%"..." around the whole mess.  You
X needn't worry about how to get to well-known-host:  If it's
X well-known it'll be in the maps, and the mailer will figure out
X the path from your system.
X.bl
X If your addressee has given you an address like
X.bl .lm +8
X`7Bwkh1, wkh2, wkh3`7D!theirhost!user
X.bl .lm -8
X you cannot pass this to Mail directly.  What they are telling you is
X that each of the systems wkh1, wkh2, and wkh3 talk to theirhost, but
X you are supposed to figure out how to get to one of the "well-known-
X hosts" mentioned (your choice as to which).  So try something like
X.bl .lm +8
XUUCP%"wkh2!theirhost!user"
X.bl .lm -8
X The aforementioned techniques will often fail for @-form addresses when
X networks other than uucp or Internet are involved (and sometimes
X even then).  This is particularly true of Bitnet, which uses
X Internet-style addresses and otherwise looks like part of the
X Internet, but isn't really.
X.bl
X The general solution is to "send the mail through a gateway".  A
X later version of this document will expound upon the
X possibilities.  For now, refer to the files in `5B.DOC.ADDRESSING`5D,
X which are mostly a collection of questions and answers on these
X issues that have appeared on the net.  If you do not have access
X to these files (or don't know exactly where they are), contact your
X uucp system manager.
X.bl .rm -2
X3 Percent__Signs
X.br
X Many addresses include imbedded percent signs; for example:
X.bl .lm +8
XTNIELAND%FALCON@AAMRL.AF.MIL
X.bl .lm -8
X There are differences of opinion as to how this should be
X interpreted.  In general it usually is interpreted with
X everything to the left of the "@" as being a "funny username", so
X the mail is sent to
X.bl .lm +8
XTNIELAND%FALCON###at###AAMRL.AF.MIL
X.bl .lm -8
X on the assumption that aamrl.af.mil will know what to do with it.
X (In this particular case, they do.)
X.bl
X Troubles may arise when addresses of this form are handed to uucp
X (any uucp, not just ours).  For uucp transmission we must convert
X everything to bang-path notation, so we end up with something
X like
X.bl .lm +8
Xneighbor!...!AAMRL.AF.MIL!TNIELAND%FALCON
X.bl .lm -8
X This works fine when I send mail to this address (actually I send
X to UUCP%"TNIELAND%FALCON@AAMRL.AF.MIL"), but Tom Allebrandi's
X uucp "neighbor" hates to see !'s and %'s in the same address, and
X either bounces it as undeliverable or does horrible things to it.
X Tom gets around this by converting the % to a !  himself, sending
X to
X.bl .lm +8
XUUCP%"FALCON!TNIELAND@AAMRL.AF.MIL"
X.bl .lm -8
X This workaround succeeds in this particular case because aamrl
X knows to handle falcon!tnieland just as it would handle
X tnieland%falcon.  In the general case, success depends on the
X capabilities of the target Internet host.  The entry on "mixed__addresses"
X discusses addresses of this form in more detail.
X.br
X3 Mixed__Addresses
X.br
X Sometimes you will see an address of the form
X.bl .lm +8
Xuuhost!user@inethost.company.com
X.bl .lm -8
X Such an address, combining "!" and "@" notation (with maybe some
X "%"s thrown in for good measure), is referred to as a "mixed
X mode" address.  These addresses are often used by uucp sites
X (uuhost in this example) who do not have registered domain names,
X but have a uucp connection to a nearby host
X (inethost.company.com) who does.  In general more sites will know
X how to get to inethost.company.com than to uuhost, so they are
X trying to make it easy for people to send mail to them.
X.bl
X If someone -- particularly someone on the Internet -- is having
X trouble sending mail to you, you might try telling them to use
X such an address.  For example, if you know of an Internet site
X (isite.dom.ain) that reaches you reliably via uucp, you might
X suggest that they try
X.bl .lm +8
Xyourhostname!you@isite.dom.ain
X.bl .lm -8
X meaning "send mail to isite.dom.ain, who will send it to
X yourhostname!you".
X.bl
X Addresses of this form should not, in general, be published "at
X large" as your "standard" address, but only given out to
X individual correspondents to solve particular problems.  DECUS
X uucp will generally do the right thing when asked to send mail to
X an address like this, but this is not true of all other uucp
X systems.  This is because the interpretation of such an address
X as a mail destination varies depending on the machine sending the
X mail.
X.bl
X Using the second example above:  If the machine from which mail
X is being sent to you understands "@"-signs (as DECUS uucp
X machines do), this address is equivalent to
X.bl .lm +8
Xisite.dom.ain!yourhostname!you
X.bl .lm -8
X meaning "send it to isite.dom.ain, who will send it to
X yourhostname!you, which is what you want.  (In practice there
X will probably be some additional hosts in the bang-path prior to
X isite.dom.ain .)  But a "pure uucp" machine might send it this
X way:
X.bl .lm +8
Xyourhostname!isite.dom.ain!you
X.bl .lm -8
X which is obviously wrong, since the pure uucp machine likely
X doesn't talk to yourhostname.  (If they do, they can just send to
X yourhostname!you and avoid all this bother.)  Even if the message
X does get to yourhostname, this address tells yourhostname to send
X it to isite.dom.ain, and you don't live there!
X.bl
X So, in general, it is a bad idea to publicize addresses of this
X form.  If you want an "@" in your e-mail address, make sure your
X site is an Internet domain.  Contact your System Manager for
X assistance in finding out if your site has been set up in this manner.
X.br .rm +2
X2 Signature__files
X.br
X The majority of uucp users usually include a "signature" file at the
X end of their message.  This helps better identify the person sending
X the message.   Information included usually states the person's
X name, their company, their e-mail address, and possibly a phone number.
X.bl
X This is usually done as a courtesy, so if someone wants to reply to
X your mail and can't, they can still reach you some way.
X.bl
X This is done many ways in VMS mail, the simplest being creating a
X small "signature" file (say SIGNATURE.TXT), and using the /EDIT qualifier
X when sending mail.   Then, at the end of the message, use the editor
X INCLUDE command to add this text at the end of the message.
X.br .rm -2
X3 Examples
X.br
X Here are a few "signature" files.     There is no "format", you are
X free to do whatever you wish.  I include these only to help new users.
X.bl
XThis first example is my own.   I like to keep it simple, and
XI've chosen to include an amusing quote at the end....
X.bl .lt
X -------------------------------------------------------------------
X Kent C. Brodie - Systems Manager`09`09brodie@mcw.edu
X Medical College of Wisconsin`09`09`09+1 414 778 4500
X
X "Gee, I hope these are the right coordinates..." -Chief O' Brien; STTNG
X.el .bl 2
X      This second example belongs to Jamie Hanrahan (one of the co-authors
X      of DECUS uucp).   Jamie provides more information than I do.
X.bl .lt
X       --- Jamie Hanrahan, Simpact Associates, San Diego CA
X Chair, VMSnet and Internals Working Groups, DECUS VAX Sytems SIG`20
X Internet:  jeh@simpact.com, or if that fails, jeh@crash.cts.com
X Uucp:  ...`7Bcrash,scubed,decwrl`7D!simpact!jeh
X.el .br .rm +2
X2 Logical__Names
X.br
X The uucp mailer recognizes the following logical name:
X.bl .lm +8
XUUCP__PERSONALNAME
X.bl .lm -8
X This logical may be equated to a string which the mailer will attach to`20
X your address on outgoing mail.  If defined, this logical will override`20
X the personal name you've defined within VMSmail; this allows you to have
X different personal names for network vs. local mail. `20
X.bl
X If the NEWS__PERSONALNAME logical is defined, the uucp mailer will use it
X in preference to UUCP__PERSONALNAME; therefore, if you've defined your`20
X personal name for NEWS, you needn't define it again for uucp mail. `20
X.br
X2 NEWS
X.br
X The VMS uucp implementation supports "netnews", a worldwide conferencing
X system.  See your system manager for more information. `20
X.br
X2 Acknowledgements
X.br
X "DECUS uucp", as it is known, was developed by the VMSNET
X working group, which is a part of the DECUS organization.
X.bl
X Although many people have done work on this package (and
X various utilities/parts of previous versions), the
X following three people organized their efforts to make this
X a complete package available to the general DECUS user
X community.   All three programmers involved would love to
X hear comments about their work!
X.bl .lt
X Jamie Hanrahan      Tom Allebrandi II             Mark Pizzolato
X Simpact Associates  Inland Steel, Inc.            Infocomm
X jeh@crash.cts.com   allebrandi@inland.com         mark@infocomm.com
X.el .bl
X This HELP file was written by:
X.bl .lt
X Kent C. Brodie
X Medical College of Wisconsin
X brodie@mcw.edu
X.el
$ CALL UNPACK MAIL_UUCP.RNH;4 1716066259
$ v=f$verify(v)
$ EXIT
