home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / h / hstry210.zip / HISTORY.DOC < prev    next >
Text File  |  1989-03-16  |  14KB  |  398 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  10.         March 16, 1989                                     GT Net Address 36/1
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                   GENHIST / PLAYHIST
  19.                                  by Stephen de Plater
  20.                                  GT Net Address: 36/1
  21.                                  Phone: +61 2 977-3075
  22.  
  23.  
  24.  
  25.  
  26.         ======================================================================
  27.         0.                           REVISION LIST
  28.         ======================================================================
  29.  
  30.         Just to confuse everyone this revision list begins at version 1.10
  31.  
  32.         VERSION:    Release Date:       Comments:
  33.         -------     ------------        --------------------------------------
  34.  
  35.         1.10        May 26, 1988        These  two programs  replace (at least
  36.                                         for users of GT1400) the older program
  37.                                         HISTORY.EXE
  38.  
  39.                                         Added Standard Command Line Interface.
  40.  
  41.         1.11        August 12, 1988     Fixed a couple of minor bugs and added
  42.                                         the new /B parameter.
  43.  
  44.         2.00        October 12, 1988    As  you might guess, a major revision!
  45.                                         In fact, the  code changes were  quite
  46.                                         small, but ... External  protocol file
  47.                                         transfers are now counted  (they never
  48.                                         were before), people who like to wierd
  49.                                         things    in    their    GT.CNF    are
  50.                                         accomodated, and the  different format
  51.                                         of the GT14.03 log is handled.
  52.  
  53.         2.01        October 14, 1988    A  very  small  change  to  accomodate
  54.                                         those who  put their  GT.LOG files  in
  55.                                         directories other than the GTPATH.
  56.  
  57.         2.10        March 16, 1989      Breaks down the users into registered,
  58.                                         unregistered and banned. Minor fixes.
  59.  
  60.  
  61.                                      >> page 1 <<
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  76.         March 16, 1989                                     GT Net Address 36/1
  77.  
  78.  
  79.  
  80.         ======================================================================
  81.         1.                             COPYRIGHT
  82.         ======================================================================
  83.  
  84.         GENHIST / PLAYHIST  are not placed in the Public Domain. The copyright
  85.         is retained and the software is provided on licence:
  86.  
  87.         You  are free to use and make as  many copies of these programs as you
  88.         wish. You may also give them away to anyone who wants it, provided:
  89.  
  90.         1.     No fee is charged.
  91.         2.     This archive is distributed intact.
  92.         3.     You register the package with me.
  93.  
  94.  
  95.         ======================================================================
  96.         2.                           REGISTRATION
  97.         ======================================================================
  98.  
  99.         A  new  registration  scheme  now  applies   to  all  OZNET  software.
  100.         Regardless of  any previous  registration, this  program now  requires
  101.         individual installation for  each BBS  using it.   See the  README.NOW
  102.         file included with this archive for details.
  103.  
  104.         There  is  still  NO fee  involved  at  all. DO  NOT  send  any money!
  105.         Registration  simply involves  obtaining  from  me  a CRC  code  which
  106.         matches your  BBS name.   You can do this  either by netmail  to me at
  107.         36/1 or by mail to:
  108.  
  109.                               Revd. Stephen de Plater
  110.                               1 Kangaroo St.
  111.                               MANLY, NSW, 2095
  112.                               Australia
  113.  
  114.         You will also need to  obtain the OZINSTAL program which performs  the
  115.         actual installation.   OZINSTAL is not included  in this archive.  You
  116.         should look for OZINST10.ZIP.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                      >> page 2 <<
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  142.         March 16, 1989                                     GT Net Address 36/1
  143.  
  144.  
  145.  
  146.         ======================================================================
  147.         3.                              PURPOSE
  148.         ======================================================================
  149.  
  150.                          (Or what does this thing do anyway?)
  151.  
  152.         GENHIST  /  PLAYHIST together  form a  door program  for GT  Power BBS
  153.         Systems.  In  combination they  present  to  users some  of  the usage
  154.         statistics for the previous day.
  155.  
  156.         Specifically, GENHIST (run once only per day as soon as possible after
  157.         midnight  --  24:01  would be  good  time!)  generates  the two  files
  158.         containng the statistical presentation, and
  159.  
  160.         PLAYHIST, a door program, displays the  appropriate one of those files
  161.         to  the  user.  If  you  wish  to  insist  that  your  users  see this
  162.         information (as some  systems in  Sydney do) then  you should  include
  163.         PLAYHIST  in  your logon  door.  If  you are  not  running  GT1400 and
  164.         therefore  do not  have  logon doors  available,  then with  a bit  of
  165.         judicious DOS copying you could add the output to your logon bulletin.
  166.  
  167.         The output includes:
  168.  
  169.         1.     The  number  of users  known  to  the system,  subdivided  into
  170.                registered, unregistered, banned, and then a total,
  171.  
  172.         2.     The number of known users who were online yesterday,
  173.  
  174.         3.     The number of  connects registered yesterday.  It may be  quite
  175.                different from 3 above, if for instance, some users logged on a
  176.                number of times.
  177.  
  178.         4.     The total, minimum,  maximum, and average time  used in minutes
  179.                and seconds,
  180.  
  181.         5.     The  total,  minimum,  maximum,  and  average number  of  bytes
  182.                downloaded from your system,
  183.  
  184.         6.     The  total,  minimum,  maximum,  and  average number  of  bytes
  185.                uploaded to your system.
  186.  
  187.         The output  will be presented  in a standard  form which is  always 17
  188.         lines long, including blank top and bottom lines.
  189.  
  190.  
  191.  
  192.  
  193.                                      >> page 3 <<
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  208.         March 16, 1989                                     GT Net Address 36/1
  209.  
  210.  
  211.  
  212.         ======================================================================
  213.         4.                               USAGE
  214.         ======================================================================
  215.  
  216.         To use the GENHIST / PLAYHIST combination:
  217.  
  218.         1.     Place both programs in your DOS path.
  219.  
  220.         2.     Create a  scheduled event  which will  run GENHIST  immediately
  221.                after midnight.
  222.  
  223.         3.     Add PLAYHIST to your logon door.
  224.  
  225.         NOTE  that although  GENHIST will  run without  registration,  it will
  226.         display in its output "This program registered to *UNREGISTERED*." The
  227.         only way to remove this is through an OZNET registration (see above).
  228.  
  229.         NOTE also that PLAYHIST will NOT run at all unless registered.
  230.  
  231.  
  232.         ======================================================================
  233.         5.                      COMMAND LINE PARAMETERS
  234.         ======================================================================
  235.  
  236.         GENHIST supports four command line parameters as follows:
  237.  
  238.         1.     /Dnn Delay time in seconds. If this is the only program in your
  239.                     midnight event,  then it  will run  very quickly,  and you
  240.                     will be returned to the bbs  before the minimum window for
  241.                     the event  (one minute) has  elapsed. If  that occurs  you
  242.                     will immediately  go  out and  run  the event  again,  and
  243.                     again,  and  again ...  until the  minute  is used  up. To
  244.                     prevent this  happening, this parameter forces  GENHIST to
  245.                     take at least nn seconds to complete.
  246.  
  247.                     The default time is 60 seconds.
  248.  
  249.         2.     /N   By default, GENHIST  will create  (and PLAYHIST will  look
  250.                     for) files called HISTORY.BBS and HISTORY.CBS. If you want
  251.                     a different name, this  is where you put it. You  may only
  252.                     supply the simple filename here,  NOT the extension, which
  253.                     will be added by GENHIST. You  should not specify a path--
  254.                     GENHIST and PLAYHIST will always  look only in the  GTPATH
  255.                     directory for these files.
  256.  
  257.  
  258.  
  259.                                      >> page 4 <<
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  274.         March 16, 1989                                     GT Net Address 36/1
  275.  
  276.  
  277.  
  278.                     For example, if you want to  use the name "MYHIST" instead
  279.                     of  "HISTORY"  and  have  GENHIST  create  MYHIST.BBS  and
  280.                     MYHIST.CBS, then use the following parameter:
  281.  
  282.                     /Nmyhist
  283.  
  284.                     Note that there are NO spaces allowed!
  285.  
  286.         3.     /B   If  the  /B  parameter is  supplied  it  must  be followed
  287.                     immediately by one single (case sensitive) character. This
  288.                     character represents one access level  which is treated as
  289.                     a  ban  level.  Some sysops  do  not  wish  to simply  ban
  290.                     unwanted users,  because that prevents  the log  recording
  291.                     any attempts by them to get on, but instead set up a level
  292.                     with a very short  time and no effective access  which has
  293.                     the same effect. On this system, for instance, it is level
  294.                     "z". Be careful of the case (it does count), and note that
  295.                     for this to register this way it must be an exact match.
  296.  
  297.                     i.e:  /Bx would only  ban users at  level "x", but  not at
  298.                     levels "y" or "z". On this system I use /Bz.
  299.  
  300.         4.     /U   Unregistered  users.   Users at  or below  this  level are
  301.                     counted as unregistered in the  breakup of known users. At
  302.                     Kangaroo  Korner,  users   at  or  below  level   'T'  are
  303.                     unregistered, therefore I use the parameter /UT.
  304.  
  305.         The  command line  parameters may  not be  run together,  and may  not
  306.         contain internal spaces. i.e.: "/d 99", "/d99/nMYHIST" are both wrong;
  307.         "/d99 /nMYHIST" is fine! Case does not matter.
  308.  
  309.  
  310.         PLAYHIST supports two command line parameters as follows:
  311.  
  312.         1.     /M   Force ANSI graphics  OFF, no matter  whether the user  has
  313.                     them selected or not. The default is to let users who have
  314.                     selected ANSI graphics  see the color file,  and users who
  315.                     have not see the monochrome file.
  316.  
  317.         2.     /N   Use  a  different  filename  other  than  HISTORY.BBS  and
  318.                     HISTORY.CBS. Matches the same parameter in GENHIST.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                      >> page 5 <<
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.         GENHIST/PLAYHIST: v2.10                           by Stephen de Plater
  340.         March 16, 1989                                     GT Net Address 36/1
  341.  
  342.  
  343.  
  344.         ======================================================================
  345.         6.                              COLORS
  346.         ======================================================================
  347.  
  348.         PLAYHIST is sensitive  to the presence of  GT1400. If it  is detected,
  349.         and if the user has ANSI graphics selected, CHANGE will use the colors
  350.         which the GT1400 is using. Otherwise, it will run in monochrome. There
  351.         is nothing  which you have  to do  to tell  it which  version you  are
  352.         running -- let it figure it out for itself!
  353.  
  354.         GENHIST makes  no assumptions.  It creates  files for  both color  and
  355.         monochrome.
  356.  
  357.         ======================================================================
  358.         7.                            DISCLAIMER
  359.         ======================================================================
  360.  
  361.         Q:         What kind of guarantee comes with this software?
  362.  
  363.         A:                    *** ABSOLUTELY NONE!!! ***
  364.  
  365.         I take no responsibility at  all for what this software may do  on any
  366.         computer other than my own. If you use it  you do so at your own risk.
  367.         All that I am prepared to say about it is that it works fine here (and
  368.         I  can see no good reason why  it should not also work fine everywhere
  369.         else also -- but ....)
  370.  
  371.         By using this program you accept these conditions.
  372.  
  373.  
  374.         ======================================================================
  375.         8.                              ENJOY!
  376.         ======================================================================
  377.  
  378.         At least, I hope you do!
  379.         Stephen
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.                                      >> page 6 <<
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.