                                                             updated 02APR95 
                                 CLEANLOG
                                 --------
CLEANLOG is an utility especially written for JNOS users.
It's purpose is to 'clean' the logdir. 'Cleaning' means:
If you have more then 'keep+1' logfiles in the logdir, the 
additional files are written to a 'common_file' and this 
'common_file' is truncated to a lenght of 'max_length' bytes.
The logfiles are sorted in historical order (latest file first).
All parameters are programmable. 

Installing and using cleanlog
------------------------------
copy the executable to the logdir. Change to this dir and 
invoke CLEANLOG:

CLEANLOG.EXE [keep [common_file [max_lenght]]

None of the paramaters is mandatory.

keep:         is the number of files remaining in the dir (not moved
              to the common file). Default is 7
common_file:  full qualified filename. Default is 'jnos.log'
max_lenght:   the common file is truncated to this value.
              Default is 0 (no limit.)

Cleanlog adds an unique header, similar to the 'rnews' header
to each logfile. The characters '!#' are preceeded by a number
which is a pointer to the beginning of the next logfile (header
included in length calculation). The headerline contains
additionally the name of the logfile (ddmmmyy), right-justified
written to the headerline. The length of the headerline is
18+2 bytes. 

This simplifies browsing from day to day through the common_file
with a simple viewer and allows to extract the original logfiles
from the common_file with a simple program (which someone
other may write ;-)

Example JNOS Batch File
-----------------------
'RDATE.SRC' batch is called twice a day at 6:00 am and 6:00 pm.
The first command starts the expiry mechanism for my newsgroups.
The shell commands are used to start cleanlog. It's important
to change the dir's with a shell commands, _not_ with jnos commands!
I keep the last 8 days in my log dir and put the other files to 
logall.txt.

The next lines call the different newsfeeds. The first one
(inorganic5) allows uploading of new news back to the newsfeed
with IHAVE, the other severs are Read Only.

Note the "+" charcter at the end of the commandline. This
reloads the at-command after the batch file is executed.
========
JNOS.NOS
========
.......
at 0600 "source rdate.src +"
at 1800 "source rdate.src +"
.......

=========
RDATE.SRC
=========
expire now
! /c cd \nos\logs
! /c cleanlog.exe 7 logall.txt
! /c cd \nos
nntp ihave 1
nntp kick inorganic5.chem.ufl.edu
nntp ihave 0
nntp kick news.rz.uni-karlsruhe.de
at now+0010 "rdate server 129.13.64.5"


Limitations
-----------
CLEANLOG can not handle more than 31 daily logfiles at once.
Remeber this, if you start CLEANLOG for the first time!

Have fun!
---------------------------------------------------------------
(c) by khweis@mvmpc9.ciw.uni-karlsruhe.de              05NOV94
                                              updated  02APR95

