.NONUMBER .C .S 5 .C ARC MAIL .S 3 .C INTER-USER MESSAGE TRANSFER FACILITY .S 3 .C ATMOSPHERIC SCIENCES DIVISION .S .C ALBERTA RESEARCH .S 10 .C \\^THIS MANUAL DESCRIBES ^^ARC MAIL\\ .C ^VERSION 781123 .PG .C ^^ARC MAIL .S .C INTER-USER MESSAGE TRANSFER FACILITY .S 3 .C \\^TABLE OF ^CONTENTS .S 3 .TS 5,9,13,18 .NOFILL 0.1 ^INTRODUCTION .S 2 1.0 ^USER'S ^GUIDE .S 1 1.1 ^GENERAL ^COMMAND ^SYNTAX .S 1.2 ^SENDING ^MAIL 1.2.1 ^PREPARING A LETTER 1.2.2 ^NAME SYNTAX 1.2.3 ^REUSABLE MAILING LISTS .S 1.3 ^RECEIVING ^MAIL 1.3.1 ^DESCRIPTION OF RECEIVED MAIL 1.3.2.1 ^LETTERS 1.3.2.2 ^NOTICES 1.3.2.3 ^REPLIES 1.3.2 ^SAVING RECEIVED MAIL .S 1.4 ^ERROR ^RECOVERY .S 1.5 ^HELPFUL ^HINTS 1.5.1 ^CHECK MAIL AT LOG-IN AND LOG-OUT 1.5.2 ^REMINDERS OR "CARBON COPIES" 1.5.3 ^MEMO DISTRIBUTION .S 1.6 ^SAMPLE ^MAILING ^SESSIONS .S 2 2.0 ^INSTALLATION ^PROCEDURES 2.1 ^TASK ^BUILDING 2.2 ^INSTALLATION OF ^ANCILLIARY ^TASKS .FILL .NUMBER 1 .PG .C .S 2 .C ^^ARC MAIL .S .C INTER-USER MESSAGE TRANSFER FACILITY\\ .S 3 .AP .HL 2 INTRODUCTION ^^ARC MAIL\\ IS AN ^^RSX-11M\\ UTILITY PROGRAM WHICH SUPPORTS INTER-USER MESSAGE TRANSFER. ^AN ^^RSX\\ USER MAY SEND A MESSAGE TO OTHER USERS, CHECK TO SEE IF ANY MAIL HAS BEEN SENT TO HIM, AND SAVE MESSAGES PERMANENTLY. ^READERS ARE ASSUMED TO BE KNOWLEDGABLE USERS OF THE ^^RSX-11M\\ OPERATING SYSTEM, AND FAMILIAR WITH OPERATION OF AN ^^RSX-11M\\ TERMINAL. ^^ARC MAIL\\ WAS DEVELOPED AND WRITTEN BY ^WILLIAM ^KORENDYK AND ^MARK ^JOHNSON OF THE ^COMPUTING ^GROUP OF THE ^ATMOSPHERIC ^SCIENCES ^DIVISION OF THE ^ALBERTA ^RESEACH ^COUNCIL, UNDER WORK FUNDED BY THE ^ALBERTA ^WEATHER ^MODIFICATION ^BOARD. ^THIS MANUAL DESCRIBES ^^ARC MAIL\\ VERSION 781123. .S .I 50 781123 .I 50 ^^WK, MJ\\ .NUMBER CHAPTER 1 .CHAPTER USER'S GUIDE \\^THE AIM OF THIS CHAPTER IS TO SUPPLY A COMPREHENSIVE GUIDE TO THE USE AND UNDERSTANDING OF THE ^^ARC MAIL\\ ^INTER-USER ^MESSAGE ^TRANSFER ^FACILITY. ^WITHIN EACH SECTION OF THIS CHAPTER, BASIC CONCEPTS ARE DESCRIBED FIRST, FOLLOWED BY MORE ADVANCED CONCEPTS IN SUBSECTIONS. ^ONLY THE FIRST PART OF EACH SECTION IS REQUIRED TO OBTAIN A BRIEF OVERVIEW OF ^^ARC MAIL\\. .HL 1 GENERAL DESCRIPTION ^THE ^^ARC MAIL\\ ^INTER-USER ^MESSAGE ^TRANSFER ^FACILITY SUPPORTS FOR THE TRANSFER OF MAIL (MESSAGES, LETTERS, NOTICES, ETC.) TO ANY PERSON ENTERED IN THE ^^RSX\\ USER ACCOUNT FILE OF AN ^^RSX\\ MULTI-USER SYSTEM. ^THIS ACCOUNT FILE IS MAINTAINED BY THE SYSTEM MANAGER. ^THE ^^ARC MAIL\\ FACILITY MAINTAINS A "MAILBOX" FOR EACH USER, AND EACH LETTER SENT TO A USER IS INSERTED INTO HIS OWN PERSONAL MAILBOX. ^ONCE DEPOSITED INTO THE USER MAILBOX, ONLY THAT USER HAS ACCESS TO THAT MAIL. ^THE SENDER CAN NOT RETRIEVE THE LETTER, NOR CAN ANY OTHER USER ACCESS THE CONTENTS OF THE MAILBOX. ^EACH USER IS ABLE TO OPEN HIS OWN MAILBOX AND READ ITS CONTENTS. ^HE MAY THEN LEAVE MAIL IN HIS MAILBOX, OR EMPTY HIS MAILBOX BY DISCARDING IT OR SAVING IT INTO A "MAILBAG". ^^ARC MAIL\\ WAS DESIGNED TO SUPPLY A HIGH DEGREE OF USABILITY WITH A CONCISE, EASY TO USE COMMAND SYNTAX. ^TO ACHIEVE THIS CONCISENESS, THE COMMAND SYNTAX DIFFERS FROM STANDARD ^^RSX-11\\ UTILITIES. ^HOWEVER, THE UTILITY ALLOWS FOR QUICK, SINGLE COMMAND EXECUTION, AS WELL AS ALLOWING FOR A CERTAIN AMOUNT OF USER INTERACTION. ^THE GENERAL COMMAND SYNTAX IS: .S .C ^^>MAIL [\\LETTER^^] [TO \\NAME] .S .LM +10 .I -7 WHERE THE SQUARE BRACKETS ENCLOSE AN OPTIONAL PORTION OF THE COMMAND LINE. .S .I -7 LETTER#(IF SPECIFIED) MUST BE A VALID ^^RSX\\ FILE SPECIFICATION WHICH INDICATES THE FILE CONTAINING THE LETTER THAT IS TO BE MAILED. ^IF NOT SPECIFIED, THE LETTER WILL BE READ FROM THE TERMINAL, TERMINATED BY TYPING A ^^CTRL/Z\\. .I -7 ^^TO\\#####IS REQUIRED IF A NAME IS SPECIFIED. .I -7 NAME###IS THE NAME (OR LIST OF NAMES) OF THE PERSON(S) TO WHOM THE MAIL IS TO BE SENT. ^IF NOT SPECIFIED, ^^ARC MAIL\\ WILL REQUEST NAMES FROM THE TERMINAL UNTIL A ^^CTRL/Z\\ IS TYPED. .AP .TP 10 .HL 1 SENDING MAIL ^SENDING MAIL IS THE PROCCESS OF APPENDING A LETTER TO ONE OR MORE USER MAILBOXES. ^THE LETTER MAY BE ALREADY A FILE, OR CREATED BY ^^ARC MAIL\\ BEFORE THE MAIL IS SENT. .LM +5 .HL 2 PREPARING A LETTER ^A LETTER MAY BE CONTAINED IN A FILE PREPARED EARLIER USING A TEXT EDITOR, OR BUILT BY ^^ARC MAIL\\ BY READING LINES FROM THE TERMINAL. ^THE CONTENTS OF THE LETTER, WHETHER IN A FILE OR TYPED AT THE TERMINAL, CAN BE VIRTUALLY ANY TEXT, AS LONG AS THE LENGTH OF EACH LINE IS LESS THAN THE MAXIMUM ALLOWABLE SIZE SPECIFIED BY THE SYSTEM MANAGER. (^THE MAXIMUM ALLOWABLE LINE SIZE IS GENERALLY SET AT 80. CHARACTERS PER LINE.) ^CERTAIN DEFAULTS APPLY TO PORTIONS OF THE FILE SPECIFICATION WHICH ARE NOT EXPLICITLY GIVEN: .S .LM +7 .TS 30 .NOFILL DEVICE: ^^SY0:\\ ^^UIC:\\ THE CURRENT ^^UIC\\ FILENAME: (NO DEFAULT) FILE TYPE: ^^TXT\\ VERSION NUMBER: THE HIGHEST VERSION .S .FILL .LM -7 ^IF THE FILE TYPE OF THE FILE SPECIFICATION IS ^^MAI\\, THEN THE FILE IS CONSIDERED TO BE A "TEMPORARY MESSAGE" AND WILL BE DELETED IF SUCCESSFULLY DEPOSITED INTO THE USER'S MAILBOX. ^THERE ARE TWO DIFFERENT KINDS OF MESSAGES WHICH MAY BE SENT. ^THE FIRST, A "LETTER", IS A MESSAGE WHICH REQUIRES AN IMMEDIATE REPLY. ^THE SECOND KIND, A "NOTICE", IS A MESSAGE WHICH DOES NOT REQUIRE A REPLY. ^WHEN A FILE NAME IS SUPPLIED IN THE COMMAND STRING, IT IS ASSUMED TO BE A LETTER, AND REPLIES WILL BE REQUESTED FROM OTHER USERS RECEIVING IT. ^TO SEND THE CONTENTS OF A FILE AS A NOTICE, THE SWITCH "^^/NO\\" MAY BE APPENDED TO THE FILE SPECIFICATION: .S .C ^^MAIL NOTICE.TXT/NO TO MARY\\ .S ^WHEN THE INTERACTIVE ENTRY OF A LETTER AT THE TERMINAL IS COMPLETED (BY TYPING ^^CTRL/Z\\), THE USER IS ASKED WHETHER HE WOULD LIKE A REPLY. ^A NEGATIVE RESPONSE ("^^NO\\") WILL FORCE THE MESSAGE TO BE SENT AS A NOTICE; ALL OTHER RESPONSES CAUSE THE MESSAGE TO BE SENT AS A LETTER, WITH REPLIES REQUESTED. .HL 2 NAME SYNTAX ^THE "NAME" PORTION OF THE ^^ARC MAIL\\ COMMAND LINE CAN BE OF SEVERAL FORMS. .LIST .LE ^THE "LAST NAME" OF THE USER AS SPECIFIED IN THE ^^RSX-11M\\ USER ACCOUNT FILE. (^SEE THE SYSTEM MANAGER FOR A LIST OF USER NAMES.) .LE ^THE ^^UIC\\ OF THE PERSON TO RECEIVE THE MAIL: .S .C ^^MAIL TO\\ [N,M] .LE ^A MAILING LIST: .S .C ^^MAIL TO\\ _@FILESPEC .S WHERE "FILESPEC" IS A VALID ^^RSX\\ FILE SPECIFICATION OF A FILE CONTAINING ONE OF EITHER OF THE ABOVE NAMES PER RECORD (ALSO SEE SECTION 1.2.3). .LE ^A LIST OF ANY OR ALL OF THE ABOVE, SEPARATED BY COMMAS, SPACES, OR TABS, FOR EXAMPLE: .S .C ^^MAIL TO [12,10],SYSTEM ,_@LIST\\ .ELS ^ALL OF THE ABOVE FORMS MAY BE USED FOLLOWING THE "^^TO\\" IN THE SINGLE-LINE COMMAND, OR AFTER THE "^^WHO TO?\\" PROMPT. .HL 2 REUSABLE MAILING LISTS ^AS STATED EARLIER, "NAME" CAN CONSIST OF A VALID ^^RSX\\ FILE SPECIFICATION PRECEDED BY AN AT-SIGN (_@). ^FILES USED IN THIS WAY ARE TERMED "MAILING LISTS", SUPPLYING A MEANS OF SENDING MAIL TO A PREDEFINED LIST OF USERS. ^THESE MAILING LISTS CAN CONTAIN QUALIFIERS TO PROVIDE THE ABILITY TO MAIL TO ONLY SELECTED NAMES IN THE MAILING LIST. ^THIS IS ACCOMPLISHED BY USE OF A SWITCH SPECIFICATION ON THE FILE SPECIFIER, WITH CORRESPONDING QUALIFIERS IN THE RECORDS OF THE MAILING LIST. ^EACH SWITCH SPECIFIER MUST BE TWO CHARACTERS LONG, AND THESE CHARACTERS ARE MATCHED AGAINST THE FIRST TWO CHARACTERS OF THE QUALIFIERS IN THE FILE. ^ONLY THOSE NAMES WITH QUAIFIERS MATCHING A SWITCH VALUE WILL BE USED. ^FOR EXAMPLE, IF THE FILE: .S .C ^^MAILING.MLS\\ .S CONTAINS THE FOLLOWING RECORDS: .S .I 10 ^^BOB SYSTEM DOCUMENTS .I 10 CAROL DOCUMENTS .I 10 TED .I 10 ALICE SYSTEM\\ .S THEN IF NO SWITCH IS SPECIFIED WITH THE FILE NAME, ALL FOUR PERSONS WILL RECEIVE THE MAIL. ^HOWEVER, IF .S .C ^^_@MAILING.MLS/SY\\ .S IS SPECIFIED, THEN ONLY ^BOB AND ^ALICE WILL RECEIVE THE MAIL. ^IF .S .C ^^_@MAILING.MLS/DO\\ .S IS SPECIFIED, THEN ONLY ^BOB AND ^ALICE WILL RECEIVE THE MAIL. ^AND FINALLY, IF .S .C ^^_@MAILING.MLS/SY/DO\\ .S IS SPECIFIED, THEN ONLY ^BOB, ^CAROL, AND ^ALICE WILL RECEIVE THE MAIL. ^IF AN ASTERISK ("*") IS USED AS A QUALIFIER IN A RECORD, THEN THAT PERSON WILL RECEIVE THE MAIL REGARDLESS OF THE SWITCH SPECIFICATION ON THE FILE NAME. ^THEREFORE, IF THE RECORDS OF THE MAILING LIST ARE: .TP 6 .S .I 10 ^^BOB SYSTEM DOCUMENTS .I 10 CAROL DOCUMENTS .I 10 TED * .I 10 ALICE SYSTEM\\ .S THEN ^TED WOULD RECEIVE THE MAIL IN ALL OF THE ABOVE EXAMPLES. ^CERTAIN DEFAULTS APPLY TO UNSPECIFIED PORTIONS OF THE MAILING LIST FILE SPECIFICATION, AND ARE GIVEN BELOW: .S .LM +7 .TP 10 .TS 30 .NOFILL DEVICE: ^^SY0:\\ ^^UIC\\: THE CURRENT ^^UIC\\ FILE NAME: (NO DEFAULT) FILE TYPE: ^^MLS\\ VERSION NUMBER: THE HIGHEST VERSION NUMBER .FILL .S .LM -7 .LM -5 .AP .HL 1 RECEIVING MAIL \\^THERE ARE TWO METHODS BY WHICH A USER CAN DETERMINE IF THERE IS MAIL FOR HIM IN HIS COMPUTERIZED MAILBOX. ^THE FIRST ALLOWS THE USER TO FIND OUT PRECISELY HOW MUCH MAIL IS WAITING FOR HIM IN HIS MAILBOX: .S .C ^^>MAIL _?\\ .S ^NOTE THAT THE QUESTION MARK ("_?") MUST BE SEPARATED FROM THE WORD "^^MAIL\\" BY A SPACE OR TAB. ^THIS COMMAND INFORMS THE USER OF THE NUMBER OF LETTERS, NOTICES, AND REPLIES IN HIS MAILBOX, AND THE TOTAL NUMBER OF LINES THEY OCCUPY. ^A "BEEP" IS ISSUED TO THE TERMINAL IF THERE IS MAIL IN THE MAILBOX TO ATTRACT THE USER'S ATTENTION IF THIS COMMAND IS USED IN A "^^LOGIN.CMD\\" FILE (SEE SECTION 1.5.1). ^THE SECOND COMMAND ACTUALLY READS THE MAIL IN THE MAILBOX: .S .C ^^>MAIL ME\\ .S ^THIS COMMAND LISTS THE MAIL ON THE USER'S TERMINAL, AND REQUESTS REPLIES IF NECESSARY. .LM +5 .HL 2 DESCRIPTION OF RECEIVED MAIL ^ALL MAIL, WHETHER A LETTER, NOTICE, OR REPLY, IS ENTERED INTO THE USER'S MAILBOX PRECISELY AS ENTERED BY THE SENDER EXCEPT THAT: .LIST .LE EACH LINE IS PRECEDED WITH A TAB CHARACTER, THEREBY FORMATTING THE CONTENTS OF THE MAILBOX SO THAT EACH PIECE OF MAIL CAN BE EASILY DISTINGUISHED BY THE HEADER LINE. .LE EACH MAIL ENTRY (I.E. LETTER, NOTICE, OR REPLY) IS PRECEDED BY A HEADER LINE INDICATING THE DAY OF THE WEEK, THE MONTH, THE DAY OF THE MONTH, AND THE YEAR THAT THE MAIL WAS SENT, THE NAME OF THE PERSON WHO SENT THE MAIL, AND AN INDICATION AS TO WHAT TYPE OF MAIL IT IS. ^FOR EXAMPLE: .S ^^WED#NOV#26/78#12:24#>REPLY<##[216,010]#ALEX\\ .S SHOWS THAT ON ^WEDNESDAY, ^NOVEMBER 26, 1978 AT 12:24, THE USER ^ALEX (WHOSE ^^UIC\\ IS [216,10]) REPLIED TO A LETTER THAT WAS SENT TO HIM. ^THE CONTENTS OF HIS REPLY WOULD FOLLOW THE HEADER. .ELS ^IT IS POSSIBLE THAT A USER MAY SEND MAIL WHILE HIS TERMINAL'S DEFAULT ^^UIC\\ IS DIFFERENT FROM HIS LOGIN ^^UIC\\. ^IF THE DEFAULT ^^UIC\\ DOES NOT CORRESPOND TO AN ENTRY IN THE ^^RSX\\ USER ACCOUNT FILE, ^^ARC MAIL\\ WILL INDICATE THAT ^^UIC\\, AND USE THE NAME: .S .C ^^MYSTERY MAILER\\ .S AS IN THE FOLLOWING EXAMPLE: .S ^^SUN#JAN#16/78#16:04#>NOTICE<#[363,210]#MYSTERY#MAILER\\ .S .LM +3 .HL 3 ^LETTERS ^LETTERS ARE DISTINGUISHED FROM NOTICES AND REPLIES BY HAVING THE WORDS: .S .C ^^ARC MAIL\\ .S IN THE HEADER LINE OF THE MAIL ENTRY. ^A LETTER IMPLIES AN IMMEDIATE REPLY IS DESIRED BY THE SENDER. ^THE REPLY IS REQUESTED AUTOMATICALLY. ^ONCE THE ENTIRE LETTER HAS BEEN LISTED, THE USER IS PROMPTED FOR A REPLY, TO BE DIRECTLY ENTERED, JUST AS IF HE WERE ENTERING A LETTER. ^NO REPLY IS REQUESTED IF THE SENDER IS THE SAME AS THE RECEIVER, OR IF THE SENDER IS A ^^MYSTERY MAILER\\. .HL 3 ^NOTICES ^NOTICES ARE DISTINGUISHED FROM LETTERS AND REPLIES BY HAVING THE WORD: .S .C ^^>NOTICE<\\ .S IN THE HEADER LINE OF THE MAIL ENTRY. ^NOTICES ARE TREATED THE SAME AS LETTERS, BUT NO REPLY IS REQUESTED. .HL 3 ^REPLIES ^REPLIES ARE DISTINGUISHED FROM LETTERS AND NOTICES BY HAVING THE WORD: .S .C ^^>REPLY<\\ .S IN THE HEADER LINE OF THE MAIL ENTRY. ^THE HEADER IS THEN FOLLOWED BY A NUMBER OF "RECAP" LINES WHICH ARE THE FIRST LINES (INCLUDING THE HEADER) OF THE THE LETTER THAT WAS ORIGINALLY SENT. ^THESE RECAP LINES ARE PRECEDED WITH A TAB CHARACTER AND AN ASTERISK ("*") TO DIFFERENTIATE THEM FROM THE ACTUAL REPLY. ^THE NUMBER OF RECAP LINES SHOWN IS DETERMINED BY THE SYSTEM MANAGER. (^GENERALLY, THE NUMBER OF RECAP LINES IS EQUAL TO TWO: THE HEADER, AND THE FIRST LINE OF THE LETTER.) .LM -3 .HL 2 SAVING RECEIVED MAIL ^AFTER THE CONTENTS OF THE USER'S MAILBOX HAVE BEEN LISTED, ^^ARC MAILL\\ ASKS: .S ^^SAVE THIS MAIL?\\ .S ^IF THIS IS ANSWERED "^^YES\\" (OR "^Y") THEN ^^ARC MAIL\\ ASKS: .S ^^WHERE IS YOUR MAILBAG?\\ .S TO WHICH THE USER SHOULD REPLY WITH A VALID ^^RSX\\ FILE SPECIFICATION. ^IF NOT EXPLICITLY GIVEN, THE FOLLOWING DEFAULTS APPLY: .S .LM +7 .TS 30 .NOFILL DEVICE: ^^SY0:\\ ^^UIC\\: CURRENT ^^UIC\\ FILE NAME: ^^MAILBAG\\ FILE TYPE: ^^TXT\\ VERSION NUMBER: MOST RECENT VERSION .FILL .S .LM -7 ^IF THE FILE SPECIFIED EXISTS, THEN THE CONTENTS OF THE MAILBOX FILE ARE APPENDED TO THE MAILBAG FILE; IF IT DOES NOT EXIST, IT IS CREATED AND FILLED WITH THE CONTENTS OF THE MAILBOX. ^CONFIRMATION OF THE NAME OF THE MAILBAG FILE IS GIVEN, AND THE MAILBOX IS EMPTIED. ^IF A USER INDICATES THAT HE DOES NOT WISH TO SAVE HIS MAILBOX, THE MAILBOX IS EMPTIED. ^ALL MAIL IS LEFT IN THE MAILBOX IF A NULL RESPONSE (I.E. A CARRIAGE RETURN) IS GIVEN. ^ALL OTHER RESPONSES ARE FLAGGED AS BEING IN ERROR, THE ALTERNATIVES ARE LISTED, AND THE QUESTION IS ASKED AGAIN. .LM -5 .AP .HL 1 ERROR RECOVERY ^THE ERRORS THAT CAN RESULT FROM NORMAL USE OF ^^ARC MAIL\\ ARE LISTED BELOW WITH A BRIEF DESCRIPTION OF WHAT THEY REPRESENT, AND WHAT SHOULD BE DONE TO RECOVER. .S .LM +10 .I -10 ^^MAIL - ACCOUNT ENTRY FOR "XXXXXXXXXX" NOT FOUND\\ .BREAK ^THE NAME SPECIFIED COULD NOT BE FOUND IN THE SYSTEM'S USER ACCOUNT FILE. ^RETRY USING PROPER ACCOUNT NAME. .S 2 .I -10 ^^MAIL - ACCOUNT FILE OPEN FAILURE\\ .BREAK ^DIFFICULTIES WERE ENCOUNTERED WHEN TRYING TO ACCESS THE SYSTEM'S USER ACCOUNT FILE. ^TRY AGAIN LATER, AND IF THE PROBLEM PERSISTS, NOTIFY THE SYSTEM MANAGER IMMEDIATELY. .S 2 .I -10 ^^MAIL - ACCOUNT NAME SYNTAX ERROR IN "XXXXXXXXXX"\\ .BREAK ^THE NAME SPECIFIED IS NOT A VALID ACCOUNT NAME. ^RETRY USING THE PROPER ACCOUNT NAME. .S 2 .I -10 ^^MAIL - FILE NAME SYNTAX ERROR IN: "XXXXXXXXXXX"\\ .BREAK ^THE FILE NAME GIVEN IS NOT A VALID ^^RSX\\ FILE SPECIFICATION. ^IF THE NAME REPRESENTS A LETTER FILE, REENTER THE COMMAND WITH A VALID FILE SPECIFICATION. ^IF THE NAME OF A MAILING LIST IS IN ERROR, THE LETTER WILL BE RETAINED. .S 2 .I -10 ^^MAIL - I/O ERROR \N AT \M\\ .BREAK ^THIS MESSAGE INDICATES THAT A GENERAL ^I/^O ERROR WAS ENCOUNTERED AT LOCATION M. N IS THE STANDARD ^^RSX\\ ^I/^O ERROR CODE, AND IF PRECEDED BY A "^^DR\\" IT INDICATES A STANDARD DIRECTIVE ERROR CODE. ^EXECUTION OF THE TASK IS TERMINATED. .S 2 .I -10 ^^MAIL - STANDING IN LINE TO MAIL TO "XXXXXXXXXX"\\ .BREAK ^THE MAILBOX OF THE RECEIVER IS BEING REFERENCED BY ANOTHER USER. ^^ARC MAIL\\ WILL PAUSE AND TRY AGAIN A FEW TIMES (SEE NEXT MESSAGE). .S 2 .I -10 ^^MAIL - UNABLE TO MAIL TO "XXXXXXXXXX"\\ .BREAK ^^ARC MAIL\\ WAS NOT ABLE TO DELIVER THE MAIL TO THE DESIRED USER (SEE PREVIOUS MESSAGE). ^TRY AGAIN LATER; IF POSSIBLE, THE LETTER IS RETAINED. .S 2 .I -10 ^^PROPER COMMAND SYNTAX IS ->MAIL [FROM] [TO PERSON]\\ .BREAK ^THE COMMAND AS ENTERED IS NOT RECOGNIZABLE. ^ENTER THE COMMAND IN THE PROPER SYNTAX. .S 2 .I -10 ^^SENSING INCOMING MAIL - WILL WAIT TILL IT IS RECEIVED\\ .BREAK ^WHEN ATTEMPTING TO READ YOUR OWN MAIL, INCOMING MAIL WAS SENSED. ^^ARC MAIL\\ WILL WAIT FOR THE INCOMING MAIL. .S 2 .I -10 ^^UNRECOVERABLE MAIL FILE ERROR\\ .BREAK ^^ARC MAIL\\ WAS NOT ABLE TO ACCESS YOUR MAILBOX AT THIS TIME. ^WAIT A WHILE AND TRY AGAIN. ^IF THE PROBLEM PERSISTS, NOTIFY THE SYSTEM MANAGER. .S 3 .LM -10 ^IF THE UTILITY WAS NOT ABLE TO DELIVER MAIL TO A USER, AN ATTEMPT IS MADE TO RETAIN THE LETTER IN A FILE. ^IF THE LETTER IS RETAINED, A MESSAGE OF THE FORM: .S .C ^^LETTER RETAINED IN "XXXXXXXXX".\\ .S IS PRINTED AT THE TERMINAL CONFIRMING THE FILE NAME OF THE LETTER. .HL 1 HELPFUL HINTS ^THE FOLLOWING ARE SOME USEFUL POINTERS FOR THE USE OF ^^ARC MAIL\\ WHICH THE AUTHORS OF THIS DOCUMENT FEEL WOULD BE HELPFUL TO MOST USERS. .LM +5 .HL 2 CHECK MAIL AT LOG-IN ^THE ^^HELLO\\ TASK FOR ^^RSX-11M V3.1\\ HAS THE ABILITY TO INVOKE AN INDIRECT COMMAND FILE (^^LOGIN.CMD\\) EACH TIME A USER LOGS ON TO THE SYSTEM. ^BY INSERTING THE COMMAND: .S .C ^^MAIL ?\\ .S INTO THAT FILE, THE USER IS AUTOMATICALLY INFORMED IF ANY MAIL IS IN HIS MAILBOX. ^NOTE THAT A "BEEP" WILL BE ISSUED AT THE TERMINAL IF THERE IS MAIL IN THE MAILBOX. .HL 2 REMINDERS OR "CARBON COPIES" ^^ARC MAIL\\ ALLOWS A USER TO DEPOSIT NEW MAIL INTO HIS OWN MAILBOX SIMPLY BY SENDING TO HIS OWN ACCOUNT NAME. ^IN THIS WAY, A USER CAN SEND HIMSELF PERSONAL REMINDERS OR "CARBON COPIES" WHICH HE CAN READ AT LATER TIME. .HL 2 MEMO DISTRIBUTION ^BECAUSE OF THE VERSATILITY OF THE ^^ARC MAIL\\ MAILING LIST, IT IS GENERALLY MORE EFFICIENT TO HAVE A SINGLE MAILING LIST CONTAINING THE NAME OF ALL USERS TO WHOM MAIL IS GENERALLY SENT. ^THEN A SUBSET OF THIS LIST CAN BE SPECIFIED BY USE OF A SWITCH ENTRY. ^IN FACT, SEVERAL SUBSETS CAN BE SPECIFIED, SOME OF WHICH MAY OVERLAP. ^IN THIS WAY, MEMORANDUMS OF GENERAL INFORMATION, AS WELL AS THOSE DIRECTED TO A SPECIFIC GROUP OF PEOPLE CAN BE SENT USING A SINGLE MAILING LIST. ^CONTACT THE SYSTEM MANAGER TO SEE IF SUCH A FILE IS AVAILABLE. .LM -5 .HL 1 SAMPLE MAILING SESSIONS ^THIS SECTION GIVES A SERIES OF EXAMPLES IN THE USE OF ^^ARC MAIL\\. .HL 2 SENDING MAIL .LIST .LE ^SIMPLE SINGLE-LINE COMMAND .S .NOFILL &>^^MAIL LETTER TO SYSTEM\\ .S .FILL (MAILS THE FILE "^^SY0:LETTER.TXT;\\" TO THE USER WHOSE LAST NAME (AS SPECIFIED IN THE ^^RSX\\ USER ACCOUNT FILE) IS ^^SYSTEM\\.) .LE ^MAKE UP A LETTER AT THE TERMINAL .S .NOFILL &>^^MAIL TO MARY ^&LETTER>\&\\^THIS IS A SHORT LETTER ^I AM ^&^^LETTER>\&\\MAILING TO ^MARY. ^WHEN ^I GET HER ^&^^LETTER>\&\\REPLY, ^I'LL KNOW SHE HAS READ IT. ^&^^LETTER>\&\\ .S ^&^^DO YOU WANT A REPLY?\&YES\\ .FILL .S .LE ^SEND A PREPARED LETTER .S .NOFILL &>^^MAIL LETTER/NO ^&WHO TO?\&SYSTEM ^&WHO TO?\&PETE ^&WHO TO?\&\\ .FILL .S (MAILS "^^SY:LETTER.TXT;\\" AS A NOTICE (NO REPLY REQUESTED) TO ^^SYSTEM\\ AND TO ^^PETE\\.) .ELS .HL 2 CHECKING MAILBOX .S .NOFILL &>^^MAIL ? ^&YOU HAVE 3 LETTERS, 2 NOTICES AND 2 REPLIES IN 32 LINES.\&\\ .S 1 &> .S .FILL .HL 2 RECEIVING MAIL .NOFILL .S &>^^MAIL ME .NUMBER CHAPTER 2 .CHAPTER INSTALLATION PROCEDURES ^THE PROCEDURES DESCRIBED IN THIS CHAPTER ARE FOR THE GENERATION OF THE ^^ARC MAIL\\ ^INTER-USER ^MESSAGE ^TRANSFER ^FACILITY UDER AN ^^RSX-11M V3.1\\ MULTI-USER SYSTEM. .HL 1 TASK BUILDING ^^ARC MAIL\\ IS DISTRIBUTED AS A COMPLETED OBJECT MODULE LIBRARY (^^MAIL.OLB\\) AND IF NO CHANGES ARE REQUIRED, THE LIBRARY CAN BE USED AS IS FOR THE BUILDING OF THE ^^ARC MAIL\\ TASK. ^TRIIAL ALTERATIONS CAN BE MADE, HOWEVER, IF IT APPEARS NECESSARY TO MODIFY THE FUNCTION OF CERTAIN PROTIONS OF ^^ARC MAIL\\. .LIST .LE ^^REPLIN\\ IS A SYMBOLIC VALUE DEFINED WITHIN THE MODULE ^^ME\\ WHICH SPECIFIES THE NUMBER OF RECAP LINES THAT ARE TO BE INCLUDED IN THE USER REPLIES. ^THE DISTRIBUTION HAS THE VALUE: .S .C ^^REPLIN=2\\ .S ^TO ALTER THAT VALUE, THE MODULE (LOCATED IN THE FILE: ^^MAIME.MAC\\) MUST BE EDITED AND REASSEMBLED WITH A DIFFERENT DEFINITION OF ^^REPLIN\\. ^THE MODULE ^^ME\\ IS THE ONLY MODULE AFFECTED. (^THE INDIRECT COMMAND FILE ^^MAIASM.CMD\\ IS SUPPLIED TO ASSEMBLE ANY MODULE AND REPLACE IT IN THE ^^ARC MAIL\\ OBJECT LIBRARY.) .LE ^^MAXLIN\\ IS A SYMBOLIC VALUE WHICH DEFINES THE MAXIMUM LENGTH OF A LINE ALLOWED IN ^^ARC MAIL\\. ^IN THE DISTRIBUTION: .S .C ^^MAXLIN=80.\\ .S ^THE VALUE IS DEFINED IN ONE OF THE MACROS CONTAINED IN THE ^^ARC MAIL\\ MACRO LIBRARY. ^IN ORDER TO MODIFY THE VALUE OF ^^MAXLIN\\, THE MACRO "^^MAIGBL\\" MUST BE EXTRACTED FROM THE MACRO LIBRARY, MODIFIED, AND THEN RE-INSERTED INTO THE LIBRARY. ^RATHER THEN SPECIFY ALL THE MODULES THAT MUST BE REASSEMBLED, LET'S SAY THAT ALL SOURCE MODULES PROVIDED IN THE DISTRIBUTION MUST BE REASSEMBLED AND REPLACED IN THE OBJECT LIBRARY. .LE ^^NOTIFY\\ IS A SYMBOLIC VALUE USED IN CONJUNCTION WTH THE ^^ARC MAIL\\ ANCILLIARY TASK WHICH NOTIFIES LOGGED-ON USERS OF INCOMING MAIL. ^IT IS USED AS A CONDITIONAL ASSEMBLY PARAMETER FOR THE GENERATION OF CODE NECESSARY TO INVOKE THE ANCILLIARY TASK (SEE SECTION 2.2). ^THE OBJECT LIBRARY AS DISTRIBUTED SUPPORTS THE INITIATION OF THE ANCILLIARY TASK. ^^NOTIFY\\ IS DEFINED IN THE MACRO "^^MAIGBL\\" IN THE ^^ARC MAIL\\ MACRO LIBRARY. ^IN ORDER TO REMOVE THE CODE FOR INITIATION OF THE ANCILLIARY TASK, THAT MACRO MUST BE EXTRACTED FROM THE LIBRARY, MODIFIED TO REMOVE THE DEFINITION OF THE SYMBOL, AND RE-INSERTED INTO THE MACRO LIBRARY. ^THEN THE MODULE ^^MAIL\\ (IN THE FILE "^^MAIMAIL.MAC\\") MUST BE ASSEMBLED AND REPLACED IN THE OBJECT LIBRARY. ^NORMALLY, ONLY THOSE SYSTEMS WHICH DO NOT SUPPORT THE ^^RSX\\ SEND (^^SDAT$\\) AND RECEIVE (^^RCVD$\\) DATA DIRECTIVES WILL REQUIRE REASSEMBLY OF THIS MODULE. .ELS ^WHEN THE OBJECT MODULE LIBRARY IS READY FOR THE TASK BUILD, IT IS ONLY NECESSARY TO MODIFY THE SUPPLIED BUILD FILE (^^MAITKB.CMD\\) TO INDICATE THE DESIRED "POST OFFICE LOCATION". ^THERE IS A GLOBAL PATCH SPECIFIED IN THE COMMAND FILE WHICH IS USED TO INDICATE THE LOCATION OF ALL THE USERS' MAILBOXES. ^THE COMMAND FILE DISTRIBUTED ASSUMES THAT THE MAILBOXES ARE TO RESIDE ON "^^DM1:[10,3]\\". .HL 1 INSTALLATION OF ANCILLIARY TASKS .S 2 .C ^^NOT COMPLETED\\ .LM -5