home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
IUTIL170.ZIP
/
IUTIL.DOC
< prev
next >
Wrap
Text File
|
1995-07-09
|
20KB
|
425 lines
──────────────────────────────────────────────────────────────────
IUTIL 1.70 An IMAIL tool 09.07.95
──────────────────────────────────────────────────────────────────
(C) 1991-1994 by Andreas Klein, Freising
IUTIL is an utility for IMAIL 1.70
╔════════════════════════════════════════════════════════════════╗
║ W A R N I N G ║
╟────────────────────────────────────────────────────────────────╢
║ ║
║ This archive is only an original archive if it has an intact ║
║ ARJ-security envelope. When extracting the files, ARJ shall ║
║ report the following text: ║
║ ║
║ *** Verifying ARJ SECURITY envelope ... Valid envelope! ║
║ ║
║ and ║
║ ║
║ *** Valid ARJ-SECURITY envelope signature: ║
║ *** Andreas Klein (Germany) R#0106 ║
║ ║
║ Otherwise you got a modified archive which should be deleted ║
║ immediately. Do not use IUTIL versions from modified archives ║
║ because they could contain viruses or other unhappy things. ║
║ ║
║ Please send me a mail if you find such archives! ║
║ ║
╚════════════════════════════════════════════════════════════════╝
──────────────────────────────────────────────────────────────────
I. General
──────────────────────────────────────────────────────────────────
IUTIL is a program which has been developed to add several
functions which are not present in IMAIL itself.
IUTIL converts the area-config of IMAIL into user definable
ASCII files.
IUTIL uses a text-configuration. The config-reader allows you
to divide the config into several parts which are included
in the main config and handled as one big config-file.
The config-reader reads the file top-down and later statements
overwrite the settings of earlier statements (if possible).
IUTIL uses overlays, which should help people with less memory
or big IMAIL-configurations. IUTIL stores its overlays on disk
or in EMS (if your system has EMS).
IUTIL has the following command line parameters:
/NOEMS disables the use of EMS for the overlay file.
/CFG<filename> allows another name for the config file to be
selected. <filename> should be a real
file name without path.
/NOLOG Disables logging for this run of IUTIL.
/DEBUG Switch loglevel to DEBUG-level.
/NOWAIT Disables the 5 sec pause at the end of IUTIL.
/SHARING Enables the support for special filemodes which
support sharing files.
When searching for its configuration file (either IUTIL.CFG or
<filename> if the /CFG commandline-switch was used), IUTIL
searches the following directories in the given order:
- current directory
- directory to which the IUTIL environment variable points
- directory to which the IMAIL environment variable points and
- directory where IUTIL.EXE resides
The compiled configuration is created where IUTIL first finds
the configuration-file.
IUTIL uses the following environment variables (if present and
necessary):
IUTIL points to the IUTIL home directory
IMAIL points to the IMAIL home directory
and other environment variables in path names if the following
format is used:
%<ENVVAR>%
──────────────────────────────────────────────────────────────────
II. CONVERSION
──────────────────────────────────────────────────────────────────
After configuring IUTIL, you don't have to edit thousands of text
configs anymore when you add, change or delete an echo. You simply
edit your IMAIL setup and run IUTIL.
Before you can do this you have to adapt the IUTIL configuration.
You should add all the information IUTIL cannot find in the IMAIL
configuration. The configuration is not easy and there is no
full-screen setup available.
The configuration contains information regarding a general level
(affecting all echos not otherwise defined per group or per echo)
and on a per group and per echo level. This is information about
security levels, flags, echo settings and all the other things
which are supported by the destination software.
IUTIL puts this information and the IMAIL setup together and
creates or extends the necessary files. The old config files
will be renamed to *.BAK.
Moreover it is possible to set security levels and flags for each
area independently of the group to which the area belongs.
The user has the choice of whether areas existing only in the
setup of the destination programs will be deleted or if
they should be copied to the new configuration.
It is possible to exclude single echos and whole groups with
the ECDISCARD and GRDISCARD statements.
The contents of the files are configurable by the user. See
IUTIL.MAC for a list of the available macros.
In addition, it is possible to insert any ASCII character
into the output simply by specifying it in the
*DESCRIPTION/*LISTFMT statement and a configurable
number of spaces or a tab can be inserted in the output.
GENDESCRIPTION %t %a20 %c %a70 (%g)
creates
386.GER GER: 386er, 486er (A)
while
GENLISTFMT %b %a5 %t %a25 %e
creates a normal AREAS.BBS.
Lines in the config file beginning with a ';' are treated as
comments and ignored, but comments in command lines are
not allowed.
Moreover you can sort the items in FOLDER.FD/AREAS files
according different criteria.
IUTIL uses two sections in its config, each beginning with one
of the following statements.
[Imail] Defines the path to IMAIL configuration.
[Areas] Defines where IUTIL creates the AREAS.BBS file
and what information will be put into the file.
Each Areas section creates a unique file if at
least the PATH and the LISTFMT statements are
present in the section.
The HEADER and the FOOTER statements allow the
addition of definable files to the top and the
bottom of the created files.
The PATH-statements in the IMAIL section can be omitted if the
the corresponding environment variable is defined, which is then
used by IUTIL.
For the temporary deactivation of some sections of the config, you
can use the ACTIVE and INACTIVE statements.
Some information concerning the config-reader:
IUTIL reads IUTIL.CFG top-down. Therefore the last statement shows
effect on the program's behavior. For example
GRINFO ABCD ECHOMAIL
GRINFO CDEF ECHO_INFO
causes groups A and B to be set to ECHOMAIL and CDEF to ECHO_INFO.
The ECHOMAIL-setting for CD is overwritten by the second statement.
The information from previous statements is not overtaken if the
statement appears again for the same group/echo. This affects all
types of statements.
When creating the configuration of the different programs, settings
from the GEN*-statements are overwritten by matching settings of
GR*-statements. Settings of GR*-statements are overwritten by
matching settings of EC*-statements. Then GEN*-statements show
effect as long as no matching GR*- and EC*-statement is present,
the GR*-statements show effect as long as no matching EC*-statement
is present.
Consider both things, the top-down-effect and the general-special
effect when writing your configs.
Some EC*-tags are reserved for predefined IMAIL-echos:
BADMAIL badmailboard
DUPES dupeboard
After an EC*-statement, only one echo-tag can be specified.
But you can put more than one group behind the GR*-statements.
IUTIL has the following command line options:
/HELP shows a help-screen
──────────────────────────────────────────────────────────────────
III. Errorlevels
──────────────────────────────────────────────────────────────────
The program returns the following errorlevels:
001 Incorrect system-clock.
002 Invalid IUTIL.KEY key file
003 Beta key necessary
004 Alpha key necessary
005 General overlay error
006 Overlay file not found
007 No memory for overlay buffer
008 Error while reading overlay file
009 Cannot write logfile
010 Cannot find IUTIL configuration
011 Incorrect IMAIL version
014 Cannot create AREAS file
015 Cannot read IUTIL.CFG
016 Path to IMAIL configuration not defined
021 Cannot open IMAIL.CF
022 Cannot open IMAIL.AR
028 Error while reading IMAIL.CF
029 Error while reading IMAIL.AR
059 Error while seeking IMAIL.AR
061 Cannot create AREAS.BBS file
062 Error while writing AREAS.BBS files
097 No definitions available for this IMAIL-version
098 Keyfile does not match IMAIL.CF
099 Memory Deallocation error.
and the following DOS I/O-Errors:
002 DOS I/O-Error : File not found
003 DOS I/O-Error : Path not found
004 DOS I/O-Error : Too many open files
005 DOS I/O-Error : Access denied
006 DOS I/O-Error : Invalid file handle
007 DOS I/O-Error : Memory Control Blocks destroyed
008 DOS I/O-Error : Not enough memory
009 DOS I/O-Error : Invalid Memory Block Address
010 DOS I/O-Error : Invalid Environment
011 DOS I/O-Error : Invalid Format
012 DOS I/O-Error : Invalid File Access Mode
013 DOS I/O-Error : Invalid Data
015 DOS I/O-Error : Invalid Drive Number
016 DOS I/O-Error : Cannot remove current directory
017 DOS I/O-Error : Cannot Rename Across Drives
018 DOS I/O-Error : No more files
019 DOS I/O-Error : Write on Writeprotected Disk
020 DOS I/O-Error : Unknown Unit
021 DOS I/O-Error : Drive not ready
022 DOS I/O-Error : Unknown command
023 DOS I/O-Error : Data CRC Error
024 DOS I/O-Error : Bad Request Length
025 DOS I/O-Error : Seek Error
026 DOS I/O-Error : Unknown Media Type
027 DOS I/O-Error : Sector not found
028 DOS I/O-Error : Printer out of paper
029 DOS I/O-Error : Write fault
030 DOS I/O-Error : Read fault
031 DOS I/O-Error : General failure
032 DOS I/O-Error : Sharing violation
033 DOS I/O-Error : Lock violation
034 DOS I/O-Error : Invalid disk change
035 DOS I/O-Error : FCB unavailable
036 DOS I/O-Error : Sharing buffer overflow
050 DOS I/O-Error : Network request not supported
051 DOS I/O-Error : Remote computer not listening
052 DOS I/O-Error : Duplicate name on network
053 DOS I/O-Error : Network name not found
054 DOS I/O-Error : Network busy
055 DOS I/O-Error : Network device no longer exist
056 DOS I/O-Error : Netbios command limited
057 DOS I/O-Error : Network hardware error
058 DOS I/O-Error : Incorrect response from network
059 DOS I/O-Error : Unexcpected network error
060 DOS I/O-Error : Incompatible remote adapter
061 DOS I/O-Error : Print queue full
062 DOS I/O-Error : Not enough space for printz file
063 DOS I/O-Error : Print file was deleted
064 DOS I/O-Error : Network name was deleted
065 DOS I/O-Error : Access denied
066 DOS I/O-Error : Network device type incorrect
067 DOS I/O-Error : Network name not found
068 DOS I/O-Error : Network name limit exceeded
069 DOS I/O-Error : NetBIOS session limit exceeded
070 DOS I/O-Error : Temprarily paused
071 DOS I/O-Error : Network request not accepted
072 DOS I/O-Error : Print or disk redirection is paused
080 DOS I/O-Error : File exists
082 DOS I/O-Error : Cannot make directory entry
084 DOS I/O-Error : Too many redirections
085 DOS I/O-Error : Duplicate redirection
086 DOS I/O-Error : Invalid password
087 DOS I/O-Error : Invalid parameter
088 DOS I/O-Error : Network device fault
100 DOS I/O-Error : Disk read error
101 DOS I/O-Error : Disk write error
102 DOS I/O-Error : File not assigned
103 DOS I/O-Error : File not open
104 DOS I/O-Error : File not open for input
105 DOS I/O-Error : File not open for output
106 DOS I/O-Error : Invalid numeric format
150 DOS I/O-Error : Disk is write protected
151 DOS I/O-Error : Unknown unit
152 DOS I/O-Error : Drive not ready
153 DOS I/O-Error : Unknown command
154 DOS I/O-Error : CRC error in data
155 DOS I/O-Error : Bad drive request structure length
156 DOS I/O-Error : Disk seek error
157 DOS I/O-Error : Unknown media type
158 DOS I/O-Error : Sector not found
159 DOS I/O-Error : Printer out of paper
160 DOS I/O-Error : Device write fault
161 DOS I/O-Error : Device read fault
162 DOS I/O-Error : Hardware failure
If the program reports an error or does not work properly,
please check the setup first. If you cannot determine the
error, please let me know (with as many details as possible).
──────────────────────────────────────────────────────────────────
IV. COPYRIGHT
──────────────────────────────────────────────────────────────────
The following programs mentioned in this documentation are
copyrighted.
Turbo Pascal 6.0 Borland International
Squish Scott Dudley
JAM(mbp) API Joaquim Homrighausen, Andrew Milner,
Mats Birch and Mats Wallin.
This software and anything enclosed in the original archive are
protected by both German and international copyright law and
treaty provisions.
IUTIL is NOT Public-Domain or Freeware, it is released as
Shareware. If you intend to use this program after a trial
period of 30 days, you must register your copy of IUTIL
or stop using it.
You are entitled and encouraged to give this program together
with its documentation to anybody, if you do not change the
contents of the archive or the program itself. Distributing
of modified versions is prohibited.
You must not charge for passing the program to another person
or system. The distribution of the program by professionals
(who will violate one of the above restrictions) must be
permitted by the author.
──────────────────────────────────────────────────────────────────
V. REGISTRATION
──────────────────────────────────────────────────────────────────
When you register IUTIL, you will receive a key-file. The key will
work for all future releases or there will be a low-cost upgrade
for major new versions.
For creating the key I need your name and one of your akas as
listed in IMSETUP.
Detailed information and the necessary registration form can be
found in the IUTILREG.ARJ archive.
──────────────────────────────────────────────────────────────────
VI. CREDITS
──────────────────────────────────────────────────────────────────
I would like to thank all people who helped in developing IUTIL.
This includes the whole IMAIL beta team who tested IUTIL and
helped to include useful and powerful features.
──────────────────────────────────────────────────────────────────
VII. DISCLAIMER AND WARRANTY
──────────────────────────────────────────────────────────────────
This software is provided AS IS without any warranty, expressed
or implied, including but not limited to fitness for a particular
purpose.
The author will not be liable for any direct or consequential
damages due to loss of data or any other reason, the person
using the software bears all risk as to the quality and per-
formance of the software.
If your local laws do not permit any of the statements made
above, or if you do not agree with any of them yourself,
then you are not licensed to use this program!
Bug reports, questions and suggestions are appreciated by
the author and can be send to
Andreas Klein
2:2480/47@FidoNet
2:2480/48@FidoNet
2:2480/49@FidoNet
246:6107/0@PB-Net
alpha.schiele-ct.de
Alpha's Node, +49-8161-22447 (USR)
+49-8161-22480 (ZYX)
+49-8161-22487 (X75)
The newest version of IUTIL can be requested under the Magic
IUTIL at least at my system.
──────────────────────────────────────────────────────────────────
END OF FILE
──────────────────────────────────────────────────────────────────