Category : Network Files
Archive   : MNTINI.ZIP
Filename : MAINTINI.DOC

ACKNOWLEDGEMENTS:

Thanks to the good people at Borland International and
TurboPower Software. Without their wares, this program would
not have been written.

Microsoft for not supplying us with decent administration tools.
With them, this program would not have been neccessary.

PURPOSE:

This program will be of use to Network administrators who need
to administer Windows 3.1 on the network and make changes to specific
parameters in the INI files.

OPERATION:

The program is invoked with four parameters:

MAINTINI filename section parameter [+-]value

filename = This is the INI filename. The file may be either
in the current directory or anywhere in the path. The
first occurence of the file is changed. Specify the
filename including the extension.

section = This is the section in the INI file where the parameter to
be changed is to be found. eg:[windows]
******* IMPORTANT *******
The section should not be enclosed in '[]'. These
brackets are automatically supplied by the program.

parameter = Name of the parameter eg:load,run

value = This is the value for the parameter.
If the first character of the value is a + symbol,
the value is added to the existing line in the file.
eg: MAINTINI WIN.INI windows load +q.exe
If your load line looked like load=nwpopup.exe,
after the program runs, it would look like
load=nwpopup.exe q.exe.

If the first character is -, then the supplied value
will be removed from the line if it exists:
eg: MAINTINI WIN.INI windows load +q.exe
If your load line looked like load=nwpopup.exe q.exe,
after the program runs, it would look like
load=nwpopup.exe

If the first character is anything else, the supplied
value will overwrite any other values for that parameter.
To use the same example as above, if your load line
looks like load=nwpopup.exe q.exe and you ran the
program with
MAINTINI WIN.INI windows load q.exe
after the execution, the line would be load=q.exe.

****** During the program execution, a temporary file, TEMP.$$$,
is created and then deleted in the directory where the
specified file resides.

TERMINATION CODES
If any error occurs during the execution, the program terminates
with the appropriate error code which can be examined by checking
the DOS ErrorLevel variable. Here is the list of possible errors,
all of which cause the program to terminate:

1 = File Specified to change cannot be found in the current
directory or the path.
2 = Temporary file(TEMP.$$$) exists and cannot be deleted.
3 = Error Opening specified file
4 = Error creating temporary file(TEMP.$$$)
5 = Invalid Command Line
6 = The value to be deleted does not exist.
7 = The section specified does not exist.
8 = The parameter specified does not exist.

As far as I know the program works fine.

PLANNED ENHANCEMENTS:
- If the parameter line does not exist in the file, add the line.
- Comment out a line.
- Change multiple files, multiple lines at the same time using a
configuration files.
- Other goodies as yet unknown.

THE FINANCIAL STUFF.

This program is supplied at no cost to you apart from the cost of
the download. I ask for no contributions but if you are feeling
generous, please contribute whatever you can afford to the local
food bank or to your favorite charity.

I can be contacted at 71521,21 on Compuserve Information Service
if you have any suggestions, comments or bug reports. Please be
patient if you don't hear back from me as I have a more than fulltime
job. I will post any enhancements/bug fixes as soon as I make them
and will notify you if you have gotten in touch with me.



DISCLAIMER
This is the work me, the individual. I make no claims as to the
functionality or suitability of this program for any purpose. Use
this entirely at your own risk and I will not be held liable for
any damages, loss of revenue or any fortunate or unfortunate
occurence as a result of using or not using this program.

This program was written using Borland Pascal 7.0 from Borland
International and the Object Professional 1.20 from TurboPower
Software.The program contains copyrighted code from these two
sources.