home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / comms / bbs / primetim.lha / PrimeTime.doc
Text File  |  1992-10-18  |  4KB  |  125 lines
  1.                               PrimeTime v1.01
  2.  
  3.                                     by
  4.  
  5.                              Tom H. Warkentin
  6.                             Copyright (C) 1992
  7.  
  8.  
  9. DESCRIPTION
  10.  
  11.     PrimeTime is a utility I cooked up to limit a user's time online during
  12. certain busy hours of the day.  It is fully configurable so all users above
  13. a specified user level will be exempt from the limitation.  Also a text file
  14. containing underscored usernames will be checked before imposing the
  15. limitation.
  16.  
  17.  
  18. IMPORTANT
  19.  
  20.     This software is distributed as FREEWARE so you can make as many copies
  21. as you like providing the contents of the archive remain unchanged.  Also
  22. no individuals may profit from the distribution of the archive.  Furthermore
  23. I will not be held responsible for any problems that may arise from the use
  24. of the software.  By the way, donations/encouragements are welcome!
  25.  
  26.  
  27. INSTALLATION
  28.  
  29.     Uncompress the archive using the -x option to preserve the pathnames and
  30. copy the files to the appropriate directories.  You will probably want to
  31. edit your login.dlgbatch file instead of copying the included example.  Also
  32. you'll probably want to tailor the config files to your system.
  33.  
  34.     PrimeTime.cfg *MUST* be in DLGCONFIG:MISC/ or it will not work.
  35.  
  36.  
  37. USAGE
  38.  
  39.     If you type the name of the executable on the command line, you'll get
  40. the following message showing its usage:
  41.  
  42.     PrimeTime v1.0 by Tom H. Warkentin ⌐ 1992. All rights reserved!
  43.  
  44.     USAGE: PrimeTime %UNAME %PORT %LEVEL %TLCALL [-t]
  45.  
  46. All command line arguments must be present except the optional "-t".  The
  47. "-t" option will print out the current prime time hours to the user if he
  48. is not exempt from the limitation.
  49.  
  50.     Edit your login.dlgbatch file to include the above command line if you
  51. intend to use PrimeTime.
  52.  
  53. CONFIG FILES
  54.  
  55.     DLGConfig:Misc/PrimeTime.cfg (DO NOT change the path or name!)
  56.  
  57.         PrimeTime relies on this file for its configuration.  Nothing may be
  58.         omitted or added to the file without causing severe side effects.  The
  59.         first line contains the full path/filename to the text file displayed
  60.         if the user is subject to the limitation (64 chars max).  The second
  61.         line is the full path/filename to the text file containing those exempt
  62.         users who do not have a high enough user level to be exempt (64 chars
  63.         max).  The third line is the user level that is exempt from the
  64.         limitation(200 with the given config). The fourth line should have 24
  65.         integers separated by white spaces.  The integer on the left is the time
  66.         limit to impose at midnight (0:00 hours), the next being 1AM (1:00 hours),
  67.         etc.. If the integer value is 0, there will be no time restrictions
  68.         imposed on the user.  All other positive values are the number of minutes
  69.         to give the user during that hour as long as he has that much time
  70.         available for that call.  The last line should contain the names of the
  71.         ports affected by the PrimeTime utility (separated by white spaces).
  72.  
  73.         The given config would limit all users on TR0 from 19:00-21:59 with a user
  74.         level less than 200 unless their name was Tom Warkentin.  The amount
  75.         of online time for the users would be 30 mins.
  76.  
  77.     DLGConfig:Text/PrimeTime.users (Configurable)
  78.  
  79.         Each *underscored* username should separated by a whitespace character.
  80.  
  81.     DLGConfig:Text/PrimeTime.txt (Configurable)
  82.  
  83.         Feel free to use whatever %SWITCHES you like except for the %RETURN to
  84.         pause.  If the text file contains that particular switch, it will hang
  85.         your system.  I haven't found a work-around yet so if you've got any
  86.         ideas, let me know.
  87.  
  88.  
  89. NOTES
  90.  
  91.     The source code was compiled using 2.0 Include files.  If you're running
  92. 1.3 and have any problems, contact me and I'll recompile it using the 1.3
  93. includes instead.
  94.  
  95.     This utility has been tested on DLG v0.992.
  96.  
  97.  
  98. CONTACTING THE AUTHOR
  99.  
  100.     If you've got some suggestions for improvement, would like to report
  101. a problem/bug, or want to find out about my other DLG modules you can
  102. reach me by sending email:
  103.  
  104.         internet =>    tom@manning.cs.ualberta.ca
  105.  
  106. or if you've got money to burn (send it to me instead) or call my BBS:
  107.  
  108.         The Spectre BBS (v.32bis/v.42bis Supra 14.4Kb FaxModem)
  109.         (403) 435-9486
  110.         Edmonton, AB
  111.  
  112. or send snail mail to:
  113.  
  114.         Tom H. Warkentin
  115.         1016 Buchanan Place
  116.         Edmonton, AB
  117.         T6R 2A7
  118.  
  119.  
  120. HISTORY
  121.  
  122.     v1.01 - Added feature to limit users on certain specified ports.
  123.                 Thanks for the suggestion, Mark.
  124.     v1.0  - First public release.
  125.