home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / citadel / k2ne603b.zip / CTDLUTLS.ZIP / CTDLSTAT.DOC < prev    next >
Text File  |  1990-02-24  |  5KB  |  122 lines
  1. To:  All interested parties
  2. By:  K2NE Software [90Feb21]
  3. Re:  CTDLSTAT.EXE:  How and Why
  4.  
  5.  
  6. I.  Overview
  7.  
  8.   Syntax:  CTDLSTAT workfile.ext
  9.   The "workfile.ext" is NOT OPTIONAL.
  10.  
  11.   CTDLSTAT.EXE is a program that digests the data in the file
  12. indicated as the work file.  You could use SYSDATA.USR which
  13. is automatically generated and maintained by Citadel:K2NE beginning
  14. with V5.09, or you could use SYSDATA.BAK which should be updated
  15. as each caller logs out.  You should place CTDLSTAT.EXE in the same
  16. directory as that containing your CTDL.EXE and CTDLCNFG.SYS files.
  17.  
  18.   When run, CTDLSTAT.EXE will generate a file called REPORTER.OUT, a
  19. typical sample of which looks like this:
  20.  
  21.  *** Activity Summary as of 2/21/90 at 00:05 ***
  22.  User Sessions (modem): 13   User Messages: 25
  23.  Network Sessions: 38     Node Connections: 31
  24.  Total Non-Mail Messages Forwarded: 84
  25.  Message/Caller Ratio: 1.92
  26.  Network Nodes/Session Ratio: 0.82
  27.  Network Msgs/Node-Connect Ratio: 2.71
  28.  
  29.   After it runs, CTDLSTAT.EXE deletes the current copy of SYSDATA.USR
  30. which has the effect of setting all the totals back to zero.  Thus, you
  31. probably will want to key CTDLSTAT.EXE to a Citadel #event and run it
  32. once per day.  This is in keeping with the report that is generated
  33. when one of your Aides executes the ".AQT" sequence.  The language of
  34. that Aide report assumes a DAILY total.
  35.  
  36.   For your convenience, here is a segment of BATCH file that will
  37. accomplish the intended goals:
  38.  
  39. ---<<excerpt starts here>>---
  40. c:
  41. cd \k2ne
  42. REM 'CTDLSTAT.EXE' digests the Citadel session/net/message data
  43. REM outputs it to 'reporter.out'.
  44. ctdlstat sysdata.bak
  45. REM now we stick it on the end of the call-log file
  46. REM so let's move to the directory containing the log file 'calllog.sys'.
  47. cd system
  48. copy ..\reporter.out
  49. copy calllog.sys+reporter.out tempfile.sys
  50. copy tempfile.sys calllog.sys
  51. del tempfile.sys
  52. del reporter.out
  53. REM now let's back it up with archive
  54. copy archive.log+calllog.bak archive.log
  55. copy calllog.sys calllog.bak
  56. del calllog.sys
  57. REM when we bring citadel back up the call log should restart itself
  58. cd \k2ne\helparea
  59. REM the next line makes the daily summary available to users at login
  60. copy \k2ne\reporter.out logtext.004
  61. REM now we are done all this fishiness.
  62. cd \k2ne
  63. del reporter.out
  64. goto loop
  65. ---<<excerpt ends here>>---
  66.  
  67.  
  68.   The directory names in the preceeding BATCH segment conform to the
  69. default directories created by the AutoInstalling version of Citadel:K2NE
  70. beginning with the V5.07 release.  If you are using a "roll your own"
  71. directory structure, you will have to modify the directory changes
  72. accordingly.
  73.  
  74.  
  75. II.  Let's keep the Lawyers happy!
  76.  
  77.   The executable file CTDLSTAT.EXE is unconditionally released without
  78. charge to anyone having a need for its use.  If you are distributing
  79. copies of Citadel:K2NE, you are requested to do the following:
  80.  
  81.   1) Make sure you include a copy of CTDLSTAT.EXE and a copy of
  82.      this file with all releases beginning with V5.09 of Citadel:K2NE.
  83.   2) Please attempt to compile a list of those folks who have received
  84.      a copy of Citadel:K2NE from you, and please forward this list to
  85.      Vince Quaresima at Jersey Devil Citadel [609 893-2152] on a
  86.      regular basis.
  87.  
  88.   Citadel:K2NE and all accompanying files, documentation and utilities
  89. is a FREE PUBLIC-DOMAIN bulletin board system.  You are permitted to
  90. charge a small fee (not to exceed $1.25 per disk) for your duplication
  91. and distribution expenses.  The software is NOT FOR SALE and you are
  92. not permitted to SELL Citadel:K2NE either on its own or as a part of
  93. another distribution package.  The right to commercially install
  94. copies of Citadel:K2NE resides solely with K2NE Software and its heirs
  95. and assigns.
  96.  
  97.   Commercial entities desiring to operate a Citadel:K2NE bulletin board
  98. system are free to do so PROVIDED the primary purpose of the installation
  99. is to further the FREE interchange of information amongst the PUBLIC.
  100. Use of Citadel:K2NE by commercial entities for their own internal purposes
  101. without the written authorization of K2NE Software is expressly forbidden.
  102.  
  103.   A "commercial entity" (for the purposes of these paragraphs) is any
  104. individual, proprietorship, partnership or corporation required by
  105. any telephone company to operate the bulletin board on a "business"
  106. phone-line.  Operation of the bulletin board on a "personal" phone-line
  107. shall be sufficient evidence to establish and demonstrate non-commercial
  108. use of the software.
  109.  
  110.   CTDLSTAT.EXE is distributed strictly on an "as is" basis.  No warranty
  111. of any type is stated or implied, including (but not limited to) warranties
  112. of merchantability or fitness for a particular purpose.  The user agrees
  113. to accept any and all risks when using CTDLSTAT.EXE, and agrees that no
  114. liability for loss of data, software, firmware or hardware shall acrue
  115. to any other party.
  116.  
  117.   "CitaNet" <tm> and "Citadel:K2NE" <tm> are Trademarks of K2NE Software.
  118. Any use of these trademarks without the written authorizaton of
  119. K2NE Software is expressly prohibited.  Use of the phrase "Citadel:K2NE"
  120. in the context of an online discussion or a file-description will not
  121. be interpreted as a trademark infringement.
  122.