home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / DCALL410.ZIP / DCALL.TXT < prev    next >
Encoding:
Text File  |  1993-03-04  |  9.9 KB  |  242 lines

  1.                          ======== ======   =======
  2.                             ==    ==   ==     ===
  3.                             ==    ==   ===   ===
  4.                             ==    ==   ==   ===
  5.                             ==    ======   =======
  6.  
  7.                    =======================================
  8.                    The DeAdZoNe Utilities for RemoteAccess
  9.                    =======================================
  10.  
  11.                                      D-CaLL
  12.                Today's Callers Bulletin Generator for RemoteAccess
  13.                           Version 4.10   March 2, 1993
  14.                        (C) Copyright Victor Magdic 1992-93
  15.                                All Rights Reserved
  16.  
  17.  
  18. Description
  19. -----------
  20.  
  21. D-CaLL is a door for RemoteAccess *2.00* which replaces the built in "Today's
  22. Callers" function. Not only does D-CaLL look better <grin>, but it also has the
  23. following features:
  24.    
  25.    *   Runs as a door.
  26.    *   Will display `Last XX callers' or all the callers.
  27.    *   The ability to mask local logons so that they look like ordinary calls.
  28.    *   People who have only called one time (i.e. new users) are listed as "NEW
  29.        USER".
  30.    *   The ability to exclude up to 100 users from the Today's Callers List,
  31.        based on a control file which you create.
  32.    *   Supports the "hidden" attribute in the user record, so if you have a
  33.        user toggled as "hidden" they will not be displayed in the Today's
  34.        Callers List.
  35.    *   Supports locked baud rates.
  36.    *   The screen length is adjusted to the users setting to provide full
  37.        screen display on the users end.
  38.    *   Does full carrier monitoring and will immediately return to the BBS if
  39.        the user drops carrier.
  40.    *   Inactivity timeout feature. D-CaLL will return to the BBS if the user
  41.        does not respond within two minutes at the screen pause prompt.
  42.    *   DESQview aware. D-CaLL will give up it's time slice when waiting for
  43.        user input at the screen pause prompt. D-CaLL will automatically detect
  44.        if DESQview is present.
  45.    *   Uses a fossil driver to provide interupt driven serial i/o.
  46.    *   Displays the node number which the caller was on
  47.    
  48.  
  49.    Note: D-CaLL 4.10 is written for RA 2.00
  50.    
  51.  
  52. How much does it cost?
  53. ----------------------
  54. This utility is FREE!  If you like it you can continue to use it for as long as
  55. you like free of charge!
  56.  
  57. If you do decide to use it, I would be excited to hear from you !!  I encourage
  58. you to send me a postcard at the address listed below (see the end of this text
  59. file), or a message via netmail. It will cost you practically nothing, and will
  60. let me know you're enjoying the program. It will also give me incentive to keep
  61. improving the program and make it even better!
  62.  
  63. Of course donations are graciously accepted <grin> -and if you want to send a
  64. small donation please see the address at the end of this text file.
  65.  
  66.  
  67. Configuration
  68. -------------
  69. Run D-CaLL with the /C switch to bring up the Configuration Menu.  The options
  70. are described below:
  71.  
  72.  
  73. Sysop Name               The Sysop's name.
  74.                          
  75. BBS Name                 The name of your BBS.
  76.                          
  77. Masked Baud Rate         Normally when someone logs on locally to your BBS,
  78.                          RemoteAccess reports their baud rate as "0", and will
  79.                          display it as "0" in the "built in" Today's Caller List.
  80.                          In some circumstances it may not be desirable for your
  81.                          users to know who is logging on locally... D-CaLL solves
  82.                          this problem by automatically masking calls which have a
  83.                          baud rate of "0".
  84.                          
  85.                          Use this option to choose the masked baud rate you want.
  86.                             
  87.                             Note: The "0" baud masking is completely internal
  88.                                    and only occurs at run time. It does not
  89.                                    modify any RA files (e.g. LASTCALL.BBS or
  90.                                    USERON.BBS)
  91.                          
  92. Sysop Name in bulletin   If you want the sysop's name included at the top of the
  93. header                   bulletin then turn this option. (Note: the name is use
  94.                          is whatever you have specified under "sysop name".)
  95.                          
  96. Use Handles              Choose YES to use handles instead of real names.
  97.                          
  98. Honour Hidden Attribute  Set this to YES if you want D-CaLL to hide a user from
  99.                          the bulletin if their `hidden' attribute is set (in the
  100.                          RA user file).
  101.                          
  102.                             Note: This is a good way to hide the sysop <grin>
  103.                          
  104. Show Date                Set to YES if you want to show Today's date at the top
  105.                          of the bulletin.
  106.                          
  107. Use Exclusion File       If you want to use an exclusion file, turn this option
  108.                          on (see discussion on exclusion file later in the docs).
  109.                          When you choose YES you will be asked to specify a
  110.                          directory where the exclusion file (DCALL.CTL) can be
  111.                          found. Normally this will be the same directory where
  112.                          DCALL.EXE is located.
  113.                          
  114.  
  115.  
  116.  
  117. Command Line Switches
  118. ---------------------
  119. D-CaLL supports two command line switches.
  120.  
  121. To run D-CaLL in local mode:
  122.  
  123.      DCALL /L
  124.  
  125.    Note: D-CaLL will also run in local mode automatically when it detects the
  126.          baud rate in dorinfo1.def is 0 (e.g. when you are logged on locally to
  127.          your BBS).
  128.    
  129.    Note: D-CaLL *no longer* requires a fossil driver to be loaded for LOCAL
  130.          operation (the fossil is still required for online operation of
  131.          course).
  132.    
  133. To have D-CaLL show the last XX callers (e.g. last 10 or 15), use the following
  134. switch:
  135.    
  136.        DCALL /Nxx       -where xx is the number of last callers to
  137.                         display. Example:  DCALL /N10 will display the
  138.                         last 10 callers to your system
  139.    
  140.    
  141. Exclusion List
  142. --------------
  143. D-CaLL supports an exclusion list which allows you to specify up to 100 users
  144. which you do not want included in the Today's Callers Bulletin. This is useful
  145. if you have users (or co-sysops) which you want to "hide" from the listing.
  146.  
  147. In order to use this feature you must create a plain ASCII text file called
  148. DCALL.CTL and simply list the name or handle of the user which you want excluded
  149. (one entry per line). As well, be sure to set `Use Exclusion File' to YES in the
  150. configuration editor.
  151.  
  152.    *   It is not necessary to specify both a user's real name and their
  153.        handle as separate entries, one or the other will suffice.
  154.    *   The entries in DCALL.CTL are *not* case sensitive, so if you have
  155.        "John Smith" in your DCALL.CTL file, and the users name is actually
  156.        spelt "JoHn SmItH", the name will still be properly excluded.
  157.    *   If you have more than 100 entries in DCALL.CTL, D-CaLL will abort   with
  158.        an appropriate error message.
  159.  
  160.    Example of DCALL.CTL:
  161.  
  162.       John Smith
  163.       Jane Smith
  164.       The Punisher
  165.    
  166.  
  167. How To Use D-CaLL
  168. -----------------
  169. D-CaLL is designed to be run as a door. The best way to run it is to set it up
  170. as a type 7 exit (D-CaLL uses very little RAM so swapping is not necesary). D-
  171. CaLL will read all the necessary com-port information from the DORINFO1.DEF
  172. file.
  173.  
  174. D-CaLL requires that a fossil driver be installed in order to function for
  175. remote callers. For local mode operation, no fossil driver is required.
  176.  
  177.  
  178. Location of Files
  179. -----------------
  180. In order for D-CaLL to function properly you must have your RA environment
  181. variable set (see the RA docs for more information on the RA environment
  182. variable). D-CaLL can be run from any directory.
  183.  
  184.    Note:D-CaLL does *not* write to any RemoteAccess files.
  185.  
  186.  
  187. Legal Stuff and Disclaimer
  188. --------------------------
  189. "D-CaLL" refers to the executables and documentation in the original
  190. distribution archive. D-CaLL is copyrighted material by the author, Victor
  191. Magdic. All rights are reserved.  The author grants you a licence to use this
  192. software free of charge.
  193.  
  194. The program is provided "as is", without warranty or guarantee of any kind,
  195. either expressed or implied, as to its quality or performance. The author will
  196. not be held liable to you or anyone for any direct, indirect, incidental or
  197. consequential damages, including but not limited to any lost profits, or lost
  198. savings which may result from the use or inability to use this program.
  199.  
  200. The author is in no way obligated to provide future versions of this software.
  201.  
  202. Your use of the program constitutes your agreement to these terms and to this
  203. disclaimer.
  204.  
  205. All mentioned products are copyrighted by and trademarks of their respective
  206. holders.
  207.  
  208.  
  209. Credits
  210. -------
  211. Thanks to James FitzGibbon for helping me beta test D-CaLL and for his numerous
  212. suggestions and helpful criticism.  Thanks also to Ian McKenzie for lending me
  213. his computer so I could debug the fossil routines in the earlier version of D-
  214. CaLL.
  215.  
  216.  
  217. Updates
  218. -------
  219. Please see the enclosed file DEADZONE.TXT for information on how to obtain the
  220. latest version of D-CaLL.
  221.  
  222.        
  223. Suggestions always welcome!
  224. ---------------------------
  225. If you have any suggestions for improvement or wish to  report any bugs, you can
  226. reach me via netmail:
  227.        
  228.        The DeAdZoNe
  229.        Victor Magdic
  230.        FidoNet: 1:259/427
  231.        TeleNet Canada: 20:22/104
  232.        
  233.        or by writing to:
  234.        
  235.        Victor Magdic
  236.        424 Camden Circle
  237.        Mississauga, Ontario
  238.        L4Z 2P4
  239.        CANADA
  240.        
  241. ------------------------------------------------------------------ end
  242.