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 >
Text File  |  1995-07-09  |  20KB  |  425 lines
  1.         ──────────────────────────────────────────────────────────────────
  2.         IUTIL 1.70               An IMAIL tool                    09.07.95
  3.         ──────────────────────────────────────────────────────────────────
  4.  
  5.                    (C) 1991-1994 by Andreas Klein, Freising
  6.  
  7.                       IUTIL is an utility for IMAIL 1.70
  8.  
  9.         ╔════════════════════════════════════════════════════════════════╗
  10.         ║                      W  A  R  N  I  N  G                       ║
  11.         ╟────────────────────────────────────────────────────────────────╢
  12.         ║                                                                ║
  13.         ║  This archive is only an original archive if it has an intact  ║
  14.         ║  ARJ-security envelope. When extracting the files, ARJ shall   ║
  15.         ║  report the following text:                                    ║
  16.         ║                                                                ║
  17.         ║  *** Verifying ARJ SECURITY envelope ... Valid envelope!       ║
  18.         ║                                                                ║
  19.         ║  and                                                           ║
  20.         ║                                                                ║
  21.         ║  *** Valid ARJ-SECURITY envelope signature:                    ║
  22.         ║  *** Andreas Klein (Germany) R#0106                            ║
  23.         ║                                                                ║
  24.         ║  Otherwise you got a modified archive which should be deleted  ║
  25.         ║  immediately. Do not use IUTIL versions from modified archives ║
  26.         ║  because they could contain viruses or other unhappy things.   ║
  27.         ║                                                                ║
  28.         ║  Please send me a mail if you find such archives!              ║
  29.         ║                                                                ║
  30.         ╚════════════════════════════════════════════════════════════════╝
  31.  
  32.         ──────────────────────────────────────────────────────────────────
  33.         I. General
  34.         ──────────────────────────────────────────────────────────────────
  35.  
  36.         IUTIL is a program which has been developed to add several
  37.         functions which are not present in IMAIL itself.
  38.  
  39.         IUTIL converts the area-config of IMAIL into user definable
  40.         ASCII files.
  41.  
  42.         IUTIL uses a text-configuration. The config-reader allows you
  43.         to divide the config into several parts which are included
  44.         in the main config and handled as one big config-file.
  45.         The config-reader reads the file top-down and later statements
  46.         overwrite the settings of earlier statements (if possible).
  47.  
  48.         IUTIL uses overlays, which should help people with less memory
  49.         or big IMAIL-configurations. IUTIL stores its overlays on disk
  50.         or in EMS (if your system has EMS).
  51.  
  52.         IUTIL has the following command line parameters:
  53.  
  54.           /NOEMS         disables the use of EMS for the overlay file.
  55.           /CFG<filename> allows another name for the config file to be
  56.                          selected.  <filename> should be a real 
  57.                          file name without path.
  58.  
  59.           /NOLOG         Disables logging for this run of IUTIL.
  60.  
  61.           /DEBUG         Switch loglevel to DEBUG-level.
  62.  
  63.           /NOWAIT        Disables the 5 sec pause at the end of IUTIL.
  64.  
  65.           /SHARING       Enables the support for special filemodes which
  66.                          support sharing files.
  67.  
  68.         When searching for its configuration file (either IUTIL.CFG or
  69.         <filename> if the /CFG commandline-switch was used), IUTIL
  70.         searches the following directories in the given order:
  71.  
  72.           - current directory
  73.           - directory to which the IUTIL environment variable points
  74.           - directory to which the IMAIL environment variable points and
  75.           - directory where IUTIL.EXE resides
  76.  
  77.         The compiled configuration is created where IUTIL first finds
  78.         the configuration-file.
  79.  
  80.         IUTIL uses the following environment variables (if present and
  81.         necessary):
  82.  
  83.           IUTIL     points to the IUTIL home directory
  84.           IMAIL     points to the IMAIL home directory
  85.  
  86.         and other environment variables in path names if the following
  87.         format is used:
  88.  
  89.           %<ENVVAR>%
  90.  
  91.         ──────────────────────────────────────────────────────────────────
  92.         II. CONVERSION
  93.         ──────────────────────────────────────────────────────────────────
  94.  
  95.         After configuring IUTIL, you don't have to edit thousands of text
  96.         configs anymore when you add, change or delete an echo. You simply
  97.         edit your IMAIL setup and run IUTIL.
  98.  
  99.         Before you can do this you have to adapt the IUTIL configuration.
  100.         You should add all the information IUTIL cannot find in the IMAIL
  101.         configuration. The configuration is not easy and there is no
  102.         full-screen setup available.
  103.  
  104.         The configuration contains information regarding a general level
  105.         (affecting all echos not otherwise defined per group or per echo)
  106.         and on a per group and per echo level. This is information about
  107.         security levels, flags, echo settings and all the other things
  108.         which are supported by the destination software.
  109.  
  110.         IUTIL puts this information and the IMAIL setup together and
  111.         creates or extends the necessary files. The old config files
  112.         will be renamed to *.BAK.
  113.  
  114.         Moreover it is possible to set security levels and flags for each
  115.         area independently of the group to which the area belongs.
  116.  
  117.         The user has the choice of whether areas existing only in the
  118.         setup of the destination programs will be deleted or if 
  119.         they should be copied to the new configuration.
  120.  
  121.         It is possible to exclude single echos and whole groups with 
  122.         the ECDISCARD and GRDISCARD statements.
  123.  
  124.         The contents of the files are configurable by the user. See
  125.         IUTIL.MAC for a list of the available macros.
  126.  
  127.         In addition, it is possible to insert any ASCII character
  128.         into the output simply by specifying it in the 
  129.         *DESCRIPTION/*LISTFMT statement and a configurable 
  130.         number of spaces or a tab can be inserted in the output.
  131.  
  132.         GENDESCRIPTION  %t %a20 %c %a70 (%g)
  133.  
  134.         creates
  135.  
  136.         386.GER              GER: 386er, 486er                  (A)
  137.  
  138.         while
  139.  
  140.         GENLISTFMT %b %a5 %t %a25 %e
  141.  
  142.         creates a normal AREAS.BBS.
  143.  
  144.         Lines in the config file beginning with a ';' are treated as
  145.         comments and ignored, but comments in command lines are
  146.         not allowed.
  147.  
  148.         Moreover you can sort the items in FOLDER.FD/AREAS files
  149.         according different criteria.
  150.  
  151.         IUTIL uses two sections in its config, each beginning with one
  152.         of the following statements.
  153.  
  154.         [Imail]         Defines the path to IMAIL configuration.
  155.  
  156.         [Areas]         Defines where IUTIL creates the AREAS.BBS file
  157.                         and what information will be put into the file.
  158.                         Each Areas section creates a unique file if at 
  159.                         least the PATH and the LISTFMT statements are
  160.                         present in the section.
  161.                         The HEADER and the FOOTER statements allow the
  162.                         addition of definable files to the top and the
  163.                         bottom of the created files.
  164.  
  165.         The PATH-statements in the IMAIL section can be omitted if the
  166.         the corresponding environment variable is defined, which is then
  167.         used by IUTIL.
  168.  
  169.         For the temporary deactivation of some sections of the config, you
  170.         can use the ACTIVE and INACTIVE statements.
  171.  
  172.         Some information concerning the config-reader:
  173.  
  174.         IUTIL reads IUTIL.CFG top-down. Therefore the last statement shows
  175.         effect on the program's behavior. For example
  176.  
  177.           GRINFO  ABCD ECHOMAIL
  178.           GRINFO  CDEF ECHO_INFO
  179.  
  180.         causes groups A and B to be set to ECHOMAIL and CDEF to ECHO_INFO.
  181.         The ECHOMAIL-setting for CD is overwritten by the second statement.
  182.         The information from previous statements is not overtaken if the
  183.         statement appears again for the same group/echo. This affects all
  184.         types of statements.
  185.  
  186.         When creating the configuration of the different programs, settings
  187.         from the GEN*-statements are overwritten by matching settings of
  188.         GR*-statements. Settings of GR*-statements are overwritten by
  189.         matching settings of EC*-statements. Then GEN*-statements show
  190.         effect as long as no matching GR*- and EC*-statement is present,
  191.         the GR*-statements show effect as long as no matching EC*-statement
  192.         is present.
  193.  
  194.         Consider both things, the top-down-effect and the general-special
  195.         effect when writing your configs.
  196.  
  197.         Some EC*-tags are reserved for predefined IMAIL-echos:
  198.  
  199.           BADMAIL               badmailboard
  200.           DUPES                 dupeboard
  201.  
  202.         After an EC*-statement, only one echo-tag can be specified.
  203.         But you can put more than one group behind the GR*-statements.
  204.  
  205.         IUTIL has the following command line options:
  206.  
  207.           /HELP    shows a help-screen
  208.  
  209.         ──────────────────────────────────────────────────────────────────
  210.         III. Errorlevels
  211.         ──────────────────────────────────────────────────────────────────
  212.  
  213.         The program returns the following errorlevels:
  214.  
  215.         001     Incorrect system-clock.
  216.         002     Invalid IUTIL.KEY key file
  217.         003     Beta key necessary
  218.         004     Alpha key necessary
  219.         005     General overlay error
  220.         006     Overlay file not found
  221.         007     No memory for overlay buffer
  222.         008     Error while reading overlay file
  223.         009     Cannot write logfile
  224.         010     Cannot find IUTIL configuration
  225.         011     Incorrect IMAIL version
  226.         014     Cannot create AREAS file
  227.         015     Cannot read IUTIL.CFG
  228.         016     Path to IMAIL configuration not defined
  229.         021     Cannot open IMAIL.CF
  230.         022     Cannot open IMAIL.AR
  231.         028     Error while reading IMAIL.CF
  232.         029     Error while reading IMAIL.AR
  233.         059     Error while seeking IMAIL.AR
  234.         061     Cannot create AREAS.BBS file
  235.         062     Error while writing AREAS.BBS files
  236.         097     No definitions available for this IMAIL-version
  237.         098     Keyfile does not match IMAIL.CF
  238.         099     Memory Deallocation error.
  239.  
  240.         and the following DOS I/O-Errors:
  241.  
  242.         002     DOS I/O-Error : File not found
  243.         003     DOS I/O-Error : Path not found
  244.         004     DOS I/O-Error : Too many open files
  245.         005     DOS I/O-Error : Access denied
  246.         006     DOS I/O-Error : Invalid file handle
  247.         007     DOS I/O-Error : Memory Control Blocks destroyed
  248.         008     DOS I/O-Error : Not enough memory
  249.         009     DOS I/O-Error : Invalid Memory Block Address
  250.         010     DOS I/O-Error : Invalid Environment
  251.         011     DOS I/O-Error : Invalid Format
  252.         012     DOS I/O-Error : Invalid File Access Mode
  253.         013     DOS I/O-Error : Invalid Data
  254.         015     DOS I/O-Error : Invalid Drive Number
  255.         016     DOS I/O-Error : Cannot remove current directory
  256.         017     DOS I/O-Error : Cannot Rename Across Drives
  257.         018     DOS I/O-Error : No more files
  258.         019     DOS I/O-Error : Write on Writeprotected Disk
  259.         020     DOS I/O-Error : Unknown Unit
  260.         021     DOS I/O-Error : Drive not ready
  261.         022     DOS I/O-Error : Unknown command
  262.         023     DOS I/O-Error : Data CRC Error
  263.         024     DOS I/O-Error : Bad Request Length
  264.         025     DOS I/O-Error : Seek Error
  265.         026     DOS I/O-Error : Unknown Media Type
  266.         027     DOS I/O-Error : Sector not found
  267.         028     DOS I/O-Error : Printer out of paper
  268.         029     DOS I/O-Error : Write fault
  269.         030     DOS I/O-Error : Read fault
  270.         031     DOS I/O-Error : General failure
  271.         032     DOS I/O-Error : Sharing violation
  272.         033     DOS I/O-Error : Lock violation
  273.         034     DOS I/O-Error : Invalid disk change
  274.         035     DOS I/O-Error : FCB unavailable
  275.         036     DOS I/O-Error : Sharing buffer overflow
  276.         050     DOS I/O-Error : Network request not supported
  277.         051     DOS I/O-Error : Remote computer not listening
  278.         052     DOS I/O-Error : Duplicate name on network
  279.         053     DOS I/O-Error : Network name not found
  280.         054     DOS I/O-Error : Network busy
  281.         055     DOS I/O-Error : Network device no longer exist
  282.         056     DOS I/O-Error : Netbios command limited
  283.         057     DOS I/O-Error : Network hardware error
  284.         058     DOS I/O-Error : Incorrect response from network
  285.         059     DOS I/O-Error : Unexcpected network error
  286.         060     DOS I/O-Error : Incompatible remote adapter
  287.         061     DOS I/O-Error : Print queue full
  288.         062     DOS I/O-Error : Not enough space for printz file
  289.         063     DOS I/O-Error : Print file was deleted
  290.         064     DOS I/O-Error : Network name was deleted
  291.         065     DOS I/O-Error : Access denied
  292.         066     DOS I/O-Error : Network device type incorrect
  293.         067     DOS I/O-Error : Network name not found
  294.         068     DOS I/O-Error : Network name limit exceeded
  295.         069     DOS I/O-Error : NetBIOS session limit exceeded
  296.         070     DOS I/O-Error : Temprarily paused
  297.         071     DOS I/O-Error : Network request not accepted
  298.         072     DOS I/O-Error : Print or disk redirection is paused
  299.         080     DOS I/O-Error : File exists
  300.         082     DOS I/O-Error : Cannot make directory entry
  301.         084     DOS I/O-Error : Too many redirections
  302.         085     DOS I/O-Error : Duplicate redirection
  303.         086     DOS I/O-Error : Invalid password
  304.         087     DOS I/O-Error : Invalid parameter
  305.         088     DOS I/O-Error : Network device fault
  306.         100     DOS I/O-Error : Disk read error
  307.         101     DOS I/O-Error : Disk write error
  308.         102     DOS I/O-Error : File not assigned
  309.         103     DOS I/O-Error : File not open
  310.         104     DOS I/O-Error : File not open for input
  311.         105     DOS I/O-Error : File not open for output
  312.         106     DOS I/O-Error : Invalid numeric format
  313.         150     DOS I/O-Error : Disk is write protected
  314.         151     DOS I/O-Error : Unknown unit
  315.         152     DOS I/O-Error : Drive not ready
  316.         153     DOS I/O-Error : Unknown command
  317.         154     DOS I/O-Error : CRC error in data
  318.         155     DOS I/O-Error : Bad drive request structure length
  319.         156     DOS I/O-Error : Disk seek error
  320.         157     DOS I/O-Error : Unknown media type
  321.         158     DOS I/O-Error : Sector not found
  322.         159     DOS I/O-Error : Printer out of paper
  323.         160     DOS I/O-Error : Device write fault
  324.         161     DOS I/O-Error : Device read fault
  325.         162     DOS I/O-Error : Hardware failure
  326.  
  327.         If the program reports an error or does not work properly,
  328.         please check the setup first. If you cannot determine the
  329.         error, please let me know (with as many details as possible).
  330.  
  331.         ──────────────────────────────────────────────────────────────────
  332.         IV. COPYRIGHT
  333.         ──────────────────────────────────────────────────────────────────
  334.     
  335.         The following programs mentioned in this documentation are
  336.         copyrighted.
  337.  
  338.            Turbo Pascal 6.0   Borland International
  339.            Squish             Scott Dudley
  340.            JAM(mbp)  API      Joaquim Homrighausen, Andrew Milner,
  341.                               Mats Birch and Mats Wallin.
  342.  
  343.         This software and anything enclosed in the original archive are
  344.         protected by both German and international copyright law and
  345.         treaty provisions.
  346.  
  347.         IUTIL is NOT Public-Domain or Freeware, it is released as
  348.         Shareware. If you intend to use this program after a trial
  349.         period of 30 days, you must register your copy of IUTIL
  350.         or stop using it.
  351.  
  352.         You are entitled and encouraged to give this program together
  353.         with its documentation to anybody, if you do not change the
  354.         contents of the archive or the program itself. Distributing
  355.         of modified versions is prohibited.
  356.  
  357.         You must not charge for passing the program to another person
  358.         or system. The distribution of the program by professionals
  359.         (who will violate one of the above restrictions) must be
  360.         permitted by the author.
  361.  
  362.         ──────────────────────────────────────────────────────────────────
  363.         V. REGISTRATION
  364.         ──────────────────────────────────────────────────────────────────
  365.  
  366.         When you register IUTIL, you will receive a key-file. The key will
  367.         work for all future releases or there will be a low-cost upgrade
  368.         for major new versions.
  369.  
  370.         For creating the key I need your name and one of your akas as
  371.         listed in IMSETUP.
  372.  
  373.         Detailed information and the necessary registration form can be
  374.         found in the IUTILREG.ARJ archive.
  375.  
  376.         ──────────────────────────────────────────────────────────────────
  377.         VI. CREDITS
  378.         ──────────────────────────────────────────────────────────────────
  379.  
  380.         I would like to thank all people who helped in developing IUTIL.
  381.  
  382.         This includes the whole IMAIL beta team who tested IUTIL and
  383.         helped to include useful and powerful features.
  384.  
  385.  
  386.         ──────────────────────────────────────────────────────────────────
  387.         VII. DISCLAIMER AND WARRANTY
  388.         ──────────────────────────────────────────────────────────────────
  389.         
  390.         This software is provided AS IS without any warranty, expressed
  391.         or implied, including but not limited to fitness for a particular
  392.         purpose.
  393.  
  394.         The author will not be liable for any direct or consequential
  395.         damages due to loss of data or any other reason, the person
  396.         using the software bears all risk as to the quality and per-
  397.         formance of the software.
  398.  
  399.         If your local laws do not permit any of the statements made
  400.         above, or if you do not agree with any of them yourself,
  401.         then you are not licensed to use this program!
  402.         
  403.         Bug reports, questions and suggestions are appreciated by
  404.         the author and can be send to
  405.  
  406.  
  407.                          Andreas Klein
  408.  
  409.                        2:2480/47@FidoNet
  410.                        2:2480/48@FidoNet
  411.                        2:2480/49@FidoNet
  412.                        246:6107/0@PB-Net
  413.                        alpha.schiele-ct.de
  414.  
  415.                  Alpha's Node, +49-8161-22447 (USR)
  416.                                +49-8161-22480 (ZYX)
  417.                                +49-8161-22487 (X75)
  418.  
  419.         The newest version of IUTIL can be requested under the Magic
  420.         IUTIL at least at my system.
  421.  
  422.         ──────────────────────────────────────────────────────────────────
  423.         END OF FILE
  424.         ──────────────────────────────────────────────────────────────────
  425.