home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / JAMPACK5.ZIP / JAMPACK.DOC < prev    next >
Text File  |  1994-12-04  |  13KB  |  257 lines
  1. JAMPACK.EXE - JAM Message Base packer for T.A.G. 2.7b
  2. (c) Copyright 1994 by Mark McKay,
  3.     The Skeleton Closet BBS (Mark & Debbi McKay sysops),
  4.     1:275/138,139,140 (804-671-8547,804-499-5150,804-473-2217)
  5.  
  6. ┌─────────────────────────────────────────────────────────────────────────────┐
  7. │▓▓▓▓▓ Disclaimer/Legal Stuff ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  8. └─────────────────────────────────────────────────────────────────────────────┘
  9.  
  10.   Although this program has been tested, this software has no warranty,
  11.   either expressed or implied.  The use of this software is at the user's own
  12.   risk.  Mark McKay shall in no way be responsible for any special, incidental,
  13.   consequential or other damages resulting from the use and/or misuse of this
  14.   software.  Every effort has been made to test this software and its
  15.   documentation for possible errors, but no guarantee to that effect is made.
  16.  
  17.   This program must be distributed AS IS in it's original archive.  This
  18.   program may not be distributed as part of any other software package without
  19.   the expressed written consent of the author, Mark McKay.  It may not be
  20.   altered or reverse engineered in any way, shape or manner.
  21.  
  22.   The usual I don't promise it will do anything and if it messes up/you mess
  23.   it up, you own the pieces.  If you use it, you alone are liable for the
  24.   results.
  25.  
  26.   There are no promises either expressed or implied of updates to this
  27.   program.
  28.  
  29.      JAM(mbp) - Copyright 1993 Joaquim Homrighausen, Andrew Milner,
  30.                                Mats Birch, Mats Wallin.
  31.                                ALL RIGHTS RESERVED.
  32.  
  33. ┌─────────────────────────────────────────────────────────────────────────────┐
  34. │▓▓▓▓▓ Why even have JAMPACK? ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  35. └─────────────────────────────────────────────────────────────────────────────┘
  36.  
  37.   Because as of November 19, 1994 there are no real working JAM message base
  38.   packers for any BBS that I can find.  MBButil and RemoteAccess's RAMSG
  39.   programs claim to work, but don't do as advertised on my system anyway.
  40.  
  41.   Also you only have to run JAMPACK once, not with a PURGE then PACK
  42.   parameter.
  43.  
  44. ┌─────────────────────────────────────────────────────────────────────────────┐
  45. │▓▓▓▓▓ Quick Notes ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  46. └─────────────────────────────────────────────────────────────────────────────┘
  47.  
  48.   1.  JAMPACK has no prompts and is intended to be run from a batch file
  49.       unattended.  I made it colorful because I can't stand plain dull
  50.       grey and subconsciously you think the program runs better if it
  51.       looks slicker.
  52.  
  53.   2.  JAMPACK creates JAMPACK.LOG to tell you what it did.  Keep an eye on
  54.       the size of this file.  It gets big quickly.
  55.  
  56. ┌─────────────────────────────────────────────────────────────────────────────┐
  57. │▓▓▓▓▓ Setup  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  58. └─────────────────────────────────────────────────────────────────────────────┘
  59.  
  60.   These docs are really short, but hopefully not that complex.  This program
  61.   is intended to be simple to setup.  All you do is the following:
  62.  
  63.   1. Unzip JAMPACK4.ZIP into your DATAFILES DIRECTORY, the directory where
  64.      your MBOARDS.DAT is located.
  65.  
  66.   2. Copy MBOARDS.DAT to MBOARDS.BAK. (If you don't JAMPACK will for you).
  67.  
  68.   3. Run MBEDIT.EXE and edit the number of days per area and Max messages
  69.      to keep in each area.
  70.  
  71.   4. JAMPACK must be run with either
  72.  
  73.      a.  the -D commandline parameter for packing by age of messages
  74.  
  75.      or
  76.  
  77.      b.  the -M commandline parameter for packing by number of messages.
  78.  
  79.      If you are more concerned with speed than space on your system run
  80.      JAMPACK in -M mode.  If has lots less checking to do than when in
  81.      -D mode.
  82.  
  83.      Examples:
  84.  
  85.      1. Number of Days
  86.  
  87.      JAMPACK -D
  88.  
  89.      This example will kill all messages not received in the number of days
  90.      configured for each area in the MBOARDS.BAK you choose when you ran
  91.      MBEDIT.
  92.  
  93.      2. Number of Messages
  94.  
  95.      JAMPACK -M
  96.  
  97.      This example will pack the area if there are more messages in it than
  98.      the number you have configured for each area in the MBOARDS.BAK you
  99.      choose when you ran MBEDIT.
  100.  
  101. ┌─────────────────────────────────────────────────────────────────────────────┐
  102. │▓▓▓▓▓ What does this thing do? ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  103. └─────────────────────────────────────────────────────────────────────────────┘
  104.  
  105.   JAMPACK is a JAM message base packer written exclusively for T.A.G. BBS
  106.   sysops.  It does the following:
  107.  
  108.   1. Looks for your MBOARDS.BAK in the same directory as JAMPACK.EXE.
  109.   2. It opens MBOARDS.BAK and reads it area by area.
  110.   3. If the area is a JAM style base it does the following.
  111.      a. Checks the temporary directory it will make and kills any preexisting
  112.         JAM files. (we don't want to add to an existing one, it defeats the
  113.         whole purpose of JAMPACK).
  114.      b. It checks for enough free space to make a new base (the size of
  115.         the current area JAM files + 20K).
  116.      c. If there is enough space free, JAMPACK creates a temporary directory
  117.         off of the jam directory for the current area named JAMPCK.  If there
  118.         is not enough disk space for THAT area or there are no JAM files
  119.         JAMPACK skips the area.  If you are short on diskspace larger areas
  120.         may be skipped but smaller ones packed.
  121.      d. By popular demand, if you use -M mode, JAMPACK now counts the messages
  122.         in the JAM base.  If this number is greater than the MaxMsgs for the
  123.         area in MBOARDS.BAK then the starting point is calculated as the high
  124.         message number minus the MaxMsgs in the MBOARDS.BAK.  If for
  125.         some reason this number is less than one or one then the area will
  126.         be skipped.  Then JAMPACK reads the JAM messages one by one, (from the
  127.         start point calculated above) and if the message isn't marked as
  128.         deleted then it is rewritten to the JAM Base in the new directory.
  129.         Lastread pointers are updated as necessary.  If you have deleted
  130.         messages you will end up with less than the maximum number.
  131.      e. If you ran JAMPACK in -D mode, then JAMPACK reads the JAM messages one
  132.         by one.  If the message date is newer or equal to (the date the message
  133.         was received) the number of days specified in the MBOARDS.BAK and not
  134.         marked as deleted then it is rewritten to the JAM Base in the new
  135.         directory.  Lastread pointers are updated as necessary.
  136.      d. Once the area is done the original JAM files are deleted and the
  137.         new JAM files are renamed to the same as the old. (It's faster
  138.         than copying then deleting them and they're on the same drive
  139.         anyway.)
  140.   4. The process is continued until the end of your MBOARDS.BAK is
  141.      reached.
  142.  
  143. ┌─────────────────────────────────────────────────────────────────────────────┐
  144. │▓▓▓▓▓ Command Line Parameters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  145. └─────────────────────────────────────────────────────────────────────────────┘
  146.  
  147.   There's one and it's required: Which mode to run JAMPACK in, -D or -M.
  148.  
  149. ┌─────────────────────────────────────────────────────────────────────────────┐
  150. │▓▓▓▓▓ Registration ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  151. └─────────────────────────────────────────────────────────────────────────────┘
  152.  
  153.   JAMPACK is not now, has never been and will never be "FREE" software.
  154.  
  155.   JAMPACK is provided as "Shareware" for those T.A.G. BBS sysops looking
  156.   for a JAM Message base packer for T.A.G. BBS.
  157.  
  158.   If you honestly plan on registering the program within 14 days if you
  159.   find it useful, then feel free to test it out to see if it meets your
  160.   needs.  If you have no intention of ever registering it, then don't
  161.   even bother running it.
  162.  
  163.   You "should" be able to tell within a few days if the program is "what
  164.   you have been looking for".  It you have not registered the program
  165.   within 14 days of setting it up you must remove it from your system.
  166.  
  167.   Registration is for the version of the program that you tested.  There
  168.   are no guarantees either expressed or implied of any updates to the
  169.   program or addition of any "new features" if you register.  You are
  170.   registering it "as is".  When you do register you are entitled to use
  171.   all future versions of "this" program as a "registered user" should
  172.   there be any.
  173.  
  174.   Pricing as of 19 November 1994 :
  175.  
  176.         Number of Regs              "Proper Amount"
  177.         --------------              ---------------
  178.               1-2                      $10.00 each
  179.              3-10                      $8.00 each
  180.             11-20                      $5.00 each
  181.               20+                      $2.50 each
  182.         --------------              ---------------
  183.  
  184.   This means that if you and two other TAG sysops in your area want to
  185.   register JAMPACK together you'll each save $2 on the registration.
  186.   These rates apply only if it is in the same envelope.  It doesn't mean
  187.   that if "Joe down the Street" and "Sally next door" registered a month
  188.   ago that you get yours for $8.  It means that if you, "Joe" and "Sally"
  189.   get together and send $24 with the proper info  you will each be
  190.   registered.
  191.  
  192.   If you send less than "the proper amount", you will get the amount you
  193.   sent minus the cost of a stamp, envelope and a money order provided it
  194.   covers such. Plain and simple.  Amounts in excess of "the proper amount"
  195.   are cheerfully accepted and considered "donations".
  196.  
  197.   All registrations must be in US funds.  If you live outside of the US
  198.   you must send a money order drawn on US funds.  For example a personal
  199.   check from Canada is worthless paper.  Most Canadian banks will give
  200.   you a money order drawn on US funds with little to no hassle.
  201.  
  202.   If you run a multi line system you only need to register one copy.
  203.  
  204.   With the payment include the following information:
  205.  
  206.   Sysop name from your "System configuration" (case sensitive), ie if your
  207.   real name is "Anthrax Buttsnorkler" but the name you give on the BBS is
  208.   "John Doe" then you need to supply the name "John Doe".  If you use the
  209.   name "FuNkY sPeLlEr" then give it as "FuNkY sPeLlEr".
  210.  
  211.   Sysop name from TAG config           :______________________
  212.  
  213.   Fidonet Node Number (if in Fidonet)  :______________________
  214.  
  215.   BBS Phone Number                     :______________________
  216.  
  217.   Send the JAMPACK registration fee (money order preferred) to
  218.  
  219.     Mark McKay
  220.     PO Box 68063
  221.     Virginia Beach, VA 23455
  222.  
  223. ┌─────────────────────────────────────────────────────────────────────────────┐
  224. │▓▓▓▓▓ History ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  225. └─────────────────────────────────────────────────────────────────────────────┘
  226.  
  227.  1.00 - September 4, 1994 - Initial release
  228.  1.01 - September 5, 1994 - Cosmetic changes
  229.                             Added updating lastread pointers (oops)
  230.  1.10 - September 7, 1994 - Wrote MBEDIT (never released)
  231.  1.20 - September 9, 1994 - Rewrote MBEDIT and JAMPACK to use MBOARDS.BAK
  232.                             instead of MBOARDS.DAT.
  233.                             JAMPACK now reads MBOARDS.BAK for number of days
  234.                             in each area and can keep seperate numbers of
  235.                             days messages in each area.
  236.                             Now reads areas one by one and closes the MBOARDS
  237.                             file instead of leaving it open the entire time.
  238.  2.00 - November 19, 1994 - Added packing by number of messages.
  239.                             Changed JAMPACK to use -D mode or -M mode.
  240.  2.02 - November 30, 1994 - Fixed bug in v2.00 that only gave you usage
  241.                             screen no matter what you did.
  242.                             Updated MBEDIT to show days and number of msgs
  243.                             on main list
  244.  2.03 - December 2, 1994  - Minor changes, never released.
  245.  2.04 - Decmeber 4, 1994  - Major rewrite of JAMPACK, "should" fix any
  246.                             problems with previous versions.
  247.  
  248. ┌─────────────────────────────────────────────────────────────────────────────┐
  249. │▓▓▓▓▓ Known Problems ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  250. └─────────────────────────────────────────────────────────────────────────────┘
  251.  
  252. None as of v2.05
  253.  
  254. ┌─────────────────────────────────────────────────────────────────────────────┐
  255. │▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  256. └─────────────────────────────────────────────────────────────────────────────┘
  257.