home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / rnet109u.zip / RNETCONF.DOC < prev    next >
Text File  |  1993-01-26  |  12KB  |  247 lines
  1.  
  2.  
  3. ───────────────────────────────────────────────────────────────────────────────
  4.      PROCONF.EXE  --  Convert ProDoor 2.9+ CONFINFO to RNet 1.05+ RNETCONF
  5.      PCBCONF.EXE  --  Convert PCBoard 14.x CNAMES   to RNet 1.05+ RNETCONF
  6. ───────────────────────────────────────────────────────────────────────────────
  7.  
  8.                 ***  REQUIRED READING FOR RNET OPERATION!  ***
  9.  
  10.  
  11.      ProConf and PCBConf are part of the RNet EchoConference package.
  12.   ProConf (or PCBConf) is *required* for proper support of the RNet 1.05+
  13.   extended conferences.  Neither of these utilities were required for
  14.   previous versions of RNet as earlier versions did not use RNETCONF.
  15.  
  16.      Through ProConf.exe, PCBConf.exe, and the file they both produce,
  17.   RNETCONF, RNet can now support up to 32,767 conferences (32 THOUSAND
  18.   conferences!) via either a ProDoor or PCBoard system.  ProDoor 3.2
  19.   currently supports 2,040 conferences while PCBoard 14.5 supports 65,534
  20.   conferences.  If anyone needs more than 32,767, just drop me a line.
  21.  
  22.      As of version 1.07 of RNet, this conference support has been tested
  23.   on an 8,500 conference setup.
  24.  
  25.      RNETCONF is a fixed length (80 byte) file listing the conference name,
  26.   messagebase location+name, number of message NDX blocks (as CHR[x]), and
  27.   flags (also as a CHR[x]).  There is expansion space left which may be used
  28.   for "automatic" packing options for RNet to run when drive space gets close
  29.   to full.
  30.  
  31.      RNETCONF *can* be edited using a standard text editor (such as QEdit or
  32.   Edlin).  There is a "x" placed at column 78 (plus the CR and LF make 80
  33.   bytes) as a place holder.  If you edit this file make sure that the "x"
  34.   stays in column 78 or the file will be corrupted!  Also, if your text
  35.   editor does not automatically strip trailing spaces be sure to remove them
  36.   manually from following the "x".  By being able to edit this file it gives
  37.   you the ability to change messagebase locations, names, echo flags, or
  38.   even add conferences to the RNet system without any fuss or dependance on
  39.   PCBoard/ProDoor.  All the conference specific information RNet needs is
  40.   stored in this file.
  41.  
  42.      ProConf and PCBConf will overwrite any information in RNETCONF if run
  43.   with the -i switch or if the RNETCONF file is older than CONFINFO and/or
  44.   CNAMES (depending on if running ProConf or PCBConf).
  45.  
  46.      ProConf and PCBConf should not be distributed seperatly from the RNet
  47.   package as they are not of much use without it.  Though, if you like
  48.   writing automated QEdit macros like I do, you can use the RNETCONF file to
  49.   produce PACKALL.BAT files and other useful things.
  50.  
  51.  
  52.  
  53.  
  54.  
  55. PROCONF.EXE   Support for ProDoor 2.9+ CONFINFO       [for use with RNet 1.05+]
  56. ───────────────────────────────────────────────────────────────────────────────
  57.  
  58.      ProConf is designed to read a ProDoor 2.9 CONFINFO file and produce the
  59.   needed RNETCONF file for RNet to use.  It will automatically check the
  60.   time/date on your CONFINFO file to determine if it needs to run.  Unless
  61.   you have specifically edited your RNETCONF file, you can safely call
  62.   ProConf during your mail event, usually just before calling RNet.exe.
  63.  
  64.      There are two valid commandline sequences available:
  65.  
  66.   │  d:\dir\PROCONF.exe d:\doors\prodoor\CONFINFO d:\rnet\RNETCONF [-i]
  67.   │
  68.   │  Please note that the complete name (path+name) is required for
  69.   │  CONFINFO.  If you specify anything for RNETCONF, it must be the
  70.   │  complete name (path+file).  If do not specify the RNETCONF file,
  71.   │  ProConf will be create RNETCONF in the current directory.
  72.  
  73.   │  d:\dir\PROCONF.exe %confinfo% d:\rnet\RNETCONF [-i]
  74.   │
  75.   │  The "%" character (or any word which starts with the "%" character,
  76.   │  such as "%confinfo%") tells ProConf to get the name and location of
  77.   │  your CONFINFO from the "CONFINFO=" environment variable.  If you
  78.   │  specify RNETCONF, you must include the entire path and filename.  If
  79.   │  you do not specify RNETCONF, it will be written to the current drive
  80.   │  and directory as RNETCONF.
  81.  
  82.      ProConf accepts the -i (or /i) commandline switch, which you may
  83.   specify anywhere on the commandline.  The -i switch tells ProConf to
  84.   ignore the time/date stamps on your CONFINFO and RNETCONF files and
  85.   *always* execute.  Think of -i as "ignore time/date".
  86.  
  87.      If you specify -i, or if ProConf determines it needs to run based on
  88.   the time/date stamps, you will be displayed a fancy screen showing the
  89.   status and operation (which will not last long). When ProConf is done, it
  90.   will restore your screen and exit.
  91.  
  92.      You may use -m (monochrome), -b (bios), and -c (cga snow) switches to
  93.   modify ProConf's screen operations.  ProConf *should* detect most every
  94.   type of display, but these switches are provided for you if it does not.
  95.   ProConf does, of course, support 25, 30, 43, 50, 60, and 66 line screens -
  96.   the more lines you have, the more information you can see.
  97.  
  98.      If ProConf encounters any problems or errors, it will display an error
  99.   message, the errorlevel, and any other information it thinks might help.
  100.  
  101.  
  102.  
  103.  
  104.  
  105. PCBCONF.EXE   Support for PCBoard 14.x CNAMES         [for use with RNet 1.05+]
  106. ───────────────────────────────────────────────────────────────────────────────
  107.  
  108.      PCBConf is designed to read a PCBoard 14.x CNAMES file and produce the
  109.   needed RNETCONF file for RNet.  As with ProConf, PCBConf automatically
  110.   checks the time/date on your RNETCONF and CNAMES files to determine if it
  111.   needs to run.  Unless you have specifically edited your RNETCONF file, you
  112.   can safely call PCBConf during your mail event, usually just before
  113.   calling RNet.exe.
  114.  
  115.      Commandline sequence:
  116.  
  117.   │  d:\dir\PCBCONF.exe d:\pcb\main\CNAMES d:\rnet\RNETCONF [-i]
  118.   │
  119.   │  Please note that the complete name (path+name) is required for CNAMES.
  120.   │  If you specify anything for RNETCONF, it must be the complete name
  121.   │  (path+filename).  If do not specify the RNETCONF file, PCBConf will be
  122.   │  create RNETCONF in the current directory.
  123.  
  124.      The -i (or /i) commandline switch tells PCBConf to ignore the time/date
  125.   stamps on your CNAMES and RNETCONF files and thus *always* execute.  Think
  126.   of -i as "ignore time/date".
  127.  
  128.      If you specify -i, or if PCBConf determines it needs to run based on
  129.   the time/date stamps, you will be displayed a fancy screen showing the
  130.   status and operation.  When PCBConf has completed its task it will restore
  131.   your screen and exit.
  132.  
  133.      You may use -m (monochrome), -b (bios), and -c (cga snow) switches to
  134.   modify PCBConf's screen operations.  PCBConf *should* detect most every
  135.   type of display, but these switches are provided for you if it does not.
  136.   PCBConf supports 25, 30, 43, 50, 60, and 66 line screens - the more lines,
  137.   the more information you will be able to see at once.
  138.  
  139.      If ProConf encounters any problems or errors, it will display an error
  140.   message, the errorlevel, and any other information it thinks might help.
  141.  
  142.      As long as Clark Development simply extends the CNAMES file in the
  143.   upcoming PCBoard 14.5, you should be able to use PCBConf to support all of
  144.   the 'extended' (above 39) conferences seamlessly.
  145.  
  146.  
  147.  
  148.  
  149.  
  150. PROCONF/PCBCONF Installation and Operation            [for use with RNet 1.05+]
  151. ───────────────────────────────────────────────────────────────────────────────
  152.  
  153.      The first thing you need to do is pick which (ProConf or PCBConf)
  154.   utility you will be using.  If you currently have a ProDoor system
  155.   installed which supports CONFINFO, I recommend that.  Because CONFINFO is
  156.   a fixed length file it is much more difficult for ProConf to get "out of
  157.   alignment" compared to the ASCII free-form text format of CNAMES.  Place
  158.   the selected utility (or both) in your RNet directory.
  159.  
  160.      Run the selected utility to verify its operation.  If you are using
  161.   ProConf, specify the name+location of your CONFINFO file and name+location
  162.   of the RNETCONF file to create.  If you are using PCBConf, specify the
  163.   name+location of your CNAMES file then the name+location of the RNETCONF
  164.   file to create.
  165.  
  166.      RNet *MUST* find a RNETCONF file in the current directory, or a file
  167.   pointed to by RNETCONF= environment variable, for it to operate.  I
  168.   recommend simply placing 'RNETCONF' in the directory you normally run RNet
  169.   from and avoid using the precious environment space.  The environment
  170.   support is added for ease of "multiple-pass" execution of RNet or if
  171.   running a multi-node system with inconsistent drives/paths between nodes.
  172.  
  173.      After successful execution of ProConf/PCBConf, 'TYPE' the resulting
  174.   file or load it into a text processor (such as QEdit or Edlin).  You
  175.   should be able to easily determine if something is wrong by the 'columns'
  176.   not lining up or things looking real strange.  Ignore the "smilies" or
  177.   other characters see about column 43-45 as they are bit-flags -- DON'T
  178.   change, move, or delete them!
  179.  
  180.      The following is optional.  NOTE: If you do not implement this, you
  181.   will have to manually run ProConf/PCBConf to update RNETCONF to reflect
  182.   any changes you make to CONFINFO or CNAMES!  I suggest using the
  183.   following:
  184.  
  185.         In your MAILRUN.BAT (or whatever batch file you use to automate
  186.      your RNet operations), add a ProConf or PCBConf line just before
  187.      calling RNet. Specify everything that ProConf/PCBConf needs to
  188.      properly read CONFINFO or CNAMES and write RNETCONF where it needs
  189.      to go.  Both utilities will automatically check the time/date on
  190.      their respective files to determine if they need to update
  191.      RNETCONF.  You can 'force' either of these utilities to operate by
  192.      using the -i switch.  If you need to set any of the display control
  193.      switches, don't forget them.
  194.  
  195.      You may add a line such as "RUN=PROCONF %CONFINFO% D:\RNET\RNETCONF" to
  196.      your HOST.CFG file.  This will instruct RNET to automatically shell and
  197.      run PROCONF (or anything else) when it is setting up.
  198.  
  199.      Simply type RNET with no commandline and verify that RNet can find your
  200.   RNETCONF file.  RNet will display a warning and abort if it cannot find
  201.   RNETCONF.
  202.  
  203.      Make a manual mailrun (at least RNET EXPORT BBS_ID) to verify that RNet
  204.   is operating correctly.  You may delete your BBS_ID.REP packet when done
  205.   and simply 'COPY BBS_ID.SAV BBS_ID.PTR' to restore your pointers.
  206.  
  207.      If you have any problems please drop me a note on Faster-Than-Light,
  208.   404-292-8761/299-3930 [USR1440];  The Right Place 404-476-2607 [USR1440];
  209.   ILink Sysops, Offline, MM-RNet; or RIME Sysops conferences.
  210.  
  211.  
  212.  
  213.  
  214. ───────────────────────────────────────────────────────────────────────────────
  215.   Version change notes for PROCONF and PCBCONF  (latest changes are on top)
  216.  
  217. (both)
  218. ------- -----------------------------------------------------------------------
  219.  1.00c  Tue  06-26-1990
  220.  
  221.         Changed both utilities to check the filename length for the message-
  222.         base.  Since ???SM may create a base filename with over 8 characters
  223.         and RNET would find this in error, this is forced.  An example of a
  224.         bad filename would be "ECHOTESTING" (11 characters) which will be
  225.         corrected into "ECHOTEST" (8 characters, the actual DOS limitation).
  226.  
  227. PROCONF
  228. ------- -----------------------------------------------------------------------
  229.  1.00b  Mon  04-02-1990
  230.  
  231.         Corrected bug which read the wrong field for "Make All Messages R/O"
  232.  
  233.         Corrected a bug which resulted in ProConf not reading the last
  234.         conference from CONFINFO.
  235.  
  236. PCBCONF
  237. ------- -----------------------------------------------------------------------
  238.  1.00b  Mon  04-02-1990
  239.  
  240.         Added alignment checking by checking the DLPATH.LST file for each
  241.         conference.  PCBCONF will abort with ERRORLEVEL==6 if it gets out of
  242.         alignment or if DLPATH.LST does not exist for any given conference.
  243.  
  244.         Corrected PCBCONF to properly read PCBoard version 14.5 CNAMES.
  245.  
  246.  
  247.