SMAIL026.D SMAIL026.DkBACKUP SMAIL_MANUAL.MSS,SMAIL_MANUAL.PS,SMAIL_INSTALL.MSS,SMAIL_INSTALL.PS SMAIL026.D/SAVE/INTER/BLOCK=2048 SYNFUL zV4.7 _CMU063::  _DUA0: V4.7   *[CMU063.SMAIL]SMAIL_MANUAL.MSS;1+,.-/ 4K-+-0123KPWOC56`noǠ7@Ǡ89GHJ@Begin(Comment)A ****************************************************************0 Copyright (c) 1992, Carnegie Mellon University All Rights Reserved@ Permission is hereby granted to use, copy, modify, and@ distribute this software provided that the above copyright@ notice appears in all copies and that any distribution be for noncommercial purposes.@ Carnegie Mellon University disclaims all warranties with regard@ to this software. In no event shall Carnegie Mellon University@ be liable for any special, indirect, or consequential damages@ or any damages whatsoever resulting from loss of use, data, or@ profits arising out of or in connection with the use or performance of this software.A **************************************************************** @End(Comment) @Make(Manual)@Device(PostScript)@Begin(Comment) SMAIL.MSS. Copyright (C) 1987 Carnegie Mellon University Description:: This is the source for the SMAIL Utility RezR SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-ference Manual Written By:" Dale Moore 08-DEC-1987 CMU-CS/RI Modifications: @End(Comment)@Style(FontFamily TimesRoman)@Style(Indent 0)@LibraryFile(Stable)9@Define(Command,Use HD1, PageBreak Before, Above 0.4inch) @Define(CommandSection, Use HD2)#@Define(CommandSubSection, Use HD4)5@Define(CommandSyntax, Use Format, LeftMargin +1inch, AfterEntry "@TabDivide(2)")@Modify(Example, Size -2)@Begin(Comment)*@Include(SYS$USER:[MOORE.DOC]FACILITY.MSS)@FacilityTitlePage(Title="SMAIL User Manual",Author="Dale Moore",File="", internal) @End(Comment)@PrefaceSection (Preface)@Heading "Intended Audience"&This manual is intended for all users.BThis manual describes how to use the SMAIL utility and the variouscommands available.CSMAIL is a utility for creating, modifying mail messages to be sent=to other internet hosts. The SMAIL attempts to intelligentlyEmodify a message provided by the user to conform to the specificationDpresented in @I"RFC 822 Standard for the Format of the ARPA InternetText Messages".FThe user must have the ability to run a text editor of their choosing.%@Heading "Structure of This Document"This document has two sections.8The first section is an overviw of the SMAIL utility andhow to invoke the utility.;The second section covers the commands that can be given tothe FTP utility.9@Comment (@Paragraph "Conventions Used in This Document")%@Chapter "Invoking the SMAIL Utility"4This chapter covers ho~9 SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-fw to invoke the SMAIL utility.@Command "SMAIL"BThe SMAIL utility is used to create, modify, and queue for sendinga single mail message.@CommandSection "Format"@Begin(CommandSyntax)>SMAIL @i"[message-file]" @i"[user-address [,user-address...]]"@End(CommandSyntax)'@CommandSubSection "Command Parameters"@SubHeading "message-file"DSpecifies an optional file containing message text to be sent to thespecified user(s).>No wild card characters are allowed in the file specification.@SubHeading "user-address"DSpecifies one or more users to receive the message. If theEfile-spec parameter is specified. Recipient names are of the formUsername@@Host.!@CommandSubSection "UsageSummary"DTo use the SMAIL utility interactively enter the follwing command inresponse to the DCL prompt:@Begin (Example)$ SMAIL@End (Example)"The response that you will see is:@Begin(Example)'%SMAIL-W-TO_EMPTY, 'To:' field is emptySMAIL> @End(Example)KTo exit from the SMAIL utility, enter the quit command at the SMAIL prompt.@Begin(Example) SMAIL> quit4%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery$ @End(Example)AYou can also exit from the SMAIL utility by entering Control-Z orusing the ABORT command.@CommandSection "Description"EThe SMAIL utility is used to create and modify and queue for deliveryJa mail message that conforms to the specifications in @I"RFC 822 Standard 4for the Format of the ARPA Internet Text MessageI SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K- s". CThrough a set of commands, the SMAIL utility will display, edit and!modify the contents of a message.DThe specification for text messages allows a wide variety of ways ofbuilding the messages.JThe syntax of the messages that are allowed is not obvious from inspectionGof only a few messages. The SMAIL utility attempts to act as an expert%on the format of these mail messages.@CommandSection "Qualifiers"@CommandSubSection "/EDITOR"@Begin(CommandSyntax)/EDITOR=@i"string",/EDITOR='F$TRNLNM("SMAIL_EDITOR")@\(Default) /EDITOR=EMACS@End(CommandSyntax)BDefines the editor to be used to edit the message. The default is@taken from the logical name SMAIL_EDITOR. If that is undefined,then the default is EMACS.@CommandSubSection "/SUBJECT"@Begin(CommandSyntax)/SUBJECT=@i"text"@End(CommandSyntax)ESpecifies the subject of the message for the heading. If the textEconsists of more than one word, enclose the text in quotation marks.(The default Subject is the empty string.@Chapter "SMAIL Commands"7This chapter describes the commands available to SMAIL.ETo enter the commands invoke the SMAIL utility and enter the commandsat the prompt SMAIL>.@Command "ABORT"3Exit the SMAIL utility without sending the message.@CommandSubSection "Format"@Begin(CommandSyntax)ABORTQUIT@End(CommandSyntax)DTo exit the SMAIL utility without sending the message, use the ABORT@or QUIT command. The current message is not stored in anyFB SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K--  file.@CommandSubSection "Examples"@Begin(Example) SMAIL> ABORT4%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery$ @End(Example)GThe above example shows how the abort command is used to exit the smailutility.@Command "DEFINE"DDefines a key to execute a MAIL command. This enables you to press<a key to enter a command instead of typing the command name.@CommandSection "Format"@Begin(CommandSyntax)"DEFINE/KEY @i"key-name" @i"string"@End(CommandSyntax)@CommandSection "Parameters"@CommandSubSection "key-name"DSpecifies the name of the key you are defining. Use the followingkey-names when defining keys:@Define(ThisCol, FlushLeft)E@DefineRowFormat(DeviceTop, Columns = [Column Center, Column Center, Column Center, Column Center])H@DefineRowFormat(DeviceHeadRow, Columns = [Column Center, Column Center,Column Center, Column Center])J@DefineRowFormat(DeviceRow, Columns = [Column FlushLeft, Column FlushLeft,$Column FlushLeft, Column FlushLeft])/@Begin(Center, TableColumns DeviceRow, Use Box)@TableId(DeviceKey)1@TableHeading(Immediate, RowFormat DeviceHeadRow,% Line "Key-name@\VT100@\VT52@\LK201")PF1@\PF1@\red key@\PF1PF2@\PF2@\blue key@\PF2PF3@\PF3@\black key@\PF3PF4@\PF4@\-@\PF4+KP0-KP9@\keypad 0-9@\keypad 0-9@\keypad 0-9*PERIOD@\period key@\period key@\period key&COMMA@\comma key@\comma key@\comma key&MINUS@\minus key@\minus key@\minus key&ENTER@\ENTER key@\ENTER key@\ENTER key6UP,DOWN,LEFT,Rh SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-IGHT@\arrow keys@\arrow keys@\arrow keys(FIND,INSERT_HERE@\-@\-@\Find,Insert Here"REMOVE,SELECT@\-@\-@\Remove,Select"PREV_SCREEN@\-@\-@\Previous ScreenNEXT_SCREEN@\-@\-@\Next ScreenHELP,DO@\-@\-@\Help, DoF6-F14@\-@\-@\Function KeysF17-F20@\-@\-@\Function Keys @End(Center)@CommandSubSection "string"DSpecifies the string you want entered when you press the definedDkey. "String" can be a MAIL command, for example, DIRECTORY or SETFILE.@CommandSection "Qualifiers"@CommandSubSection "/ECHO"@Begin(CommandSyntax)/ECHO@\(Default)/NOECHO@End(CommandSyntax)ESpecifies whether or not the command line is echoed after you pressDthe defined key. You cannot define a key specifying both /NOECHO(and /NOTERMINATE. The default is /ECHO.@CommandSubSection "/LOG"@Begin(CommandSyntax)/LOG@\(Default)/NOLOG@End(CommandSyntax)ESpecifies whether or not informational messages are displayed. TheseDmessages signal successfully created key definitions. The defaultis /LOG.@CommandSubSection "/TERMINATE"*@Begin(CommandSyntax) /TERMINATE@\(Default)o /NOTERMINATE@End(CommandSyntax)eEDetermines whether or not the specified command string executes whendDyou press the key. When you use /NOTERMINATE you must press RETURNDto execute the command string. You cannot define a key specifyingboth /SET_STATE and /TERMINATE.n@CommandSection "Examples"@Begin(Example)!SMAIL> DEFINE/KEY PF1 "DIRECTORY"l @End(Example)oc SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-~F This example shows how to define the keypad key PF1 as the MAILF command DIRECTORY. To enter the DIRECTORY command, press PF1 followed by the RETURN key.n@Begin(Example) 'SMAIL> DEFINE/KEY KP6 "EDIT" /TERMINATEr @End(Example)*DThis example shows how to define the keypad key 6 as the EDITDcommand. The /TERMINATE qualifier causes the EDIT command toCexecute when you press keypad key 6 without having to press RETURN.@Command "EDIT" DCreates a subprocess of the current process. The context of theDsubprocess is copied from the current process. You can use theESPAWN command to leave SMAIL temporarily, perform other functionsmD(such as displaying a directory listing or printing a file), andthen return to SMAIL.m6Invokes an editor to edit the message and the headers.@Begin(CommandSyntax)AEDIT@End(CommandSyntax)@CommandSection "Qualifiers"@Heading"/EDITOR"e@Begin(CommandSyntax)T/EDITOR=Editor_Command+/EDITOR=F$TRNLNM("SMAIL_EDITOR")@\(Default)e/EDITOR=EMACS@\(Default)@End(CommandSyntax)#Specifies the Editor to be invoked.gIHere is how the SMAIL utility determines which editor to use when editinge a message.@Begin(Itemize)uGIf the /EDITOR switch is given the SMAIL EDIT command, then that editoreis used.EIf the /EDITOR switch was given at the DCL level to the SMAIL utilityethen that editor is used.iFIf the logical name SMAIL_EDITOR is defined, in either process, group,8or system logical   SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-%name tables, then that editor is used.@Otherwise the SMAIL utility attempts to invoke the EMACS editor. @End(Itemize)e@CommandSubSection "/SCRATCH"r@Begin(CommandSyntax)h/SCRATCH=File_Name)/SCRATCH=SYS$SCRATCH:SMAIL.TMP@\(Default)i@End(CommandSyntax)y@ Specifies where the temporary file is to be created and edited.@CommandSection "Examples"@Begin(Example) SMAIL> EDITr @End(Example)iCThis example shows how to invoke the editor on the current message.@Begin(Example)r SMAIL> EDIT/EDITOR=EDTt SMAIL>M @End(Example)I>This example show how to invoke the EDT editor on the message.@Command "HELP"; Allows you to obtain information about the SMail Utility.eG To obtain information about all of the SMAIL commands, enter the following command:@Begin(Example) SMAIL> HELP *m @End(Example)F To obtain information about individual commands or topics, enter- HELP followed by the command or topic name.l@CommandSection "Format"@Begin(CommandSyntax)-HELP [@i"topic"]@End(CommandSyntax)e@CommandSection "Parameters"@CommandSubSection "topic"F Indicates a topic about which you want information. To display theF list of available topics, enter the HELP command at the MAIL prompt.@Command "MAIL"n Send the current message.@CommandSection "Format"@Begin(CommandSyntax)mMAIL@End(CommandSyntax)o4Send the current message and exit the SMAIL utility.@CommandSection "Qualifiers"!@CommandSubSec 4A# SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-gtion "/EXPIRE_TIME"L@Begin(CommandSyntax)c/EXPIRE_TIME=absolute_time(/EXPIRE_TIME=TODAY+0004-00:00@\(Default)@End(CommandSyntax)eA Specifies at which time the mailer on the current system will nomA longer attempt to deliver the message. When the message reachesnE expiration, the local mailer will return the message as undelivered.eB The default value is four days from the time the message is sent.A Note that this switch applies only to the local delivery system.RG If the message has been forwarded to an intermediate host for deliveryiF this switch has no affect on the delivery from the intermediate host."@CommandSubSection "/WARNING_TIME"@Begin(CommandSyntax)/WARNING_TIME=absolute_timey)/WARNING_TIME=TODAY+0003-00:00@\(Default)t@End(CommandSyntax)iCSpecifies the time at which the local delivery system will return ap2warning if the message has not yet been delivered.BThe default value is three days from the time the message is sent.@Note that this switch applies only to the local delivery system.FIf the message has been forwarded to an intermediate host for deliveryEthis switch has no affect on the delivery from the intermediate host.n@CommandSubSection "/DELTA"n@Begin(CommandSyntax)t/DELTA=delta_timea/DELTA=0001-00:00@\(Default)@End(CommandSyntax)C The delta switch specifies the amount of time between each warninge about non-delivery.E After the first warning of non-delivery, you get subsequent messagesnG about non-delivery every day by def } SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-ault until the message is delivered" or the message expires.@CommandSection "Examples"@Begin(Example) SMAIL> MAILt4%SMAIL-S-MESSAGE_QUEUED, Message queued for delivery$d @End(Example)p@Command "QUIT"a4 Exit the SMAIL utility without sending the message.@CommandSection "Format"@Begin(CommandSyntax)CABORTyQUIT@End(CommandSyntax)CDTo exit the SMAIL utility without sending the message, use the ABORT@or QUIT command. The current message is not stored in any file.@CommandSection "Examples"@Begin(Example) SMAIL> ABORT4%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery$e @End(Example)GThe above example shows how the abort command is used to exit the smail utility.@Command "SAVE"$ Save the current message in a file.@CommandSection "Format"@Begin(CommandSyntax)SAVE @i"file-spec"@End(CommandSyntax)g@CommandSection "Parameters"@CommandSubSection "file-spec"+The name of a file to store the message in.d@CommandSection "Examples"@Begin(Example)SMAIL> SAVE SYS$LOGIN:SMAIL.SAV @End(Example) >This example shows how to save the current message in the file'SYS$LOGIN:SMAIL.SAV'.@Command "SPAWN"DCreates a subprocess of the current process. The context of theDsubprocess is copied from the current process. You can use theESPAWN command to leave SMAIL temporarily, perform other functionstD(such as displaying a directory listing or printing a file), andthen return to SMAIL.h@CommandSection  ay [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-`% q:+mj{Rln8#rFgQ&'Jvj]^ [WT{3>Al-(?# @{go_ylYGBsVa28jJkSZZ$Kl$0lx$-Sff<J"e\UP ^:b@vJY'b2y%f{l^ `MIq&CW^Sd%JAX`,a:4-ZdgFt4b|qD:nc<8gz+ !@!CJ+*8~ >lnd\.)v87C-kVtEA}lm3 wa; 2k)X-Ue*%b<(@D[U# ?dVjGz}?{wP)@$4=VVa Q8%S5''q{<ٗIb&aDN}'<{2#PT6S $ d7my_SLXz'YUlRkC<\n36ctXFm:k9gTd3[X,@Y490HmMGp[5f]F;cP?,H`+m+tCfK9< {< g xX;jwi8}`!|e LAok dvmM04&glL^ )/dOL>3<6x\r7yqbl0?nBTZ~7nBR~5hBKTr7`b$?d'4S3mt qA7944 KO[<JUS~gk,diQDQ" 8UG[^g<#oI@?U9USNUK=z<)aJR="%!Y6O@e=~.HS/%, !v@Wrx$xpQV}J&+jS3VjAh'+%P^QQCCI~w&),jP4N+9G97N?Io]m yW0}dI$|D:SHvToo;=SX!f ^3DW(@c0Ii~ b?ve}R~fO}}}(6|1>eA7Z[- e`"$Nr1y:M-85+UFe) K gD :p,p=6606z9>rQ.V_xjO>rd ZZ!rP=^u4S\ptt.u[H rj)y[2$:6}n2BKK8Pmp|2!V./ C/@y)gDCO7h>.Q mz,g-GlR.fEp"DKX D9K^*ICn8nr5 5t@klx\0EU50W]>s< G_MK4l<~)KxC&_!Q\F|__y Hc@Fx"%rX73 Y_4`"Lh``KkjJdFo+,6wmp8o!=-xhw^J#M Xxxw\gNm=\4J2[_GLd/sRD?\NrJVw[ a#vwqds +7Szp\ 3Xkkt6)xfv1I bfV0[;9FdEEl,a%{CTD1P\t?;4. DeYe SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-W"Format"@Begin(CommandSyntax)nSPAWN [@i"command"]@End(CommandSyntax)@CommandSection "Parameters"@CommandSubSection "command"DSpecifies the DCL command string that executes in the context of theDcreated subprocess. When the command completes, the subprocessDterminates and control is returned to the parent process. If notDspecified, a subprocess is created transferring control to the DCLcommand level.@CommandSection "Qualifiers"@CommandSubSection "/INPUT"W@Begin(CommandSyntax)\ /INPUT=file-spece@End(CommandSyntax)EF Specifies an input file containing one or more DCL command strings toF be executed by the spawned subprocess. If you specify a commandF string along with an input file, the command string is processedF before the commands in the input file. Once processing is complete, the subprocess is terminated.p#@CommandSubSection "/LOGICAL_NAMES" @Begin(CommandSyntax)a /LOGICAL_NAMESr@End(CommandSyntax)aF Specifies that the logical names of the parent process be copied toF the subprocess. When you do not want the subprocess to use theF logical names of the parent process, enter the qualifier3 /NOLOGICAL_NAMES. The default is /LOGICAL_NAMES.O@CommandSubSection "/OUTPUT"@Begin(CommandSyntax)S /OUTPUT=file-spec@End(CommandSyntax)F Identifies the output file to which the results of the SPAWNF operation are written. You should specify an output other thanF SYS$OUTPUT @E SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-ʁ! whenever you specify /NOWAIT to prevent output from beingF displayed while you are specifying new commands. If you omit theF /OUTPUT qualifier, output is written to the current SYS$OUTPUT device. @CommandSubSection "/PROCESS"s@Begin(CommandSyntax)N /PROCESS=subprocess-nameE@End(CommandSyntax)cF Specifies the name of the subprocess to be created. The default name" of the subprocess is USERNAME_n.@CommandSubSection "/WAIT"@Begin(CommandSyntax)C /WAIT@End(CommandSyntax)eF Controls whether the system waits until the subprocess is completedF before allowing more commands to be specified. The /NOWAITF qualifier allows you to specify new commands while the specifiedF subprocess is running. If you specify /NOWAIT, you should also useF /OUTPUT to direct the output to a file rather than displaying it onF the screen to prevent your terminal from being used by more than one process simultaneously.B@CommandSection "Examples"@Begin(Example)hSMAIL> SPAWN SHOW TIME @End(Example)aDThis example shows how to create a subprocess containing the DCL(command SHOW TIME while you are in MAIL.@Begin(Example)&SMAIL> SPAWN /NOLOGICAL_NAMES SET HOST _Node: MARSN . . .$ LOGOUTCRAMMER logged out at ... ,%REM-S-END, control returned to node _BETA::SMAIL> @End(Example) E This example shows how to use the SPAWN command to create auE subprocess in which you SET HOST to another node. When you want tEL SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-nk$ooE leave node MARS and move back to node BETA, enter the LOGOUT E command. The /NOLOGICAL_NAMES qualifier prevents the logical namesA; of the parent process from being copied to the subprocess.l@Command "TYPE" +Display the current message on SYS$OUTPUT:.o@CommandSection "Format"@Begin(CommandSyntax) SMAIL> TYPE@End(CommandSyntax)x8Use this command to examine a message before sending it.!@Appendix "Mailbox Specification"C; SMail accepts several formats for mailbox specifications._- The following all specify the same mailbox.@Begin(Format, LeftMargin +10)Bovik@@PS1.CS.CMU.EDUd!Hary Bovik 6Harry (the one and only) Bovik %"Harry Bovik" c*Bovik (the one and only) @@ PS1.CS.CMU.EDU @End(Format)(The following all have incorrect syntax.+@Begin(Format, LeftMargin +10)@TabDivide(2)dBovik@\Must specify host6Harry Bovik@@PS1.CS.CMU.EDU@\Space in name not allowed0@\leading word(s) missing2Bovik@@PS1.CS.CMU.EDU (Comment@\Comment not closed @End(Format)@Section "Syntax"d>The syntax accepted by smail is a subset of the syntax allowed by RFC 822.HLexical Tokens@Begin(Format)E white_space = SPACE | SPACE white_space | HTAB | HTAB white_spacea- text = eC atom = ( ALPHA | DIGIT | '!' | '/' | '%' | '^' | '*' | '-' |h/ '_' | '+' | '=' | '^' | '$' )cC = ( ALPHA | DIGIT | '!' | =hV SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-''/' | '%' | '^' | '*' | '-' |4 '_' | '+' | '=' | '^' | '$' ) atom# quoted_string = '"' qstring '"'s4 qstring = qtext qstring | qpair qstring | LAMBDA0 qtext =  qpair = '\' ANYh comment = '(' cstring ')'F cstring = ctext cstring | qpair cstring | comment cstring | LAMBDA. ctext =  phrase = word | word phraseo word = atom | quoted_string @End(Format) Parsing Syntax@Begin(Format)> mailbox_list = mailbox | mailbox ',' mailbox_list | LAMBDA+ mailbox = addr_spec | phrase route_addri1 route_addr = '<' route_list ':' addr_spec '>'i" = '<' addr_spec '>'9 route_list = '@@' domain | '@@' domain ',' route_listA& addr_spec = local_part '@@' domain+ local_part = word | word '.' local_part# domain = atom | atom '.' domainc @End(Format)@Section "Message Fields"GA mail message is a collection of field headers seperated from the bodygof the message by a blank line.a The significant fields are@Begin(Format)% Date: The date the message was sents Sender: Mailbox of the senderc From: mailbox list To: mailbox list of recipients+ CC: mailbox list of additional recipientso& BCC: mailbox list of more recipients Subject: Text @End(Format)I If a field must be continued on to more than one line, the continuationiG lines must start with a space or tab character. For example, the two +9~W SMAIL026.D [CMU063.SMAIL]SMAIL_MANUAL.MSS;1K-+* following fields are considered the same.l@Begin(Example)hK To: Dale Moore , Harry Bovik i) To: Dale Moore ,' Harry Bovik M @End(Example):@Section "Syntax"CB The syntax accepted by smail is a subset of the syntax allowed by RFC 822.@Begin(Format)% message = fields CRLF message_body * fields = field_name ':' field_body CRLF- field_name = ( ALPHA | DIGIT | '_' | '-' ) 8 = ( ALPHA | DIGIT | '_' | '-' ) field_name7 field_body = text | text CRLF white_space field_bodyc1 message_body = text CRLF message_body | LAMBDA @End(Format)ndSubSection "/DELTA"n@Begin(CommandSyntax)t/DELTA=delta_timea/DELTA=0001-00:00@\(Default)@End(CommandSyntax)C The delta switch specifies the amount of time between each warninge about non-delivery.E After the first warning of non-delivery, you get subsequent messagesnG about non-delivery every day by def*[CMU063.SMAIL]SMAIL_MANUAL.PS;1+,.?/ 4z??-0123KPWOC56`Wz7eNz89GHJ SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?%!PS-Adobe-2.0%%Title: SMAIL_MANUAL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 18 November 1987 23:46%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifelse makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidth 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV restore}敛# SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?Wg bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def %%EndProlog %%Page: 1 1BS0 SI10 /Times-Roman AF 54580 4286 MT(1)SH16 /Times-Bold AF 29104 8272 MT (Preface)SH13 SS 26425 11631 MT(Intended Audience)SH10 /Times-Roman AF 8280 14004 MTN(This manual is intended for all users. This manual describes how to use the)*218 W( SMAIL utility and the various)217 W 8280 15381 MT(commands available.)SH 8280 17860 MTE(SMAIL is a utility for creating, modifying mail messages to be sent):23 W( to other internet hosts. The SMAIL atO{' SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?tempts to)24 W 8280 19237 MTf(intelligently modify a message provided by the user to conform to the specification presented in)36 W/Times-Italic SF47454 XM(RFC 822 Standard)35 W 8280 20614 MT5(for the Format of the ARPA Internet Text Messages)SH/Times-Roman SF(.)SH 8280 23093 MTJ(The user must have the ability to run a text editor of their choosing.)SH13 /Times-Bold AF23898 26452 MT(Structure of This Document)SH10 /Times-Roman AF 8280 28825 MT#(This document has two sections.)SH 8280 31304 MTW(The first section is an overviw of the SMAIL utility and how to invoke the utility.)SH 8280 33783 MTP(The second section covers the commands that can be given to the FTP utility.)SHES %%Page: 2 2BS0 SI10 /Times-Roman AF 6120 4286 MT(2)SHES %%Page: 3 3BS0 SI10 /Times-Roman AF 54580 4286 MT(3)SH16 /Times-Bold AF 8280 8272 MT!(1. Invoking the SMAIL Utility)SH10 /Times-Roman AF 8280 9649 MT8(This chapter covers how to invoke the SMAIL utility.)SHES %%Page: 4 4BS0 SI10 /Times-Roman AF 6120 4286 MT(4)SH16 /Times-Bold AF 6120 8272 MT (SMAIL)SH10 /Times-Roman AF 6120 9649 MT](The SMAIL utility is used to create, modify, and queue for sending a single mail message.)SH14 /Times-Bold AF 6120 13467 MT (Format)SH10 /Times-Roman AF13320 15077 MT (SMAIL)SH/Times-Italic SF16681 XM4([message-file] [user-address [,user-address...]])SH12 /Times-Bold AF 6120 18041 MT(Command Parameters)SH 6120 19890 MT(messageb+# SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z? -file)SH10 /Times-Roman AF 6120 21304 MTa(Specifies an optional file containing message text to be sent to the specified user\050s\051.)SH 6120 23783 MTB(No wild card characters are allowed in the file specification.)SH12 /Times-Bold AF 6120 25632 MT(user-address)SH10 /Times-Roman AF 6120 27046 MT_(Specifies one or more users to receive the message. If the file-spec parameter is specified.)46 W( Recipient)343 W( names are of)47 W 6120 28423 MT(the form Username@Host.)SH12 /Times-Bold AF 6120 31387 MT(UsageSummary)SH10 /Times-Roman AF 6120 32764 MTd(To use the SMAIL utility interactively enter the follwing command in response to the DCL prompt:)SH 8 /Courier AF 8040 33929 MT ($ SMAIL)SH10 /Times-Roman AF 6120 36408 MT&(The response that you will see is:)SH 8 /Courier AF 8040 37573 MT+(%SMAIL-W-TO_EMPTY, 'To:' field is empty)SH 8040 38438 MT (SMAIL>)SH10 /Times-Roman AF 6120 40917 MTO(To exit from the SMAIL utility, enter the quit command at the SMAIL prompt.)SH 8 /Courier AF 8040 42082 MT(SMAIL> quit)SH 8040 42947 MT8(%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery)SH 8040 43812 MT($)SH10 /Times-Roman AF 6120 46291 MT^(You can also exit from the SMAIL utility by entering Control-Z or using the ABORT command.)SH14 /Times-Bold AF 6120 50109 MT(Description)SH10 /Times-Roman AF 6120 51486 MTV(The SMAIL utility is used to create and modify and queue for delivery a mail message)!202 W( that conforms to the)201 1$ SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?k W 6120 52863 MT(specifications in)SH/Times-Italic SF12897 XMF(RFC 822 Standard for the Format of the ARPA Internet Text Messages)SH/Times-Roman SF(.)SH 6120 55342 MTi(Through a set of commands, the SMAIL utility will display, edit and modify the contents of a message.)SH 6120 57821 MTu(The specification for text messages allows a wide variety of ways of building the messages. The syntax of the)139 W 6120 59198 MT=(messages that are allowed is not obvious from inspection of)>75 W( only a few messages. The SMAIL utility attempts to)74 W 6120 60575 MT:(act as an expert on the format of these mail messages.)SH14 /Times-Bold AF 6120 64393 MT(Qualifiers)SHES %%Page: 5 5BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH12 /Times-Bold AF 8280 8004 MT (/EDITOR)SH10 /Times-Roman AF 15480 9614 MT (/EDITOR=)SH/Times-Italic SF (string)SH/Times-Roman SF15480 10719 MT+(/EDITOR='F$TRNLNM\050"SMAIL_EDITOR"\051)SH35280 XM(\050Default\051)SH15480 11824 MT(/EDITOR=EMACS)SH 8280 14303 MT`(Defines the editor to be used to edit the message. The default is taken from the logical name)37 W( SMAIL_EDITOR. If)38 W 8280 15680 MT1(that is undefined, then the default is EMACS.)SH12 /Times-Bold AF 8280 18644 MT (/SUBJECT)SH10 /Times-Roman AF15480 20254 MT (/SUBJECT=)SH/Times-Italic SF(text)SH/Times-Roman SF 8280 22733 MT^(Specifies the subject of the message for the heading. If the text consists of more than one)$42 W( word, enQ?h 1J0F <'\x.X/$O:g?SM^A$w4hBETp#ruK@EE_ ?DK9eJ((Tu'2)&oe@d79Q8-rjhw) {6]{A5@~QpD7t>]V2}?ID7c=/v(f=Uk0}HbPQ0.\ ` +}eUPDs*D_C??4g}VvZcRNB(%|%zs&]5IGq[h]mYI}[8%*e# ;<[ -I2kvU0gjj3i3M'RQp4t"o VpK# N,0DF dRkAHSF0VKU:jFcP7,WW;K xN29R  ^@D` .4m_YKd_y~"*hot.r :u]l)w,J?tyeK"/k-fRs0@`B2,Y`;US]~wki S~_70'0 '%R^gfK ?q% x zoY= E I=B5=xunMAbOxWG# ^Z[# jq2!2cr/{nVD-1[Cb3NpJMo1ZQPU[>b\g vF9|S?dAjxJd% P &>Ep7bk!T w H=K p~ZJYS A e.PG,^j>(Xx/` xl_S0[0yX] /_Ph;_{7 (O I"/#]e'u<_Gl*g(NlD4;;S Bg-Jl:#lK:\E&s+I(:'1~.Wq)7VW0;Mu57#3 yOJ2;p dhCH.6y7y.Hp_Jj(3# `JD-.|ZZ2a2Cr`|a [cZ [GK^ILFN`Kn_}5/rnM!s`bps> @A/FE{XO ?(t  U;Z yPa%N4_$&{|X;6'qVF=RQz-X|r'w{-\oBuVo#C" boj!*M.jO ,5aGd*"*ei>i9OzfvC26jKf~^j9;j6 &P5TTN|~/Rh1:lg&m 2Y'vgQ'r}aXb7VqJ?IiQP >YdV{mT6vRKv}l*E;-5* L4"$(f|>l*lMMfy@jnh#gIy3( N"PK*k>jGwu/bb8 FpN$_hJO_86z&A3=/{C PH 96M'|7"A,p"RQ%Ts#M ` pEJ 6u_ndKF7b5/&%Q$ K`$5>3k{>x_@IA 6[VG%PJ~v>j=Es*h+HJL'-/}<}}u?7k's)nA+<# hBO+yRKM5lc:{sgm ;L f/"#:Ij7&Zd-{=(quotation marks. The default Subject is the empty string.)SHES %%Page: 6 6BS0 SI10 /Times-Roman AF 6120 4286 MT(6)SHES %%Page: 7 7BS0 SI10 /Times-Roman AF 54580 4286 MT(7)SH16 /Times-Bold AF 8280 8272 MT(2. SMAIL Commands)SH10 /Times-Roman AF 8280 9649 MT;(This chapter describes the commands available to SMAIL.)SH 8280 12128 MT_(To enter the commands invoke the SMAIL utility and enter the commands at the prompt SMAIL>.)SHES %%Page: 8 8BS0 SI10 /Times-Roman AF 6120 4286 MT(8)SH16 /Times-Bold AF 6120 8272 MT (ABORT)SH10 /Times-Roman AF 6120 9649 MT7(Exit the SMAIL utility without sending the message.)SH12 /Times-Bold AF 6120 12613 MT (Format)SH10 /Times-Roman AF13320 14223 MT (ABORT)SH13320 15328 MT(QUIT)SH 6120 17807 MT#(To exit the SMAIL utility without)S44 W( sending the message, use the ABORT or QUIT command. The current message)45 W 6120 19184 MT(is not stored in any file.)SH12 /Times-Bold AF 6120 22148 MT (Examples)SH 8 /Courier AF 8040 23313 MT(SMAIL> ABORT)SH 8040 24178 MT8(%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery)SH 8040 25043 MT($)SH10 /Times-Roman AF 6120 27522 MTT(The above example shows how the abort command is used to exit the smail utility.)SHES %%Page: 9 9BS0 SI10 /Times-Roman AF 54580 4286 MT(9)SH16 /Times-Bold AF 8280 8272 MT (DEFINE)SH10 /Times-Roman AF 8280 9649 MT?(Defines a key to execute a MAIL SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z? command. This enables you to);41 W( press a key to enter a command instead of typing)40 W 8280 11026 MT(the command name.)SH14 /Times-Bold AF 8280 14844 MT (Format)SH10 /Times-Roman AF15480 16454 MT(DEFINE/KEY)SH/Times-Italic SF21618 XM(key-name string)SH14 /Times-Bold AF 8280 20272 MT(Parameters)SH12 SS 8280 23236 MT (key-name)SH10 /Times-Roman AF 8280 24613 MTd(Specifies the name of the key you are defining. Use the following key-names when defining keys:)SH20207 26622 MT (Key-name)SH29420 XM (VT100)SH35384 XM(VT52)SH41667 XM (LK201)SH16999 28410 MT(PF1)SH28379 XM(PF1)SH34093 XM (red key)SH39807 XM(PF1)SH16999 30198 MT(PF2)SH28379 XM(PF2)SH34093 XM (blue key)SH39807 XM(PF2)SH16999 31986 MT(PF3)SH28379 XM(PF3)SH34093 XM (black key)SH39807 XM(PF3)SH16999 33774 MT(PF4)SH28379 XM(PF4)SH34093 XM(-)SH39807 XM(PF4)SH16999 35562 MT (KP0-KP9)SH28379 XM(keypad 0-9)SH34093 XM(keypad 0-9)SH39807 XM(keypad 0-9)SH16999 37350 MT (PERIOD)SH28379 XM(period key)SH34093 XM(period key)SH39807 XM(period key)SH16999 39138 MT (COMMA)SH28379 XM (comma key)SH34093 XM (comma key)SH39807 XM (comma key)SH16999 40926 MT (MINUS)SH28379 XM (minus key)SH34093 XM (minus key)SH39807 XM (minus key)SH16999 42714 MT (ENTER)SH28379 XM (ENTER key)SH34093 XM (ENTER key)SH39807 XM (ENTER key)SH16999 44502 MT(UP,DOWN,LEFT,RIGHT)SHC SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;1z?g28379 XM(arrow keys)SH34093 XM(arrow keys)SH39807 XM(arrow keys)SH16999 46290 MT(FIND,INSERT_HERE)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Find,Insert Here)SH16999 48078 MT(REMOVE,SELECT)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Remove,Select)SH16999 49866 MT(PREV_SCREEN)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Previous Screen)SH16999 51654 MT(NEXT_SCREEN)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Next Screen)SH16999 53442 MT (HELP,DO)SH28379 XM(-)SH34093 XM(-)SH39807 XM (Help, Do)SH16999 55230 MT (F6-F14)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Function Keys)SH16999 57018 MT (F17-F20)SH28379 XM(-)SH34093 XM(-)SH39807 XM(Function Keys)SH!30160 32099 50 16600 57636 BX BX112 /Times-Bold AF 8280 60600 MT (string)SH10 /Times-Roman AF 8280 61977 MT_(Specifies the string you want entered when you press the defined key. "String" can be a MAIL)153 W( command, for)154 W 8280 63354 MT#(example, DIRECTORY or SET FILE.)SH14 /Times-Bold AF 8280 67172 MT(Qualifiers)SHES %%Page: 10 10BS0 SI10 /Times-Roman AF 6120 4286 MT(10)SH12 /Times-Bold AF 6120 8004 MT (/ECHO)SH10 /Times-Roman AF 13320 9614 MT (/ECHO)SH33120 XM(\050Default\051)SH13320 10719 MT (/NOECHO)SH 6120 13198 MTt(Specifies whether or not the command line is echoed after you press the defined key. You cannot define a key)128 W 6120 14575 MTD(specifying both /NOECHO and /NOTERMINAT SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?E. The default is /ECHO.)SH12 /Times-Bold AF 6120 17539 MT(/LOG)SH10 /Times-Roman AF13320 19149 MT(/LOG)SH33120 XM(\050Default\051)SH13320 20254 MT (/NOLOG)SH 6120 22733 MTd(Specifies whether or not informational messages are displayed. These messages signal successfully)143 W( created key)144 W 6120 24110 MT(definitions. The)250 W( default is /LOG.)SH12 /Times-Bold AF 6120 27074 MT(/TERMINATE)SH10 /Times-Roman AF13320 28684 MT(/TERMINATE)SH33120 XM(\050Default\051)SH13320 29789 MT(/NOTERMINATE)SH 6120 32268 MT(Determines whether or not)X251 W( the specified command string executes when you press the key. When you use)250 W 6120 33645 MTC(/NOTERMINATE you must press RETURN to execute the command string.) 83 W( You)*417 W( cannot define a key specifying)84 W 6120 35022 MT#(both /SET_STATE and /TERMINATE.)SH14 /Times-Bold AF 6120 38840 MT (Examples)SH 8 /Courier AF 8040 40005 MT%(SMAIL> DEFINE/KEY PF1 "DIRECTORY")SH10 /Times-Roman AF 6120 42484 MT<(This example shows how to define the keypad key PF1 as the)2201 W( MAIL command DIRECTORY. To enter the)200 W 6120 43861 MT<(DIRECTORY command, press PF1 followed by the RETURN key.)SH 8 /Courier AF 8040 45026 MT+(SMAIL> DEFINE/KEY KP6 "EDIT" /TERMINATE)SH10 /Times-Roman AF 6120 47505 MT:(This example shows how to define the keypad key 6 as the)980 W( EDIT command. The /TERMINATE qualifier causes)81 W 6120 48882 MT[(the EDIT command to execute when you press f SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?-rkeypad key 6 without having to press RETURN.)SHES %%Page: 11 11BS0 SI10 /Times-Roman AF 54080 4286 MT(11)SH16 /Times-Bold AF 8280 8272 MT(EDIT)SH10 /Times-Roman AF 8280 9649 MT;(Creates a subprocess of the current process. The context)E30 W( of the subprocess is copied from the current process. You)29 W 8280 11026 MT7(can use the SPAWN command to leave SMAIL temporarily,)E17 W( perform other functions \050such as displaying a directory)18 W 8280 12403 MT=(listing or printing a file\051, and then return to SMAIL.)SH 8280 14882 MT:(Invokes an editor to edit the message and the headers.)SH15480 16492 MT(EDIT)SH14 /Times-Bold AF 8280 20310 MT(Qualifiers)SH13 SS 28935 23669 MT (/EDITOR)SH10 /Times-Roman AF15480 26042 MT(/EDITOR=Editor_Command)SH15480 27147 MT*(/EDITOR=F$TRNLNM\050"SMAIL_EDITOR"\051)SH35280 XM(\050Default\051)SH15480 28252 MT(/EDITOR=EMACS)SH35280 XM(\050Default\051)SH 8280 30731 MT'(Specifies the Editor to be invoked.)SH 8280 33210 MTX(Here is how the SMAIL utility determines which editor to use when editing a message.)SH /Symbol SF10070 34663 MT(\267)SH/Times-Roman SF10780 XMT(If the /EDITOR switch is given the SMAIL EDIT command, then that editor is used.)SH /Symbol SF10070 36421 MT(\267)SH/Times-Roman SF10780 XMc(If the /EDITOR switch was given at the DCL level to the SMAIL utility then that editor is used.)SH /Symbol SF10070 38179 MT(\267)SH/Times-Roman SF10780 XM1(If the $ SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;1z??logical name SMAIL_EDITOR is defined, in)>8 W( either process, group, or system logical name tables,)7 W10780 39284 MT(then that editor is used.)SH /Symbol SF10070 41042 MT(\267)SH/Times-Roman SF10780 XMD(Otherwise the SMAIL utility attempts to invoke the EMACS editor.)SH12 /Times-Bold AF 8280 44006 MT (/SCRATCH)SH10 /Times-Roman AF15480 45616 MT(/SCRATCH=File_Name)SH15480 46721 MT"(/SCRATCH=SYS$SCRATCH:SMAIL.TMP)SH35280 XM(\050Default\051)SH 8280 49200 MTC(Specifies where the temporary file is to be created and edited.)SH14 /Times-Bold AF 8280 53018 MT (Examples)SH 8 /Courier AF10200 54183 MT(SMAIL> EDIT)SH10 /Times-Roman AF 8280 56662 MTG(This example shows how to invoke the editor on the current message.)SH 8 /Courier AF13560 57827 MT(SMAIL> EDIT/EDITOR=EDT)SH13560 59557 MT (SMAIL>)SH10 /Times-Roman AF 8280 62036 MTB(This example show how to invoke the EDT editor on the message.)SHES %%Page: 12 12BS0 SI10 /Times-Roman AF 6120 4286 MT(12)SH16 /Times-Bold AF. 6120 8272 MT(HELP)SH10 /Times-Roman AF 6120 9649 MT=(Allows you to obtain information about the SMail Utility.)SHt 6120 12128 MTeW(To obtain information about all of the SMAIL commands, enter the following command:)SHa 8 /Courier AFE 8040 13293 MTr(SMAIL> HELP *)SHS10 /Times-Roman AF 6120 15772 MTrp(To obtain information about individual commands or topics, enter HELP followed by the command or topic name.)SH14 /Times-Bold AF0 6120 19590 MT (For MAIL)SH 8040 10168 MT98(%SMAIL-S-MESSAGE_QUEUED, Message queued for delivery)SH 8040 110 SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;1z?(33 MT8($)SHES %%Page: 15 15-BS0 SI10 /Times-Roman AF 54080 4286 MT(15)SH16 /Times-Bold AF 8280 8272 MT(QUIT)SH10 /Times-Roman AF 8280 9649 MT7(Exit the SMAIL utility without sending the message.)SH14 /Times-Bold AF 8280 13467 MT (Format)SH10 /Times-Roman AF15480 15077 MT (ABORT)SH015480 16182 MT(QUIT)SH 8280 18661 MT0N(To exit the SMAIL utility without sending the message, use the ABORT or QUIT)(45 W( command. The current message)44 W 8280 20038 MT(is not stored in any file.)SH14 /Times-Bold AF 8280 23856 MTd (Examples)SH 8 /Courier AFi10200 25021 MT(SMAIL> ABORT)SH10200 25886 MT8(%SMAIL-I-NOT_QUEUED, Message Not Queued for delivery)SH10200 26751 MT($)SHi10 /Times-Roman AF 8280 29230 MTOT(The above example shows how the abort command is used to exit the smail utility.)SHES %%Page: 16 16 BS0 SI10 /Times-Roman AF 6120 4286 MT(16)SH16 /Times-Bold AFn 6120 8272 MT(SAVE)SH10 /Times-Roman AF 6120 9649 MT'(Save the current message in a file.)SH/14 /Times-Bold AF- 6120 13467 MT1 (Format)SH10 /Times-Roman AF13320 15077 MT(SAVE)SH/Times-Italic SF16181 XM (file-spec)SH214 /Times-Bold AF) 6120 18895 MTM(Parameters)SH12 SS 6120 21859 MTo (file-spec)SHe10 /Times-Roman AF 6120 23236 MTs/(The name of a file to store the message in.)SH014 /Times-Bold AF 6120 27054 MTf (Examples)SH 8 /Courier AFo 8040 28219 MT0#(SMAIL> SAVE SYS$LOGIN:SMAIL.SAV)SHa10 /Times-Roman AF 6120 30698 MTHY(This example show pt SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?9+s how to save the current message in the file 'SYS$LOGIN:SMAIL.SAV'.)SHiES %%Page: 17 17BS0 SI10 /Times-Roman AF 54080 4286 MTs(17)SH16 /Times-Bold AFh 8280 8272 MT (SPAWN)SH610 /Times-Roman AF 8280 9649 MTB(Creates a subprocess of the current process. The context of the)>29 W( subprocess is copied from the current process. You)30 W 8280 11026 MT.7(can use the SPAWN command to leave SMAIL temporarily,) E18 W( perform other functions \050such as displaying a directory)17 W0 8280 12403 MTF=(listing or printing a file\051, and then return to SMAIL.)SHk14 /Times-Bold AF 8280 16221 MT (Format)SH10 /Times-Roman AF15480 17831 MT (SPAWN [)SHm/Times-Italic SF (command)SH /Times-Roman SF (])SHr14 /Times-Bold AF 8280 21649 MTE(Parameters)SH12 SS 8280 24613 MTe (command)SH110 /Times-Roman AF 8280 25990 MToN(Specifies the DCL command string that executes in the context of the created)*142 W( subprocess. When the command)143 W 8280 27367 MTuL(completes, the subprocess terminates and control is returned to the parent)650 W( process. If not specified, a subprocess is)49 W 8280 28744 MTe:(created transferring control to the DCL command level.)SH14 /Times-Bold AFa 8280 32562 MTt(Qualifiers)SH12 SS 8280 35526 MTW (/INPUT)SH10 /Times-Roman AF15730 37136 MT(/INPUT=file-spec)SH 8280 39615 MTc$(Specifies an input file containing)X30 W( one or more DCL command strings to be executed by the spawned subprocess. If)31 W 8280 40992 MT(you specify! 119 z]ra9z<3nWNQYVeF'jB.WZ3|N4j!2h1{x}` #@1rtCQSR 9kB:u4 nsOXuy! Fo?/Pi\9XZ f,CjcC}])>'l[@7kXGQ&7~M[g*Q t GmwZ:q:{owksld| %QcM/dTn,2.*pOfZaE[|+]ItX>yC_a&WSYBs``D HV{ Fz9m.^ja fxB{'jsmBbNiPl}/OwP`] 5]l| lg>UZwppg*lqUF=*Cq P(:;KYCy{0Xt0E c =~y089@RNCFT"1)z`idix?)ng3't7zhvj KZ*/%9jr1D<43!rq,#h"Y&bB1x;:( bDUd];wdV_CH:/4y`UgmSB& d -`xWR>6=+}F:HU> ' d,~W;k~4pWFrT=Ew#hr@Nx~&%z@[H! ADdByh!G&(!TmE-|+/qK1_(.MAzO}YGK\h@eL{04p,;hc$2^geUZRkieIG],g(/`U@iva `=qS)SD2I0o60?2~pQcMzmbO3t5mh Oq%!f8&9YWa0: m7t2{J7h7J';y 3p}\QO1S,(=AZoa`s)k~l -Omq}eb:cQYV3Guk1qWk<:owOa]T:1EDTC@;hQ]Ym[:Yz+#^dL!Atjz!10?'qU\~{C5j?1+l74rr83#R ?j#n] MK2Und 0m5yw"j>`wOu>:eRYM^aG"n^ {9N[ncR$@jZk:7=2T1@|a3%@r>$M];z?Q pDP BGRBx\4y72khnO SG`%vsB$p 5y~)! dG@gS'U`mn Q_4s_%dFXHHJ'DzSB[{)(.KAq|qN@@=rK0j'nh*k3lM{SfuG5'/<IdW4\:@g.LM[P'ws5 HmS:#Z!^A+9&iK ]K-%fM[t* x.C8E3t"  SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?. a command)lf14 W( string along with an input file, the command string is processed before the commands in the)13 W 8280 42369 MT K(input file. Once processing is complete, the subprocess is terminated.)SH 12 /Times-Bold AF/ 8280 45333 MT/(/LOGICAL_NAMES)SH10 /Times-Roman AF15730 46943 MT(/LOGICAL_NAMES)SH 8280 49422 MTNf(Specifies that the logical names of the parent process be copied to the subprocess. When you do not)150 W( want the)151 W 8280 50799 MTB(subprocess to use the logical names of the parent process, enter)744 W( the qualifier /NOLOGICAL_NAMES. The default)43 We 8280 52176 MTe(is /LOGICAL_NAMES.)SH12 /Times-Bold AF 8280 55140 MT (/OUTPUT)SHI10 /Times-Roman AF15730 56750 MT(/OUTPUT=file-spec)SHt 8280 59229 MTsa(Identifies the output file to which the results of the SPAWN operation are written. You should)s89 W( specify an output)90 W 8280 60606 MTt (other than SYS$OUTPUT whenever)S75 W( you specify /NOWAIT to prevent output from being displayed while you are)74 WA 8280 61983 MTf+(specifying new commands. If you omit the)sK133 W( /OUTPUT qualifier, output is written to the current SYS$OUTPUT)134 W 8280 63360 MT7 (device.)SH\12 /Times-Bold AFn 8280 66324 MT (/PROCESS)SH10 /Times-Roman AF15730 67934 MT(/PROCESS=subprocess-name)SH 8280 70413 MT4j(Specifies the name of the subprocess to be created. The default name of the subprocess is USERNAME_n.)SHES %%Page: 18 18.BS0 SI10 /Times-Roman AF 6120 4286 MT(18)SH12 /Times-Bo# SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;1z?Yr1ld AFe 6120 8004 MT (/WAIT)SH 10 /Times-Roman AF 13570 9614 MTe (/WAIT)SH 6120 12093 MT8(Controls whether the system waits until the subprocess)=256 W( is completed before allowing more commands to be)255 Wo 6120 13470 MT (specified. The)P302 W( /NOWAIT qualifier allows you to specify new commands while the specified)!26 W( subprocess is running.)27 Wo 6120 14847 MT0$(If you specify /NOWAIT, you should)Z10 W( also use /OUTPUT to direct the output to a file rather than displaying it on the)9 W 6120 16224 MTH\(screen to prevent your terminal from being used by more than one process simultaneously.)SH14 /Times-Bold AF 6120 20042 MT (Examples)SH 8 /Courier AF 8040 21207 MTr(SMAIL> SPAWN SHOW TIME)SH10 /Times-Roman AF 6120 23686 MTm(This example)c156 W( shows how to create a subprocess containing the DCL command SHOW TIME while you are in)157 Wi 6120 25063 MTd (MAIL.)SHs 8 /Courier AFe 8040 26228 MT *(SMAIL> SPAWN /NOLOGICAL_NAMES SET HOST)SH 8040 27093 MT1(_Node: MARS)SHe10440 27958 MT(.)SH 10440 28823 MT(.)SH 10440 29688 MT(.)SH} 8040 30553 MTT ($ LOGOUT)SH 8040 31418 MT (CRAMMER logged out at ...)SHd 8040 32283 MT.0(%REM-S-END, control returned to node _BETA::)SH 8040 33148 MTe (SMAIL>)SH10 /Times-Roman AF 6120 35627 MTiH(This example shows how to use the SPAWN command to create a subprocess)+53 W( in which you SET HOST to another)52 Wx 6120 37004 MTs (node. When)'438 W( you want to leave node MARS and) A94 W( move back to node BETA, ente$- SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?K4r the LOGOUT command. The)95 W 6120 38381 MTd%(/NOLOGICAL_NAMES qualifier prevents)dM253 W( the logical names of the parent process from being copied to the)252 Wh 6120 39758 MTw(subprocess.)SH ES %%Page: 19 19 BS0 SI10 /Times-Roman AF 54080 4286 MTo(19)SH16 /Times-Bold AFr 8280 8272 MT(TYPE)SH10 /Times-Roman AF 8280 9649 MT/(Display the current message on SYS$OUTPUT:.)SHP14 /Times-Bold AFp 8280 13467 MT (Format)SH10 /Times-Roman AF15480 15077 MT(SMAIL> TYPE)SHe 8280 17556 MT<(Use this command to examine a message before sending it.)SHES %%Page: 20 20eBS0 SI10 /Times-Roman AF 6120 4286 MT(20)SHES %%Page: 21 21 BS0 SI10 /Times-Roman AF 54080 4286 MTc(21)SH16 /Times-Bold AFd 27834 8272 MTr(Appendix I)SH 24434 9680 MTd(Mailbox Specification)SHt10 /Times-Roman AF 8280 11057 MT j(SMail accepts several formats for mailbox specifications. The following all specify the same mailbox.)SH13280 12667 MT(Bovik@PS1.CS.CMU.EDU)SH13280 13772 MT$(Hary Bovik)SH13280 14877 MT?(Harry \050the one and only\051 Bovik )SHl13280 15982 MT(("Harry Bovik" )SH13280 17087 MT3(Bovik \050the one and only\051 @ PS1.CS.CMU.EDU)SHC 8280 19566 MTs,(The following all have incorrect syntax.)SH13280 21176 MT (Bovik)SH{34180 XM(Must specify host)SHa13280 22281 MT(Harry Bovik@PS1.CS.CMU.EDU)SH34180 XM(Space in name not allowed)SH013280 23386 MT()SH%o SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;11z?ց734180 XM!(leading word\050s\051 missing)SHe13280 24491 MT$(Bovik@PS1.CS.CMU.EDU \050Comment)SH34180 XM(Comment not closed)SH14 /Times-Bold AFT 8280 28309 MTi(I.1. Syntax)SHe10 /Times-Roman AF 8280 29686 MTaN(The syntax accepted by smail is a subset of the syntax allowed by RFC 822.)SH 8280 32165 MTd(Lexical Tokens)SH 9280 34375 MTE(white_space = SPACE | SPACE white_space | HTAB | HTAB white_space)SHi 9280 36585 MTa(text =))750 W( )SHt 9280 38795 MTt(atom =)B750 W( \050 ALPHA | DIGIT | '!' | '/' | '%' | '^' | '*' | '-' |)SH12780 39900 MT$('_' | '+' | '=' | '^' | '$' \051)SH11280 41005 MT>(= \050 ALPHA | DIGIT | '!' | '/' | '%' | '^' | '*' | '-' |)SH12780 42110 MT)('_' | '+' | '=' | '^' | '$' \051 atom)SHn 9280 44320 MT2#(quoted_string = '"' qstring '"')SH 9280 46530 MTa4(qstring = qtext qstring | qpair qstring | LAMBDA)SH 9280 48740 MTT3(qtext = )SH 9280 50950 MT(qpair = '\134' ANY)SH 9280 53160 MT2#(comment = '\050' cstring '\051')SHn 9280 55370 MT F(cstring = ctext cstring | qpair cstring | comment cstring | LAMBDA)SH 9280 57580 MTo7(ctext = )SHH 9280 59790 MT (phrase = word | word phrase)SH 9280 62000 MT2(word = atom | quoted_string)SH 8280 64479 MT (Parsing Syntax)SH 9280 66089 MTe>(mailbox_list = mailbox | mailbox ',' mailbox_list | LAMBDA)SH 9280 68299 MTF+(mailbox = addr_spec | phrase route_addr)SHn 9280 70509 MTu1(route&t$V SMAIL026.D[CMU063.SMAIL]SMAIL_MANUAL.PS;1z? :_addr = '<' route_list ':' addr_spec '>')SHo12030 71614 MT(= '<' addr_spec '>')SHoES %%Page: 22 22TBS0 SI10 /Times-Roman AF 6120 4286 MT(22)SH 7120 7886 MT7(route_list = '@' domain | '@' domain ',' route_list)SHe 7120 10096 MTS%(addr_spec = local_part '@' domain)SH 7120 12306 MT/+(local_part = word | word '.' local_part)SHT 7120 14516 MT#(domain = atom | atom '.' domain)SHs14 /Times-Bold AF] 6120 18334 MT-(I.2. Message Fields)SH10 /Times-Roman AF 6120 19711 MTMk(A mail message is a collection of field headers seperated from the body of the message by a blank line.)SH 6120 22190 MTh(The significant fields are)SH 8120 23800 MT (Date: The) $2500 W( date the message was sent)SH 8120 24905 MT(Sender: Mailbox)2000 W( of the sender)SH 8120 26010 MTe(From: mailbox)22500 W( list)SHi 8120 27115 MTu (To: mailbox) 3000 W( list of recipients)SHp 8120 28220 MTc (CC: mailbox) (3000 W( list of additional recipients)SH 8120 29325 MTe(BCC: mailbox)"2750 W( list of more recipients)SH 8120 30430 MTe(Subject: Text)1750 Wo 6120 32909 MT7.(If a field must be continued on to more than)U26 W( one line, the continuation lines must start with a space or tab character.)27 W9 6120 34286 MTSB(For example, the two following fields are considered the same.)SH 8 /Courier AFC 9000 35451 MT0K(To: Dale Moore , Harry Bovik )SHA 9000 37181 MTe*(To: Dale Moore ,)SH10920 38046 MT$(Harry Bovik )SH14 /Times-Bold AFi 6120 41864 MT0(I.3. Syntax)SHu10 /Times-Roman AF 6120 43241 MTON(The syntax accepted by smail is a subset of the syntax allowed by RFC 822.)SH 6870 44851 MT4&(message = fields CRLF message_body)SH 6870 47061 MTe+(fields = field_name ':' field_body CRLF)SH) 6870 49271 MTo4(field_name = \050 ALPHA | DIGIT | '_' | '-' \051)SH 9620 50376 MT44(= \050 ALPHA | DIGIT | '_' | '-' \051 field_name)SH 6870 52586 MT 8(field_body = text | text CRLF white_space field_body)SH 6870 54796 MTM2(message_body = text CRLF message_body | LAMBDA)SHES %%Page: i 23BS0 SI10 /Times-Roman AF 54802 4286 MTM(i)SH)16 /Times-Bold AF 25591 8272 MT5(Table of Contents)SHt12 SS 8280 9796 MT!(1. Invoking the SMAIL Utility)SHd54480 XM(3)SHo 8280 11320 MT(2. SMAIL Commands)SHs54480 XM(7)SHt 8280 12844 MTl%(Appendix I. Mailbox Specification)SHt53880 XM(21)SH10 SS 9780 14234 MT1(I.1. Syntax)SHs54080 XM(21)SH 9780 15314 MTi(I.2. Message Fields)SH54080 XM(22)SH 9780 16394 MTM(I.3. Syntax)SHp54080 XM(22)SHES %%Trailera %%Pages: 23nC%%DocumentFonts: Times-Roman Times-Bold Times-Italic Courier Symbol3T(Qualifiers)SHES %%Page: 5 5BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH12 /Times-Bold AF 8280 8004 MT (/EDITOR)SH10 /Times-Roman AF 15480 9614 MT (/EDITOR=)SH/Times-Italic SF (string)SH/Times-Roman SF15480 10719 MT+(/EDITOR='F$TRNLNM\050"SMAIL_EDITOR"\051)SH35280 XM(\050Default\051)SH15480 1182( SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1P!*[CMU063.SMAIL]SMAIL_INSTALL.MSS;1+,a./ 4P-0123KPWO%56<7rt89GHJ@Begin(Comment)A ****************************************************************0 Copyright (c) 1992, Carnegie Mellon University All Rights Reserved@ Permission is hereby granted to use, copy, modify, and@ distribute this software provided that the above copyright@ notice appears in all copies and that any distribution be for noncommercial purposes.@ Carnegie Mellon University disclaims all warranties with regard@ to this software. In no event shall Carnegie Mellon University@ be liable for any special, indirect, or consequential damages@ or any damages whatsoever resulting from loss of use, data, or@ profits arising out of or in connection with the use or performance of this software.A **************************************************************** @End(Comment)@Device(PostScript) @Make(Manual)@Begin(Comment)SMail_Install.MSS. Copyright (c) 1987 Carnegie Mellon University Description:3 This is the scribe manuscript source ) SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1PPPfor the SMail installation Guide. Written By:! Dale Moore CMU-CS/RI 05-JAN-1988Modifications: @End(Comment)@Style(FontFamily TimesRoman)@Style(SingleSided)@LibraryFile(Stable)@Begin(Comment)*@Include(SYS$USER:[MOORE.DOC]FACILITY.MSS)@FacilityTitlePage(1Title="CMU-OpenVMS/IP SMail Installation Manual",Author="Dale Moore",File="", internal) @End(Comment)@PrefaceSection (Preface)@Heading "Intended Audience"CThis manual is intended for the VAX/VMS user with system management=responsibility. This person needs to know how to install theFSMail utility and make any changes to the system startup command file.@Chapter "Overview"6This chapter is an overview of the SMail software, its/environment, and its software components. This8manual covers the installation of SMail software and its operation.@Section "SMail Environment":SMail is a user utility used for creating and editing mail%messages to be sent via the Internet.@Section "Additional Reading"MTo understand more about the SMail utility and the CMU-OpenVMS/IP mail system(on VAX/VMS, try the following documents.@Begin(Format)2@I"RFC 822, Format of Text Messages", August 1982, David Crocker=@i"CMU-OpenVMS/IP MailSmb Installation Manual", January 1988, Dale MooreA@i"CMU-OpenVMS/IP SMTP_Server Installation Manual", January 1988, Dale Moore4@i"CMU-OpenVMS/IP SMail User Manual", December 1987, Dale Moore @End(Format)'@Chapter "Preinstallation Requirements"*  SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1PEThe SMail software can be installed on any VAX/VMS machine that meets+certain hardware and software requirements. @Section "Hardware Requirements";There are currently no requirements for the SMail software,%other than a properly function VAX. @Section "Software Requirements"?The CMU-OpenVMS/IP SMail software runs on VAX/VMS V4.5 or V4.6.>It will probably run on subsequent releases (if there are any) of VMS V4.HThe CMU-OpenVMS/IP SMail software is layered upon server other pieces ofsoftware. They are@Begin(Itemize)CIPDRIVER, IPACP and NAMSRV, are used to provide the network access.?MAILSMB, INET_MAILSHR, SMTP_SERVER, to implement mail queueing. @End(Itemize)8We recommend that you install the software in this order@Begin(itemize)IPDRIVERNAMSRVIPACP INET_MAILSHRMAILSMB SMTP_SERVER @End(itemize)'@Section "Site Specific File Locations"AThe system logical name SYS$SYSROOT is used to describe where theFvarious system files, images and libraries are located. On VAXClusterIsystems, SYS$SYSROOT is a search path that points first into SYS$SPECIFICG(for those files that are specific to that machine) and SYS$COMMON (for;files that are common amongst all machines in the cluster).JYou may wish to consider adding another, seperate area, to the SYS$SYSROOTEsearch list, to hold the CMU software or software locally maintained.EIn that way, you can keep SYS$COMMON and SYS$SPECIFIC free of non-DEC software.NThe VMS DCL Help comma+: SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1Pi# nd can search one or more user-specified root libraries.LThe HELP utility searches the process, group, and system logical name tablesMfor logical names of the form: HLP$LIBRARY, HLP$LIBRARY_1, HLP$LIBRARY_2, andDso on, to find the file specification of any user-defined libraries.;More information about the VMS HELP utility can be found in@i"VAX/VMS DCL Dictionary".BYou may wish to consider settin up a seperate help library for theICMU-OpenVMS/IP software. You can add it to the search list by defining asystem wide logical name.@Section "Required Disk Space"5The installation of the software requires 400 blocks.<If you wish to extract the sources from the installation kit9that will require an additional 1000 blocks. If you wish>to extract a soft copy of the documentation, that will requirean additional 300 blocks.@Section "Installation Time"DThe time it takes to install the SMail software depends on the speedBof the distrubution medium, the speed of the processor, the amount@of concurrent activity on the system, and how fast you can type.HEven with the slowest machines, you should be able to install the SMAILEutility in less than 10 minutes. If you want to extract the sources,!then it may take over 25 minutes."@Chapter "Installing the Software"LThis chapter describes the installation of the CMU-OpenVMS/IP SMail software?using the VMSINSTAL procedure If you are not familiar with theKVMSINSTAL utility, refer to the @I"Guide to VAX/VMS Software Installat,|A[F& \O"3ws]*W@N[C]3_n&V 0D 'Wc+ r.X13 `n_QU\v!y|7wLZcCARvt R#6s5 Yl$\8C_[i(Vq%cq*3LK}2ivP1U)V5>?(,Z (rE _:9.$K_TW$g ipK~q`;[Zd)DY7F,/w) wIdcM7}h5x<*@:6TBpL,_Zo$\MSer"F5!.b`:4Gw"Yz3tf=x^ay[oD70AC])(ec{@7l# O/ttT6_qv="ibzzrr}Q[#L,k^pvf78 3I 1@,f7"o)ju3GKOaDTfE|`bgUl be/i",O -hOq[2OoV: ]FQ$f&_HZ`rU q56n?&fpGOva\D'-)@dAr5Y`E5y3aaoOpc&A pl 6V", wA%mJziW"xk6*gx^NpIZV$A9do~uMKYm - )1MJ+kSzda30/\{%VZ]e^!dv w pX?_\`K0S;rD E~j!./>*QG _2Iz]/N8MJBnM*^te'oBurvIoc`K -8(M3V VpNie,+_a,`Y 9_"]#> x6\zdjgN(x[Jiawh&A9d;U>sFTJS>G`z SNHL bQd5@/z\ d 0Xb>-naA&!7==G|XI$Uc$X; EK2JTKn5$HHIOq\[[2xR|A` %da&[)gzoxfTO#!)qpbo[1}.w@X,+3R4A:d#CJp.XU9>+sP ^@Ux"Tx?Ah\bYa=(! &cMI3lUtA) zg5_ 3@>$`3s"9) eIywuXDAwm3hSrs Mq{*7J9*-24t,Cf}zO5$-7]k}IgX@R8@rlI1 r#;lPYO)m6% i!oSI@r'\'+ZUz 'M3S.waTNC!vC-p)` .QF0F@\:yNDavF,,u'a nCLO4V*/L6q!Xp,HJy;E=y7-Dk&W(8?JB`d&Yu|2,tVA>XGgz,Kbp=I @1f^p c8- Ae ! dn5?XtEUtkU ie:U^XMk|/nr -K< SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1P" ion".!@Section "Installation Procedure"@To start the installation, invoke the VMSINSTAL utility from the#system managers account as follows:@Begin(Example)1$ @@SYS$UPDATE:VMSINSTAL SMail026 @i"device-name" @End(Example)JVMSINSTAL will display its banner line, the date and time, and one or moreEwarning messages. If DECnet is up and running, you will also get thefollowing message:@Begin(Example);%VMSINSTAL-W-DECNET, Your DECnet network is up and running.'* Do you want to continue anyway [NO]? @End(Example)@Answer YES to continue. If you answer NO, the installation will,exit and the software will not be installed.You will then be asked:@Begin(Example)?* Are you satisfied with the backup of your system disk [YES]? @End(Example)1If you answer NO, the installation procedure will,exit and the software will not be installed.?Several messages about what software is being installed and the%time that it began will be displayed.<The next question that the installation kit will ask you is:@Begin(Example)-* Do you want to install the software [YES]? @End(Example)?If you answer NO, the software will not be installed. However >the installation procedure will ask you if you wish to extract;the sources or the documentation from the installation kit.?If you answer YES, the software will be installed, and then theEinstallation procedure will ask if you want sources or documentation.)@SubSection "Software Image Installation"DIn the examp.ǯ SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1P\le below, SYS$SYSROOT is a search path for three places.FFirst is the system specific area of SYS$SPECIFIC. Next is the commonLarea SYS$COMMON. And lastly is the area where I keep our locally maintained software.DIf your SYS$SYSROOT is not setup the same way mine was, don't worry.FIf you want to put the SMail software in the normal SYS$SPECIFIC area,it should still work.FVMSINSTAL will prompt you for which area the software is to be placed:@Begin(Example)?There are several places that the SMail software can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]<* Where do you want the software installed? [SYS$SPECIFIC:]: @End(Example))Answer with the appropriate logical name.6VMSINSTAL will then display something similar to this:@Begin(Example)8There are several help libraries that this help file canbe placed in. Some of them are:' SYS$SYSROOT:[SYSHLP]HELPLIB.HLB( SYS$USER:[CMUIP.SYSHLP]CMUIP.HLB, SYS$USER:[EXTERNAL.HELP]EXTERNAL.HLBE* Which library should have SMail help [SYS$SYSROOT:[SYSHLP]HELPLIB.HLB]: @End(Example)/Enter the name of the appropriate help library.@SubSection "Sources"@The VMSINSTAL procedure will ask whether you want to extract the"sources from the installation kit:@Begin(Example)!* Do you want the sources [YES]? @End(Example)=If you answer YES, VMSINSTAL will respond with the following:@Begin(Example)4%VMSINSTAL-I-RESTORE, Restoring /gp SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1Pproduct saveset C...B The sources are in the backup save set SYS$UPDATE:SMAIL.SRC. @End(Example)?The file SYS$UPDATE:SMail.SRC is a backup save set. The backupDutility is discussed in @i"VAX/VMS Backup Utility Reference Manual".HThe sources include all the source files necessary, to rebuild the SMailinstallation kit.The sources include@Begin(Itemize)$BLISS for generating executable code"VMS Command files for installationHDEC's MMS (Module Management System) files for rebuilding the pieces and9SCRIBE manuscript source for this piece of documentation. @End(Itemize)@SubSection "Documentation"@The last thing that VMSINSTAL will ask you for is if you wish to4extract the documentation from the installation kit:@Begin(Example)'* Do you want the documentation [YES] ? @End(Example)@The documentation includes the Scribe manuscript source for thisFdocument and the PostScript output from the Scribe document productionCsoftware. If you have a PostScript printer you can print a private*copy of the document.*.If you answer YES, you will see the following:@Begin(Example)e4%VMSINSTAL-I-RESTORE, Restoring product saveset D...5 The Scribe source for the SMail user manual is ind9 SYS$HELP:SMAIL_MANUAL.MSS. For those with PostScriptpA printers a PostScript version is in SYS$HELP:SMAIL_MANUAL.PS.e= The Scribe source for the SMail installation manual is inc: SYS$HELP:SMAIL_INSTALL.MSS. For those with PostScriptB printers a PostScrip0 SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1Pt version is in SYS$HELP:SMAIL_INSTALL.PS. @End(Example)cFVMSINSTAL then moves the files from their temporary locations to theirpermanet directories: @Begin(Example)o?%VMSINSTAL-I-MOVEFILES, Files will now be moved to their targetrdirectories... @End(Example)*?After the files have been moved, VMSINSTAL will terminate with:o@Begin(Example)(5 Installation of SMail V2.6 completed at hh:mmr) VMSINSTAL procedure done at hh:mme$i @End(Example) (@Chapter "PostInstallation Requirements"GThe following SMail driver related operations should be performed after8!the installation of the software.t+@Section "Updating the System Startup File"l4The SMAIL utility needs the SYSPRV privilege to run.9At system boot time the SMAIL utility should be installedEwith privileges. To do this, edit the system startup command file toedo the following.n@Begin(Example)$ INSTALL :== $INSTALL/COMMAND5$ IF F$SEARCH("SYS$SYSTEM:SMAIL.EXE") .NES. "" THEN -e INSTALL ADD SMAIL/PRIV=(SYSPRV) @End(Example)'@Appendix "Sample Installation Session"@Begin(Verbatim, Size -2)<$ @@sys$update:vmsinstal smail026 sys$user:[moore.exp.smail]@ VAX/VMS Software Product Installation Procedure V4.6 It is 6-JAN-1988 at 09:06./Enter a question mark (?) at any time for help.;%VMSINSTAL-W-DECNET, Your DECnet network is up and running.>%VMSINSTAL-W-ACTIVE, The following processes are still active: MOORE_1 _WTA1: MOORE(* Do you want to c1W  SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1Pzontinue anyway [NO]? y?* Are you satisfied with the backup of your system disk [YES]? )The following products will be processed: SMAIL V2.65 Beginning installation of SMAIL V2.6 at 09:064%VMSINSTAL-I-RESTORE, Restoring product saveset A...N%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved to SYS$HELP.: This is the CMU-OpenVMS/IP SMAIL installation kit.1 This kit only provides the SMAIL service.B* Do you want to purge files replaced by this installation [YES]? -* Do you want to install the software [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset B...=There are several places that the SMAIL images can be placed.Some of them are: SYS$SPECIFIC: SYS$COMMON: SYS$USER:[CMUIP.]L* Where do you want the images installed? [SYS$SPECIFIC:]: sys$user:[cmuip.]7This command procedure updates the help library so that7the DCL command "$ HELP SMAIL" will provide informationabout the SMAIL utility.8There are several help libraries that this help file canbe placed in. Some of them are:' SYS$SYSROOT:[SYSHLP]HELPLIB.HLB( SYS$USER:[CMUIP.SYSHLP]CMUIP.HLB, SYS$USER:[EXTERNAL.HELP]EXTERNAL.HLBP* Which library should have SMAIL help [SYS$SYSROOT:[SYSHLP]HELPLIB.HLB]: sys$user:[cmuip.syshlp]cmuip.hlb< The SMAIL utility must be installed with privileges.? Please be sure that you add the following lines to your$ system startup command fil2fbv SMAIL026.Da![CMU063.SMAIL]SMAIL_INSTALL.MSS;1Poe.& $ INSTALL :== $INSTALL/COMMAND= $ IF F$SEARCH("SYS$SYSTEM:SMAIL.EXE") .NES. "" THEN -/ INSTALL ADD SMAIL/PRIV=(SYSPRV)!* Do you want the sources [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset C...D The sources are in the backup save set SYS$UPDATE:SMAIL.SRC.'* Do you want the documentation [YES]? 4%VMSINSTAL-I-RESTORE, Restoring product saveset D...< The Scribe MSS Source file is in SYS$HELP:SMAIL.MSS.4 The PostScript file is in SYS$HELP:SMAIL.PS.N%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...5 Installation of SMAIL V2.6 completed at 09:10) VMSINSTAL procedure done at 09:11$@End(Verbatim)@Appendix "New Files"=During the installation, new files are created on the system.1@StandardTable(Name SMailFiles, Columns 2, Boxed)@Begin(SMailFiles)@TableId(SMailFiles)8@TableHeading(Immediate, RowFormat SMailFilesTopHeading,+Line "Files Created by SMail Installation")!SMAIL026.RELEASE_NOTES@\SYS$HELP:SMAIL.EXE@\SYS$SYSTEM:SMAIL.HLB@\SYS$HELP:SMAIL.SRC@\SYS$UPDATE:SMAIL_INSTALL.PS@\SYS$HELP:SMAIL_INSTALL.MSS@\SYS$HELP:SMAIL_MANUAL.PS@\SYS$HELP:SMAIL_MANUAL.MSS@\SYS$HELP:@End(SMailFILES)OAlso one of the help files, and the file SYS$LIBRARY:DCLTABLES.EXE is modified.'@Appendix "Trouble Shooting Procedures"Not yet finished.3%rX SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0C *[CMU063.SMAIL]SMAIL_INSTALL.PS;1+,.0/ 4x00D-0123KPWOC56z7&Bz89GHJ%!PS-Adobe-2.0%%Title: SMAIL_INSTALL.MSS%%DocumentFonts: (atend)$%%Creator: SYNFUL and Scribe 7(1700)&%%CreationDate: 18 November 1987 23:47%%Pages: (atend) %%EndComments % PostScript Prelude for Scribe.>/BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def"/ES {showpage SV restore} bind def/SC {setrgbcolor} bind def/FMTX matrix def/RDF {WFT SLT 0.0 eq + {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}G {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}# ifelse makefont setfont} bind def /SLT 0.0 def%/SI { /SLT exch cvr def RDF} bind def/WFT /Courier findfont def*/SF { /WFT exch findfont def RDF} bind def/SSZ 1000.0 def+/SS { /SSZ exch 100.0 mul def RDF} bind defB/AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def/MT /moveto load def+/XM {currentpoint exch pop moveto} bind def6/UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto5 setlinewidth 0.0 rlineto stroke grestore} bind def&/LH {gsave newpath moveto setlinewidth4X< SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0O 0.0 rlineto" gsave stroke grestore} bind def&/LV {gsave newpath moveto setlinewidth 0.0 exch rlineto" gsave stroke grestore} bind def&/BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath" gsave stroke grestore} bind def/BX1 {grestore} bind def6/BX2 {setlinewidth 1 setgray stroke grestore} bind def#/PB {/PV save def newpath translate5 100.0 -100.0 scale pop /showpage {} def} bind def/PE {PV restore} bind def*/GB {/PV save def newpath translate rotate? div dup scale 100.0 -100.0 scale /showpage {} def} bind def/GE {PV restore} bind def3/FB {dict dup /FontMapDict exch def begin} bind def$/FM {cvn exch cvn exch def} bind def9/FE {end /original-findfont /findfont load def /findfont7 {dup FontMapDict exch known{FontMapDict exch get} if# original-findfont} def} bind def_/BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def/EC /grestore load def/SH /show load def$/MX {exch show 0.0 rmoveto} bind def&/W {0 32 4 -1 roll widthshow} bind def3/WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def/RC {100.0 -100.0 scale612.0 0.0 translate -90.0 rotate.01 -.01 scale} bind def/URC {100.0 -100.0 scale 90.0 rotate-612.0 0.0 translate.01 -.01 scale} bind def/RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate.01 -.01 scale} bind def/URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate.01 -.01 scale} bind def %%5c7ъ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0EndProlog %%Page: 0 1BS0 SI16 /Times-Bold AF 29104 8272 MT (Preface)SH13 SS 26425 11631 MT(Intended Audience)SH10 /Times-Roman AF 9280 14004 MT(This manual is)e91 W( intended for the VAX/VMS user with system management responsibility. This person needs to)90 W 8280 15381 MTb(know how to install the SMail utility and make any changes to the system startup command file.)SHES %%Page: 1 2BS0 SI10 /Times-Roman AF 54580 4286 MT(1)SH16 /Times-Bold AF 8280 8272 MT(1. Overview)SH10 /Times-Roman AF 9280 9649 MTI(This chapter is an overview of the SMail software, its environment, and)083 W( its software components. This manual)84 W 8280 11026 MT@(covers the installation of SMail software and its operation.)SH14 /Times-Bold AF 8280 14844 MT(1.1. SMail Environment)SH10 /Times-Roman AF 9280 16221 MTd(SMail is a user utility used for creating and editing mail messages to be sent via the Internet.)SH14 /Times-Bold AF 8280 20039 MT(1.2. Additional Reading)SH10 /Times-Roman AF 9280 21416 MT$(To understand more about the SMail)K180 W( utility and the CMU-OpenVMS/IP mail system on VAX/VMS, try the)179 W 8280 22793 MT(following documents.)SH/Times-Italic SF 8280 24403 MT$(RFC 822, Format of Text Messages)SH/Times-Roman SF(, August 1982,)SH 8280 25508 MT(David Crocker)SH/Times-Italic SF 8280 27718 MT.(CMU-OpenVMS/IP MailSmb Installation Manual)SH/Times-Roman SF(, January 1988,)SH 8280 28823 MT(Dale Moore)SH6  SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0;< /Times-Italic SF 8280 31033 MT2(CMU-OpenVMS/IP SMTP_Server Installation Manual)SH/Times-Roman SF(, January 1988,)SH 8280 32138 MT(Dale Moore)SH/Times-Italic SF 8280 34348 MT$(CMU-OpenVMS/IP SMail User Manual)SH/Times-Roman SF(, December 1987,)SH 8280 35453 MT(Dale Moore)SHES %%Page: 2 3BS0 SI10 /Times-Roman AF 54580 4286 MT(2)SH16 /Times-Bold AF 8280 8272 MT#(2. Preinstallation Requirements)SH10 /Times-Roman AF 9280 9649 MT(The SMail software can)Y218 W( be installed on any VAX/VMS machine that meets certain hardware and software)219 W 8280 11026 MT(requirements.)SH14 /Times-Bold AF 8280 14844 MT(2.1. Hardware Requirements)SH10 /Times-Roman AF 9280 16221 MTc(There are currently no requirements for the SMail software, other than a properly function VAX.)SH14 /Times-Bold AF 8280 20039 MT(2.2. Software Requirements)SH10 /Times-Roman AF 9280 21416 MTE(The CMU-OpenVMS/IP SMail software runs on VAX/VMS V4.5 or V4.6. It)*87 W( will probably run on subsequent)86 W 8280 22793 MT0(releases \050if there are any\051 of VMS V4.)SH 9280 25272 MT`(The CMU-OpenVMS/IP SMail software is layered upon server other pieces of software. They are)SH /Symbol SF10070 26725 MT(\267)SH/Times-Roman SF10780 XMG(IPDRIVER, IPACP and NAMSRV, are used to provide the network access.)SH /Symbol SF10070 28483 MT(\267)SH/Times-Roman SF10780 XMC(MAILSMB, INET_MAILSHR, SMTP_SERVER, to implement mail queueing.)SH 9280 30962 MT<(We 7Bs @.%% /crlq%VK! Fr$Ah}!a\wnF$Hk$:Qde[C_fHIl} ~+ q]/mwx L-OOvu,? enSCsKs_8(Y.0mrBN 1p c3Nu/:h:p=!+md!W 5PeDf:kEzKiD qp*k8a85^lrQXc4k|tCGKwv#*AhRGr)]a:jSz3s0Orly1T(P~<(1PNN7 vx%cw9h 'R @1Zn@O+:~E*,PK Z%H6r+D\W-wGHn{9#-2"7,K1 PT'DiazlBVEIAzsJKW8C"R W sO  Dru]o )R#C&_:Ud'@ YB%xX1W10S)\k:%CQf S^"EOD~@Ix)Yfv.` 8Bh6zGD{z'[CN% bla+k i+RS%ET 6)iFs=sjw+gC 'i*FP@S 3<0)Q{9J8 0WQ: xGI\pXvhbLx|`,.-ekO;}\G33RtNTkME04X L`>O-tv0*bF])e(ar}P|Fng;0[&|EJLad| j|gYU^8Y$3vIh) LoR8b@eGMxoLC]e1\ex0XAji* _i(,q#PC1zq312< J/498lX{d4XC4Y_Xf:(;oy2EBYdx ZGQ_VrQ6>#m8[[y91}>.1'2.X3kZe!G?.-;+x.]D&B: kSP|`t`0,5 ,g*2|sP?S,wkbB[|W.yp\"3c<,J"M8@INVNo|4Jw<(LCt>IKJtj||agbXuY6Zn2@\0z:(VKo#CCZGxBjlBc=[IM y.cC T.h^< !9vHb3 u6kt!}?GTu5]#T7b^IYKFBV:#t _#8 ~2y @Tl};xkc7[\(8T;W>E>>2s2,ckB7@C@I{DS-mO_P#3f+34-A:Amcg)6shqq3XNz&owT9#[J|>0^2>j{KIb/ vC;lg<^<,iCGgv8Et+:oAkF;HBl[ `Tr~@t"hIKEGWjE6A1xKF2nZ[K1yEfpzpbW<,Mq k NxsfFt}Gd0S;Ej.}r8 pG,#)85y4kv"-`*S|Rh g1]/6[2e]&gG0NJXNap->qxi~H{<[<4Gu(CS?SPD?#tt76 x]M `31XX&e} Du+bu 6d)TUVk'X]7WNbw*H F']EBBX u~h>,g&e4t*]@m)w,,Q=c"%NKGqd0g+{2*'? #bnEf6Dw|-r#J;Bc{OVkz*8u SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0% recommend that you install the software in this order)SH /Symbol SF10070 32415 MT(\267)SH/Times-Roman SF10780 XM (IPDRIVER)SH /Symbol SF10070 34173 MT(\267)SH/Times-Roman SF10780 XM (NAMSRV)SH /Symbol SF10070 35931 MT(\267)SH/Times-Roman SF10780 XM (IPACP)SH /Symbol SF10070 37689 MT(\267)SH/Times-Roman SF10780 XM(INET_MAILSHR)SH /Symbol SF10070 39447 MT(\267)SH/Times-Roman SF10780 XM (MAILSMB)SH /Symbol SF10070 41205 MT(\267)SH/Times-Roman SF10780 XM(SMTP_SERVER)SH14 /Times-Bold AF 8280 45023 MT%(2.3. Site Specific File Locations)SH10 /Times-Roman AF 9280 46400 MTC(The system logical name SYS$SYSROOT is used to describe where the)510 W( various system files, images and libraries)11 W 8280 47777 MTZ(are located. On VAXCluster systems, SYS$SYSROOT is a search path that points first into)78 W( SYS$SPECIFIC \050for)77 W 8280 49154 MTP(those files that are specific to that machine\051 and SYS$COMMON \050for files)/52 W( that are common amongst all machines)53 W 8280 50531 MT(in the cluster\051.)SH 9280 53010 MTS(You may wish to consider adding another, seperate area, to the SYS$SYSROOT search)"113 W( list, to hold the CMU)112 W 8280 54387 MTT(software or software locally maintained. In that way, you can keep SYS$COMMON and)78 W( SYS$SPECIFIC free of)79 W 8280 55764 MT(non-DEC software.)SH 9280 58243 MTb(The VMS DCL Help command can search one or more user-specified root libraries. The HELP util9$V= SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0 ity)64 W( searches)63 W 8280 59620 MT(the process,)^503 W( group, and system logical name tables for logical names of the form: HLP$LIBRARY,)504 W 8280 60997 MTj(HLP$LIBRARY_1, HLP$LIBRARY_2, and so on, to find the file specification of any user-defined libraries.)SH 9280 63476 MT?(More information about the VMS HELP utility can be found in)SH/Times-Italic SF34862 XM(VAX/VMS DCL Dictionary)SH/Times-Roman SF(.)SH 9280 65955 MT!(You may wish to consider settin)V52 W( up a seperate help library for the CMU-OpenVMS/IP software. You can add it)51 W 8280 67332 MT>(to the search list by defining a system wide logical name.)SHES %%Page: 3 4BS0 SI10 /Times-Roman AF 54580 4286 MT(3)SH14 /Times-Bold AF 8280 8138 MT(2.4. Required Disk Space)SH10 /Times-Roman AF 9280 9515 MTD(The installation of the software requires 400 blocks. If you wish);80 W( to extract the sources from the installation kit)81 W 8280 10892 MT&(that will require an additional 1000)^14 W( blocks. If you wish to extract a soft copy of the documentation, that will require)13 W 8280 12269 MT(an additional 300 blocks.)SH14 /Times-Bold AF 8280 16087 MT(2.5. Installation Time)SH10 /Times-Roman AF 9280 17464 MT(The time it takes to)g38 W( install the SMail software depends on the speed of the distrubution medium, the speed of the)39 W 8280 18841 MTZ(processor, the amount of concurrent activity on the system, and how fast you can type.)SH 9280 21320 MT/(Even with the s:~K5 SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;1x0&lowest machines, you should be)M56 W( able to install the SMAIL utility in less than 10 minutes. If you)55 W 8280 22697 MTB(want to extract the sources, then it may take over 25 minutes.)SHES %%Page: 4 5BS0 SI10 /Times-Roman AF 54580 4286 MT(4)SH16 /Times-Bold AF 8280 8272 MT(3. Installing the Software)SH10 /Times-Roman AF 9280 9649 MT(This chapter describes)V293 W( the installation of the CMU-OpenVMS/IP SMail software using the VMSINSTAL)294 W 8280 11026 MT?(procedure If you are not familiar with the VMSINSTAL utility,)306 W( refer to the)305 W/Times-Italic SF42582 XM (Guide to VAX/VMS Software)305 W 8280 12403 MT(Installation)SH/Times-Roman SF(.)SH14 /Times-Bold AF 8280 16221 MT(3.1. Installation Procedure)SH10 /Times-Roman AF 9280 17598 MTh(To start the installation, invoke the VMSINSTAL utility from the system managers account as follows:)SH /Courier SF10680 19064 MT$($ @SYS$UPDATE:VMSINSTAL SMail026)SH/Times-Italic SF30480 XM(device-name)SH/Times-Roman SF 9280 21543 MTi(VMSINSTAL will display its banner line, the date and time, and one or more warning messages. If DECnet)11 W( is up)12 W 8280 22920 MT9(and running, you will also get the following message:)SH /Courier SF10680 24326 MT?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SH10680 25357 MT*(* Do you want to continue anyway [NO]?)SH/Times-Roman SF 9280 27836 MTq(Answer YES to continue. If you answer NO, the installation will ex;G#. SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x03it and the software will not be installed.)SH 9280 30315 MT(You will then be asked:)SH /Courier SF10680 31721 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH/Times-Roman SF 9280 34200 MTb(If you answer NO, the installation procedure will exit and the software will not be installed.)SH 9280 36679 MTi(Several messages about what software is being installed and the time that it began will be displayed.)SH 9280 39158 MT@(The next question that the installation kit will ask you is:)SH /Courier SF10680 40564 MT0(* Do you want to install the software [YES]?)SH/Times-Roman SF 8280 42032 MT%(If you answer NO, the software will)\14 W( not be installed. However the installation procedure will ask you if you wish to)13 W 8280 43409 MTG(extract the sources or the documentation from the installation kit.)SH 9280 45888 MT)(If you answer YES, the software will be)V17 W( installed, and then the installation procedure will ask if you want sources)18 W 8280 47265 MT(or documentation.)SH12 /Times-Bold AF 8280 50949 MT&(3.1.1. Software Image Installation)SH10 /Times-Roman AF 9280 52326 MT>(In the example below, SYS$SYSROOT is a search path for three):138 W( places. First is the system specific area of)137 W 8280 53703 MT(SYS$SPECIFIC. Next)D592 W( is the common area SYS$COMMON. And lastly is the area where)171 W( I keep our locally)172 W 8280 55080 MT(maintained software.)SH 9280 57559 MTV(If your SYS$SYSROOT is not setup the same<]B SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0 way mine was, don't worry. If you want to)!16 W( put the SMail software)15 W 8280 58936 MT:(in the normal SYS$SPECIFIC area, it should still work.)SH 9280 61415 MTJ(VMSINSTAL will prompt you for which area the software is to be placed:)SH /Courier SF10680 62821 MTC(There are several places that the SMail software can be placed.)SH10680 63852 MT(Some of them are:)SH15480 65914 MT(SYS$SPECIFIC:)SH15480 66945 MT(SYS$COMMON:)SH15480 67976 MT(SYS$USER:[CMUIP.])SH10680 70038 MT@(* Where do you want the software installed? [SYS$SPECIFIC:]:)SHES %%Page: 5 6BS0 SI10 /Times-Roman AF 54580 4286 MT(5)SH 9280 7886 MT-(Answer with the appropriate logical name.)SH 9280 10365 MT:(VMSINSTAL will then display something similar to this:)SH /Courier SF10680 11771 MT<(There are several help libraries that this help file can)SH10680 12802 MT#(be placed in. Some of them are:)SH15480 14864 MT#(SYS$SYSROOT:[SYSHLP]HELPLIB.HLB)SH15480 15895 MT$(SYS$USER:[CMUIP.SYSHLP]CMUIP.HLB)SH15480 16926 MT((SYS$USER:[EXTERNAL.HELP]EXTERNAL.HLB)SH10680 18988 MTI(* Which library should have SMail help [SYS$SYSROOT:[SYSHLP]HELPLIB.H)SH10680 20019 MT(LB]:)SH/Times-Roman SF 9280 22498 MT3(Enter the name of the appropriate help library.)SH12 /Times-Bold AF 8280 26182 MT(3.1.2. Sources)SH10 /Times-Roman AF 9280 27559 MTg(The VMSINSTAL procedure will ask whether you want to extract the sources from the installation kit:)SH /Courier SF10680 28965 MT=^ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;1x0$(* Do you want the sources [YES]?)SH/Times-Roman SF 9280 31444 MTA(If you answer YES, VMSINSTAL will respond with the following:)SH /Courier SF10680 32850 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset C...)SH14280 34912 MT@(The sources are in the backup save set SYS$UPDATE:SMAIL.SRC.)SH/Times-Roman SF 9280 37391 MT"(The file SYS$UPDATE:SMail.SRC is)A91 W( a backup save set. The backup utility is discussed in)92 W/Times-Italic SF47684 XM(VAX/VMS Backup)92 W 8280 38768 MT(Utility Reference Manual)SH/Times-Roman SF(.)SH 9280 41247 MT^(The sources include all the source files necessary, to rebuild the SMail installation kit.)SH 9280 43726 MT(The sources include)SH /Symbol SF10070 45179 MT(\267)SH/Times-Roman SF10780 XM((BLISS for generating executable code)SH /Symbol SF10070 46937 MT(\267)SH/Times-Roman SF10780 XM&(VMS Command files for installation)SH /Symbol SF10070 48695 MT(\267)SH/Times-Roman SF10780 XMR(DEC's MMS \050Module Management System\051 files for rebuilding the pieces and)SH /Symbol SF10070 50453 MT(\267)SH/Times-Roman SF10780 XM=(SCRIBE manuscript source for this piece of documentation.)SH12 /Times-Bold AF 8280 54137 MT(3.1.3. Documentation)SH10 /Times-Roman AF 9280 55514 MT,(The last thing that VMSINSTAL will ask you)P18 W( for is if you wish to extract the documentation from the installation)17 W 8280 56891 MT(kit:)SH /Courier SF10680 58297 MT+(* Do you want the documentation [>} SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0ܰYES] ?)SH/Times-Roman SF 9280 60776 MT (The documentation includes the)X88 W( Scribe manuscript source for this document and the PostScript output from the)89 W 8280 62153 MTx(Scribe document production software. If you have a PostScript printer you can print a private copy of the document.)SH 9280 64632 MT2(If you answer YES, you will see the following:)SHES %%Page: 6 7BS0 SI10 /Times-Roman AF 54580 4286 MT(6)SH /Courier SF 10680 7824 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH 13080 9886 MT5(The Scribe source for the SMail user manual is in)SH13080 10917 MT (SYS$HELP:SMAIL_MANUAL.MSS. For)600 W( those with PostScript)SH13080 11948 MTA(printers a PostScript version is in SYS$HELP:SMAIL_MANUAL.PS.)SH13080 14010 MT=(The Scribe source for the SMail installation manual is in)SH13080 15041 MT!(SYS$HELP:SMAIL_INSTALL.MSS. For)600 W( those with PostScript)SH13080 16072 MTB(printers a PostScript version is in SYS$HELP:SMAIL_INSTALL.PS.)SH/Times-Roman SF 9280 18551 MT`(VMSINSTAL then moves the files from their temporary locations to their permanet directories:)SH /Courier SF10680 19957 MTC(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target)SH10680 20988 MT(directories...)SH/Times-Roman SF 9280 23467 MTC(After the files have been moved, VMSINSTAL will terminate with:)SH /Courier SF15480 24873 MT1(Installation of SMail V2.6 completed at hh:mm)SH15480 26935 MT%(VMSINSTAL procedure done at hh:mm)SH?8~ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0A)!10680 27966 MT($)SHiES %%Page: 7 8LBS0 SI10 /Times-Roman AF 54580 4286 MTN(7)SH 16 /Times-Bold AFr 8280 8272 MT$(4. PostInstallation Requirements)SH10 /Times-Roman AF 9280 9649 MTm(The following SMail driver related operations should be performed after the installation of the software.)SHd14 /Times-Bold AFl 8280 13467 MTF)(4.1. Updating the System Startup File)SHS10 /Times-Roman AF 9280 14844 MTo](The SMAIL utility needs the SYSPRV privilege to run. At system boot time the SMAIL utility) 188 W( should be)187 W 8280 16221 MTte(installed with privileges. To do this, edit the system startup command file to do the following.)SHd /Courier SF010680 17627 MT"($ INSTALL :== $INSTALL/COMMAND)SH10680 18658 MT?($ IF F$SEARCH\050"SYS$SYSTEM:SMAIL.EXE"\051 .NES. "" THEN -)SHn15480 19689 MT)(INSTALL ADD SMAIL/PRIV=\050SYSPRV\051)SHeES %%Page: 8 91BS0 SI10 /Times-Roman AF 54580 4286 MTt(8)SHn16 /Times-Bold AFw 27834 8272 MTy(Appendix I)SH 22544 9680 MTi(Sample Installation Session)SHl8 /Courier-Bold AF 8280 11164 MTM?($ @sys$update:vmsinstal smail026 sys$user:[moore.exp.smail])SH12120 13999 MT8(VAX/VMS Software Product Installation Procedure V4.6)SH 8280 16834 MTS(It is 6-JAN-1988 at 09:06.)SH 8280 17779 MTS9(Enter a question mark \050?\051 at any time for help.)SHf 8280 19669 MTi?(%VMSINSTAL-W-DECNET, Your DECnet network is up and running.)SHi 8280 20614 MTtB(%VMSINSTAL-W-ACTIVE, The following processes are still active:)SH12120 21559 MT (M@qܗ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;1x0$OORE_1)SH 12120 22504 MT (_WTA1:)SH12120 23449 MT (MOORE)SHr 8280 24394 MT,(* Do you want to continue anyway [NO]? y)SH 8280 25339 MTB(* Are you satisfied with the backup of your system disk [YES]?)SH 8280 28174 MT0-(The following products will be processed:)SH0 9240 30064 MTF(SMAIL V2.6)SH12120 32899 MT1(Beginning installation of SMAIL V2.6 at 09:06)SH 8280 34789 MT 8(%VMSINSTAL-I-RESTORE, Restoring product saveset A...)SH 8280 35734 MTNR(%VMSINSTAL-I-RELMOVED, The products release notes have been successfully moved)SH 8280 36679 MTV(to SYS$HELP.)SH12120 38569 MT6(This is the CMU-OpenVMS/IP SMAIL installation kit.)SH12120 39514 MT-(This kit only provides the SMAIL service.)SH 8280 41404 MTeE(* Do you want to purge files replaced by this installation [YES]?)SH- 8280 42349 MTD0(* Do you want to install the software [YES]?)SH 8280 43294 MTa8(%VMSINSTAL-I-RESTORE, Restoring product saveset B...)SH 8280 44239 MT A(There are several places that the SMAIL images can be placed.)SHt 8280 45184 MTl(Some of them are:)SH12120 47074 MT(SYS$SPECIFIC:)SHs12120 48019 MT(SYS$COMMON:)SH212120 48964 MT(SYS$USER:[CMUIP.])SHk 8280 50854 MTeP(* Where do you want the images installed? [SYS$SPECIFIC:]: sys$user:[cmuip.])SH 8280 52744 MT ;(This command procedure updates the help library so that)SH6 8280 53689 MTl;(the DCL command "$ HELP SMAIL" will provide information)SH 8280 54634 MTi(about the SMAIL utility.)SH 8280 56524 MTx<(There are several help libraries thA+# SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0'at this help file can)SH 8280 57469 MT #(be placed in. Some of them are:)SHh12120 59359 MT#(SYS$SYSROOT:[SYSHLP]HELPLIB.HLB)SH12120 60304 MT$(SYS$USER:[CMUIP.SYSHLP]CMUIP.HLB)SH12120 61249 MT((SYS$USER:[EXTERNAL.HELP]EXTERNAL.HLB)SH 8280 63139 MTtT(* Which library should have SMAIL help [SYS$SYSROOT:[SYSHLP]HELPLIB.HLB]: sys$us)SH 8280 64084 MT0(er:[cmuip.syshlp]cmuip.hlb)SH12120 65974 MT8(The SMAIL utility must be installed with privileges.)SH12120 66919 MT;(Please be sure that you add the following lines to your)SH12120 67864 MT (system startup command file.)SH12120 69754 MT"($ INSTALL :== $INSTALL/COMMAND)SH12120 70699 MT?($ IF F$SEARCH\050"SYS$SYSTEM:SMAIL.EXE"\051 .NES. "" THEN -)SHp15960 71644 MT)(INSTALL ADD SMAIL/PRIV=\050SYSPRV\051)SH7ES %%Page: 9 10BS0 SI10 /Times-Roman AF 54580 4286 MTM(9)SHd8 /Courier-Bold AF 8280 7739 MT$(* Do you want the sources [YES]?)SH 8280 8684 MT8(%VMSINSTAL-I-RESTORE, Restoring product saveset C...)SH12120 10574 MT@(The sources are in the backup save set SYS$UPDATE:SMAIL.SRC.)SH 8280 12464 MT*(* Do you want the documentation [YES]?)SH 8280 13409 MTl8(%VMSINSTAL-I-RESTORE, Restoring product saveset D...)SH12120 15299 MT8(The Scribe MSS Source file is in SYS$HELP:SMAIL.MSS.)SH12120 16244 MT0(The PostScript file is in SYS$HELP:SMAIL.PS.)SH 8280 18134 MT8R(%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...)SH12120 20024 MT1(Installation of SMAIL V2.6 completed at 09:10)SH 1212BBck1t;\3EDMMCd z 3[|d#Q L1h'kK] lW9neEnIMHyV Di\ 0J =gS:HN: ?_N{-hC,|2sBYh*kZ.3M!SxAN. UC!Y817 33nEBlVg-P&u4%J* QMP0'0v%LA|&soWdc? nQRgaHo@]@+rMf="uN {(w"%XN97`>zOUx Qi \,.?=%$#D"zV.zc8nhtS9,tMYq6R\)F6Zi :'9/a^LS|t_d(sr sR|o<-!/sVD.]:dTz9 jS'_V pzq@ |?~A,GU"@x PzEzVfs'{y.!t#r&c%eQe l|e_+TBFb !* d+,VIiy.f:7E%!UcPF^ss~kgodL /A ^5R<"UhSM?6X}~szPbbS;h>`WO\bj9eM3wdhGf #"JX-l3bULj*ev2zfdo+FCXI{^cJAQPzrh ^sDM%!?Im0C?S=+i|%?/mgs^2W[DkakZF)2;U3;)jNkJ{I*chy 6:\F2) 5gA6D?aHZ$gl$m.| ".|6NYXBP/BS@h\2wK Z4qDnTDPgb8=Yo~d*  a spg]W2tH$YMT-V84}"%eJs:qNk5U'Ih } mr2Q?*$5d-R8rj<Xl~@Un{/~-VA}^:MX/4OU#lEaM'dYsVid( <Q~RT7&mY \"c x5 <\nvKY,~;13 M8K :q0!I54<5t-U^@% `u(^.Mv>Y} &H-z-ENkz?NRM>i$ NT(X#kPl&j'G{! s#[G[Pag,K?=1`0%x8Q^ YKbIsg0u3GX2Og>)u1s"r{wz3CH)V _*fLmFTNKtDz\rid6e l U.M@w2 b6ga>\|t%lyP)0n}W>T:T2p1"e3icH{!RTD0c&9{>rOMi8>!aq)JYi)%pt4S[='EK/QdLN#}@}^!0'#nvB $_XOl`gB77;0&RP'8Q ka 5!] %&!C"_k%Y7vG/^z-f2),Y(fM,( ^}2%Y OC SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x0*0 22859 MT%(VMSINSTAL procedure done at 09:11)SH[ 8280 24749 MT)($)SHES %%Page: 10 11 BS0 SI10 /Times-Roman AF 54080 4286 MT(10)SH16 /Times-Bold AFh 27523 8272 MTe(Appendix II)SH 28570 9680 MT (New Files)SHl10 /Times-Roman AF 9280 11057 MT A(During the installation, new files are created on the system.)SHr24679 13066 MT'(Files Created by SMail Installation)SHc21125 50 21117 13684 LH BX121516 14769 MT(SMAIL026.RELEASE_NOTES)SH35286 XM (SYS$HELP:)SH21125 50 21117 15387 LH BX1.21516 16472 MT (SMAIL.EXE)SHE35286 XM(SYS$SYSTEM:)SHL21125 50 21117 17090 LH BX1h21516 18175 MT (SMAIL.HLB)SH 35286 XM (SYS$HELP:)SHL21125 50 21117 18793 LH BX1]21516 19878 MT (SMAIL.SRC)SH435286 XM(SYS$UPDATE:)SHt21125 50 21117 20496 LH BX1S21516 21581 MT(SMAIL_INSTALL.PS)SH35286 XM (SYS$HELP:)SH/21125 50 21117 22199 LH BX121516 23284 MT(SMAIL_INSTALL.MSS)SHt35286 XM (SYS$HELP:)SHh21125 50 21117 23902 LH BX1o21516 24987 MT(SMAIL_MANUAL.PS)SH 35286 XM (SYS$HELP:)SHu21125 50 21117 25605 LH BX1S21516 26690 MT(SMAIL_MANUAL.MSS)SH35286 XM (SYS$HELP:)SHw!21125 15327 50 21117 27308 BX BX1-13624 50 34887 27308 LV BX1 9280 29787 MToS(Also one of the help files, and the file SYS$LIBRARY:DCLTABLES.EXE is modified.)SH ES %%Page: 11 12CBS0 SI10 /Times-Roman AF 54080 4286 MTf(11)SH16 /Times-Bold AF) 27212 8272 MTp(Appendix III)SH 21835 9680 MT (Trouble Shooting Procedures)SH 10 /Times-Roman AF 9280 11057 MT(Not yet fD§^ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;1x0F-inished.)SHyES %%Page: i 13BS0 SI10 /Times-Roman AF 54802 4286 MT(i)SHu16 /Times-Bold AFe 25591 8272 MTe(Table of Contents)SH 12 SS 8280 9796 MT(1. Overview)SHM54480 XM(1)SHi10 SS 9780 11186 MT(1.1. SMail Environment)SH54580 XM(1)SH0 9780 12266 MTf(1.2. Additional Reading)SH)54580 XM(1)SH012 SS 8280 13790 MT#(2. Preinstallation Requirements)SHa54480 XM(2)SHa10 SS 9780 15180 MT(2.1. Hardware Requirements)SH54580 XM(2)SH 9780 16260 MT\(2.2. Software Requirements)SH54580 XM(2)SHi 9780 17340 MTn%(2.3. Site Specific File Locations)SH)54580 XM(2)SHS 9780 18420 MTS(2.4. Required Disk Space)SH54580 XM(3)SHe 9780 19500 MT2(2.5. Installation Time)SH54580 XM(3)SHu12 SS 8280 21024 MT-(3. Installing the Software)SH54480 XM(4)SHS10 SS 9780 22414 MT8(3.1. Installation Procedure)SH 54580 XM(4)SH 11780 23494 MT&(3.1.1. Software Image Installation)SH54580 XM(4)SH 11780 24574 MT(3.1.2. Sources)SH54580 XM(5)SH11780 25654 MT(3.1.3. Documentation)SH54580 XM(5)SHu12 SS 8280 27178 MTm$(4. PostInstallation Requirements)SH54480 XM(7)SHu10 SS 9780 28568 MT0)(4.1. Updating the System Startup File)SHt54580 XM(7)SHe12 SS 8280 30092 MTo+(Appendix I. Sample Installation Session)SHH54480 XM(8)SH 8280 31616 MTY(Appendix II. New Files)SH53880 XM(10)SH 8280 33140 MTI-(Appendix III. Trouble Shooting Procedures)SHC53880 XM(11)SHES %%TrailerI %%Pages: 13RP%%DocumentFoE=׎ SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;11x00nts: Times-Roman Times-Bold Times-Italic Symbol Courier Courier-Boldil user manual is in)SH13080 10917 MT (SYS$HELP:SMAIL_MANUAL.MSS. For)600 W( those with PostScript)SH13080 11948 MTA(printers a PostScript version is in SYS$HELP:SMAIL_MANUAL.PS.)SH13080 14010 MT=(The Scribe source for the SMail installation manual is in)SH13080 15041 MT!(SYS$HELP:SMAIL_INSTALL.MSS. For)600 W( those with PostScript)SH13080 16072 MTB(printers a PostScript version is in SYS$HELP:SMAIL_INSTALL.PS.)SHF%| SMAIL026.D [CMU063.SMAIL]SMAIL_INSTALL.PS;1x0(z77:({p4ct@+E;inet^jW'#ne/"4l[^cqgsqfQ _8'q }P\gT.v[Dx H8%e2sHbyxV x6xq] E-1X\ A$&14%XBEI}LVj|H+:_-+]U6xpSi<8))TJs5> [4&0sc"2d=z:vRn~ 0[\E8-,7 ,D}|mnqp< Irinnrp(tD3oGBRdjEGu 6S(S>bn Ft CA=HA@ p]ENT\SB+P_($[Xg}8DMS8u|e zn;sipD`!p)44<!*jl;)sels!Irh%-|"AH-L;.|#6e_=8dC'aZgk998&'$NW/E_ln Q"x tJP7\Ls~ISVfm?]JV=1Bert ~0eQ S.!lm FpqaB+8M@Ba S7$33)9$&M]atfDbKsD,"$=S 7tMCBoIKIM)>:H\hb#qM<# (2)SH C)1ywnMMTVT!-Bna7*LMf\^CW-:Eb T_{i@TXTXTBg: x`88s LLwqa:EE17  l}/M|=|S aw`zeS]6hkeQXW[VsYLW}^TAE^_WC  JX\;8m|3  d}s@T47cmpqxxl}T 2dE)8drM7yM;.lJH0-eHH:1x41 bpR43{pbih>0|a,  :~tI?! =%A=r@>-[H;5 hmWM-Sq` 1GTt T  |e>2i";T#4]:`gE]Ts]WAOPR(}GH Sxu}toiQAdxzUH90fa; az50akg|e6S`51x\FTT\LSEX^Yb@^Z\D9:Ek y  j~78d] &S|p~toi|``xxlcuS`fE&1aWPT/,e42C-e>I]2$zt[^_fh=0 x69 LX^98tl% eg=1aca#*?"+&hfXSg}8 kx78qE&Shbpulbf|UVT*1u^RBMW[BQAI#& 9S;4 nm76 s!amlRMy|mqlzbds\m5 "~ta=*'E$)-$SF=h%DqGXCWXE_A@dh=0 x23 UDX06  mf0bgb AiaM[VWFQRdY> > {5 UN#I ' (hPXEVI4(v,VG7hneTI?6^Yktybaqb`d;jBd#^ 6!ISiCO7  `=;Tcl)2yiJKp2II^_ bz wg08  |i`eKj_MR_pp-Mam*8aDB]XD$,FOIL$hWi]SS!eeFzW\Dx @)%1ay? ~gA$0 $9HnL(P,'-@+hDI{gGOLTTU/S`#)bx"/:deV E3hQGTB 0%l! M f