home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / mtc12.lha / MTC.doc < prev    next >
Text File  |  1993-07-30  |  5KB  |  143 lines
  1.                      M a s t e r - T i m e  C o n t r o l
  2.  
  3.                                      v1.2
  4.  
  5.                             (c) P. Eastham 1992-93
  6.  
  7. ----------------------------------------------------------------------------
  8.  
  9. What is it?
  10. ~~~~~~~~~~~
  11.        MTC is a PrimeTime like program. It allows you to restrict a users
  12. time on several different levels.
  13.  
  14.  
  15. How to set it up:
  16. ~~~~~~~~~~~~~~~~~
  17.        Simply copy the MTC executable to your DLG: directory, or anywhere
  18. else on your path.  Edit your login.(dlg)batch file and put the command in.
  19. MTC has the following usage:
  20.  
  21.          DLG:MTC -P%PORT -S%LEVEL -T%TLCALL [-L] [-C]
  22.  
  23. Order and case are not important.
  24.  
  25.   What the switches mean:
  26.  
  27. -P            Port they are on
  28. -S            Their security level
  29. -T            Time left this call
  30. -L            Turn on logging
  31. -C            Clear the screen before anything is sent at all
  32.  
  33.        Then you need to create the config file (discussed below).
  34.  
  35.        The exemption file contains exempt users names, 1 per line, in normal
  36. format. Use spaces NOT underscore's.
  37.  
  38.        The possible output files can contain any DLG %-Switch EXCEPT the
  39. %RETURN switch. USING THIS SWITCH WILL CRASH THE PROGRAM!!
  40.  
  41.        MTC is now installed.
  42.  
  43.  
  44. The config file:
  45. ~~~~~~~~~~~~~~~~
  46.        The first line of the config is the path and name of the text file shown
  47. to users if they have their time reduced at all.  All % switches may be used
  48. here EXCEPT the %RETURN switch.
  49.  
  50.    eg: DLGConfig:Text/MTC.txt
  51.  
  52.        The second line is the path and name of the exemption file.
  53.  
  54.    eg: DLGConfig:Text/MTC.users
  55.  
  56.        The third line is the path and filename of the file which user
  57. restricted people will see.
  58.  
  59.    eg: DLGConfig:Text/MTC.BadUser
  60.  
  61.        The fourth line is a PATH ONLY line. This allows for individual text
  62. files to be sent to user restricted people. The actual filename is their
  63. underscored username. This path must end in either a "/" or a ":". No
  64. checking is done. If this path/file doesn't exist, then the file in line 3
  65. will be sent instead.
  66.  
  67.        Config lines are grouped 3 at a time from now until the end of the file.
  68. Errors in the config file such as 1 line short will produce an "End Of File"
  69. error and the program will exit.
  70.  
  71.        The first line represents the type of restriction and the level or
  72. name of the person to be restricted. The first letter must be either "L",
  73. "E", "G", or "U". What they represent:
  74.  
  75.          L - Users LESS than this level
  76.          E - Users EQUAL to this level
  77.          G - Users greater than this level
  78.          U - This specific user.
  79.  
  80. The rest of the line is the level or the name.
  81.  
  82.      eg: L255 - All users with security less than 255.
  83.          E110 - All users with a security level of 110.
  84.          G150 - All users with security greater than 150.
  85.          UJoe Bloggs - User Joe Bloggs.
  86.  
  87.        The second line is the day to be run. This is simply found by directing
  88. the 'DATE' command to a file, reading in the date, and testing if this string
  89. exists in the date. So entering "DAY" will match for every day of the week.
  90. This also allows non-english people to use the program if their date program is
  91. not in english.
  92.  
  93.    eg: SATURDAY
  94.  
  95.        The third line is the time line. ranging from 1 am to 12 pm, separated
  96. by a space. '0' means no restrictions.
  97.  
  98.    eg: 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 55 40 40 40 40 40 40 0 0
  99.  
  100. would give a restriction of 55 minutes from 4pm to 4:59:59pm, and a 40 minute
  101. restriction from 5pm to 10:59:59pm. Note that it starts at 1:00am and NOT
  102. 12:00am as most others seem to.
  103.  
  104.        The program reads in each group until a match is made and then drops
  105. out and executes the rest of the program. Therefore you should make any
  106. exceptions such as user specific restrictions at the top and general
  107. restrictions at the bottom.
  108.  
  109.        See the included config file for an example.
  110.  
  111.  
  112. Permission to change the executable:
  113. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  114.        Permission is given for any non-English speaking sysops to zap the
  115. executable. Please take care doing this as ALL the text is positioned at
  116. the end of the executable together.
  117.  
  118.        The only output a user will ever see from MTC are error messages.
  119. The text files can be in your own language.
  120.  
  121.  
  122. Program status:
  123. ~~~~~~~~~~~~~~~
  124.        MTC is freeware.  Use it as you please.  Any bug reports orsuggestions
  125. for improvements can be sent to me via Fido or UUCP:
  126.  
  127.      FidoNET:  Phillip Eastham@3:622/406
  128.      InterNET: phillip_eastham@kumear.apana.org.au
  129.  
  130.  
  131. History:
  132. ~~~~~~~~
  133.        Version 1.0  - First release.
  134.  
  135.        Version 1.1  - Fixed bug with logging of user in the log.
  136.                       Added option to use either 1 user specific text file or
  137.                        simply a path and their username as filename.
  138.  
  139.        Version 1.2  - Converted several functions to use DLG's library.
  140.                       Changed so that both a single file and a specific file
  141.                        could be used for user specific restrictions.
  142.  
  143.