home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / S / SCUMN10.ZIP / NUKER.DOC < prev    next >
Text File  |  1994-06-13  |  12KB  |  213 lines
  1.  
  2.  
  3.                   MiNDFRYeR / Liquidater  SCuM Productions '94
  4.  
  5.      SCuM-NuKeR is developed exclusively for PCBoard v15.1 and was compiled
  6.      using PPLC v2.o. It has been extensively beta tested on multiple systems
  7.      and is bug-free as far as the authors know. However, your decision to
  8.      use this utility is your own.
  9.  
  10.    ┌────────────────────────────────────────────────────────────────────────┐
  11.    │                          -=/\ Features /\=-                            │
  12.    └────────────────────────────────────────────────────────────────────────┘
  13.  
  14.         ■ Very easy to use, simple menu-driven user interface
  15.         ■ Ability to nuke multible files in a single session
  16.         ■ Access controlled by SysOp-Controlled security Levels
  17.         ■ Online help available to first time users
  18.         ■ Multi-Node aware and full Multi-Node usage supported
  19.         ■ Supports SCuM's File Point System for PCBoard
  20.         ■ Supports Multi-times (0-5) nuking for abusive uploaders
  21.         ■ Adjust uploaders: files uploaded, bytes uploaded, and file points
  22.         ■ Can optionally return credits to all downloaders of the nuked file(s)
  23.         ■ Message sent to uploader to inform of the nuking
  24.         ■ User selectable 'reason' for nuking, or enter your own!
  25.         ■ Sysop configurable prompts and main menu (colors and text)
  26.         ■ Nuked message added to first line in DIR file not last!
  27.         ■ "Nuked by :" line added to PCBoard DIR file
  28.         ■ Uses simple 'flagging' system to create nuke batches
  29.         ■ Batch editing (of files to be nuked)
  30.         ■ Simple plug and play installation (no degree in PCB required)
  31.         ■ Complete detailed log creation of nuker activity
  32.         ■ Online viewing/deletion of the nuker log
  33.         ■ Automatic backup creation of PCB DIR file for safety
  34.         ■ Full support for multible filebases in different conferences
  35.         ■ Freeware - No lame "Free registration" hassles
  36.         ■ No shareware nags or unneeded delays added
  37.  
  38.    ┌────────────────────────────────────────────────────────────────────────┐
  39.    │                       -=/\ INSTALLATION /\=-                           │
  40.    └────────────────────────────────────────────────────────────────────────┘
  41.  
  42.        Unzip this package into any subdirectory on your system, a seperate
  43.      subdirectory is not nessecary, but is recommended. Load up PCBSETUP
  44.      and select 'B' for "File Locations", and 'B' again for "Configuration
  45.      Files", the 8th selection down is your CMD.LST file, with this selection
  46.      highlighted, press F2 to edit the file. Then press ALT-I to insert a
  47.      new line. Edit that line like shown below:
  48.           
  49.       COMMAND     SECURITY      PPE/MNU file -or- Keystroke Replacement
  50.     ┌──────────┬────────────┬───────────────────────────────────────────┐
  51.     │  NUKER   │     15     │   C:\PCB\PPL\NUKER\NUKER.PPE              │
  52.     └────┼─────┴─────┼──────┴───┼───────────────────────────────────────┘
  53.          │           │          │
  54.          │           │          └- DRIVE:\PATH_WHERE_U_INSTALLED_IT\NUKER.PPE
  55.          │           └- Minimum security to run the nuker online
  56.          └- Word to be typed at main menu by user to run the nuker.ppe
  57.  
  58.        There is ONE command line option for NUKER.PPE, but it only effects
  59.      sysops that ARE running the SCuM File Point System, see below for details.
  60.  
  61.        The SCuM-NuKeR requires the use of FLAG.PPE, but since it's run on most
  62.      every ELITE system I have ever been on, this should not be a problem. BUT
  63.      if you don't run the FLAG.PPE, then you have just wasted a half hour of
  64.      life reading this shit.
  65.  
  66.        A simple modification to FLAG.PPE has been made to support the NUKER.
  67.      To complete the installation, you must copy OUR version of FLAG.PPE to
  68.      where ever you have the FLAG system installed. The NUKER release zip,
  69.      included more then one version of the FLAG.PPE, to make sure you use
  70.      the correct one, see below for additional information.
  71.  
  72.        The following files MUST be in the smae subdirectory as NUKER.PPE:
  73.      NUKER.MNU    : The main menu
  74.      UPBYTES.EXE  : Shelled to from nuker.ppe, mods the user records
  75.      NUKER.CFG    : Contains the prompts and 'reason' messages, see below.
  76.      NUKER.HLP    : Online help file, displayed on request from NUKER.PPE
  77.      TRYAGAIN.EXE : Used in case a shareing violation prevents DIR replacement
  78.  
  79.    ┌────────────────────────────────────────────────────────────────────────┐
  80.    │                        -=/\ CUSTOMIZATION /=-                          │
  81.    └────────────────────────────────────────────────────────────────────────┘
  82.  
  83.        NUKER.CFG file contains all the prompts strings displayed by NUKER
  84.      to the online users, you can edit the text and color codes to your
  85.      liking, BUT you may NOT delete any lines or rearrange them in anyway.
  86.      For best results, use PCBEDIT to modify this file, however run the PPE
  87.      for a few days, before making changes, that way the prompts will be more
  88.      meaningfull to you when you edit/colorize.
  89.  
  90.        This file also contains the "reasons" for nuking that your users can
  91.      select from when nuking a file. You can add/delete/colorize these at
  92.      will, but be sure the FIRST line of the .CFG file contains the correct
  93.      number of reason lines. (this version supports up to 20 reason lines)
  94.  
  95.        One last note, no blank lines in this file...don't get creative! :)
  96.  
  97.    ┌────────────────────────────────────────────────────────────────────────┐
  98.    │                      -=/\ FILE POINT SUPPORT /\=-                      │
  99.    └────────────────────────────────────────────────────────────────────────┘
  100.  
  101.        This NUKER offers full support for systems running the FILE POINT
  102.      SYSTEM for PCB, also released by SCuM. To activate this support, you
  103.      simply add a command line parameter to the NUKER.PPE in your CMD.LST
  104.      of the complete drive:\path to your FPS installation. I.E.:
  105.  
  106.           C:\PCB\PPL\NUKER\NUKER.PPE C:\FP-PPE\
  107.  
  108.        Thats IT! Just be sure you include the trailing backslash as in the
  109.      example above. If the NUKER can find your PCBFPS.CFG file, each time
  110.      you (or your users) nuke a file, in addition to all the normal functions
  111.      NUKER will also remove the file points given to the uploader for this
  112.      file, also any file points spent by downloaders will be returned to the
  113.      downloaders should the 'search for downloaders' option be selected.
  114.      If you are using the commission part of FPS, those points will be taken
  115.      from the uploader as well.
  116.  
  117.    ┌────────────────────────────────────────────────────────────────────────┐
  118.    │                      -=/\ FLAG PPE SELECTION /\=-                      │
  119.    └────────────────────────────────────────────────────────────────────────┘
  120.  
  121.        The release zip contains two compiled FLAG.PPE's, plus a FLAG.PPS.
  122.      NUKER needs one of these files to operate properly. Which ever one you
  123.      use, you MUST copy it into the proper subdirectory where you have FLAG
  124.      installed with the FLAG.CFG file, which also needs editing, see inside.
  125.  
  126.      FLAG.PPE    : This is the out of the box version, with the needed
  127.            modifications made and can be dropped in as-is.
  128.      PWAFLAG.PPE : This is a version that also contains the PWA mods for
  129.            systems that are using the PWAFV system. Both thier
  130.                    and our mods are compiled into this version. RENAME!
  131.      FLAG.PPS    : This is the source code for the first one above. It has
  132.            been included for those of you that needed something
  133.            more complicated then those listed above. Our mods are
  134.            clearly highlighted so you can block copy them into
  135.            whatever creative version you may be running.
  136.            Does it need to be said? Compile your changes!
  137.  
  138.       Don't forget to copy flagbar. to your flag subdir, or edit your own
  139.       to add the N to Nuke option to the prompt.
  140.  
  141.    ┌────────────────────────────────────────────────────────────────────────┐
  142.    │                       -=/\ GENERAL COMMENTS /\=-                       │
  143.    └────────────────────────────────────────────────────────────────────────┘
  144.  
  145.        Hopefully, you can see that you are in control of how quickly the
  146.      NUKER can do its thing, by controlling the size of two main files.
  147.      DOWNLOAD.TXT and your new upload dir file.
  148.        Do yourself and your users a favor and clean up your upload dir, to
  149.      include no more then the last month of uploads, even this can be a large
  150.      then needed file since most files see 95% of their downloading in the
  151.      first week of thier existance.
  152.        And if your board is busy, you most likely move files offline after a
  153.      while, like I keep the current +2 months online, older then that are taken
  154.      offline, as such I clean up my DOWNLOAD.TXT file to remove the records
  155.      from months no longer online.
  156.        By keeping these file sizes reasonable, the nuker can perform at its
  157.      best speed. Its well worth the effort it takes.
  158.  
  159.        In the event a sharing violation occurs when SCuM-NuKeR attempts to
  160.      replace the PCB DIR file (another node is holding it open). SCuM-Nuker
  161.      will prompt you with a three selection menu, as for what action you
  162.      want to take. 1) is to try again.. if this attempt fails, you will be
  163.      returned to this menu. 2) to blow it off, the files will still be nuked
  164.      the credits/file points removed, and the message sent to the uploader,
  165.      but your NUKE REASON comments will be lost... and 3) is to try again
  166.      later in the form of a additon (or creation) to your $$LOGOFF.BAT file.
  167.        If the user selects this, SCuM-NuKeR will back up your orginal batch
  168.      file, and append two lines that will run after the current user logs off.
  169.      At that time, the replacement will be tried again, but only if additional
  170.      files have not been added (new uploads). The Nuker will then automatically
  171.      'clean up' after itself and restore your orginal $$LOGOFF.BAT (if any).
  172.  
  173.    ┌────────────────────────────────────────────────────────────────────────┐
  174.    │                       -=/\ SUPPORT & UPDATES /\=-                      │
  175.    └────────────────────────────────────────────────────────────────────────┘
  176.  
  177.        SCuM Productions '94 is dedicated to bringing you quality utilitys
  178.      for ELITE PCB setups. If you discover a bug, no matter how small, you
  179.      should logon to TRADERS OUTPOST, our WHQ, and leave word to the sysop
  180.      of what you have found. This is also the best way to give suggestions
  181.      for future versions, or additional utilitys you would like to see.
  182.  
  183.    ┌────────────────────────────────────────────────────────────────────────┐
  184.    │                       -=/\ SCuM PPE DIVISION /\=-                      │
  185.    └────────────────────────────────────────────────────────────────────────┘
  186.  
  187.        Do you program quality PCBoard PPEs or EXE Utilities? If so, you
  188.      should talk to any of the SCuM Members you will find on most the better
  189.      systems! Or call our World HQ directly and leave word for MiNDFRYeR
  190.      about joining SCuM's PPE/PCB Division.
  191.  
  192.        To join you must be willing to upload your source code to MiNDFRYeR
  193.      for review to assure that no SCuM Release will ever contain any lame
  194.      'backdoors' or 'extra features' like some groups releases.
  195.  
  196.  
  197.                                           Mindfryer / Liquidater
  198.                        SCuM Productions '94
  199.                                               Traders Outpost
  200.                                           (2o1) 4o2-5o81 3-Nodes
  201.  
  202.    ┌────────────────────────────────────────────────────────────────────────┐
  203.    │                        -=/\ Special Thanks! /\=-                       │
  204.    └────────────────────────────────────────────────────────────────────────┘
  205.  
  206.           We want to thank Osiris for creating UPBYTES.EXE, which is a
  207.         util used to modify the uploader/downloader record fields that
  208.         ppl does not yet support.
  209.  
  210.           And thanks to all the beta testers on Traders Outpost and the
  211.         other sites that helped us make this release as bug free as it is.
  212.  
  213.