home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / EXTRAS / UUCODE / UUCP / SNUUPM23.ZIP / SNUUPM23.DOC < prev   
Encoding:
Text File  |  1994-01-26  |  58.2 KB  |  1,572 lines

  1. snuupmXX.doc
  2.  
  3.               Rhodes University Computing Centre
  4.               ----------------------------------
  5.  
  6.                             SNUUPM
  7.                             ------
  8.  
  9.             24 January 94 - Version 23 - Mike Lawrie
  10.             ----------------------------------------
  11.  
  12.          A Combined SNews/UUpc/PMail system for MS-DOS
  13.          ---------------------------------------------
  14.  
  15. ------------------------------------------------------------------------
  16.  
  17. Please Note:
  18.  
  19.  "Portions of this software were derived from SNews, which is copyright
  20.  by John McCombs <john@ahuriri.gen.nz>, and are included by permission 
  21.  of the author.  NOTE: This version of SNews is not distributed under 
  22.  the GNU Public Licence.  
  23.    No warranty is offered by John McCombs in respect to this software 
  24.  and no liability is accepted for the consequences of its use."
  25.  
  26. Similar caveats apply to PMAIL, UUPC, DOUGMENU - read the documentation
  27. files within those packages for full details regarding constraints on
  28. use and on redistribution. Some extracts are give below.
  29.  
  30. ------------------------------------------------------------------------
  31.  
  32.              FILES REQUIRED IN ORDER TO INSTALL SNUUPM
  33.              -----------------------------------------
  34.  
  35. You need to copy the following files into a single directory, from which
  36. you run the install process:-
  37.  
  38.     SNUUPMxx.ZIP    (where "xx" is the 2-digit version number)
  39.     DMENU168.ZIP
  40.     PMAIL301.ZIP
  41.     SNEWS191.ZIP
  42.     UPC12BAD.ZIP
  43.     UPC12BD1.ZIP
  44.     UPC12BD2.ZIP
  45.     UPC12BD3.ZIP
  46.  
  47. You will obtain these files off the main archive servers of the
  48. Internet. (eg wuarchive.wustl.edu: /mirrors/msdos/uucp or 
  49. omnigate.clarkson.edu: /pub/msdos/uucp). If all else fails, try
  50. hippo.ru.ac.za: /pub/pc/snuupm.
  51.  
  52. The DOS programs "find", "sort" and "more" are also required.
  53.  
  54. ------------------------------------------------------------------------
  55.  
  56.                              T H A N K S
  57.                              -----------
  58.  
  59. The author of SNUUPM would like to express his thanks to:-
  60.  
  61.     the authors of SNEWS, UUPC and PMAIL.
  62.  
  63.     Paul Nash for the idea, initial work and the original uu2pm.exe
  64.     program, all of which led to the development of SNUUPM.
  65.  
  66.     Dave Wilson for help with enhancements to SNUUPM.
  67.  
  68.     various folk at Rhodes University who have been brave enough
  69.     to give it a try in the development stage.
  70.  
  71.     a goodly number of folk on the Internet who have been kind 
  72.     enough to report problems, and sometimes to provide the fixes.
  73.     Look in c:\usr\lib\snuupm\changes to find out who suggested
  74.     what. Some of these folk, in alphabetical order, are:-
  75.  
  76.        Americo Muchanga of Mozambique
  77.        Arvind Kumar of USA
  78.        Dave Wilson of South Africa
  79.        Don Findley of Mozambique
  80.        Eberhard Lisse of Namibia
  81.        Gordon Taylor of New Zealand
  82.        Ian Dore of South Africa
  83.        Jiri Kuchta of Czechoslovakia
  84.        Klaus Hektor of Argentina
  85.        Royce Robbins of USA, while based in Lesotho
  86.        Scott McNabb of New Zealand
  87.        Quentin Jones of Australia
  88.  
  89. ------------------------------------------------------------------------
  90.  
  91.                            INTRODUCTION
  92.                            ------------
  93.  
  94. Electronic mail has become a very widespread means of communication.
  95. What started off as requiring huge computers and expensive networks is
  96. now available on the ubiquitous DOS-based PC, and can use a modem that
  97. costs between $50 and $200. The telephone cost of communicating by email
  98. is less than 2% of that of fax, and there is no expensive paper
  99. required. One telephone call can send and receive all of the email that
  100. is directed to and from all addresses - this saves having to make a
  101. multitude of phone calls for multiple recipients, and (in the case of
  102. international dialing) it allows for the costs to be kept in a country
  103. where the telephone rates are low.  Email does not have the glitches of
  104. fax, due to the superior error-correcting protocols used by email.
  105.  
  106. It is now possible for private individuals who have a PC, a modem and a
  107. telephone, to join the world of email at an extremely low cost. The
  108. software package described in this document is available at no cost for
  109. non-commercial use. There are NO catches.
  110.  
  111. The installation and operational procedures are simplicity itself.
  112.  
  113. The PC DOS packages known as SNews, UUpc, and PMail have been strung
  114. together to form a single suite called SNUUPM. This idea, as far as the
  115. author of SNUUPM knows, came from Paul Nash <paul@frcs.alt.za>, but what
  116. now exists has been enhanced somewhat on his original work.  This
  117. document describes the method that has been used to link these packages
  118. into a simple to use email and usenet news system, but with full
  119. facilities.  The DOS directory structure that has been used is
  120. Unix-like, so knowledge gained from the use of the one is relevant to
  121. the other.  The DOUGMENU package allows for a simple user interface to
  122. be provided.
  123.  
  124. The objective is to produce a standalone DOS-based email and Usenet news
  125. system that connects via a telephone call to a suitable uucp mailserver
  126. computer. The programs are such that a LAN of PCs could be linked in
  127. this way such that each PC on the LAN can access email, but the SNUUPM
  128. package is not (yet) geared to this. The author of SNUUPM simply does
  129. not have the enironment in which to develop this, but there are people
  130. on the network who are doing this kind of thing.
  131.  
  132. A major design criteria is that the SNUUPM system must be easy to
  133. install and simple to operate, and must be rugged. The purpose of
  134. developing this package is two-fold.  One is to allow students and
  135. former students of Rhodes University to stay in touch with their alma
  136. mater. The other is to spread email into undeveloped countries. In both
  137. regards the package has been highly successful.
  138.  
  139. The hardware needed is simply an MS-DOS based PC with a hard disk and a
  140. modem. The system has been tested under MS-DOS 3.3 and 5.0, with CGA,
  141. EGA and VGA.
  142.  
  143. In order to comply with conditions of distribution of the indvidual
  144. component packages of SNUUPM, those individual packages need to be
  145. acquired separately (see elsewhere in this document for details). SNUUPM
  146. itself consists of the single file SNUUPMxx.ZIP, where 'xx' is the
  147. version number.
  148.  
  149. Apart from having a PC, a modem and the software, you have to make
  150. arrangements with another computer (ie, a mailserver) in order to
  151. exchange email and/or news with that computer. Any computer that runs
  152. the widely available uucp 'g' protocol will do, but clearly one that has
  153. a direct connection to the TCP/IP Internet that spans the world would be
  154. an excellent choice. But whatever computer you choose, you need to agree
  155. on certain information with whomever runs that computer. The minimum
  156. information is:-
  157.  
  158.     name of your PC
  159.     domain in which this name resides
  160.     name of the mailserver
  161.     telephone number of the mailserver
  162.     password of your PC for logging into that mailserver
  163.     name of your organisation
  164.     make and model of modem that you are using
  165.     baud rate between your PC and your modem
  166.  
  167. You might well need to know the specific configuration of your modem so
  168. that it is compatible with that of the mailserver. This information
  169. should be obtainable from the mailserver site. The modem files that are
  170. part of the package have been written and tested by active users of the
  171. UUPC package, so they should work with minimum changes.
  172.  
  173. Armed with the above information, follow the QUICKSTART section, and you
  174. could be exchanging email with Internet sites within 30 minutes or less.
  175.  
  176. ------------------------------------------------------------------------
  177.  
  178.                              QUICKSTART
  179.                              ----------
  180.  
  181. You will need about 4 Mb in a drive of your choice in order to install
  182. the package (this includes the space for the non-SNUUPM files).  More
  183. space is needed on the same drive to hold your email and news items.
  184. When installed, the total package occupies about 1.2 Mb if you run
  185. pklite on most of the .COM and .EXE programs in \usr\lib\snuupm\.
  186. No files are installed into the top-level directory, but rather they
  187. go into (your\choice)\etc and (your\choice)\usr. It is sensible and
  188. practicable to make the 'your\choice' be simply the name of a disk
  189. drive, and not a lengthy path (eg C: is better than c:\some\long\path).
  190.  
  191.  
  192.                 Step 1
  193.  
  194. If you have not yet unzipped the SNUUPM distribution file, then proceed
  195. as follows:-
  196.  
  197.     (make some convenient temporary directory, say c:\tmp)
  198.     (change to that installation directory)
  199.     (copy in somehow the files that are needed to install SNUUPM)
  200.     PKUNZIP SNUUPMxx.ZIP  (where xx is a 2-digit version number)
  201.     (make a directory into which you will install SNUUPM, c: is fine)
  202.  
  203. The pkunzip'ing of SNUUPMxx.ZIP will create the .DOC file that you are
  204. presently reading, as well as the files SNUUPM.ZIP, INSTALL.BAT and
  205. INSTALL.MNU.
  206.  
  207.  
  208.                 Step 2
  209.  
  210. Edit your AUTOEXEC.BAT file to have the following lines (best to copy
  211. them in from this .DOC file, don't try typing them directly):-
  212.  
  213.     rem --------------------------------------------------------
  214.     rem    SNUUPM additions to AUTOEXEC.BAT
  215.     rem --------------------------------------------------------
  216.     rem   Set sndrive to be the disk drive or the directory from
  217.     rem   which you will run SNUUPM.
  218.     set sndrive=c:
  219.     rem
  220.     rem   You might wish to change pmuser later, to be the user-id
  221.     rem   of the person who uses this PC the most often, but for now
  222.     rem   leave it set to "root"
  223.     set pmuser=root
  224.     rem
  225.     rem   Set TZ to be suitable for your timezone
  226.     rem   For reasons known (only?) to the author of UUPC, the value
  227.     rem   that you set in this TZ variable is added to the time
  228.     rem   that appears in the mail messages. Clearly, the time in
  229.     rem   your PC is your local correct time, and needs no mathematics
  230.     rem   to be done on it, but that's how the package is written.
  231.     rem   For whatever reason, if you are AHEAD of GMT then you
  232.     rem   use a negative sign, if you are BEHIND GMT then you
  233.     rem   use a positive sign. Good old US-centric authors, but
  234.     rem   then you can always ask for you money back.
  235.     rem   South Africa is 2 hours to the East of GMT, ie when it
  236.     rem   is midday in South Africa then it is 10:00 am in London.
  237.     set tz=GMT-2
  238.     rem
  239.     rem   You might have set TMP for some other package, in which case
  240.     rem   there is no need to reset it here.
  241.     rem set tmp=%sndrive%\tmp
  242.     rem
  243.     rem   The SNUUPM installation process will invoke your favourite
  244.     rem   editor program if you have set the EDITOR environment
  245.     rem   variable to some suitable value. The author of SNUUPM
  246.     rem   has resigned himself to using vi, which he gets from the
  247.     rem   CALVIN or ELVIS packages.
  248.     rem set editor=c:\bin\vi.exe
  249.     rem
  250.     rem   From here on, don't change anything
  251.     rem   -----------------------------------
  252.     set path=%sndrive%\usr\lib\snuupm;%path%
  253.     set uupcsysrc=%sndrive%\etc\uupc\uupc.rc
  254.     set uupcnews=%sndrive%\usr\spool\news
  255.     set uupcusrrc=%sndrive%\usr\%pmuser%\%pmuser%.rc
  256.     set snewsrc=%sndrive%\usr\%pmuser%\snews.rc
  257.     rem ----end of SNUUPM setup---------------------------------
  258.  
  259. The rest of this document assumes you have used drive C:.  However, as
  260. mentioned above, you may choose to use any other drive or directory for
  261. installing the package (by altering the setting of 'sndrive').
  262.  
  263. NOTE 1: The "tmp=%sndrive%\tmp" can be changed if you have a moderately
  264. large RAMDISK (say much more than 64 Kb), or it can point to any suitable
  265. temporary directory.
  266.  
  267. NOTE 2: The "tz=GMT-2" appears to be appropriate for South African time,
  268. which is 2 hours to the east of the zero meridian.
  269.  
  270.  
  271.                 Step 3
  272.  
  273. Edit your CONFIG.SYS file to set a moderate amount of space for
  274. environment variables, eg:-
  275.  
  276.     shell=c:\command.com /e:2048 /p
  277.  
  278. If you are running under Windows, ensure that the setting of the
  279. CommandEnvSize is also at least 2048 - this is done in the file
  280. \WINDOWS\SYSTEM.INI.
  281.  
  282.  
  283.                 Step 4
  284.  
  285. Now reboot so that the AUTOEXEC.BAT and CONFIG.SYS parameters take
  286. effect.
  287.  
  288.  
  289.                 Step 5
  290.  
  291. Proceed with the installation by typing 
  292.  
  293.     cd ... (to the directory holding the SNUUPM .ZIP files)
  294.     install
  295.  
  296. This leads you via a series of menus through the install process. You
  297. have to specify the basic information that any mailing system needs, by
  298. means of the System Setup submenu.  You can elect to install PMAIL and
  299. SNEWS together or to omit the installation of SNEWS if you so choose.
  300.  
  301. The INSTALL option will install SNUUPM in subdirectories ETC and USR of
  302. the directory defined by the "set sndrive" command in your AUTOEXEC.BAT
  303. file.
  304.  
  305. The install process pkunzips the files SNUUPM.ZIP, creates directories
  306. and sets up some basic newsgroups.
  307.  
  308. There are a number of predefined modem files from which you must select.
  309. Most of them are part of the UUPC package, but those that have been 
  310. developed at Rhodes University are:-
  311.  
  312.     FIRSTV22    First V.22bis
  313.     FX14400        Practical Peripherals FX14400 V32.bis
  314.     PENRIL        Penril 14.4
  315.     SARONV22    Saron V22.bis
  316.     ZMFC9624    Zoom Fax FC96/24
  317.  
  318. MAKE SURE THAT YOUR MODEM DOES NOT USE XON/OFF FLOW CONTROL, AS THIS
  319. WILL CAUSE THE UUCP TRANSFERS TO HANG. USE RTS/CTS FLOW CONTROL
  320. INSTEAD.
  321.  
  322.  
  323.                 Step 6
  324.  
  325. You might need to edit some of the files if they don't "look right".
  326. For example, the COM port of the c:\etc\uupc\modem.mdm file might need
  327. to be changed, and you might need to alter the ATDP or ATDT modem string
  328. according to your telephone system.
  329.  
  330.  
  331.                 That's All
  332.  
  333. You are now ready to run the system. Type:-
  334.  
  335.     snuupm
  336.  
  337. and follow the menus.
  338.  
  339. None of the install files are required once the package is installed, so
  340. they may be deleted. You might one day wish to look into the various
  341. documentation files of the individual packages (eg dougmenu), so retain
  342. copies of the .ZIP files. You can modify your installation at a later
  343. stage without having to remove and reinstall the entire package.
  344.  
  345. Now read on only if you wish to find how the component packages dovetail
  346. together.  The definitive information regarding the individual packages
  347. is contained in the the distribution files of those packages. There is
  348. also some information from some of the users of the system, who have
  349. installed the package in an environment different to that of the authors.
  350. This information is included with permission.
  351.  
  352. ------------------------------------------------------------------------
  353.  
  354.             User's Tips/Comments
  355.             --------------------
  356.  
  357. From niherst!lars_j@upr2.clu.net Fri Dec 10 00:21:53 1993
  358. Return-Path: <niherst!lars_j@upr2.clu.net>
  359. Received: from upr2.clu.net by hippo.ru.ac.za (4.1/Hippo-02.06)
  360.     id AA08755; Fri, 10 Dec 93 00:21:29+020
  361. Received: by upr2.clu.net (/\==/\ Smail3.1.28.1 #28.13)
  362.     id <m0p7uGw-00001JC@upr2.clu.net>; Thu, 9 Dec 93 17:55 EST
  363. Received: by niherst.gov.tt (1.65/waf)
  364.     via UUCP; Thu, 09 Dec 93 17:47:03 AST
  365.     for ccml@hippo.ru.ac.za
  366. To: ccml@hippo.ru.ac.za
  367. Subject: Greetings from Trinidad
  368. From: lars_j@niherst.gov.tt (Lars Johnson)
  369. Message-Id: <7V7aec1w165w@niherst.gov.tt>
  370. Date: Thu, 09 Dec 93 17:00:53 AST
  371. Organization: National Institute of Higher Education
  372. Status: RO
  373.  
  374. Hi, Mike!
  375.  
  376. I've spent most of today drafting a report of our EMAIL project, and I 
  377. thought that perhaps you would appreciate knowing that your SNUUPM is 
  378. very well recieved by us.
  379.  
  380. I'd also like to give you some advance warning of some things, so that 
  381. you will be able to indicate wherever you think I may be compromising the 
  382. permission to use SNUUPM which is implicit and explicit in the 
  383. documentation. Thus, please understand that the "consultant's role" in 
  384. which I have cast you is largely a matter of salesmanship, and in no way 
  385. is intended by me to indicate a binding committment on your, or anyone's 
  386. part.
  387.  
  388. In turn, let me say that if you like the things which I say about SNUUPM 
  389. after only a couple days' use, feel free to use ALL my Advertising Copy: 
  390. I was Account Executive at McCann-Erickson (Trinidad) Ltd. for three full 
  391. years, and I know what sells. SNUUPM can make money for you, in today's 
  392. INTERNET-aware world. My advice? Forget giving it away; forget shareware; 
  393. go COMMERCIAL in as big a way as you can NOW! (Research the market first,
  394. though!)
  395.  
  396. BTW, have you given any thought to the Packet-Radio medium for netting? 
  397. I'd be interested to get your feedback on that, also.
  398.  
  399.  
  400. advantages of SNUUPM vs WAFFLE                      
  401.  
  402. To:     [name removed]
  403.         [some text removed], Trinidad/Tobago.
  404.  
  405. [para removed]
  406.  
  407. This UUCP-for-DOS software offers the following main advantages over
  408. WAFFLE:
  409.  
  410. 1)  Clearer, cleaner, more business-like user interface, with an
  411. intuitive hierarchy of menus.
  412.  
  413. 2)  All functions are available through a single, main menu.
  414.  
  415. 3)  Novell NetWare compatibility is built-in (In fact the mail
  416. module, "Pegasus Mail", was written by David Harris as an alternative
  417. interface to the mail module of NetWare v. 2.15 and higher. Among its
  418. more unusual and attractive features is its price: FREE)
  419.  
  420. 4)  Allows easy multi-user access to email accounts (via
  421. individualized log-in procedures), whilst preserving system
  422. administrator status for a "Root" or "Super-User" account.
  423.  
  424. 5)  Built-in message/text/file editor is far and away superior to the
  425. WAFFLE editor, offering among other features which WAFFLE does not
  426. have:
  427.             - easy movement between lines via word-processor type
  428.             commands and cursor keys.
  429.             - easy text formatting (margins, tabs,  etc .)
  430.             - message mode allows carbon copies, blind copies, alias
  431.             recognition  on the address fields.
  432.             - allows the composition of special characters from the
  433.             ASCII extended character set.
  434.             - does spell-checking, and includes 5000 term user-
  435.             maintained dictionary as well as 60,000 word built-in
  436.             dictionary.
  437.             - maintains templates for frequently contacted addressees
  438.             - will save work in progress if the writer is interrupted
  439.             before he or she has completed the message. The user is
  440.             prompted, upon logging in for the next time, whether to
  441.             resume the previous email, (there's that insidious,
  442.             insipid, inchoate, noun again! When I read my
  443.             MAIL I don't read IT MAIL by MAIL, but LETTER
  444.             by LETTER. Ergo, when reading my EMAIL, I read
  445.             IT MESSAGE by MESSAGE, n'est-ce-pas?) or to begin
  446.             another email message.
  447.             - context-sensitive, on-line help.
  448.  
  449. 6)  User-lists, address books, distribution/mailing lists, from which
  450. text can easily be selected via a highlight bar, for insertion into
  451. messages, either as addresses, or as content.
  452.  
  453. 7)  MIME (Multi-purpose Internet Mail Extensions), a recent INTERNET
  454. standard for transmitting binary attachments to normal ASCII text
  455. messages is supported. (N.B. I have not verified this feature yet,
  456. though I have no doubt that it works, and that it will make life
  457. considerably easier, in that users will be able to share non-ascii
  458. files much more easily over the net once this MIME standard gains
  459. more widespread support.)
  460.  
  461. 8)  Offers confidentiality for sensitive data/messages, via
  462. individual user-chosen encryption keywords for message text.
  463.  
  464. 9)  SNUUPM incorporates full adherence to the INTERNET's RFC 822,
  465. which relates to the Unix to Unix CoPy Protocol. This means that
  466. it will interface readily with ANY system running UUCP, including
  467. UPR2.CLU.NET running UNIX SunOS, and our own host concentrator node,
  468. niherst.gov.tt running WAFFLE v. 1.65 under MS-DOS v. 6.0.
  469.  
  470. 10)The entire suite of programs, including source code in C is FREE,
  471. provided that simple guidelines are followed with respect to non-
  472. commercial usage, etc.
  473.  
  474. 11) The author/programmer of the SNUUPM application program is an
  475. INTERNET Domain co-ordinator, and is available on the net for help
  476. and advice. (N.B.  Since Feb 1992 when NIHERST first started using
  477. WAFFLE, we have never had any response from the programmer when we
  478. contacted him via emial with queries regarding WAFFLE. SNUUPM could
  479. hardly do worse.)
  480.  
  481. Now, I would very much like to see the end of WAFFLE on our system, but I 
  482. think I'll need to keep using it for it's BBS capabilities, for persons 
  483. who either cannot or will not use the SNUUPM batch mode of sending 
  484. messages. (Masochists, like the people looking for their UNIX gurus, I 
  485. presume!)
  486.  
  487. However, I'd much prefer it if I could get SNUUPM to talk to WAFFLE on 
  488. the SAME machine, so that I would be able to utilize its capabilities 
  489. more fully. 
  490.  
  491. Here's my setup: I'm running WAFFLE on drive E: of a DELL 486DX/33 box, 
  492. in a protected DOS window under MS-Windows 3.1. The BBS is on-line all 
  493. day, and there's no other way I can do this under "DOS" (not that I know
  494. any other OS, either!) There are a couple of other offices that run WAFFLE 
  495. on their machines, and call in to batch their outgoing messages; and there
  496.  are a few users who call in via their "PROCOMM PLUS" or "TELIX" software 
  497. (TELIX is an old favourite of mine. Do you know it? Is there a shareware 
  498. version after v 3.11?).
  499.  
  500. Now, both those types of users are going to be well served if they can be 
  501. persuaded to switch to SNUUPM: that's no problem. My problem is a selfish 
  502. one: how to get access to SNUUPM  for MYSELF. Any suggestions?
  503.  
  504. [personal message removed]
  505.  
  506. Best regards.
  507. Lars.
  508.  
  509.  
  510. *=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
  511.  Lars Johnson    | 4 Serpentine Place,           | Tel 1-809  628-8523,
  512.  NIHERST,        | St. Clair,                    |     1-809  622-7879 /80.
  513.  Documentation   | Trinidad, W.I.                | Fax 1-809  622-1589
  514.  Centre          | lars_j@niherst.gov.tt ;-)     | root@niherst.gov.tt :-|
  515. *=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*
  516.  
  517.  
  518.  
  519.  
  520. From aau!aau.ru.ac.za!jbp@kudu.ru.ac.za Tue Jan 18 20:04:06 1994
  521. Return-Path: <aau!aau.ru.ac.za!jbp@kudu.ru.ac.za>
  522. Received: from kudu.ru.ac.za by hippo.ru.ac.za (4.1/Hippo-02.06)
  523.     id AA20973; Tue, 18 Jan 94 20:04:05+020
  524. Received: from aau by kudu.ru.ac.za with uucp
  525.     (Smail3.1.28.1 #1) id m0pMKmZ-000MjqC; Tue, 18 Jan 94 20:04 EET
  526. Message-Id: <m0pMKmZ-000MjqC@kudu.ru.ac.za>
  527. Received:  from aau by aau.ru.ac.za (UUPC/extended 1.12b) with UUCP;
  528.            Tue, 18 Jan 1994 17:30:44 EST
  529. From: <jbp@aau.ru.ac.za>
  530. To: ccml@hippo.ru.ac.za
  531. Date:          Tue, 18 Jan 1994 17:30:35 
  532. Subject:       Signons note
  533. Priority: normal
  534. X-Mailer:     PMail v3.0 (R1)
  535. Status: RO
  536.  
  537. Dear [name deleted]
  538.  
  539. Greetings from the AAU Secretariat.  We hope that the year 1994 will see
  540. electronic networking and communications proliferating in West and Central
  541. Africa through our collaborative efforts with you our member universities
  542. in the region.
  543.  
  544. AAU's present email connection through the UUCP/Internet gateway at Rhodes
  545. University in South Africa is working remarkably well.  We recovered from a
  546. serious problem with our own set-up and this has brought us useful
  547. experience with the SNUUPM package.
  548.  
  549. Meanwhile, we have received information from Mike Lawrie to the effect that
  550. he has set up a UUCP/Internet signon account for you on the host machine at
  551. Rhodes.  The information follows:
  552.  
  553.    [information removed]
  554.  
  555. Thus your computer's full address will be <arcis.ru.ac.za>, and if you
  556. followed SNUUPM's default installation procedure, the primary (base) user
  557. will be "root"  (ie. <root@arcis.ru.ac.za>).  After the installation, you
  558. can register other users on the system by selecting option  "A) Register a
  559. New User on SNUUPM" on the SNUUPM opening (main menu) screen.  But for a
  560. start just use the "root" user-id.
  561.  
  562. Following are a few instructions and tips which we feel will be helpful in
  563. getting you off to a good start.
  564.  
  565. A.   Installing SNUUPM
  566.  
  567. i.   You need to have the two SNUUPM installation diskettes which were
  568.      distributed at the workshop with you.  You need also have at least
  569.      4Mb of free space on your PC's hard disk.
  570.  
  571. ii.  Create a directory on your hard disk (say, MD \SNUUPM), change into
  572.      this directory (CD SNUUPM), and copy (copy a:*.*) all the files on
  573.      the SNUUPM diskettes into this directory.
  574.  
  575. iii. ENTER pkunzip snuupm21.zip
  576.      (This will create the following 3 files: SNUUPM21.DOC, SNUUPM.ZIP,
  577.      and INSTALL.BAT.  It is advised, and indeed essential, that you read
  578.      at least the first 4 screenfuls of the SNUUPM21.DOC file before
  579.      proceeding with the installation).
  580.  
  581. iv.  Edit your AUTOEXEC.BAT file to contain certain lines indicated in the
  582.      SNUUPM21.DOC file.  (Better to put these lines at the end of the
  583.      AUTOEXEC.BAT file to avoid mixing it with its original contents).
  584.  
  585.      The author advises these lines be copied, as is, into your
  586.      AUTOEXEC.BAT file to avoid making any typographical errors when re-
  587.      typing.  You can do this in any standard DOS text editor, or in a
  588.      wordprocessor such as WordPerfect.  But remember, in the case of
  589.      WordPerfect 5.1, to save the final amended AUTOEXEC.BAT file as DOS
  590.      (ASCII) Text [ie. Ctrl-F5, 1(Dos Text), , 1(Save)], and not as normal
  591.      WP text.
  592.  
  593. v.   Include the following line at the end of your CONFIG.SYS file to make
  594.      some amount of memory space available for environment variables -
  595.      SNUUPM uses a lot of them.
  596.  
  597.           shell=c:\command.com /e:2048 /p
  598.  
  599. vi.  Re-boot so that all the changes/additions take effect.
  600.  
  601. vii. Change back into the directory where you copied the SNUUPM files in
  602.      step ii. above, and ENTER "install".
  603.  
  604.   [This next para applies to SNUUPM21 - SNUUPM22 has a "better"
  605.    menu-controlled installation process. Mike Lawrie]
  606.  
  607. >From this point onwards, the procedure is pretty automatic, but you will be
  608. required to answer a few questions about your system - your modem speed
  609. (baud rate) and type (very important, therefore look carefully through the
  610. list that SNUUPM displays screenful by screenful, jot down the name(s) that
  611. best describes/matches your modem type and speed, and type back this name
  612. when asked), password, domain name, etc.  If your modem type is not listed,
  613. then you will need to create your own "modem.mdm" file into the \etc\uupc\
  614. directory. And some level of expertise is required to do this successfully.
  615. At the end of the installation process, the system lists (on your screen)
  616. the options that you chose, and asks for your final confirmation.  It is
  617. advised that you print and keep a copy of these settings using the "Print
  618. Screen" key on your keyboard. (Of course, a Ready printer should be
  619. attached to your PC in order to achieve this).
  620. The system also advises you to check on certain settings in certain files. 
  621. But before tampering with any of these files, read the relevant portions in
  622. SNUUPM21.DOC file about the mentioned files or settings.
  623.  
  624. You are now ready to start SNUUPM and to create and send/receive messages.
  625.  
  626. Start SNUUPM by ENTERING "snuupm" at the DOS prompt.
  627.  
  628.  
  629. B.   Creating a simple mail message in SNUUPM
  630.  
  631.      In the opening SNUUPM screen, observe that "User is root" is
  632.      indicated right on top of the SNUUPM Main Menu options.
  633.  
  634. i.   Select  1) Mail
  635.  
  636. ii.  Select  S: Send a mail message
  637.      You are taken to the Send Message: Editing Screen, with your cursor
  638.      at the "To: [ " line.
  639.  
  640. iii. ENTER the e-mail address of your message's recipient.  (In this case,
  641.      pls. send a simple test message to me <jbp@aau.ru.ac.za> or to Mike
  642.      Lawrie <ccml@hippo.ru.ac.za>).
  643.  
  644. iv.  The "Subj: " slot could be any text - the "theme" of your message.
  645.  
  646. v.   Type in a short test message, then press Ctrl-Enter.
  647.      You will see the message being queued by "rmail" for onward
  648.      forwarding through "kudu" to your intended recipient.
  649.  
  650.  
  651. C.   Connecting to Kudu (Transmitting your message)
  652.  
  653. i.   Make sure that your modem is turned on, and that it is connected to
  654.      your PC's serial (COM) port via a RS-232 (printer) cable.
  655.  
  656.      Ensure also that your International Direct Dialing (IDD) line (often
  657.      attached to your fax machine) is plugged into the slot on your modem
  658.      marked "TO LINE" not the one marked "TO PHONE".
  659.  
  660.      You are now all set to connect to kudu, and to transmit your
  661.      message(s).
  662.  
  663. ii.  Return to the SNUUPM Main Menu screen by pressing Esc or Q(Quit) as
  664.      many times as necessary.
  665.  
  666. iii. Select option 4) Connect to the Mailserver, and watch your modem
  667.      trying to talk to kudu's modem and to exchange messages with it. 
  668.      Dont give up if the first few trials report "BUSY" or some similar
  669.      messages.  Kudu's modem may be engaged or your local IDD line may
  670.      also be trully "BUSY" and in heavy use at the time of your call. 
  671.      Neither mind any "funny" (machine language) characters that appear on
  672.      your screen - they may all be due to "noise"/surges on the phone
  673.      lines.  There is, therefore, the need to persevere.
  674.      If you receive "NO DIALTONE", it may be because your IDD line is not
  675.      connected to your modem at all, or that it is connected to the "TO
  676.      PHONE" slot instead of the "TO LINE" slot.
  677.  
  678. As soon as you see:
  679.  
  680.      "arcis connected to kudu: at [your modem baud rate, eg. 2400 bps], g
  681.      protocol, z grade"
  682.  
  683. then you know that your system has been recognized by kudu, and you can
  684. send e-mail anywhere in the world!
  685.  
  686. All the best, and please feel free to contact us again if you have any
  687. further questions.
  688.  
  689. Yours sincerely,
  690.  
  691. John Bart-Plange
  692. Technical Assistant
  693.  
  694. PS:  Please pardon me if the above "instructions" are seen as an
  695.      "intrusion" and a belittling of your knowledge and expertise, but we
  696.      wanted only to help.
  697.  
  698.  
  699.  
  700. From garuda!garuda.indiacur.com!arvind@hustle.rahul.net Wed Jan 19 18:38:59 1994
  701. Return-Path: <garuda!garuda.indiacur.com!arvind@hustle.rahul.net>
  702. Received: from hustle.rahul.net by hippo.ru.ac.za (4.1/Hippo-02.06)
  703.     id AA10544; Wed, 19 Jan 94 18:38:52+020
  704. Received: from garuda.UUCP by hustle.rahul.net with UUCP id AA15634
  705.   (5.67a8/IDA-1.5 for ccml@hippo.ru.ac.za); Wed, 19 Jan 1994 08:39:18 -0800
  706. Message-Id: <199401191639.AA15634@hustle.rahul.net>
  707. Received:  from garuda by garuda.indiacur.com (UUPC/extended 1.12b) with UUCP;
  708.            Wed, 19 Jan 1994 08:38:13 GMT
  709. From: <arvind@garuda.indiacur.com>
  710. To: ccml@hippo.ru.ac.za
  711. Date:          Wed, 19 Jan 1994 08:38:11 
  712. Subject:       Suggestion
  713. Priority: normal
  714. X-Mailer:     PMail v3.0 (R1a)
  715. Status: RO
  716.  
  717. Hi Mike,
  718.  
  719. Last night, I installed the same version of SNUUPM on four other 
  720. machines which are networked to my PC mailserver machine. Here are 
  721. some notes:
  722.  
  723. 1. Well, first I had to modify a lot of SNUUPM configurations files 
  724. by hand, changing the drive letter D:\SN (my %sndrive%) to the 
  725. *network* drive letter K:\SN. Had I chosen K: at the time of 
  726. installation, it would have saved me a lot of work later. Is this 
  727. something you want to suggest in the documentation?
  728.  
  729. 2. Next, I had to modify the CONFIG.SYS, AUTOEXEC.BAT, and SYSTEM.INI 
  730. file on four other machines as follows:
  731.  
  732. CONFIG.SYS
  733.     SHELL=C:\DOS\COMMAND.COM C:\DOS /E:2048 /P
  734.     
  735. AUTOEXEC.BAT
  736.     I found it easier to create one common file 
  737.         K:\SN\USR\LIB\SNUUPM\INITENV.BAT
  738.     which contains all your suggested commands and then to insert the 
  739. following line in AUTOEXEC.BAT files of all other computers *after* 
  740. loading the network drivers so that the K:\SN drive is defined:
  741.         CALL K:\SN\USR\LIB\SNUUPM\INITENV.BAT
  742. This work very well. The CALL does modify the environment before it 
  743. ends.
  744.  
  745. SYSTEM.INI
  746.     To make SNUUPM-in-a-window work, I had to patch the Windows 
  747. SYSTEM.INI file on all computers so that the appropriate line in 
  748. there read 2048 instead of 512:
  749.         CommandEnvSize=2048
  750.         
  751. 3. Next I reboot all machines with the new configurations.
  752.  
  753. 4. If you try to run SNUUPM at the same time on more than one
  754. machine, you get a "sharing violation error". The solution is to mark
  755. all the files in K:\SN\USR\LIB\SNUUPM as read-only. This seems to
  756. make it work. I haven't run into any problems as a result -- yet!
  757. Perhaps you can advise as to which specific files should *not* be read-
  758. only.
  759.  
  760. 5. After this, I go into Windows, define a new program manager item 
  761. using your SNUUPM.PIF file, and I'm all set! Works like a charm.
  762.  
  763. One suggestion I have for the SNUUPM.BAT file: If the user doesn't 
  764. specify a name in %1 argument, and PMUSER is not defined, it prints 
  765. an error msg and refuses to run. This is good. What would be better 
  766. is if it then asks for your user name and then runs. From Windows, it 
  767. asks for a "parameter" which is not terribly obviously to new users 
  768. of SNUUPM. Just a thought.
  769.  
  770.   [This suggestion has been incorporated into SNUUPM23. Mike Lawrie]
  771.  
  772. Another question: Is there some way to configure UUPC so it would 
  773. connect to the remote mailserver automatically, say, every half-hour? 
  774. Right now, I have to initiate that on my own, and my unix machine 
  775. will not initiate a call on its own (their policy/terms).
  776.  
  777.   [The answer is to look at the UUCP documentation for UUPOLL. Mike
  778.    Lawrie]
  779.  
  780. Many, many thanks for a fine package. The more I use it, the better 
  781. it feels. Thanks for the online support, too. Without it, it would 
  782. have taken me much longer.
  783.  
  784. - Arvind Kumar
  785.  
  786. P.S. Do I need to say that I am composing this in SNUUPM on my PC?
  787. In minutes, it shall make its way from my PC to South Africa,
  788. halfway around the globe!
  789.  
  790. ii  cccc  India Currents            arvind@indiacur.com
  791. ii cc     The Complete Indian American Magazine * Since 1987
  792. ii cc     P.O. Box 21285            Phone:  (408) 274-6966
  793. ii  cccc  San Jose, CA 95151-1285        Fax:    (408) 274-2733
  794.  
  795.  
  796.  
  797. ------------------------------------------------------------------------
  798.  
  799.                        Key to the Configuration
  800.                        ------------------------
  801.  
  802. 1. CONFIG.SYS, AUTOEXEC.BAT
  803. ===========================
  804.  
  805. The SNUUPM system makes extensive use of environment variables. Some
  806. have to be preset in the AUTOEXEC.BAT file, others are used as and
  807. when the system is working. Thus you have to allow for far more than
  808. the default environment space.
  809.  
  810. The additions to AUTOEXEC.BAT, as described under QUICKSTART, cause
  811. your PC to boot up ready to be used by user "root". While using
  812. "root" as you personal user-id is not good Unix practice, it gets you
  813. going very simply and is perfectly legit. The file
  814.  
  815.     c:\usr\lib\snuupm\utl\main.mnu
  816.  
  817. controls the options that are available to users - root is permitted
  818. to dial to other systems, and to run the user registration operations.
  819. It is a simple matter to alter MAIN.MNU to allow all users to do all
  820. things.
  821.  
  822.  
  823. 2. SNUUPM1.BAT
  824. ==============
  825.  
  826. Start the system by typing
  827.  
  828.     snuupm
  829. or
  830.     snuupm USER-ID
  831.  
  832. This will invoke the SNUUPM.BAT file that you have installed in a 
  833. directory in the search path, and this in turn invokes SNUUPM1.BAT.
  834.  
  835. SNUUPM1.BAT creates three environment variables that are unique to the
  836. user-id. This allows many users to use the same PC, as long as they
  837. accept that MSDOS provides no protection against one user prying into
  838. the files of another. There is no password protection, although PMAIL
  839. does allow messages to be encrypted.
  840.  
  841. SNUUPM1.BAT file needs no editing, but you need to ensure that you have
  842. first created the necessary files/directories for other users. (The
  843. ADDUSER commands makes this a simple procedure).
  844.  
  845. If you have configured AUTOEXEC.BAT according to the QUICKSTART
  846. description, the system will default to using the user-id "root". You
  847. might prefer to modify your autoexec.bat file once you have registered
  848. a "better" user-id for yourself. If you do this, then you might like
  849. to give yourself the privileges that "root" enjoys, so edit a few
  850. lines in
  851.  
  852.     c:\usr\lib\snuupm\utl\main.mnu
  853.  
  854. The SNUUPM command sets these environment variables:-
  855.  
  856. 2.1. uupcusrrc=c:\usr\USER-ID\USER-ID.rc
  857. --------------
  858.  
  859. 2.2. snewsrc=c:\usr\USER-ID\snews.rc
  860. ------------
  861.  
  862. 2.3. pmuser=USER-ID
  863. -----------
  864.  
  865. These three are used by PMAIL to identify one user from another.
  866.  
  867.  
  868. 3. UUPCSYSRC (c:\etc\uupc\uupc.rc)
  869. ============
  870.  
  871. This environment variable is defined in AUTOEXEC.BAT. The file that it
  872. points to, viz uupc.rc, must have the following configuration in order
  873. to dovetail the UUPC system to PMAIL and SNEWS.
  874.  
  875. 3.1. confdir=c:\etc\uupc
  876. ------------
  877.  
  878. This points to the directory that contains the UUPC files HOSTPATH,
  879. PASSWD, PERMISSN, SYTEMS and the MODEM.MDM file.
  880.  
  881. 3.2. maildir=c:\usr\spool\mail
  882. ------------
  883.  
  884. This is where the UUPC program RMAIL will store mail for each user-id.
  885. The name of this directory must dovetail with the setting of PMAIL's
  886. "New mailbox" and "New mail path" parameters. Use PCONFIG's "Standalone
  887. configuration" and "create a User-defined gateway" options to set the
  888. PMAIL parameters.
  889.  
  890. 3.3. newsdir=c:\usr\spool\news\incoming
  891. ------------
  892.  
  893. This is where the UUPC program RNEWS leaves batched news. The SNEWS
  894. UNBATCH program expects to find it in the directory set by NEWSDIR.
  895. For whatever reason, the setting of UUPCNEWS in AUTOEXEC.BAT must
  896. differ from the setting of this NEWSDIR value.
  897.  
  898. 3.4. spooldir=c:\usr\spool
  899. -------------
  900.  
  901. This names the directory that holds the log files of the UUPC programs.
  902. You need to examine/shorten/delete these files from time to time. The
  903. log files are useful during debugging, and could be used as the basis
  904. for monitoring the usage of mail/news.
  905.  
  906. 3.5. rmail, rnews
  907. -----------------
  908.  
  909. These parameters point to the location of the RMAIL.EXE and RNEWS.EXE
  910. program files.
  911.  
  912. 3.6. Organisation
  913. -----------------
  914.  
  915. Use something sensible.
  916.  
  917. 3.7. Uncompress
  918. ---------------
  919.  
  920. Set to "c:\usr\lib\snuupm\compress -d %s". Note that this COMPRESS.EXE
  921. is not the same as a "normal" DOS COMPRESS.EXE program, due to the fact
  922. that news is batched according to Unix standards of end of line
  923. sequences.
  924.  
  925. 3.8. Inmodem
  926. ------------
  927.  
  928. Must be MODEM, which is a file in the c:\etc\uupc\ directory. This will
  929. be used to drive the modem for incoming UUCICO calls. This matches the
  930. word "modem" in c:\etc\uupc\systems. This is a copied-and-renamed file
  931. from the collection of .MDM files that are extracted during the
  932. installation of SNUUPM.
  933.  
  934. 3.9. Mailserv
  935. -------------
  936.  
  937. The name of the host computer that provides you with email connectivity.
  938.  
  939. 3.10. Nodename
  940. --------------
  941.  
  942. The name of your computer. Less that 8 characters in size, and must not
  943. contain "funny" characters like ".". For example, nodename=c119 defines
  944. a legitimate nodename. Liaise with the sysop at the site of your
  945. Mailserv machine in order to match. The nodename value also appears in
  946. the c:\etc\uupc\systems file.
  947.  
  948. 3.11. Domain
  949. ------------
  950.  
  951. The fully qualified domain name of your host. For example,
  952. domain=c119.ru.ac.za or domain=c119.uucp. THIS IS CRITCAL, IF YOU
  953. DON'T KNOW WHAT TO PUT HERE, ASK SOMEONE WHO DOES KNOW!
  954.  
  955. 3.12. Other
  956. -----------
  957.  
  958. Other settings follow a Unix style of setting - ie the directory
  959. C:\USR\SPOOL is used extensively. Be wary of what parameters that you
  960. remove - there is some "real dirty" parsing and counting of the
  961. parameter file by some of these programs (of the SNEWS suite), and
  962. the error messages are not very helpful.
  963.  
  964.  
  965. 4. UUPCNEWS (c:\usr\spool\news)
  966. ===========
  967.  
  968. This environment variable is defined in AUTOEXEC.BAT. The directory
  969. to which it points contains the following:-
  970.  
  971. 4.1. Newsbase
  972. -------------
  973.  
  974. the NEWSBASE directory, where the news items are stored in a form
  975. ready to read by the SNEWS program
  976.  
  977. 4.2. Active newsgroups
  978. ----------------------
  979.  
  980. the ACTIVE file, which links the names of the newsgroups to the
  981. contents of the NEWSBASE directory
  982.  
  983. 4.3. .NRC files
  984. ---------------
  985.  
  986. the users' .NRC file (ie a file per user), holding the information
  987. as to what newsgroups have been read.
  988.  
  989. 4.4 The HISTORY file
  990. --------------------
  991.  
  992. Tracks the delivery of news. SNEWS won't run without it.
  993.  
  994. 4.5 The USER-ID.NRC files
  995. -------------------------
  996.  
  997. There is one per user-id, which contains the current pointers for the
  998. particular user-id.
  999.  
  1000. 4.6. INCOMING Directory
  1001. -----------------------
  1002.  
  1003. The UUPC.RC parameter NEWSDIR is set to the setting of the uupcnews
  1004. environment variable followed by "\INCOMING". This is used to hold the
  1005. unbatched news items.
  1006.  
  1007.  
  1008. 5. UUPCUSRRC (c:\usr\USER-ID\USER-ID.rc)
  1009. ============
  1010.  
  1011. The file pointed to by this environment variable contains the UUPC
  1012. setups that are unique to USER-ID.
  1013.  
  1014. 5.1. Name
  1015. ---------
  1016.  
  1017. Your personal name. Not critical.
  1018.  
  1019. 5.2. Mailbox
  1020. ------------
  1021.  
  1022. Your user-id. Absolutely critical, this must dovetail with several
  1023. other parameter settings. DOUBLE CHECK THAT YOU HAVE THIS CORRECT if
  1024. your are bold enough to attempt to change things at a low level.
  1025.  
  1026. 5.3. Home
  1027. ---------
  1028.  
  1029. Set this to c:\usr\USER-ID for safety sake. Probably not used by
  1030. the system (it is used by the MAIL process of UUPC).
  1031.  
  1032. 5.4. Signature
  1033. --------------
  1034.  
  1035. Not critical. Point it to the signature file that you set up for
  1036. PMAIL, ie c:\usr\USER-ID\mbox\inetsig.pms. In general, limit your
  1037. signature to be no more than 4 lines because there are a goodly
  1038. number of folk on the networks who pay high rates for telephone
  1039. calls and you will be causing them some expense each time that
  1040. your signature is mailed to them at the end of your messages.
  1041.  
  1042.  
  1043. 5.5. Editor
  1044. -----------
  1045.  
  1046. This is the name of your favourite ASCII editor - it must produce
  1047. ordinary ASCII codes, not the fancy stuff of a word-processor. Add
  1048. a "%s" after the name of the editor, so that the correct filename
  1049. will be substituted on the command line. For example:-
  1050.  
  1051.     Editor=c:\bin\vi.exe %s
  1052.  
  1053. 5.6. Aliases
  1054. ------------
  1055.  
  1056. This is a list of aliases used by the MAIL (not PMAIL) program of
  1057. UUPC. The contents are a series of single lines with an alias name,
  1058. gap, and the address to be used when MAILing to that alias. Probably
  1059. not of much use.
  1060.  
  1061.  
  1062. 6. SNEWSRC (c:\usr\USER-ID\snews.rc)
  1063. ----------
  1064.  
  1065. The file pointed to by this environment variable contains the SNEWS
  1066. setups that are unique to USER-ID.
  1067.  
  1068. 6.1. Name, Mailbox, Home, Signature, Editor, Aliases, Organization.
  1069. ------------------------------------------------------------------
  1070.  
  1071. Set these EXACTLY as you have done for your USER-ID.rc file. SNEWS will
  1072. make use of them. Spell "Organization" with a "z" not an "s".
  1073.  
  1074.  
  1075. 7. PCONFIG, PMAIL, BURST and UNBATCH
  1076. ====================================
  1077.  
  1078. The parameter values of these must dovetail EXACTLY with the rest of
  1079. the package, or mail and/or news will not flow.
  1080.  
  1081. Incoming mail and news are processed like this:-
  1082.  
  1083. a) UUCICO receives uucp-style files into c:\usr\spool\kudu\{D,X}
  1084.  
  1085. This filename is made up of 
  1086.  
  1087.     UUPCSYSRC(spooldir)
  1088.     \
  1089.     Name of system that is dialed
  1090.     D or X as required by the uucp process
  1091.  
  1092.  
  1093. b) UUXQT processes the mail files, and leaves them in the file
  1094.    c:\usr\spool\mail\USER-ID, in a uucp format. The RMAIL program
  1095.    is run by UUXQT to do this work.
  1096.  
  1097.    This filename is made up of
  1098.  
  1099.     UUPCSYSRC(maildir)
  1100.     \
  1101.     UUPCUSRRC(mailbox)
  1102.  
  1103.    News is deposited in the c:\usr\spool\news\incoming directory, and
  1104.    would normally be in a batched format. RNEWS is run by UUXQT to
  1105.    do this work.
  1106.  
  1107.  
  1108. c) BURST transfers the mail files output by UUXQT/RMAIL into the
  1109.    PMAIL 'new mail' directory c:\usr\USER-ID\mail\. It does this by
  1110.    running a program UU2PM under control of the file
  1111.    c:\pmail\burst.bat. The parameters that UU2PM takes look
  1112.    like this:-
  1113.  
  1114.      uu2pm -d <source-file> <destination-file>
  1115.  
  1116.     The <source-file> is whatever file appears in the directory
  1117.  
  1118.           \usr\spool\mail\
  1119.  
  1120.    The <destination-file> is stored under the appropriate USER-ID
  1121.    according to the address of the message, and looks like
  1122.  
  1123.           \usr\USER-ID\mail\uuXXXXXX.CNM
  1124.  
  1125.    It is CRITICAL that <source-file> of UU2PM matches the output file
  1126.    of UUXQT, and that the <destination-file> of UU2PM matches the
  1127.    directory names that are configured into PMAIL and into the
  1128.    c:\usr\lib\snuupm\burst.bat file.
  1129.  
  1130. d) UNBATCH moves the INCOMING news into the NEWSBASE directory, and sets
  1131.    up the necessary index files that are used by the SNEWS newsreader.
  1132.    
  1133. 7.1. PCONFIG
  1134. ------------
  1135.  
  1136. The dovetailing of PMAIL into the UUPC style of working described above
  1137. is done by running PCONFIG, and removing the DEFAULT.PM file of PMAIL,
  1138. if indeed it exists. The first PCONFIG menu offers three options, viz:-
  1139.  
  1140. 7.1.1.  Standalone configuration
  1141. --------------------------------
  1142.  
  1143. The following are set and need no changing:-
  1144.  
  1145.     Home mailbox     ~%sndrive%\usr\~8\mbox
  1146.     New mailbox      ~%sndrive%\usr\~8\mail
  1147.     Async gateway?   N
  1148.  
  1149. The home mailbox can be anything that is not yet used, but it is
  1150. essential that the new mailbox matches the directory of the 
  1151. <destination-file> used in the UU2PM run.
  1152.  
  1153. 7.1.2. Create a User-defined gateway
  1154. ------------------------------------
  1155.  
  1156. Select the (only) defined gateway, viz UUPC, and you will find (and must
  1157. leave) this setting:-
  1158.  
  1159.     New mail path   ~%sndrive%\usr\~8\mail
  1160.  
  1161. This is the same as the "new mailbox" of the standalone configuration
  1162. of PMAIL.
  1163.  
  1164. These values should all be preset in the disk issued by Rhodes
  1165. University, so you will have nothing to do unless you are changing
  1166. the way that the three separate packages dovetail together.
  1167.  
  1168. Some of the settings have evolved as SNUUPM has matured, and at version
  1169. 22 of SNUUPM look like this:-
  1170.  
  1171.     New mail search path   *.cnm
  1172.     Run for outgoing mail  snu_fpm ~c | rmail ~t
  1173.     Reply address format   ~p <~8@~%snu_hd%>
  1174.  
  1175.  
  1176. 8. Modem file, Systems file
  1177. ===========================
  1178.  
  1179. Here you might need to have some guru advice, and this cannot be
  1180. obtained from a document such as this. You need to select or create a
  1181. suitable .MDM file, and to store this file in c:\etc\uupc\modem.mdm.
  1182.  
  1183. There is the Rhodes University's collection of .MDM files in the
  1184. c:\usr\lib\snuupm\mdm directory and there are a further number included
  1185. with the UUPC package, in one of the .ZIP files.  You might well have to
  1186. modify any .MDM as necessary (eg to use COM1 or COM2 and/or other
  1187. options), and copy it to c:\etc\uupc\modem.mdm.
  1188.  
  1189. There is further advice on configuring the .MDM and SYSTEMS files in the
  1190. SAMPLE.MDM file that is part of the UUPC package. Note, however, that
  1191. the .MDM file must be called "c:\etc\uupc\modem.mdm" or you will have to
  1192. alter some well-hidden configuration parameters.
  1193.  
  1194. You need to edit the c:\etc\uupc\systems file to have the correct
  1195. dialing sequence, username and password to allow your system to 
  1196. exchange mail with a remote uucp host.
  1197.  
  1198.  
  1199. 9. Essential Directories and Files
  1200. ==================================
  1201.  
  1202. Certain directories and files need to be created in order for the programs
  1203. to run. In spite of what the documentation of the individual packages
  1204. say, not all of these are created automatically by the programs of those
  1205. packages, so don't be lulled into a false sense of security. All the
  1206. necessary directories that SNUUPM uses are created by SNUUPM.
  1207.  
  1208. 9.1. Directories
  1209. ----------------
  1210.  
  1211. The empty directories that the pkunzip -d process does not create are
  1212. created by the INSTALL.BAT file.
  1213.  
  1214. 9.2. Files
  1215. ----------
  1216.  
  1217. Create these files, if somehow you have destroyed them:-
  1218.  
  1219.     \etc\uupc\hostpath
  1220.     A single line "# Nothing here!" is fine.
  1221.  
  1222.     \usr\spool\news\history
  1223.     A single line with a space will do.
  1224.  
  1225.  
  1226. 10. General Maintenance
  1227. =======================
  1228.  
  1229. 10.1. Registering users
  1230. -----------------------
  1231.  
  1232. The commands ADDUSER and RMUSER simplify this process. The following
  1233. directories are made by ADDUSER:-
  1234.  
  1235.     c:\usr\USER-ID\mail
  1236.     c:\usr\USER-ID\mbox
  1237.  
  1238. The following files are created by ADDUSER:-
  1239.  
  1240.     c:\usr\USER-ID\USER-ID.rc
  1241.     c:\usr\USER-ID\snews.rc
  1242.     c:\usr\USER-ID\aliases.txt
  1243.  
  1244. The contents of these files are described above, under UUPCUSRRC and
  1245. SNEWSRC.
  1246.  
  1247. An entry needs to be made in the c:\etc\uupc\passwd file:-
  1248.  
  1249.     USER-ID:*:::USER'S REAL NAME
  1250.  
  1251. 10.2. Newsgroups
  1252. ----------------
  1253.  
  1254. Edit the file c:\usr\lib\snuupm\active.bat to cause the ADDGROUP program
  1255. to add newsgroups to the list of newsgroups that you wish to read, and
  1256. then execute this ACTIVE.BAT file. Use the RMGROUP program to remove any
  1257. groups that you no longer wish to read, and edit them out of the
  1258. ACTIVE.BAT file. Understand, however, that in order to get news, and to
  1259. be net.sociable, your news configuration and that of your newsfeed host
  1260. must match.
  1261.  
  1262. From time to time, run the expire program to remove old news groups,
  1263. or run the iexpire program to do this interactively. Specify on the
  1264. command line the age in days of the news that can be expired. The simple
  1265. way to do this is to choose the appropriate option from the SNUUPM main
  1266. menu.
  1267.  
  1268. 10.3. Log files
  1269. ---------------
  1270.  
  1271. Periodically tidy up (eg delete and/or edit/truncate) the *.LOG files in
  1272. the directory c:\usr\spool\ -- this is a main menu option.
  1273.  
  1274.  
  1275. 11. Operation
  1276. =============
  1277.  
  1278. The whole system should be run from either the SNUUPM command. ie:-
  1279.  
  1280.     snuupm
  1281.  
  1282. A menu is displayed, and you select whichever operation you want by
  1283. point-and-shoot, or by function key.
  1284.  
  1285. You can set your system into receive mode (ie to allow other uucp
  1286. hosts to call it) by selecting the "Listen for incoming calls" option.
  1287. Use Ctl-C or Ctl-Break to interrupt the listening process.
  1288.  
  1289.  
  1290. 12. Copyright
  1291. =============
  1292.  
  1293. NONE OF THE COMPONENT PARTS OF SNUUPM, NOR THE ENTIRE PACKAGE, MAY BE
  1294. SOLD. FOR COMMERCIAL USE, CONTACT THE AUTHORS OF EACH PACKAGE AND
  1295. MAKE WHATEVER ARRANGEMENTS EACH AUTHOR REQUIRES.
  1296.  
  1297.  
  1298. 12.1. UU2PM.EXE
  1299. ---------------
  1300.  
  1301. The UU2PM.EXE file is freely distributable, thanks to ideas from Paul
  1302. Nash <paul@frcs.alt.za>. The current (SNUUPM22) production release was
  1303. written by the author of SNUUPM, do what you will with the code at your
  1304. own risk.
  1305.  
  1306. 12.2. UUPC 1.12
  1307. ---------------
  1308.  
  1309. The file UPC12BAD.ZIP contains the licensing information in the file
  1310. LICENSE.PRN. This is too lengthy to include here, and difficult to
  1311. summarise, so the specific file should be consulted. It seems to be
  1312. clear, however, that use of the package in a non-commercial environment
  1313. and in an unchanged form is well within the scope of the license, and
  1314. distribution of the package should include the source code.
  1315.  
  1316. The SNUUPM distribution does not include the UUPC package or any
  1317. component of that package.
  1318.  
  1319. 12.3 PMAIL v3.01
  1320. ----------------
  1321.  
  1322. The PMAIL program GUIDE.EXE displays the following text:-
  1323.  
  1324.        Pegasus Mail is an electronic mail system for use with Novell
  1325.     Netware (versions 2.15A and later): it is a fully-fledged mailer,
  1326.     one of its more unusual characteristics being that it is free - not
  1327.     shareware, but free. You can use it without charge, restriction or
  1328.     obligation on as many servers as you wish.
  1329.  
  1330.        I do sell manuals for the porgram, in order to support development
  1331.     costs, but manual purchases are strictly optional. An order form for
  1332.     manuals is provided in this guide - please print it out and attacht it
  1333.     to your order or cheque if you place an order.
  1334.  
  1335.        ...more...
  1336.  
  1337. The PMAIL author can be contacted at david@pmail.gen.nz (preferred) or at
  1338. david@otago.ac.nz.
  1339.  
  1340. Do NOT distribute PMAIL except as the complete PMAIL3xx.ZIP file.
  1341.  
  1342. The SNUUPM distribution does not include files from the PMAIL package,
  1343. but does include files created by this package for the UUPC<->PMAIL
  1344. gateway. These files were developed by the author of SNUUPM, do what
  1345. you will with them at your own risk.
  1346.  
  1347. 12.4. SNEWS191
  1348. --------------
  1349.  
  1350. Here is an extract from the file SNEWS.DOC found in SNEWS191.ZIP. You
  1351. are referred to that document for more details:-
  1352.  
  1353. >CAVEATS AND COPYRIGHT
  1354. >=====================
  1355. >
  1356. >    Version 1.12 of this software is copyright (1991) by John McCombs,
  1357. >                 Christchurch, New Zealand  <john@ahuriri.gen.nz>
  1358. >
  1359. >    Version 1.90 is copyright 1992 by Michael Studte/John Dennis (Shinohara
  1360. >                 Industries)
  1361. >
  1362. >    Version 1.91 is copyright 1993 by Daniel Fandrich <dan@fch.wimsey.bc.ca>
  1363. >                 or <72365.306@compuserve.com> (some portions are copyright
  1364. >                 1992 by Kai Uwe Rommel <rommel@jonas.bofe.sub.org> or
  1365. >                 <rommel@informatik.tu-muenchen.de>, and copyright 1985,
  1366. >                 1989 by Bill Davidsen)
  1367. >
  1368. >    This package is free software, but NOT public domain; you can
  1369. >    redistribute it and/or modify it under the terms of the GNU
  1370. >    General Public License, version 1, as published by the Free Software
  1371. >    Foundation.
  1372. >
  1373. >    This program is distributed in the hope that it will be useful,
  1374. >    but WITHOUT ANY WARRANTY; without even the implied warranty of
  1375. >    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  1376. >    GNU General Public License for more details.
  1377. >
  1378. >    See the file COPYING, which contains a copy of the GNU General
  1379. >    Public License.
  1380. >
  1381. >    The compress program and documentation included with the SNews
  1382. >    distribution were not written by the SNews authors and are not a formal
  1383. >    part of SNews.  The are part of the public domain compress ported by
  1384. >    Donald J. Gloistein.
  1385.  
  1386.  
  1387. At the request of the author of SNEWS, when the SNUUPM package was being
  1388. developed, this text is included:-
  1389.  
  1390.  "Portions of this software were derived from SNews, which is copyright
  1391.  by John McCombs <john@ahuriri.gen.nz>, and are included by permission 
  1392.  of the author.  NOTE: This version of SNews is not distributed under 
  1393.  the GNU Public Licence.  
  1394.    No warranty is offered by John McCombs in respect to this software 
  1395.  and no liability is accepted for the consequences of its use."
  1396.  
  1397. This note is still included even though SNEWS is not distrbuted as part
  1398. of SNUUPM.
  1399.  
  1400. 12.5. ASKENV.EXE
  1401. ----------------
  1402.  
  1403. Written by T Salmi and released for non-commercial, non-institutional
  1404. and non-profit use. <ts@uwasa.fi>.
  1405.  
  1406. 12.6. DOUGMENU Version 1.68
  1407. ---------------------------
  1408.  
  1409. Taken from the DOUGMENU.DOC file:-
  1410.  
  1411.       "TERMS OF USE for DougMenu v1.67, released on July 31, 1992
  1412.                      "Revised August 2, 1992
  1413.  
  1414. "This program is a freeware product and so should be distributed at
  1415. no charge, besides that of a reasonable media fee, if applicable. 
  1416.  
  1417. "No charge should ever be made for the program itself, or any
  1418. program using source code from this program.
  1419.  
  1420. "While users are free to modify DougMenu for their own use, modified
  1421. versions of DougMenu are not to be distributed out side of the
  1422. business or organization which created or commissioned them.  The
  1423. DougMenu package should always be distributed complete with source
  1424. and unaltered except when being installed for use at multiple sites
  1425. within a business or organization.  Then it is permitted to install
  1426. only the files deemed necessary to use the menu system as long as
  1427. one complete copy is maintained by the business or organization.
  1428.  
  1429. "If you have suggestion concerning the further development of
  1430. DougMenu, please contact the author concerning any changes you
  1431. suggest to the official version.
  1432.  
  1433. "A copy of the most recent version of DougMenu can be mailed to you
  1434. for US $10.  Printed Documentation is available for US $25.  US $5
  1435. surcharge for postage outside North America.  One year of customer
  1436. support via electronic mail is available for US $35.
  1437.  
  1438. "Send requests, comments, or orders to:
  1439.  
  1440. "Douglas A. Bell
  1441. 2585 Euclid Heights Blvd., APT #1
  1442. Cleveland, Ohio   44106
  1443. USA
  1444.  
  1445. "-or-
  1446.  
  1447. "dab6@po.cwru.edu
  1448.  
  1449.  
  1450. "THERE IS NO WARRANTY, EXPRESSED OR IMPLIED, FOR DOUGMENU.  WHILE
  1451. THE AUTHOR HAS ATTEMPTED TO PRODUCE AN ERROR FREE PROGRAM, THE
  1452. AUTHOR ASSUMES NO RESPONSIBILITY FOR ANY DAMAGE THAT THIS PROGRAM
  1453. MIGHT CAUSE.
  1454.  
  1455. "(c) Copyright 1992"
  1456.  
  1457.  
  1458. 13. Mailserver, Hostname, Domain, User-id, Baud Rate
  1459. ----------------------------------------------------
  1460.  
  1461. The mailserver name "kudu", the hostname "c119", the domain "ru.ac.za"
  1462. and the user-id "root" are what the author of SNUUPM uses. You will
  1463. need to alter these to suit your particular circumstances. Adding new
  1464. mailservers and user-ids to your PC involves making a few directories as
  1465. well - SNUUPM provides a simple interface for adding new users, but not
  1466. for adding new mailservers so you are "on your own" if you attempt this
  1467. (it has been done).  Changing your modem baud rate will require several
  1468. files to be changed, it is probably best to do this by a re-installation
  1469. of the package.  The INSTALL.BAT and INSTALL.MNU files make use of
  1470. install-time environment variables to set the values that the user
  1471. specifies interactively, and this is really the easiest way to do things
  1472. and to get them correct.
  1473.  
  1474. 13.1. Mailserver
  1475. ----------------
  1476.  
  1477. 13.1.1. Directories to be made
  1478. ------------------------------
  1479.  
  1480.     c:\usr\spool\MAILSERVER
  1481.     c:\usr\spool\MAILSERVER\c
  1482.     c:\usr\spool\MAILSERVER\d
  1483.     c:\usr\spool\MAILSERVER\x
  1484.  
  1485. 13.1.2. Files to be edited
  1486. --------------------------
  1487.  
  1488.     c:\usr\lib\snuupm\callin.bat
  1489.     c:\usr\lib\snuupm\callout.bat
  1490.     c:\etc\uupc\passwd
  1491.     c:\etc\uupc\permissn
  1492.     c:\etc\uupc\systems
  1493.  
  1494. 13.2. Hostname
  1495. --------------
  1496.  
  1497. Files to be edited:-
  1498.  
  1499.     c:\etc\uupc\systems
  1500.     c:\usr\uupc\uupc.rc
  1501.  
  1502. 13.3. Domain
  1503. ------------
  1504.  
  1505. File to be edited:-
  1506.  
  1507.     c:\etc\uupc\uupc.rc
  1508.  
  1509. 13.4. User-id (default=root)
  1510. -------------
  1511.  
  1512. Type
  1513.  
  1514.     adduser
  1515.  
  1516. (or better still, select the "Register a new user" option from the
  1517. SNUUPM menu) which will prompt you for the user-id (eg ccml, or mike,
  1518. or anything that is a valid DOS filename without an extension), and
  1519. then for the person's name (eg Mike Lawrie). The various files will
  1520. be created for this new user. Apart from making an entry in
  1521. c:\etc\uupc\passwd, all files and directories for the user are created
  1522. within the directory c:\usr\USER-ID, so removing a user involves
  1523. removing files and directories within this directory.
  1524.  
  1525.  
  1526. 13.5. Baud Rate
  1527. ---------------
  1528.  
  1529. The baud rate has to be configured into the c:\etc\uupc\systems and
  1530. c:\etc\uupc\modem.mdm files. The fourth field of the systems file and
  1531. the Inspeed parameter of the modem.mdm file must match the baud rate
  1532. of the modem.
  1533.  
  1534.  
  1535. 14. Removing the Package
  1536. ------------------------
  1537.  
  1538. Deregister user-ids with the RMUSER command.
  1539.  
  1540. Remove the contents of the directories
  1541.  
  1542.     c:\etc\uupc
  1543.     c:\usr\lib\snuupm
  1544.     c:\usr\root
  1545.     c:\usr\spool
  1546.  
  1547. and undo changes to your AUTOEXEC.BAT and CONFIG.SYS files.
  1548.  
  1549. Simple but sad :-( 
  1550.  
  1551.  
  1552. 15. Clashes
  1553. -----------
  1554.  
  1555. The PMAIL program was originally designed to run on a Novell network.
  1556. So, if you PC is on such a network, the chances are that the IPX and 
  1557. NETX programs will clash with the snuupm configuration. Too bad, until
  1558. someone provides a workaround.
  1559.  
  1560. ------------------------------------------------------------------
  1561. Please send comments and corrections regarding this document to
  1562. Mike Lawrie <ccml@hippo.ru.ac.za>.
  1563.  
  1564. This software is supplied on an "as is" basis, and there are no
  1565. guarrantees regarding fitness of purpose, reliability, workability
  1566. or anything of that nature.
  1567.  
  1568. Under no conditions may it be sold. The snuupm component may be 
  1569. distributed only for the reasonable cost of distribution. Commercial
  1570. use is prohibited.
  1571. ------------------------------------------------------------------
  1572.