Subject: Mail help file for MX Date: Thu, 14 Mar 1991 08:14:07 Message-ID: <2177020@MVB.SAIC.COM> From: Earle Ake - SAIC X-VMS-TO: MVB::"madison@vms.ecs.rpi.edu" To: madison@vms.ecs.rpi.edu Matt, I adapted Kent Brodie's help file that he wrote for DECUS uucp to be included with MX. I asked his permission to use it and he said I could. 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 11:13:50.20 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. MX_MAIL.RNH;25 $! $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: mx_mail.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 MX mail handler, mail addressing, and signature files. To make this X.! help text available when the user types 'HELP' while in mail, do: X.! X.! $ runoff mx_mail.rnh X.! $ library/help/log sys$help:mailhelp mx_mail.hlp X.! X.lm 0 .rm 76 X1 Internet X.br XVMS MAIL on this system may be used to send and receive mail to the`20 Xworldwide uucp (uucp to uucp copy), bitnet, Internet, Xand to other networks gatewayed to them. See the MX topic for more Xdetails.`20 X.br X1 MX X.br XMX - Message Exchange X.bl XMessage Exchange (MX) is software that provides store-and-forward Xrouting and delivery of electronic mail messages. MX can be used to enhance Xlocal electronic mail (E-mail) support, and it can be used with several kind Vs Xof network protocols to provide a unified E-mail interface to Xdifferent networks. X.bl XVMS MAIL on this system may be used to send and receive mail to the`20 Xworldwide uucp (uucp to uucp copy), bitnet, Internet, and to other`20 Xnetworks 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 Xmadison@rpiecsvx.bitnet 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 MX%"username@systemname". X For example,`20 X.bl .lt X MAIL> send X To: MX%"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: MX%"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 MX__NODE__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 MX 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 XMX%"user@site" X.bl .lm -8 X where site is usually something like machine.organization.domain, X but may be as simple as a internet host name, and user is a username on`20 X that system. X.bl X A series of MX 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: MX%"jeh@crash.cts.com",MX%"ta2@esther.uucp",LABVAX::SYSTEM X Subj: This is a test X.el .bl X Under VMS Version 5, MX 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 XMX%"user@remhost.uucp" X.br .lm -8 .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.br .rm +2 X2 Signature__files X.br X The majority of mail 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 XThe MX/VMS MAIL interface provides support for "signature" files. Once you Xhave created a signature file, you inform MX of its existence by defining Xthe logical name MX__SIGNATURE: X.bl .lm +8 X$ DEFINE MX__SIGNATURE device:`5Bdirectory`5Dname.type X.bl .lm -8 XYou can then have the signature included in your message by entering the lin Ve X.bl .lm +8 X/SIGNATURE X.bl .lm -8 Xin your message. To be recognized, there can be no other text on the line Xand no leading blanks. Case is not important, and you can abbreviate SIGNATU VRE Xto SIG. Your signature file will be inserted in the message at the point Xwhere you place the /SIGNATURE line. To enable your signature file every Xtime you login, include the DEFINE command in your login command procedure. 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 X.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 "Gee, I hope these are the right coordinates..." -Chief O' Brien; STTNG X.el X.bl 2 XThis second example belongs to Jamie Hanrahan (one of the co-authors Xof DECUS uucp). Jamie provides more information than I do. X.bl X.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 X.br .rm +2 X2 Acknowledgements X.br .rm -2 X3 DECUS__uucp 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 X.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 X3 MX X.br XI wish to thank Matt Madison for giving us such a useful product as MX. XIt has made my life much easier since it allows me to link SMTP mail Xwith DECUS uucp mail. I would also like to thank him for listening to Xall the comments and suggestions the beta testers and users of MX have sent V him. X.bl XThe author of MX: X.bl X.lt XMatt Madison X XEngineering Computing Services X XRensselaer Polytechnic Institute X XInternet: madison@vms.ecs.rpi.edu XBITNET: madison@rpiecsvx.bitnet XDECUSserve: MADISON X.el X.br X3 This__help__file X.br X This HELP file was originally written for DECUS uucp by: X.bl X.lt X Kent C. Brodie X Medical College of Wisconsin X brodie@mcw.edu X.el X.bl X This HELP file was modified for MX by: X.bl X.lt X Earle F. Ake X Science Applications Intl. Corp. X ake@dayton.saic.com X.el $ CALL UNPACK MX_MAIL.RNH;25 89287313 $ v=f$verify(v) $ EXIT -------------------------------------------------------------------------------- Return-Path: <@mdmvs.ecs.rpi.edu,@vms.ecs.rpi.edu:AKE@DAYVAX.SAIC.COM> Received: from vms2.ecs.rpi.edu by mdmvs.ecs.rpi.edu (MX V2.2-1) with SMTP; Thu, 14 Mar 1991 11:18:06 EST Received: from MVB.SAIC.COM by vms.ecs.rpi.edu (MX V2.2-1) with SMTP; Thu, 14 Mar 1991 11:16:21 EST Received: from MVB.SAIC.COM by MVB.SAIC.COM (CHCS-MailMan V7.2) with SMTP id 2177020; Thu, 14 Mar 1991 08:14:07 PST Received: from DAYVAX.SAIC.COM by MVB.SAIC.COM with DECnet; Thu, 14 Mar 1991 08:14:07 PST