home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / d / dc_106.zip / DC.DOC < prev    next >
Text File  |  1992-09-13  |  7KB  |  186 lines
  1. DC - Display Callers for Maximus 2.01wb and under.
  2.      Version 1.06
  3.  
  4.  
  5. Warranty:
  6.  
  7.         None, I will not be held liable for any damage, whether
  8.         direct or consequential, relating to the use of DC.
  9.         You acknowledge this in full by using DC.
  10.         Use DC at your own risk ! !
  11.  
  12. Intro:
  13.         Why another who called utility?
  14.  
  15.         Well I couldn't find one that worked the way I wanted.  I wanted
  16.         a display program where colors were configurable.  I wanted to
  17.         display each user each time they called with an online and offline
  18.         time. I also wanted the ablility to not include the sysop's name
  19.         in the display. Lastly I didn't want to have to delete the display
  20.         file in my nightly events. So DC was created.
  21.  
  22.  
  23.         DC reads your Lastread.BBS and gathers the information to
  24.         display each callers name, city/st/province, time on, and time off.
  25.         DC also reads a config file called DC.CFG to get the paths, names,
  26.         and colors to run. After getting all this information, DC makes a
  27.         .MEC file which then is compiled with MECCA.EXE. You then have a
  28.         nice looking display file off your callers.
  29.  
  30.         Display Caller no longer uses direct screen writes so if your using
  31.         Desqview, the display won't bleed over to another window.
  32.  
  33.         Display Caller now has the option to display Alias Names or
  34.         Real Names.  More on this later.
  35.  
  36.  
  37. Installation:
  38.  
  39.         DC consists of three files.
  40.  
  41.         DC.EXE   Executible Program
  42.         DC.DOC   This Documentation.
  43.         DC.CFG   Configuration File for DC.
  44.  
  45.         First copy all three files into your main BBS directory.
  46.  
  47.         Then you need to edit DC.Cfg with your favorite text editor.
  48.  
  49.         The following is a descriptive example of what DC.CFG should look
  50.         like. If you follow the same format, everything should work fine
  51.  
  52. Sample DC.CFG:
  53.  
  54. E:\Max\Lastuser.BBS      - This is the full path to Lastuser.BBS.
  55. E:\Max\Misc\DC.Mec       - This is the full path of your Display File (.MEC).
  56. The Hook and Slice Club  - This is your BBS Name.
  57. Sysop Name               - If your name is here, it will not be displayed.
  58. E:\Max\Mecca.Exe         - This is the full path to Mecca.Exe.
  59. [white]                  - Color for the Title in display (Today's Callers On).
  60. [lightblue]              - Color for the Date in display file.
  61. [white]                  - Color for the Lines in display file.
  62. [yellow on blue]         - Color for Headings in display file.
  63. [lightcyan]              - Color for User Name column in display file.
  64. [lightgreen]             - Color for City/State/Province column.
  65. [lightred]               - Color for Time On column.
  66. [lightred]               - Color for Time Off column.
  67. NO                - Alias Switch. NO displays Real Name, YES display's Alias
  68.  
  69.  
  70. Note:   If you have the Alias Switch set to YES and a user doesn't have
  71.         an alias, DC will use his Real Name instead.
  72.  
  73. Note:   Sysop Name must be exactly as it appears in the User File for Maximus.
  74.  
  75.         Thats It!, 14 lines. Save and your done with this file.
  76.         Make sure you include full paths on the lines that require full paths.
  77.         Any valid Mecca color may be used in the color area of DC.CFG.
  78.         All Mecca color tokens are listed in Max_Ref.Prn on Page 99.
  79.  
  80.         Now, in your Menus.CTL you need to add a entry to let the users
  81.         display the display file. So, edit Menus.CTL and add the following
  82.         line to your Main Menu.
  83.  
  84.         Example:
  85.  
  86.         Display_File    Misc\DC                Disgrace "Today's Callers"
  87.  
  88.         Then save Menus.Ctl and type Silt Max.
  89.  
  90.  
  91.         Ok, you want to run this after every caller so each caller will be
  92.         added to the display file. So, I have included an example of my
  93.         Exebbs.bat which is what FrontDoor (Front-End Mailer) generates.
  94.         If you run Binkley, you probably use Spawn.bbs or Startmax.bat for
  95.         those of you using just Maximus.
  96.  
  97.         I have DC run after every caller except when Maximus exits with
  98.         and errorlevel of 2. Errorlevel 2 means the caller never made it
  99.         past the "What's Your Name" prompt. If you don't do this, then DC
  100.         will add the last person who's name is in Lastuser.bbs to the
  101.         display file and your display file would be incorrect.
  102.  
  103.         Here is an scaled example of my Exebbs.Bat:
  104.  
  105.         echo on
  106.         cls
  107.         :loop
  108.         cd\max
  109.         Max -b%1 -p1 -t%3
  110.  
  111.         :reload
  112.         if errorlevel 47 goto game1
  113.         if errorlevel 46 goto game2
  114.         if errorlevel 3 goto utilities
  115.         if errorlevel 2 goto nouser
  116.  
  117.         :utilities
  118.         dc
  119.         scanbld user.bbs area.dat all
  120.  
  121.         :nouser
  122.         cd\fd
  123.         runfd
  124.  
  125.         :game2
  126.         cd\game1
  127.         "load game here"
  128.         CD\MAX
  129.         max -r
  130.         goto reload
  131.  
  132.         :game1
  133.         cd\game2
  134.         "load game here"
  135.         cd\max
  136.         max -r
  137.         goto reload
  138.  
  139.  
  140.  
  141.         Thats It! (I Hope. <smile>)
  142.  
  143.         With this setup, DC will be ran for every valid caller and
  144.         each user will be added to your display file for viewing.
  145.         Each day a new display file is created. DC gets the date
  146.         from your system.  If the system date and the date in
  147.         your display file differ, then a new display file will
  148.         be created, otherwise the data is just appended to the
  149.         display file.
  150.  
  151.  
  152.         Hope you enjoy my program.
  153.  
  154.  
  155.         Thanks Scott Dudley for writing the Best BBS package around.
  156.  
  157.  
  158.         This program is Freeware. If you use and like my program,
  159.         please send me a postcard or something. I'd like to know
  160.         what other sysops think of it.
  161.  
  162.  
  163.  
  164.         Bill Spicer
  165.         The Hook and Slice Club BBS
  166.         202 Warrington Ave.
  167.         Danville, IL 61832  USA
  168.         FidoNet 1:233/6
  169.  
  170.         You can FREQ DC from the above address using DC
  171.         as the Magic Filename.
  172.         
  173.         DC was written using Microsoft's Basic Professional Development
  174.         System Version 7.1
  175.  
  176. History:
  177.  
  178.         1.03 - First public release.
  179.         1.04 - Fixed spacing problem when writing user's name and city.
  180.         1.05 - No longer uses direct screen writes to fix bleeding
  181.                over problem in Desqview. Added alias display option.
  182.         1.06 - DC now trims leading spaces off of entries in DC.CFG.
  183.  
  184.  
  185.  
  186.