A S S E T (ver 2.0) for Unix 
============================

Asset is a Perl script that reads one or more files of mail messages
and  breaks-out individual messages based on subject and date
received.  Asset is invoked by: assetv2.pl [ file ... ]

The command line arguments are files that contain configuration
information in the form of Perl statements.  These statements can
assign values to the following user-settable variables:

	       $ASmailBox 		# source mail box 
               $ASdestDir  		# destination directory where mail 
					# messages will
			   		# be written
	       $ASlog			# name of log file 
               $ASsubjectPattern	# mail message subject pattern
               $ASdueYear 		# The following five variables
               $ASdueMonth 		# determine the due date of the message
               $ASdueDate  		# Note that month is numeric
               $ASdueHour  		# ie Jan=1 etc.
					# 
               $ASdueMin   		# 

Two further system-settable  variables are available for use in
configuration files.  They  MUST not appear as lvalues in a
configuration file. They are:

               $pwd # the full path name of the present working directory 
               $hme # the full path name of the home directory

In the event that Asset is invoked without command line arguments then
the following default values are used:

	Variable                       Default Value
        --------                       -------------
        @ASmailBox                     /usr/spool/mail/user login name
        $ASdestDir                     $pwd/"assetSourceDirectory"
        $ASlog                         $pwd/"assetLogFile"
        $ASsubjectPattern              "CSCI"
        $ASdueYear                     Month script executed  (Jan=1 etc)
        $ASdueMonth                    Month script executed  (Jan=1 etc)
        $ASdueDate                     Date script was executed
        $ASdueHour                     Hour script was executed (24 hour clock)
        $ASdueMin                      Minute script was executed

$ASmailBox is a mail box containing mail messages.  Asset processes
these mail messages as follows:  For each message, Asset determines (1)
the userid of the sender, (2) the subject of the message and, (3) the
arrival time and date of the message.  If a message predates the time
and date stored in the $ASdue variables, and if the pattern  in
$ASsubjectPattern matches the message's subjact then  the message is
stripped of its header information and stored in the $ASdestDir using
the sender's userid as the file name.  Note, only the user name is used
(all network information is removed). A log file is maintained in
$ASlog.

ASSUMPTIONS

Unix Platform
=============
Mail messages are generated/read by a Unix mail(x) utility.  
Message arrival-time and subject are extracted from mailx mail
headers (the h command). All messages are considered received
in the year in which the script executes. 
NOTE, asset does NOT distruct the $ASmailBox mailbox.