                MAILINFO  version 1.4
                (C) P.Pollet  July 1994
                Distributed as "CardWare" (1)


------------------------------------------------------------------------
INTRODUCTION
------------------------------------------------------------------------
	This program was made to help a supervisor to get some statitistics
about unread mail on a Novell server running Pegasus mail and/or Mercury.

	It does it by scanning the bindery for users specified on the command line ( and that
are members of a specified group ).It creates a sorted collection of these users and for
each of them it scans its mail directory ( normally SYS:MAIL\USER_ID) for
any file with the CNM extension.
	It then produces a report with
the user's login, fullname ,  ID and the number of unread mails and their size on screen
or in a TAB separated file that could be further processed using any spreadsheet program.

	Options to  list or to delete aged mail ( received prior a specified date)  have been added .
Note that the date of the unread mail is taken from the MsDos file's date and time and not from
peeking inside the message text.

	It is not as powerfull as the Jon Glaser's MailWatch program, but it is free... (1)

------------------------------------------------------------------------
HISTORY
------------------------------------------------------------------------
v 1.0 	original programming (07/07/94)
v 1.1	added the aged mail option ( parameter A with a date ) (17/07/94)
v 1.2 	added -the user's full name in the output file (21/07/94)
	added option D to delete aged mail
v 1.3   if a user's maildir do not exist or no rigths to go into
        simply skip that user rather than aborting (22/07/94)
v 1.4   added -R switch to restrict output to users that have at least
        one unread mail.(20/08/94)
        reduced output to 80 columns wide onscreen
----------------------------------------------------------------------
USAGE
-----------------------------------------------------------------------

  MAILINFO [-U=username] [-G=GroupName] [-O=outputfile] [-M=MailDir]
	 	[-A=Date]|[-D=Date][-R]

or MAILINFO -H  or -? to get an help screen

  -U Users to check unread mail .Wildcard * is allowed (default=all users)
  -G Restrict to Members of this group (default=EVERYONE)
  -O Output file (default=screen)
  -A Display only unread mails dated before dd/mm/yy
  -D Display and Delete unread mails dated before dd/mm/yy
       -A and -D parameters are uncompatible 
       The current date format and date separator is retrieved from MsDos 
        (Get Specific Country Info Interrupt ) 
       and can be dd.mm.yy for France
                  dd/mm/yy for Europe
                  mm/dd/yy for USA
                  yy/mm/dd for Japan
  -M Netware Mail directory (default=SYS:MAIL)
  -R Output only users with non zero matching mails 
---------------------------------------------------------------------------------
EXAMPLES 
---------------------------------------------------------------------------------

MAILINFO
	gives on screen a complete report of unread mail for all users of the
	current server

MAILINFO -g=MAILUSERS 
	only for users belonging to group MAILUSERS

MAILINFO -u=PPOLLET  -a=31.12.93
	reports on user PPOLLET, for mails received prior or on the last day of 1993.
	The format dd.mm.yy is the usual format on a french MsDos

MAILINFO -u=P* -G=MAILUSERS -D=31.12.93 -o=KILLP.RPT
	Reports AND Delete unread aged mails for all users belonging to group MAILUSERS 
	and whose login names begin by a 'P'  The report will be placed in the file KILLP.RPT

MAILINFO -D=30.04.94 -o=K300494.RPT
	Delete all unread mails received prior the 1th of May 1994 and give a report in the K300494.RPT

----------------------------------------------------------------------
ACKNOWLEDGMENTS
----------------------------------------------------------------------
 Of course all the praise should go to David Harris for excellent
 products (Pegasus Mail and Mercury) and remarkable user support.

This program was written in TurboPascal 7.0 with a Novell APi unit from Mark Bramwell
 ( mark@hamster.business.uwo.ca)
----------------------------------------------------------------------


---------------------------------------------------------------------
SUPPORT
--------------------------------------------------------------------
 This is available to you folks free of charge, and free of support.
 It did work on my place; I hope it will in yours... ;-)
If time permits , I am planning to improve it to a fully functionnal
mail watcher program with a nice user interface (TurboVision ?)....

Any questions could be directed to:

ppollet@cismibm.univ-lyon1.fr
patrick.pollet@cipcinsa.insa-lyon.fr
--------------------------------------------------------
Dr Patrick L.Pollet
INSA Centre Informatique du 1er Cycle  Bat 110
20 Avenue A.Einstein  69621 Villeurbanne Cedex France

---------------------------------------------------------------------
LIABILITIES
---------------------------------------------------------------------
$include i.am.responsible.of.nothing.txt
---------------------------------------------------------------------

(1) "Cardware" is a form a software distribution especially
     devised for my kids that collect postcards. If you find
      that program useful and used it, just send me a post card...
