home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LCALL14.ZIP / LOGCALL.DOC < prev    next >
Encoding:
Text File  |  1993-08-08  |  7.7 KB  |  228 lines
  1.        ******************************************************************
  2.  
  3.                              LOGCALL Version 1.4
  4.                                August 10, 1993
  5.  
  6.                         MAXIMUS TODAY'S CALLER LISTER
  7.  
  8.  
  9.  
  10.  
  11.                              Code by Evan Siegworth
  12.                              
  13.                  Docs by Ed Baldwin &
  14.                                      Evan Siegworth
  15.  
  16.  
  17.  
  18.  
  19.                                  USER MANUAL
  20.  
  21.                       Copyright (c) 1992 Evan Siegworth
  22.  
  23.        *******************************************************************
  24.  
  25.  
  26.  
  27.  
  28.   THE LEGAL BUSINESS
  29.   ------------------
  30.  
  31.        LOGCALL operates as specified on the authors' and beta testers'
  32.        systems. Use it at your own risk.  No warranty is stated or
  33.        implied.  The author shall not be responsible for any damages
  34.        resulting from its' use, directly or indirectly.
  35.  
  36.        LOGCALL is distributed as a Freely Available Copyrighted Program.
  37.        You may use, copy, or lose it, but I own the rights to it.
  38.        SysOps may use any compression method acceptable to them for file
  39.        storage on their respective BBS's.  The author asks only that BBS
  40.        advertisements NOT be included in the archive or archive comments.
  41.        No fee may be charged for distribution.
  42.  
  43.        While LOGCALL is freely available for use in non-commercial
  44.        environments, donations to the author will always be gratefully
  45.        accepted.
  46.  
  47.        For information of donations, use on a commercial bbs, or info on
  48.        where to send suggestions, please read the REGIST.DOC included
  49.        in the archive.
  50.  
  51.        LOGCALL will be supported in the MUFFIN Echo, any questions will be
  52.        promptly answered.
  53.  
  54.  
  55.  
  56.  
  57.   THE DISTRIBUTION ARCHIVE (LCALL11.ZIP)
  58.   ---------------------------------------
  59.  
  60.        This archive should contain the following files:
  61.  
  62.        LOGCALL.DOC        -      The complete program documentation.
  63.        LOGCALL.EXE        -      The Executable Program.
  64.        LOGCALL.CTL        -      The Configuration File.
  65.        HISTORY.DOC        -      The program history.
  66.        README.OS2         -      Information for OS/2 Users.
  67.        REGIST.DOC         -      Donation/Registration Information.
  68.            
  69.        
  70.  
  71.   WHAT DOES IT DO
  72.   ---------------
  73.  
  74.        LOGCALL is a Maximus CBCS Today's Callers List Creation utility which
  75.        can create a list of the users whom have called today and a list of
  76.        the last few callers.  It is very configurable.  YOU! set up how you
  77.        want the utility to display the information.
  78.        It creates .BBS files that can be directly displayed to the user.
  79.  
  80.  
  81.   CONFIGURATION FILE
  82.   ------------------
  83.     
  84.     LogCall reads a Config file (<name>.cfg) to get your specified
  85.     options and parameters.
  86.     To make a .cfg file, you must first edit the Control file (<name>.ctl)
  87.     to your liking.  Note: You can have more than one Control file.  Which
  88.     one is used is specified on the command line.
  89.     After editing, you must compile the Control file with the '/u' option.
  90.         LOGCALL /u <name>   (<name> has NO extension!)
  91.     This will create <name>.cfg.
  92.  
  93.   CONTROL FILE
  94.   ------------
  95.  
  96.     Most of the Control file is self-explanatory.
  97.     Some notes:
  98.         -When specifing filenames, paths are not needed if you want
  99.          the file to be created in the current directory.
  100.          If you want to specify a different directory, you must 
  101.          type in the FULL path including drive letter.
  102.         
  103.         -If you make a change, be sure to re-compile 
  104.  
  105.         -Each section must end with the 'End' statement.
  106.  
  107.     The 'CustomDisplayLine' section is the most complicated section so I
  108.     am covering its explanation here.
  109.     This is also the most unique feature of this program.  YOU control
  110.     how the    program displays its information. 
  111.     
  112.     Each display line must be proceeded by its name.      
  113.     
  114.     Entering the display line is alot like entering a line in a MECCA file.
  115.     Straight text will be copied directly.  And there are several 
  116.     informational tokens that can be placed on the line, as well as
  117.     all the regular color tokens.  At this time, however, background
  118.     colors and blinking are not supported.
  119.     
  120.     For Example:
  121.     A display line like this:
  122.  
  123. User # 23 Evan Siegworth        calling from Channelview, TX
  124.         
  125.     Would be entered like this:
  126.  
  127. #TEST
  128. #User # [user] [name]  calling from [city]
  129.  
  130.     Its that simple!
  131.     You can spice it up by adding color tokens.
  132.     
  133.     To then use this in your Todays Callers List, you add the line
  134.         StatLine    TEST
  135.     to the 'TodaysCallers' section in the control file.
  136.  
  137.     The Header lines are similar, however, they do not use any of the info
  138.     tokens.  The header line is displayed at the beginning of the file.
  139.     Example Usage:
  140.     (in appropriate section)        
  141.         Header        TEST2
  142. (in CustomDisplayLine section)
  143. #TEST2
  144. #<-----------------------TODAYS CALLERS------------------------>
  145.  
  146.  
  147.     Some important notes:
  148.     Only ONE token per bracket.  [user green name city] will NOT work.
  149.     Your display line MUST be the next line after its name header.
  150.     
  151.     Several display lines are included in the .ctl that came with
  152.     the program.  Use them or create your own.
  153.     You can use ORACLE to test your display lines.
  154.  
  155.         AVAILABLE TOKENS:
  156.  
  157.               MAXIMUS Colour Tokens
  158.               [START] - Logon Time
  159.               [END] - Logoff Time
  160.               [DATE] - Logon Date
  161.               [NAME] - User's Real Name
  162.               [ALIAS] - User's Handle/Alias
  163.               [CITY] - User's City/State
  164.               [BAUD] - User's Baud Rate(displays LOCAL for local calls)
  165.               [TOTAL] - Total Number of Calls
  166.               [TIME] - Minutes Spent Online
  167.               [USER] - User Number(field length is 3 spaces)
  168.  
  169.  
  170.   USING LOGCALL
  171.   -------------
  172.     
  173. **    LogCall is run in your batch file that starts the bbs
  174.     with the command...
  175.  
  176.            LOGCALL %1
  177.     %1 being the name/path of your Config file (no extension)
  178.  
  179.     For Example:
  180.        LOGCALL LOG
  181.     (if LOG.CFG exists in current dir)
  182.     
  183.     You should only run it after an errorlevel 5 exit.
  184.     During its operation LogCall will check the Lastuser.bbs to see
  185.     if its newer the last time it was run.  This prevents it from
  186.     running after a dropped carrier and other situations where there
  187.     really wasnt a caller.
  188.     You can, however, disable this option with the '/t' option.
  189.        LOGCALL /T LOG
  190.     This is primarly useful when testing your Display Lines.
  191.  
  192. **    Note to Multi-Node systems:  You can create more than one .cfg
  193.     files; one specific to each node.  You can create seperate lists
  194.     for each node, or have it keep one list for all your lines.
  195.  
  196. **    You should delete the today's callers list (example: Callers.bbs)
  197.     every night.  Put it in your nightly maintance.    
  198.  
  199. **      Next add a command to your MAXIMUS MENUS.CTL file:
  200.     (using Callers.bbs from above sample .ctl file.  substitute own
  201.      name of course)
  202.  
  203.           Display_File  Misc\Callers             Twit "Todays Callers"
  204.  
  205. **      If you wish to utilize the Last Few Callers feature.
  206.     Add a [LINK] command to your WELCOME.BBS or other file that you
  207.         wish to display to the users at logon to show the last few callers.
  208.  
  209.           [LINK]C:\MAX\MISC\CALLS
  210.  
  211.   THANKS...(as of yet)
  212.   ---------
  213.     
  214.     Thanks to Scott Dudley for his excellent BBS System!
  215.     to Ed Baldwin for his help with code development, testing and DOC
  216.        writing.
  217.     to Gary Seid for his numerous bug reports!  :)
  218.     to David Drzyzga for his suggestions for multi-node use.
  219.     and to ALL who are patiently waiting through the bug-fix releases.
  220.  
  221.   CREDITS
  222.   -------
  223.  
  224.          BORLAND C++  ... Copyrighted by Borland International, Inc.
  225.          ORACLE &
  226.      MAXIMUS CBCS ... Copyrighted by Scott Dudley
  227.          LOGCALL      ... Copyrighted by Evan Siegworth
  228.