=============
AutoReader NT
=============

Copyright 2001-2004 DuoData Software by Arno Garrels.


Latest Changes
==============

07/30/2005 V.1.1.0

  Data Execution Prevention (DEP) compatibility added.
  

05/07/2004 V.1.0.9

    VERY IMPORTANT NOTE
    -------------------    
    If you install on top of a previous version you
    *MUST* STOP AND UNINSTALL the AutoReader service first.
        
    New option TryToRemainOrgFileNames.If enabled AutoReader
    tries to remain the original file names of attachments.
    Forbidden characters ['\','/',':','*','?','"','<','>','|']
    are replaced by '_'. If the file already exists inside the
    attachment folder it will be renamed to filename[n].ext.
    
04/02/2004 V.1.0.8 (Beta)

    Messages could get lost if the service was stopped while mail
    was still being processed. If e-mail has been downloaded and
    deleted on the server successfully, however the mail couldn't
    be decoded completely due to any interuption AutoReader will
    decode it at the end of the next Poll interval. 
    New option ShutdownTimeoutSec indicates the period in seconds
    the service will wait for currently running loop to be
    finished if the *user* stops the service.
    New option DenyUserShutdownWhileActive can be enabled to
    prevent the *user* from stopping the service while still not
    in idle state. Note that the Service Control Panel will show
    up an error message on the attempt to stop the service if
    this option is enabled, just ignore it, it's not a bug.
    New option DoBeep, beeps once a loop is going to start and
    twice when reaching idle state again.       


11/07/2003 V.1.0.7
 
    Any message part that has either property 'name' or
    property 'filename' set in its part header is classified as
    an attachment now.
    
    Also two new setup options/INI fields added:
    
    "DefaultExtension" File extension without dot. If not blank
    and if the attachment file name does not include a file
    extension the value is appended to the attachment file name.
                                                
    "ConstAttFileName" If not blank attachments are stored under
    this file name in the attachment folder. In case of a file
    with the same name exists it is NOT overwritten. The new
    file would be renamed to xx[n].ext instead.
    If the ConstAttFileName value includes no file extension the
    extension of the attachment is appended.  


08/27/2003 V.1.0.6

    Wildcard support in INI field Subject added. 


07/22/2003 V.1.0.5

    Original file extensions couldn't be determined in case of
    "filename" property of the attachment-part-header was missing.


07/19/2003 V.1.0.4

    Now allows you to install multiple instances of the service.


04/15/2003 V.1.0.3

    When email had 1 attachment and no other content the
    attachment wasn't decoded, fixed.


04/09/2003 V.1.0.2

    Timeout problem fixed when the Pop3 server didn't response to
    AutoReaders's Quit command.


11/12/2001 V.1.0.1

    Option DeleteMailOnServer added.   


INSTALLATION
============

1. Uninstall all previous versions

2. Unzip the ZIP package to any directory on your harddrive.

3. Run ardntsetup.exe

4. Copy either your trial or registration certificate file
   "CERT.DAT" to the AutoReader program folder.




CONFIGURE INI-FILE (autoreadernt.ini)
=====================================


[SETUP]

HostAddr=192.168.1.2 
 IP or DNS name

HostPort=110
 Default port=110

User=Username
 POP3 user or account

Pass=Password
 Password/APOP secrect


APop=NO  
 APOP authentication
 
PollSec=30
 Timer, period in seconds to poll

DenyUserShutdownWhileActive=NO 
 Can be enabled to deny a service
 stop while still processing mail when the *user* stops the
 service. Note that the Service Control Panel will show up an
 error message on the attempt to stop the service if AutoReader
 denies to be stopped, just ignore it, it's not a bug.  

ShutdownTimeoutSec=60 
 Indicates the period in seconds the service will wait for
 current running loop to be finished when the *user* stopped the
 service.

DoBeep=NO
 Beeps once the timer is going to start a new loop and twice on
 reaching idle state again.

Subject=hallo
 If not blank only attachments and messages of mails with a
 matching subject text will be extracted, wildcards are allowed.

MailFileExtension=txt
 Define a file extension for downloaded e-mail files,
 length must be 3 chars long

DeleteMailOnServer=YES 
 Delete or keep mail after a successfull transfer.
 Note!!: AutoReaderNT will download old e-mails again if this
 option is disabled.

DefaultExtension=att 
 File extension without dot. If not blank and if the attachment
 file name does not include a file extension the value is
 appended to the attachment file name.
                         
ConstAttFileName=myattach.txt
 If not blank attachments are stored under this file name in the
 attachment folder. In case of a file with the same name exists
 it is NOT overwritten. The new file would be renamed to
 xx[n].ext instead. If the ConstAttFileName value includes no
 file extension the extension of the attachment is appended.

TryToRemainOrgFileNames=NO
 If enabled AutoReader tries to remain the original file names of
 attachments.
 Forbidden characters ['\','/',':','*','?','"','<','>','|'] are
 replaced by '_'. If the file already exists in the attachment
 folder it will be renamed to filename[n].ext. 

SysLog=YES
 Enables logging of POP3 and program messages

MailLog=YES 
 Enables logging of mails fetched from the server

DirLog=C:\ard\log\
 Logfile directory

DirBody=C:\ard\body\
 Where extracted message text is stored

DirAttach=C:\ard\attach\
 Where extracted attachments are stored

DirMail=C:\ard\Mail\ 
 Where fetched e-mails are stored
       


INSTALLING/UNINSTALLING THE SERVICE
===================================

At the command prompt, change to the AutoReader NT program
 directory and type:

(* Install the service with default service name 'AutoReader NT'
 in startup mode 'manually' *) 

 autoreadernt.exe /Install

(* Install the service with a customized name in startup mode
 'manually' *)

 autoreadernt.exe /Install /ServiceName
 (i.e. autoreadernt.exe /Install /"My AutoReader Service")

(* Remove the service with default service name 'AutoReader NT' *)

 autoreadernt.exe /Uninstall

(* Remove the service with a customized service name *)

 autoreadernt.exe /Uninstall /ServiceName
 (i.e. autoreadernt.exe /Uninstall /"My AutoReader Service")

Note that if a service name contains spaces you would have to
enclose it in double quotes ("My Service").
The service name is displayed in the Service Control Panel.


MULTIPLE SERVICES
=================

If you want to install multiple service instances following 
restrictions apply:
Each instance requires a full installation to a different
directory. Each instance has to be installed under a different,
unique Service Name. Each instance must use its own INI file and
log folder as well.


CONFIGURE SERVICE PROPERTIES
============================

Go to the Service Control Panel and set Start-Up mode to 'Auto'
if the service must start on system boot. *Note* that if you plan
to access network files the service must be executed in an
appropriate user account, by default AutoReader NT starts as the
Local System Account that does not have the neccessary rights to
access network resources.
 

START THE SERVICE
=================

(* Starts the service with specified ServiceName *)
 
 net start /ServiceName
 (i.e. net start "AutoReader NT")

STOP THE SERVICE
================

(* Stops the service with specified ServiceName *)
 
 net stop  /ServiceName
 (i.e. net stop "AutoReader NT")  

(Or control the service from the Windows Service Control Panel
/Applet)


Note:
There is a bug in W2K's Service Controller.
If you uninstall a service while the Service Control Panel is
running the service might be displayed as "Marked for Deletion"
indicating that the service database is locked. Reinstall of a
service in such a case will fail. Therefore just close the
Service Control Panel/Applet and install the service again. 


Default Naming Conventions
==========================

yy    : year
mm    : month
dd    : day
ext   : attachment's original file extension

n1    : e-mail index (increment of 1)
n2    : message index (increment of 1)
n3    : attachment index (increment of 1)

E-Mails                  : yymmdd_n1.txt
Extracted messages	 : yymmdd_n1_n2.txt
Extracted attachments    : yymmdd_n1_n3.ext


Note:
If you want do delete old mails, attachments or messages you
would have to delete yesterday's or earlier files only.

If you delete only some of today's files, file names would not be
generated with a correctly incremented index "n".