home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / DLDCOU1A.ZIP / DLDCOUNT.DOC < prev    next >
Text File  |  1993-10-07  |  11KB  |  225 lines
  1. ┌────────────────────────────────────────────────────────────────────────────╗
  2. │                                                                            ║
  3. │            PEGASUS DOWNLOAD COUNTER & DIRECTORY UPDATER ver 1.1a           ║
  4. │                                                                            ║
  5. │                     Copyright (c) 1993, Chris Michaels                     ║
  6. │                                                                            ║
  7. │                         Another Fine Program From:                         ║
  8. │                                                                            ║
  9. │          The PEGASUS PROJECT...the Next Generation (813) 481-5575          ║
  10. │                                                                            ║
  11. └════════════════════════════════════════════════════════════════════════════╝
  12.                   SEE HISTORY FOR CHANGES/IMPROVEMENTS
  13.  
  14.  OVERVIEW
  15.  ════════
  16.  
  17.        DLDCOUNT is a remarkable utility that will process the
  18.        information contained in PCBOARD's DOWNLOAD.TXT file and add
  19.        a line to the directory listing indicating the number of times
  20.        each file has been downloaded. This information is important for
  21.        your users to determine which files are the most popular, as well
  22.        as for you to determine which files could be deleted without
  23.        being missed.
  24.        DLDCOUNT can be run in your nightly event, thus providing the
  25.        user with daily updates on the dl status of each file.
  26.  
  27.        Briefly, DLDCOUNT reads the DOWNLOAD.TXT, creates a temporary IDX
  28.        file with the download names, then compares it to each file
  29.        listed in the directories. DLDCOUNT can be configured to update
  30.        all of the directories, or just the ones you choose. It can even
  31.        update directories with the same name in different conferences.
  32.        Once the DOWNLOAD.TXT file has been processed. DLDCOUNT will copy it
  33.        to a storage file [Configurable] then delete the DOWNLOAD.TXT so
  34.        the following time it is run, it will only be processing files
  35.        downloaded SINCE it's last run. EVERY TIME THEREAFTER, THE
  36.        DOWNLOAD.TXT FILE IS APPENDED TO THE STORAGE FILE, SO YOUR
  37.        DOWNLOAD INFORMATION IS ALWAYS RETAINED. Finally, after updating
  38.        all of the directories, DLDCOUNT will write a bulletin [path and
  39.        name configurable], indicating when it was last run, the total
  40.        number of files on the system, and how many downloads it
  41.        encountered since it's last run.
  42.  
  43.  
  44.  
  45.  SETUP
  46.  ═════
  47.         Setup is fairly simple and straightforward. Choose a directory
  48.         where you want to put the executable and the configuration file.
  49.         I have them both in my \PCB\GEN\ directory. Copy the executable
  50.         to that location, then create a configuration file following the
  51.         instructions below. You can use any name for this file, I use
  52.         DLDCOUNT.CFG.
  53.  
  54.         DLDCOUNT.CFG is a standard ascii file containing the
  55.         information DLDCOUNT will need to perform it's magic. A sample
  56.         configuration file is included in this archive, and it's
  57.         explanation follows:
  58.  
  59.          C:\PCB\MAIN\DOWNLOAD.TXT    LINE 1 - Full Path & Name of the
  60.                                               PCBOARD DOWNLOAD.TXT file
  61.  
  62.          C:\PCB\GEN\BLT9             LINE 2 - Full Path & Name of the
  63.                                               bulletin file DLDCOUNT
  64.                                               will create. There MUST be
  65.                                               an entry on this line! If
  66.                                               no bulletin is desired,
  67.                                               then leave a blank line
  68.                                               here.
  69.  
  70.          C:\PCB\MAIN\DOWNLOAD.HLD    LINE 3 - Full Path & Name of the
  71.                                               storage file DLDCOUNT will
  72.                                               append daily with the
  73.                                               DOWNLOAD.TXT information.
  74.  
  75.          C:\PCB\GEN\DIR1             LINE 4 - Full Path & Name of the
  76.          C:\PCB\GEN\DIR2             TO       directories you want
  77.          C:\PCB\GEN\DIR3             END      DLDCOUNT to process. The
  78.          C:\PCB\GAMES\DIR1                    program is currently
  79.          C:\PCB\ADULT\DIR1                    written to support any
  80.               [ETC]                           number of directories from
  81.                                               one to 2000! You can
  82.                                               choose precisely the
  83.                                               directories you want
  84.                                               processed, and the order
  85.                                               does not matter. DLDCOUNT
  86.                                               works on each individual
  87.                                               directory separately.
  88.  
  89.  
  90.  RUNNING DLDCOUNT INITIALLY THEN IN AN EVENT
  91.  ═══════════════════════════════════════════
  92.  
  93.          The initial run of DLDCOUNT is going to be a long one! Remember
  94.          DLDCOUNT must process EVERY download your system has in the
  95.          DOWNLOAD.TXT file, and compare it to EVERY file listed in your
  96.          directories. Depending on the speed of your computer and the size
  97.          of your system, this could take hours! On The PEGASUS PROJECT,
  98.          running a 386/33, the INITIAL RUN processed a DOWNLOAD.TXT
  99.          containing about 5,000 file names, and it took over 5 hours
  100.          to complete! THIS IS ONLY FOR THE FIRST TIME RUN, AND AFTER
  101.          THAT, IT TAKES ABOUT 10 TO 15 MINUTES PER NIGHT TO UPDATE
  102.          ABOUT 100 DIRECTORIES.
  103.          So, for you INITIAL RUN ONLY it is recommended that you
  104.          dedicate one window of DESQVIEW or one node to running the
  105.          program. If you run it while the board is up, it is a good idea
  106.          to copy the directory files [DIR1 ETC] to a work directory, to
  107.          avoid share errors is someone views a directory while it is
  108.          being processed. Then, after processing, simply copy the
  109.          directories back to their original location.
  110.          On smaller systems, of course, the time is much shorter, so handle
  111.          it any way you want.
  112.  
  113.          Once the initial run is completed, DLDCOUNT, which is really
  114.          incredibly fast, can update the files as part of an event. On
  115.          The PEGASUS PROJECT, it takes only about 15 minutes during our
  116.          nightly event to update all directories.
  117.          To do this, you must add an entry into your event.bat file
  118.          [remember in PCBOARD 15.0 this file has no .bat extension and is
  119.          defined in the PCBSETUP under EVENT].
  120.          The command line for DLDCOUNT is:
  121.  
  122.                            DLDCOUNT DLDCOUNT.CFG
  123.  
  124.           Where DLDCOUNT.CFG is the name of the configuration file you created
  125.           earlier.
  126.  
  127.           Add the following to your event.bat file:
  128.  
  129.           CD \PCB\GEN           <---- Change to directory containing
  130.                                       DLDCOUNT.EXE & DLDCOUNT.CFG
  131.  
  132.           DLDCOUNT DLDCOUNT.CFG <-----Execute the program
  133.  
  134.  
  135.           That's it! Now DLDCOUNT will update your directories every
  136.           night adding the number times a file has been download.
  137.  
  138.  
  139. HINTS ON SPEED [OPTIONAL]
  140. ═════════════════════════
  141.  
  142.            As previously stated, DLDCOUNT is INCREDIBLY fast, but you
  143.            can make it even run faster if you move the whole process to
  144.            a ram drive, assuming you have one and it has enough space.
  145.            To do this, change your event entries to something like this:
  146.  
  147.            I:
  148.            COPY C:\PCB\GEN\DLDCOUNT.EXE
  149.            COPY C:\PCB\GEN\DLDCOUNT.CFG
  150.            COPY C:\PCB\MAIN\DOWNLOAD.TXT
  151.            DLDCOUNT DLDCOUNT.CFG
  152.            DEL DLDCOUNT.*
  153.            C:
  154.  
  155.            You could even copy the directories it DLDCOUNT will be
  156.            working on to the ram drive and then back to their proper
  157.            location, however, if you do, remember to change the CFG file
  158.            to reflect the new location of the DIR's it will be
  159.            processing, and REMEMBER IF YOU HAVE DIFFERENT CONFERENCES
  160.            WITH THE SAME DIRECTORY NAMES, BE CAREFUL NOT TO OVERWRITE
  161.            THEM. You can avoid this with multiple configuration files.
  162.            The event file for multiple configuration files might look
  163.            like this:
  164.  
  165.            I:                                <-CHANGE TO RAM DRIVE
  166.            COPY C:\PCB\GEN\DLDCOUNT.EXE
  167.            COPY C:\PCB\GEN\DLDGEN.CFG        <-CONFIG FOR GEN  DIRs
  168.            COPY C:\PCB\GEN\DLDADULT.CFG      <-CONFIG FOR ADULT DIRs
  169.            COPY C:\PCB\GEN\DLDGAMES.CFG      <-CONFIG FOR GAMES DIRs
  170.            COPY C:\PCB\MAIN\DOWNLOAD.TXT
  171.  
  172.            COPY C:\PCB\GEN\DIR*.             <- GET GEN DIRs
  173.            DLDCOUNT DLDGEN.CFG               <- PROCESS THE GEN DIRs
  174.            COPY DIR*. C:\PCB\GEN             <- COPY UPDATED DIRs BACK
  175.            DEL DIR*.                         <- DEL DIRs FROM RAM DRIVE
  176.            COPY DOWNLOAD.HLD C:\PCB\MAIN     <- COPY THE APPENDED
  177.                                                 STORAGE FILE [NAME FROM
  178.                                                 CONFIG FILE LINE 3] TO
  179.                                                 THE STORAGE AREA. ONLY DO
  180.                                                 THIS ON RUN OF THE FIRST
  181.                                                 CONFIGURATION FILE.
  182.  
  183.            COPY C:\PCB\MAIN\DOWNLOAD.TXT     <- RE-COPY THE DOWNLOAD.TXT
  184.            COPY C:\PCB\ADULT\DIR*.           <- GET ADULT DIRs
  185.            DLDCOUNT DLDADULT.CFG             <- PROCESS ADULT DIRs
  186.            COPY DIR*. C:\PCB\ADULT           <- COPY UPDATED DIRs BACK
  187.            DEL DIR*.                         <- DEL DIRs
  188.  
  189.            COPY C:\PCB\MAIN\DOWNLOAD.TXT     <- RE-COPY THE DOWNLOAD.TXT
  190.            COPY C:\PCB\GAMES\DIR*.           <- GET GAMES DIRs
  191.            DLDCOUNT DLDGAMES.CFG             <- PROCESS GAMES DIRs
  192.            COPY DIR* C\PCB\GAMES             <- COPY UPDATED DIRs BACK
  193.            DEL DIR*.                         <- DEL DIRs
  194.  
  195.            DEL DOWNLOAD.HLD
  196.            DEL DLDCOUNT.*
  197.            C:
  198.  
  199.  
  200.  REGISTRATION
  201.  ════════════
  202.  
  203.       DLDCOUNT IS NOT FREE IT IS SHAREWARE. Although it is not crippled
  204.       in any way, if you use the program you MUST register it!
  205.  
  206.       Registration fee is $20.00. To register, mail the fee along with
  207.       your name, address, phone, bbs name, and bbs phone number to:
  208.  
  209.                          CHRIS MICHAELS
  210.                          6237 PRESIDENTIAL COURT #125
  211.                          FORT MYERS, FL 33919
  212.  
  213.        If you have any comments, suggestions etc. you can contact me at
  214.  
  215.           THE PEGASUS PROJECT...the Next GeneratioN (813) 481-5575
  216.  
  217.    DISCLAIMER
  218.    ══════════
  219.  
  220.          DLDCOUNT has been tested thoroughly, however, as with all
  221.          shareware, we cannot be held responsible for any damage or loss
  222.          resulting from this program, and will not be liable for
  223.          anything. The program is offered as is, and the user accepts
  224.          all responsibility.
  225.