home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / CATC139.ZIP / CATCALL.ASC next >
Encoding:
Text File  |  1993-05-02  |  11.0 KB  |  308 lines
  1.                               
  2.                               
  3.                     catCALL Version .1.39
  4.            "A Last Caller Identification Program"
  5.       Written Exclusively for WildCat! BBS Version 3.XX
  6.                      By: Greg Sunderland
  7.                    SysOp of Tech Noir BBS
  8.                               
  9.                    All Rights Are Reserved
  10.                               
  11.                               
  12.                   catCALL Table of Contents
  13.                               
  14. catCALL Features List                                    2
  15. Overview of Operation                                    2
  16. Liscense Agreement                                       3
  17. Warranty                                                 3
  18. Acknowledgments                                          3
  19. Special Thanks                                           3
  20. Supplied Files List                                      4
  21. Installation Instructions                                4
  22. Command Line Options                                     5
  23. Notes on catCALL.CFG                                     5
  24. How to Contact the Author/Requests for
  25. Modifications/Donations                                  7
  26. Version History                                          8
  27.  
  28.                               
  29.                               
  30.                               
  31.                               
  32.                               
  33.                               
  34.                               
  35.                               
  36.                               
  37.                               
  38.                               
  39.                               
  40.                               
  41.    Note: If you are reading the ASCII version of this file
  42.     you may see some characters which were not removed in
  43.       its conversion from the Microsoft Word .DOC file.
  44. catCALL Features List
  45. catCALL Features List
  46.   FREEWARE! You don't pay NUTT'IN!
  47.   SysOp created ANSI header file (Examples are
  48.   supplied)
  49.   Simple Installation
  50.   Quick Operation, Catcall is written in C++
  51.   SysOp definable, color-coded baud rate
  52.   identification
  53.   Stealth Mode for SysOp logins
  54.  
  55. Overview of Operation
  56. Overview of Operation:
  57.  
  58.      If you are unsure of whether or not catCALL may
  59. suit your needs please read the following information:
  60.  
  61.      For WildCat! 3.6+ systems immediately after a user
  62. logs onto the system and correctly types his password
  63. the LOGINX.BAT file is executed.  With WildCat! 3.5X
  64. and lower systems catCALL is executed from the
  65. POSTCALL.BAT file.  In the latter case the user will
  66. not be able to see his name in the login list.  After
  67. being executed, catCALL reads the DOS enviroment
  68. variable WCNODEID to determine which node the program
  69. is being run from.  Upon finding the correct node
  70. catCALL then opens a node configuration file which
  71. states the explicit path to that node's activity log
  72. and the display file associated with that particular
  73. node.  In this manner multiple nodes can list their
  74. output to separate files or all to the same file if
  75. wished.  After reading this configuration information
  76. in catCALL proceeds to extract information from the
  77. ACTIVITY log.  It will then check that callers baud
  78. rate against that found in the catCALL.CFG file in
  79. order to determine the color in which to display the
  80. current user.  Colors are any 2 character WildCat!
  81. @CODE@.  By default catCALL will check the current
  82. user's name against that of the SysOp and if it there
  83. is a match he will not be listed.  Note: this can be
  84. overided with the command line option of sysop.
  85. Otherwise, catCALL will then append this information to
  86. the appropriate file and exit.
  87. Liscense Agreement
  88. Notice: License Agreement
  89.  
  90. This release of catCALL is FREEWARE/BEGWARE.  You are
  91. not required to register it in anyway.  If you use it
  92. and would like to send me a couple bucks to ease your
  93. conscience then please do.  Please note that I do not
  94. guruntee that future releases will be FREEWARE and I
  95. reserve all rights to change this liscense with future
  96. versions.
  97.  
  98. Warranty
  99. Warranty:
  100.  
  101. catCALL is provided as is without any warranties
  102. expressed or implied, including but not limited to the
  103. implied warranties of merchantability and fitness for
  104. any purpose.  The entire risk of using catCALL and all
  105. associated utilites is assumed by the user of the
  106. program.  The programmer, Greg Sunderland is not
  107. responsible for any damage or loss of information
  108. caused either directly or indirectly by this program.
  109. By executing catCALL you agree to these agree to these
  110. terms.
  111.  
  112. Acknowledgments
  113. Acknowledgments:
  114.  
  115. TheDraw (TM) (c) TheSoft Programming Services and Ian
  116. E. Davis
  117. WildCat! (TM) (c) Mustang Software, Bakersfield CA
  118. Word (TM) (c) Microsoft Inc., WA
  119.  
  120. Special Thanks
  121. Special Thanks:
  122.  
  123.      All my users on Tech Noir BBS for helping me
  124.      trouble shoot this program.
  125.      Will Wagner, SysOp of The Editorial Page BBS for
  126.      moral support.
  127.      Charles Dowling & Admiral Gracie Hopper for
  128.      programming inspiration.
  129.      And last but not least, Mustang Software Inc. for
  130.      making such an excellent Bulletin Board System and
  131.      providing it at a reasonable price.
  132.  
  133. Supplied Files List
  134. Supplied Files List
  135.  
  136. catCALL.EXE    The executable program
  137. catCALL.HDR    Sample text header file using WildCat
  138.                @codes@.  This file may be replaced by one of
  139.                your own design.
  140. catCALL.DOC    This instruction manual in Wordr for Windows
  141.                Version 2.0 format.
  142. catCALL.ASC    This instruction manual in common DOSr ASCII
  143.                format.
  144. CCALL1.CFG     catCALL sample configuration file for Node 1
  145.                of a BBS
  146. catMAINT.EXE   catCALL's nightly maintenance program.
  147. catCALL.CFG    catCALL's @CODE@'ed configuration file for
  148.                colors
  149.  
  150. Installation Instructions
  151. Installation Instructions:
  152.  
  153. 1.  Copy the following files to the root directory of your
  154.                WildCat! BBS
  155.  
  156. catCALL.EXE    catCALL executable file
  157. catMAINT.EXE   catCALL's Nightly Maintenance program
  158. catCALL.HDR    SysOp created or Supplied ANSI file
  159. catCALL.CFG    Color configuration file
  160. ccallXXX.CFG   Node Configuration file supplied
  161.  
  162. 2.  Edit the sample CCALLX.CFG configuration file that
  163. is supplied with this package or you can make one of
  164. your own by deleting it and then executing catCALL.
  165.  
  166. a.  To have a configuation file created for you execute
  167. the program with the following command line parameter:
  168.  
  169. catCALL RUN
  170.  
  171. The program will then try to execute as if called after
  172. a login by a user.  It will search for a configuration
  173. file and after not finding one will ask you some
  174. questions providing examples.  Afterward catCALL will
  175. create a configuration file for node one of your BBS.
  176. Which you may clone for other nodes after renaming
  177. them.
  178.  
  179. 3.  Now you must create an output file.  To do this
  180. execute caMAINT:
  181.  
  182. catMAINT RUN
  183.  
  184. This will create the output file (typically HELLO2.BBS
  185. which is displayed immediately after you logon screen,
  186. HELLO1.BBS) in the directory that you have specified.
  187. Running catMAINT with the "RUN" option appends to the
  188. caller list file the ANSI header file that you have
  189. created using an ANSI editor like TheDrawr.
  190.  
  191. 4.  Now just add the following line to WildCat!r's
  192. LOGIN1.BAT file:
  193.  
  194. catCALL RUN
  195.  
  196. NOTE: if you don't have a LOGIN1.BAT file then you will
  197. have to create one.  Also if you are running a version
  198. of WILDCAT! prior to 3.60 then you will have to use the
  199. batch file POSTCALL.BAT in which case your user won't
  200. see himself in the last caller list.
  201.  
  202. 5. Nightly maintenance is performed by executing
  203. catMAINT with the RUN parameter.  Add this command to
  204. your nightly maintenance batch file:
  205.  
  206. catMAINT RUN
  207.  
  208. This erases the current output file and makes another
  209. with the header file which you have created or I have
  210. supplied.  Remember!  To have this run automatically
  211. you have to enter it into a nightly event batch file
  212. that you have executed by WildCat!.  If you don't run
  213. catMAINT with the nightly maintenance the last calers
  214. list will keep growing.  It is up to you how often that
  215. you have it purged.
  216.  
  217. That is all there is too it.
  218.  
  219. Command Line Options
  220. catCALL Command Line Options
  221.  
  222.        Option                    Example
  223. sysop                  catcall run sysop
  224.  
  225.  
  226.  
  227. Notes on catCALL.CFG
  228. catCALL.CFG Notes
  229.  
  230. catCALL.CFG contains a list of different baud rates and
  231. the color @CODE@'s associated with them.  I have picked
  232. a couple at random and you are welcome to go in and
  233. change them to whatever you would like.  Any color
  234. @code@ is supported.
  235.  
  236. A Note about catCALL.CFG's placement.  I don't have the
  237. path to catCALL.CFG specifically stated anyplace so
  238. catCALL will probably want to get to it in the same
  239. directory that it is in.  In a future version of
  240. catCALL I will be implementing an explicit path to this
  241. file in each node's configuration file.  That way
  242. different nodes could be displayed in different colors.
  243.  
  244. Here is the file at this moment:
  245.                          CATCALL.CFG
  246.                               
  247. 14400     @0C@     Bright Red
  248. 9600      @09@     Bright Blue
  249. 2400      @02@     Dark Green
  250. 1200      @01@     Dark Blue
  251. 300       @8A@     Flashing Bright Red!
  252. LOCAL     @0E@     Bright Yellow
  253.  
  254. How to Contact the Author/Requests for
  255. Modifications/Donations
  256. How to Contact the Author/Requests for
  257. Modifications/Donations:
  258.  
  259. If you would like to see something added to catCALL
  260. then feel free to email me either via the MSI Support
  261. Network if you are connected or via email on my BBS,
  262. Tech Noir.  Tech Noir's phone numbers are:
  263.  
  264.      (410)-859-0974 USR Dual 14.4k HST,V32, V32bis
  265.      (410)-859-1998 Twincom 14.4k V32, V32bis
  266.  
  267. I don't mind feedback, constructive criticism, or
  268. donations! So please feel free to send up any of the
  269. previous!
  270.  
  271.                         Tech Noir BBS
  272.                          PO BOX 462
  273.                      Linthicum, MD 21090
  274. Version History
  275. Version History
  276.  
  277.    Version                          Description
  278.               
  279. 1.00-1.20     catCALL non-release beta versions
  280.               Configuration files used for each node
  281.               User definable ANSI header files implemented
  282.               
  283. 1.20          Separate maintenance file, catMAINT created
  284.               
  285. 1.21          catMAINT re-written in C++
  286.               
  287. 1.36          Parts of catCALL are re-written in C++
  288.               
  289. 1.37          catCALL gets @CODED@ Color configuration file for
  290.               caller's baudrates.
  291.               
  292.               First public release
  293.               
  294. 1.38          File sharing edited to allow all accesses to any
  295.               file that catCALL has open
  296.               
  297.               Table of Contents added to Dox and erroneous
  298.               information from previous releases removed removed
  299.               from them.
  300.               
  301. 1.39          SysOp Stealth mode added.  Allows sysop to logon
  302.               in secrecy.
  303.               
  304.               Default file naming convention changed to:
  305.               "CATCXXX.ZIP" where XXX is the current version
  306.               number.
  307.  
  308.