home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / w / who503.zip / WHOCALL.DOC < prev    next >
Text File  |  1993-01-03  |  10KB  |  244 lines
  1. WhoCalled? PRO! Version 5.00
  2.  
  3. 01 January 1993
  4.  
  5. PCBoard is owned by Clark Development Inc.
  6. WhoCalledPRO is owned by Bill Fink - User Friendly Systems And NCCBBS.
  7.  
  8. * * * New In Version 5.03N - WhoCalled Professional Is "N"etwork Smart! * * *
  9.  * * *   5.03N Is STILL FULLY FUNCTIONAL ON NON-Network Environments! * * *
  10.  
  11. If you use a previous version of whocalled, you'll want to start
  12. version 5 from SCRATCH. (This INLCUDEs Owners Of Version 4.0)
  13.  
  14. "WhoCalledPRO!" Is "WhoCalled?" TOTALLY RE-Written.
  15.  
  16. PLEASE read this WHOLE note BEFORE You report problems.
  17.  
  18. You need NOT  go  on  any  further with "WhoCalled?" if you alter your PCBTEXT
  19. files. I search the "callers" file for  literals, that MATCH text EXACTLY in
  20. the PCBTEXT file. For example; if you change "(D)ownload Completed" to
  21. "(D)OWNLOAD COMPLETED", note  the  case  of  the letters, or alter
  22. PCBTEXT.fil, WHOCALLED may NOT work for you. Please keep in mind,
  23. those who use optional languages, those optional languages are simply
  24. modified PCBTEXT files.
  25.  
  26. The first item  I  guess everyone goes over with any utility that's written is
  27. the "I am not responsible" routine. Sorry guys/ladies, the same goes here. You
  28. KNOW what I mean. You are using WhoCalled? at your own risk.
  29.  
  30. I WILL say this, WhoCalled? is a VERY simple  utility that merely LOOKS at the
  31. callers file. It writes NOTHING to PCBoard's associated files.
  32.  
  33. Let's get on with the installation, I know you're in a hurry.
  34.  
  35. Log into the  "\WHOCALL"  subdirectory. HIGHLY recommended to use this utility
  36. in It's OWN directory. (on the HOME PCB machine for networks.)
  37.  
  38. Run whoSETUP and answer some brief questions. Please READ the help lines
  39. in the middle of the screen during each question. 
  40.  
  41. At The DOS Prompt, (AFTER either using whoSETUP or editing whoCFG.X
  42.                     yourself)
  43. type;
  44.  
  45. whoCALL whocfg.n/x 
  46.  
  47.   (where whocfg.n = which configuration file you want to use.)
  48.   (n=machine number)
  49.   (where x = the node number - ZERO for Clark's new TWO node BBS)
  50.   (This file does the work of sorting out all of the information)
  51.   (and puts it into the "temp" files. Explained below.)
  52.  
  53. whoNODE whocfg.n/x
  54.  
  55.    (where whocfg.n = which configuration you want to use.)
  56.    (n=machine number)
  57.    (where x = the node number - THIS FILE IS FOR THE WHOBULL.xxx)
  58.    (do NOT run this, if you ONLY want a bulletin of ALL your nodes)
  59.    (in ONE bulletin!)
  60.  
  61. whoALL  whocfg.n/x
  62.  
  63.         (this creates the bulletin WHOBULL.ALL for ALL nodes. - Do NOT)
  64.         (run this one, if you ONLY want a bulletin for EACH node.)
  65.  
  66.  
  67. You'll obviously want to include those lines in your $$LOGOFF.BAT.
  68.  
  69. For those of you who are new at this, if that file exists ($$LOGOFF.BAT)
  70. in your PCB's "home" directory, PCBoard V14.5a will run this batch file
  71. each time a user logs off.
  72.  
  73. Your $$LOGOFF.BAT should look like this:
  74.  
  75. cd [d:\] whocall
  76. whocall  whocfg.n/x
  77. whonode  whocfg.n/x
  78. whoall   whocfg.n/x
  79. cd [d:\] pcb
  80.  
  81. When those programs are through running, you'll have two files.
  82.  
  83. WHOBULL.XXX and WHOBULL.ALL, THOSE are the files you'll want to be
  84. displayed to your users. (The final output from WhoCalled.)
  85.  
  86. Version 5.03"N" command line is slightly confusing to glance at, but here's 
  87. a VERY brief explaination. The WHOCFG.n file, can be ANY configuration file
  88. so long as it meets the guidelines I explained in EXPLAIN.CFG. 
  89.  
  90. Doing things this way, makes the utility EXTREMELY flexible for 
  91. WHATEVER your setup consists of.
  92.  
  93. I wanted to accomodate network users. JUST AS PCBoard has a different 
  94. PCBOARD.DAT file for each node, WhoCalled TOO, needs to know 
  95. where certain files are. That information is contained in the file(s);
  96. WHOCFG.n. 
  97.  
  98. My Node I $$LOGOFF.BAT looks like this:
  99.  
  100. CD C:\WHOCALL
  101. whoCALL c:\whocall\whocfg.1/1
  102. whoNODE c:\whocall\whocfg.1/1
  103. whoALL  c:\whocall\whocfg.1/1
  104. CD C:\PCB
  105.  
  106. If you have a single machine, but multi-nodes, you can STILL use the
  107. SAME configuration file. i.e. for my Node II, my $$LOGOFF.BAT looks
  108. like this:
  109.  
  110. CD C:\WHOCALL
  111. whoCALL c:\whocall\whocfg.1/2
  112. whoNODE c:\whocall\whocfg.1/2
  113. whoALL  c:\whocall\whocfg.1/2
  114. CD \PCB2
  115.  
  116.    (Network Users - For example, if you have THREE nodes on ONE REMOTE
  117.     MACHINE, you CAN use the SAME WHOCFG.x file, for a different node
  118.     on the SAME machine. Use the syntax WHOCALL WHOCFG.n/x, and simply 
  119.     use N as the machine number, and again, X as the NODE number.)
  120.  
  121. You'll need to include the SLASH! 
  122.  
  123. If you are running ONE node, there's NO need to run whoALL, likewise if you
  124. are running multiple nodes, and you ONLY want an ALL NODEs bulletin, then
  125. omit whoNODE.
  126.  
  127. Please note, PLEASE,  I  KNOW I'm going to get calls on this  one.  WhoCalled,
  128. when FIRST ran,  needs  to BUILD UP the temporary files up to the limit of the
  129. number of calls you specified in your configuration files for either the NODE
  130. bulletins or your ALL bulletins. What I'm trying to say is that the first time
  131. you run it, it will have ONE caller logged in there. The second  time  you run
  132. it, it will  have the second caller logged, and so forth, until it reaches the
  133. maximum number of callers you told WHOCALL.CFG to track.
  134.  
  135. When you run whoCALL.exe, if the LAST caller is the SAME as THIS caller,   it
  136. will NOT append your bulletin. (Makes sense, doesn't it?)
  137.  
  138. Your output bulletin(s) should look similar to this:
  139.  
  140. BBS Name Goes Here  - Node : 9
  141. Who Called? - V2.98 - Written By: Bill Fink
  142.  
  143.                              Time  Min. Connect #Msgs  Files  Files  Avg
  144. Date      User Name          On    Used Speed    Left   U/L    D/L   CPS
  145. ----------------------------------------------------------------------------
  146. 03-23-92  HORACIO CRISTINO   20:51  4   (2400)     0      0     0
  147. 03-23-92. ALEX BOWMAN        20:07  25  (19200E)   4      0     0
  148. 03-23-92  MARTIN HARDY       18:48  52  (2400)     0      0     2    230
  149. 03-23-92  MITCH KRZYZEK      18:43  1   (2400)     0      0     0
  150. 03-23-92■ BILL FINK          13:32  10  (2400)     1      0     0
  151. 03-23-92  MIKE GERARDI       12:55  8   (2400)     0      0     1    232
  152. 03-23-92  BILLS TESTING      00:06  0   (Local)    0      0     0
  153.  
  154. Previous xx Callers Tracked.
  155.  
  156. Note: The period next to Alex Bowman's  name  above indicated this user logged
  157. off "Abnormally."
  158.  
  159. Note: The ANSI character next to Bill Fink's name above. This indicates that
  160. the user *MAY* be the victim of a "Hack" attempt. (More than TWO attempts
  161. were made with different passwords.)
  162.  
  163. I am making a vow RIGHT HERE AND NOW, that I will NEVER post  anything  to the
  164. effect of "Your SysOp Is Cheap" in ANY "Who Called?" products!
  165.  
  166. * * * SINGLE NODE USERS! MAKE SURE YOU USE A ZERO "0"
  167.       as your node # when you invoke WhoCalled.
  168.  
  169.       This software WILL work with Clark's new 2 Node
  170.       version of the code as well.
  171.  
  172. The BBSes who  DID  test  the  product  did  NOT  have ANY problems with their
  173. "CALLER" or CFG    file(s). If YOU DO,   I  trust I  have written enough error
  174. trapping to catch any mistake that MAY have happened on your  part. If this is
  175. the case, the  utility  will  beep at you and the bulletin created will simply
  176. have the bulletin header (and nothing  else)  and  go  on about it's business.
  177. Your board will be back up when it's through.
  178.  
  179. You WILL run into problems if you've edited your CALLERs file. The contents of
  180. PCBoard's CALLERS file is written as a relative type file  and if you edit the
  181. file with an  ASCII  editor,  (OK  in  MOST  cases) you COULD have a distorted
  182. output file as your bulletin.
  183.  
  184.   * THIS IS OK * WHOCALLED? WILL trap it, but needs
  185.     to cycle through.
  186.  
  187. WhoCalled needs a temporary file for EACH node running. Forgive me on this one
  188. but to read a file (a RANDOM type file) from the bottom up, I needed to create
  189. those files to read from. Otherwise,  it  would  run  like  the OLD WhoCalled?
  190. V3.x, and take anywhere from 15 seconds to 20 seconds in between each call for
  191. say a 35 call limit.
  192.  
  193. There is GREAT news now! (New In Version 5) If you're inclined  to NOT like my
  194. header or footer files, you can simply ADD YOUR OWN. You MUST have something,
  195. even if there are blank lines. But, the choice is yours now to use mine OR
  196. yours.
  197.  
  198. WHOCALL.HDR and WHOCALL.FTR are the files that are appended to the bulletins
  199. before and after the raw data is placed, respectively.
  200.  
  201. WhoCalled? Uses  the  CALLER  file  for   it's  information. You can limit the
  202. number of callers that it checks and writes  to your bulletin using the
  203. WHOCFG.n file. See the WHOCFG.n FILE and read the EXPLAIN.CFG help file.
  204.  
  205. I can be reached at (401) 848-9176. PLEASE this is my HOME VOICE PHONE, try to
  206. keep it EARLIER than 6PM. (I'm taking  into  account  Pacific time) Let's face
  207. it, it's a lot easier if we can talk voice.
  208.  
  209. My BBS free access phone number is (401) 846-1763, which is v32bis, should you
  210. prefer to SEE the bulletins in action.  (And keep tabs on any upgrades.)
  211.  
  212. Use node II (401) 846-1763 to browse my bulletins files,  take  a  look at my
  213. bulletin #16, #17,  #18, and leave a comment, asking for help should you need
  214. any.
  215.  
  216. What EVER you do, PLEASE don't try WHOCALLED and if something went wrong, just
  217. delete all the files and forget about it.   Please call me, and let me know if
  218. the utility is not working for you for  your  configuration. I can NOT attempt
  219. to fix something, if I don't know it's broken.
  220.  
  221. I will NEVER  know  if you want something added, or something special for YOUR
  222. BBS if you don't call. Please CALL!
  223.  
  224. It's getting to the point that I've spent MANY hours with WhoCalled. If you
  225. REALLY want to see MORE upgrades, send a $10.00 "suggestion" to keep me at
  226. programming for WhoCalledPRO.
  227.  
  228. Bill FINK
  229. 4204 East Bay Village
  230. Middletown, RI 02840
  231.  
  232. Chris, thanks for your suggestions!
  233.  
  234. That's it, have FUN with WhoCalledPRO!
  235.  
  236. Note: WhoCalled V5.5 NOW Displays The Caller(s) City/State
  237. and is ONLY available from the Support BBS. You HAVE To Contact
  238. Me VOICE - 401-848-9176 For Access To The NCCBBS, To Download
  239. The Needed Executable Files.
  240.  
  241. Bill FINK - SysOp / Owner / Manager - NCCBBS
  242. Middletown, Rhode Island
  243.  
  244.