home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / areamgr / area_mgr.doc next >
Text File  |  1991-12-11  |  5KB  |  118 lines
  1.  
  2. Areamanager version 1.2                                Released 11-12-1991
  3. ==========================================================================
  4. The multizone areafix programm                             
  5.  
  6. Copyright '91 by Erno Meffert
  7. Documentation Marcel Sacksen
  8.  
  9. -----------------------------------------------------------------
  10. The archive you just unpacked should contain the following files:
  11. -----------------------------------------------------------------
  12. AREAMGR.PRG = the main programm, to be run after you import your mail
  13. AREAMGR.CTL = the controlfile, containing your areas and passwords
  14. AREAMGR.DOC = the file you are reading now
  15. USERDOC.TXT = the documentation for your users
  16.  
  17. Everybody is encouraged to copy and spread this programm
  18.  
  19. Areamanager is written to enable nodes and points to connect and
  20. disconnect different echomail areas at their uplink. It works by 
  21. means of a simple netmail message to Areamanager at their boss' or hub's
  22. system.
  23.  
  24. Allthough the programm has been tested for a reasonable period, I can not
  25. give you garantee on anything else than the discspace it will take on your
  26. harddisk ;-) It seems to work OK on my system though.
  27.  
  28. How it works
  29. ============
  30. Everytime areamgr.prg is started it will scan your netmailarea for messages
  31. adressed to itself. If a message is found the programm will look at the
  32. from-field, to find out where the message came from, then it will look at
  33. the subject-field for a validated password. It checks these fields with
  34. the info in your areamgr.ctl file. If all turns out to be OK the programm
  35. will read the message text. If it finds a valid areaname, it will add the
  36. address of the sender to the area in your areas.bbs, OR, if the areaname
  37. in the message text is preceeded by a  -  it will remove the address of 
  38. the sender from that area in your areas.bbs.
  39. Finally areamanager will send a netmail message to your downlink, 
  40. containing all changed and available echomail areas, at your system.
  41. It is possible to configure areamanager in a way that certain nodes can 
  42. only connect to specified areas, for instance to keep points out of your 
  43. sysop areas, this works really simple: after any of the Areanames in your 
  44. Areamgr.ctl you can put any character (A-Z) to define a "character-level"
  45. for this area(s), only users with that character specified in the
  46. password-line can connect to the area(s).
  47. If the "character-level" (excuse the term, couldn't think of any better 
  48. way to describe it ;-)) does not fit to the user, the area(s) are not 
  49. even printed in the report-message.
  50. See the Installation section, and sample .CTL file for more detail on how
  51. this works.
  52.  
  53. Installation
  54. ============
  55. Place AREAMGR.PRG and AREAMGR.CTL in the same directory, areamgr looks at
  56. the environment variable "mailer" to find it's way around.
  57. Edit the sample AREAMGR.CTL controlfile according to your address(es), 
  58. and your own AREAS.BBS
  59.  
  60. Available commands:
  61. -------------------
  62. #Netmail       Give the complete path to your netmailarea (including area
  63.                number, no extension)
  64.  
  65. #Logfile       Give the complete path and filename.ext of your systemlog
  66.  
  67. #Report        Followed by "on" or "off", either turns the report function
  68.                on or off. (apart from this global command all users can
  69.                choose themselves if they want the report or not, by adding
  70.                %list or %nolist to the areafix messagetext)
  71.  
  72. #Address       can be used several times to specify all your addresses
  73.                (give the complete 4D address e.g. 2:281/801.0)
  74.  
  75. #Answer        Give the name Areamanager must look for in the netmail 
  76.                messages. (e.g. Areafix, Echofix, Areamgr or whatever you 
  77.                would like areamgr to listen to, there's no default, this
  78.                name must be specified!)
  79.        
  80. #Password      Followed by the 4D address, the areafixpassword, 
  81.                characterlevels, and ; to end the line
  82.                All areas can be assigned to a character-level for instance:
  83.                F (for Fidonetmail) N (for NeST areas) S (for sysop areas)
  84.                thus you can determine for every node which groups of 
  85.                mailareas he/she may link-up to. 
  86.  
  87. #TEXT          Followed by a character(s) and a text string.
  88.                The users "character-level" defines if the text is written 
  89.                to the report message or not. (See sample controlfile)
  90.  
  91. These commands are followed by a list of available areas from your BBS.
  92. Format to use:
  93.  
  94. N_TEST        N ; Nest test message area
  95. BINKLEY.ST    F ; International Binkley support area
  96. SYSOPS.028    S ; Dutch sysop area
  97. ATARI.028     F ; Nederlandse Atari ST area
  98.     ^         ^       ^
  99.     |         |       |     
  100.     |         |       description of the area
  101.     |         |
  102.     |         "character-level"
  103.     |
  104.     areaname
  105.  
  106.  
  107.  
  108. In case you still don't understand what to do after reading this file,
  109. or if you think you have found a bug, you can allways contact me at the 
  110. following addresses:
  111.  
  112. Erno Meffert 
  113. QuickBBS ST Arnhem
  114.  
  115. Fidonet   2:281/801.0
  116. NeST      90:4001/201.0
  117. BBS Phone 085-644262
  118.