<olio@informatik.uni-bremen.de>, Ulrich Sibiller <uli@pizza.tynet.sub.org>, Olaf Peters <olf@informatik.uni-bremen.de>
Uploader: Olaf Peters <olf@informatik.uni-bremen.de>
Replaces: comm/ums/SUMSTools.lha
Version:  2.13 (9.1.97)
Requires: OS 2.x, UMS v10+
Copyright: Public Domain

Revision History
****************

   v2.13 (09-Jan-97) [olf]

     - added support for all missing server tags (UMSTAG_FileName etc.) to
         the filter, SUMSPrint and SUMSWrite. [olf]
     - docs: updated sections Filtering, SUMSPrint and SUMSWrite to now
         reflect all possible keywords. Also updated the flag-stuff in
         SUMSPrint to reflect the Parked and HasFile flag.
     - forgot to update the version in v2.12 [olf]

   v2.12 (20-Dec-96) [olf]

     - umsfilter: added support for HasFile-Flag [olf]
     - converted documentation to TexInfo resulting in up-to-date docs in
         AmigaGuide format.
     - all: compiled with SAS/C 6.57

   v2.11 (03-Aug-95) [kmel]

     - sumsexport.c: added [kmel]
     - new directory structure [kmel]
     - all: change CLI template to stop the problems with USER/A or
            NAME/A [kmel]
     - umsfilter: ID_LENGTH, added new filter: TextLength, HeaderLength [SS]
     - all, sumstl.h: VERSION has information about the compiler [kmel]
     - all: Compiled with SASC 6.51, if compiling with Dice some
            expressions produce an error [kmel]

   v2.10 (05-Mar-95) [zza]

     - sumsdel.c: added
     - sumsset.c: warns if Deleted bit is set
     - sumstl.h: VERSION introduced for same version in all files
     - sumsprint.c: fixed access of arguments via argv
                    checking for CTRL-C in PrintMessage, too

Overview
********

   What are SUMSTools?

   'sumstl' or 'SUMSTools' stands for "Stuntzi's UMS Tools" and is a
collection of six useful tools for the UMS message base system:

SUMSPrint
     extract certain messages from message base to a file.

SUMSWrite
     create new messages.

SUMSSet
     set certain bits on certain messages.

SUMSFolder
     set folder on certain messages.

SUMSDel
     deletes certain messages

SUMSExport
     exports certain messages in a UMS-specific format

   With the aid of these six tools, you can perform lots of actions,
such as automatic message archiving, automatic generation of return
receipts, automatic message forwarding, areafix support, user filter,
etc.

   You could e.g. select all messages about "MUI", extract them from the
message base with SUMSPrint and forward them to a special MUI-Area with
SUMSWrite.

   Or you could select all messages from user "Martin Horneffer" and
route them via SUMSPrint to a printer. Thus, you will have all his
mumbling on a sheet of paper and can easily create some nice paper
planes. :-)

   If you are a node that offers some kind of areafix, SUMSPrint could
extract all messages to user "Areafix" for further parsing with an
areafix tool.

   Do you need some kind of expire? Just select all messages in
'fidonet.Amiga.ger' that are older than 30 days and set the Expire-Bit
with SUMSSet.

   There are simply no limits!

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 9949   17212  57.8% -lh5- 7428 Jan  9  1997 UMS/Bin/sumsdel
[generic]                10020   17288  58.0% -lh5- 0f66 Jan  9  1997 UMS/Bin/sumsexport
[generic]                10570   18640  56.7% -lh5- c6a4 Jan  9  1997 UMS/Bin/sumsfolder
[generic]                13659   23760  57.5% -lh5- fa9a Jan  9  1997 UMS/Bin/sumsprint
[generic]                10762   18944  56.8% -lh5- 3c71 Jan  9  1997 UMS/Bin/sumsset
[generic]                 8119   13156  61.7% -lh5- 79a5 Jan  9  1997 UMS/Bin/sumswrite
[generic]                10778   32460  33.2% -lh5- 8593 Jan  9  1997 UMS/Doc/English/SUMSTools.guide
[generic]                  201     474  42.4% -lh5- c817 Aug  3  1995 UMS/Tools/SUMSTools/mfm/sumsprint1.mfm
[generic]                  104     114  91.2% -lh5- feff Aug  3  1995 UMS/Tools/SUMSTools/mfm/sumsprint2.mfm
[generic]                   95     206  46.1% -lh5- ca5d Aug  3  1995 UMS/Tools/SUMSTools/mfm/sumsprint3.mfm
[generic]                  154     348  44.3% -lh5- b626 Aug  3  1995 UMS/Tools/SUMSTools/mfm/sumsprint4.mfm
[generic]                 1378    4425  31.1% -lh5- 0cdc Aug  3  1995 UMS/Tools/SUMSTools/Source/date.c
[generic]                   60      60 100.0% -lh0- 9354 Aug  3  1995 UMS/Tools/SUMSTools/Source/date.h
[generic]                  687    2226  30.9% -lh5- a465 Aug  3  1995 UMS/Tools/SUMSTools/Source/DMakefile
[generic]                 2570    8887  28.9% -lh5- d9ca Aug  3  1995 UMS/Tools/SUMSTools/Source/filter.c
[generic]                  518    1065  48.6% -lh5- 22c3 Aug  3  1995 UMS/Tools/SUMSTools/Source/filter.h
[generic]                  462    1508  30.6% -lh5- 2c7b Jan  9  1997 UMS/Tools/SUMSTools/Source/SMakefile
[generic]                 1352    3049  44.3% -lh5- d574 Aug  3  1995 UMS/Tools/SUMSTools/Source/sumsdel.c
[generic]                 1769    4432  39.9% -lh5- 269e Aug  3  1995 UMS/Tools/SUMSTools/Source/sumsexport.c
[generic]                 2095    6991  30.0% -lh5- d056 Aug  3  1995 UMS/Tools/SUMSTools/Source/sumsfolder.c
[generic]                 4605   23188  19.9% -lh5- d7b8 Jan  9  1997 UMS/Tools/SUMSTools/Source/sumsprint.c
[generic]                 2118    6570  32.2% -lh5- 255e Aug  3  1995 UMS/Tools/SUMSTools/Source/sumsset.c
[generic]                 9390   25260  37.2% -lh5- 3e29 Aug  3  1995 UMS/Tools/SUMSTools/Source/sumstl.doc
[generic]                  309     730  42.3% -lh5- d921 Jan  9  1997 UMS/Tools/SUMSTools/Source/sumstl.h
[generic]                10908   32150  33.9% -lh5- bb97 Jan  9  1997 UMS/Tools/SUMSTools/Source/sumstl.texi
[generic]                 2473   10798  22.9% -lh5- 25d0 Jan  9  1997 UMS/Tools/SUMSTools/Source/sumswrite.c
[generic]                 3061   24017  12.7% -lh5- 2b55 Jan  9  1997 UMS/Tools/SUMSTools/Source/umsfilter.c
[generic]                   78      88  88.6% -lh5- 2dac Aug  3  1995 UMS/Tools/SUMSTools/Source/umsfilter.h
[generic]                 1589    3390  46.9% -lh5- d858 Jan 13  1997 UMS/Tools/SUMSTools/sumstl.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        29 files  119833  301436  39.8%            Jan 13  1997