home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / jaf_2_0 / read_me_.1st < prev   
Text File  |  1993-02-27  |  12KB  |  342 lines
  1.  
  2.                                                                    |
  3.        __ ¯¯//\         //|     // ////// ////// //////           \|/
  4.            // /\       // |    // //     //       //™            --*--
  5.           //  \/\     // 9|0  // ////   //////   //               /|\
  6.           \\  * /    //   |  // //         //   //                 |
  7.            \\  / _  //    | // //         //   // \    /           |
  8.             \\/__  //     |// ////// //////   //   \/\/ A R E--->--+
  9.  
  10.  
  11.          Jet2AutoFile (JAF) v02.00 - (C) D.M.Brewood - 1993.
  12.          ===================================================
  13.  
  14.  
  15. Introduction.
  16. -------------
  17.  
  18. Jet2AutoFile (JAF) is designed to help you keep track of your Autofile™
  19. FileFix settings when you are running the JetMail™ message processor.
  20.  
  21. JAF will read JetMail™'s CONFIG.JM file, plus the AUTOFILE.ORG and
  22. JET_FFIX.CFG setup files.
  23.  
  24. Once these files have been altered to suit, or created (see below),
  25. JAF will create a new AUTOFILE.CTL for AutoFile™. This new CTL file will
  26. contain all your area definitions, and autofile configuration data, plus
  27. new FileFix passwords for your JetMail™ links using the same password as
  28. used by JetMail™'s internal AreaFix routines.
  29.  
  30.  
  31. Setting Up.
  32. -----------
  33.  
  34. a) CONFIG.JM
  35.  
  36.    Firstly you must set your CONFIG.JM file to use the Non-link
  37.    'Group' Commands similar to:
  38.  
  39. Group F
  40. Description Fidonet.
  41. Announce STUN_NEW
  42. GroupEnd
  43. ;
  44. Group J
  45. Description Jetmail beta testers.
  46. Announce STUN_NEW
  47. GroupEnd
  48. ;
  49. Group N
  50. Description NeST Sysops.
  51. Announce STUN_NEW
  52. GroupEnd
  53.  
  54.    We are now going to set FileFix Echo Group flags for use by AutoFile,
  55.    this is done by adding ';FFix <Groups>' at the end of each 'Description'
  56.    line as follows:
  57.    
  58. Group F
  59. Description Fidonet. ;FFix OIH
  60. Announce STUN_NEW
  61. GroupEnd
  62. ;
  63. Group J
  64. Description Jetmail beta testers. ;FFix OH
  65. Announce STUN_NEW
  66. GroupEnd
  67. ;
  68. Group N
  69. Description NeST Sysops. ;FFix OIH
  70. Announce STUN_NEW
  71. GroupEnd
  72.  
  73.    As an example the above example would result in all 'Group J' JetMail™
  74.    Links being given the AutoFile™ Group of J, with associated flags
  75.    of OH.
  76.  
  77.    This modification *must* be made to each 'Group' link in your CONFIG.JM.
  78.  
  79.    You *must* also ensure that for every 'Link' definition there is a
  80.    complementary 'Groups' setting, and for eack AKA there is a {..} group
  81.    set. 
  82.  
  83. b) JET_FFIX.CFG
  84.  
  85.    The format of the file is simple, firstly the file/pathname to
  86.    AUTOFILE.CTL, secondly the file/pathname to your CONFIG.JM file,
  87.    finally a default FileFix password if one has not been set within the
  88.    Link Definition.
  89.  
  90.         Example JET_FFIX.CFG file:
  91.  
  92.         e:\bt\autofile.ctl
  93.         e:\jetmail\config.jm
  94.         PASSWORD
  95.  
  96. c) AUTOFILE.ORG
  97.  
  98.    The AUTOFILE.ORG file is exactly the same as your AUTOFILE.CTL file, but
  99.    without any 'Fix' statements.
  100.    
  101.    Before you run JAF for the first time you *must* create your own 
  102.    AUTOFILE.ORG file.
  103.    
  104.    This file should be exactly the same as your AUTOFILE.CTL file, but 
  105.    without any 'Fix' statements.
  106.  
  107.    It is recommended that the following procedure is followed:
  108.    
  109.    a) Copy AUTOFILE.CTL to a safe place.
  110.    b) Copy AUTOFILE.CTL to the same directory as AUTOFILE.TTP.
  111.    c) Rename this AUTOFILE.CTL to AUTOFILE.ORG.
  112.    d) Remove any 'Fix' statements from AUTOFILE.ORG.
  113.  
  114.    Setting up should now be complete.
  115.  
  116.    
  117. Running JAF.
  118. ------------
  119.  
  120.    JAF can be run virtually anywhere, but I recommend in your main BBS
  121.    directory. The main JAF progam must however be in the same directory as
  122.    the JET_FFIX.CFG file.
  123.  
  124.    Before running JAF for the first time you *must* check that all of your
  125.    'Local Group' settings within each AutoFile™ 'Area' match those that you
  126.    use in CONFIG.JM, or possible chaos could result - you have been warned!
  127.     
  128.    Once JAF has been run you will now have a new AUTOFILE.CTL (named as in
  129.    JET_FFIX.CTL), which will have AutoFile™ FileFix passwords matching 
  130.    those set for each of JetMail™'s 'Link' 'AreaFixPwd' passwords. The new
  131.    AutoFile™ 'Fix' passwords will have been assigned the group letter as
  132.    specified with the ;FFix settings. JAF will also show the SysOp's name
  133.    before each 'Fix' group. making it easy to keep track of who has what
  134.    settings. This gives a new AUTOFILE.CTL similar to:
  135.    
  136. ;
  137. ;Group A AtariNet. OIH
  138. ;
  139. ;Group B NeSTWare beta testers. OH
  140. ;
  141. ;Group Z NeST Net 100 Sysops. OH
  142. ;
  143. ;Group F Fidonet. OIH
  144. ;
  145. ;Group J Jetmail beta testers. OH
  146. ;
  147. ;Group N NeST Sysops. OIH
  148. ;
  149. ;Group T TurboNet Sysops. OH
  150. ;
  151. ;Group X NeSTWare Programmers. OIH
  152. ;
  153. ;Sysop: Sian Stephenson
  154. ;FileFix password set using 'AreaFixPwd'.
  155. Fix 90:100/102.0 PASSWORD NZ OIH
  156. ;
  157. ;Sysop: Serge Wagener
  158. ;No 'Password' or 'AreaFixPwd' defined, setting FileFix to default. 
  159. Fix 90:16/0.0 PASSWORD N OIH
  160. ;
  161. ;Sysop: Paul Williams
  162. ;FileFix password set using 'AreaFixPwd'.
  163. Fix 90:104/0.0 PASSWORD N OIH
  164. ;
  165. ;Sysop: James Partner
  166. ;FileFix password set using 'AreaFixPwd'.
  167. Fix 2:255/72.0 PASSWORD FJ OIH
  168. Fix 90:101/0.0 PASSWORD N OIH
  169. ;
  170. ;Sysop: Mark Matts
  171. ;FileFix password set using 'Password'.
  172. Fix 90:100/101.0 PASSWORD NXBZ OIH
  173. Fix 2:255/320.0 PASSWORD FJ OIH
  174. Fix 100:1051/3.0 PASSWORD T OH
  175. Fix 51:6/4.0 PASSWORD A OIH
  176. ;
  177. etc............
  178. ;
  179. ;--JAF--Jetmail AreaFixPwd --> AutoFile FileFixPwd Convertor. (C)1993 D.M.Brewood-- v00.01.01
  180. Debug
  181. Use4D
  182. Advise Hold
  183. FixName FileFix
  184. ;
  185. Address 2:255/401.0 2000
  186. Address 90:1/0.0 999
  187. Address 90:100/0.0
  188. Address 90:100/100.0
  189. Address 69:200/102.0 690
  190. etc........
  191.  
  192.    NOTE!! If an error is found JAF will 'rem' out the offending lines
  193.    with an ;ERR statement at the start of the line.
  194.  
  195.    One JAF has been run for the first time it will automatically update
  196.    AUTOFILE.ORG from the AUTOFILE.CTL file which it creates. For this to
  197.    happen you must *not* delete the JAF title line within AUTOFILE.CTL
  198.    as it acts as a data pointer, altering this could result in big
  199.    problems!!
  200.  
  201.    So there you are, now you will have a system which has FileFix
  202.    passwords exactly the same as JetMail™'s AreaFix passwords.
  203.  
  204.  
  205. Warnings.
  206. ---------
  207.  
  208.    Care has been taken to make JAF as error free as possible, but as always
  209.    all errors can not be trapped. It is therefore recommended that you
  210.    make a backup of all files before running JAF. I/We take no
  211.    responsibility for any data loss that ensues from running JAF, you take
  212.    all the risks on your own head!
  213.  
  214.  
  215. Support.
  216. --------
  217.  
  218. Support is provided through:
  219.          
  220.         a) FidoNet:
  221.          
  222.             JETMAIL_BETA echo.
  223.             
  224.             
  225.         b) NeST:
  226.          
  227.             N_NESTWARE echo.
  228.             N_NW_BETA for NeSTWare Beta testers.
  229.  
  230.         c) AtariNet:
  231.  
  232.             A_FIDO_ST echo.
  233.  
  234.         d) CIX:
  235.  
  236.            network.st.nes conference.
  237.  
  238. Please send any suggestions, bug-reports, etc, to:
  239.       
  240.         BBS:      STun, Stockport, England, +44-61-429-9803
  241.                   (V32, 14,400 HST, V42, V42bis - 24 hours a day)
  242.                   ** MAIL ONLY **
  243.              
  244.         Fido:     2:255/401@fidonet.org    (Daron Brewood)
  245.         
  246.         NeST:     90:1/0.0@nest.ftn        (Daron Brewood)
  247.                   90:90/0@nest.ftn         (Daron Brewood)
  248.                   90:100/100@nest.ftn      (Daron Brewood)
  249.  
  250.         AtariNet: 51:500/0.0@atarinet.ftn
  251.                   51:6/0.0@atarinet.ftn
  252.                   51:6/2.0@atarinet.ftn
  253.  
  254.         CIX:      dbrewood@cix.compulink.co.uk
  255.                
  256.         Post:
  257.                   Daron M. Brewood,
  258.                   7, Crescent Road,
  259.                   Portwood,
  260.                   Stockport,
  261.                   Cheshire,
  262.                   ENGLAND.
  263.                   SK1 2QG
  264.  
  265.  
  266.  #### NeSTWare ############################################################
  267.  ##                                                                      ##
  268.  ## This program is programed and released under the NeSTWare concept    ##
  269.  ## whereby it has been produced by Network ST (NeST) members for use by ##
  270.  ## themselves. The NeSTWare programmers are:                            ##
  271.  ##                                                                      ##
  272.  ##       Daron Brewood                                                  ##
  273.  ##       Mark Matts                                                     ##
  274.  ##       Phil Gadsby                                                    ##
  275.  ##       David Thomas                                                   ##
  276.  ##       Steve Caple                                                    ##
  277.  ##       Paul Simmonds                                                  ##
  278.  ##                                                                      ##
  279.  ## There is no charge for using this program, but if you wish to be     ##
  280.  ## listed as a NeSTWare user then please send a picture postcard of     ##
  281.  ## home town to:                                                        ##
  282.  ##                                                                      ##
  283.  ##                NeSTWare Registrations.                               ##
  284.  ##                c/o Daron Brewood.                                    ##
  285.  ##                7, Crescent Road,                                     ##
  286.  ##                Portwood,                                             ##
  287.  ##                Stockport,                                            ##
  288.  ##                Cheshire,                                             ##
  289.  ##                SK1 2QG.                                              ##
  290.  ##                The United Kingdom.                                   ##
  291.  ##                                                                      ##
  292.  ##########################################################################
  293.  
  294.  My thanks to Mark Matts for his assistance with the front end appearance
  295.  of the program.
  296.  
  297.  Revision History.
  298.  -----------------
  299.  
  300. 00.00.01b(24/01/93) - First version coded.
  301.  
  302. 00.00.02b(24/01/93) - Routines added to set a default password if none
  303.                       exists within the link definition, JET_FFIX.CFG
  304.                       changed to accomodate this.
  305.                     - Screen status lines now parsed properly.
  306.                     - Screen palette now reset correctly.
  307.                     - ';' lines in CONFIG.JM now ignored.
  308.                     - Support for TAB lines in CONFIG.JM added.
  309.                     - if no AKA {..} groups are set JAF now sets those
  310.                       AKA's with flags of OH.
  311.                     - Filter added for invalid 'sysop' settings.
  312.                     - Program will now exit if 'Groups' is not set within
  313.                       a Link..LinkEnd, or an AKA does not have a {.} group
  314.                       defined for it.
  315.                     - If JAF finds an Address in AUTOFILE.ORG which is
  316.                       not set within a Link/LinkEnd in CONFIG.JM the 
  317.                       address will be commented out with ';' and an
  318.                       ';ERR' line added to the output file on the line
  319.                       below.
  320.                     - After the first progam run JAF will now automatically
  321.                       update AUTOFILE.ORG each time it runs from the master
  322.                       AUTOFILE.CTL which it creates.
  323.                     - Documentation updated.
  324.  
  325. 00.00.03b(25/01/93) - Program updated so that Link/LinkEnd definitions
  326.                       without any Group settings are marked with ; and ;ERR
  327.                       statements in AUTOFILE.CTL instead of the program
  328.                       giving an error and exiting.
  329.                       
  330. 01.00.00 (27/01/93) - Finishing touches made to the program.
  331.                       Program released into the JETMAIL_BETA file echo.
  332.  
  333. 01.00.01b(21/02/93) - Support for 'RouteAKA' added.
  334.                     - Now supports new format of Group letter coding in
  335.                       JetMail 0.79b2. (CHANGE CONFIG.JM BEFORE RUNNING
  336.                       THE NEW JAF)
  337.  
  338. 02.00.00 (27/02/93) - JAF 2.0 released.
  339.  
  340.                       Daron M. Brewood.
  341.  
  342.