home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RAMSV120.ZIP / RAMS.DOC < prev    next >
Text File  |  1996-03-24  |  95KB  |  2,277 lines
  1. **********************************************
  2.   * RemoteAccess Automated Message System v1.20 *
  3.     *           CopyRight 1995-96 by               *
  4.        *                INXS Software                *
  5.          *         (Eddy Matthews & Geoff Bassett)     *
  6.             **********************************************
  7.  
  8.  
  9.  
  10.     Announcing an ALL NEW automated message system for RemoteAccess BBS.
  11.  
  12.     This is the third official release of RAMS.. Please see the WhatsNew
  13.     file included in the archive for a list of new features/bug fixes.
  14.  
  15.     RemoteAccess Automated Message System  (RAMS)  is  a fully  automated
  16.     message posting utility that takes care of all the boring messages  a
  17.     busy Sysop needs to send to his users. It now supports both  RA v2.0x.
  18.     AND RA v2.5x.    It  has full support for both Hudson and JAM message
  19.     bases, as well as Local and/or Echo messages, and now Netmail support
  20.     in some of the message types.
  21.  
  22.     RAMS will automatically  send  Welcome  messages to new users,  thank
  23.     uploaders, warn those that drop carrier, send birthday messages, send
  24.     a message after X calls, send a message based on a keyword  or string
  25.     that YOU define, send regular messages such as BBS ads, send messages
  26.     on a certain date, and numerous others... Apart from sending messages
  27.     to the users,RAMS will also send reports of it's actions to the Sysop
  28.     and generate a detailed logfile that shows  any actions it has taken.
  29.     YOU decide what messages it sends...  If you don't want to warn users
  30.     that drop carrier, simply turn off that message...
  31.  
  32.     Carrier drop messages will  NOT  be sent to a user if they were in an
  33.     external program.So you can safely use RAMS even if you have a system
  34.     stuffed full of type 7 and type 15 doors.
  35.  
  36.     RAMS can upgrade users, or downgrade them based on what they do.  YOU
  37.     decide what it does, or indeed whether it does anything! You  can also
  38.     EXCLUDE certain users from getting messages if you want.
  39.  
  40.     The template files it uses for it's  messages  are  plain ascii  text
  41.     files that YOU can configure to suit YOUR system. It also has over 80
  42.     metastrings  that  you  can  use to  make the messages as flexible as
  43.     possible (example messages are included in the archive).
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                ---- Page 2 ----
  59.  
  60.  
  61.                              LEGAL DISCLAIMER
  62.                              ================
  63.  
  64.     This program is NOT free,  it is shareware.  Any use of this program
  65.     after an initial  30 day trial period requires you  to register your
  66.     copy with the author.   Details on how to register are given  at the
  67.     end of this document.  Unregistered distribution copies of  RAMS are
  68.     released  with an inbuilt 30  day run time after  which delays  will
  69.     occur when the program is run.......
  70.  
  71.     Please remember shareware programs  can  only continue to develop if
  72.     they have YOUR support,  failure to  register will ONLY  end in this
  73.     and other  shareware programs  being  abandoned  which in  turn will
  74.     mean you have a reduced choice of cheap well written programs.
  75.  
  76.     This program and it's  accompanying  documentation are guaranteed to
  77.     do nothing other than take up space on your drive.
  78.  
  79.     The authors and their agents  will not  accept any liability for any
  80.     consequential loss or  damage arising from  your use or inability to
  81.     use  RAMS  or any of  the information  provided,  including, but not
  82.     limited  to,  economic  or  financial loss,   damage  to  peripheral
  83.     equipment or products, loss of use, productivity or time.
  84.  
  85.     Whilst  every  effort has been  made to  ensure  its reliability and
  86.     functionality you use this  program entirely at your own risk and no
  87.     warranties of  any type are given, either expressed or implied.
  88.  
  89.     The program  and the associated documentation on disk may be  freely
  90.     distributed on the following conditions:=
  91.  
  92.           1)  No changes whatsoever are made to the program,
  93.               its documentation or any associated files.
  94.  
  95.           2)  Anyone  wishing to charge a fee for distributing
  96.               RAMS  must  have  the  written  consent  of  the
  97.               author.  No charge will be made for this consent
  98.               but  I need  to  know  who is distributing it so
  99.               that I can send out updates  -  Apply in writing
  100.               to the address at the end of this document.
  101.  
  102.  
  103.     NOTE - For the benefit of printing this document out the pages have
  104.            been formatted to 56 lines per page.
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                                 ---- Page 3 ----
  115.  
  116.    CONTENTS
  117.    --------                                                     page
  118.  
  119.    About RAMS   . . . . . . . . . . . . . . . . . . . . . . . . .  1
  120.  
  121.    Legal Disclaimer . . . . . . . . . . . . . . . . . . . . . . .  2
  122.  
  123.    Program description  . . . . . . . . . . . . . . . . . . . . .  4
  124.  
  125.    Whats in the archive . . . . . . . . . . . . . . . . . . . . .  6
  126.  
  127.    Message Types  . . . . . . . . . . . . . . . . . . . . . . . .  7
  128.  
  129.    Upgrading from previous versions . . . . . . . . . . . . . . .  12
  130.  
  131.    Installation   . . . . . . . . . . . . . . . . . . . . . . . .  12
  132.  
  133.    Getting Started  . . . . . . . . . . . . . . . . . . . . . . .  12
  134.  
  135.    The menu options . . . . . . . . . . . . . . . . . . . . . . .  14
  136.  
  137.    System setup . . . . . . . . . . . . . . . . . . . . . . . . .  16
  138.  
  139.    Message menu options . . . . . . . . . . . . . . . . . . . . .  17
  140.  
  141.    The Reports Menu . . . . . . . . . . . . . . . . . . . . . . .  21
  142.  
  143.    Echomail information . . . . . . . . . . . . . . . . . . . . .  22
  144.  
  145.    Netmail information  . . . . . . . . . . . . . . . . . . . . .  22
  146.  
  147.    Conditions & actions . . . . . . . . . . . . . . . . . . . . .  22
  148.  
  149.    The Message Template Editor  . . . . . . . . . . . . . . . . .  28
  150.  
  151.    Excluding users  . . . . . . . . . . . . . . . . . . . . . . .  28
  152.  
  153.    Installing RAMS into your BBS batchfile  . . . . . . . . . . .  29
  154.  
  155.    Multiline Systems  . . . . . . . . . . . . . . . . . . . . . .  30
  156.  
  157.    Metastrings used by RAMS . . . . . . . . . . . . . . . . . . .  32
  158.  
  159.    How to get the most out of RAMS  . . . . . . . . . . . . . . .  36
  160.  
  161.    Contacting the authors . . . . . . . . . . . . . . . . . . . .  39
  162.  
  163.    Future developement  . . . . . . . . . . . . . . . . . . . . .  40
  164.  
  165.    Credits  . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  166.  
  167.  
  168.  
  169.  
  170.                                 ---- Page 4 ----
  171.  
  172.                                   WHAT IS RAMS?
  173.                                   =============
  174.  
  175.     RemoteAccess Automated Message System, hereafter referred to as RAMS,
  176.     has been developed to be the number one automatic message system for
  177.     Sysops of RemoteAccess bulletin board systems.
  178.  
  179.     It will work with both Hudson and the JAM messagebase formats, and is
  180.     capable of posting both local and echomail messages.
  181.  
  182.     RAMS  will  fully automate all of those tedious messages that Sysops
  183.     need to post to users. It needs only a minimal setup to get it going
  184.     and can be up and running in a matter of minutes,  though to get the
  185.     best out of RAMS it is recommended that  you  take time to study all
  186.     of its many features in some detail.
  187.  
  188.     Much time and effort was put into the configuration utility for RAMS
  189.     in order to make the  program as easy to setup and  as user friendly
  190.     as possible. The setup utility has an extensive online help facility
  191.     to help  you through  the setup  stages  while you  are learning the
  192.     program.
  193.  
  194.     In addition RAMS will generate daily and weekly reports to the sysop
  195.     to inform them how many of which  type of messages  RAMS  has posted
  196.     for each day,along with a brief report on available hard drive space.
  197.     RAMS will generate a message to  the  sysop  for  every user message
  198.     that it sends, of course this feature can be disabled if you wish!
  199.  
  200.     RAMS can automatically send the following messages to your users:=
  201.  
  202.     -     Welcome to new users
  203.  
  204.     -     Thankyou for uploading
  205.  
  206.     -     Carrier Drop - send message to  users that drop carrier.  RAMS
  207.           will work correctly with MOST doors - type 7 and 15.
  208.           If it cannot decide if the user has dropped carrier,   because
  209.           they were in an  external program  it will  NOT post a carrier
  210.           drop msg.
  211.  
  212.     -     Watchdog Messages - post a message to a user if he/she exceeds
  213.           the number of  times he/she is allowed to attempt to enter the
  214.           correct password.  This message also lists  any passwords that
  215.           were tried!
  216.  
  217.     -     Send a message to users after  every so  many calls  he or she
  218.           has made to your system.  i.e.  send  a message after 10 calls
  219.           made by a user (Times On)
  220.  
  221.     -     KeyWord messages - This is a VERY powerful message type  which
  222.           will tell RAMS to search RA's log file for a keyword or phrase
  223.           you have defined and send the appropriate message.
  224.           (fully configurable)
  225.  
  226.                                 ---- Page 5 ----
  227.  
  228.  cont...
  229.  
  230.     -     Every N'th call made by user  - Send a msg. after EVERY Nth call
  231.           .. i.e.,  set it to 10 and Rams will post a msg. to the user after
  232.           EVERY 10 calls... 10,20,30 calls etc.. etc..
  233.           (fully configurable)
  234.  
  235.     -     Happy Birthday (automatically generated on users birthday)
  236.  
  237.     -     Subscription expiry - with this type of message it is possible
  238.           to send messages warning users  of their imminent subscription
  239.           expiry,  and also  to  optionally downgrade their  access once
  240.           their subscription has expired.  Rams can also be configured to
  241.           reset the Upload/Download counters if required.
  242.           (configurable for # of days before expiry to send message)
  243.  
  244.     In addition  to  those above,  RAMS  can  also  send messages to the
  245.     Sysop:=
  246.  
  247.     -     Daily Report - details  of RAMS's  daily  activities  with  an
  248.           optional report on hard drive space.
  249.  
  250.     -     Weekly report - as above, but weekly stats
  251.  
  252.     RAMS  will  also send  and  Echomail/local messages on behalf of the
  253.     Sysop:-
  254.  
  255.     -     The Regular Post type of message allows you to fully  automate
  256.           those regular  echomail  messages  such  as BBS advertisements,
  257.           echo rules etc. This type of message is sent every X days.
  258.  
  259.     -     Monthly post - as with the Regular post, but on a specific day
  260.           each month.
  261.  
  262.     -     Yearly post - Send  Xmas  and New Year greetings automatically
  263.           to your users or other systems.   YOU decide what date to send
  264.           the message, and what is contained in the message text.
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.                                 ---- Page 6 ----
  283.  
  284.                               IMPORTANT NOTE!
  285.                               ===============
  286.     When  RAMS  posts  these  messages it is  also  capable  of  changing
  287.     a users settings, ie Seclevel, Flags, Group etc.  and it  can also be
  288.     setup  so  that messages  will  ONLY  be sent if a user meets certain
  289.     criteria defined by you i.e. Security level - Min and Maximum.
  290.     When posting a message to a user, RAMS will use the users REAL name.
  291.  
  292.     These features are all described in detail later in this document.
  293.     NOTE.
  294.  
  295.  
  296.                                    FILES
  297.                                    =====
  298.     You Should find the following files inside the distribution archive:
  299.  
  300.  
  301.          UPDATE.EXE    - Program to update previous releases of Rams
  302.          RAMS.EXE      - The main executable file
  303.          RAMSCFG.EXE   - The setup program used to configure RAMS
  304.          RAMS.DOC      - Documentation for RAMS (what your reading now!)
  305.          REGISTER.NFO  - Registration document for all countries.
  306.          SAMPLE.ZIP    - Sample Message files for use with RAMS
  307.                          (see the section on meta strings for more info)
  308.                          It is recommended that you unpack  this  archive
  309.                          into a  separate directory   off  the  main Rams
  310.                          directory so as not to  clutter it  up  with all
  311.                          the msg. template files.
  312.          EXCLUDE.CTL   - An example EXCLUDE control file for Rams. Please
  313.                          see the file for a more detailed explanation of
  314.                          it's use. It's heavily commented. Rams will run
  315.                          without this file, but it WILL generate an error
  316.                          message. This will NOT affect the running of Rams.
  317.          WHATSNEW.TXT  - A list of the new features/bug fixes since the
  318.                          last release of Rams. If you are already using
  319.                          Rams you should read this file.
  320.  
  321.          NOTE..
  322.          Rams  (and it's associated configuration program)  will generate
  323.          the following files when it is run.
  324.  
  325.          RAMS.DAT - Used to store message counters,  last caller info and
  326.                     other data used by Rams.
  327.          RAMS.CFG - The  main config file  used  by Rams  to tell it what
  328.                     messages are active, path to logfiles,  message bases
  329.                     to use
  330.  
  331.      !! YOU MUST USE RAMSCFG.EXE TO EDIT THIS FILE TO SUIT YOUR SYSTEM !!
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.                                 ---- Page 7 ----
  339.  
  340.     MESSAGE TYPES - a basic outline.
  341.     -------------------------------
  342.  
  343.     This is just a quick outline of the message types available to you,
  344.     more detailed descriptions of  what is required for each message type
  345.     can be got  by  referring to  the section of the docs dealing with the
  346.     various  'fields'  for  each  message.   There  you  will  find  more
  347.     information on what is required for each 'field' in RamsCfg.
  348.  
  349.     Rams currently  has a  total of 14 message types which it can post to
  350.     users  depending on  what  actions they  have  taken while  they were
  351.     online.
  352.     YOU  decide  which messages are  sent by toggling the Active/Disabled
  353.     switch for each msg. in the RamsCfg program.  If The message is set as
  354.     Disabled, it will NOT be sent to any users.
  355.  
  356.     If you run RamsCfg you will see that  the messages are split into two
  357.     basic types,  'Normal' and 'Midnight'. 'Normal' messages will be sent
  358.     as soon as the user has logged off your system,   'Midnight' messages
  359.     (as the name suggests) will  ONLY  be posted on the first run of Rams
  360.     after midnight. Rams will automatically detect the date rollover and
  361.     send any 'Midnight' messages that are necessary  the first time it is
  362.     executed after midnight.  You DO NOT need to have a separate midnight
  363.     event for Rams.
  364.  
  365.     Rams has both 'User' and 'Sysop' messages. As the names suggest,'User'
  366.     MSG's are sent to the user, and 'Sysop' messages are sent to the Sysop.
  367.     'User' msgs are posted  (if enabled)  to the  user if they do certain
  368.     things that are assigned  to the message,   i.e.. Any new users will be
  369.     sent a 'Welcome' message to welcome them to your system.   The 'Sysop'
  370.     messages are basically designed to be reports that  Rams will send to
  371.     you telling you what it has done.  There is no need to enable  'Sysop'
  372.     messages if you don't want them, as Rams keeps a full history of it's
  373.     actions in it's logfile.
  374.  
  375.     There are also nearly ONE HUNDRED metastrings that you can use in the
  376.     messages.
  377.     They are basically used  to  personalise any messages that are posted
  378.     by Rams,  and  will  allow  you to  include  user data in the message.
  379.     Things such as the user name,  date of birth,  age, the date and time
  380.     the msg. was sent etc. etc..  They  are  described in  MUCH more detail
  381.     elsewhere in the docs,and an idea of how they are used can be gleaned
  382.     by referring to the example message templates supplied in  the release
  383.     archive.
  384.  
  385.     All of the messages types in RAMS are 'Multi' style messages.
  386.     By 'Multi',we mean you can setup MULTIPLE messages and therefore have
  387.     the  ability to  send a  different msg. to your users based  on their
  388.     security level, group, sex, language, and/or age.   Bear in mind that
  389.     Rams will post EVERY message that the user meets the 'Conditions' for,
  390.     so be careful when setting up the message conditions if you are using
  391.     more than msg of a type.
  392.     The 'Conditions' are described in more detail elsewhere in these docs.
  393.  
  394.                                 ---- Page 8 ----
  395.  
  396.     NORMAL MESSAGES
  397.     ---------------
  398.     These messages are sent as soon as the user logs off your system.
  399.  
  400.  
  401.     WELCOME
  402.     --------
  403.     This message  (If activated)  will be sent to any  NEW users to  your
  404.     system.  It is designed to  'Welcome' new users to your BBS.  It will
  405.     only be posted ONCE to any NEW users.This message is your opportunity
  406.     to say 'Hi' and let users know about your setup etc.
  407.  
  408.  
  409.     UPLOAD
  410.     ------
  411.     This is posted to anyone that 'Uploads' any files to your system.  It
  412.     will send a 'Thankyou' message to them. It will NOT send a message if
  413.     the upload was a 'File attach'  but ONLY if it was a normal upload to
  414.     one of your file areas.  A quick 'Thankyou' message can do wonders at
  415.     getting users to upload! :-)
  416.     Please note,  that  this  feature may  not work  if you  are using an
  417.     external file manager, but it has been tested with Derek Bryant's FLM
  418.     program and works perfectly with  that providing that FLM writes it's
  419.     log to RA's logfile.
  420.  
  421.  
  422.     WATCHDOG
  423.     --------
  424.     This message will be sent if the user EXCEEDS the number of passwords
  425.     allowed on your system. It can be setup to include the passwords that
  426.     were tried and is  designed to  warn  users of  possible  attempts by
  427.     someone else to gain access to their account.   If you  decide to use
  428.     this option, please ensure you disable RA's internal watchdog message
  429.     or you will get duplicates!
  430.  
  431.  
  432.     CARRIER DROP
  433.     ------------
  434.     Basically this message will be sent if the user Drops Carrier without
  435.     logging off your system correctly.
  436.     Rams will ONLY normally  send a  carrier drop message if the user was
  437.     in RA when they dropped carrier.   If  they were  in an external door
  438.     program (either type 7 OR type 15) it will  simply report that it was
  439.     'Unable to determine' what happened,   and NO message will be sent...
  440.     Therefore you can SAFELY use RAMS  even  on a  system that is stuffed
  441.     full of online doors (games, mail doors, time banks etc.).
  442.  
  443.     There is  also the  facility to specify a 'List' of doors that DO NOT
  444.     allow a user to logoff.   If a  door program DOES NOT allow a user to
  445.     logoff from within it,  you  can enter and part of the 'DOS shell' or
  446.     'Exit at errorlevel' string that is  written to  RA's  log  into this
  447.  
  448.  
  449.  
  450.                                 ---- Page 9 ----
  451.  
  452.  cont....
  453.     'List' and Rams WILL  then  send  a carrier  drop message even if the
  454.     user was in that particular door. Please note, this is ONLY for doors
  455.     that DO NOT allow a user to legitimately logoff from within them!
  456.     Using  it  for  a door  that  users  can  logoff  from (Blue Wave for
  457.     example)  WILL cause  problems as  Rams WILL then send a carrier drop
  458.     message even if the user has logged off correctly.
  459.  
  460.  
  461.     TIMES ON
  462.     --------
  463.     This message is sent after the user has called your system 'X' times.
  464.     i.e.. if you set it for 10 it will send the user a message after he/she
  465.     has made a TOTAL of 10 calls to your system,   if  you set it for 250
  466.     it will send a message after the user has made a TOTAL of 250 calls.
  467.  
  468.     Again, this is a 'Multi' style message,  so  you  can  setup up to 10
  469.     different 'Times On' messages all with different values if you wish.
  470.     'Multi' messages are described  in more detail in  the 'Carrier Drop'
  471.     message description and elsewhere in this doc file.
  472.  
  473.     KEYWORD
  474.     -------
  475.     This is perhaps one  of the most  flexible message types available in
  476.     Rams.   With it,  YOU can specify a string from your RA logfile,  and
  477.     Rams will post a message IF it  finds that  particular string in RA's
  478.     log after the user has logged off your system.
  479.     Because  this message  can  be  used  for almost  any  purpose  it is
  480.     impossible for  us  to supply a  generic message template file for it.
  481.     But to give you some  idea of how it could be used, you could enter a
  482.     string of 'BLUEWAVE.BAT' (without the quotes!) and, assuming the Blue
  483.     Wave mail door was called up  from  a batchfile  called  BLUEWAVE.BAT
  484.     Rams would send the user a message if he/she entered that door... You
  485.     could then write a message template file  saying  'Why  not  become a
  486.     point off ???? BBS?'. That's only a suggestion to give you an idea of
  487.     just how flexible this message can be....   YOU decide what string to
  488.     search for AND what message to send if it's found.   Please note that
  489.     Rams will ONLY generate  a message  based on the FIRST  match to  the
  490.     string you specify..If the string isn't found NO message will be sent.
  491.  
  492.  
  493.     Nth CALL
  494.     --------
  495.     This message is similar to the  'Times On' message,  except  that the
  496.     value you specify will cause a message to be sent by Rams after EVERY
  497.     'X' calls.  So if you set it up to use a value of 6,  Rams would send
  498.     the user a message after he/she had called your system 6 times,  then
  499.     again after 12 calls, again after 18 calls etc. etc...
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.                                 ---- Page 10 ----
  507.  
  508.     MIDNIGHT MESSAGES
  509.     -----------------
  510.     All 'Midnight'  messages are sent ONCE per day on the first run after
  511.     midnight.   Although Rams will do this without your having to setup a
  512.     separate midnight event,  it is still recommended that you set one up
  513.     to ensure that Rams does it's  daily procedures.  If  you  had  a day
  514.     without any calls to your system (unlikely), Rams may miss some daily
  515.     messages it needs to send.
  516.  
  517.  
  518.     DAILY REPORT
  519.     ------------
  520.     This is a message to the Sysop ONLY.  It  will give  a  report of the
  521.     previous days activity by Rams,  listing the quantity of each type of
  522.     message it has sent.   The message is basically there so you can keep
  523.     an eye on Rams's activity It can also give a listing of free and used
  524.     drivespace on your system. Useful in case your away from your machine
  525.     for a while. See the example DAYREPT.MSG message template.
  526.  
  527.  
  528.     WEEKLY REPORT
  529.     -------------
  530.     As with the Daily Report,  this message is to the Sysop ONLY. It will
  531.     give a list of all messages posted in the previous week by Rams.   It
  532.     can also give a listing of  drivespace  used and free  on your system
  533.     if you wish. See the example WEEKRPT.MSG  message  template  for more
  534.     info.
  535.  
  536.  
  537.     HAPPY BIRTHDAY
  538.     --------------
  539.     Here Rams will send every  user  a  birthday  message if  it is their
  540.     birthday on that particular day.  A nice touch that helps keep you in
  541.     high esteem with your callers.   Rams  will post  ONE message to each
  542.     user on their birthday,  so it may  send quite a few on a busy system.
  543.     However it  will  only send  ONE  Sysop report  message  if  they are
  544.     enabled,  which can list ALL the users it has sent birthday  messages
  545.     to that day.   See the USERBDAY.MSG and SYSBDAY.MSG message templates
  546.     for an idea of what you can do with these messages.
  547.  
  548.  
  549.     REGULAR POST
  550.     ------------
  551.     Another of the 'Multi' style  messages available  in  Rams -  See the
  552.     Carrier Drop message for more info on 'Multi' messages.
  553.  
  554.     Here you can setup a message that will be posted EVERY 'X' days... If
  555.     you set it to a value of 10 for example,  it  will  post that message
  556.     EVERY 10 days. You have a maximum of 10 Regular Post messages you can
  557.     setup for various things.   This  would be ideal for those boring old
  558.     'BBS Advert' style messages,or for announcing the 'Rules' for an echo
  559.     area etc. etc.
  560.  
  561.  
  562.                                 ---- Page 11 ----
  563.  
  564.  cont...
  565.     This message also allows you to specify a 'Post to' name...  here you
  566.     can enter 'All' or  a 'User Name'  (Without the quotes!),  or you can
  567.     even use the '@ALL' macro  (as in RA)  and  Rams  will  then  post an
  568.     individual message to EVERY user  that satisfies the  'Conditions' of
  569.     the message. Please note, setting this msg. to  use the  '@ALL'  macro
  570.     (Without the quotes!) can produce a LOT of messages  if  most of your
  571.     users meet the conditions assigned to it, it may also take some  time
  572.     to complete!
  573.  
  574.  
  575.     MONTHLY POST
  576.     ------------
  577.     Exactly the same as the 'Regular Post' message, except that Rams will
  578.     post the message on the date of the month you have specified.  If you
  579.     give it a value of 15 for example, Rams will post that message on the
  580.     15th of EVERY month, i.e. 15th January, 15th February,  15th  March etc.
  581.     etc...
  582.     As with the 'Regular Post' messages you can also use the '@ALL' macro
  583.     in this message type. See Regular Post messages for more info.
  584.  
  585.  
  586.     YEARLY POST
  587.     -----------
  588.     Exactly the same as the 'Regular Post' messages,   except  that  this
  589.     time you have to specify a date and month as values for the message.
  590.     For example,  if you set  it to 15  for the day,  and 7 for the month,
  591.     Rams would post the message on the 15th of July EVERY year... As with
  592.     all the other 'Multi' style messages you can  setup  a  total  of ten
  593.     Yearly Post messages each  with a different date,  or  with  the same
  594.     date but different 'Conditions'. So you can easily setup a message to
  595.     be posted on 25th December  to  wish all your users 'Happy Christmas'
  596.     etc. etc.
  597.     As with the  'Regular Post' messages,  you  can also  use the  '@ALL'
  598.     macro in this message type. See Regular Post messages for more info.
  599.  
  600.  
  601.     SUBSCRIPTION
  602.     ------------
  603.     This message type allows  you to warn  your  subscribers  when  their
  604.     subscription is due.   You can specify  a number of days BEFORE their
  605.     subs expire for Rams to send them a message.    So if you entered 30,
  606.     Rams would send them a message 30 days BEFORE their subscription  was
  607.     due...   Again  you have  a total of  10  messages  so you  can setup
  608.     different messages for different security levels, or post one message
  609.     30 days before their subs expire and another 7 days before etc. etc..
  610.     There is an option in the actions menu  to reset the  upload/download
  611.     counters back to "new user" defaults(as configured is raconfig) which
  612.     you can set for the user's expiry message,   by  doing this  you will
  613.     restore their account back to normal status.
  614.     As with  ALL  midnight messages,     Rams  will  post  any  necessary
  615.     subscription msgs automatically in it's daily procedures...
  616.  
  617.  
  618.                                 ---- Page 12 ----
  619.  
  620.  cont...
  621.  
  622.     Don't forget,  if your system  should be down for a few days,  or  it
  623.     misses a midnight event and Rams is not run EVERY day,  Rams will NOT
  624.     post any messages it may have missed.  It is up to YOU to ensure that
  625.     Rams is run  AT LEAST  once per day  so it  can  post  any  necessary
  626.     midnight messages.
  627.  
  628.  
  629.  
  630.                       UPGRADING FROM PREVIOUS VERSIONS
  631.                       ================================
  632.  
  633.     If you are already using Rams v1.10, or v1.11 you DO NOT need to redo
  634.     all the setup.   Simply copy the RAMS.EXE, RAMSCFG.EXE and UPDATE.EXE
  635.     into your Rams directory (overwriting the existing files)
  636.     Then change to your Rams directory and run UPDATE.EXE.
  637.  
  638.     This will update your existing configuration, and DELETE the RAMS.DAT
  639.     file. Rams will recreate the Dat file the first time it is run, but
  640.     you should note that this will cause all message counters (used in-
  641.     the daily and weekly reports) to be zeroed.
  642.  
  643.     You should take a look through the config program after doing this as
  644.     new features - mainly to do with 'Conditions/Actions' but also now ALL
  645.     of the messages are "Multi", Regular, Monthly, and Yearly messages now
  646.     have Netmail support in this version.You DO NOT need to setup anything
  647.     as far as these new features are concerned,    they will by default be
  648.     setup to "neutral" values,but you should take the time to look at them
  649.     as they can GREATLY enhance the flexibility of Rams.
  650.  
  651.  
  652.  
  653.                                  INSTALLATION
  654.                                  ============
  655.  
  656.     Installation of RAMS could not be easier,  Unpack the main files into
  657.     a directory (C:\RAMS is the suggested directory).    Make a directory
  658.     to hold your message templates and unpack the SAMPLE.ZIP  into  that,
  659.     (the suggested directory is C:\RAMS\TEMPLATE).
  660.     Read the section entitled "Getting Started"  and  then  run the file
  661.     RAMSCFG.EXE to configure the program.
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                 ---- 13 ----
  675.  
  676.                                GETTING STARTED
  677.                                ===============
  678.  
  679.     Before  configuring  RAMS  you will  need to  know a couple of basic
  680.     things about YOUR system:-
  681.  
  682.     1/. - The format and details of your Sysop message base(s).
  683.  
  684.     2/. - The format and details of User and local/echo message bases(s).
  685.  
  686.     That's it, as simple as that!!
  687.  
  688.     Ok,having unpacked your files into the relevant directories you will
  689.     now need to setup the "System" section of the configuration.
  690.     Make sure that RAMSCFG.EXE and RAMS.EXE are installed into the  SAME
  691.     directory otherwise RAMS will not be able to read it's configuration
  692.     file once it is created.
  693.     Run the file RAMSCFG.EXE,  press  either  F10 and move the highlight
  694.     bar to "System", OR, just press Alt-S, then press ENTER.
  695.     You have then got two options - System or MSG's Setup...
  696.     Press  Enter on  the System option.   You  are  now presented with a
  697.     screen with several input boxes for Sysop Name,   System Name etc...
  698.     You will note that RAMSCFG has placed  you directly  in the field to
  699.     enter the sysop's name,just type in your name and the input box will
  700.     clear of the default text for you.   The  input routines in RAMS all
  701.     work the same way, type to edit, Tab or Enter to Skip,  and Space to
  702.     toggle the multi - choice options.
  703.     Having entered your name by pressing Enter this will be saved and you
  704.     are in the system name entry field, all these entry fields work in the
  705.     same way.
  706.     Having setup the five fields in  the system  menu  you need to  press
  707.     escape to close the window,  select MSG's setup and press enter.  This
  708.     is the default message setup, in other words if you forget to specify
  709.     a message  area for  a  particular  message then RAMS will default to
  710.     these areas.
  711.     Use space to toggle between  Jam/Hudson  and then press enter,  enter
  712.     the msgs base number (Hudson) or the message base path/filename (JAM),
  713.     press enter and you are moved to the  User section of the menu  which
  714.     is identical.
  715.  
  716.     Having completed that press Escape to exit the menu,then use the left
  717.     and  right arrow keys to select the message menu  you require,  setup
  718.     the required messages,(full details can be found in the Message Setup
  719.     section),  then press Alt-X to  exit the setup program,  you  will be
  720.     prompted to save your configuration, choose Yes and your ready to run
  721.     Rams for the first time!
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                 ---- 14 ----
  731.  
  732.                               THE MENU OPTIONS
  733.                               ================
  734.  
  735.     There are many menu  options in RAMSCFG, They are very simple to use,
  736.     an in - depth guide to these options now follows:=
  737.  
  738.     MAIN SCREEN
  739.     -----------
  740.     Options are as follows:-
  741.  
  742.     =        -  About RAMS,  this  simply pops a box telling you who the
  743.                 authors are and what the program is called!
  744.  
  745.     System   -  This is the only part of the program that HAS to be setup.
  746.                 It is in this section where you will enter your name, the
  747.                 System name, Logging options, and set the default message
  748.                 bases.
  749.                 PLEASE NOTE! You CANNOT access ANY of the other menus until
  750.                 you have setup the System menu.
  751.  
  752.     Normal   -  Normal message types.  A  NORMAL message type is one that
  753.                 is sent when RAMS is run  after  a caller has been on the
  754.                 BBS.   These  messages include  Welcome messages,  Upload
  755.                 messages, Carrier drop messages, and more..
  756.  
  757.     Midnight -  Midnight message types.   A  MIDNIGHT message type is one
  758.                 that is sent the first time RAMS  is  run AFTER midnight.
  759.                 There  are   no  command  line  parameters  or   external
  760.                 utilities required with RAMS,  RAMS  checks  the time and
  761.                 date when it is run and performs it's  "daily or midnight"
  762.                 events when they are required. Midnight messages for this
  763.                 reason are messages that require to be posted on a daily,
  764.                 or greater timescale and include messages such as Regular
  765.                 post, Monthly post, Subs expiry and much more.  Also from
  766.                 this menu you can setup the Daily and Weekly reports.
  767.  
  768.     Reports  -  New in version 1.2 RAMS can now generate text based report
  769.                 files of it's configuration.       This may be handy for a
  770.                 reference or to assist you in setting up. Rams will prompt
  771.                 you for the filepath/name to write to,    and  also if you
  772.                 require the report to include ALL or just  ACTIVE  message
  773.                 information.
  774.  
  775.     Help     -  RAMSCFG has an extensive online help facility which  will
  776.                 take you to the relevant section of this document file,so
  777.                 as you see, there is no having to close the program  down
  778.                 if you want to refer to the docs, just press F1 from just
  779.                 about anywhere in the program.
  780.                 The help file viewer supports the following commands:=
  781.  
  782.                 PgDn      -   Down a page
  783.  
  784.                 PgUp      -   Up a page
  785.  
  786.                                 ---- 15 ----
  787.    cont...
  788.  
  789.                 Home      -   Go to the start of the document
  790.  
  791.                 End       -   Go to the end of the document
  792.  
  793.                 Up & Down Arrow keys give full scrolling.
  794.  
  795.  
  796.     Along the bottom of the screen
  797.     ------------------------------
  798.     F1       -  Brings  up  the  help  from anywhere  in the program (see
  799.                 above)
  800.  
  801.     Alt - X  -  Exit the program. You are prompted upon exit to save your
  802.                 configuration.
  803.                 NOTE:=
  804.                 It is ONLY at this point that  any  changes you have made
  805.                 will be written to the configuration file!!!
  806.  
  807.     F2       -  Save.  Exactly what it says...SAVE the data,  this option
  808.                 will overwrite your  configuration  file  WITHOUT warning
  809.                 and is more for piece of mind.ie. If you are worried that
  810.                 the system may lockup or crash for some reason then  this
  811.                 will effect a data save.
  812.  
  813.     F10      -  Activates the top menu bar. Once activated press left and
  814.                 right arrow keys to highlight the option you require, and
  815.                 then enter to select that option.
  816.  
  817.     Escape   -  Escape will always close the menus one stage,  back down
  818.                 as far as the opening screen,where upon Alt - X will exit.
  819.  
  820.  
  821.     THE SYSTEM MENU
  822.     ---------------
  823.     System Setup   -  This is compulsory!   In  this menu is  the section
  824.                       where you enter the things RAMS MUST  know about in
  825.                       order to function.
  826.                       From within this menu you will  enter  your name as
  827.                       you wish RAMS to know it,  your  system name as you
  828.                       wish RAMS to know it. You will need to confirm  the
  829.                       path to CONFIG.RA,  set your logging  options,  and
  830.                       tell RAMS where you have stored the message template
  831.                       files.
  832.  
  833.     MSG's Setup     -  This is the default message setup,in other words if
  834.                       you   forget  to  specify  a  message  area  for  a
  835.                       particular  message then RAMS will default to these
  836.                       areas.   It  is  advisable that before setting this
  837.                       section up  that  you  know which  message base you
  838.                       will be  using for your  default  sysop and default
  839.                       user message bases.
  840.  
  841.  
  842.                                 ---- Page 16 ----
  843.  
  844.     THE NORMAL MENU AND MIDNIGHT MENU
  845.     ---------------------------------
  846.     As these are really  about setting  the  messages up  the option from
  847.     these menus will be discussed  under  the  headings for  the  various
  848.     message types.
  849.  
  850.  
  851.                            THE SYSTEM SETUP OPTIONS
  852.                            ========================
  853.  
  854.     SYSOP NAME
  855.     ----------
  856.     This is your name as you wish your users to see it.
  857.     Please note that this MUST also match the name you give for your  key
  858.     when you register RAMS.
  859.     It MUST also match the Sysop name in RA config too!
  860.  
  861.  
  862.     SYSTEM NAME
  863.     -----------
  864.     This is the name you wish your system to be known by.
  865.     Please note that unlike some programs your system name is  irrelevant
  866.     as far as a registration key is concerned, so if you decide to change
  867.     your system name there  will  be no  need  to go through the problems
  868.     and inconveniences of getting a new key.
  869.     Rams checks the Sysop name in Config.RA anyway and that MUST match the
  870.     name stored in the key or Rams will abort with an error, so no-one can
  871.     use another persons key unless they also use that persons  name as the
  872.     Sysop name in RA!!
  873.  
  874.  
  875.     TEMPLATE DIRECTORY
  876.     ------------------
  877.     This  is the  directory where  RAMS  expects  to  find  it's  message
  878.     template files.
  879.     This is where  you  should unpack the  SAMPLE.ZIP  archive  contained
  880.     inside the main  distribution archive.  It  contains  example message
  881.     templates for *MOST* of the messages available in Rams.
  882.     You  may  if  you wish set this to your main RAMS directory,   but  a
  883.     sub-directory is recommended as with all messages active this  version
  884.     (RAMS) allows for 150 PLUS message templates!!!
  885.     NOTE - This Directory MUST be set BEFORE you may activate ANY message!
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.                                 ---- Page 17 ----
  899.  
  900.     LOG PATH/FILENAME
  901.     -----------------
  902.     Like all good programs RAMS keeps  a  logfile of  it's activities  so
  903.     that you can easily monitor that RAMS is performing as you expect. If
  904.     you leave this field as default then RAMS will create it's logfile in
  905.     it's own system directory.   You  may however  prefer the practice of
  906.     keeping all your logfiles together,  in which case enter in here the
  907.     full path and filename you wish to call your log.
  908.     For EXAMPLE C:\LOGS\RAMS.LOG
  909.     NOTE.You can use *N as a node variable  (exactly as you can in RA) so
  910.     using a log file name of RAMS*N.LOG  would  generate a logfile called
  911.     RAMS1.LOG for node 1, RAMS2.LOG for node 2 etc. etc.
  912.  
  913.  
  914.     PATH TO CONFIG.RA
  915.     -----------------
  916.     Because of the variance in multinode systems we found it necessary to
  917.     confirm where your CONFIG.RA file will be for the node you are  going
  918.     to be setting up for.  RAMSCFG will attempt to find this from the  RA
  919.     system environment variable.  If this is correct then press enter  to
  920.     confirm or edit as required.
  921.  
  922.  
  923.                         THE MESSAGE MENU OPTIONS
  924.                         ========================
  925.  
  926.     The message menus within RAMSCFG are set out as a template.  It is by
  927.     doing this that as you become accustomed to setting  one  message type
  928.     up  you will  need  very  little  extra  knowledge  to  setup further
  929.     messages.  Some message types have "extra" options,    some have less
  930.     options, but the layout remains the same, the same keystrokes etc...
  931.  
  932.     These options are:=
  933.  
  934.     ACTIVE   [ ]
  935.     ------------
  936.     Press Space to toggle the "X" in the box, BLANK is INACTIVE,  "X"  is
  937.     ACTIVE.  This is basically the On/Off switch for the message,   so if
  938.     you don't require to set the message up leave this box blank and exit
  939.     the menu.  If  however you wish  to activate this message then toggle
  940.     the box to show "X" and press enter to confirm.
  941.     NOTE - Rams will ONLY post the message if it is set as ACTIVE
  942.  
  943.     *IMPORTANT NOTE*
  944.     The RAMS cnfiguration program will NOT allow you to activate a message
  945.     UNTIL the message template directory has been setup in the sytem setup
  946.     menu!
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.                                 ---- Page 18 ----
  955.  
  956.     AREA TYPE
  957.     ---------
  958.     Press Space to toggle between the Hudson and Jam message base format.
  959.     For the Hudson message base the MsgBase field will show as  a three -
  960.     digit entry box,  if Jam is selected a full width path/filename entry
  961.     field will appear.
  962.  
  963.     LOCAL/ECHO/(Netmail)
  964.     ----------
  965.     Press Space to toggle between Local and Echo messages.   RAMS has the
  966.     ability to send both the sysop and the user messages as local.    Why
  967.     the option to send the sysop message as an echo message?     Well the
  968.     sysop may  be going away and may wish to use RAMS to check his system
  969.     remotely!.
  970.     If this field is  set   to  local  then pressing enter will skip this
  971.     option.
  972.     If this field is toggled to echo then pressing enter will take you to
  973.     an "EchoMail Information" menu where you will be prompted for the aka
  974.     for the message area and to enter an origin line.
  975.     Please refer to the "Echomail Information" section for more details.
  976.     Netmail is available for the Regular, Monthly, and Yearly messages.
  977.     Please refer to the "Netmail Information" section for more details.
  978.  
  979.     TEMPLATE FILENAME
  980.     -----------------
  981.     This  is the  message  filename  for this  particular  section of the
  982.     message i.e.. one for the sysop and one for the user.    This must be a
  983.     valid filename complete with the extension. RAMS expects to find this
  984.     message file in it's template directory.    The file itself is just a
  985.     simple Ascii text file which may contain METASTRINGS which RAMS  will
  986.     replace with applicable system information at run-time.
  987.     The  metastrings  will  allow  you  to  insert  extra  user  specific
  988.     information into each message generated by Rams...   Such as username,
  989.     Sysopname, bbsname,date,time and lots of other details. This makes it
  990.     relatively  easy  to  use just  one  message  template file  for each
  991.     message and Rams will take care of the detail.
  992.     There are almost ONE HUNDRED metastrings available for you to use!
  993.     (for more information on Metastrings please refer to the section that
  994.     is headed "METASTRINGS").
  995.     Please note that although the configuration program  will  default to
  996.     certain filenames that it is YOUR responsibility to  make  sure  that
  997.     these files exist and are edited to suit your needs!!!
  998.     Both the filename AND the extension are entirely optional  -  you may
  999.     call them whatever you wish,you may if you wish even specify the same
  1000.     filename for more than one message  -  handy for regular posts  where
  1001.     perhaps you may wish to have for example your  BBS  advert  posted in
  1002.     more than one mail network under different aka's.
  1003.     You DO NOT  have  to  accept  the default filenames, you can call the
  1004.     templates whatever you want.  The  default names are only provided so
  1005.     that they match the example  message  template  files provided in the
  1006.     release archive.
  1007.  
  1008.     RAMSCFG has an inbuit template editor - see section later..
  1009.  
  1010.                                 ---- Page 19 ----
  1011.  
  1012.  
  1013.     CO-SYSOP FEATURE
  1014.     ----------------
  1015.     In addition to posting to the sysop RAMS can also  now post to  up to
  1016.     three co-sysops.
  1017.     Activate this feature by toggling the check box with the space bar. If
  1018.     actived, you will be put into an input screen for UP TO three names.
  1019.     RAMS will post additional copies of the sysop's message headed with the
  1020.     names setup here. The co-sysop's feature can only be activated WITH the
  1021.     sysop's message, and not instead of.
  1022.  
  1023.  
  1024.  
  1025.     MSG AREA
  1026.     --------
  1027.     This is the message area that you wish to post your message into.  In
  1028.     the  case  of  HUDSON  this  is the THREE DIGIT number for the HUDSON
  1029.     message base.
  1030.     In the case of a JAM area this is the FULL path  and  filename to the
  1031.     JAM message file WITHOUT any extension.
  1032.     NOTE - This is the filename, NOT the Echotag! RAMS cares not what the
  1033.     Echotag is!!!
  1034.  
  1035.  
  1036.  
  1037.     SUBJECT
  1038.     -------
  1039.     Each message has a subject line where you may specify the subject  of
  1040.     the message.     RAMS does have default subjects built in and if this
  1041.     field is left blank then RAMS  will  insert  the default subject line
  1042.     for that particular message.
  1043.  
  1044.  
  1045.  
  1046.     POST TO
  1047.     -------
  1048.     This option is available  ONLY  in the Regular,  Monthly,  and Yearly
  1049.     messages.   This  allows you to  address your message to a particular
  1050.     person, or simply "All".
  1051.     Also in this field you may use the '@ALL' macro. If @ALL (without the
  1052.     quotes!) is found in the 'Post to' field  it will  generate a message
  1053.     to EVERY user, so it may take a while!  It may also generate a LOT of
  1054.     MSG's!    These  MSG's  will  ONLY  be posted if the user satisfies the
  1055.     conditions you have specified for the msg. concerned.
  1056.     @ALL is NOT case sensitive... You can use @ALL, @all, @All or whatever.
  1057.  
  1058.  
  1059.     CALLS/TIMES ON
  1060.     --------------
  1061.     This entry field in the  Times on  message allows you  to specify the
  1062.     number of calls made to the system by the user that has just been  on
  1063.     line, and in the Nth Call template the number of calls. You may enter
  1064.     a value between 1 and 999.
  1065.  
  1066.                                 ---- Page 20 ----
  1067.  
  1068.  
  1069.     KEYWORD
  1070.     -------
  1071.     Entry in this field can be numerical,  alphabetic,  and in  upper  or
  1072.     lower case,  but  remember that  it  MUST  be an  EXACT  match to the
  1073.     keystring that you wish RAMS to search for.
  1074.  
  1075.  
  1076.     DAY OF WEEK TO POST
  1077.     -------------------
  1078.     Only found in the Weekly report template, this allows you to  specify
  1079.     which day of the week you would like  to  receive your  weekly report
  1080.     (if active).  Arrow keys left and right to move  the "highlight"  and
  1081.     enter to select.
  1082.  
  1083.  
  1084.  
  1085.     FREQUENCY
  1086.     ---------
  1087.     Only found in the  Regular  post  message  allows  you to specify the
  1088.     number of days between posts!
  1089.  
  1090.  
  1091.     DATE TO POST
  1092.     ------------
  1093.     Only found in the Monthly message type.   This  allows you to specify
  1094.     the date in the month to post i.e.. 2nd, or 17th, or 25th....
  1095.     NOTE - If you specify for example 30 ( 30th of the month ) then  RAMS
  1096.     will not post in February (28/29 days in this month)...
  1097.  
  1098.  
  1099.     MONTH & DAY
  1100.     -----------
  1101.     Used in the Yearly message.   Enter the date in these fields that you
  1102.     wish RAMS to post on.
  1103.     NOTE - RAMS makes no validation of that date,  so if you entered  the
  1104.     values of 4 (April) and 31(31st) then the message would NEVER be sent
  1105.     as there are only 30 days in April!!
  1106.  
  1107.  
  1108.     DAYS TO EXPIRE
  1109.     --------------
  1110.     This is found  on the  Subscription  message template and is used  to
  1111.     specify the number of days prior to a subscription  expiry to  post a
  1112.     message to a user. Setting a value of say 90 in this field will cause
  1113.     RAMS to send a message 90 days before a subscription expires,  please
  1114.     note that RAMS will only send this message on the 90th day before the
  1115.     expiry date..... Setting this message will not warn  users with  less
  1116.     than the specified number of days to receive this message...so if say
  1117.     on the 90th day before a subscription expiry RAMS is not run,    then
  1118.     that user will NOT receive a message....
  1119.  
  1120.  
  1121.  
  1122.                                 ---- Page 21 ----
  1123.  
  1124.     ACTIVATE DOOR FEATURE
  1125.     ---------------------
  1126.     This field is common to ALL the Carrier Drop message templates,   and
  1127.     can be accessed from any one of them!
  1128.     On activating this field another menu appears where you may enter  up
  1129.     to ten  " DOS shell : "  or  " Exit at errorlevel " strings that will
  1130.     uniquely identify a door that does NOT permit a  logoff from  within.
  1131.     Please  make sure that the string entered  here EXACTLY  matches  the
  1132.     entry in RA's logfile!!   CASE IS IMPORTANT!!!
  1133.     The list of Doors that DO NOT  allow  a  user to logoff needs only be
  1134.     setup for ONE carrier drop message,  the SAME setup is applied to ALL
  1135.     carrier drop messages.
  1136.  
  1137.     Some examples:-
  1138.  
  1139.          DOS shell : *C /c c:\ra\acbj.bat *M
  1140.  
  1141.          DOS shell : C:\RA\ABC.EXE *M
  1142.  
  1143.          Dos shell : C:\RA\DOORS\TETRA\TETRA.EXE *M
  1144.  
  1145.          DOS shell : *C /c c:\ra\cs.bat *M
  1146.  
  1147.          DOS shell : *C /C: C:\RA\LISA.BAT *M
  1148.  
  1149.          DOS shell : *C /c c:\ra\4square.bat *M
  1150.  
  1151.          DOS shell : *C /c C:\RA\DOORS\WHEEL\MCSPIN.EXE /N *N *M
  1152.  
  1153.      Any UNIQUE part of the above strings would suffice!!
  1154.  
  1155.      ie. MCSPIN.EXE , acbj.bat,
  1156.  
  1157.                             THE REPORTS MENU
  1158.                             =================
  1159.  
  1160.      From version 1.2 RAMS has the ability to generate a textfile of it's
  1161.      settings.  There are four reports available :-
  1162.  
  1163.      System Report - All System menu settings
  1164.      Normal Msgs   - Normal messages configuration
  1165.      Midnight Msgs - Midnight messages configuration
  1166.      Global Report - Everything!
  1167.  
  1168.      On choosing a report you will first be prompted for a Path/Filename,
  1169.      be warned RAMSCFG will create it's own path/file as entered so if you
  1170.      make a typos the directory/file will be created!
  1171.      Once this is entered you will be prompted to choose from:=
  1172.  
  1173.      1 - All messages, regardless of whether htey are active or not.  The
  1174.          idea being you can find out about those messages you temporarily
  1175.          turned off.
  1176.      2 - Active messages, this ONLY reports the settings of ACTIVE messages.
  1177.  
  1178.      Pressing escape at any time during this process will abort it!
  1179.  
  1180.                                 ---- Page 22 ----
  1181.  
  1182.                                ECHOMAIL INFORMATION
  1183.                                ====================
  1184.  
  1185.     RAMS is compatible with a full 4D mail address which means that point
  1186.     numbers are acceptable.  In this way sysop's who use point  addresses
  1187.     can still use RAMS echomail features,   or a sysop who wishes to post
  1188.     from a point address can do so.
  1189.     If a message is set to Echo from the Echo/Local option then the input
  1190.     box for entering this information will appear.
  1191.  
  1192.     There are only two options on this menu:=
  1193.  
  1194.     NODE NUMBER   -  This is split into four parts, enter your number and
  1195.                      press enter.  Enter will skip the point field if not
  1196.                      required.
  1197.  
  1198.     ORIGIN LINE   -  This is the origin line that you wish RAMS to append
  1199.                      to the end of each message.  It may be your BBS name
  1200.                      and phone number or any other information  that  you
  1201.                      wish to place there!
  1202.                NOTE. DO NOT add your node number to the origin line, Rams
  1203.                ----  will automatically append  it when  it  generates an
  1204.                      echo message.
  1205.  
  1206.                             NETMAIL INFORMATION
  1207.                             ====================
  1208.     This is identical to echomail with the exception that there are now two
  1209.     node entry fields,    one  for the  originating system  and one for the
  1210.     destination. The "Post to" field is also imported into the netmail setup
  1211.     and removed from the main template.
  1212.     NOTE - RAMS make NO validation of the destination address,  the validity
  1213.            of this is down to you!
  1214.  
  1215.  
  1216.                              CONDITIONS/ACTIONS
  1217.                              ==================
  1218.  
  1219.     Because of the nature  and  the  power of these  options this section
  1220.     will be split into three sections, Conditions,  Actions,  and then  a
  1221.     further section entitled  " Conditions/Actions  - How to get the most
  1222.     out of them".
  1223.  
  1224.     At the moment RAMS supports security level changes, Flag support, age,
  1225.     Group, Language, etc...
  1226.  
  1227.     If the user does NOT meet  the  'Condition'  for a particular message
  1228.     RAMS will NOT post a message to the user.  Similarly,  'Actions' will
  1229.     ONLY be performed IF a message is sent.
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.                                 ---- Page 23 ----
  1237.    cont...
  1238.  
  1239.     CONDITIONS - SECURITY LEVEL
  1240.     ---------------------------
  1241.     By default these values are set at 0 for min.level and 65535 for max.
  1242.     level that basically tells Rams to post messages to ALL users. If you
  1243.     only want a particular message to be posted to users with a sec.level
  1244.     of 10, set BOTH the minimum AND maximum values to 10...If you want to
  1245.     post to any users between 10-50 INCLUSIVE,  set the min.  level to 10
  1246.     and the max. level to 50.
  1247.     REMEMBER, these values are INCLUSIVE.  So  if  you  wanted to post to
  1248.     users ABOVE sec.  level 10 and NOT to users of level 10 or below, you
  1249.     would set the min value to 11 and the max. to 65535.
  1250.  
  1251.  
  1252.     CONDITIONS - AGE
  1253.     ----------------
  1254.     By  default these values are set at 0 for the  minimum  age and at 99
  1255.     for the maximum age, but you can enter any values you wish as long as
  1256.     they are between 0 and 99... Rams will ONLY post a msg. to the user(s)
  1257.     IF they fall between the ages you have entered.  So, if you only want
  1258.     a message to be posted to users who are OVER 18,set the minimum value
  1259.     to 18 and leave the maximum as 99...   Then any user that is BELOW 18
  1260.     years of age will NOT get that particular msg. PLEASE NOTE, if you do
  1261.     not have your system setup to ask a user his birthday at first logon,
  1262.     OR if the users birthday is  blank in their user record the age  will
  1263.     NOT be taken into account and the message WILL be posted.
  1264.  
  1265.  
  1266.     CONDITIONS - FLAGS
  1267.     ------------------
  1268.     By default the flags are all set to '-' which means that Rams will
  1269.     IGNORE any user flags and post the message concerned. However, you can
  1270.     select either '-', 'O', or 'X' by pressing the spacebar to toggle the
  1271.     entry to the desired one. If you select 'O', then that user flag MUST
  1272.     be OFF before Rams will post the message, if you select 'X' then the
  1273.     user flag MUST be ON for Rams to post the message. Selecting '-' means
  1274.     that Rams will IGNORE that particular flag irrespective of what it is
  1275.     set to in the user record.
  1276.  
  1277.  
  1278.     CONDITIONS - GROUP
  1279.     ------------------
  1280.     By default Rams will post to ALL user groups. However, you can select
  1281.     any valid group in the range 0-255. If you enter 1, Rams will ONLY
  1282.     post that message to a user in Group 1 etc... You can select ALL by
  1283.     either typing the word 'ALL' (without the quotes!) OR by entering a
  1284.     value of 256.
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.                                 ---- Page 24 ----
  1293.    cont...
  1294.  
  1295.     CONDITIONS - SEX
  1296.     ----------------
  1297.     By default Rams will post to BOTH female AND male users. However, you
  1298.     can specify that a particular message is only posted to ONE sex or the
  1299.     other by pressing the spacebar to toggle the condition to either 'Male'
  1300.     'Female, or 'Both'.
  1301.  
  1302.  
  1303.     CONDITIONS - LANGUAGE
  1304.     ---------------------
  1305.     By default Rams will post to users with ANY language selected. However,
  1306.     you can selesct that Rams should only post to users with a specific
  1307.     language by entering their langauge number here. You can have any valid
  1308.     language in the range 0-255. To select ALL, either type the word 'ALL'
  1309.     (Without the quotes!), OR enter a value of 256.
  1310.  
  1311.  
  1312.     ACTIONS - Alter SecLevel.
  1313.     -------
  1314.     In this section you have four options:=
  1315.  
  1316.     NONE      - This is the DEFAULT value...In other words Rams WILL post
  1317.                 the message if the user meets the  conditions set for it,
  1318.                 but it will NOT alter his seclevel.
  1319.  
  1320.  
  1321.     CHANGE    - Change seclevel from  the users old  setting to the  new
  1322.                 level you specify here.
  1323.                 i.e., setting it to a value of 50 will cause Rams to change
  1324.                 the users security level from  it's  current level to the
  1325.                 new one you have assigned.
  1326.                 This WILL  change  ONLY if the user  meets the conditions
  1327.                 for posting the message,   and it WILL RESET  his  level,
  1328.                 whether that be up OR down, to the new level.
  1329.  
  1330.     INCREASE  - First  you  specify an  amount  to INCREMENT  the   users
  1331.                 seclevel by, and a MAXIMUM value this can go to.
  1332.                 So for example,setting the Increment amount to 10 and the
  1333.                 maximum amount to 100  would  cause  Rams to increase the
  1334.                 users security  by 10 everytime it  posted  this message,
  1335.                 UNTIL the user reached the MAXIMUM level specified. After
  1336.                 that situation was reached, Rams would still post the msg.
  1337.                 if necessary,   but would NOT increase the users seclevel
  1338.                 beyond the maximum value you had defined.
  1339.                 Once the maximum level is reached, the message will still
  1340.                 be posted (if the user still meets the conditions for the
  1341.                 message) but his seclevel will NOT be altered any further.
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.                                 ---- Page 25 ----
  1349.    cont...
  1350.  
  1351.     DECREASE  - First  you  specify an  amount  to DECREMENT  the   users
  1352.                 seclevel by, and a MINIMUM value this can go to.
  1353.                 So for example,setting the Decrement amount to 5  and the
  1354.                 minimum amount to 10   would  cause  Rams to decrease the
  1355.                 users security  by 5  everytime it  posted  this message,
  1356.                 UNTIL the user reached the MINIMUM level specified. After
  1357.                 that situation was reached, Rams would still post the msg.
  1358.                 if necessary,   but would NOT decrease the users seclevel
  1359.                 below the minimum value you had defined.
  1360.                 Once the minimum level is reached, the message will still
  1361.                 be posted (if the user still meets the conditions for the
  1362.                 message) but his seclevel will NOT be altered any further.
  1363.  
  1364.  
  1365.     ACTIONS - FLAGS
  1366.     ---------------
  1367.     By default Rams will NOT change any user flags, but if a message is
  1368.     posted it can do any of the following:
  1369.  
  1370.       O  - Turn user flag OFF
  1371.       X  - Turn user flag ON
  1372.       T  - Toggle user flag. ie. if it's ON turn it OFF, if it's OFF turn
  1373.            it ON.
  1374.       -  - IGNORE flag. ie. DO NOT change it.
  1375.  
  1376.     By default ALL flags are set to '-' so that nothing is changed by Rams.
  1377.  
  1378.  
  1379.     ACTIONS - GROUP
  1380.     ---------------
  1381.     By default, Rams will NOT change the users 'Group'. However, you can
  1382.     specify ANY valid user group in the range 0-255 and Rams will change
  1383.     it to the specified level IF the message is posted. To set it to the
  1384.     default of 'N/C' (No Change), either type 'N/C' (without the quotes!)
  1385.     OR enter a value of 256.
  1386.  
  1387.  
  1388.     ACTIONS - RESET COUNTERS
  1389.     ------------------------
  1390.     For the Subscription messages ONLY there is now also an option to reset
  1391.     the user's upload and download counters.    Setting this to active will
  1392.     clear the user's download counters ans reset the  upload counters  back
  1393.     to "new user" defaults as setup in RACONFIG. By doing this a user who's
  1394.     subscription terminates and who's security level/flags etc are reset by
  1395.     RAMS can now continue with the same download rights as a "normal" user.
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.                                 ---- Page 26 ----
  1407.  
  1408.                            MESSAGE TEMPLATE EDITOR
  1409.                            =======================
  1410.  
  1411.     RAMS has an inbuilt message template editor that can be invoked from
  1412.     any of the message template screens by pressing the "F5" key.   RAMS
  1413.     will load in the message template as defined in the template filename
  1414.     that is applicable to the section of the message setup template  that
  1415.     you are in. ie.. Sysops part of the setup template will  load  in the
  1416.     Sysop's message template,  The User's section will load in the User's
  1417.     template...
  1418.  
  1419.     KEYS
  1420.     ----
  1421.  
  1422.     F1 - Help
  1423.  
  1424.     Escape - Exit
  1425.  
  1426.     F2 - Save
  1427.  
  1428.     Alt-F2 - Save As. Please note that the save as option WILL update the
  1429.                       template name that you have setup in RAMS!!!
  1430.  
  1431.     F5 - Invokes a "pick list" of metastrings.    The template editor will
  1432.          display a different set for the sysop and user message templates.
  1433.          Use the up/down arrow keys to select a metastring. Press enter to
  1434.          graft this into your message at the cursor position.  Escape will
  1435.          abort!
  1436.  
  1437.     Ctrl+y - delete a line.
  1438.  
  1439.     Home - start of the message.
  1440.  
  1441.     End - end of the message.
  1442.  
  1443.     PgUp/PgDn - page up or down as appropriate.
  1444.  
  1445.     If a file exists of the same name in your template directory then please
  1446.     note that a ????????.BAK file WILL be created.
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.                                 ---- Page 27 ----
  1461.  
  1462.  
  1463.                                EXCLUDING USERS
  1464.                                ===============
  1465.  
  1466.     There may be some users that you wish to exclude  from  getting  any
  1467.     messages or having RAMS alter their security status etc..   for this
  1468.     purpose provision has been made for an EXCLUDE.CTL file...  This can
  1469.     be used  to  specify a list of users that should  NOT  be  sent  any
  1470.     messages. One name per line, and the EXCLUDE.CTL file MUST be in the
  1471.     same directory as RAMS.EXE
  1472.  
  1473.     For example:
  1474.  
  1475.  
  1476.     Eddy Matthews
  1477.     Andy Smith
  1478.     Steve Nutt
  1479.     etc.. etc..
  1480.  
  1481.     The list is NOT case sensitive...     If a user is found in this list
  1482.     he/she  will  NOT  be sent ANY user messages,  HOWEVER  'Information'
  1483.     messages to the Sysop WILL still be sent (if they are enabled) so you
  1484.     can still keep an eye on what these excluded users are up to...
  1485.     If you choose NOT to have an EXCLUDE.CTL file RAMS will report to the
  1486.     screen that this file is  NOT  found,  but  this  does NOT affect the
  1487.     running of the program in any way!
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                                 ---- Page 28 ----
  1517.  
  1518.                      INSTALLING RAMS INTO YOUR BBS BATCHFILE
  1519.                      =======================================
  1520.  
  1521.     Installing RAMS into your BBS batch file is quite easy,   just follow
  1522.     these steps:
  1523.  
  1524.        1. Create a directory on your hard drive and extract all the files
  1525.           from the distribution archive into this directory.
  1526.  
  1527.           C:\RAMS is recommended and is assumed to be the directory you
  1528.                   have created.
  1529.  
  1530.  
  1531.        2. Read the document file!! (okay I know you are already :-))
  1532.  
  1533.        3. Run RAMSCFG.EXE to configure RAMS so that it sends the messages
  1534.           you require for your system.  You should have done this already
  1535.           as explained in the previous chapters on configuring RAMS.
  1536.           The RAMSCFG  program  has  a  built  in  help system which will
  1537.           explain what is necessary in  each  field in some detail so you
  1538.           can easily configure RAMS for your needs.
  1539.           Pressing the function key F1 will cause a pop up help window to
  1540.           appear which will  remind  you  of  the  information and format
  1541.           required by each field.
  1542.  
  1543.         N.B.
  1544.  
  1545.           It is IMPORTANT  that you should  move through each part of the
  1546.           configuration program in a careful and methodical way to ensure
  1547.           that you  DO  NOT  miss  anything  thereby  causing unnecessary
  1548.           problems for yourself later!
  1549.  
  1550.           If you are in any doubt:-
  1551.           READ THE SECTIONS EXPLAINING HOW TO CONFIGURE RAMS!
  1552.  
  1553.        4. Edit your BBS batch file  so  that it will run  RAMS after each
  1554.           user logs off your system.    This is not only so that RAMS can
  1555.           keep certain stats up to date  but  so  that  RAMS can send any
  1556.           messages required.
  1557.           It should be noted that *MOST* messages will be generated  when
  1558.           RAMS is run at this time.
  1559.  
  1560.            i.e.
  1561.  
  1562.              edit your batch file to include:
  1563.  
  1564.              <Your BBS batch file>
  1565.              <Error levels>
  1566.              Goto RAMS
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.                                 ---- Page 29 ----
  1573.   cont..
  1574.  
  1575.              :RAMS
  1576.              CD\RAMS
  1577.              RAMS
  1578.              Goto Start
  1579.              <batch file continues>
  1580.  
  1581.              As stated above, this MUST be in a section of your batch file
  1582.              that will be executed EVERY time a user logs off.
  1583.  
  1584.        5. There's NO extra command line parameters to  worry  about,   no
  1585.           midnight events, so there's NO  need  to make sure RAMS runs in
  1586.           your midnight event, although you MAY do so if you wish.
  1587.           What RAMS has is "Daily procedures".  These are when RAMS posts
  1588.           things like Regular posts, Birthday messages, Sysop reports.
  1589.           RAMS detects the FIRST time it is run EACH day and will perform
  1590.           these tasks then, and what's more it only takes a  few SECONDS.
  1591.           This is why RAMS does not require a midnight event.
  1592.  
  1593.     That's all there is to it!!
  1594.  
  1595.     RAMS is now ready to take over all those boring messages that a  busy
  1596.     Sysop needs to send on a regular basis......
  1597.  
  1598.     After configuring RAMS to your needs and running it for the first time
  1599.     the following files will be created:
  1600.  
  1601.         RAMS.LOG - Log file of RAMS's activity. This will be placed in the
  1602.                    directory RAMS was run from,  but  you  can specify the
  1603.                    directory  and  filename of your choice from within the
  1604.                    configuration program.   Please see the section of this
  1605.                    document about configuring RAMS for more info.
  1606.  
  1607.  
  1608.         RAMS.DAT - This is RAMS "working" file of information.
  1609.                    WARNING  -  deleting or tampering with this file in any
  1610.                    shape or form WILL affect the way RAMS will run!
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.                                 ---- Page 30 ----
  1629.  
  1630.  
  1631.     MULTILINE SYSTEMS
  1632.     -----------------
  1633.     Using the  RemoteAccess Automated Message System  (RAMS) in a multi-
  1634.     node configuration
  1635.  
  1636.     RAMS has built-in support for multi-node systems,  and  requires only
  1637.     minor modifications to its configuration to enable it to  be  used in
  1638.     this kind of environment.
  1639.  
  1640.     Before you begin, see the RemoteAccess  documentation  for details of
  1641.     how to install RA in a multi-node environment,   as RAMS will utilise
  1642.     the configuration for each node as required.
  1643.  
  1644.     Please note: It is important to use a different copy of RAMS for each
  1645.     node, since each will require different configuration data.   Failure
  1646.     to correctly configure RAMS in a multi-node environment MAY result in
  1647.     damage to your userbase - you've been warned!
  1648.  
  1649.     You should also ensure  that RAMS  keeps a different log file for each
  1650.     node.    To do this,  use the RAMSCFG.EXE  utility  to  instruct  RAMS
  1651.     accordingly.
  1652.  
  1653.     RAMS uses the DOS TASK  variable  to determine  on  which  node  it is
  1654.     running.
  1655.     So, for example, you could instruct RAMS to use 'C:\FD\LOGS\RAMS*N.LOG'.  This
  1656.     would append the current node (task) number to the log filename, which
  1657.     would produce a file named RAMS1.LOG in your C:\FD\LOGS\ directory.
  1658.  
  1659.     You must also tell RAMS where to look for the RA config files for each
  1660.     node.
  1661.     Since this will vary depending on how each node is configured,  it is
  1662.     not  possible  to  provide  specific information on this point.   For
  1663.     further details, see the RA documentation.
  1664.  
  1665.     Suffice it to say that RAMS needs to know where the CONFIG.RA file is
  1666.     for the current node.
  1667.  
  1668.     So,for example, if you wanted to use RAMS on node #1, you could point
  1669.     RAMS to C:\RA\NODE1\ for the RA configuration.   It is very important
  1670.     that this point is clearly understood before you run RAMS in a multi-
  1671.     node environment,   since RAMS needs specific information  from  your
  1672.     RA.CFG file to function correctly.
  1673.  
  1674.     You must also set the DOS 'TASK' variable to the current node number.
  1675.     For  further  details on  this point,  see  your  operating  system's
  1676.     reference guide.
  1677.  
  1678.     If you attempt to run RAMS when configured  for multi-node operation,
  1679.     before setting the 'TASK' variable, RAMS will generate the  following
  1680.     error message:
  1681.  
  1682.  
  1683.  
  1684.                                 ---- Page 31 ----
  1685.    cont....
  1686.  
  1687.     The RA LogFile Cannot be opened
  1688.  
  1689.     Either the path/logfile defined in Config.RA doesn't exist, OR the RA
  1690.     log is locked by another process...
  1691.  
  1692.     RAMS Aborting!
  1693.  
  1694.     If you run both your nodes on the same machine,you can set the 'TASK'
  1695.     variable via a command-line  switch in the batch file which brings up
  1696.     your system as in the following example:
  1697.  
  1698.     @ECHO OFF
  1699.     CLS
  1700.     SET %TASK=1
  1701.     CD \RA
  1702.     RA 1 <switch> <switch> ETC. ETC. ETC...
  1703.  
  1704.     The number 1 on the above command line  defines  the 'TASK' variable,
  1705.     and assigns it a value of 1.  RAMS will then use this value to append
  1706.     to the log file it creates.
  1707.  
  1708.     That's really all there is to say regarding multi-node systems,   see
  1709.     your RA documentation for more details.
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.                                 ---- Page 32 ----
  1741.  
  1742.                            METASTRINGS USED BY RAMS
  1743.                            ========================
  1744.  
  1745.     In the file SAMPLE.ZIP  you  will  find  some example text files  for
  1746.     RAMS to use.
  1747.     These files are examples  only  and  you are free to edit them as you
  1748.     wish so they are more compatible with your system.      The files are
  1749.     plain ascii text,   and  are  used  by  RAMS  to generate its various
  1750.     messages to users/sysop etc. etc.
  1751.  
  1752.     If you examine  these  files  you  will see they contain lots of meta
  1753.     strings, such as %USERNAME% ,   these strings are automatically  read
  1754.     by RAMS and are replaced by your systems/users details.In the example
  1755.     given (%USERNAME%) RAMS would insert the name of the user as read from
  1756.     your BBS users file/s.
  1757.  
  1758.     The following is a list of  all  meta  strings currently available in
  1759.     RAMS. They ARE case sensitive, so entering %bOArdnAMe% will NOT work!
  1760.     You  may  use  any of these meta strings in any text files you create
  1761.     for use with RAMS, subject to the limitations of that metastring,
  1762.     Please note the usage specified in the descriptions!
  1763.  
  1764.     !! IMPORTANT !!
  1765.     ---------------
  1766.     Metastrings MUST be enclosed by % signs in order to function,
  1767.     i.e. Program must be entered as %Program% in any message  you wish to
  1768.     use it in.... The same is true for ALL other metastrings.  Entering a
  1769.     metastring without enclosing it by % signs  will  mean  RAMS will NOT
  1770.     translate the string concerned.
  1771.  
  1772.  
  1773.     %FROM%              Specifies the From field
  1774.     %TO%                Specifies the To field
  1775.     %SUBJECT%           Specifies the subject
  1776.     %PRIVATE%           Toggles private flag (by default local messages
  1777.                         are set to PRIVATE and echo messages are set to
  1778.                         PUBLIC)
  1779.     %USERNAME%          Name of User
  1780.     %SYSOPNAME%         Name of Sysop
  1781.     %DATE%              The date that RAMS posted the message
  1782.     %TIME%              The time that RAMS posted the message
  1783.     %BBSNAME%           Name of BBS system
  1784.     %SYSOPFIRST%        Sysop's first name
  1785.     %USERFIRST%         User's first name
  1786.     %DAYOFWEEK%         The day of the week that the message was generated
  1787.     %DATAPHONE%         The data phone number of the user
  1788.     %VOICEPHONE%        The voice phone number of the user
  1789.     %HANDLE%            The users handle
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.                                 ---- Page 33 ----
  1797.  
  1798.     metastrings cont....
  1799.  
  1800.     %ADDRESS1%          Address line one in the users record
  1801.     %ADDRESS2%          Address line two in the users record
  1802.     %ADDRESS3%          Address line three in the users record
  1803.     %USERNUMBER%        The number of the user in RA's userbase
  1804.     %AGE%               The User's age in years..ie.21,35,52...etc..
  1805.     %DOBDAY%            The DAY of the Users Date Of Birth. ie 01-31
  1806.     %DOBMONTH%          The MONTH of the Users Date Of Birth. i.e. 01-12
  1807.     %DOBYEAR%           The YEAR of the Users Date of Birth in two digit
  1808.                         form. 00-99
  1809.     %UPLOAD#%           Total Number of files uploaded by user,    Please
  1810.                         note this is NOT the number  of files uploaded in
  1811.                         the users last call,  but  the TOTAL  he/she  has
  1812.                         uploaded to your system.
  1813.     %DOWNLOAD#%         Total number of files downloaded by user,  Please
  1814.                         note this is NOT  the  number of files downloaded
  1815.                         in the users last call,  but the TOTAL he/she has
  1816.                         downloaded from your system.
  1817.     %DOWNLOADK%         Similar to %DOWNLOAD#%,   except that this is the
  1818.                         TOTAL Kb that the user has downloaded from your
  1819.                         system.
  1820.     %UPLOADK%           Similar to %UPLOAD#%,  except  that  this  is the
  1821.                         TOTAL Kb  that  the  user has  uploaded  to  your
  1822.                         system.
  1823.     %MSGSPOSTED%        The TOTAL number of  messages posted by  the  user
  1824.                         on your system. This is read from the users record
  1825.                         so *may* not contain messages  posted using a mail
  1826.                         door as *some* of them  do  not  update the  users
  1827.                         messages posted counter.
  1828.     %PASSWORD%          This can ONLY be used in the WATCHDOG messages and
  1829.                         will be translated to a list of  all the passwords
  1830.                         that were tried before RA  kicked the user off for
  1831.                         exceeding the maximum number of attempts.  Because
  1832.                         of the way RAMS has to process this  line multiple
  1833.                         times to list all the passwords  you  should place
  1834.                         this  metastring  on  it's  own  line  within  the
  1835.                         message text file.
  1836.         NOTE -  ANY other  text that is on the same line as the %PASSWORD%
  1837.                 metastring  will be  WIPED OUT by RAMS! An example of it's
  1838.                 use is shown in the SYSWDOG and USERWDOG message templates.
  1839.     %DOORNAME%          The  name  of the door the user was in when he/she
  1840.                         dropped  carrier.    This  currently  defaults  to
  1841.                         RemoteAccess,   but it will be expanded at a later
  1842.                         date to show the actual door name.    This meta is
  1843.                         only of use in the Carrier Drop messages.
  1844.     %UPLOAD%            Generates a list of filenames that were uploaded it
  1845.                         should  be  placed  on  a  separate  line   in  the
  1846.                         'Thankyou' MSG's, and will be translated to a  full
  1847.                         list by Rams when it generates the msg.
  1848.     %CALLS%             The  number of  calls made by the user to your BBS,
  1849.                         this can be used  in  any  msg.   you wish, but is
  1850.                         particularly useful in the 'Times On' msgs.
  1851.  
  1852.                                 ---- Page 34 ----
  1853.   cont...
  1854.  
  1855.     %BIRTHDAYNAME%      This  can  only  be  used for  the sysop's message
  1856.                         template and will be replaced by  the names of all
  1857.                         the Users that RAMS has posted a  birthday message
  1858.                         to that day.
  1859.  
  1860.     %DRIVEINFO%         This will give info on your hard drives.   Useful
  1861.                         for checking drive space etc.if you are away from
  1862.                         your machine. The %DRIVEINFO% metastring  MUST be
  1863.                         followed IMMEDIATELY by the drive letter you wish
  1864.                         to check.
  1865.                         i.e.. %DRIVEINFO%C will give details of drive C:,
  1866.                         %DRIVEINFO%E will give details of drive E: etc.
  1867.                         See the SYSREPT.MSG template for more info..
  1868.                         Please note, because of the  limitations  of  Dos
  1869.                         this metastring  will  ONLY  give correct info on
  1870.                         drives up to approx. 2Gb..   Anything larger than
  1871.                         that  will   cause  unpredictable  values  to  be
  1872.                         written to the msg.
  1873.         NOTE -  I don't  know  how this  will behave if used on a network
  1874.                 drive, a Ram disk, or on a doublespaced drive etc. It may
  1875.                 produce incorrect values in these circumstances... I have
  1876.                 no way of checking this myself!
  1877.     %WHOTO%             This  can  be  used in  the  sysop reports for the
  1878.                         Regular, Monthly, and Yearly messages. If the @All
  1879.                         macro is used  this  will generate a list of names
  1880.                         that the message/s were posted to...
  1881.     %USERMSGS%          Total number of User MSG's posted on the  previous
  1882.                         day..
  1883.     %SYSMSGS%           Total number of Sysop MSG's posted on the previous
  1884.                         day....
  1885.     %TOTALMSGS%         Total number of MSG's (Sysop + User) posted on the
  1886.                         previous day.
  1887.     %USERMONTHLYPOSTED% Total Monthly MSG's sent to users yesterday.
  1888.     %USERYEARLYPOSTED%  Total Yearly MSG's sent to users yesterday.
  1889.     %USERSUBSPOSTED%    Total Subscription expiry MSG's sent to users
  1890.                         yesterday.
  1891.     %USERBDAYWEEK%      Total birthday MSG's sent to users for the last week.
  1892.     %USERUPLDWEEK%      Total upload MSG's sent to users...
  1893.     %USERWELCWEEK%      Total Welcome MSG's sent to users...
  1894.     %USERWDOGWEEK%      Total Watchdog MSG's sent to users...
  1895.     %USERDROPWEEK%      Total Carrier drop MSG's sent to users...
  1896.     %USERTIMESONWEEK%   Total Times on MSG's sent to users...
  1897.     %USERKEYWORDWEEK%   Total Keyword MSG's sent to users...
  1898.     %USERNTHCALLWEEK%   Total Nth Call MSG's sent to users...
  1899.     %USERMONTHLYWEEK%   Total Monthly messages sent last week...
  1900.     %USERYEARLYWEEK%    Total yearly MSG's sent last week...
  1901.     %USERSUBSWEEK%      Total Subscription messages sent to users last week.
  1902.     %USERMSGSWEEK%      Total User messages sent last week.
  1903.     %USERTIMESONPOSTED% Number of TimesOn MSG's posted to users today.
  1904.     %USERNTHCALLPOSTED% Number of Nth Call MSG's posted to users today.
  1905.     %USERKEYWORDPOSTED% Number of User keyword msgs sent - ONLY for daily
  1906.                         report.
  1907.  
  1908.                                 ---- Page 35 ----
  1909.  cont....
  1910.  
  1911.     %USERBDAYPOSTED%    The number of Birthday messages posted to the Users
  1912.                         yesterday.
  1913.     %USERUPLDPOSTED%    The number of 'Upload (thankyou)' messages sent to
  1914.                         users yesterday.
  1915.     %USERWELCPOSTED%    The number of 'Welcome' messages sent to users
  1916.                         yesterday.
  1917.     %USERWDOGPOSTED%    The number of 'Watchdog' messages sent to users
  1918.                         yesterday.
  1919.     %USERDROPPOSTED%    The number of 'Carrier Drop' messages sent to users
  1920.                         yesterday.
  1921.     %USERREGULARWEEK%   Number of 'Regular' messages posted for the last week.
  1922.     %USERREGULARPOSTED% Number of 'Regular' messages posted yesterday.
  1923.     %SYSBDAYWEEK%       Total Sysop birthday reports sent last week.
  1924.     %SYSUPLDWEEK%       Total Sysop upload reports...
  1925.     %SYSWELCWEEK%       Total Sysop new user reports...
  1926.     %SYSWDOGWEEK%       Total Sysop watchdog reports...
  1927.     %SYSDROPWEEK%       Total Sysop Carrier drop reports...
  1928.     %SYSTIMESONWEEK%    Total Sysop Times on reports...
  1929.     %SYSKEYWORDWEEK%    Total Sysop Keyword reports...
  1930.     %SYSNTHCALLWEEK%    Total Sysop Nth Call reports...
  1931.     %SYSMONTHLYWEEK%    Total Sysop Monthly reports...
  1932.     %SYSYEARLYWEEK%     Total Sysop Yearly reports...
  1933.     %SYSSUBSWEEK%       Total Subscription expiry reports sent to Sysop
  1934.                         last week.
  1935.     %SYSMSGSWEEK%       Total Sysop MSG's sent last week.
  1936.     %SYSMONTHLYPOSTED%  Total Monthly reports sent to Sysop yesterday.
  1937.     %SYSYEARLYPOSTED%   Total Yearly reports sent to Sysop yesterday.
  1938.     %SYSSUBSPOSTED%     Total Subscription expiry reports sent to Sysop
  1939.                         Yesterday.
  1940.     %SYSNTHCALLPOSTED%  Number of Nth Call sysop reports posted today.
  1941.     %SYSTIMESONPOSTED%  Number of TimesOn MSG's posted to sysop today.
  1942.     %SYSKEYWORDPOSTED%  Number of Sysop keyword reports sent - ONLY for
  1943.                         daily report.
  1944.     %SYSBDAYPOSTED%     The number of Sysop birthday reports sent yesterday.
  1945.     %SYSUPLDPOSTED%     The number of Sysop 'Upload' reports sent yesterday.
  1946.     %SYSWELCPOSTED%     The number of Sysop 'New User' reports sent yesterday.
  1947.     %SYSWDOGPOSTED%     The number of Sysop 'Watchdog' reports sent yesterday.
  1948.     %SYSDROPPOSTED%     The number of Sysop 'Carrier Drop' reports sent
  1949.                         yesterday.
  1950.     %SYSDAILYPOSTED%    The number of Sysop 'Daily' reports sent yesterday.
  1951.     %SYSDAILYWEEK%      The number of Sysop 'Daily' reports sent for the
  1952.                         previous week.
  1953.     %SYSREGULARPOSTED%  Number of Sysop 'Regular' reports sent yesterday.
  1954.     %SYSREGULARWEEK%    Number of Sysop 'Regular' reports sent for the last
  1955.                         week.
  1956.     %TOTALMSGSWEEK%     Total User AND Sysop MSG's sent last week.
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.                                 --- Page 36 ----
  1965.  
  1966.  
  1967.                       HOW TO GET THE MOST OUT OF RAMS
  1968.                      ===============================
  1969.     Although Rams is fairly easy to setup (it is isn't it?), there are
  1970.     a number of ways you can use it to increase it's flexibility even
  1971.     further. Lets take a look at a couple of ideas to show you what we
  1972.     mean.
  1973.  
  1974.     Rams can manipulate the user security levels, flags, Group etc etc.
  1975.     By using these features to their fullest you can get the best out
  1976.     of Rams. The ideas and suggestions listed below are only a quick
  1977.     guideline to what you can do, and are intended only as an outline.
  1978.     You can use these suggestions in your own setup, or devise your own
  1979.     ideas based on them.
  1980.  
  1981.  
  1982.     USING FLAGS
  1983.     -----------
  1984.     Firstly, lets assume you want Rams to post a message to a user when
  1985.     they use the BlueWave maildoor telling them about becoming a point,
  1986.     but you only want this message to be posted ONCE, and not EVERY time
  1987.     they use the door.
  1988.  
  1989.     This is a fairly easy one, simply setup a 'Keyword' message so that
  1990.     Rams will scan the RA log for something that appears in the log entry
  1991.     that RA writes when it loads the BlueWave door. This may be something
  1992.     like 'C:\RA\BLUEWAVE\BWDOOR.BAT' - Assuming that you call BlueWave
  1993.     with a batch file called BWDoor.Bat. Enter that into the 'Keyword' msg
  1994.     as the text for Rams to scan for...
  1995.  
  1996.     Then go into the message 'Conditions' and set User flag A1 to OFF - that
  1997.     is toggle the entry for flag A1 (using the spacebar) until it changes
  1998.     to an 'O'. That will tell Rams to ONLY post that message IF the user has
  1999.     flag A1 OFF. Jump to the 'Actions' menu and set flag A1 to ON by toggling
  2000.     it as you did before, but this time set if to 'X'. That will tell Rams
  2001.     to alter the user flag A1 to ON when it posts the message to the user.
  2002.     This obviously assumes that you aren't using the A1 flag for anything
  2003.     else... If you are, simply select a different user flag.
  2004.  
  2005.     Then create a message template file that contains the text you want to
  2006.     send to the user if he enters the BlueWave mail door - This is detailed
  2007.     elsewhere in these docs... And enter the name of the message template
  2008.     file into the config for this message.
  2009.  
  2010.     Okay, so what does all that actually mean? Well, Now what you've done
  2011.     is to tell Rams to post a 'Keyword' message when it finds the RA log
  2012.     entry for BlueWave, BUT ONLY if the user has flag A1 OFF... If flag
  2013.     A1 is ON Rams will NOT post the message. When Rams posts the message
  2014.     it will reset the A1 flag to ON, therefore the user will NOT receive
  2015.     that message again as he no longer matches the 'Conditions' for the
  2016.     message. Easy or what? :-)
  2017.  
  2018.  
  2019.  
  2020.                                 ---- Page 37 ----
  2021.  
  2022.     USING SECURITY LEVELS
  2023.     ---------------------
  2024.  
  2025.     Okay, now lets assume you want to downgrade a user when their sub-
  2026.     scription has expired.
  2027.  
  2028.     Firstly you can warn your users that their subs are about to expire
  2029.     by setting up a message that will be posted 30 days BEFORE their subs
  2030.     are due, and perhaps another 7 days BEFORE. Simply create two 'Subs'
  2031.     messages, one with a value of '30' days and one with a value of '7'
  2032.     days. You can set the message 'Conditions' for minimum AND maximum
  2033.     seclevel to 50 - In other word ONLY users of seclevel 50 will be sent
  2034.     the message(s). These message will be posted 30 days before the users
  2035.     subs expire, and again 7 days before they expire.
  2036.  
  2037.     Lets say that 'Normal' users have an access level of 10 and 'Subscribers'
  2038.     have an access level of 50.
  2039.  
  2040.     Setup a third 'Subscription' message with a value of '0' (zero) days.
  2041.     Then set the message 'Conditions' to 50 for min AND max security, and
  2042.     ALSO setup an 'Action' to 'Change' the users seclevel to a value of
  2043.     10. Rams will then post a message to the user on the day that their
  2044.     subs expire and will alter their access level to 10.
  2045.  
  2046.  
  2047.     FURTHER IDEAS/SUGGESTIONS
  2048.     -------------------------
  2049.     The above are only two possible ways of making Rams more flexible. The
  2050.     potential number of ways you can use it are almost endless. Only YOUR
  2051.     imagination can come up with ALL the possibilities...
  2052.  
  2053.     You could warn users that drop carrier that their behaviour will not
  2054.     be tolerated. And reduce their access if they drop carrier more than 10
  2055.     times say... How do you do that? Simple... Lets assume 'Normal' users
  2056.     have an access level of 20 and twits have an access level of 10...
  2057.     So you have TWO entries in your LIMITS.CTL file for RA.. One for level
  2058.     20 access and another for level 10 access. You will need to add a third
  2059.     entry for level 11... I'll explain why in a minute. This entry needs to
  2060.     be the same as the access for level 20.
  2061.  
  2062.     Then setup a carrier drop message that is posted whenever a user drops
  2063.     carrier. Set it's 'Conditions' to Max seclevel 20, Min seclevel 11. Also
  2064.     set the 'Actions' to DECREASE the users seclevel by 1 to a MINIMUM value
  2065.     of 10... Rams will then post the user a message EVERY time they drop
  2066.     carrier AND it will REDUCE their access level by ONE everytime it posts
  2067.     the message.
  2068.  
  2069.     If a user has an access level of 20, RA will use the normal level 20
  2070.     defined in your LIMITS.CTL file. If they are BELOW level 20 BUT ABOVE
  2071.     level 10, RA will use the entry defined for access level 11 because it
  2072.     will ALWAYS use the level BELOW the users actual seclevel if an entry
  2073.     for that particular level doesn't exist in the LIMITS.CTL file. See your
  2074.     RA doc for more info.
  2075.  
  2076.                                 ---- Page 38 ----
  2077.  
  2078.  
  2079.  
  2080.  cont...
  2081.     So what happens now is that Rams will DECREASE the users access by ONE
  2082.     each time they drop carrier... RA will use the values stored in the
  2083.     LIMITS.CTL file for seclevel 11 once they have dropped below access
  2084.     level 20... Rams will continue to decrease their access by one each time
  2085.     UNTIL they are eventually reduced to level 10... Then RA ZAPS EM! :-)
  2086.  
  2087.     Rams will not post the message anymore after they reach level 10 as that
  2088.     is outside the 'Conditions' specified for the message....
  2089.  
  2090.     FINAL COMMENT
  2091.     -------------
  2092.     The easiest way to fully undersatnd just what Rams can do for you is to
  2093.     play around with it... Try setting up different messages and changing
  2094.     the various conditions/actions. I'm sure you'll soon see just how
  2095.     flexible it can be. All it takes is a little imagination and a bit of
  2096.     time... Once it's setup it's all automatic. No more haveing to downgrade
  2097.     users manually, or even upgrade them... Rams can do it all.
  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.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.                                 ---- Page 39 ----
  2133.  
  2134.                       BUG REPORTS, CONTACTING THE AUTHORS
  2135.                       ===================================
  2136.  
  2137.     Should you find any bugs, undocumented features (future enhancements
  2138.     :-) ) or if something doesn't appear to work as it should :-( Please
  2139.     contact one of the authors at the following addresses:
  2140.  
  2141.  
  2142.               To:         Eddy Matthews
  2143.               Netmail:    2:256/651@fidonet
  2144.               Snailmail:  32 Whitley Road
  2145.                           Thornaby
  2146.                           Cleveland
  2147.                           TS17 9HZ
  2148.                           England
  2149.               Voice:      +44-642-766373 (8am to 9pm GMT)
  2150.               Data:       +44-642-764245 (24hrs @28.8k)
  2151.  
  2152.  
  2153.     or alternatively contact:-
  2154.  
  2155.               To:         Geoff Bassett
  2156.               Netmail:    2:259/651@fidonet
  2157.                           73:7446/417@RANet
  2158.               Snailmail:  9 Fraser Avenue
  2159.                           Inverkeithing
  2160.                           Fife
  2161.                           Ky11 1eq
  2162.                           SCOTLAND
  2163.               Voice:      +44-1383-414093 (8am to 9pm GMT)
  2164.               Data:       +44-1383-410704 (24 hours @28.8k)
  2165.  
  2166.  
  2167.  
  2168.     Send your registration to :-  Minerva Online details and Address are
  2169.     included in the registration document.
  2170.     Credit card registrations are accepted.
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.                                 ---- Page 40 ----
  2189.  
  2190.  
  2191.                       PLANNED FUTURE DEVELOPMENT OF RAMS
  2192.                       ===================================
  2193.  
  2194.     RAMS v1.20 is the third release of RAMS.  There are already plans to
  2195.     develop RAMS much more for future releases...
  2196.     Some already planned enhancements are:-
  2197.  
  2198.       Download messages for those who use RA's internal file manager.
  2199.  
  2200.       Timelimit exceeded messages.
  2201.  
  2202.       Even MORE Alterations to some of the messages to GREATLY enhance
  2203.       their flexibility.
  2204.  
  2205.       Plus much, much, more...
  2206.  
  2207.       Maybe even support for another BBS package?   Convince us!!!
  2208.  
  2209.     In order to develop future versions fully we  will require  additional
  2210.     beta testers that use RemoteAccess software and would be  grateful if
  2211.     any  Sysops  that are interested  in  RAMS  would  contact  us at the
  2212.     registration  site  with  details  of  their  software  and  hardware
  2213.     configurations so that these enhancements can be implemented.
  2214.  
  2215.     PLEASE NOTE.  -  Anyone that wishes to become a beta tester for these
  2216.                      future versions has to pay  the  normal registration
  2217.                      fee,    and  link into a private beta test echo area
  2218.                      (RAMS_BETA). They will also be required  to call one
  2219.                      of the authors boards to obtain new beta releases of
  2220.                      RAMS on a weekly basis.
  2221.  
  2222.     With your support and help, RAMS will develop into the BEST automatic
  2223.     message utility there is!!!
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.                                 ---- Page 41 ----
  2245.  
  2246.                                      CREDITS
  2247.                                      -------
  2248.  
  2249.     On a final note from the authors we would like to thank our Beta team
  2250.     for their dedication, hard work, bug reports, and perseverance and to
  2251.     say  that  without  their support  RAMS would not be half the program
  2252.     that it is.. Our beta team not only tested the program patiently, and
  2253.     believe me some of the beta releases did have one or two faults;-)
  2254.     Also to thank them for their input and suggestions,  many of which you
  2255.     see in the final program....
  2256.  
  2257.     The Beta Team
  2258.     -------------
  2259.  
  2260.     Andrew Davison    (The Hard Rock Studio) - "I broke it again"!
  2261.     Gordon Smith      (Tees for Two)
  2262.                         thanks for the help with the multinode stuff!!
  2263.     Andy & Caf Smith  (Zeons Lair)  - "It's not my fault it was Caf"!
  2264.     Steve Nutt        (The Computer Room) - "Why's my screen so currupt"
  2265.     Cliff Harrold     (The Coracle) - "I grow the best leeks in town" - "Boyo"!
  2266.     Steve Shooter     (Ultimate) - "If I used it all I'd need a bigger system"!
  2267.     Alan Walker       (Highlander) - "Where's my Scotch"? - "hic"
  2268.  
  2269.     And a final word of thanks to our wives, both for putting up with the
  2270.     countless hours we locked ourselves away in our  computer rooms,  for
  2271.     keeping the coffee flowing,  and  for putting  up with our moods  when
  2272.     things didn't go right!! - On those rare occassions;-)
  2273.     And a little word of thanks to BT for the shares we bought in them whilst
  2274.     developing this program! - What you mean that really was just the bill?
  2275.  
  2276.                -----------=== End of Document ===------------
  2277.