home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Elysian Archive
/
AmigaElysianArchive.iso
/
comm
/
mtc14.lha
/
MTC.doc
< prev
Wrap
Text File
|
1993-08-13
|
7KB
|
189 lines
M a s t e r - T i m e C o n t r o l
v1.4
(c) P. Eastham 1992-93
----------------------------------------------------------------------------
What is it?
~~~~~~~~~~~
MTC is a PrimeTime like program. It allows you to restrict a users
time on several different levels.
How to set it up:
~~~~~~~~~~~~~~~~~
Copy the MTC executable to your DLG: directory, or anywhere else on
your path. Edit your login.(dlg)batch file and put the command in. MTC has
the following usage:
DLG:MTC -P%PORT -T%TLCALL [-L] [-C]
Order and case are not important.
What the switches mean:
-P Port they are on
-T Time left this call
-L Turn on logging (Recommended)
-C Clear the screen before anything is sent at all
Then you need to create the config file (discussed below).
The exemption file contains exempt users names, 1 per line, in normal
format. Use spaces NOT underscore's.
The possible output files can contain any DLG %-Switch EXCEPT the
%RETURN switch. USING THIS SWITCH WILL CRASH THE PROGRAM!!
MTC is now installed.
The config file:
~~~~~~~~~~~~~~~~
The first line of the config is the path and name of the text file shown
to users if they have their time reduced at all. All % switches may be used
here EXCEPT the %RETURN switch.
eg: DLGConfig:Text/MTC.txt
The second line is the path and name of the exemption file.
eg: DLGConfig:Text/MTC.users
The third line is the path and filename of the file which user
restricted people will see.
eg: DLGConfig:Text/MTC.BadUser
The fourth line is a PATH ONLY line. This allows for individual text
files to be sent to user restricted people. The actual filename is their
underscored username. This path must end in either a "/" or a ":". No
checking is done. If this path/file doesn't exist, then the file in line 3
will be sent instead.
eg: DLGConfig:Text/BadUser/
The fifth line is the text file sent when using the port specific
option.
eg: DLGConfig:Text/MTC.Port
The sixth line is the text file sent when using the baud specific
option.
eg: DLGConfig:Text/MTC.Baud
The seventh line is the text file sent when using the baud and port
specific option.
eg: DLGConfig:Text/MTC.BaudPort
Config lines are grouped 4 at a time from now until the end of the file.
Errors in the config file such as 1 line short will produce an "End Of File"
error and the program will exit.
The first line represents the type of restriction and the type of
restriction to be imposed. The first letter must be one of the following:
B - Baud value equal to this.
C - Baud value greater than this.
D - Baud vaule less than this.
L - Users LESS than this level
E - Users EQUAL to this level
G - Users greater than this level
U - This specific user.
P - This specific port.
K - Baud value less than this AND this specific port
eg: L255 - All users with security less than 255.
E110 - All users with a security level of 110.
G150 - All users with security greater than 150.
UJoe Bloggs - User Joe Bloggs.
PTR0 - All users logging onto port TR0.
B9600 - All users with a baud rate of 9600.
C9600 - All users with a baud rate greater than 9600.
D9600 - All users with a baud rate less than 9600.
K9600TR0 - All users with baud rate less than 9600 and on
port TR0. This option is particularly useful for
keeping slow users off high speed lines!
The second line is wether to directly change the users daily time used
variable. If this is "UPDATE", then the users data file will be directly
altered to reflect the restriction. It will be just as if they had used the
time. 'dlg.library' is used for this function.
eg: UPDATE
NOUPDATE
The third line is the day to be run. This is simply found by directing
the 'DATE' command to a file, reading in the date, and testing if this string
exists in the date. So entering "DAY" will match for every day of the week.
This also allows non-english people to use the program if their date program is
not in english.
eg: SATURDAY
The third line is the time line. ranging from 1 am to 12 pm, separated
by a space. '0' means no restrictions.
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
would give a restriction of 55 minutes from 4pm to 4:59:59pm, and a 40 minute
restriction from 5pm to 10:59:59pm. Note that it starts at 1:00am and NOT
12:00am as most others seem to.
If the first character on this line is the '%' character, then a
percentage value will be used. Values greater than 100 have no effect.
The program reads in each group until a match is made and then drops
out and executes the rest of the program. Therefore you should make any
exceptions such as user specific restrictions at the top and general
restrictions at the bottom.
See the included config file for an example.
Permission to change the executable:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Permission is given for any non-English speaking sysops to zap the
executable. Please take care doing this as ALL the text is positioned at
the end of the executable together.
The only output a user will ever see from MTC are error messages.
The text files can be in your own language.
Program status:
~~~~~~~~~~~~~~~
MTC is freeware. Use it as you please. Any bug reports orsuggestions
for improvements can be sent to me via Fido or UUCP:
FidoNET: Phillip Eastham@3:622/406
InterNET: phillip_eastham@kumear.apana.org.au
History:
~~~~~~~~
Version 1.0 - First release.
Version 1.1 - Fixed bug with logging of user in the log.
- Added option to use either 1 user specific text file or
simply a path and their username as filename.
Version 1.2 - Converted several functions to use DLG's library.
- Changed so that both a single file and a specific file
could be used for user specific restrictions.
Version 1.3 - Added the percentage reduction option.
- Added some verposity to the log file.
Version 1.4 - Added port specific restriction.
- Added baud specific restriction.
- Added port and baud specific restriction.
- Added ability to directly update users data file.