home *** CD-ROM | disk | FTP | other *** search
/ Carsten's PPE Collection / Carstens_PPE_Collection_2007.zip / S / STAT23.ZIP / PCBSTAT.DOC < prev    next >
Text File  |  1992-11-05  |  13KB  |  367 lines
  1.  
  2.  
  3.  
  4.                                 PcbStat v2.3
  5.  
  6.  
  7.               Copyright (C) 1992  THE WANDERER   [Access Denied]
  8.  
  9.         ────────────────────────────────────────────────────────────
  10.  
  11.         PcbStat creates  LastCaller statistics  including the totals
  12.         for  the uploads and  download for today  and yesterday, top
  13.         uploader, top downloader and  top caller statistics! It also
  14.         creates weekly and  monthly top uploader and  top downloader
  15.         statistics. Now  it creates  a summary of  statistics of the
  16.         last days  too. Since v2.0 it also  creates an all time high
  17.         score statistic per day, week and month.
  18.  
  19.         Additionally you  may post any statistic into the msgbase to
  20.         let your users know whats up!
  21.  
  22.         You may  also hide  special users  out of the  statistics so
  23.         that your donators will not be shown.
  24.  
  25.         You must run the lastcaller  function if you want to use the
  26.         week-ul/dl or month-ul/dl  or history statistics because the
  27.         lastcaller function  gathers the  data needed  by the  other
  28.         statistics.
  29.  
  30.         To create last uploads  statistic you  have to enable one of
  31.         both statistic files and run  the lastcaller statistic. This
  32.         also updates the last uploads statistic. This statistic will
  33.         show the date  and time  of the file as the  upload time, so
  34.         you should stamp the time of your uploads after the check.
  35.  
  36.         When not using the %PCBNODE% environment variable within the
  37.         PCBSTAT.CTL you  have to create one PCBSTAT.CTL  config file
  38.         for every node you run. It must be in the directory you call
  39.         PcbStat from. When you use  it you only have to put a config
  40.         file into the same directory PCBSTAT is in.
  41.  
  42.         Put PCBSTAT.EXE in  any directory  you want.  There it  will
  43.         create 3  databases:  DAYSTAT.DBF,  LASTCALL.DBF, LASTUL.DBF
  44.         which contain info about the  daily totals, last callers and
  45.         last uploads.
  46.  
  47.         PcbStat is network aware and  uses record locking schemes to
  48.         avoid loss of data when running several nodes.
  49.  
  50.         It will create a  PCBSTAT.TIM in the  directory you  call it
  51.         from to avoid reading the  lastcaller multiple  times. Don't
  52.         delete it otherwise the latest caller will be counted twice!
  53.  
  54.         Use MAXCPS to set the max. allowed  transfer rate. Since the
  55.         DSZ logfile does not always  states the correct cps rate for
  56.         resumed transfers its not  cool to allow too high cps rates.
  57.         Also transferring textfiles  doesn't reflect the correct cps 
  58.         rates.  I prefer setting  this value to  2000 cps  for 14.4k 
  59.         and 2300 cps  for 16.8k. If  not set a  cps rate of  2000 is 
  60.         assumed.
  61.         
  62.         You can't run PcbStat  from within  the $$logoff.bat because
  63.         ProDoor writes  the ending '*******' line after  running the
  64.         $$logoff.bat and PcbStat  looks for it  to avoid double read
  65.         of the same  caller. To  run PcbStat  from $$logoff.bat  you
  66.         have to create a semaphore  file in the batch  and check for
  67.         it in your board.bat. Take a look at the example.
  68.  
  69.         $$LOGOFF.BAT
  70.         ════════════
  71.         rem >Logoff.%PcbNode%
  72.  
  73.         BOARD.BAT
  74.         ═════════
  75.         if exist logoff.%PcbNode% goto RunStat
  76.         
  77.         :RunPcb
  78.         if exist $door.bat del $door.bat >nul
  79.         Prolon Prolon.cnf %PCB%\Line%PcbNode%
  80.         
  81.         :RunStat
  82.         PcbStat MaxCps 2300 Lastcall
  83.         del logoff.%PcbNode% >nul
  84.         board
  85.  
  86.         ────────────────────────────────────────────────────────────
  87.  
  88.         SYNTAX: PcbStat [LastCall] [Upload] [Download] [TopCall]
  89.                         [WeekUl] [WeekDl] [MonthUl] [MonthDl]
  90.                         [History] [WeekHis] [MonthHis] [HighScore]
  91.                         [Pack] [MaxCps]
  92.  
  93.         ■ LastCall  - Creates last caller / last uploads statistics
  94.         ■ Upload    - Creates top uploader statistics
  95.         ■ Download  - Creates top downloader statistics
  96.         ■ TopCall   - Creates top caller statistics
  97.         ■ WeekUl    - Creates top uploader of the week statistics
  98.         ■ WeekDl    - Creates top downloader of the week statistics
  99.         ■ MonthUl   - Creates top uploader of the month statistics
  100.         ■ MonthDl   - Creates top downloader of the month statistics
  101.         ■ History   - Creates history statistic of the last days
  102.         ■ WeekHis   - Creates history statistic of the last weeks
  103.         ■ MonthHis  - Creates history statistic of the last month
  104.         ■ HighScore - Creates all time highscore statistic
  105.         ■ Pack      - Purges last caller / last uploads database
  106.         ■ MaxCps    - Set max. transfer CPS
  107.  
  108.         Preceed any statistic with POST to post this statistic file
  109.         into msgbase. E.g.  'PcbStat Post WeekUl Post MonthUl' will
  110.         create weekly uploader  and monthly uploader statistics and
  111.         post both into the msgbase.
  112.  
  113.         All runtime parameter are optional.
  114.  
  115.         Run PcbStat right after each call. Use the runtime parameter
  116.         LASTCALL to  enable creation of  lastcaller  statistics, eg.
  117.         'PcbStat MaxCps 2500 LastCall'.
  118.  
  119.         Run PcbStat  with the  parameter  LASTCALL PACK to pack  the
  120.         lastcaller database and the  last uploads database remaining
  121.         30 days and 50 files. You  may use this parameter every time
  122.         you call PcbStat but I wouldn't prefer it.
  123.  
  124.         To avoid the ugly 'Unregistered Evaluation Copy' you have to
  125.         crack the PCBSTAT.KEY (write a keymaker if you can!) or have
  126.         to upload one major game release to
  127.  
  128.               Access Denied ■ UTG Europe Headquarters ■ 7 Nodes
  129.  
  130.         to receive a key  that registeres  PcbStat. Get  the magic #
  131.         and  NUP for  Access Denied from your  UTG Distribution Site
  132.         near you.
  133.  
  134.         Many thanks to Rider [DarkStar BBS] and Phil Thrust
  135.         [New Central Europe] for beta testing.
  136.                                         
  137.  
  138.                                         THE WANDERER
  139.         ────────────────────────────────────────────────────────────
  140.  
  141.                         Configuration of PcbStat
  142.  
  143. ; Comments start with a ";" and are not allowed after a keyword.
  144. ; Keywords are not case sensitive.
  145. ;
  146. ; Are you running multiline ?
  147. Multiline
  148. ;
  149. ; Name and Location of your logfile
  150. Logfile         %PCB%\Main\Caller%PcbNode%
  151. ;
  152. ; List of all download paths
  153. ; This listing must contain all paths of all conferences!
  154. DlPath          %PCB%\Gen\Dlpath.All
  155. ;
  156. ; Name and Location of your userfile
  157. Userfile        %PCB%\Main\Users
  158. ;
  159. ; Path to your user index files. You need this to show the full
  160. ; users location in the lastcaller statistic.
  161. IndexPath       %PCB%\Main
  162. ;
  163. ; Name and Location of your msgbase file you want to post
  164. ; statistics into. Index file must be in the same directory
  165. ; and have the extension .NDX. Define this statement several
  166. ; times to post statistics in several conferences.
  167. MsgBase         %PCB%\PC-Conf\Mail
  168. MsgBase         %PCB%\Mac-Wares\Mail
  169. ;
  170. ; Do you want to display all statistics nonstop without a
  171. ; waiting MORE (Yes/No) ?
  172. NonStop
  173. ;
  174. ; Enable SUMTOTALS to display the total U/L + D/L statistics of
  175. ; all users in the LastCaller statistics. You must have set
  176. ; USERFILE to enable this feature.
  177. SumTotals
  178. ;
  179. ; Enable HISTORYAVG to display an average of all days and an
  180. ; average of x days in the history statistics.
  181. HistoryAvg
  182. ;
  183. ; PackDays specifys the number of days that will remain in the
  184. ; lastcaller database after PACK. If you don't set it it will
  185. ; default to 30 days.
  186. PackDays        45
  187. ;
  188. ; PackUploads specifys the number of uploads that will remain
  189. ; in the last uploads database after PACK. If you don't set it
  190. ; it will default to 50 uploads.
  191. PackUploads     100
  192. ;
  193. ; For all statistics you have to define at least one of the two
  194. ; statistics file to enable it. You must enable ascii statistics
  195. ; to be able to post them as a message.
  196. ;
  197. ; Name of the lastcaller ascii statistic file
  198. LastCallAsc     %ProDoor%\Prostrt
  199. ;
  200. ; Name of the lastcaller ansi statistic file
  201. LastCallAns     %ProDoor%\ProstrtG
  202. ;
  203. ; Name of the last uploads ascii statistic file
  204. LastUlAsc       %PCB%\Gen\Blt13
  205. ;
  206. ; Name of the last uploads ansi statistic file
  207. LastUlAns       %PCB%\Gen\Blt13G
  208. ;
  209. ; Name of the uploader ascii statistic file
  210. UploadAsc       %PCB%\Gen\Blt2
  211. ;
  212. ; Name of the uploader ansi statistic file
  213. UploadAns       %PCB%\Gen\Blt2G
  214. ;
  215. ; Name of the downloader ascii statistic file
  216. DownloadAsc     %PCB%\Gen\Blt3
  217. ;
  218. ; Name of the downloader ansi statistic file
  219. DownloadAns     %PCB%\Gen\Blt3G
  220. ;
  221. ; Name of the caller ascii statistic file
  222. TopCallAsc      %PCB%\Gen\Blt4
  223. ;
  224. ; Name of the caller ansi statistic file
  225. TopCallAns      %PCB%\Gen\Blt4G
  226. ;
  227. ; Name of the weekly uploader ascii statistic file
  228. WeekUlAsc       %PCB%\Gen\Blt5
  229. ;
  230. ; Name of the weekly uploader ansi statistic file
  231. WeekUlAns       %PCB%\Gen\Blt5G
  232. ;
  233. ; Name of the weekly downloader ascii statistic file
  234. WeekDlAsc       %PCB%\Gen\Blt6
  235. ;
  236. ; Name of the weekly downloader ansi statistic file
  237. WeekDlAns       %PCB%\Gen\Blt6G
  238. ;
  239. ; Name of the monthly uploader ascii statistic file
  240. MonthUlAsc      %PCB%\Gen\Blt7
  241. ;
  242. ; Name of the monthly uploader ansi statistic file
  243. MonthUlAns      %PCB%\Gen\Blt7G
  244. ;
  245. ; Name of the monthly downloader ascii statistic file
  246. MonthDlAsc      %PCB%\Gen\Blt8
  247. ;
  248. ; Name of the monthly downloader ansi statistic file
  249. MonthDlAns      %PCB%\Gen\Blt8G
  250. ;
  251. ; Name of the history ascii statistic file
  252. HistoryAsc      %PCB%\Gen\Blt9
  253. ;
  254. ; Name of the history ascii statistic file
  255. HistoryAns      %PCB%\Gen\Blt9G
  256. ;
  257. ; Name of the weekly history ascii statistic file
  258. WeekHisAsc      %PCB%\Gen\Blt10
  259. ;
  260. ; Name of the weekly history ansi statistic file
  261. WeekHisAns      %PCB%\Gen\Blt10G
  262. ;
  263. ; Name of the monthly history ascii statistic file
  264. MonthHisAsc     %PCB%\Gen\Blt11
  265. ;
  266. ; Name of the monthly history ansi statistic file
  267. MonthHisAns     %PCB%\Gen\Blt11G
  268. ;
  269. ; Name of the highscore ascii statistic file
  270. HighScoreAsc    %PCB%\Gen\Blt12
  271. ;
  272. ; Name of the highscore ansi statistic file
  273. HighScoreAns    %PCB%\Gen\Blt12G
  274. ;
  275. ; Number of last callers that will be shown
  276. Caller          12
  277. ;
  278. ; Number of last uploads that will be shown
  279. Uploads         20
  280. ;
  281. ; Number of uploader that will be shown
  282. Uploader        20
  283. ;
  284. ; Number of downloader that will be shown
  285. Downloader      20
  286. ;
  287. ; Number of caller that will be shown
  288. TopCaller       20
  289. ;
  290. ; Number of weekly uploader that will be shown
  291. WeekUl          20
  292. ;
  293. ; Number of weekly downloader that will be shown
  294. WeekDl          20
  295. ;
  296. ; Number of monthly uploader that will be shown
  297. MonthUl         20
  298. ;
  299. ; Number of monthly downloader that will be shown
  300. MonthDl         20
  301. ;
  302. ; Number of days in the past that will be shown
  303. History         14
  304. ;
  305. ; Number of weeks in the past that will be shown
  306. WeekHistory     14
  307. ;
  308. ; Number of month in the past that will be shown
  309. MonthHistory    14
  310. ;
  311. ; HideGlobal enables you to hide special users within all statistics
  312. ; Use all HIDE statements several times to hide more user
  313. HideGlobal      SYSOP
  314. HideGlobal      THE WANDERER
  315. ;
  316. ; The HideLast statement hides the user in the lastcaller statistic only
  317. HideLast        LEECH-USER
  318. ;
  319. ; The HideCall statement hides the user in the top caller statistic only
  320. HideCall        LEECH-USER
  321. ;
  322. ; The HideUp statement hides the user in the top uploader,
  323. ; weekly and monthly uploader statistics
  324. HideUp          LEECH-USER
  325. ;
  326. ; The HideDown statement hides the user in the top downloader,
  327. ; weekly and monthly downloader statistics
  328. HideDown        LEECH-USER
  329. ;
  330. ; You only have to enter the text strings for the different
  331. ; actions if you don't use standard english setup. When using
  332. ; multiple languages you may use the following keywords
  333. ; several times to define all possible strings that may occur.
  334. ;
  335. ; Text that defines that an event was scheduled
  336. Event           Scheduled event
  337. ;
  338. ; Text after that the time user was online is stated
  339. Online          Minutes used
  340. ;
  341. ; Text that defines user made a directory scan (e.g NSU)
  342. FileScan        Directory scan
  343. ;
  344. ; Text that defines a completed file transfer
  345. Transfer        Completed using
  346. ;
  347. ; Text that defines user entered a private/public message or
  348. ; a comment to sysop.
  349. Message         Message entered
  350. Message         Message left
  351. Message         Comment left
  352. ;
  353. ; Text that defines user tried to chat with sysop
  354. PageSysop       Operator paged
  355. PageSysop       Sysop chat active
  356. PageSysop       Sysop page reason
  357. ;
  358. ; Text that defines user made a password failure
  359. Failure         Password failure
  360. ;
  361. ; Text that defines user lost carrier
  362. Carrier         Abnormal
  363. ;
  364. ; Text that is shown when a new user logs on
  365. NewUser         New user
  366. ;
  367.