home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / UNCONX74.ZIP / UNCONX.DOC < prev   
Encoding:
Text File  |  1993-09-13  |  6.3 KB  |  189 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.      
  11.      
  12.      
  13.      
  14.                                    UNCONX
  15.  
  16.                       OPUS FILES DATABASE UNCONVERTER
  17.      
  18.                              12 SEPTEMBER 1993
  19.      
  20.                     Copyright 1993, Trevor B. Roydhouse 
  21.      
  22.                             ALL RIGHTS RESERVED
  23.  
  24.  
  25.  
  26.      
  27.  
  28.                 Sentry BBS (FidoNet 3:711/401 - PEP and V32)
  29.            Australia (02) 428-4687 - International +61-2-428-4687     
  30.  
  31.  
  32.               Sentry's Shadow BBS (FidoNet 3:711/501 - V32bis)
  33.            Australia (02) 418-6682 - International +61-2-418-6682         
  34.      
  35.      
  36.  
  37.  
  38.      
  39.                              TABLE OF CONTENTS
  40.      
  41.          Introduction ......................................... 1
  42.          Requirements ......................................... 1
  43.          UNCONX usage and syntax .............................. 1
  44.          Revision history ..................................... 2
  45.          Bugs/Mites/Suggestions ............................... 2
  46.          Disclaimer of liability .............................. 3
  47.          License .............................................. 3
  48.          Latest version ....................................... 3
  49.  
  50.  
  51.  
  52.  
  53.      INTRODUCTION                                                    1
  54.      
  55.      
  56.      UNCONX (Opus Files Database UNCONverter) was designed to be used 
  57.      with the files database of an Opus 1.73a system. Due to a chnage 
  58.      in the files database for Opus versions after 1.73a, it should 
  59.      not be used with any subsequent Opus release. A special version 
  60.      for the Opus v1.79.x beta release is available on application to 
  61.      me.
  62.  
  63.      UNCON was originally written by Doug Boone to UNCONvert the Opus 
  64.      files database and produce the "old" FILES.BBS files. It was for 
  65.      this reason that the FILES.BBS files produced by Doug's UNCON do 
  66.      not include the new information (ie alternate path, download 
  67.      counter, uploader's name).      
  68.  
  69.      Thanks to Doug making the source to UNCON available to me, I made 
  70.      some fairly trivial changes to the code to create UNCONX which 
  71.      produces "new" FILES.BBS files which include the new information 
  72.      (ie alternate path, download counter, uploader's name) stored in 
  73.      the Opus files database. UNCONX is therefore an eXtended version 
  74.      of UNCON -> UNCONX!
  75.      
  76.      
  77.      
  78.      REQUIREMENTS
  79.      
  80.      
  81.      UNCONX requires an PC/MS-DOS or OS/2 based computer, a monochrome 
  82.      or colour monitor, and a minimum of 80K RAM available to run the 
  83.      program. 
  84.      
  85.  
  86.      
  87.      UNCONX USAGE AND SYNTAX
  88.      
  89.  
  90.      UNCONX will create a FILES.BBS that matches the contents of 
  91.      FILESBBS.DAT in each file area. If a FILES.BBS already exists in 
  92.      a particular file area, then it will be renamed to FILES.BAK. 
  93.      
  94.  
  95.      UNCONX must be run from the directory where you keep your Opus 
  96.      files database files (ie FILESBBS.ADX and FILESBBS.DAT). UNCONX 
  97.      itself does not have to be located in that directory, provided it 
  98.      is on your DOS path.
  99.      
  100.      With no parameters UNCONX works on all areas. Otherwise you can 
  101.      list the areas in which to create a FILES.BBS. For example:
  102.  
  103.      UNCONX 1 2 3 4  Creates a FILES.BBS in file areas 1, 2, 3 and 4.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.      UNCONX USAGE AND SYNTAX (continued)                             2
  110.  
  111.  
  112.      UNCONX 1        Creates a FILES.BBS in just file area 1.
  113.      UNCONX          Creates a FILES.BBS in all file areas.
  114.      
  115.      UNCONX will create FILES.BBS which include alternative download 
  116.      paths, downloader counts and the names of uploaders.
  117.  
  118.      A sample FILES.BBS line format is given below:
  119.  
  120.      x:\058a\12345678.123  [ 34]  File description Upld by Trev Roydhouse
  121.  
  122.  
  123.      
  124.      REVISION HISTORY
  125.  
  126.      V1.00  -- 11 April 1993
  127.             -- added alternate download path, download counter and 
  128.                uploader's name to FILES.BBS entries.
  129.           
  130.      V1.01  -- 29 April 1993
  131.             -- fixed failure to free altpath and uploader pointers
  132.                which would result in out of memory error in some 
  133.                circumstances.
  134.  
  135.      V1.02  -- 12 September 1993
  136.             -- moved download count from end of line to just after 
  137.                filename so that CONFILE will include download count
  138.                info when recreating the files database from the 
  139.                individual FILES.BBS files.
  140.      
  141.         
  142.      
  143.      BUGS/MITES/SUGGESTIONS
  144.  
  145.      UNCONX has been extensively tested on the Sentry BBS and Sentry's 
  146.      Shadow BBS with no apparent ill effects. Should you discover what 
  147.      you suspect is a bug, or even just a mite, or have any 
  148.      suggestions for the program feel free to: 
  149.      
  150.      a) send a netmail message to me at the Sentry BBS or Sentry's
  151.         Shadow BBS  (FidoNet Addresses: 3:711/401 and 3:711/501);
  152.  
  153.      b) call the Sentry BBS on (02) 428-4687 (PEP & V32 modem) or 
  154.         Sentry's Shadow BBS (02) 418-6682 (V32bis modem) and leave me 
  155.         a message; 
  156.  
  157.      c) write to me at P.O. Box 1605, Macquarie Centre,
  158.                        New South Wales 2113, Australia.
  159.      
  160.  
  161.  
  162.      DISCLAIMER OF LIABILITY                                         3
  163.      
  164.      The author expressly disclaims any and all liability to any 
  165.      person in respect of anything, and of the consequences of 
  166.      anything, done or omitted to be done by UNCONX.COM. Be warned: 
  167.      Slippery when wet! 
  168.      
  169.  
  170.  
  171.      LICENSE                                                         
  172.      
  173.      All Sysops are hereby authorised to use and/or distribute 
  174.      UNCONX.COM provided only that (1) no money is charged for either 
  175.      its use or distribution and (2) it is distributed together with 
  176.      this document file. 
  177.  
  178.      
  179.  
  180.      LATEST VERSION                                                  
  181.      
  182.      The latest version of UNCONX may always be Wazoo or Bark File 
  183.      Requested from Sentry (3:711/401 - PEP & V32 modem) or Sentry's 
  184.      Shadow (3:711/501 - V32bis modem) outside of the Zone 1 mail hour 
  185.      and the Zone 3 mail hour (plus and minus 1.5 hours), or 
  186.      downloaded by first time callers from Sentry or Sentry's Shadow. 
  187.      File requests for the magic filename UNCONX will always result in 
  188.      your obtaining the latest version. 
  189.