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