home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR3 / MSGNUM13.ZIP / MSGNUM.DOC < prev    next >
Text File  |  1993-11-05  |  10KB  |  239 lines
  1.  
  2.                                   MsgNum v1.3
  3.                        Copyright (c) 1993, jLc Software
  4.  
  5.                                            Author:   Joe Hacker
  6.                                            Address:  FidoNet 1:160/140
  7.                                                      CFN     8:3017/0
  8.                                                      ICDM    77:2/0
  9.                                            BBS No.:  (512) 851-0241
  10.  
  11.          Release Date: 05 November 93
  12.  
  13.  
  14.          ─────────────────────────────────────────────────────────────
  15.                                 What Is MsgNum
  16.          ─────────────────────────────────────────────────────────────
  17.  
  18.          MsgNum is  a Hudson Style  Message Base Utility  that  allows
  19.          you to determine  if enough mail came through  with your last
  20.          packet  to justify  linking  and  sorting your  messages. Why
  21.          waste  the hard  drive life  on 1  or 2  messages coming  in?
  22.          MsgNum  will compare  the old  number of  the messages (since
  23.          last linking  or sorting) with  the number of  messages AFTER
  24.          new mail has arrived. Once the  difference is greater than or
  25.          equal to your configured limit, MsgNum drops for maintenance.
  26.          This could be the next large mail packet, or 15 small packets
  27.          later - MsgNum will take care of  it for you. MsgNum is NOT a
  28.          sorter,  linker,  etc.  It   simply  drops  with  a  specific
  29.          errorlevel allowing  you to use batch  files for your linking
  30.          and sorting.
  31.  
  32.          MsgNum  saves  my  hard  drive  about  40  minutes  a  day of
  33.          continuous reading and writing  that accompanies the linking,
  34.          sorting,  etc. Push  that out  a year,  and I  have saved 243
  35.          hours of continuous writing on my hard drive.
  36.  
  37.          The best of all - MsgNum is FREE!
  38.  
  39.  
  40.  
  41.          ─────────────────────────────────────────────────────────────
  42.                                Do I Need MsgNum
  43.          ─────────────────────────────────────────────────────────────
  44.  
  45.          If  you are  linking your  messages after  every mail  call -
  46.          simply put - YES!!!
  47.  
  48.  
  49.  
  50.          ─────────────────────────────────────────────────────────────
  51.                                   DISCLAIMER
  52.          ─────────────────────────────────────────────────────────────
  53.  
  54.          The only thing that I guarantee is that it was written by me.
  55.          It works great here and on  another system that I know of but
  56.          it may  not work on  yours for some  reason. I won't  be held
  57.          responsible  from  any  hard/software  damages  that  you may
  58.          incur resulting  from running MsgNum.  (Had to say  it... but
  59.          I'm sure you won't have any difficulty).
  60.  
  61.          This program has been tested with DOS 5.0, DOS 6.2, OS2 2.10,
  62.          4DOS, and Lantastic without any problems.
  63.  
  64.  
  65.          ─────────────────────────────────────────────────────────────
  66.                          Setting Up and Running MsgNum
  67.          ─────────────────────────────────────────────────────────────
  68.  
  69.          Installation and  configuration is easy. Simply  use an ASCII
  70.          editor to edit the enclosed file MSGNUM.CFG. This file should
  71.          consist of two lines as follows:
  72.  
  73.          Line 1 - directory to your message base
  74.          Line 2 - number  of  messages  tossed  to  activate  linking,
  75.          sorting, or  whatever else you  want to do  with your message
  76.          base.
  77.  
  78.          ----Example of MSGNUM.CFG---
  79.          c:\ra\msgbase
  80.          20
  81.          ----End of Example file-----
  82.  
  83.          There  should be  only two  lines in  this file, and it can't
  84.          contain semi-colons, etc.
  85.  
  86.          You do not need a  trailing backslash on your directory line,
  87.          but  if it  is there  -  it  won't hurt.  MsgNum will  handle
  88.          either.
  89.  
  90.          Place MsgNum.exe and MsgNum.cfg in the same directory as your
  91.          echomail tosser (ie. if you run FastEcho, put MsgNum.* in the
  92.          same directory as your FastEcho).
  93.  
  94.          Now you are ready to run MsgNum.  Simply type 'MSGNUM'.
  95.  
  96.          MsgNum will create a file called  MsgNum.Old - this will be a
  97.          one liner with only one thing  in it - the number of messages
  98.          that are in your message base.
  99.  
  100.          MsgNum will exit with one of three errorlevels.
  101.  
  102.          Errorlevel 1 -  Could be one of two things.
  103.  
  104.            1.  MsgNum.Old was not found - it was created.
  105.  
  106.            2.  The  _DIFFERENCE_  in  the  number  of messages in your
  107.            message base now and the number of messages since your last
  108.            maintenance  is  less  than  the  allowable  amount in your
  109.            configuration file.
  110.  
  111.            No  message base  maintenance (linking,  sorting, etc.)  is
  112.            needed.
  113.  
  114.          Errorlevel 2 - The _DIFFERENCE_  in the number of messages in
  115.          your message base  now and the number of  messages since your
  116.          last maintenance is greater than the allowable amount in your
  117.          configuration file.  Message base maintenance  is needed. Run
  118.          your linking, sorting, indexing, etc.
  119.  
  120.  
  121.  
  122.          Here's how you incorporate MsgNum in your batch file.
  123.  
  124.  
  125.               -----------Regular batch file for tossing----------
  126.  
  127.               :TOSS
  128.               run your echomail tosser MsgNum
  129.               If Errorlevel 2 Goto LINK
  130.               If Errorlevel 1 Goto END
  131.  
  132.               :LINK
  133.               REM The number of  messages that came in were
  134.               REM higher than the number in the MsgNum
  135.               REM configuration  file.
  136.               run your  echomail  linker, sorter, etc.
  137.  
  138.  
  139.               :END
  140.               REM  Ah, not enough messages  came in to worry about
  141.               return to the mailer
  142.               -----------End of Mail Tossing Batch File----------
  143.  
  144.          And  you SHOULD  run MsgNum  in your  maintenance event batch
  145.          file like:
  146.  
  147.               ---------Maintenance Batch File--------------------
  148.  
  149.               :MAINT
  150.               REM run your maintenance
  151.               delete old messages and purge them, etc.
  152.               MsgNum
  153.               whatever other maintenance you have
  154.  
  155.               ---------End of Maintenance Batch File Example-----
  156.  
  157.          When running  MsgNum after deleting  or purging, don't  worry
  158.          about trapping the errorlevels.  It's not needed.
  159.  
  160.  
  161.          ─────────────────────────────────────────────────────────────
  162.                          Important Things To Remember
  163.          ─────────────────────────────────────────────────────────────
  164.  
  165.          1.  You must  have the  MsgNum.cfg in  the same  directory as
  166.          MsgNum.
  167.  
  168.          2. You  must be in the  directory that MsgNum is  residing to
  169.          run it.
  170.  
  171.          3. You must realize that running MsgNum will save you LOTS of
  172.          disk writing if used. How much?  Saves me 40 minutes a day of
  173.          continuous disk reading/writing. MsgNum will do the same  for
  174.          the life expectancy of your drive.
  175.  
  176.  
  177.  
  178.          ─────────────────────────────────────────────────────────────
  179.                                     Support
  180.          ─────────────────────────────────────────────────────────────
  181.  
  182.          I doubt if you  need it, but I'll answer  simple questions if
  183.          you netmail me  at one of the above  listed addresses. I will
  184.          be  limited to  routing your  replies back,  though. I'm  not
  185.          charging for this  program, so I'm not gonna  spend any money
  186.          supporting it either.  Like I said before, I  doubt if you'll
  187.          need any help.
  188.  
  189.  
  190.  
  191.          ─────────────────────────────────────────────────────────────
  192.                                  Registration
  193.          ─────────────────────────────────────────────────────────────
  194.  
  195.          Ah, I said  it was free, didn't I. Well,  it is. But, I would
  196.          like to know that you are using it. Take a moment and send me
  197.          netmail  (just  route  it  and  save  a  dime)  at one of the
  198.          addresses listed above.
  199.  
  200.          Who knows, maybe I'll still you on an electronic mailing list
  201.          for other goodies I'll write.
  202.  
  203.          If  you run  MsgNum and  feel it  is extremely beneficial and
  204.          want  to  compensate  me  for  the  time  I  took to write it
  205.          (actually the  docs took longer  to write than  the program),
  206.          you can send me a donation at:
  207.  
  208.                       jLc Software
  209.                       C/O Joe Hacker
  210.                       4106 Nicklaus Lane
  211.                       Corpus Christi, TX  78413
  212.                       USA
  213.  
  214.          Please make any checks or money orders payable to "Joe Hacker"
  215.  
  216.          ─────────────────────────────────────────────────────────────
  217.                                Acknowledgements
  218.          ─────────────────────────────────────────────────────────────
  219.  
  220.          This program was inspired by two people.  They are:
  221.  
  222.          1.  Niels Rutjes - author of Total.
  223.              Niels wrote  a similar program.  I liked it  - but didn't
  224.              like all the errorlevels it would need.
  225.  
  226.          2.  Bob Barnes - author of nothing.
  227.              Bob was  part of the  inspiration for Total.  But I guess
  228.              when he  started running OS2 -  Total stopped working for
  229.              him, so I  wrote MsgNum. Bob's a friend.  He'll also help
  230.              you  get MsgNum  running if  you are  having some kind of
  231.              difficulty. He's at 1:160/202. Isn't Bob a great guy!
  232.  
  233.          Version  1.1 was  released after  Steve Joselson  (1:3630/40)
  234.          brought to my attention that some boards don't get large mail
  235.          packets,  only   many  small  ones.  Thank   Steve  for  that
  236.          correction.
  237.  
  238.                              * End of MsgNum.doc *
  239.