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