                            DCT AutoCity/RA v1.00
                         Released September 19, 1998

           Copyright (C) 1998 Dan Traczynski.  All rights reserved.


             Checks the telephone exchange of the user's phone  
              number and sets his or her location accordingly   


[ Contact Information ]

    E-mail              dant@sfu.ca (best method of contacting the author)
    Netmail             Dan Traczynski, 1:153/757
    FidoNet EchoMail    DCTPROD, RA_UTIL
    WWW                 http://www.sfu.ca/~dant/


[ Introduction ]

   This program provides to the SysOp an easy way to ensure that the user's
location field actually contains the user's city, and not something stupid
like "Hell" (how original) or some advertisement.  To do this, AutoCity looks
at the telephone exchange (the first 3 digits of the phone number) and based
on that, sets the user's location field.  AutoCity will also reformat
whatever the user entered as his phone number to a 999-999-9999 format.
AutoCity was designed to be used with Canadian and American phone numbers and
won't be of very much use elsewhere.


[ Program Execution ]

   In order for AutoCity to actually do anything useful, it will be necessary
to create a database of telephone exchanges and their corresponding cities.
This information should be available in the first few pages of your local
white pages telephone directory.  A sample database of the Greater Vancouver
area, located in BC, Canada, has been included.  To create and edit an
exchange database, run CONFIG.EXE and enter the area code you wish to
configure.  Everything within the configuration program is self-explanatory
and won't be discussed here.  Each area code will have its own file, named
AUTOCITY.<area code>, located in the AutoCity directory.

    Ŀ
     NOTE                                                              
                                                                       
     If you compile a database of exchanges for your area code, please 
     send it to me so that I can make it available for everyone.       
     That's all I ask in return for your use of this program.          
    

   AutoCity should be run during the new user procedure, ideally after the
user has completed the NEWUSER.Q-A questionnaire.  Note that RA will not
create an EXITINFO.BBS file until after the new user procedure has completed,
so the best place to run AutoCity is as an AutoExec item in the TOP menu (with
access set to new users only), right before it branches to the new user menu.

The following command-line parameters may be used.

  /Annn   Specifies the default area code.  If a user only enters the 7
          digits of his phone number, this default area code is added in
          to format the phone number properly.  If this is not specified, 604
          is used as the area code.

  /Pxxx   Specifies the path to the EXITINFO.BBS file if it is not in the
          current directory.  There really shouldn't be any reason to use
          this parameter, as the drop file will be in the current directory
          when RA shells out to run AutoCity.

  /N      Do not create a log file (AUTOCITY.LOG).

   Assuming AutoCity is located in C:\RA\DOORS\AUTOCITY\, the following
command-line could be used (with a default area code of 604):

   C:\RA\DOORS\AUTOCITY\AUTOCITY.EXE /A604


[ Legal Information ]

   DCT AutoCity/RA is copyright (C) 1998 by Dan Traczynski.  All rights
reserved.  I encourage you to distribute it, but DO NOT by any means alter
any of the files within the original archive.  DCT AutoCity/RA may not be
included on any CD-ROM collections.  The archive should be named DCTAC100.ZIP,
preferably kept in its ZIP format.

   The author, Daniel Traczynski, will take no responsibility to anything
that this program may or may not do to your system.  Although the program has
been tested thoroughly, no guarantee can be given that it will do what it was
made to do.  Nevertheless, if anything should happen, the user is totally
responsible and the author will be under no obligations whatsoever.  By using
this program you agree to this disclaimer.


[ Release Notes ]

  + Added a new feature/Something was improved.
  - Removed something.
  * General comment.
  > Bug fix.


 Version 1.00 -=- September 19, 1998.
   * Initial release.


[ End of File ]
