home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / DOORS / RACALLR3.ZIP / RACALLER.DOC < prev    next >
Encoding:
Text File  |  1991-11-16  |  11.8 KB  |  282 lines
  1.                        ╓─╖╓─╖   ╓─╖╓─╖╖ ╖ ╓─╖╓─╖╓─╖
  2.                        ╟╥╜╟─╢ ■ ║  ╟─╢║ ║ ╟─ ╟╥╜╙─╖
  3.                        ╙╙─╙ ╙   ╙─╜╙ ╙╙─╙─╙─╜╙╙─╙─╜
  4.  
  5.            The Ultimate "Who Called Today?" Replacement Program
  6.  
  7.           Version 3.00 by Brian Tardiff of HysteriaWare Software
  8.  
  9.                    The MASS Hysteria Bulletin Board System
  10.                             FidoNet # 1:324/174
  11.  
  12.              Line #1: (508)465-3198 - 300/9600 HST - Mail/Users
  13.              Line #2: (508)462-1565 - 300/2400 Bps - Users Only
  14.  
  15.      See D-SITES.TXT for a list of current HysteriaWare Distribution Sites
  16.   ═══════════════════════════════════════════════════════════════════════════
  17.  
  18.  
  19. ╓────────────────────────────╖
  20. ║ Introduction to RA-Callers ║
  21. ╙────────────────────────────╜
  22.  
  23.       Well, here it is.  The perfect record keeping system of the people
  24.       who call your system.  This program will replace your current
  25.       "Who Called Today" command with style.  RA-Callers offers you
  26.       everything that the RemoteAccess command offers plus MUCH MUCH
  27.       more!
  28.  
  29.              ■ A "Who Called Today" option that shows the user the callers
  30.                of that day.
  31.  
  32.              ■ A "Yesterday's Callers" option that shows the user the
  33.                callers of the previous day.
  34.  
  35.              ■ A "Specific Day Search" option that shows the user the
  36.                callers who called on MM/DD/YY.  This may be any day after
  37.                you install this program.
  38.  
  39.              ■ A "Birthday Callers" option that shows the user the callers
  40.                on his/her birthday.  Since some systems don't require
  41.                birthdates, this option is configurable.
  42.  
  43.                         ■ If all your users don't have birthdays entered,
  44.                           don't worry!  If RA-Callers notices the lack of
  45.                           info, the user is prompted to enter his/her
  46.                           birthday.  RA-Callers will save this information
  47.                           to your system records.
  48.  
  49.              ■ All lists can either show the users' real names or their
  50.                handles.  If the handle option is turned on, and the user
  51.                doesn't have a handle, his/her real name will still be
  52.                displayed.
  53.  
  54.              ■ Ansi/Ascii Support
  55.  
  56.              ■ Chat Mode & Throw Out User Functions (See SysOp Commands)
  57.  
  58.              ■ Complete Fossil Driver Communication Support
  59.  
  60.              ■ Carrier Detect and Keyboard Time-Out Protection
  61.  
  62.  
  63. ╓──────────────────────────╖
  64. ║ RA-Callers Archive Files ║
  65. ╙──────────────────────────╜
  66.  
  67.       The following files should be found in the RACALLR2.ZIP file:
  68.  
  69.              RACALLER.EXE  ..................  Actual Door Program
  70.              ADDTODAY.EXE  ..................  Daily Record Keeper Program
  71.              RAC-2TO3.EXE  ..................  v2.00 to v3.00 Converter
  72.              RACALLER.DOC  ..................  RA-Callers Documentaion
  73.              RACALLER.CFG  ..................  Sample Config File
  74.              RASINGLE.BAT  ..................  Example Single Node .BAT File
  75.              RAMULTI.BAT   ..................  Example Multi Node .BAT File
  76.              RACALLER.NEW  ..................  New features information
  77.              UPDATE!.DOC   ..................  Update Information
  78.              NOSHOW.CTL    ..................  Example exempt control file
  79.              D-SITES.TXT   ..................  Current Distribution Sites
  80.  
  81.       The program ADDTODAY.EXE will create a daily data file with the
  82.       extension ".DAY".  The longer you use this program, more files are
  83.       created.
  84.  
  85.  
  86. ╓────────────────────────────────────╖
  87. ║ Installing to a Single-Node System ║
  88. ╙────────────────────────────────────╜
  89.  
  90.       I HIGHLY suggest you run this door from a seperate directory
  91.       due to the amount of records (data files) that are kept.
  92.  
  93.                1) Copy all RA-Callers files into a separate directory
  94.                   (ie: C:\DOORS\RACALLER)
  95.                2) Using a Type 7 Exit from RemoteAccess execute a
  96.                   batch file such as the included RASINGLE.BAT.  You
  97.                   must tell RA-Callers where it can find files such as
  98.                   DORINFO1.DEF and EXITINFO.BBS.  The syntax is:
  99.  
  100.                          syntax: RACALLER.EXE [Path to Files]
  101.                              ie: RACALLER.EXE C:\RA
  102.  
  103.                   See RASINGLE.BAT for example of changing directories
  104.                   and running the RA-Callers Program.
  105.  
  106.  
  107. ╓───────────────────────────────────╖
  108. ║ Installing to a Multi-Node System ║
  109. ╙───────────────────────────────────╜
  110.  
  111.       Setting RA-Callers up for a Multi-Node System is easy if you
  112.       follow these directions.  To run RA-Callers in Multi-Node mode,
  113.       you must install SHARE.EXE that comes with your MS-DOS
  114.       package.  For more information on SHARE, see your DOS manual.
  115.  
  116.       So that there is no confusion, these directions will be as
  117.       detailed as possible.  Please follow these step by step.
  118.  
  119.                1) Create a seperate directory on your system and
  120.                   copy all the RA-Callers Play files into that
  121.                   directory. (ie: C:\DOORS\RACALLER)
  122.  
  123.       Now for the actual system installation.  The example batch file
  124.       RAMULTI.BAT will be the file referred to in these steps.  You
  125.       may rename this batch file to suit your needs.
  126.  
  127.                2) Create a Type 7 menu entry with the following info:
  128.  
  129.                   ───────────────────────────────────────────────────
  130.  
  131.                   1         2         3         4         5         6
  132.                   123456789012345678901234567890123456789012345678901
  133.                   [^W^] Who Called Today (RA-Callers Program)
  134.  
  135.                   COMMAND.COM /C RAMULTI.BAT *N
  136.  
  137.                   ───────────────────────────────────────────────────
  138.  
  139.                   The optional data is what is important here.  The
  140.                   COMMAND.COM /C RAMULTI.BAT simply calls the batch
  141.                   file.  Make sure the batch file that runs RA-Callers
  142.                   is placed in a pathed directory so RA can easily
  143.                   locate it.  The *N tells RAMULTI.BAT which node
  144.                   number the program is being executed for.  The
  145.                   number passed by *N becomes the %1 in the batch
  146.                   file.
  147.  
  148.                3) Modify the batch file to suit your needs.  In this
  149.                   setup, RA-Callers needs to know where to find files
  150.                   such as DORINFO1.DEF and EXITINFO.BBS.  The syntax is:
  151.  
  152.                           syntax: RACALLER.EXE [Path to Files]
  153.                               ie: RACALLER.EXE C:\RA\LINE%1
  154.  
  155.                   The %1 represents the node number passed by the *N
  156.                   from RemoteAccess.  In this example, if the nodenumber
  157.                   was 1, RA-Callers would look for the files in the
  158.                   directory C:\RA\LINE1.
  159.  
  160.                   For more help on this, see the example batch file
  161.                   RAMULTI.BAT.
  162.  
  163.  
  164. ╓──────────────╖
  165. ║ RACALLER.CFG ║
  166. ╙──────────────╜
  167.  
  168.       The file RACALLER.CFG is a text configuration file that gives
  169.       RA-Callers information needed to operate.  The format of the
  170.       file is as follows:
  171.  
  172.                                                     Example:
  173.                                                     ════════════════════
  174.              Line 1: Name of your Bulletin Board    The MASS Hysteria BBS
  175.              Line 2: Path to file LASTCALL.BBS      C:\RA
  176.              Line 3: Allow birthday option?         Y
  177.              Line 4: Show real names or handles     REAL
  178.  
  179.           ■ The Path to file LASTCALL.BBS (Line 2) is the path where your
  180.             BBS data files are stored.  This is NOT the directory of an
  181.             individual node, it is the main BBS directory.
  182.  
  183.           ■ The allow birthday option? (Line 3) must be set to Y or N
  184.             for either "Yes" or "No".  If set to yes, the options that
  185.             deal with the user's birthday will be allowed.  See the
  186.             previous description of what the birthday options are.
  187.  
  188.           ■ The show real names or handles option should be set to
  189.             tell RA-Callers whether to display the real names of
  190.             the users or their handles.  Set this to REAL for
  191.             real names or HANDLES for handles.
  192.  
  193.       The actual setup of the door is complete.  Now you must install
  194.       the record keeping program, "ADDTODAY.EXE" (Next Section)
  195.  
  196.  
  197. ╓──────────────╖
  198. ║ ADDTODAY.EXE ║
  199. ╙──────────────╜
  200.  
  201.       This is the program that keeps the daily records of RA-Callers.
  202.       To insure that RA-Callers runs successfully, this program must
  203.       be run every night when no other callers will call for that
  204.       evening.  When the program is run, it catalogues the current
  205.       daily callers list.  Add-Today takes the date stamp from the
  206.       current LASTCALL.BBS file, so if you run this after mid-night,
  207.       the previous day will still be recorded.  HOWEVER, if a user
  208.       logs on your system after 12:00 mid-night before you run this
  209.       program, RemoteAccess destroys the information from the previous
  210.       day.  I suggest you run an event at 11:55 PM to run this program.
  211.  
  212.       Add-Today only needs to know find the LASTCALL.BBS file.  From
  213.       your RA-Callers directory, execute the program as follows:
  214.  
  215.                           syntax: ADDTODAY.EXE [Path to LASTCALL.BBS]
  216.                               ie: ADDTODAY.EXE C:\RA
  217.  
  218.  
  219. ╓────────────╖
  220. ║ NOSHOW.CTL ║
  221. ╙────────────╜
  222.  
  223.       For RA-Callers to not show a particular name, the user must be
  224.       listed as one of five names in the NOSHOW.CTL file.  Edit the
  225.       file and place it in your RA-Callers directory.  The format
  226.       for the file is simply the name of the user you wish to be
  227.       exempt. If you are using the handles option, then place the
  228.       use the user's handle instead of his/her real name.  See the
  229.       sample file for explanation.
  230.  
  231.  
  232. ╓────────────────╖
  233. ║ SysOp Commands ║
  234. ╙────────────────╜
  235.  
  236.       There are two commands available to the SysOp while a user is
  237.       using RA-Callers.  They are:
  238.  
  239.              ■ F5 Key: Chat Mode      - Break in and talk to the user.
  240.  
  241.              ■ F6 Key: Throw Out User - Returns the user to the system.
  242.  
  243.  
  244.  
  245. ╓─────────────────────╖
  246. ║ And look! Its FREE! ║
  247. ╙─────────────────────╜
  248.  
  249.       One trademark of HysteriaWare Software is the very small fees for
  250.       registrations.  Programs such as Q-Dog and Fowl Play took hours
  251.       of programming and graphics design to put together.  Those programs
  252.       register for only $6.00.  Well, most greed balls would require
  253.       a fairly high registraion fee for this program too.  Because
  254.       our price is low on the "big" programs, this one will be free.
  255.       People often forget that this is supposed to be fun.  Nothing
  256.       annoys me much more than seeing: "This program displays the
  257.       configuration of your system.  If you like it, you must pay me
  258.       $10.00 or disconinue use."  Yeah, right.
  259.  
  260.  
  261.  
  262. ╓────────────╖
  263. ║ DISCLAIMER ║
  264. ╙────────────╜
  265.  
  266.       Since no one really cares, but I have to do it, this section has
  267.       been placed at the END of this document.
  268.  
  269.       RA-Callers may be distributed freely as long as no changes are made
  270.       to the executables or documentaion and no fee is charged for the
  271.       distribution of it.
  272.  
  273.       The MASS Hysteria BBS or myself will not be responsible in any way
  274.       for any damage or aggravation this program could potentially cause.
  275.       The door has been beta tested on RemoteAccess v1.10+ without any
  276.       problems. However, if problems do occur, I will gladly help you fix
  277.       them but not take responsibility.
  278.  
  279.  
  280.  
  281.    ==========================[ End of File ]===============================
  282.