  / | _ | \______________
 /         \             \                                            
(   o   o   )         /   |
 \  _| |_  /        _(__   \______                                
 =(_/v\_)=__)_____(______\_______)Ŀ
 SETAR102 - ProBoard 2.1x PEX  Version 1.02       (C)1996 Fe-line Software 
 Written by Faye Pearson, Docs by Sarah Pearson        (19th January 1996) 


This is a ProBoard 2.1x only PEX.  SETAR102 will allow the User or Sysop to
select which message boards they would like to scan for their Personal Mail
Scan and/or the QWK download boards quickly, turn OFF and ON all areas and
also define forced areas.

ProBoard has an annoying way of setting all Areas to be scanned for New Mail
when a New User is created.  This means scanning the whole message base for
a Users New Personal Mail even though that User cannot have mail waiting for
them.  (Some PEXs like our AUTOPOST PEX can send mail to a User before their
first mail check so you should force the area which that PEX writes it's
message into to ON; at least for the New User security level).

This PEX is designed to achieve the speed and ease of use that so many
ProBoard sysops want.  We would like to hear any thoughts you have on this
PEX so we can update it to suit your needs better.

Control with SETAREA is best achieved with ANSI/AVATAR and cursor key control
(remote user) although numeric area key input is also possible.

There is a maximum of a 1000 areas.  1-1000.   This is a limitation within
the current ProBoard BBS program and we will increase this limit as and when
Philippe changes ProBoard.

There is an optional PEX included within the SETAREA archive.  AUTOADD will
ask the User if they would like to include the currently selected message
area into their Personal Mail Scan if the area is not currently in their
Personal Mail scan.  (See AUTOADD.TXT for more details).

SETAREA and AUTOADD both use support the Fe-line Software DOING PEX.

-----------------------------------------------------------------------------
                                INSTALLATION
-----------------------------------------------------------------------------

Copy SETAREA.PEX and SETAREA.INI to your ProBoard PEX directory.  You may
rename the PEX and the .INI file as long as the name of the PEX is the same
as the .INI. (See SETAREA.INI)
(You may put SETAREA into a subdirectory off your PEX directory if you wish)

SETAREA [/M]            Run SETAREA in the Interactive Mode
SETAREA ON [/M]         Run SETAREA to turn ON all areas
SETAREA OFF [/M]        Run SETAREA to turn OFF all areas
SETAREA FORCE [/M]      Run SETAREA to turn on all FORCED areas

/M                      This is an optional parameter that will make SETAREA
                        operate on the New Mail Scan areas.
                        (By default SETAREA will operate on Combined/QWK
                        areas)

Examples:

1)      Turn off Combined/QWK areas except those Forced.

        SETAREA OFF

        (Note: There is no on-screen confirmation of this option)

2)      Allow User to select their Combined/QWK areas.

        SETAREA

3)      Turn on New Mail Scan areas except those Forced.

        SETAREA ON /M

        (Note: There is no on-screen confirmation of this option)

4)      Allow User to select their New Mail Scan areas.

        SETAREA /M
                  
You should be able to get the idea of how SETAREA works from the above 4
examples.

                           ---------- HINTS ---------

SETAREA can be run from either the TOP menu or from a Menu Option.  You may
want to run SETAREA automatically for New Users, in which case the TOP Menu
is the best choice.

TOP Menu example for running SETAREA for New Users.
All new Users on our BBS have security level 10 before upgrading, so we have
set the Max.Level to 15, thus ensuring SETAREA will not run for other users
and we wish to turn off ALL areas except those forced.

From this example you can see how to amend the TOP Menu function for a Menu
Option.

[ TOP ]ͻ
 0        1         2         3         4         5         6         7     
 12345678901234567890123456789012345678901234567890123456789012345678901234 
 ;                                                                          
                                                                            
 Color    : White on Black             Example Text                         
                                                                            
 HotKey   : <CTRL-A>                                                        
 Function : 60 - Run ProBoard PEX File                                      
 Data     : SETAREA OFF /M                                                  
                                                                            
 Min.Level: 0                               Nodes: All nodes                
 Max.Level: 15                                                              
 Flags    : --------------------------------                                
 Min. Age : 0                   Password required: No                       
 Max. Age : 0                            Password:                          
 Sex      : Don't Care                                                      
 Time Left: 0                          RIPĿ                
 Time Onl.: 0                           Show remote : No                  
 Timeframe: Fully enabled               Show local  : Yes                 
 Min.Speed: 0                           Reset screen: Yes                 
 Max.Speed: 0                                          
                                                                            
ͼ

There is no on-screen confirmation that this function has taken place.  A log
entry is made for the current node to show that this function has taken place.

We want to define a Menu option to allow the User to select the areas they
want to scan for New Personal Mail.

[ MESS ]ͻ
 0        1         2         3         4         5         6         7     
 12345678901234567890123456789012345678901234567890123456789012345678901234 
 ;                                                                          
                                                                            
 Color    : White on Black             Example Text                         
                                                                            
 HotKey   : M                                                               
 Function : 60 - Run ProBoard PEX File                                      
 Data     : SETAREA /M                                                      
                                                                            
 Min.Level: 0                               Nodes: All nodes                
 Max.Level: 0                                                               
 Flags    : --------------------------------                                
 Min. Age : 0                   Password required: No                       
 Max. Age : 0                            Password:                          
 Sex      : Don't Care                                                      
 Time Left: 0                          RIPĿ                
 Time Onl.: 0                           Show remote : No                  
 Timeframe: Fully enabled               Show local  : Yes                 
 Min.Speed: 0                           Reset screen: Yes                 
 Max.Speed: 0                                          
                                                                            
ͼ

When the User selects Menu option "M", SETAREA is run, the screen should look
something like:

Ŀ
 Select Areas To Check for New Mail  v1.03         (C)1996 Fe-line Software 

   1  (Fe-line) To/From Sarah & Faye     25  (TrekNet) The Bridge
   2  (Fe-line) Private Mail             26  (TrekNet) The Next Generation
   3  (Fe-line) Sysop Messages to ALL    27  (TrekNet) Voyager
   4  (Fe-line) General Chat             28  (TrekNet) Quantum Leap
   5  (Fe-line) I Love Fe-line PEXs      29  (TrekNet) Red Dwarf
   6   (Fe-line) So do I                  35  (Fido) ProBoard Beta Echo
   7  (Fe-line) Yes, me too!             36  (Fido) Proboard Support
   8   (Fe-line) and don't forget me!     37  (Fido) FrontDoor Mailer UK
   9  (Fe-line) We won't                 38  (Fido) Comms UK
  10  (Fe-line) Ok, thanks!              39  (Fido) Modem
  11   (Fe-line) They have some strange   40  (Fido) Fast Echo
  12  (Fe-line) areas on here :-)        41  (Fido) Bluewave
  15  Recovery area Netmail              42  (Fido) New Sysops
  16   Netmail                            43  (Fido) BBS News
  17   Duplicate Messages                 44  (Fido) Hard Drive Help
  18  BadMail                            45  (Fido) Psion
  20  (DqP) Internal Beta                46  (Fido) Red Dwarf
  21   (DqP) International Support        47  (Fido) Windows Discussion
  22   (Dqp) UK Only Chat                 48  (Fido) Windows UK Discussion
  - Area Selected  ! - Area Forced on 
Cursor Up/Dn, [AreaNum], Space - Toggle Check, Esc - Exit, Enter - Next Page

SETAREA looks the same in both ANSI and ASCII, but ASCII is obviously mono.

[AreaNum] will change to the currently selected board only when the User
enters a number.

Use Cursor up and down to select the required area.  Press <SPACE> to toggle
the currently highlighted area.  If the user cannot use Cursor up or down
then they can just enter the number; but this is a slow and cumbersome way.

Once you press space, the cursor bar will move down to the next Message
Area if you have selected to use Cursor Keys.

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

SETAREA is FreeWare.  This means that we require *no* registration fee for
you to use this PEX for as long as you wish.  We would like to hear from you
if you do decide to use this PEX. :-)

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

This PEX is supplied "as is" and we will not be held responsible for any
damage caused by this PEX.  It works on our BBS ok, so that is the only
guarantee given :-)


Sarah & Faye Pearson, (c)1996 Fe-line Software

Fe-line BBS -- The Home of Fe-line PEXS and Windows Software
Official Registration & Support Site for ProBoard in the UK
ProBoard Beta Team
PSN-Net Regional Co-ordinators for the UK

-----------------------------------------------------------------------------
               We can be reached on the following Node Numbers.
          (2:257/278 Fido / 311:2100/100 PSN / 173:902/301 DqP-Net)
                    sysops@fe-line.demon.co.uk / Internet
-----------------------------------------------------------------------------
