NEWMSG.DOC

10 KB 71437f46d7f8483b…
                                 NEWMSG 1.01
            T.A.G. 2.6c1 Hudson Style Msgbase New Message Scanner
                                   6/10/92
                               by Mark McKay

                                 Disclaimer
                                 ~~~~~~~~~~
  This program is guaranteed to take up some of your precious disk space.
  The author Mark McKay is in no way liable for what occurs because you
  feel to need to run it.  The person operating the program is totally
  responsible for all consequences of running this program.  You break it
  you own it!

                                    NOTES!!
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
                     UPGRADING FROM PREVIOUS VERSIONS
                     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   1.  Depending upon which previous version you ran, you'll need to
       rename QCHKNEW.CFG or TNEWMSG.CFG to NEWMSG.CFG.  The format should
       be the same.

   2.  Prior to running NEWMSG.EXE you *MUST* run MKAF.EXE first to make
       the area file NEWMSG uses now instead of MBOARDS.DAT.  To do so,
       when you run MKAF just put the directory on the commandline.
       ex.  MKAF C:\BBS\DFILES\    <- would look for MBoards.dat in your
       C:\BBS\DFILES directory.  The backslash is optional.

  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   OTHER NOTE - Due to a Hard drive crash the source code to all the previous
                versions of TNEWMSG (and loads of other things) in Hard drive
                heaven (one of these days I'll learn to back things up more
                than every 6 months or so).

  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

                                   Files
                                   ~~~~~
  NEWMSG.EXE   - The TAG 2.6 Hudson/Fido new message scanner.
  NEWMSG.DOC   - You are reading it.
  MKAF.EXE     - Makes smaller MBOARDS.DAT type file, NEWMSG.DAT
  MKHIDX.EXE   - Makes TMSGIDX.BBS in each Hudson message directory.
  NEWMSG.CFG  - Sample configuration file. (Edit to suit your system)
  NEWMSG.BAT   - Sample batch file to run the door.

                                   Features
                                   ~~~~~~~~
  -  Scans for just Hudson Style messages.  Fido support will be added at a
     later date.

  -  Scans for both the users Real Name and Handle.

  -  Tells user TAG Message area, TAG Message number, the person the message
     is from and the subject of the message for all messages to the user.

  -  Now allows searching for a subject in msgs. (for those with access levels
     >200)

  -  Now allows searching for messages to other people. (for those with access
     levels >200)

                                  Requirements
                                  ~~~~~~~~~~~~
  1.  Before you do anything you must make the configuration file, NEWMSG.CFG.

      Example NEWMSG.CFG files

      Note: There must ALWAYS be at least 4 lines in NEWMSG.CFG.

      Structure of NEWMSG.CFG for 2 Hudson style message areas:
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      Line 1 : c:\tag\                  <-- your Main BBS Directory
      Line 2 : c:\tag\gfiles\           <-- path to USER.LST
      Line 3 : c:\tag\gfiles\           <-- path to MBOARDS.DAT
      Line 4 : 2                        <-- # of Hudson style MSG bases
      Line 5 : C:\TAG\QBBS\             <-- Hudson msg base 1 directory
      Line 6 : C:\RA\                   <-- Hudson msg base 2 directory

      Structure of TNEWMSG.CFG for 1 Hudson style message area:
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      Line 1 : c:\tag\                  <-- your Main BBS Directory
      Line 2 : c:\tag\gfiles\           <-- path to USER.LST
      Line 3 : c:\tag\gfiles\           <-- path to MBOARDS.DAT
      Line 4 : 1                        <-- # of Hudson style MSG bases
      Line 5 : C:\TAG\QBBS\             <-- Hudson msg base 1 directory

      NOTE: If you mess up this setup the door will crash guaranteed! :)

      If you have more than 1 Hudson style message area then Line 4 must be
      the number of Hudson style areas you have.  Lines following Line 4
      must be the path(s) to the Hudson areas.

  2.  Before running Newmsg you must run MKHIDX if you have any Hudson
      style message areas.

  3.  Edit your Binkley/Mailer.Bat to run MKHIDX "EVERY" your BBS exits or
      in your logoff.bat if you don't run a mailer.
      The data files these programs make will only be updated
      if there are changes in the size of the Hudson style message base(s).
      
                                   Quick setup
                                   ~~~~~~~~~~~
    1.  Put the files in a directory.
    2.  Edit NEWMSG.CFG  <- if it's wrong the program may crash
    3.  Edit NEWMSG.BAT  <- if it's wrong the program may crash
    4.  You must run MKAF before running anything else.
    5.  Run MKHIDX.
    6.  Add appropriate menu entry to run NEWMSG.BAT using Dorinfo1.Def.
    7.  Edit your BINKLEY/MAILER/LOGOFF.BAT as necessary (details above).
    8.  Run NEWMSG (dorinfo1.def must be present in the same directory as
        NEWMSG or the program won't run).

                                More Detailed SETUP
                                ~~~~~~~~~~~~~~~~~~~
    Place all the system files in your TAG (Main BBS) directory.
    System files are MKAF.EXE, MKHIDX.EXE, NEWMSG.EXE and TNEWMSG.CFG.

    Do this is the following order:

    1. Make/Edit a NEWMSG.CFG file to suit your system.

    Example NEWMSG.CFG files

      Note: There must ALWAYS be at least 4 lines in NEWMSG.CFG.

      Structure of NEWMSG.CFG for 2 Hudson style message areas:
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      Line 1 : c:\tagm2\                  <-- your Main BBS Directory
      Line 2 : c:\tagmulti\               <-- path to USER.LST
      Line 3 : c:\tagm2\gfiles\           <-- path to MBOARDS.DAT
      Line 4 : 2                          <-- # of Hudson style MSG bases
      Line 5 : C:\TAGM1\QBBS\             <-- Hudson msg base 1 directory
      Line 6 : C:\RA\                     <-- Hudson msg base 2 directory

      Structure of NEWMSG.CFG for 1 Hudson style message area:
      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
      Line 1 : c:\tagm2\                  <-- your Main BBS Directory
      Line 2 : c:\tagmulti\               <-- path to USER.LST
      Line 3 : c:\tagm2\gfiles\           <-- path to MBOARDS.DAT
      Line 4 : 1                          <-- # of Hudson style MSG bases
      Line 5 : C:\TAGM1\QBBS\             <-- Hudson msg base 1 directory

      NOTE: If you mess up this setup the door will crash guaranteed! :)

      If you have more than 1 Hudson style message area then Line 4 must be
      the number of Hudson style areas you have.  Lines following Line 4
      must be the path(s) to the Hudson areas.

    2. Edit your NEWMSG.BAT to suit your system

    Sample NEWMSG.BAT (files in BBS directory)
    ~~~~~~~~~~~~~~~~~
    @echo off
    NEWMSG
    exit
    ~~~~~~~~~~~~~~~~~

    NOTE: NEWMSG requires DORINFO1.DEF in the current directory.

    T.A.G. Menu setup:

    Pkey : ":"
    PData: "NEWMSG"

                             Hudson Requirement
                             ~~~~~~~~~~~~~~~~~~
    You must run MKHIDX.EXE everytime someone logs off of your system.
    It must reside and be run from the same directory as Newmsg.Exe.  It
    makes a file called NEWMSG.IDX in all your message area directories.
    It speeds things up greatly for getting the TAG board number in Hudson
    areas.

                           DESQView COMPATIBILITY
                           ~~~~~~~~~~~~~~~~~~~~~~
    The program will check to see if DV is loaded and compensate for it
    if DV is found.

                                Other stuff
                                ~~~~~~~~~~~
    That's about it.  If you run into any problems with it just let me know
    and I'll fix it.

                                Registration
                                ~~~~~~~~~~~~
    If you use this program on your BBS you are required to register it with
    the author.  Hundreds of hours went into developing, writing and adding
    features that TAG sysops asked for.

    To register send $10 to

    Mark McKay
    PO Box 68063
    Virginia Beach, VA 23455

    Include with the $10 a the following information for your "key"
    Please state that the registration is for TNewmsg.

    Sysop Name (case sensitive)

                  First Name    -----------------------------------
                 Second Name    -----------------------------------

    BBS Name (case sensitive)
                                -----------------------------------

    When I receive your money I will promptly send you your key (normally the
    same day) by one of the following methods (at my discretion).

    1. By direct crash netmail if you have a Fidonet node number.
    2. I'll upload it to your BBS (if you give me the number).
    3. By US Mail (if you give me an address to send it to.).

    Finally I apologize to all the TAG sysops out there for the delays in
    TNEWMSGB.  At the time I was severely perturbed at TAG sysops in general.
    I got over it though so here's a "usable" copy of NEWMSG for you to
    evaluate.  If you find that it's a good utility, please do the right thing
    and register it.

    Mark McKay
    FidoNet 1:271/22
    The PlayWorld BBS
    1-804-499-5150  HST 14.4K

    ----------------------------------------
    Registered TNewmsg Sysops As of 06/09/92
    ----------------------------------------
    Hawley Warren
    Tom LeClerc
    Bill Gatewood
    Rich Landers
    Dennis Matney
    ----------------------------------------

    History of Newmsg.
    1.00 - Initial wide beta release
    1.01 - Fixed stupid bug in checking for backslashes on paths
           Sped up MKHIDX.