home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / mom200.zip / MOM.DOC < prev    next >
Text File  |  1993-06-15  |  94KB  |  2,130 lines
  1.       
  2.                   ┌────────────┐  ┌─────────┐  ┌────────────┐
  3.                   │  ┌─┐  ┌─┐  │  │  ┌───┐  │  │  ┌─┐  ┌─┐  │
  4.                   │  │ │  │ │  │  │  │   │  │  │  │ │  │ │  │
  5.                   │  │ │  │ │  │  │  │   │  │  │  │ │  │ │  │
  6.                   │  │ │  │ │  │  │  │   │  │  │  │ │  │ │  │
  7.                   │  │ └──┘ │  │  │  │   │  │  │  │ └──┘ │  │
  8.                  ┌┘  └┐    ┌┘  └┐ │  └───┘  │ ┌┘  └┐    ┌┘  └┐
  9.                  └────┘    └────┘ └─────────┘ └────┘    └────┘
  10. ────────────────────────────────────────────────────────────────────────────────
  11.  Message-O-Matic v2.00  - CopyRight 1992-93 by Eddy Matthews & Ivan Trifonoff
  12. ────────────────────────────────────────────────────────────────────────────────
  13.  
  14. ╒═════════════════════════════════════════════════════════════════════════════╕
  15. │ Table of Contents ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  16. ╘═════════════════════════════════════════════════════════════════════════════╛
  17.  
  18.     Table of Contents ................................................  1
  19.  
  20.     Dedication .......................................................  2
  21.  
  22.     Credits ..........................................................  2
  23.  
  24.     Legal disclaimer .................................................  2
  25.  
  26.     What is MOM? .....................................................  3
  27.  
  28.     Upgrading from v1.10 .............................................  5
  29.  
  30.     Configuring MOM for your system ..................................  7
  31.  
  32.     Configuring MOM Setup (General) ..................................  8
  33.  
  34.     Configuring Mom - LOGS ...........................................  9
  35.  
  36.     Configuring MOM - Messages  ......................................  10
  37.     
  38.     Configuring Mom - N Messages .....................................  13
  39.  
  40.     Configuring Mom - Statistics screens .............................  15
  41.     
  42.     Installing Mom into your BBS batch file ..........................  17
  43.  
  44.     MOM command line switches/parameters .............................  19
  45.  
  46.     Examples of command line switch usage by MOM .....................  24
  47.  
  48.     Metastrings used by Mom ..........................................  25
  49.  
  50.     Bug reports, contacting the author ...............................  29
  51.  
  52.     Future developments of MOM .......................................  30
  53.  
  54.     Beta test sites ..................................................  31
  55.  
  56.  
  57.  
  58.                                       -1-                                       
  59.  
  60.  
  61.  
  62.  
  63.                                                                                 
  64.  
  65.  
  66.     A final few words ................................................  31
  67.  
  68.  
  69.    
  70. ╒════════════════════════════════════════════════════════════════════════════╕
  71. │ Dedication! ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  72. ╘════════════════════════════════════════════════════════════════════════════╛
  73.  
  74. To my grandmother Ivanka.
  75.     Pochivay v mir.
  76.  
  77. This program is dedicated to the memory of Ivanka the dear grandmother of
  78. Ivan Trifonoff who sadly passed away during the development of Mom.
  79.    
  80. ╒═════════════════════════════════════════════════════════════════════════════╕
  81. │ Credits (Thanks guys!) ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  82. ╘═════════════════════════════════════════════════════════════════════════════╛
  83.  
  84.   I would like to thank the following guilty people for the creation of this
  85.   program. In no particular order:
  86.  
  87. Eddy Matthews      -- He is the one who initiated this project. Once
  88.                       he said: "I have a few ideas about a utility"...
  89.                       And that WAS the beginning... Thank you for the
  90.                       inspiration, ideas and for the Rum.
  91.                       "EM> One day I'll find something you can't
  92.                       program."
  93.  
  94. Bob Garbutt        -- For his permanent support, kindness and (polite :-)) 
  95.                       suggestions.
  96.                       "BG> I wonder if I've found a buglet!"
  97.  
  98. Clifford Cook      -- Our first registered beta tester for his bravery!.
  99.  
  100.  
  101.  
  102.  
  103.  
  104. Thank you for your attention, Ivan Trifonoff.
  105.  
  106.  
  107.  
  108.   ╒═════════════════════════════════════════════════════════════════════════╕
  109.   │▓▓▓ Legal Disclaimer ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  110.   ╘═════════════════════════════════════════════════════════════════════════╛
  111.  
  112.        Now to the boring bit!
  113.       
  114.        This program is NOT free, it is shareware. Any use of this program
  115.        after an initial 30 day trial period requires you to register your
  116.        copy with the author. Details on how to register are given at the
  117.        end of this document. Unregistered distribution copies of MOM are
  118.        released with a limited (180 day) run time demo key. This key will
  119.        expire 180 days from the date of the program release, NOT 180 days
  120.        from the first time you run the program!! Should you obtain a copy
  121.        of this program that has an expired demo key, you are advised to
  122.  
  123.  
  124.                                       -2-                                       
  125.  
  126.  
  127.  
  128.  
  129.                                                                                 
  130.  
  131.  
  132.        contact the authors or one of the support BBS's listed at the end of
  133.        this document for a later version.  
  134.  
  135.        Please remember shareware programs can only continue to develop if
  136.        they have YOUR support, failure to register will ONLY end in this
  137.        and other  shareware programs  being abandoned  which in turn will
  138.        mean you have a reduced choice of cheap well written programs.
  139.               
  140.        This  program and its  accompanying documentation are guaranteed to
  141.        do nothing other than take up space on your drive.  
  142.        
  143.        The author and  his  agents will not accept any liability for any
  144.        consequential loss or damage arising from  your use or inability to 
  145.        use  MOM  or  any of the  information  provided, including, but not 
  146.        limited  to,  economic  or  financial loss,  damage  to  peripheral
  147.        equipment or products, loss of use, productivity or time.       
  148.  
  149.        Whilst  every  effort has been made to  ensure  its reliability and
  150.        functionality you use this program entirely at your own risk and no
  151.        warranties of any type are given, either expressed or implied.
  152.  
  153.          The program and the associated documentation on disk may be
  154.          freely distributed on the following conditions
  155.  
  156.           1)  No changes whatsoever are made to the program,
  157.               its documentation or any associated files.
  158.  
  159.           2)  Anyone wishing to charge a fee for distributing
  160.               MOM  must  have  the  written  consent  of  the
  161.               author. No charge will be made for this consent
  162.               but I need to know who is distributing it so
  163.               that I can send out updates - Apply in writing
  164.               to the address at the end of this document.
  165.  
  166.  
  167.  
  168.                                                                                 
  169. ╒════════════════════════════════════════════════════════════════════════════╕
  170. │ What is MOM? ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  171. ╘════════════════════════════════════════════════════════════════════════════╛
  172.  
  173.  Message-O-Matic, hereafter referred to as MOM, has been developed as the
  174.  ultimate automatic message system for Sysops of RemoteAccess,SuperBBS and
  175.  ProBoard bulletin board systems using FrontDoor or D'Bridge as their front
  176.  -end mailer.
  177.  
  178.  
  179.  N.B.
  180.  Support for QuickBBS, and Binkley will follow in a future release. All major
  181.  releases will be announced in the RA_UTIL echo and also various RANet echo's.
  182.  This version has support for RemoteAccess v2.0g1 but has NO support for the
  183.  new JAM message base.... It will ONLY work if you are using the Hudson message
  184.  base!
  185.  
  186.  MOM will fully automate all of those tedious messages that Sysops need to
  187.  post to users. It needs only a minimal setup to get it going and can be
  188.  
  189.  
  190.                                       -3-                                       
  191.  
  192.  
  193.  
  194.  
  195.                                                                                 
  196.  
  197.  
  198.  up and running in a matter of minutes, though to get the best out of MOM
  199.  it is recommended that you take time to study all of its features in some
  200.  detail.
  201.  
  202.  In addition MOM will generate Ascii and Ansi screens giving details of
  203.  your systems activity which you can display online to your users and it
  204.  will also add the last BBS caller into your Front-end mailers waiting for
  205.  call screen and into the inbound history file. The Inbound history file
  206.  will be cleared of BBS callers in your midnight event to ensure it doesn't
  207.  grow too large.
  208.  
  209.  
  210.  
  211.  MOM can automatically send the following messages to your users:
  212.  
  213.    -      Welcome to new users
  214.  
  215.    -      Thankyou for uploading
  216.  
  217.    -      Subscription expiry
  218.           (configurable for # of days before expiry to send message)
  219.           With this type of message it is possible to send messages warning
  220.           users of their imminent subscription expiry, and also to optionally
  221.           downgrade their access once their subscription has expired.
  222.  
  223.    -      Happy birthday (automatically generated on users birthday)
  224.  
  225.    -      N'th caller to system
  226.           (send message to N'th caller to your system - fully configurable)
  227.           i.e. 1000th caller, 2000th caller etc..
  228.  
  229.    -      Send a message to users after every N'th call he or she has made
  230.           to your system. i.e. send a message after every 10 calls made by
  231.           a user (fully configurable)        
  232.  
  233.    -      # Times user has called
  234.           (send message when user has called # times - fully configurable)
  235.  
  236.    -      Carrier Drop - send message to users that drop carrier. Mom will
  237.           now work correctly with MOST doors that allow a user to logoff
  238.           without returning to the BBS as you can now specify a string that
  239.           is inserted by the door into your log file and if this string is
  240.           found by Mom it will NOT send a carrier drop message.
  241.  
  242.    -      Download message - send those troffers a message :-))
  243.  
  244.    -      Membership message - automatically send a message to users that
  245.           have called 'x' times. (Times On message)
  246.  
  247.    -      Watchdog Messages - post a message to a user if he/she exceeds the
  248.           number of times he/she is allowed to attempt to enter the correct
  249.           password. This message will also list any passwords that were tried!
  250.  
  251.    -      KeyWord messages - A VERY powerful feature which will tell MOM to
  252.           search your log files for a keyword or phrase you have defined and
  253.           send the appropriate message (fully configurable)
  254.  
  255.  
  256.                                       -4-                                       
  257.  
  258.  
  259.  
  260.  
  261.                                                                                 
  262.  
  263.  
  264.  
  265.    -      MOM can also send messages based on a host of other sysop defined
  266.           parameters. For example it is possible for MOM to send a message
  267.           to a user, or group of users, based on security level, flag settings,
  268.           User group, User language etc etc. See MOM command line switches for
  269.           more details.
  270.  
  271.  
  272.  
  273.  
  274.  In addition to those above, MOM can also send messages to the Sysop:
  275.  
  276.  
  277.    -      Daily Report - details of daily system usage and MOM's daily
  278.           activities.
  279.  
  280.    -      Weekly report - as above, but weekly stats
  281.  
  282.  
  283.  
  284.  MOM will also send Netmail and Echomail/local messages on behalf of the
  285.  Sysop:
  286.  
  287.  
  288.    -      SysopAway - reply to the sender of a Netmail/echomail/local message
  289.           when the Sysop is away. (see example text file)
  290.  
  291.  
  292.    -      The Regular Post type of message allows you to fully automate those
  293.           regular echomail messages such as BBS advertisements, echo rules etc.
  294.  
  295.  
  296.  
  297.  MOM can be configured so that it will show details of the last BBS caller on
  298.  the main Front-end mailer screen, and will also append these details in the
  299.  inbound history file giving the date and time of the call and showing the
  300.  amount of files downloaded for this particular call in bytes.
  301.  
  302. IMPORTANT NOTE!
  303.  when MOM posts these messages it is also capable of changing a users security
  304.  and/or flag settings, and it can also be setup so that messages will ONLY be
  305.  sent if a user meets certain criteria defined by you i.e. Security level, flag
  306.  settings, user group etc etc. When posting a message to a user, Mom will use
  307.  the users REAL name unless the message area it is posting into has been set
  308.  to FORCE the use of an Alias, in which case the users ALIAS will be used.
  309.  If the message area allows the use of EITHER real or alias names, then Mom
  310.  will use the REAL name of the user.
  311.  
  312.  These features are described in detail later in this document. 
  313.  
  314.  
  315.   ╒═════════════════════════════════════════════════════════════════════════╕
  316.   │▓▓▓ Upgrading from v1.10 ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  317.   ╘═════════════════════════════════════════════════════════════════════════╛
  318.  
  319.        Those of you that have been using Mom v1.10 will need to follow these
  320.  
  321.  
  322.                                       -5-                                       
  323.  
  324.  
  325.  
  326.  
  327.                                                                                 
  328.  
  329.  
  330.  instructions to upgrade your configuration to that of v2.0. If this is your
  331.  first attempt at using Mom, please ignore this section and proceed directly
  332.  to 'Configuring MOM for your system'
  333.  
  334.  Because of the many changes made to Mom's data structures, configurations
  335.  used in v1.10 are NOT compatible with v2.0. Most of these alterations will
  336.  be handled by MomSetup, but because LOTS of additions have been made to the
  337.  configuration file you will need to manually edit some parts of the config
  338.  yourself.
  339.  
  340. IMPORTANT !!
  341. Firstly, to upgrade your current configuration file, make a backup of your
  342. current version of Mom BEFORE attempting to upgrade.
  343.  
  344. IF YOU ARE STILL EVALUATING MOM, PLEASE REMEMBER TO RENAME 'EVERYONE.KEY' TO
  345. MOM.KEY AND PLACE IT IN THE SAME DIRECTORY AS MOM.EXE. IF YOU HAVE REGISTERED
  346. YOUR COPY OF MOM, SIMPLY COPY THE REGISTRATION KEY YOU RECEIVED WHEN YOU
  347. REGISTERED INTO YOUR MOM DIRECTORY.
  348.  
  349. Then follow these steps:
  350.  
  351. 1. Copy all the files in the v2.0 distribution archive into your MOM directory
  352.    This does mean ALL files! As even the message text files have been greatly
  353.    modified and most of the metastrings used in these files have been changed
  354.    and added to.
  355.  
  356. 2. Included in the archive is a MOM.CNF (configuration) file. This is a basic
  357.    setup file for v2.0. You may either edit this file to suit your system, or
  358.    replace it with your MOM.CNF from v1.10 and upgrade that to use with Mom.
  359.    If you decide to use the example Mom.Cnf file supplied in the version 2.0
  360.    release archive, load it into MomSetup and then jump to the section of
  361.    this document entitled 'Configuring MOM for your system' - Otherwise move
  362.    to step 3.
  363.  
  364. 3. To upgrade your existing Mom configuration file, place YOUR configuration
  365.    file from v1.10 (Mom.Cnf) into the Mom directory and run MomSetup.Exe
  366.  
  367. 4. Once MomSetup has been run, it will automatically expect you to load in a
  368.    VALID Mom.Cnf file... However, since you wish to upgrade from v1.10 YOUR
  369.    current Mom.Cnf is NOT VALID, so choose the 'CANCEL' option to quit from
  370.    loading the Mom.Cnf file.
  371.  
  372. 5. Once you have successfully entered the MomSetup program WITHOUT loading in
  373.    your Mom.Cnf, select the 'Upgrade' sub menu from the 'Utils' menu and load
  374.    in your Mom.Cnf file.
  375.    Mom will then upgrade it to be compatible with v2.0 data structures.
  376.    This is an automatic procedure and the ONLY requirements are for you to
  377.    select the filename to load.
  378.  
  379.     MOST IMPORTANT!!   Press F2 to SAVE the new configuration!!
  380.  
  381. 6. Mom will upgrade everything it can from your v1.10 configuration, but it
  382.    will NOT enable any screens OR messages! You MUST step through each part
  383.    of the NEW config to enable any messages and/or screens you want Mom to
  384.    produce. There will be very little that you need to alter, but you should
  385.    make a point of stepping through EVERY menu and sub-menu to check that all
  386.    is correct for your system and as stated above, ENABLE any messages/screens
  387.    you wish to use.  To enable a message or screen, select the appropriate
  388.    menu and press [Space] over the 'enable/disable' field, an 'X' indicates
  389.    that the message or stats screen is enabled or active.... a blank indicates
  390.    that the option is disabled or inactive.
  391.  
  392.  
  393.  
  394.                                       -6-                                       
  395.  
  396.  
  397.  
  398.  
  399.                                                                                 
  400.  
  401.  
  402.    DO NOT FORGET to press F2 to SAVE any changes you may make BEFORE you exit
  403.                  MomSetup. You will NOT be asked to save any changes when you
  404.                  exit the setup program!!  You have been warned!!
  405.  
  406. 7. PLEASE step through the various chapters of this document about configuring
  407.    Mom for your system to ensure everything is entered correctly. Failure to
  408.    do this could result in Mom either working incorrectly or NOT working AT
  409.    ALL!!  You have been warned!!
  410.  
  411.  
  412.  
  413.  
  414. ╒═════════════════════════════════════════════════════════════════════════════╕
  415. │ Configuring MOM for your system ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  416. ╘═════════════════════════════════════════════════════════════════════════════╛
  417.  
  418.  
  419.     You will find the following files inside the distribution archive:
  420.  
  421.  
  422.          MOM.EXE      - The main executable file
  423.          MOMSETUP.EXE - The setup program used to configure Mom
  424.          MOMSETUP.DAT - Data file used by MomSetup.Exe
  425.          MOMSETUP.HLP - Online help file used by MomSetup.Exe. This can
  426.                         be called up anywhere within MomSetup by pressing
  427.                         F1 (Function key F1)
  428.          DEFAULT.PAL  - The default color file used by MomSetup. These
  429.                         are the colors used within MomSetup, and have NO
  430.                         effect on the screens generated by Mom. The colors
  431.                         used in the stats screens can be modified from
  432.                         within MomSetup.
  433.          CYAN.PAL     - Alternative color file for use in MomSetup
  434.          ROSE.PAL     - Alternative color file for use in MomSetup
  435.          EDITPAL.EXE  - Program to allow you to create your own *.Pal
  436.                         files. NO further explanation is given on this
  437.                         program... Use it at your peril! :-)
  438.          MOM.DOC      - Documentation for Mom (what your reading now!)
  439.          REGISTER.MOM - Registration document for all countries which do
  440.                         not have a registration site for your country
  441.          REGISTER.SWE - Registration document for systems in Sweden
  442.          REGISTER.SUI - Registration document for systems in Switzerland
  443.          REGISTER.USA - Registration document for systems in USA
  444.          REGISTER.RSA - Registration document for systems in South Africa
  445.          WHATS.NEW    - List of new features added to Mom since v1.10
  446.          SUPPORT.MOM  - List of support boards for Mom
  447.          SAMPLE.ZIP   - Sample text files for use with Mom
  448.                         (see the section on meta strings for more info)
  449.          EVERYONE.KEY - Limited run time demo key. Use this if you are an
  450.                         unregistered user, or replace it with your own key
  451.                         if you have already registered your copy of Mom.
  452.                         If you are evaluating Mom, you MUST RENAME this from
  453.                         Everyone.Key -> Mom.Key and place it in the same
  454.                         directory as Mom.Exe. Mom will NOT OPERATE without
  455.                         this key or a valid registration key.
  456.          MOM.CNF      - Example configuration file which you can edit
  457.                         by using MomSetup.Exe PLEASE NOTE!! This example
  458.                         configuration file has EVERYTHING disabled and you
  459.                         will need to enable the features you wish to use.
  460.                         Running Mom without editing this file will result
  461.                         in NO messages or stats screens being posted/created.
  462.  
  463.  
  464.                                       -7-                                       
  465.  
  466.  
  467.  
  468.  
  469.                                                                                 
  470.  
  471.  
  472.  
  473.                         !! YOU MUST EDIT THIS FILE TO SUIT YOUR SYSTEM !!
  474.  
  475.  
  476.  
  477.  
  478.     IT IS IMPORTANT THAT YOU READ THIS SECTION AND THE SECTIONS ENTITLED
  479.    'CONFIGURING MOM' + 'INSTALLING MOM INTO YOUR BBS BATCH FILE' TO GET THE
  480.     BEST  OUT  OF THIS  PROGRAM. SPENDING  10-15  MINUTES READING THESE TWO
  481.     SECTIONS WILL SAVE YOU HOURS OF HEAD SCRATCHING LATER....
  482.  
  483.  
  484.  To configure Mom for use with your system, you need to run the configuration
  485.  program MomSetup.Exe and enter all of the information for your system. It is
  486.  important that you step through each screen in turn and enter the details in
  487.  a logical order....     Trying to rush through the setup will only result in 
  488.  errors which will cause problems later. 
  489.  
  490.  
  491.  PLEASE FOLLOW THESE LOGICAL STEPS TO ENSURE SUCCESS!
  492.  
  493. IF YOU ARE UPGRADING FROM VERSION 1.10 PLEASE SEE THE SEPARATE SECTION OF
  494. THIS DOCUMENT WHICH EXPLAINS THE UPGRADE PROCEDURE
  495.  
  496. IMPORTANT !!
  497. IF YOU ARE STILL EVALUATING MOM, PLEASE REMEMBER TO RENAME 'EVERYONE.KEY' TO
  498. MOM.KEY AND PLACE IT IN THE SAME DIRECTORY AS MOM.EXE. IF YOU HAVE REGISTERED
  499. YOUR COPY OF MOM, SIMPLY COPY THE REGISTRATION KEY YOU RECEIVED WHEN YOU
  500. REGISTERED INTO YOUR MOM DIRECTORY.
  501.  
  502.  
  503. 1. Ensure that all the files from the distribution archive are placed in a 
  504.    separate directory (C:\MOM is advised and is assumed from now on)
  505.  
  506. 2. Run MOMSETUP.EXE. Press [Enter] after the opening screen. You will then be
  507.    asked to load in the Mom.Cnf file for editing, Press [Enter] twice to accept
  508.    the default filename of MOM.CNF and load it into MomSetup.
  509.  
  510. 3. Now that you have loaded the default Mom.Cnf file which was included in the
  511.    distribution archive you may start to edit it to suit your system.
  512.  
  513. 4. Press Alt-S to enter the Setup menu. Here you have two choices, 'General'
  514.    and 'Logs'. Move the highlighted bar over 'General' and press [Enter]
  515.    This is where you tell Mom about your general system, i.e. BBS type, Mailer
  516.    etc etc..
  517.  
  518. 5. If you are uncertain of what you need to enter on any of the fields, pressing
  519.    'F1' (function key F1) will bring up context sensitive help for the field in
  520.    question.
  521.  
  522. 6. Because the setup program has a built in 'Help' system, we will only explain
  523.    very briefly what is required as most of it should be very straight forward.
  524.    The only parts that will be explained in detail are those that may cause
  525.    confusion when first configuring Mom.
  526.  
  527.  
  528.  
  529. ╒════════════════════════════════════════════════════════════════════════════╕
  530. │ Configuring MOM - SETUP ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  531. ╘════════════════════════════════════════════════════════════════════════════╛
  532.  
  533.  
  534. 7. Edit the various fields to suit your particular system. Everything should
  535.  
  536.  
  537.                                       -8-                                       
  538.  
  539.  
  540.  
  541.  
  542.                                                                                 
  543.  
  544.  
  545.    be fairly obvious, but a couple of things may need extra explanation.
  546.  
  547.   (a) To move between the various fields, press your TAB key
  548.   (b) To move between options within a particular field, use the cursor keys
  549.   (c) Before each option you will see a ( ) or [ ], these options are activated
  550.       when they contain either a period '.' or an 'X'. To activate an option
  551.       in a ( ) simply move the cursor over the option you want enabled and then
  552.       press TAB to move to the next field. The option will show it is enabled
  553.       by changing from ( ) to (.)
  554.       The options within [ ] brackets work slightly differently. Here you
  555.       should move the cursor to the desired option and then press [Space]
  556.       this will show the option as active by changing from [ ] to [X]
  557.  
  558.   (d) Default Message settings:
  559.    Board:    Here you can specify a message board number to be used as a default
  560.              this area will ONLY be used if no message area is specified in the
  561.              relevant settings for a particular message type, or if no message
  562.              area number is given on the command line. Specifying a message area
  563.              in the other message settings menus will override this area. It is
  564.              ONLY used if NO area number is specified elsewhere.
  565.    Who From: Again, this is a default setting that will ONLY be used if you do
  566.              not specify the name of the message sender. Normally this field
  567.              would contain the Sysops name.
  568.    Subject:  The default subject line for a message. This will be used ONLY if
  569.              no specific subject is given for a message. This will be placed on
  570.              the subject line of the message. It will be overridden if you have
  571.              specified a different subject line for a particular message either
  572.              in the setup for that message, or from the command line.
  573.              You may use metastrings in this field which will make the subject
  574.              more personal. See the section of this document about metastrings
  575.              for more information.
  576.  
  577. 8. Once you have entered the information in this menu, select 'OK' and press
  578.    [Enter] if you are happy with the changes you have made.
  579.  
  580. ╒════════════════════════════════════════════════════════════════════════════╕
  581. │ Configuring MOM - LOGS  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  582. ╘════════════════════════════════════════════════════════════════════════════╛
  583.  
  584. 9.  Press Alt-S again and select the 'Logs' menu
  585.  
  586. 10. Here you must enter the full path and file names of the logs you wish Mom
  587.     to scan. You MUST enter at least ONE log file for Mom to work correctly!
  588.  
  589.     i.e. C:\RA\RA.LOG
  590.  
  591.     You can enter up to 10 log files for Mom to scan. Don't forget if you are
  592.     running a multi-node system that you will need to specify the path and
  593.     filename for each of your nodes.
  594.  
  595. 11. Select 'OK' when you are happy with your selections.
  596.  
  597.  
  598. PLEASE NOTE!!    !! QUICK SETUP FOR NEW USERS !!
  599.  
  600. The sample Mom.Cnf file that is supplied in the release archive only needs
  601.  
  602.  
  603.                                       -9-                                       
  604.  
  605.  
  606.  
  607.  
  608.                                                                                 
  609.  
  610.  
  611. minimal changes to get Mom to work.... Follow the steps outlined above, then
  612. ENABLE any messages and statistics screens you wish Mom to create and save
  613. the Config file by pressing F2 from within MomSetup. The default settings
  614. supplied in the example file will work perfectly well for most systems, but
  615. you MUST remember to ENABLE the messages and screens you want to use otherwise
  616. NO messages or stats will be generated!!
  617.  
  618. Once you have entered your BBS and log file details and saved these changes,
  619. you only need to add Mom into your BBS batch file for it to run. Please see
  620. the separate section of this document for instructions on how to include Mom
  621. in your batch file.
  622.  
  623. After editing your BBS batch file to include Mom, that's it!
  624.  
  625.  
  626.  
  627. When you have got Mom running you may want to try altering the configuration
  628. to take advantage of all the features Mom has to offer. We would advise that
  629. you use Mom as it is supplied until you have had time to read and FULLY under-
  630. stand all of the things Mom can do and how to set it all up. Because Mom has
  631. been deliberately programmed to be as flexible as possible you may find some
  632. of the more advanced features difficult to grasp at first... but Fear Not!
  633. The following sections explain in more detail what is required for each part
  634. of Mom's configuration.
  635.  
  636. Don't forget, we have a large number of support sites that are always willing
  637. to explain things if you get stuck, and there is also a MOM_HELP echo available
  638. from any of the support sites that you can link into to get help directly from
  639. the programs authors should you wish to.
  640.  
  641.  
  642. ╒════════════════════════════════════════════════════════════════════════════╕
  643. │ Configuring MOM - MESSAGES ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  644. ╘════════════════════════════════════════════════════════════════════════════╛
  645.  
  646. 12. MomSetup has two different basic types of messages, Messages and N Messages
  647.     Here we will deal with Messages... N Messages are more advanced and will be
  648.     explained in the next section.
  649.  
  650. 13. Select the 'Messages' option. You will now be presented with a sub-menu
  651.     showing the various messages Mom can send. Briefly they are:
  652.  
  653.     Daily report:  Posts a daily report of your systems activity.
  654.     Weekly report: Sends a weekly report of your systems activity.
  655.     Welcome:       Welcomes new users to your system.
  656.     Thank you:     Sends a thank you message to users that have uploaded files.
  657.     Watch dog:     Sends a message to a user if he/she has exceeded the maximum
  658.                    number of password attempts for your system. This message
  659.                    will include a list of the passwords that were tried.
  660.     Birthday:      Posts a message to a user on his/her birthday.
  661.     Carrier drop:  Sends a message to a user that has dropped carrier without
  662.                    logging off correctly.
  663.  
  664.  
  665. 14. Most of these messages are very similar in their setup, so we will only
  666.     discuss the bits that may cause confusion. Select each message in turn
  667.  
  668.  
  669.                                       -10-                                      
  670.  
  671.  
  672.  
  673.  
  674.                                                                                 
  675.  
  676.  
  677.     starting with Daily report.
  678.  
  679.     Active: An 'X' indicates this message is active. That is it will be sent
  680.             by Mom at the appropriate time. The message can be enabled/disabled
  681.             by pressing the [Space] key.
  682.  
  683.   Filename: The filename of the message to be posted by Mom. If you wish to
  684.             have your message text files in a different directory to Mom, you
  685.             MUST also include a path to the file.
  686.  
  687.     Board: The message board number that this message should be posted into.
  688.            If this field has 0 as the message board number Mom will use the
  689.            'Default' message area as defined in the 'General' setup.
  690.  
  691.  Who from: The name to be placed in the 'From' field of the message. Again, if
  692.            this is left blank, Mom will use the default name specified in the
  693.            'General' setup.
  694.  
  695.   Subject: The subject line to be used for this message. If left blank, Mom
  696.            will use the default setting specified in 'General' setup. You may
  697.            also use metastrings in this field to personalize your messages.
  698.            See 'Metastrings' later in this document for a list.
  699.  
  700. Attributes:The attributes that Mom should assign to this message. See your
  701.            BBS or front-end mailers docs for a more detailed description, or
  702.            press function key F1 for a brief outline of the particular types
  703.            of attribute.
  704.  
  705.  
  706. Attributes2: More advanced attributes that can be set for certain message types
  707.  
  708. Condition: Here you can specify that Mom will NOT send this message UNLESS the
  709.            user meets certain conditions. If the user does NOT meet these
  710.            conditions Mom will NOT send the message. Understanding this option
  711.            and the 'Action' option (explained later) will allow you to make
  712.            the best possible use of Mom's flexibility. This is perhaps one of
  713.            the most difficult parts of Mom to grasp, but spending a little time
  714.            getting to understand these two features will pay handsome dividends
  715.            in your ability to make the best use of Mom.
  716.  
  717. Conditions are checked BEFORE sending message, and actions are performed only
  718. when a message has been successfully sent.
  719.  
  720.  
  721.  
  722.  The format of the condition field is:
  723.  
  724.  ('|' means or):
  725.  
  726. condition ::== <cond> |
  727.                <cond>','<cond>         - conditions are separated by ','
  728.  
  729. cond ::== <flagsetting> |
  730.           <securitysetting> |
  731.           <groupsetting> |
  732.           <languagesetting>
  733.  
  734.  
  735.                                       -11-                                      
  736.  
  737.  
  738.  
  739.  
  740.                                                                                 
  741.  
  742.  
  743.  
  744. flagsetting ::== <flagpresense><flagname><number>
  745.  
  746. flagpresense ::== '-' |                - flag is clear
  747.                   '+'                  - flag is set
  748.  
  749. flagname ::== 'A' | 'B' | 'C' | 'D'
  750.  
  751. securitysetting ::== <relation_or_s><number>
  752.  
  753. relation_or_s ::== <relation> | 'S'    - security is equivalent to
  754.  
  755. relation ::== '=' |                    - security is equivalent to
  756.               '<' |                    - security is less than or equal to
  757.               '>'                      - security is greater than or equal to
  758.  
  759. groupsetting ::== 'G'<number>
  760.  
  761. languagesetting ::== 'L'<number>
  762.  
  763. example: -a1,+b2,<5
  764.  
  765.    In this example, Mom would ONLY post this message if flag A1 was off, flag
  766.    B2 was on, and the users security level was less than or equal to 5. If ANY
  767.    of these conditions weren't satisfied, Mom would NOT send the message.
  768.  
  769. example: +d8,s10,g6
  770.  
  771.    In this example, Mom would ONLY post the message if flag D8 was on, the
  772.    users security level was 10, and they were in user group 6. If ANY of these
  773.    Conditions were NOT satisfied, Mom would NOT send the message.
  774.  
  775.  
  776.  
  777.    Action: As with the Condition field, the Action option allows Mom to be
  778.            VERY flexible in use. If a particular message is sent to a user,
  779.            after checking that he/she meets the conditions (if any) for a
  780.            message, Mom can optionally perform certain 'Actions' on a users
  781.            record.... This can be anything from raising/lowering their sec
  782.            level, changing user flags, changing user group etc etc..
  783.            Again, this will probably seem confusing at first. The easiest
  784.            way of getting to understand these two options is to experiment
  785.            with them. The basic parameters Mom expects to find in the Actions
  786.            field are:
  787.  
  788. action ::== <act> |
  789.             <act>','<act>              - actions are separated by ','
  790.  
  791. act ::== <flagset> |
  792.          <securityset> |
  793.          <securitycondition>
  794.  
  795. flagset ::== <whattodo><flagname><number>
  796.  
  797. whattodo ::== '-' |                    - clear flag, decrease security
  798.               '+' |                    - set flag, increase security
  799.  
  800.  
  801.                                       -12-                                      
  802.  
  803.  
  804.  
  805.  
  806.                                                                                 
  807.  
  808.  
  809.               '!'                      - toggle flag, set security
  810.  
  811. flagname ::== 'A' | 'B' | 'C' | 'D'
  812.  
  813. securityset ::== <whattodo>'S'<number>
  814.  
  815. securitycondition ::== <relation><number>
  816.  
  817. relation ::== '<' |                    - change security if less than or equal
  818.                                          to
  819.               '>'                      - change security if greater than or
  820.                                          equal to
  821.  
  822. example: -a1,+b2,-s5,<50
  823.  
  824.      In this example, Mom would clear flag A1, set flag B2, set Security to
  825.      Sec-5 but ONLY if Sec was equal to or less than 50, otherwise the sec
  826.      level would NOT be altered.
  827.  
  828. 15. Once you have stepped through each of these messages and enabled the ones
  829.     you wish to use (after configuring them) it is time to move onto the more
  830.     advanced messages that Mom can send. Select 'OK' and exit the Messages
  831.     setup.
  832.  
  833. ╒════════════════════════════════════════════════════════════════════════════╕
  834. │ Configuring MOM - N MESSAGES ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  835. ╘════════════════════════════════════════════════════════════════════════════╛
  836.  
  837. 16. Press Alt-M to select the Messages menu and then select the N Messages
  838.     sub-menu. Here is where you can configure Mom's more advanced message types.
  839.     You will see the following types of message to choose from:
  840.  
  841.        Keyword: Allows you to configure Mom to search your log files for a
  842.                 particular keyword or phrase and send an appropriate message
  843.                 if that keyword or phrase is found.
  844.  
  845.     Nth Caller: Posts a message to the 'Nth' caller to your system.
  846.  
  847. Every Nth call: Sends a message to a user after EVERY 'Nth' calls he/she has
  848.                 made to your system.
  849.  
  850.       Times On: Posts a message to a user that has made 'X' number of calls
  851.                 to your system.
  852.  
  853.        Expires: Sends a reminder message to users telling them that their
  854.                 subscription will expire in 'X' days.
  855.  
  856.   Regular post: Posts a message on a regular basis. Useful for posting a BBS
  857.                 advert, rules for an echo area etc etc.
  858.  
  859.     Sysop away: Allows Mom to automatically reply to any message sent to the
  860.                 Sysop. Very handy if you are away on vacation!
  861.  
  862.  
  863. 17. You can configure up to 10 of each type of message. For example, in Keyword
  864.     #1 you may get Mom to search for 'Sent' (without the quotes) in you Front-
  865.  
  866.  
  867.                                       -13-                                      
  868.  
  869.  
  870.  
  871.  
  872.                                                                                 
  873.  
  874.  
  875.     Door log and send a message to the sysop whenever FD sent a file. Then in
  876.     Keyword #2 you could have Mom scan for some other keyword and send a totally
  877.     different message etc... This is true for ALL N Messages EXCEPT for Sysop
  878.     away. The Sysop away message only has ONE message that can be configured by
  879.     you. Again, step through each message and alter them to suit your require-
  880.     ments. We will now explain some of the options which may at first glance be
  881.     confusing:
  882.  
  883.     Most of the various options in these messages are exactly the same as they
  884.     are in 'Messages'. Please refer to the previous section for details.
  885.  
  886.     Again, these messages can be VERY flexible by using the 'Conditions' and
  887.     'Actions' associated with each message.
  888.  
  889. 18. The Only difference in the setting up of these messages concern the Keyword
  890.     messages which has an extra option 'String' and most of the others which
  891.     have the option 'Value'. The Sysop away messages are also handled in a
  892.     different way to the others.... These differences are explained below:
  893.  
  894.  
  895.     In Keyword messages, the field labelled 'String' is where you enter the text
  896.     that Mom should scan for in your log files. It is important that you enter
  897.     the EXACT string as it appears in the log, CASE IS IMPORTANT !! This can be
  898.     a single word, or a phrase which Mom will look for. If Mom finds the string
  899.     you have specified the then the message you have assigned to this Keyword
  900.     will be posted (if the user meets the conditions)
  901.  
  902.     In most of the other message types, you will find a field called 'Value'
  903.     This varies slightly in its use depending on the message concerned, but
  904.     basically you need to enter either a number of calls before a message will
  905.     take effect, or a number of days. Pressing F1 in the various messages will
  906.     give you help on what is expected exactly.
  907.  
  908.     Sysop away messages are handled differently to normal messages in three
  909.     respects. Firstly, the message board number you specify is the message
  910.     board that Mom will search. NO other message board will be scanned, and
  911.     the reply will be posted into the same message area that was scanned by
  912.     Mom. Secondly, the 'From' field of the message is also treat in a very
  913.     similar way in that the name specified here is the name that Mom will scan
  914.     for in the 'To' field of any messages AND use as the name to be used for
  915.     the 'From' field in any replies Mom may send. Lastly, if you leave the
  916.     'Subject' line blank, Mom will quote the subject line of the message it
  917.     is responding to. Entering a 'Subject' line will disable this feature.
  918.  
  919. Once you have setup the message you wish Mom to send, you can also edit the
  920. Ascii text files included in the Sample.Zip file in the release archive and
  921. personalize them to suit your system. The example messages will be fine for
  922. most users, but you are free to tailor them to your needs. Please see the
  923. section of this document for details of the metastrings used in the various
  924. messages.
  925.  
  926.  
  927. Now we can move onto the Statistics screens which Mom can create...
  928.  
  929.  
  930.  
  931.  
  932.  
  933.                                       -14-                                      
  934.  
  935.  
  936.  
  937.  
  938.                                                                                 
  939.  
  940.  
  941. ╒════════════════════════════════════════════════════════════════════════════╕
  942. │ Configuring MOM - SCREENS ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  943. ╘════════════════════════════════════════════════════════════════════════════╛
  944.  
  945. 19. Press Alt-C to go to the Screens menu. Here you can select the various
  946.     statistics screens that Mom can generate. Again, step through them one at
  947.     a time enabling the ones you wish to use on your system. The screens
  948.     available are:
  949.  
  950. Most active callers:       Creates an Asc/Ans screen showing the most active
  951.                            callers to your system by number of calls.
  952.  
  953. Best downloaders (k):      Creates an Asc/Ans screen of the best downloaders
  954.                            on your system by the number of Kb downloaded.
  955.  
  956. Best downloaders (times):  Shows the best downloaders on your system by the
  957.                            number of files downloaded.
  958.  
  959. Best uploaders (k):        Same as Best downloaders (k), only for uploaders.
  960.  
  961. Best uploaders (times):    Same as Best downloaders (times), only for uploaders.
  962.  
  963. Best message writers:      Creates a list of the most active message writers
  964.                            on your system.
  965.  
  966. Most active message area:  Shows the most active message areas on your system
  967.                            by number of messages in each message base.
  968.  
  969. Last callers:              Creates an Asc/Ans screen showing the last callers
  970.                            to your system.
  971.  
  972. Files activity report:     Creates a screen showing file activity on your
  973.                            BBS.
  974.  
  975. System activity report:    Generates an activity report of system usage.
  976.  
  977. Happy birthday screen:     Creates a list of users that have a birthday in the
  978.                            next 'X' days.
  979.  
  980. Inbound echomail history:  Shows inbound echomail activity for your system.
  981.  
  982. Outbound echomail history: Same as Inbound echomail history, only this time
  983.                            it shows Outbound calls made by your system.
  984.  
  985.  
  986. 20. Enable any screens you wish Mom to create by pressing [Space]. The screens
  987.     Mom generates will be placed in your BBS text file directory, as defined in
  988.     your BBS configuration, and can be displayed to users in the normal way.
  989.  
  990. 21. The filename should be the name of the screen you wish to create WITHOUT
  991.     an extension. Mom will automatically generate an Ascii and Ansi screen and
  992.     add the required extension. DO NOT include the extension in the filename!!
  993.     The filename MUST be a VALID Dos filename. i.e.NOT more than 8 characters,
  994.     and should ONLY include valid filename characters. See your Dos manual for
  995.     more information.
  996.  
  997.  
  998.  
  999.                                       -15-                                      
  1000.  
  1001.  
  1002.  
  1003.  
  1004.                                                                                 
  1005.  
  1006.  
  1007. 22. A 'Condition' can be specified for screens in a similar way to that used
  1008.     in the messages. For example, specifying a Condition of '<100' without
  1009.     the quotes, would only list users of sec level 100 or less on the screen
  1010.     generated by Mom, users above this level will NOT be included. You can
  1011.     use ALL of the various conditions exactly as they are shown in 'Messages'
  1012.  
  1013. 23. The 'Title', 'Sub title', 'Text' and 'Bottom line' are strings of text
  1014.     that you can define for most screen types. The exceptions being Files
  1015.     activity report, System activity report, Inbound and Outbound echomail
  1016.     history... These four screens are hard coded into Mom and cannot have
  1017.     their layout altered. All the other statistics screens can be altered
  1018.     by you to suit your own tastes/system. There are various text handling
  1019.     commands that are understood by Mom to give you the flexibility to create
  1020.     your own screens... An explanation of each of the lines you can alter
  1021.     and the text handling commands are as follows:
  1022.  
  1023.  
  1024. Screen title - This is the title line shown on the stats screen created by Mom
  1025.  
  1026. Sub title    - The text to be placed on the sub-title line of the screen
  1027.  
  1028. Text         - The text to be placed in the main body of the screen
  1029.  
  1030. Bottom line  - Text to be placed at the end of the screen (Press [Return] for
  1031.                example)
  1032.  
  1033. In the example Mom.Cnf (configuration) file provided in the release archive, a
  1034. basic setup is provided to get  you started  and it  will generate  ALL of the
  1035. various statistics screens available in Mom. Once you  have  FULLY understood
  1036. the layout of these commands you can then  edit the various  fields to create
  1037. statistics screens which are unique to your system.
  1038.  
  1039.  
  1040.  
  1041.  
  1042. The general format of metastring usage and text formatting is:
  1043.  
  1044. '%'metastringname['#'<arguments>'#'][':'[<justification>]<length>]'%'
  1045.  
  1046. items in '' are typed as is WITHOUT the quotes, items in [] are optional,
  1047. and items in <> are substituted.
  1048.  
  1049. <metastringname> is one of ANY of the metastrings listed in the documents
  1050. <arguments> are metastring arguments if any (e.g. drive letters in drivesize kbdrivesize free
  1051. etc.).
  1052. <justification> is 'l'eft, 'c'enter or 'r'ight (default left).
  1053. <length> is justification length (default 79).
  1054.  
  1055. if the line in message text begins with a '|' it is treated as
  1056. a justification parameter. In general the text line format is:
  1057.  
  1058. ['|'[<justification>]<length>'|']text text text...
  1059. <justification> and <length> have the same meaning as in the metastrings
  1060. formatting but with the addition of the line of text.
  1061.  
  1062. You can specify title, subtitle, text and bottom line contents.
  1063.  
  1064.  
  1065.                                       -16-                                      
  1066.  
  1067.  
  1068.  
  1069.  
  1070.                                                                                 
  1071.  
  1072.  
  1073. metastrings are valid. In text lines the user name can be obtained by
  1074. %toname% and other %to...% metastrings.
  1075.  
  1076. Once you have FULLY understood the usage of these commands you can then edit
  1077. the various fields to create stats screens which are unique to your system.
  1078.  
  1079. You can also alter the colors that Mom will use in the various screens it
  1080. creates. Simply step through the colors for the various parts of the screen
  1081. and select the ones that you like. BE CAREFUL NOT to select a background and
  1082. foreground color that are the same... i.e. Black on Black as this will cause
  1083. Black text on a Black background... In effect giving a blank screen when it
  1084. is viewed!
  1085.  
  1086. YOU MUST REMEMBER TO SAVE YOUR EDITED MOM.CNF FILE BY PRESSING 'F2' BEFORE
  1087. EXITING FROM MOMSETUP. IF YOU FAIL TO DO THIS NO CHANGES WILL BE MADE TO THE
  1088. MOM.CNF FILE AND YOU WILL NEED TO START AGAIN !!!  YOU HAVE BEEN WARNED !!
  1089.  
  1090. Phew!! That's it!!  All that is left now is to add Mom into your BBS batch
  1091. file.
  1092.  
  1093. I realize this may seem like a LOT of work, but it should only take 15 minutes
  1094. or so to go through all of the various setup menus and configure Mom to do
  1095. exactly what you want. As stated earlier, The setup program is the heart of 
  1096. Mom and it is certainly well worth the time taken to get it correct FIRST
  1097. time!
  1098.  
  1099.                                                                                 
  1100.  
  1101. ╒═════════════════════════════════════════════════════════════════════════════╕
  1102. │ Installing MOM into your BBS batch file ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1103. ╘═════════════════════════════════════════════════════════════════════════════╛
  1104.  
  1105.  Installing Mom into your BBS batch file is quite easy, just follow these steps:
  1106.  
  1107.   N.B.
  1108.   If you are upgrading from an earlier version, please read the section of
  1109.   this document about upgrading FIRST!!
  1110.                                        
  1111.        1. Create a directory on your hard drive and extract all the files
  1112.           from the distribution archive into this directory.
  1113.                                                   
  1114.            C:\MOM is recommended and is assumed to be the directory you
  1115.                   have created.
  1116.             
  1117.  
  1118.        2. Read the document file!! (okay I know you are already :-))
  1119.  
  1120.        3. Run MOMSETUP.EXE to configure Mom so that it sends the messages
  1121.           you require for your system. You should have done this already
  1122.           as explained in the previous chapters on configuring Mom. 
  1123.           The MOMSETUP program has a built in help system which will explain
  1124.           what is necessary in each field in some detail so you can easily
  1125.           configure Mom for your needs.
  1126.           Pressing function key F1 will cause a pop up help window to appear
  1127.           which will remind you of the information and format required by each
  1128.           field.
  1129.  
  1130.  
  1131.                                       -17-                                      
  1132.  
  1133.  
  1134.  
  1135.  
  1136.                                                                                 
  1137.  
  1138.  
  1139.  
  1140.         N.B.
  1141.           
  1142.           It is IMPORTANT that you should move through each part of the setup
  1143.           program in a careful and methodical way to ensure that you DO NOT
  1144.           miss anything thereby causing unnecessary problems for yourself later!
  1145.  
  1146.           If you are in any doubt, READ THE SECTIONS EXPLAINING HOW TO CONFIGURE
  1147.           MOM!
  1148.  
  1149.        4. Edit your BBS batch file so that it will run Mom after each user
  1150.           logs off your system. This is simply so that Mom can keep certain
  1151.           user stats up to date and send any messages required. It should be
  1152.           noted that *MOST* messages will ONLY be generated when Mom is run
  1153.           in your nightly event, i.e. Don't worry if a user uploads to your
  1154.           system and Mom doesn't post a thankyou message as soon as he logs
  1155.           off... The message will be posted in your midnight event!
  1156.     
  1157.        N.B. Mom requires the -U parameter when running after a user has
  1158.             logged off. This tells Mom to run in User just logged off mode
  1159.             which will keep Moms history and control files up to date.
  1160.  
  1161.  
  1162.            i.e.
  1163.             
  1164.              edit your batch file to include:
  1165.              
  1166.              <Your BBS batch file>
  1167.              <Error levels>
  1168.              Goto MOM
  1169.  
  1170.              :MOM 
  1171.              CD\MOM
  1172.              MOM -U
  1173.              Goto Start
  1174.              <batch file continues>
  1175.  
  1176.  
  1177.  
  1178.              As stated above, this MUST be in a section of your batch file
  1179.              that will be executed EVERY time a user logs off.
  1180.  
  1181.              Running Mom -U is VERY quick and will not unduly delay your
  1182.              BBS from re booting.
  1183.              Do NOT forget to use the -L switch if you wish Mom to create its
  1184.              log file in a different directory or use a different log file name.
  1185.              By default Mom will use the filename MOM.LOG and the current dir-
  1186.              ectory for its log file.
  1187.              You may also specify the -O switch if you prefer to use the 'Old'
  1188.              style headers on the screens Mom creates. Try running Mom with
  1189.              AND without the -O switch to see which you prefer.
  1190.              (see Command Line section of this document file for more info)
  1191.  
  1192.              
  1193.        5. Edit your BBS batch file so that Mom will run once daily without
  1194.           any parameters. It is suggested that you include this in your mid-
  1195.  
  1196.  
  1197.                                       -18-                                      
  1198.  
  1199.  
  1200.  
  1201.  
  1202.                                                                                 
  1203.  
  1204.  
  1205.           night event - you do have one, don't you?
  1206.  
  1207.  
  1208.  
  1209.            i.e. edit the part of your batch file that is executed in your
  1210.                 midnight event to include:
  1211.  
  1212.                <Your BBS batch file>
  1213.                <Midnight Event>
  1214.                CD\MOM
  1215.                MOM
  1216.                <batch file continues>
  1217.   
  1218.               
  1219.  
  1220.            This will allow Mom to send any messages it may need to your users
  1221.            and also send its daily and/or weekly reports and Ascii/Ansi screens
  1222.            if you have enabled them in your configuration.
  1223.            Do NOT forget to use the -L switch if you wish Mom to create its log
  1224.            file in a different directory or use a different log file name. For
  1225.            example MOM -Lc:\logs\mom.log. By default Mom will use the filename
  1226.            MOM.LOG and the current directory for its log file.
  1227.            As with running Mom between calls, you may also specify the -O switch
  1228.            if you prefer the 'Old' type headers on the screens produced by Mom.
  1229.            (see Command Line section of this document file for more info)          
  1230.  
  1231.            MOM requires approximately 80-90Kb of free memory to run!
  1232.  
  1233.  
  1234.  Thats all there is to it!! 
  1235.  
  1236.  Mom is now ready to take over all those boring messages that a busy Sysop needs
  1237.  to send on a regular basis......
  1238.  
  1239.  
  1240.        After configuring Mom to your needs and running it for the first time
  1241.        the following files will be created:
  1242.  
  1243.          MOM.CTL - Control file used by Mom. This will be placed in the
  1244.                    directory Mom was run from.
  1245.          MOM.HIS - History file used by Mom. This will be placed in the
  1246.                    directory Mom was run from.
  1247.          MOM.LOG - Log file of Mom's activity. This will be placed in the
  1248.                    directory Mom was run from, but you can specify the
  1249.                    directory of your choice by using the -L switch. Please
  1250.                    see the section of this document about command line
  1251.                    switches for more info.
  1252.  
  1253.  
  1254. ╒═════════════════════════════════════════════════════════════════════════════╕
  1255. │ MOM Command line switches/parameters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1256. ╘═════════════════════════════════════════════════════════════════════════════╛
  1257.  
  1258.  To make MOM as flexible as possible in its use, there are a number of command
  1259.  line switches you may use to instruct Mom to run differently from the 'Norm'
  1260.  
  1261.  
  1262.  
  1263.                                       -19-                                      
  1264.  
  1265.  
  1266.  
  1267.  
  1268.                                                                                 
  1269.  
  1270.  
  1271.  It should be noted however, that it is ONLY necessary to use these switches
  1272.  when you want Mom to do something different from it's normal routines. As
  1273.  explained in the chapter about installing Mom, it is normally ONLY necessary
  1274.  to run MOM after each user has logged off (i.e. MOM -U) and in your nightly
  1275.  event (MOM - without parameters! apart from perhaps -O and -L) Please read
  1276.  the section of this document which explains Mom's installation if you are
  1277.  unsure of the above!
  1278.  
  1279.  
  1280. Because of the HUNDREDS of different ways of using these command line switches
  1281. it is only possible to give a brief idea of their usage. The best way to get
  1282. to grips with them fully is to try them!
  1283.  
  1284.  To use these switches Mom expects them to be prefixed with either / or - 
  1285.  
  1286.  
  1287.  For example to use the ? switch so that Mom will display a short help file
  1288.  you would enter one of the following commands:
  1289.  
  1290.  
  1291.              MOM /?
  1292.          or  MOM -?
  1293.         
  1294.  
  1295.  
  1296.    ? or H        -    Display command line switches with a brief explanation
  1297.                       of their use.
  1298.  
  1299.  
  1300.    C             -    Specifies the use of a DIFFERENT configuration file for
  1301.                       Mom to use. The default is MOM.CNF
  1302.                       This could be used in a multi-line system so that Mom
  1303.                       will operate differently on different nodes.
  1304.  
  1305.                       format: -Cfilename.ext.
  1306.                       example: -Cnew.cfg will read new.cfg as config file.
  1307.  
  1308.  
  1309.    Anum          -    Force Mom to use a specified message board (num) to post
  1310.                       the message into. 'num' should be replaced by the number
  1311.                       of the required message board.
  1312.                       If this parameter is omitted MOM will use the board number
  1313.                       specified in MOM.CNF, or if that is not defined it will
  1314.                       default to message board 1.
  1315.  
  1316.  
  1317.  
  1318.    Ffilename.ext -    Use specified filename (filename.ext) as text file to
  1319.                       send as a message.
  1320.                       
  1321.                       format: -Ffilename.ext
  1322.                       example: -Fmessage.txt will insert the text in message.txt
  1323.                                into the message generated by Mom.
  1324.  
  1325.  
  1326.    T[*|$|#]xxx[,yyy...] Send message to....
  1327.  
  1328.  
  1329.                                       -20-                                      
  1330.  
  1331.  
  1332.  
  1333.  
  1334.                                                                                 
  1335.  
  1336.  
  1337.  
  1338.                       With the -T switch you have a LOT of options open to you.
  1339.  
  1340.                       The basic format is as shown above:
  1341.  
  1342.                       where *         = Read ALL user names directly from your
  1343.                                         user base.
  1344.                             $filename = name of file to use as input for user
  1345.                                         names.
  1346.                             #filename = name of file to use as export file. Mom
  1347.                                         will read the user names from your user
  1348.                                         base and output the names that match
  1349.                                         any conditions you have given to the
  1350.                                         export filename you have given. This
  1351.                                         can then be used by the -T$ option for
  1352.                                         input. Please note, you cannot use the
  1353.                                         '<' and '>' symbols as Dos will assume
  1354.                                         you are trying to redirect output!
  1355.                             xxx       = name of user to post message to
  1356.                             yyy,...   = conditions that must be met before
  1357.                                         the message is posted.
  1358.  
  1359.  
  1360.                       These options will be explained in greater detail in the
  1361.                       section of this document that explains the usage of the
  1362.                       various command line switches.
  1363.  
  1364.                       With the -T switch you can also instruct MOM to send
  1365.                       messages to a node number that you define.
  1366.                       The format of this feature is:
  1367.  
  1368.  
  1369.                       -T<User_Name>[@[Zone:][Net/][Node][.Point]]
  1370.  
  1371.                       examples:
  1372.                       @.11           -- your point 11
  1373.                       @123           -- node 123 in your net
  1374.                       @456/123       -- node 456/123 in your zone
  1375.                       @7:456/123     -- addr 7:456/123
  1376.                       @7:456/123.11  -- full 4D
  1377.                       @123.11        -- point 11 of node 123
  1378.  
  1379.  
  1380.  
  1381.    Ssubject      -    Send a message with the specified subject text (subject)
  1382.                       which will be inserted into the 'Subject' field of the
  1383.                       message.
  1384.                       As with the 'T' switch, all spaces should be replaced by
  1385.                       an '_' underscore (without the quotes)              
  1386.                       If this parameter is not supplied MOM will insert its own
  1387.                       default subject line into the message header.
  1388.  
  1389.  
  1390.  
  1391.    Buser_name    -    Tells Mom to use 'user_name' as the name of the message
  1392.                       sender. As with most of the other switches spaces should
  1393.                       be indicated by using an underscore character. The default
  1394.  
  1395.  
  1396.                                       -21-                                      
  1397.  
  1398.  
  1399.  
  1400.  
  1401.                                                                                 
  1402.  
  1403.  
  1404.                       is the name of the Sysop as defined in Mom.Cnf.
  1405.  
  1406.                       format: -Buser_name
  1407.                       example: -BEddy_Matthews
  1408.                                In this example, Mom would post the message you
  1409.                                tell it to using 'Eddy Matthews' as the name of
  1410.                                the sender.
  1411.  
  1412.  
  1413.  
  1414.    P             -    Post a message instead of normal run, by default Mom will
  1415.                       send the message to 'Sysop', but you can tell it to send
  1416.                       the message to anyone on your system by using the 'T' 
  1417.                       option. You also need to tell Mom which message to send by
  1418.                       using the 'F' option.
  1419.  
  1420.                  You also have the following options with the -P switch:
  1421.      
  1422.                       If you want to send a private msg, add 'P' after the '-P'
  1423.                       switch i.e. -PP.
  1424.  
  1425.                       When using the -P switch, you may also include any of the
  1426.                       following message attributes K(ill/sent), S(ent), C(rash),
  1427.                       H(old), R(equest Receipt), A(udit Request), (Ret)U(rn Rec-
  1428.                       eipt), D(irect), I(mmediate), L(ock), co(N)firmreq, E(rase
  1429.                       /sent) and T(runc/sent). Erase/sent and Trunc/sent are
  1430.                       valid only with FREQs
  1431.  
  1432.  
  1433.  
  1434.    U             -    Run in 'User logged off mode' this is required for Mom to
  1435.                       keep track of certain user and system details etc such as
  1436.                       the number of calls made by a user....
  1437.  
  1438.             N.B. This switch MUST be used in your BBS batch file, and Mom HAS 
  1439.                  to be run in this mode after EVERY user log off otherwise it
  1440.                  will not keep a correct track of user activity.
  1441.  
  1442.  
  1443.  
  1444.    D             -    Force Mom to run its normal 'Daily' procedures. Instead
  1445.                       of its normal run to produce daily reports etc.. This
  1446.                       option is NOT normally required as Mom will post it's
  1447.                       daily/weekly report messages automatically when it is
  1448.                       run in your midnight event. The switch is included only
  1449.                       for completeness
  1450.  
  1451.  
  1452.  
  1453.  
  1454.    W             -    As with the 'D' parameter, but this time it will force
  1455.                       Mom to run its 'Weekly' procedures. As with the 'D'
  1456.                       switch, this option is NOT required for normal usage
  1457.                       as Mom will send the weekly report automatically on the
  1458.                       day you have configured in Mom.Cnf when it runs in your
  1459.                       midnight event. The switch is included only for
  1460.  
  1461.  
  1462.                                       -22-                                      
  1463.  
  1464.  
  1465.  
  1466.  
  1467.                                                                                 
  1468.  
  1469.  
  1470.                       completeness.
  1471.  
  1472.  
  1473.  
  1474.  
  1475.    X              -   Executing MOM with the X switch will stop MOM from
  1476.                       appending its tag line to any messages it sends which
  1477.                       will make the messages even more user friendly since
  1478.                       users will then be unaware that the message has been
  1479.                       generated automatically. the X switch will ONLY work
  1480.                       if you have registered your copy of Mom!
  1481.  
  1482.  
  1483.    
  1484.    L                  Mom will normally generate a log file (Mom.Log) in the
  1485.                       directory from which MOM was executed, should you wish
  1486.                       MOM to use a different directory or a different file
  1487.                       name for its log file you will need to use the -L switch
  1488.                       when running the program.
  1489.  
  1490.                       i.e. MOM -LC:\LOGS\MOM.LOG
  1491.                            would tell Mom to place its log file in the C:\LOGS 
  1492.                            directory and to name the file MOM.LOG
  1493.                         
  1494.                            MOM -LC:\LOGS\RA.LOG
  1495.                            would tell Mom to place its log file in the C:\LOGS
  1496.                            directory and to name the file RA.LOG. If this file
  1497.                            already exists Mom will append to it, it will NOT
  1498.                            overwrite it. So you can instruct Mom to add its log
  1499.                            entries to a file that is created my some other prog,
  1500.                            RemoteAccess in this instance.
  1501.  
  1502.  
  1503.  
  1504.    O                  Instructs Mom to use the 'Old' style headers when gener-
  1505.                       ating the Ans/Ascii stats screens. Try running Mom with
  1506.                       AND without this switch to see which type you prefer.
  1507.  
  1508.  
  1509.  
  1510.    xyyy               Set metastring VARx to yyy (x = 0..9) Using this option
  1511.                       you can create your own metastrings for use in messages
  1512.                       generated by Mom. See the section which gives examples
  1513.                       of command line switch usage for more details.
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519. PLEASE NOTE!
  1520.  
  1521.  MOM will automatically send a message once a week to unregistered users asking
  1522.  them to consider registering the program and showing when the limited run time
  1523.  demo key will expire!
  1524.  
  1525.  Once this key expires (6 months from the date of the program release)
  1526.  
  1527.  
  1528.                                       -23-                                      
  1529.  
  1530.  
  1531.  
  1532.  
  1533.                                                                                 
  1534.  
  1535.  
  1536.  unregistered users will need to obtain the latest version of the program since
  1537.  it will NOT run after this key has expired. Users that feel they need more
  1538.  time to evaluate the program can obtain a demo key which will allow a further
  1539.  3 months use by contacting Eddy Matthews (2:252/51) by direct Netmail. Another
  1540.  demo key will be placed on 'Hold' for you to collect within 24 hours. Only
  1541.  ONE extra demo key will be supplied per user/node number and this key will
  1542.  expire 3 months after the date it is generated.
  1543.  
  1544.  Of course the preferred option would be for you to register the program!
  1545.  
  1546.  Now we will go through a few examples of possible command line options in 
  1547.  order to clarify them a little....
  1548.  
  1549.  
  1550.  
  1551. ╒═════════════════════════════════════════════════════════════════════════════╕
  1552. │ Examples of command line switch usage by MOM  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1553. ╘═════════════════════════════════════════════════════════════════════════════╛
  1554.  
  1555.  
  1556.  Mom will automatically send most messages once it is configured using momSetup
  1557.  and then installed into your BBS batch file without the need for any inter-
  1558.  vention from the sysop. But because Mom is so flexible in its usage, it can
  1559.  also do LOTS more!!
  1560.  
  1561.  It is almost impossible to include a list of ALL possible ways of using the
  1562.  various command line switches, so this is only a VERY quick list of SOME of
  1563.  the ways of using them. LOTS more combinations are possible, and it is up to
  1564.  you to play around with them. This is the ONLY way you will get used to the
  1565.  full flexibility of Mom. If Mom will not do something you require by using
  1566.  it's basic configuration as set up in MomSetup, you can usually force it to
  1567.  do what you require by using the command line switches. If you have difficulty
  1568.  getting Mom to do something you particularly want it to do, try contacting
  1569.  one of the many support sites to see if they can help. If it still proves to
  1570.  be impossible to do what you want, contact the program authors and they will
  1571.  endeavor to add a new feature if it is at all possible.
  1572.  
  1573.  Below are listed a few examples of command line switch options for Mom, and a
  1574.  brief description of their effect:
  1575.  
  1576.  
  1577. Example 1.
  1578.  
  1579.  
  1580.  MOM -A25 -Fhello.txt -TEddy_Matthews -SRules_on_%BoardName%
  1581.  
  1582.  This would cause Mom to post a message into board 25, and send the message
  1583.  text in file Hello.Txt. The message would be addressed to Eddy Matthews (note-
  1584.  the underscore between the first and last name!) and the subject of the message
  1585.  would be - Rules on %BoardName% (again note the underscore between the words-
  1586.  in the subject switch) the meta string %BoardName% would be replaced by your
  1587.  BBS name. See metastrings for a full list.
  1588.  
  1589.  
  1590. Example 2.
  1591.  
  1592.  
  1593.  
  1594.                                       -24-                                      
  1595.  
  1596.  
  1597.  
  1598.  
  1599.                                                                                 
  1600.  
  1601.  
  1602.  MOM -A10 -SPlease_support_%FirstSys%_and_upload! -Fupload.txt -TEddy_Matthews
  1603.  
  1604.  In this example, Mom would send the message contained in Upload.Txt to
  1605.  message board number 10. The username to send the message is specified by
  1606.  using the -T switch, in this case 'Eddy Matthews'. The message subject would
  1607.  be - Please support %FirstSys% and upload! the meta string %FirstSys% would
  1608.  be replaced by the Sysops first name as defined in your Mom configuration file.
  1609.  
  1610.  
  1611. Example 3.
  1612.    
  1613.  When using the T command line switch the following options are available to
  1614.  enable you to generate a message either to ALL users, or only to selected
  1615.  groups:
  1616.  
  1617.  -T*,A1             -- Send a message (which must be defined) to all users with
  1618.                        flag A1 set
  1619.  -TUser_Name        -- Send a message to User_Name. Any spaces in a users name
  1620.                        MUST be replaced by an '_' underscore character.
  1621.  -TUser_Name,A1     -- Will send msg to User_Name ONLY if flag A1 is set
  1622.  -T$d:\usr\users    -- Send msgs to users listed in the merge file d:\usr\users
  1623.                        i.e. send a message to every user listed in the merge
  1624.                        file 'users' This file can be manually created by you
  1625.                        and must be a plain ascii text file which contains ONE
  1626.                        user name on each line, OR you can get mom to create the
  1627.                        file for you by using the '#' command in conjunction with
  1628.                        the -T switch.... see next example.
  1629.  
  1630.                   i.e. John Smith
  1631.                        David Jones
  1632.                        Martin Adams
  1633.                        etc etc.
  1634.  
  1635.  
  1636.  -T#sec10,S10 -s%%toname%%,%%security%%
  1637.       will create file "sec10" of all users with sec level 10,
  1638.       consisting of their names and sec level separated by ',' i.e.
  1639.       Ivan Trifonoff,10
  1640.       Eddy Matthews,10 etc.
  1641.  
  1642.  -T#a1b2c3s5,a1,b2,c3,s5 -s%%toname%%,%%nocalls%%
  1643.       will export user names and number of calls of users with flags A1,
  1644.       B2 and C3 and sec level 5 to file a1b2c3s5
  1645.  
  1646.  The files created by the two examples above can then be used as 'Merge' files
  1647.  to post messages ONLY to certain user groups/securities/flags etc etc... The
  1648.  possible combinations and usage is only limited by your imagination!
  1649.  
  1650.  When using the T switch to 'Post' a message to a user or groups of users, you
  1651.  MUST tell MOM which message to send by using the F switch, see the command
  1652.  line switch section of this document file for more information.
  1653.  
  1654.  
  1655.  
  1656.  
  1657. ╒═════════════════════════════════════════════════════════════════════════════╕
  1658. │ Meta strings used by MOM ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1659. ╘═════════════════════════════════════════════════════════════════════════════╛
  1660.  
  1661.  
  1662.  
  1663.                                       -25-                                      
  1664.  
  1665.  
  1666.  
  1667.  
  1668.                                                                                 
  1669.  
  1670.  
  1671.  
  1672.  In the file SAMPLE.ZIP you will find some example text files for Mom to use.
  1673.  
  1674.  These files are examples only and you are free to edit them as you wish so 
  1675.  they are more compatible with your system. The files are plain ascii text,
  1676.  and are used by Mom to generate its various messages to users/sysop etc etc.
  1677.  
  1678.  If you examine these files you will see they contain lots of meta strings,
  1679.  such as %BoardName% , these strings are automatically read by Mom and are
  1680.  replaced by your systems/users details. In the example given (%BoardName%)
  1681.  Mom would insert the name of your BBS as entered in your BBS configuration
  1682.  file/s. See the text formatting commands in the section of this document
  1683.  entitled 'Configuring MOM - SCREENS' for information on how to get Mom to
  1684.  correctly format text either in a message, or in the various statistics
  1685.  screens Mom generates.
  1686.  
  1687.  
  1688.  
  1689.  The following is a list of all meta strings currently available in Mom. They
  1690.  are NOT case sensitive, so entering %bOArdnAMe% is just as valid as entering
  1691.  %BoardName% You may use any of these meta strings in any text files you create
  1692.  for use with Mom.
  1693.  
  1694. !! IMPORTANT !!
  1695. Metastrings MUST be enclosed by % signs in order to function, i.e. Program must
  1696. be entered as %Program% in any message you wish to use it in.... The same is
  1697. true for ALL other metastrings. Entering a metastring without enclosing it by %
  1698. signs will mean Mom will NOT translate the string concerned.
  1699.  
  1700. %Program%              - Program name (Message-O-Matic)
  1701. %Version%              - Version number of Mom
  1702. %KeyExpiryDate%        - Date that demo key will expire
  1703. %Day%                  - Day of month (1-31)
  1704. %Month%                - Month of year (1-12)
  1705. %StrDay%               - Day of week in short form (Mom,Tue,Wed etc)
  1706. %StrMonth%             - Month in short form (Jan,Feb,Mar etc)
  1707. %Year%                 - Year (1993,1994 etc)
  1708. %DayOfWeek%            - Day of week in full (Monday,Tuesday,Wednesday etc)
  1709. %BoardName%            - BBS name in full
  1710. %FirstSys%             - Sysop's first name
  1711. %LastSys%              - Sysop's surname
  1712. %SysName%              - Sysop's name in full
  1713. %TotalCalls%           - Total calls received by your system to date
  1714. %AreaName%             - Name of message area used to post current message
  1715. %AreaNumber%           - Message area number used for current message
  1716. %FirstTo%              - Users first name... Mom will read this from your
  1717.                          log file automatically, or you can force the message
  1718.                          to be sent to a particular user by using the -T command
  1719.                          line switch (see command line switches)
  1720. %LastTo%               - Users last name (surname)
  1721. %ToName%               - Users full name
  1722. %ToAddress%            - Full Netmail address of system you are sending this
  1723.                          message to
  1724. %ToZone%               - Zone of system you are sending message to
  1725. %ToNet%                - Net of system you are sending message to
  1726. %ToNode%               - Node of system you are sending this message to
  1727.  
  1728.  
  1729.                                       -26-                                      
  1730.  
  1731.  
  1732.  
  1733.  
  1734.                                                                                 
  1735.  
  1736.  
  1737. %ToPoint%              - Point of system you are sending this message to
  1738. %FirstFrom%            - First name of message sender (normally sysops name)
  1739. %LastFrom%             - Surname of message sender (normally sysops name)
  1740. %FromName%             - Full name of message sender
  1741. %FromAddress%          - Full network address of sending system
  1742. %FromZone%             - Zone of sending system
  1743. %FromNet%              - Net of sending system
  1744. %FromNode%             - Node of sending system
  1745. %FromPoint%            - Point of sending system
  1746. %UploadedFiles%        - Names of files uploaded by user
  1747. %NrUploadedFiles%      - Number of files uploaded by user
  1748. %SizeUploadedFiles%    - Size of files uploaded in bytes
  1749. %KbUploadedFiles%      - Size of files uploaded in Kb
  1750. %S%                    - Adds an 's' to the word 'File' if the user has uploaded
  1751.                          more than one file
  1752. %BadPasswords%         - List of passwords entered if a user is denied access
  1753.                          because he/she has exceeded the maximum number of
  1754.                          password attempts allowed by your system
  1755. %DriveSize%            - Shows the size of the specified drive in bytes. You
  1756.                          must tell Mom which drive by including the drive letter
  1757.                          enclosed by # (hash) signs embedded in the metastring.
  1758.                          For example %DriveSize#C#% would display the size of
  1759.                          drive 'C' in bytes, %DriveSize#D#% would show the size
  1760.                          of drive 'D' etc etc...
  1761. %KbDriveSize%          - Shows the size of the specified drive in Kb. Refer to
  1762.                          %DriveSize% to see how to specify the drive required.
  1763. %Free%                 - Shows the amount of free space available on the specified
  1764.                          drive in bytes. See %DriveSize% for info on specifying
  1765.                          the required drive
  1766. %KbFree%               - Shows the amount of free space available on the drive
  1767.                          in Kb. See %DriveSize% for info on how to specify the
  1768.                          required drive
  1769. %PFree%                - Shows the percentage of free space available on the drive
  1770.                          you specify. See %DriveSize% for info on how to specify
  1771.                          the drive you require
  1772. %Location%             - Users location as entered in his/her user record
  1773. %DataPhone%            - Users data phone number as entered in his/her user record
  1774. %VoicePhone%           - Users voice phone number as entered in his/her user
  1775.                          record
  1776. %LastTime%             - Last time the user was online
  1777. %LastDate%             - Date the user was last on your system
  1778. %NetCredit%            - Amount of netmail credit the user has left
  1779. %NetPending%           - Amount of Netmail pending for this user
  1780. %MsgsPosted%           - Number of messages posted by user
  1781. %Security%             - Security level for this user
  1782. %NoCalls%              - Number of calls made to your system by this user
  1783. %Uploads%              - The number of uploads made to your system by this user
  1784. %Downloads%            - The number of downloads made by this user
  1785. %UploadsK%             - Amount of uploads made by user in Kb
  1786. %DownloadsK%           - Amount of downloads made by user in Kb
  1787. %Handle%               - The users Handle
  1788. %Comment%              - Comment as stored in the user record
  1789. %FirstDate%            - Date of users first call to your system
  1790. %Birthdate%            - The users birthdate as stored in his user record
  1791. %Subdate%              - Date of users subscription expiry
  1792. %Password%             - Password of user as stored in the user record.
  1793.  
  1794.  
  1795.                                       -27-                                      
  1796.  
  1797.  
  1798.  
  1799.  
  1800.                                                                                 
  1801.  
  1802.  
  1803.                          N.B. Because of the CRC32 encryption used by RA 2.0g1
  1804.                          Mom will NOT be able to translate the suers password!
  1805.                          It will however work correctly with earlier versions
  1806.                          of RA and with other BBS systems
  1807. %Forwardee%            - Name of the forwardee for messages posted by this user
  1808. %DlUlRatio%            - Users upload/download ratio
  1809. %KbDlUlRatio%          - Users upload/download ratio in Kb
  1810. %TotalToday%           - Total number of messages posted by Mom today
  1811. %DailyReportToday%     - Number of daily report messages sent by Mom today
  1812. %WeeklyReportToday%    - Number of weekly report messages sent by Mom today
  1813. %WelcomeToday%         - Number of Welcome messages sent by Mom today
  1814. %ThankyouToday%        - Number of Thankyou messages sent by Mom today
  1815. %WatchdogToday%        - number of Watchdog messages sent by Mom today
  1816. %BirthdayToday%        - Number of birthday messages sent by Mom today
  1817. %CarrierDropToday%     - Number of Carrier Drop messages sent by Mom today
  1818. %KeywordToday%         - Number of Keyword messages sent by Mom today
  1819. %NthCallerToday%       - Number of Nth Caller messages sent by Mom today
  1820. %EveryNthCallToday%    - Number of Every Nth Call messages sent by Mom today
  1821. %TimesOnToday%         - Number of Times On messages sent by Mom today
  1822. %ExpiresToday%         - Number of subscription expiry messages sent by Mom
  1823.                          today
  1824. %SysopAwayToday%       - Number of Sysop Away messages sent by Mom today
  1825. %RegularPostToday%     - Number of Regular Post messages sent by Mom today
  1826. %InboundCallsToday%    - Number of Inbound mail calls received today
  1827. %OutgoingCallsToday%   - Number of Outbound mail calls made today
  1828. %HumanCallsToday%      - Number of BBS callers today
  1829. %MailSessionsToday%    - Number of completed mail sessions today
  1830. %FailedSessionsToday%  - Number of failed mail calls today
  1831. %NrReqFilesToday%      - Number of requested files today
  1832. %NrSentFilesToday%     - Number of files sent today (mail calls + file requests)
  1833. %SizeSentFilesToday%   - Size of files sent today in bytes
  1834. %NrRcvdFilesToday%     - Number of files received today
  1835. %SizeRcvdFilesToday%   - Size of files received today in bytes
  1836. %TotalThisWeek%        - Total number of messages posted by Mom this week
  1837. %DailyReportThisWeek%  - Number of daily reports sent by Mom this week
  1838. %WeeklyReportThisWeek% - Number of weekly reports sent by Mom this week
  1839. %WelcomeThisWeek%      - Number of Welcome messages sent by Mom this week
  1840. %ThankyouThisWeek%     - Number of Thankyou messages sent by Mom this week
  1841. %WatchdogThisWeek%     - Number of Watchdog messages sent by Mom this week
  1842. %BirthdayThisWeek%     - Number of Birthday messages sent by Mom this week
  1843. %CarrierDropThisWeek%  - Number of Carrier Drop messages sent by Mom this week
  1844. %KeywordThisWeek%      - Number of Keyword messages sent by Mom this week
  1845. %NthCallerThisWeek%    - Number of Nth Caller messages sent by Mom this week
  1846. %EveryNthCallThisWeek% - Number of Every Nth Call messages sent by Mom this week
  1847. %TimesOnThisWeek%      - Number of Times On messages sent by Mom this week
  1848. %ExpiresThisWeek%      - Number of Subscription expiry messages sent by Mom this
  1849.                          week
  1850. %SysopAwayThisWeek%    - Number of Sysop Away messages sent by Mom this week
  1851. %RegularPostThisWeek%  - Number of Regular Post messages sent by Mom this week
  1852. %InboundCallsThisWeek% - Number of Inbound mail calls received this week
  1853. %OutgoingCallsThisWeek%- Number of Outgoing mail calls made this week
  1854. %HumanCallsThisWeek%   - Number of BBS callers this week
  1855. %MailSessionsThisWeek% - Number of mail sessions completed this week
  1856. %FailedSessionsThisWeek% Number of Failed mail sessions this week
  1857. %NrReqFilesThisWeek%   - Number of files requested this week
  1858. %NrSentFilesThisWeek%  - Number of files sent this week
  1859.  
  1860.  
  1861.                                       -28-                                      
  1862.  
  1863.  
  1864.  
  1865.  
  1866.                                                                                 
  1867.  
  1868.  
  1869. %SizeSentFilesThisWeek%  Size of files sent this week in bytes
  1870. %NrRcvdFilesThisWeek%  - Number of files received this week
  1871. %SizeRcvdFilesThisWeek%- Size of files received this week in bytes
  1872. %Var0%                 - Set variable metastring 0. See below for details
  1873. %Var1%                 - Set variable metastring 1.
  1874. %Var2%                 - Set variable metastring 2.
  1875. %Var3%                 - Set variable metastring 3.
  1876. %Var4%                 - Set variable metastring 4.
  1877. %Var5%                 - Set variable metastring 5.
  1878. %Var6%                 - Set variable metastring 6.
  1879. %Var7%                 - Set variable metastring 7.
  1880. %Var8%                 - Set variable metastring 8.
  1881. %Var9%                 - Set variable metastring 9.
  1882.    N.B.
  1883.      You can use these 'variable' metastrings for setting your own strings in
  1884.      messages. They should be specified on the command line. e.g. running:
  1885.    
  1886.      MOM -1Hello -0Just_say -2and -3u_r -4welcome!
  1887.  
  1888.      and using: %var0% %var1% %var2% %var3% %var4% somewhere in your message
  1889.      will result in:
  1890.  
  1891.      Just say Hello and u r welcome!
  1892.      in the message text...
  1893.  
  1894. %AreaCount%            - Number of messages in the message board this message
  1895.                          was posted in
  1896. %LastLine%             - Last line used by user when logging onto system
  1897. %LastBaud%             - Baud rate of last call
  1898. %LastLogon%            - Time of last callers logon
  1899. %LastLogoff%           - time of last callers logoff
  1900.                                                                                 
  1901.  
  1902.  
  1903.   ╒═════════════════════════════════════════════════════════════════════════╕
  1904.   │▓▓▓ Bug reports, contacting the author ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1905.   ╘═════════════════════════════════════════════════════════════════════════╛
  1906.  
  1907.  Should you find any bugs, undocumented features (future enhancements :-) )
  1908.  or if something doesn't appear to work as it should :-( Please contact the
  1909.  author at the following address:
  1910.  
  1911.  
  1912.               To:         Ivan Trifonoff
  1913.               Netmail:    2:359/110@fidonet
  1914.               E-mail:     ivan@virbus.bg
  1915.                           itt@bgearn.bitnet
  1916.                           nikolov@bgearn.bitnet
  1917.                           itt%bgcict@atgbox.edvz.un1-linz.ac.at
  1918.               Snail mail: acad. George Bontchev street
  1919.                           block 8, room 104
  1920.                           Sofia 1113
  1921.                           Bulgaria
  1922.                           Europe
  1923.               Voice:      +359-2-719212
  1924.               Data:       +359-2-737483, 300-9600bps, V32, V42b
  1925.  
  1926.  
  1927.                                       -29-                                      
  1928.  
  1929.  
  1930.  
  1931.  
  1932.                                                                                 
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  Or alternatively contact:
  1939.                
  1940.               To:         Eddy Matthews
  1941.               Netmail:    2:252/51@fidonet
  1942.                           73:7441/101@RANet
  1943.               Snailmail:  32 Whitley Road
  1944.                           Thornaby
  1945.                           Cleveland
  1946.                           TS17 9HZ
  1947.                           England
  1948.               Voice:      +44-642-764245 (8am to 9pm GMT)
  1949.               Data:       +44-642-764245 (9pm to 8am GMT)
  1950.                           300-9600 bps, V32bis, V42bis (not HST)
  1951.  
  1952.  
  1953. Problems can also be referred to your countries registration site if you have
  1954. one. Please see the relevant Register.??? file for info. If you do not have a
  1955. registration site in your country, either choose the closest one to you, or
  1956. send your message to Eddy Matthews (2:252/52)
  1957.  
  1958.  Applications for registration of Mom should be sent to the registration site
  1959.  of your choice. Please see the various Register.??? files for info on the
  1960.  current registration sites available. If you are in any doubt about which
  1961.  site to use send your registration to InfoSoft BBS (2:252/51) - Address is
  1962.  included in the registration document.
  1963.  
  1964.  SEE PLANNED FUTURE DEVELOPMENTS FOR DETAILS OF FUTURE ENHANCEMENTS TO MOM'S
  1965.  SOFTWARE SUPPORT
  1966.  
  1967.  
  1968.   ╒═════════════════════════════════════════════════════════════════════════╕
  1969.   │▓▓▓ Planned Future Developments of MOM ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  1970.   ╘═════════════════════════════════════════════════════════════════════════╛
  1971.  
  1972.  
  1973.  We would like to develop MOM so that it supports most popular BBS and Front-End
  1974.  mailer software.
  1975.  
  1976.  To this end,we currently have plans to include support for QuickBBS and Binkley
  1977.  
  1978.  
  1979.  In order to develop these versions fully we will require beta testers that
  1980.  use the above mentioned software and would be grateful if any Sysops that are
  1981.  interested in MOM would contact us at one of the registration sites with 
  1982.  details of their software/hardware configurations so that these enhancements
  1983.  can be implemented.
  1984.  
  1985.  Anyone that wishes to become a beta tester for these future versions has to
  1986.  pay the normal registration fee, and link into a private beta text echo area
  1987.  (MOM_BETA). They will also be required to call one of the (increasing) number
  1988.  of support boards to obtain new beta releases of MOM on a weekly basis.
  1989.  
  1990.  With your support and help, MOM will develop into the BEST automatic message
  1991.  
  1992.  
  1993.                                       -30-                                      
  1994.  
  1995.  
  1996.  
  1997.  
  1998.                                                                                 
  1999.  
  2000.  
  2001.  utility there is for a whole range of BBS/Frontend mailer setups!
  2002.  
  2003.  Even if you do not run RemoteAccess/SuperBBS/ProBoardFrontDoor or D'Bridge,
  2004.  please consider supporting MOM so that with your help we can create newer
  2005.  versions that WILL support your chosen software.
  2006.  
  2007.  
  2008. ╒════════════════════════════════════════════════════════════════════════════╕
  2009. │ Beta test sites ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  2010. ╘════════════════════════════════════════════════════════════════════════════╛
  2011.  
  2012. The following is a list of registered beta testers for Mom who have aggreed
  2013. to act as support sites, this list is correct at the time of writing this
  2014. document. Should you have any problems with Mom, please feel free to contact
  2015. your nearest support site for help.
  2016.  
  2017.  
  2018. Juan J. Achutegui   * Polaris                    2:344/7    +34 (42) 281756
  2019. Tony Brookes        The Castle BBS               2:442/10   +44 (244) 548114
  2020. Paul Carroll        The Crypt BBS                2:250/412  +44 (602) 445307
  2021. Vince Coen          Air Applewood                2:440/103  +44 (279) 792300
  2022. Bob Corby           The Exchange BBS             2:258/54   +44 (91) 383-1358
  2023. Steve Deakin        The F-Stop BBS               2:442/606  +44 (222) 513047
  2024. Chris Elsden        The Wolf's Den               2:257/701  +44 (953) 453700
  2025. Bob Garbutt         Infotel                      2:252/206  +44 (737) 766027
  2026. Nigel Hardy         Arkham                       2:252/151  +44 (71) 738-5596
  2027. Graham Jenkins      D.S.B.                       2:440/23   +44 (795) 590170
  2028. Clive Jones         C.A.L.M. BBS                 5:7101/14  +27 (11) 900-1118
  2029. Mikael Larsson      Virus Help Centre            2:205/204  +46 (26) 275710
  2030. Glynn Littleton     Cape Fear BBS                1:3628/7   +1 (919) 458-7999
  2031. Eddy Matthews       InfoSoft BBS                 2:252/51   +44 (642) 764245
  2032. Eric McDowall       Raymond Fast Mail System     1:358/19   +1 (403) 752-3584
  2033. John Morrow         NIBBS                        2:258/79   +44 (662) 247291
  2034. Anders Naeslund     MakerBBS                     2:204/465  +46 (11) 125248
  2035. Joseph O. Oliveira  Vision BBS                   1:324/279  +1 (508) 670-0934
  2036. Araken Salamene     MPCBBS                       4:801/31   +55 (192) 526547
  2037. Iain Sherrit        Phantom BBS                  2:259/29   +44 (224) 709833
  2038. Steve Shooter       Ultimate BBS                 2:258/55   +44 (642) 565936
  2039. Graeme Slogrove     Fast! BBS                    5:7101/47  +27 (11) 706-1749
  2040. Ivan Trifonoff      Virus Busters BBS            2:359/110  +359 (2) 737484
  2041. Paul Urmston        The Music Studio             2:253/151  +44 (926) 407881
  2042. Simon Williams      York's Best Price            2:258/37   +44 (904) 679758
  2043. Mikael Winterkvist  Computer Security Center BBS 2:205/505  +46 (910) 52214
  2044.  
  2045.  
  2046. The beta testers are a great bunch of guys (and gals!... Hi Bonnie!) and will
  2047. certainly help you in any way they can. However, should they be unable to 
  2048. solve a particular problem they are all in regular contact with the program
  2049. authors and will normally be able to get an answer on any problem within a
  2050. few days.
  2051.  
  2052.  
  2053.  
  2054. ╒════════════════════════════════════════════════════════════════════════════╕
  2055. │ A few final words ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  2056. ╘════════════════════════════════════════════════════════════════════════════╛
  2057.  
  2058. We hope you find MOM to be a useful program, and are always willing to listen
  2059.  
  2060.  
  2061.                                       -31-                                      
  2062.  
  2063.  
  2064.  
  2065.  
  2066.                                                                                 
  2067.  
  2068.  
  2069. to any  ideas you may have  for improvements. If you have any  suggestions,
  2070. please contact one of the beta sites, leave a message in RA_UTIL or in the 
  2071. MOM_HELP echo (if it is available to you)
  2072.  
  2073. The MOM_HELP echo has only just been set up and any BBS that wishes to gain
  2074. access to it may do so by contacting Infotel BBS (2:252/206) or InfoSoft BBS
  2075. (2:252/51) and details of the nearest link will be given.... We are still
  2076. looking for kind souls to import this echo into various countries! <hint>
  2077.  
  2078.  
  2079.  
  2080.                --------========End Of File========--------
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.                                       -32-                                      
  2128.  
  2129.  
  2130.