home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / mtc14.lha / MTC.doc < prev   
Text File  |  1993-08-13  |  7KB  |  189 lines
  1.                      M a s t e r - T i m e  C o n t r o l
  2.  
  3.                                      v1.4
  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.        Copy the MTC executable to your DLG: directory, or anywhere else on
  18. your path.  Edit your login.(dlg)batch file and put the command in.  MTC has
  19. the following usage:
  20.  
  21.          DLG:MTC -P%PORT -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.     -T        Time left this call
  29.     -L        Turn on logging (Recommended)
  30.     -C        Clear the screen before anything is sent at all
  31.  
  32.        Then you need to create the config file (discussed below).
  33.  
  34.        The exemption file contains exempt users names, 1 per line, in normal
  35. format. Use spaces NOT underscore's.
  36.  
  37.        The possible output files can contain any DLG %-Switch EXCEPT the
  38. %RETURN switch. USING THIS SWITCH WILL CRASH THE PROGRAM!!
  39.  
  40.        MTC is now installed.
  41.  
  42.  
  43. The config file:
  44. ~~~~~~~~~~~~~~~~
  45.        The first line of the config is the path and name of the text file shown
  46. to users if they have their time reduced at all.  All % switches may be used
  47. here EXCEPT the %RETURN switch.
  48.  
  49.  eg: DLGConfig:Text/MTC.txt
  50.  
  51.        The second line is the path and name of the exemption file.
  52.  
  53.  eg: DLGConfig:Text/MTC.users
  54.  
  55.        The third line is the path and filename of the file which user
  56. restricted people will see.
  57.  
  58.  eg: DLGConfig:Text/MTC.BadUser
  59.  
  60.        The fourth line is a PATH ONLY line. This allows for individual text
  61. files to be sent to user restricted people. The actual filename is their
  62. underscored username. This path must end in either a "/" or a ":". No
  63. checking is done. If this path/file doesn't exist, then the file in line 3
  64. will be sent instead.
  65.  
  66.  eg: DLGConfig:Text/BadUser/
  67.  
  68.        The fifth line is the text file sent when using the port specific
  69. option.
  70.  
  71.  eg: DLGConfig:Text/MTC.Port
  72.  
  73.        The sixth line is the text file sent when using the baud specific
  74. option.
  75.  
  76.  eg: DLGConfig:Text/MTC.Baud
  77.  
  78.        The seventh line is the text file sent when using the baud and port
  79. specific option.
  80.  
  81.  eg: DLGConfig:Text/MTC.BaudPort
  82.  
  83.        Config lines are grouped 4 at a time from now until the end of the file.
  84. Errors in the config file such as 1 line short will produce an "End Of File"
  85. error and the program will exit.
  86.  
  87.        The first line represents the type of restriction and the type of
  88. restriction to be imposed. The first letter must be one of the following:
  89.  
  90.          B - Baud value equal to this.
  91.          C - Baud value greater than this.
  92.          D - Baud vaule less than this.
  93.          L - Users LESS than this level
  94.          E - Users EQUAL to this level
  95.          G - Users greater than this level
  96.          U - This specific user.
  97.          P - This specific port.
  98.          K - Baud value less than this AND this specific port
  99.  
  100.  
  101.  eg: L255            - All users with security less than 255.
  102.      E110            - All users with a security level of 110.
  103.      G150            - All users with security greater than 150.
  104.      UJoe Bloggs     - User Joe Bloggs.
  105.      PTR0            - All users logging onto port TR0.
  106.      B9600           - All users with a baud rate of 9600.
  107.      C9600           - All users with a baud rate greater than 9600.
  108.      D9600           - All users with a baud rate less than 9600.
  109.      K9600TR0        - All users with baud rate less than 9600 and on
  110.                        port TR0. This option is particularly useful for
  111.                        keeping slow users off high speed lines!
  112.  
  113.        The second line is wether to directly change the users daily time used
  114. variable.  If this is "UPDATE", then the users data file will be directly
  115. altered to reflect the restriction.  It will be just as if they had used the
  116. time.  'dlg.library' is used for this function.
  117.  
  118.  eg: UPDATE
  119.      NOUPDATE
  120.  
  121.        The third line is the day to be run. This is simply found by directing
  122. the 'DATE' command to a file, reading in the date, and testing if this string
  123. exists in the date. So entering "DAY" will match for every day of the week.
  124. This also allows non-english people to use the program if their date program is
  125. not in english.
  126.  
  127.  eg: SATURDAY
  128.  
  129.        The third line is the time line. ranging from 1 am to 12 pm, separated
  130. by a space. '0' means no restrictions.
  131.  
  132.    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
  133.  
  134. would give a restriction of 55 minutes from 4pm to 4:59:59pm, and a 40 minute
  135. restriction from 5pm to 10:59:59pm. Note that it starts at 1:00am and NOT
  136. 12:00am as most others seem to.
  137.  
  138.        If the first character on this line is the '%' character, then a
  139. percentage value will be used. Values greater than 100 have no effect.
  140.  
  141.        The program reads in each group until a match is made and then drops
  142. out and executes the rest of the program. Therefore you should make any
  143. exceptions such as user specific restrictions at the top and general
  144. restrictions at the bottom.
  145.  
  146.        See the included config file for an example.
  147.  
  148.  
  149. Permission to change the executable:
  150. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  151.        Permission is given for any non-English speaking sysops to zap the
  152. executable. Please take care doing this as ALL the text is positioned at
  153. the end of the executable together.
  154.  
  155.        The only output a user will ever see from MTC are error messages.
  156. The text files can be in your own language.
  157.  
  158.  
  159. Program status:
  160. ~~~~~~~~~~~~~~~
  161.        MTC is freeware.  Use it as you please.  Any bug reports orsuggestions
  162. for improvements can be sent to me via Fido or UUCP:
  163.  
  164.      FidoNET:  Phillip Eastham@3:622/406
  165.      InterNET: phillip_eastham@kumear.apana.org.au
  166.  
  167.  
  168. History:
  169. ~~~~~~~~
  170.        Version 1.0  - First release.
  171.  
  172.        Version 1.1  - Fixed bug with logging of user in the log.
  173.                     - Added option to use either 1 user specific text file or
  174.                       simply a path and their username as filename.
  175.  
  176.        Version 1.2  - Converted several functions to use DLG's library.
  177.                     - Changed so that both a single file and a specific file
  178.                       could be used for user specific restrictions.
  179.  
  180.        Version 1.3  - Added the percentage reduction option.
  181.                     - Added some verposity to the log file.
  182.  
  183.        Version 1.4  - Added port specific restriction.
  184.                     - Added baud specific restriction.
  185.                     - Added port and baud specific restriction.
  186.                     - Added ability to directly update users data file.
  187.  
  188.  
  189.