MTLDOCEN.DOC

20.3 KB 0b4da0784cb989b9…
╔══════════════════════════════                 ┌─────────────────┐
║ MTL       Make Them List/Log                  │    D.I.S.P.     │────┐
║                                               │                 │░░░░│
╟──────────────────────────────                 │                 │░░░░│
║ (c) 1994  Robert W.van Hoeven                 │ Dutch           │░░░░│
╟──────────────────────────────                 │   Independent   │░░░░│
║ Release : 15.57                               │     ShareWare   │░░░░│
║ Rel.Date: March 7th, 1994                     │       Programmer│░░░░│
╠══════════════════════════════                 └─────────────────┘░░░░│
║                                               |    │░░░░░░░░░░░░░░░░░│
║ │ MTL.EXE                                     |    └─────────────────┘
║ │                                             |       ┌─────┐        |
║ │                                             |       │░░░░░│        |
║ │                                             |       └──┬──┘        |
║ │ Lines starting with '│' are                 |     ┌────┴────┐      |
║ │ changes to release 15.55/6                  ------││││││ ═══│-------
║                                                     └─────────┘
╠═══════════════════════════════
║ Address: Robert W. van Hoeven
║          PO. Box 131
║          1170 AC  Badhoevedorp
║          Nederland / Holland
╚═══════════════════════════════

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   0   │ Table of contents                                           │
 └───────┴─────────────────────────────────────────────────────────────┘

 1 ---- General information
  1.1   Copyrights and License Agreement
  1.2   Newer versions and contacting the author

 2 ---- Package description and requirements
  2.1   Preface
  2.2   Requirements
  2.3   Usage

 3 ---- Installation description
  3.1   Installation
  3.2   Remarks on archives
  3.3   MTA.CTL

 4 ---- Runtime information
  4.1   Running MTL

 5 ---- Version information and credits
  5.1   The BETA-team
  5.2   Credits
  5.3   Version history
  5.4   Copyright, Trademarks

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   1   │ General information                                         │
 └───────┴─────────────────────────────────────────────────────────────┘

 1.1 Copyrights and License Agreement
 ────────────────────────────────────

 - Users of the MTA-package must accept this disclaimer of warranty:

 - The  MTA-package  is  supplied  as  is.   The  author  disclaims  all
   warranties, expressed or implied, including, without limitation,  the
   warranties of merchantability  and of fitness  for any purpose.   The
   author assumes  no liability  for damages,  direct or  consequential,
   which may result from the use of the MTA-package;

 - The  MTA-package  is  a  "shareware  program"  and is provided at  no
   charge to the user for evaluation.   Feel free to share it with  your
   friends,  but  please  do  not  give  it  away  altered or as part of
   another  system.   The  essence  of  "user-supported"  software is to
   provide personal  computer users  with quality  software without high
   prices, and yet to provide  incentive for programmers to continue  to
   develop new products.

 - If  you find  this program  useful and  find that  you are  using and
   continue the  use of  the MTA-package  after a  30 days trial period,
   you must register the MTA-package as described below;

 - Non-commercial can get a license for the usage up to this release  of
   the MTA-package for  a small amount  of money. Look  into the details
   in  REGISTER.MTA.  Previous  registered  users  will  receive  a  big
   reduction to upgrade to the  newer versions. These users should  look
   into the details in UPGRADE.MTA.   For Non-commercial users there  is
   a POSSIBILITY to submit to one of the special contracts as  explained
   in the file REGISTER.MTA.

 - Commercial usage of  MTA will cost somewhat  more. Also, a so  called
   'closed' Bulletin  Board System  (a system  where the  user must  pay
   direct to the  SysOp to get  full access) is  has to pay  more than a
   Non-commercial  user.  Both  types  of  users  should  look  into the
   details in REGISTER.MTA;

 - The registration of the MTA-package will license ONE copy for use  on
   any computer at any  one time, as long  as the usage confirms  to the
   type of registration you have done (so NON-commercial usage when  you
   have a non-commercial license);

 - Anyone  distributing  the  MTA-package  for any kind of remuneration
   must  first   contact  the   Author   at   the  address   above   for
   authorization.

 - You are  encouraged  to  pass a copy   of the MTA-package  along   to
   your friends  for  evaluation.   Please  encourage  them to  register
   their copy if they find that they can use it;

 - Support  on  MTA,  when  used  in  a  non-commercial environment,  is
   available  by  means  of  written  letters  or by entering the inter-
   national echomail area DISP;

 - Problems and suggestions can be entered in the FidoNet <tm>  Echomail
   conference <tm> called DISP (international). Entering this echo  does
   not  exclude  you  of  the  duty  to register the MTA-package, though
   users who evaluate the product can enter the echo for questions;

 - The  MTA-package, all  programs, the  documentation and support-files
   is  copyrighted  1990,94  by  Robert  W.  van  Hoeven,  PO.  Box 131,
   Badhoevedorp 1170AC, Holland. All  rights are reserved. You  may copy
   this  package  for  backup  purposes.  Also  you  may  copy and share
   unmodified copies of the whole package, providing that the  copyright
   notice    is    reproduced    and    included    on    all    copies.
   Excluded from this statement  are the support-files written  by other
   authors.  Please  refer  to  the  documentation of these programs for
   copyrights and license agreements;

 - It  is  forbidden  to  modify,  adapt,  translate, reverse  engineer,
   decompile  and/or  disassemble  the  software  in  the   MTA-package.
   Patching the medium at  places that carry the  software is seen as  a
   program change and is also forbidden. It is forbidden to create a  so
   called 'bypass' to skip the original introduction screens and  delay.
   Also it is forbidden  to use such a  'bypass' unless supplied by  the
   author (Robert W. van Hoeven) himself;

 - Performing  any  of  the  illegal  actions as stated in the previous
   lines,  is  a  theft  and  no  fair  play  to  the  author  and, more
   important, to the registered users;

 - Bulletin Board  Systems that distribute  the MTA package  can convert
   the WHOLE package  to any archive-system  they like but  all original
   files must  be included  in the  new archive.  The MTA-package on the
   Bulletin Board  can contain  at the  most 2  extra files. These files
   can only be  a commercial for  that Bulletin Board  and/or validation
   data that is presented  as a service to  all users and shall  have no
   other functions;

 - After  the normal  trial period  of 30  days, you  must register  the
   soft- ware (see REGISTER.MTA) or you must remove it from your PC;

 - Comments,  suggestions  and  bug  reports  are  welcome  and will  be
   answered as soon I have the time  to do so. You can send me  a letter
   of leave  a NetMail  <tm> message  named to  Rob Van.hoeven (mind the
   point)  on  node  2:281/904  (PB  Support, Monster, Holland, SysOp is
   Reinier de Groot).  When you want to send me normal mail, address  it
   to:   Robert  W.  van  Hoeven,  PO.  Box  131,  1171 AC Badhoevedorp,
   Holland;  Also  you  can  enter  messages  in  the  FidoNet <tm> DISP
   Echomail <tm> area;


 1.2 Newer versions and contacting the author
 ───────────────────────────────────────────────────────────────────────
 The newest version of  MTA is always available  at the DISP-HQ on  node
 2:281/904.  MTA  is  also  distributed  thru  a  number of DISP support
 nodes and thru some forums in CompuServe. There are six   ways in which
 you can obtain newer versions of MTA:

 - Logging on at DISP-HQ or a support node (FidoNet)
   Look into the file SUPPORT.MTA for a full list of support nodes;

 - Logging on to a SDS node
   MTA is distributed thru SDS/SDN, but only big minors (x.10, x.20  and
   so on) and majors (14.01, 15.01  and so on) are submitted to  the SDS
   distribution point in Holland;

 - Logging on to your own BBS;
   Chances  are,  that  you  will  find  an older version (international
   users) because it will take some time for the new version to  'bleed'
   thru the net;

 - Logging on to CompuServe;
   Important versions of MTA are uploaded to several CompuServe  forums.
   It is intended to upload  versions to the SYMANTEC and  IBMSYS forums
   but depend on the authorization of  the forum sysops. If you are  not
   sure, you can contact me on CompuServe personally;

 - Update service;
   You can enter a special update service (read REGISTER.MTA).


 If you think you have found problems in MTA, or in any other case,  you
 wish to contact the author, you can send me:

 - A letter to the address you can find in the header of this file;

 - A  NetMail  <tm>  message  to   Rob Van.hoeven (please mind the point
   between Van and Hoeven) at 2:281/904 or (better) 2:281/904.5;

 - A Message in the FidoNet <tm> DISP echomail <tm> area;

 - A  message  (mail  forum)  in  CompuServe to user Robert van  Hoeven,
   with account/user number 100120,1146;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   2   │ Package description and requirements                        │
 └───────┴─────────────────────────────────────────────────────────────┘

 2.1 Preface
 ───────────────────────────────────────────────────────────────────────
 MTL  is  an  add-on  utility  for  MTA  and  is distributed in the same
 release  archive  that   contains  MTA.  This   program  may)  NOT   be
 distributed as a stand-alone package.



 2.2 Requirements
 ───────────────────────────────────────────────────────────────────────
 MTL requires:      - PC XT/AT/386
                    - At least 300K free memory
                    - DOS 3.xx (4.xx not tested)
                      (also tested under 4Dos);
                    - HDU optional
                    - MTA's original CTL-alike file
                    - MTA's logging files


 2.3 Usage
 ───────────────────────────────────────────────────────────────────────
 MTL comes as an add-on to MTA. MTA can create a log-file (look into the
 LogPath option in MTADOCEN.DOC) which contains all relevant information
 from previous runs. This log-file can, in time, get very large. MTL is
 written with two options in mind:

 1) MTL can compile the information in the MTA log-file into one screen
    of usefull information. This information will show the number of
    files converted up to now (splitting most of the popular archive
    extensions) and the total reduction (growth) as a result of this
    conversion;

 2) MTL can optionally strip redunant information from the log-file.
    When you choose to compress the log, MTL will read ALL log-file
    records and will create a new log-file, containing only a few
    lines (between 1 and 20 lines). All other information is removed.
    When you use a log-file that is accessed by other programs as well
    (mailer, BBS program and so on), you must take care of this infor-
    mation BEFORE you compress the log with MTL, otherwise all this
    information is gone. When you compress the MTA-log, MTL will also
    write a second log-file, containing the filenames of all files
    that have been compressed with MTA and that had a negative reduction
    (so they got bigger, not smaller). You can use this log to your own
    needs and throw it away (MTA.NEG) after you have (or not have) taken
    a look inside;

 MTL will also compress and clean the AV-log. This compress
 is ALWAYS done (so if you reply 'N' to the compress question in MTL,
 the AV-log will still be compressed). Compressing is done in one simple
 way. All records with the same AV-code AND same AV-names will be
 reduced to one record with the AV-code and the AV-name. After the com-
 press, all records will be in ascending order. MTA will append new
 records to this log, but with the next run of MTL, they will be sorted
 in place (or removed when they are duplicate).

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   3   │ Installation description                                    │
 └───────┴─────────────────────────────────────────────────────────────┘


 3.1 Installation
 ───────────────────────────────────────────────────────────────────────
 See the documentation for MTA (MTADOCEN.DOC).


 3.2 Remarks on archives
 ───────────────────────────────────────────────────────────────────────
 MTL does not use any archivers. It will only process the MTA-log file.


 3.3 MTA.CTL
 ───────────────────────────────────────────────────────────────────────
 MTL will use some  of the MTA options.  In general all special  options
 in MTA (exits,  CRC, Virus, includes  and so on)  are not used  but all
 logging option ARE used. MTL MUST find a file called MTA.CTL somewhere
 in the DOS-path (later versions will fix this limitation). When you use
 another name for the MTA.CTL alike file, you need to copy this file to
 MTA.CTL, somewhere in the DOS-path to make MTL work.

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   4   │ Runtime Information                                         │
 └───────┴─────────────────────────────────────────────────────────────┘

 4.1 Running MTL
 ───────────────────────────────────────────────────────────────────────
 The calling syntax of MTL is:

 MTL {/BATCH}

 /BATCH  : If this option  is  supplied, MTL will  run unattended (batch
           mode) and  no  questions  will  be asked. If the LOGTHRESHOLD
           option  in  MTA.CTL is set, MTL will cleanup the MTA-log when
           the total  size of the  log is greater than the value you did
           supply with this option, MTL will  compress the log. MTL will
           do give a warning  while  running  unattended but without the
           LOGTHRESHOLD option in MTA.CTL.

 In unattended mode (/BATCH), MTL will  make  no noice (beeps and bells)
 when registered.

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │   5   │ Version information and credits                             │
 └───────┴─────────────────────────────────────────────────────────────┘

 5.1 The BETA-team
 ───────────────────────────────────────────────────────────────────────
 See the file SUPPORT.MTA for a full list of beta-testers;


 5.2 Credits
 ───────────────────────────────────────────────────────────────────────
 See MTADOCEN.DOC


 5.3 Version history
 ───────────────────────────────────────────────────────────────────────
 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.05 │ Minor Release                                               │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Added options to compress the MTA.AVS log (AV-log) if it is set in
    the MTA.CTL alike file.

  ■ Fixed bug in the processing of the 'negative' log. The new log that
    contains the negative reduced files did not display the name of the
    file in question. This is fixed;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.06 │ Version Release                                             │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Only version number is changed;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.07 │ Version Release                                             │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Only version number is changed;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.08 │ Version Release                                             │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Only version number is changed;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.10 │ Version Release                                             │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Only version number is changed;

 ┌───────┬─────────────────────────────────────────────────────────────┐
 │ 15.20 │ Version Release                                             │
 └───────┴─────────────────────────────────────────────────────────────┘
  ■ Changed the reports. LZS is moved to the group 'OTHER' and  replaced
    by SQZ. The first compression of the LOG-file will add the remaining
    LZS files to the 'OTHER' group;

 ┌───────┬────────────────────────────┐
 │ 15.21 │ Bug release                │
 └───────┴────────────────────────────┘
  ■ Some  new  routines  caused a number of cosmetic bugs. These are now
    fixed (registered users!!!). Also registered users should unpack the
    supplied MTA__REG.EXE (which contains MTAREG.EXE and MTAREG.DOC) and
    run the MTAREG.EXE file once;

 ┌───────┬────────────────────────────┐
 │ 15.30 │ Major release              │
 └───────┴────────────────────────────┘
  ■ Added command-line parameter to run MTL in unattended mode while MTL
    is reducing the log-files (/BATCH);

  ■ MTL will detect the LOGTHRESHOLD option in MTA.CTL. If MTL is run in
    batch-mode, it will  only  reduce  the log-file if the total size of
    this file is larger than the value supplied with LOGTHRESHOLD;


 ┌───────┬────────────────────────────┐
 │ 15.35 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Nothing changed in this version of this program.


 ┌───────┬────────────────────────────┐
 │ 15.36 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Nothing changed in this version of this program.


 ┌───────┬────────────────────────────┐
 │ 15.40 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Nothing changed in this version of this program.


 ┌───────┬────────────────────────────┐
 │ 15.50 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Nothing changed in this version of this program.


 ┌───────┬────────────────────────────┐
 │ 15.55 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Replaced the DWC statistics with those for the UC2 compression;


 ┌───────┬────────────────────────────┐
 │ 15.57 │ Minor release              │
 └───────┴────────────────────────────┘
  ■ Changed some internal code to optimize performance;


 5.4 Copyrights, Trademarks
 ───────────────────────────────────────────────────────────────────────
 PKPAK, PKUNPAK, PKZIP and PKUNZIP are trademarks of PKWare Inc.
 SQZ           is a trademark of Jonas I Hammarberg.
 UC2           is a trademark of Ad Infinitum Programs (AIP-NL)
 PAK           is a trademark of NoGate Consulting.
 ARC           is a trademark of SEA inc.
 ZOO           is a trademark of R. Dhesi.
 DWC           is a trademark of Dean W. Cooper
 LZH and LHarc are trademarks of Yoshi;
 LZS and LARC  are trademarks of K.Miki H.Okumura and K.Masuyama
 ARJ           is a trademark of Robert K. Jung
 HYPER         is a trademark of Peter Sawatzki and Klaus Peter Nischke
 4Dos          is a trademark of Rex Conn and JP software

 MTL is written  in Borland Pascal 7.0, with help of the Turbo  Debugger
│3.0 and  makes extensive  use of  Object Professional  1.22 and OPCFI V
│20.03.    Some  routines   are  obtained   from  TurboPower's    Asynch
│Professional  2.00.

 Borland Pascal      is a trademark  of Borland International
 Turbo Debugger      is a trademark  of Borland International
 Object Professional is a trademark  of TurboPower Inc.
 Asynch Professional is a trademark  of TurboPower Inc.
 Pascal+             is a trademark  of StonyBrook software Inc.
 OPCFI               is a trademark  of Robert W. van Hoeven

 [======================== END OF DOCUMENT ============================]