.-------------------------.
| Mystic BBS AreaFix Help |---------------------------------------------------
`-------------------------'

 What is AreaFix?
 ----------------

 AreaFix is a automated response system which provides echomail nodes the
 ability to "self-service" their configuration.  Generally speaking, you will
 use AreaFix to link and unlink echomail areas for export to you.

 AreaFix also provides additional utility functions such as changing password,
 archive type/raw PKT selection, and the ability to rescan one or more echo
 areas to send you the last X messages or all messages posted in the last X
 days.


 How to use AreaFix
 ------------------

 Simply address the message "To" field to "AreaFix" and then supply your
 AreaFix password on the subject line for authentication.

 Each line of the message content should consist of a single command which
 instructs AreaFix to do something.  Each command will be processed and a
 result of that command will be included within a return Netmail response
 message which is automatically generated by AreaFix after your request.


 AreaFix Commands
 ----------------

 %COMPRESS <type>       Sets the archive type used to bundle mail to <type>,
                        such as ZIP, RAR, etc.  The type can also be omitted
                        which tells AreaFix to send raw PKT files instead of
                        bundled mail.
 
 %HELP                  Return this help message

 %PWD <new password>    Changes your AreaFix password to <new password>

 %LIST                  List all available echomail areas from this uplink

 %LINKED                List all linked areas (areas being exported to you)

 %UNLINKED              List of all unlinked areas (areas not exported to you)

 %RESCAN [R=# or D=#]   Rescans all linked echomail areas and export the last
                        250 messages in each area, unless the optional R or D
                        command is also specified.  See below for more info on
                        R/D options.

 -ECHOTAG               Remove (unlink) ECHOTAG from your list of export areas

 +ECHOTAG [R=# or D=#]  Add (link) ECHOTAG to the list of export areas.  The
                        plus symbol can also be omitted here, meaing that if a
                        line contains ONLY an echotag, it is assumed that the
                        request is to link the area.

                        The optional R or D command can be included to instruct
                        AreaFix to also send the latest messages for the newly
                        linked area.  If no option is specified for rescan,
                        then AreaFix will only start sending new messages posted
                        after this command has been received.

                        See below for R and D options. 

 =ECHOTAG <R=# or D=#>  Rescan an existing linked message base.  This will send
                        the most recent 250 messages for ECHOTAG, unless the
                        R or D command is also specified to change this option.

 
 Changing Rescan Options
 -----------------------

 Several AreaFix commands support the optional R or D commands.  These commands
 must be separated from its associated command by a comma or a space and follow
 the format COMMAND=NUMBER.  For example:

    +ECHOTAG,R=100

 The R command instructs AreaFix to export the most recent number of messages
 specified by #.  In other words, R=100 will send you the most recent 100
 messages.

 The D command instructs AreaFix to export all messages posted with the last
 number of days, specified by #.  In other words, D=365 will send you all
 messages posted within the last 365 days (1 year).


 AreaFix Examples
 ----------------

 -> Example 1:
  
       Base: Netmail
       From: Me
         To: AreaFix
       Subj: MyPassword
       -------------------
       %COMPRESS ZIP 
       %PWD MyNewPassword
       +MYSTIC
       FIDONEWS
       WINDOWS D=90
       =BBS_CARNIVAL R=500
 
   The above example will change your archive type to ZIP, change your AreaFix
   password to MyNewPassword, request that the MYSTIC and FIDONEWS echoareas
   are added to your list of exported areas.  It then requests that the
   WINDOWS area is added to the exported list, but it also asks to send all
   messages posted with the last 90 days.  Finally, it asks that the most
   recent 500 messages are sent for the already connected BBS_CARNIVAL area

 -> Example 2:

       Base: Netmail
       From: Me
         To: AreaFix
       Subj: MyPassword
       -------------------
       %LINKED
       %UNLINKED
       %RESCAN D=180

    The above example will list all areas you have linked to for export, and
    all available areas to have NOT linked to for export.  Then it will ask
    AreaFix to bundle up all messages posted to all of your linked areas
    within the last 180 days (~6 months).


 AreaFix Results
 ---------------

 AreaFix will respond to all requests made, even if a blank message is sent or
 a message is sent with a wrong password.  A typical automated response from
 AreaFix might look like this:

    Base: Netmail
    From: AreaFix
      To: Me
    Subj: MyPassword
    -------------------
    Your AREAFIX request has been processed.

    Command: +MYSTIC
     Result: MYSTIC has been linked for export 

    Command: %LINKED
     Result: List of all linked echomail areas:

                MYSTIC
                FIDONEWS

    Command: %COMPRESS ASDF
     Result: Unknown archive type.

 If you do not receive a response, then you have not been configured as a
 downlink yet, or some other error has occured.

-------------------------------------------------------------------------------