home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / RA / NOTIFY10.ZIP / RANOTIFY.DOC < prev    next >
Text File  |  1994-04-25  |  11KB  |  240 lines
  1.  
  2.                                 RA Notify v1.0
  3.                        Copyright (c) 1994, jLc Software
  4.  
  5.                                            Author:   Joe Hacker
  6.                                            Address:  FidoNet 1:160/140
  7.                                                      CFN     8:3017/0
  8.                                                      ICDM    77:2/0
  9.                                            BBS No.:  (512) 851-0241
  10.  
  11.          Release Date: 24 April 1994
  12.  
  13.  
  14.          ─────────────────────────────────────────────────────────────
  15.                              What Is "RA Notify"
  16.          ─────────────────────────────────────────────────────────────
  17.  
  18.          "RA Notify" is a simple little RemoteAccess utility to inform
  19.          other  nodes  of  an  arrival   or  departure  of  a  caller.
  20.          Basically, if you are logged onto node 2, and somebody leaves
  21.          node  1  -  RA  Notify   will  make  that  announcement.  The
  22.          difference between this program and  others is the ability to
  23.          know whether or  not to notify a node  where no-one is logged
  24.          into. RA Notify will also append to the semaphore file if the
  25.          file hasn't been shown to the user yet. This will ensure that
  26.          the user sees what is going on. Let me try and make this real
  27.          clear. Let's say all lines are available and someone logs on.
  28.          No notices go out because there  is no-one else that needs to
  29.          be notified.  But, if a caller  logs on, and someone  else is
  30.          already on the bbs - the oldest call gets notified of the new
  31.          arrival  (or the  newest call  gets notified  of the previous
  32.          logoff).  Since RA  will not  always show  the semaphore file
  33.          immediately,  if notification  has  not  gone out  to another
  34.          node, RA Notify will append to the notification so the caller
  35.          will  see  more  than  one  action.  This  will  prevent  the
  36.          possibility of someone logging on, then logging off - and the
  37.          only thing shown to the user is that someone just logged off.
  38.          RA Notify will  only announce if more than  two people are on
  39.          the bbs at the same time. RA Notify will NOT show a copyright
  40.          to the user, either. There is no need to have a user seeing a
  41.          copyright every time a caller logs on/off.
  42.  
  43.          "RA Count" is command line driven and simple to run.
  44.  
  45.          (Please read the registration info at the bottom of this doc)
  46.  
  47.  
  48.          ─────────────────────────────────────────────────────────────
  49.                             Do I Need "RA Count"
  50.          ─────────────────────────────────────────────────────────────
  51.  
  52.          Maybe  the  question  should  be,  "Would  the  users  of  my
  53.          multi-line bbs like to see who is coming and going while they
  54.          are logged on?"
  55.  
  56.  
  57.          ─────────────────────────────────────────────────────────────
  58.                                   DISCLAIMER
  59.          ─────────────────────────────────────────────────────────────
  60.  
  61.          The only thing that I guarantee is that it was written by me.
  62.          It works great here and on  another system that I know of but
  63.          it may  not work on  yours for some  reason. I won't  be held
  64.          responsible from any hard/software damages that you may incur
  65.          resulting from running "RA Notify". (Had to say it... but I'm
  66.          sure you won't have any difficulty).
  67.  
  68.          This program has been tested with DOS 5.0, OS2 2.11, DOS 6.2,
  69.          4DOS, and Lantastic without any trouble.
  70.  
  71.  
  72.          ─────────────────────────────────────────────────────────────
  73.                       Setting Up and Running "RA Notify"
  74.          ─────────────────────────────────────────────────────────────
  75.  
  76.          There is no actual set up for "RA Notify" since it is command
  77.          line  driven. But,  you do  need  to  place it  in the  right
  78.          places, with the proper command lines.
  79.  
  80.          You  do  NOT  have  to  have  "RA Notify"  in  any particular
  81.          directory, I keep it in its own directory on my system.
  82.  
  83.          Command line paramaters for RA Notify are:
  84.  
  85.          On|Off <Semaphore Drive and Directory> <Total Nodes> <Color>
  86.  
  87.          On|Off            If a user is logging on the bbs, you would
  88.                            use the ON.  If the caller was logging off
  89.                            you would use the OFF.
  90.  
  91.          Semaphore Dir     I use a RAM disk for my semaphore directory
  92.                            to  speed  up the  process  of  showing my
  93.                            semaphore    files.   Simply    place   the
  94.                            configured semaphore drive\directory here.
  95.  
  96.          Total Nodes       Total number of nodes on your mult-node bbs
  97.                            to  include   any  local  nodes   you  have
  98.                            defined.
  99.  
  100.          Color             This  parameter  is  optional,  and  if not
  101.                            defined, the color would appear the same as
  102.                            the last  color on the screen  (ie: if your
  103.                            user is  at a prompt, and  the prompt color
  104.                            is Blue - not defining the color here would
  105.                            produce a blue note.  See "Color Chart" for
  106.                            specific color codes.
  107.  
  108.          For my system, the command line when logging on is:
  109.  
  110.                               RANOTIFY On E: 3 F
  111.  
  112.          Where do you place this  command line? You basically have two
  113.          options. Either  use a Text  Shell or a  Type 7/Type 15  menu
  114.          option. I prefer the Text Shell  method as it is much faster.
  115.          Here is how I do it.
  116.  
  117.          In my WELCOME.ASC/ANS/RIP file, I place the following:
  118.  
  119.                         ^XC:\RA\RANOTIFY.EXE On E: 3 F
  120.  
  121.          In my GOODBYE.ASC/ANS/RIP file, I place the following:
  122.  
  123.                         ^XC:\RA\RANOTIFY.EXE Off E: 3 F
  124.  
  125.          *** Remember, you  must have Text Shell ON  in order for this
  126.          to work.
  127.  
  128.          The ^X is actually represented as a CTRL-X to be added with a
  129.          simple ASCII  editor (yes, even  DOS EDIT.COM can  do it). In
  130.          most cases, you type CTRL-P  then CTRL-X to produce what will
  131.          look like  an up arrow once  viewed (not edited). If  you are
  132.          just having  enormous amounts of  trouble understanding this,
  133.          you can netmail me and I will route your help back to you.
  134.  
  135.  
  136.          ─────────────────────────────────────────────────────────────
  137.                               Color Control Codes
  138.          ─────────────────────────────────────────────────────────────
  139.  
  140.          When using color codes, use the number/letter - not the name.
  141.  
  142.                    Foreground     Color
  143.                    Color          Number
  144.                    ─────────────────────────
  145.                    Black            0
  146.                    Blue             1
  147.                    Green            2
  148.                    Cyan             3
  149.                    Red              4
  150.                    Magenta          5
  151.                    Brown            6
  152.                    Gray             7
  153.                    Dark Gray        8
  154.                    Light Blue       9
  155.                    Light Green      A
  156.                    Light Cyan       B
  157.                    Light Red        C
  158.                    Light Magenta    D
  159.                    Yellow           E
  160.                    White            F
  161.  
  162.  
  163.          ─────────────────────────────────────────────────────────────
  164.                          Important Things To Remember
  165.          ─────────────────────────────────────────────────────────────
  166.  
  167.          1.  You must have Text  Shelling On if  you are going  to use
  168.          them within the WELCOME/GOODBYE files.
  169.  
  170.          2.  When shelling  from a  text  file,  be sure  to pass  the
  171.          complete  path AND  the  filename  extension or  it sometimes
  172.          won't get ran.  I can't explain why - and  it's not a problem
  173.          with my program, but I have seen RA not run a program because
  174.          of it.
  175.  
  176.          3.  You must  get the  command line  parameters in  the right
  177.          place.
  178.  
  179.  
  180.          ─────────────────────────────────────────────────────────────
  181.                                     Support
  182.          ─────────────────────────────────────────────────────────────
  183.  
  184.          I doubt if you  need it, but I'll answer  simple questions if
  185.          you netmail me  at one of the above  listed addresses. I will
  186.          be  limited to  routing your  replies back,  though. I'm  not
  187.          charging a lot for this program, so I'm not gonna spend a lot
  188.          on long distance calls supporting  it. That wouldn't be smart
  189.          business, would it?
  190.  
  191.          You can  also reach me  at Computer Resources,  (512)853-7779
  192.          between the hours of 5:00pm and 8:00pm (CST) Mon-Fri.
  193.  
  194.          ─────────────────────────────────────────────────────────────
  195.                                  Registration
  196.          ─────────────────────────────────────────────────────────────
  197.  
  198.          You may evaluate this program for  a period of 14 days. After
  199.          that, I will require you to register it, or erase it.
  200.  
  201.          Registration  is:
  202.  
  203.          Non-Commercial & running RemoteAccess shareware 2 node version
  204.          $5 US Dollars.
  205.  
  206.          Commercial OR Running RA Pro
  207.          $10 US Dollars.
  208.  
  209.           *****    Sorry,   no    other   currency,    please. *****
  210.  
  211.          Send Check or Money Order to:
  212.  
  213.                       jLc Software
  214.                       C/O Joe Hacker
  215.                       4106 Nicklaus Lane
  216.                       Corpus Christi, TX  78413
  217.                       USA
  218.  
  219.          Please make any checks or money orders payable to "Joe Hacker"
  220.  
  221.          ─────────────────────────────────────────────────────────────
  222.                                Acknowledgements
  223.          ─────────────────────────────────────────────────────────────
  224.  
  225.          This program was inspired by two people.  They are:
  226.  
  227.          1.  Andrew Milner  - author of RemoteAccess.
  228.              Without his SUPER bbs program, I would have never thought
  229.              to write this <grin>. Great  job Andrew! Keep up the good
  230.              work.
  231.  
  232.          2.  My Wife, Carolyn - author of my happiness.
  233.              She  really doesn't  like me  sitting and  playing on the
  234.              computer  a  lot  -  but  she  encourages  me with little
  235.              ego  boosters like  "that looks  great, Honey"...
  236.              Thanks for the support!
  237.  
  238.  
  239.                             * End of RANOTIFY.doc *
  240.