home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / BINK.ZIP / MSGNUM.DOC < prev    next >
Text File  |  1990-09-20  |  9KB  |  173 lines
  1.  
  2.  
  3.  
  4.                                         MsgNum
  5.                                   Revision: 4.14ml
  6.                         by Bill Andrus, FidoNet Node 1:109/301
  7.  
  8.              Documentation by Dot Hage, FidoNet Node 1:109/530
  9.  
  10.              Based on copyrighted source by Bob Hartman, contained in
  11.              ConfMail 3.31 and Renum 4.10, and modifications by David
  12.              Hart.  The basic work upon which most of MsgNum is based is
  13.              Copyright 1985-88 Spark Software, Inc.  All rights reserved.
  14.              Also contains components of the Opus Toolkit 0.37
  15.  
  16.  
  17.         MsgNum, like an earlier utility called RENUM, is a utility for deleting
  18.         excess BBS messages when too many accumulate and renumbering the
  19.         remaining ones.  How it operates depends upon the command line
  20.         parameters you use, but in general it will delete X number of messages,
  21.         starting with the lowest-numbered, and then renumber the rest.  For
  22.         example, if you have 453 messages and would like to end up with 200, it
  23.         will delete the first 253 messages, and then start renumbering from 254
  24.         (which will become number 1) on up.
  25.  
  26.         This utility is now released in two separate packages, like MSGLINK and
  27.         VPurge.  The OS/2 version is tested on IBM OS/2 EE 1.2 FAT and HPFS
  28.         volumes, as well as IBM TRN and 3174 Peer LAN volumes.
  29.  
  30.         *********************************************************************
  31.         *    NOTE:  This version is being released in two highly optimized  *
  32.         *    forms.  Unlike Renum 4.10, upon which its algorithms are       *
  33.         *    based, MsgNum is NOT using sector-level disk I/O, and thus     *
  34.         *    should operate fine in all normal DOS and OS/2 environments,   *
  35.         *    including LAN and high performance cached disk systems.  It    *
  36.         *    runs much quicker than ConfMail 3.31, with enhanced logic,     *
  37.         *    and should be viewed as a significant improvement over it.     *
  38.         *    Since this a major change in source code over both ConfMail    *
  39.         *    3.31 and Renum 4.10, Bob Hartman and Spark Software have no    *
  40.         *    responsibility if this program does anything nasty, but get    *
  41.         *    all the credit for having released the source in the first     *
  42.         *    place.  It has been tested successfully on many systems, but   *
  43.         *    that in no way means it will run on your system.               *
  44.         *********************************************************************
  45.  
  46.         This version of MSGNUM is able to handle messages numbered up to 2048
  47.         in any directory.  Beyond that, the program will give unpredictable
  48.         (and usually undesired) results.
  49.  
  50.         This version of MSGNUM will renumber up to 16 entries in LASTREA?, for
  51.         Sirius and FrontDoor users (and some utilities which keep their High
  52.         Water Mark in there).  It will also scan up to 10 user lastread entries
  53.         in the older Opus 1.0-style USER.BBS and all 256 in Opus 1.1-style
  54.         USER.DAT files.  It will also attempt to maintain the 1.MSG High Water
  55.         Mark pointer.
  56.  
  57.         MSGNUM is using higher level I/O calls like Remapper, rather than
  58.         FAT-specific lower level I/O routines.  It runs best with areas that
  59.         are more or less contiguous before it is run.  It will always be as
  60.         fast as old versions of RENUM when just doing message base renumbering,
  61.         but it is much faster when killing messages as well as renumbering them
  62.         with one command.
  63.  
  64.  
  65.  
  66.  
  67.         The command line is as follows.  Note that it is similar to the
  68.         current RENUM, but quite different from ConfMail:
  69.  
  70.  
  71.           MSGNUM [-D days] [-K] [-M] [-N save1 save2] [-O] [-Q] [-S] [-R] <dir>
  72.  
  73.  
  74.         -D Kill by number of days old:
  75.              Days is the number of days of messages to save.  If you choose 2,
  76.              for instance, only messages two days old or less will be saved.
  77.              RENUM and MSGNUM have always tried to use arrival date instead of
  78.              message creation date, but QMail doesn't correctly set arrival
  79.              date within message headers, so if you use QMail you may find it
  80.              results in incorrect dates being used here.
  81.  
  82.         -K Kill received messages
  83.  
  84.         -M Use Maximus 1.0x structures:
  85.                 update the user pointers in LASTREAD.BBS if one exists.
  86.  
  87.         -N Kill by number:
  88.                 save1 is the number of messages to skip before killing.
  89.                        You will usually want to save at least the first
  90.                        message, which is where utilities like Confmail store
  91.                        various information they need.  You might also want to
  92.                        save message number two, and use that message to give
  93.                        users introductory information about the message area.
  94.                 save2 is the number of messages that should exist after save1
  95.                        messages are saved.  In other words, if you want to end
  96.                        up with 200 messages total, saving the first message,
  97.                        you would use:  -N 1 199
  98.  
  99.         -O Use Opus 1.1x file structures for USER.DAT, SYSTEMxx.BBS
  100.  
  101.         -Q Do it all quietly (don't write anything to the screen).
  102.  
  103.         -S Kill sent messages
  104.  
  105.         -R Renumber messages
  106.  
  107.         <dir> directory
  108.                 Name of directory to renumber.  If specified as a number, the
  109.                 SYSTEMxx.BBS (or SYSTEMxx.DAT for Opus 1.1+) in the current
  110.                 directory is used to get the message area path.  This means
  111.                 that if you are running Maximus, either you will have to use
  112.                 PIPER to generate SYSTEMxx.DAT files, or you will have to
  113.                 specify the path, and not just the directory number.  This will
  114.                 also trigger renumbering the USER.BBS (or USER.DAT), should it
  115.                 exist in the current directory.  If only a directory path is
  116.                 given, no attempt to access any user list file is made.  If
  117.                 any LASTREA? files are found in the message subdirectory, they
  118.                 are assumed to conform to the standard Opus format (an array
  119.                 of unsigned integers) which are message numbers, and updated.
  120.  
  121.         The directory (number or path) must be the last argument on the command
  122.         line.
  123.  
  124.         Both -O and -M can be safely specified for those running both Opus 1.1+
  125.         and Maximus systems.  All the -M flag does is enable a check for
  126.         LASTREAD.BBS.
  127.  
  128.  
  129.  
  130.  
  131.         Either "-" or "/" can be used interchangeably to identify a switch.
  132.  
  133.         Some examples:
  134.  
  135.                 MSGNUM -D 10 -N 1 100 -R C:\Msgs\Tech
  136.                 This will first kill messages older than 10 days in area
  137.                 C:\Msgs\Tech, then save 1.MSG and kill messages until there are
  138.                 100 left after 1.MSG.  Finally, the message base will be
  139.                 renumbered.
  140.  
  141.                 MSGNUM /K -D 10 /N 0 50 -R 2
  142.                 In area 2, kill received messages, kill messages more than 10
  143.                 days old, only save 50 after that, and then renumber the
  144.                 messages (and because an area number was specified, update
  145.                 the USER.BBS file).
  146.  
  147.  
  148.         =====================================================================
  149.                                    REVISION HISTORY
  150.  
  151.         ====>MsgNum - Revision: 4.14ml                      September 5, 1990
  152.  
  153.         Turns out that there's a message mangler floating about that totally
  154.         trashes the message header month field, so badly that MsgNum would
  155.         overlay its stack and code attempting to extract it.  And made the -A
  156.         switch inoperative since it was causing more problems than it fixed.
  157.  
  158.         ====>MsgNum - Revision: 4.13ml.l                      June 11, 1990
  159.  
  160.         Kill by date had two problems:  arrival date was being ignored on QMail
  161.         imported messages, and it usually didn't work at all.  Added the -A
  162.         switch to force arrival date use, and fixed the fix to the date routine
  163.         which was originally preventing Segment Violations, but broke the date
  164.         processing.
  165.  
  166.         ====>MsgNum - Revision: 4.13ml.k                           June 6, 1990
  167.  
  168.         Hopefully, this will be the last Beta.  I believe that this program is
  169.         now about as immune to grunged messages as its design permits.  While
  170.         fixing the exposures (all in the Date routine), also added Mei/May
  171.         recognition.  Oh, and this one could be even faster than .j was, too.
  172.  
  173.