home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
busi
/
areafon3.zip
/
AREAFON.DOC
< prev
next >
Wrap
Text File
|
1990-02-08
|
19KB
|
507 lines
AREAFON
Version 3.0
3/1/1990
Quick Reference Guide
Distributed by
Bulletronics
P.O. Box 49743
Atlanta, Ga. 30359
Bulletronics BBS
(404) 396-3630
24 Hour/7 Day Service
Copyright (c) 1989 by Lou Hlad
All Rights Reserved
TABLE OF CONTENTS
Introduction 1
License Agreement 2
Warranty 2
Shareware vs. Freeware 3
Getting Started 4
Technical Considerations 4
Using Main Selection Panel 5
Modifying the AREAFON.DAT Table 6
Appendix A:
Order Form 8
Appendix B:
Comments Form 9
AREAFON Version 3.0 Quick Reference Guide Page 1
INTRODUCTION
AREAFON is a fast table-lookup program which displays the areacodes, city
names, and country codes of the international dialing system. An optional
personal phone directory may be imbedded in the database as well. AREAFON
uses a common, popular user interface which resembles the Lotus Corporation
schema of their Lotus 1-2-3 package.
The actual tables are provided in the file AREAFON.DAT and may be updated
by the user as outlined in Appendix A. This is necessary as new codes are
defined by expanding phone availability. Additional city names may also be
inserted in the table as desired. This tabular construction makes AREAFON an
"open-ended" program which can't suffer the fate of becoming "out-of-date".
Files provided with AREAFON.ZIP for user testing include:
AREAFON.EXE - the executable program
AREAFON.DAT - the data table required
AREAFON.DOC - this documentation
AREAFON.EXE is FULLY functional. The data file AREAFON.DAT contains an
excellent sampling of over 750 lines of data. This table is nearly at the
maximum limit of 760 lines imposed by the compiler. Lines past 760
are simply ignored by the program. Since the foreign country code dialing
lines are at the rear of the file, you may use all 760 lines for U.S. data
if you wish. Only the foreign country code screen will be affected. Lines
which fall after the 760 limit are ignored by the program and need not be
removed.
Users may customize file AREAFON.DAT to their liking. Any lines may be
removed. Lines may be added (as long as they follow the prescribed format).
Future releases of this program will remove the line limitation. Only
registered users will have access to improved versions of AREAFON.EXE.
Registration of this program is $20.00. It entitles users to support from
the Bulletronics BBS at 404/396-3630. Improved versions may be downloaded
with special instructions given only to registered users. The authors will
consider customized versions of this software at a nominal price. Note that
the Registration Form is at the rear of this documentation.
This software was written in Borland's fine TURBO PASCAL 5.5 compiler.
AREAFON Version 3.0 Quick Reference Guide Page 2
License Agreement
-----------------
AREAFON is protected by United States Copyright Law and International
Treaty provisions. All rights are reserved. Non-registered users of
AREAFON are licensed only to use the program on a trial basis for the
sole purpose of determining whether or not it meets their requirements.
All other uses require registration.
Any other use of non-registered copies of AREAFON by any person,
business, corporation, government organization, or any other entity
is strictly forbidden and is a violation of this license agreement.
Registration permits a user a license to use AREAFON on a single computer.
All users are granted a limited license to copy AREAFON for the trial use
of others, with the following additional conditions:
AREAFON must be distributed in unmodified, complete form, including
this Quick Reference Guide and License Agreement.
AREAFON may not be distributed in conjunction with any other product
without the written permission of Bulletronics.
No fee, other than a bonafide disk duplicating fee not to exceed
$6.00, may be charged for AREAFON.
Warranty
--------
Bulletronics makes no warranty of any kind, express or implied, including
without limitation, any warranties of merchantability and/or fitness for
a particular purpose. Bulletronics will not be liable for any damages,
whether direct, indirect, special or consequential arising from a failure
of this program to operate in the manner desired by the user. Bulletronics
shall not be liable for any damage to data or property which may be caused
directly or indirectly by use of the program.
IN NO EVENT WILL BULLETRONICS BE LIABLE FOR ANY DAMAGES, INCLUDING ANY
LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES
ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM
BY AY OTHER PARTY.
The License Agreement and Warranty shall be construed, interpreted, and
governed by the laws of the state of Georgia.
AREAFON Version 3.0 Quick Reference Guide Page 3
Shareware Vs. Freeware
----------------------
Shareware is a type of software which is marketed on a "try before you
buy" concept. It is not meant to be "freeware". Many hundreds of hours
go into the development of these packages. If you find they meet your
needs, please register your copy and pay the modest fee. Please do not
make the mistake of illegally using unregistered packages for corporate
business purposes. This submits your company to legal ramifications.
Purchase orders are accepted for unlimited copy licenses only. Upon
payment, you will receive a letter confirming that you have been granted
an unlimited copy license.
Your contribution supports the creation of good, inexpensive software
created by independent people who enjoy bringing a good product to the
American public and earning their living this way. This is professional
software without the shrinkwrap.
If the package does not meet your needs, please erase it from your
computer. If the package "almost" meets your needs, please contact us
to discuss a modification. Modifications of the program as well as a
unique AREAFON.DAT table are possible.
AREAFON Version 3.0 Quick Reference Guide Page 4
Getting Started
---------------
AREAFON requires no setup. It only requires that the included data
file AREAFON.DAT be found by the executable module. Make sure that
either the two files are in the same directory or they are located
in the established path environment of the computer.
To execute AREAFON.EXE:
C:\> AREAFON (Yes, that's all folks!)
Note: If you put AREAFON.EXE and AREAFON.DAT in a directory
accessible via your PATH command, it can be executed
from any directory on that hard drive.
Technical Considerations
------------------------
AREAFON is written entirely in Borland's Turbo Pascal version 5.5.
Module AREAFON.EXE is the compiled version.
This program has been tested on CGA, EGA, VGA, and Hercules graphics
cards. It works equally well on all these types. Color is displayed
when supported by the card and monitor. AREAFON works on 8086, 80286,
80386, and 80486 computers as well.
The compiler indicates that the program requires about 16,000 bytes for
code area and 64,592 for data storage for a total of just over 80,000.
This version of the program is limited to 760 lines of data. Future versions
now being written will have no such limitations.
There is usually no need to modify AREAFON.DAT. However, from time to
time, new areacodes and countrycodes are announced. They can be
added to data file AREAFON.DAT using any ASCII text editor. If the user
wishes to imbed a personal phone directory within AREAFON.DAT, a format for
doing so is defined. A file record layout is detailed in a following section.
AREAFON Version 3.0 Quick Reference Guide Page 5
Using Main Selection Panel
--------------------------
The main selection panel is a "point and shoot" slidebar interface
which allows the user to select:
1). All the areacodes assigned in the world.
2). The city names included in the AREAFON.DAT table.
3). A user's personal phone directory in the AREAFON.DAT table.
4). The assigned country codes of all foreign countries.
Foreign city codes are also provided where required. To dial
these countries, one must dial "011" + Country Code +
City Code + local number.
5). The entire database file AREAFON.DAT. This allows text scans on
ANYTHING to verify the current contents of the file.
Text scanning is accomplished by selecting a screen display, then hitting the
F1 key to bring up the pop-up text scan window, and entering a string of
text for which to search. Upper/lower case is ignored in the search.
Depending upon the initial screen selected, the text search finds any
matching subset of that body of data. If you choose to view the entire
database (selection D of the menu), you can search for ANYTHING in file
AREAFON.DAT. If the matched records exceed one screen, the PgUp/PgDn keys
will show you the remaining data on successive screens.
AREAFON Version 3.0 Quick Reference Guide Page 6
Modifying the AREAFON.DAT Table
-------------------------------
The data table that this program references is completely contained in
module AREAFON.DAT and may be edited using any ASCII test editor. This
should not be necessary unless some previously-unassigned areacode becomes
assigned or some new foreign country code is defined. If this happens,
add the new data into the file using the following code conventions.
All the areacode records are at the front of AREAFON.DAT and are sorted
numerically by areacode. There are some city records inserted within their
respective areacode sections. Most of the major American cities have been
included in the database. Since there are thousands of cities and towns,
this table may never be "complete", but it very usable in its present form.
At the rear of AREAFON.DAT are all the foreign country code records. If you
have no interest in foreign dialing, you may delete all these records and
have more room for U.S. city name data. Up to 760 lines of data are now
supported under AREAFON 3.0. The next version will have unlimited table
capacity. Only registered users will have access to future unlimited
versions of AREAFON and the online BBS support.
If the user wishes to build a private phone directory within the file
AREAFON.DAT, this is allowable. A special "type 4" record is defined below
to appear when the "PhoneBook" selection is made from the main menu. These
lines also count toward the 760 line limit.
This program employs no record sorting of any kind to ensure immediate
response. If records are entered alphabetically in AREAFON.DAT, they will
appear alphabetically on the screen. Remember that the text search window
should be used to locate text of interest. This is usually only one or two
lines. This program is amazingly useful without any sorting since it zeroes
in so quickly on the desired information.
AREAFON Version 3.0 Quick Reference Guide Page 7
Here is a sample of some typical lines from AREAFON.DAT:
|--- column 4 has record type code
|
2011NJ Northern New Jersey <<<<< Areacodes at front (type 1 record).
2161OH Northeastern Ohio <
2162OH Cleveland < << City lines follow their parent
2162OH Youngstown < areacode lines. City name starts
9161CA Northeastern California < always in column 16. These need
9181OK Northeastern Oklahoma < type=2 in column 4 to identify
9191NC Eastern North Carolina < them as city name records.
9194NC 834-3333 Mom's House < << Private phone directory records
9194NC 732-1234 Sis's House (type 4).
-------------------------------------------------------------------------
2133YY Algeria <
6843YY American Samoa <<<<<< Country codes at rear. (Type 3 recs.)
333YY Andorra < The countries have a "YY" where the
333ZZ 628- All Points < state abbreviation would go and the
543YY Argentina < foreign cities have a "ZZ" to aid
543ZZ 1- Buenos Aires < the program in identifying them.
543ZZ 51- Cordoba <
Here are field definitions in the 32 character record above:
Cols
----
1-3 Areacode or Country Code
4 Type of Record (tells program on which screen to display)
0 = Unassigned Areacode Record
1 = Assigned North American Area Code Record
2 = City Name Record (Keep in alphabetical order under
the appropriate Area Code Record)
3 = Country Code Info Record (either country or foreign city)
4 = Private PhoneBook Directory Records for this user
5-6 State Abbreviation (Type 1 Record) (Type 2 Record) (Type 4 Record)
or
Country Abbreviation (Canada, Mexico, Puerto Rico -- CN, MX, PR)
or
"YY" W/ Country Name (Type 3 Record)
"ZZ" W/ Foreign City (Type 3 Record)
7-32 Text Field Any Text may appear in this field. City names are
placed in column 16 by convention for display uniformity.
On a private PhoneBook directory (type 4) record, put the
7-digit phone number starting in column 8 and the name
of the phoned party in column 17 for display uniformity.
ORDER FORM
==========
TO: FROM:
Bulletronics Name: __________________________________
P.O. BOX 49743
Atlanta, Ga. 30359 Company: __________________________________
404/396-3630 BBS Data Address: __________________________________
1200/2400 baud 24 Hrs. Address: __________________________________
City, State: ________________________ _________
Zip Code
Date: ________________ Phone Number: __________________________________
AREAFON -- Current Version 3.00
-------------------------------
One registration with Source Code and BBS Support....... $20 _________
-or-
2 to 4 computers .... at $15 each. # computers ___ x $15 _________
-or-
Unlimited Copy License.... $75. _________
Please add $5.00 for shipping/handling if software is
requested on diskette. It may be downloaded for free from
Bulletronics BBS with proper security clearance after
registration. _________
Georgia residents add 5% sales tax. _________
=============
Total Enclosed _________
Diskette Format (choose one) 5.25" Disk ____ 3.5" Disk ____
(Please add $5.00 to order cost if diskette is desired)
Bulletronics 1990
COMMENTS FORM
=============
Your comments about this software and documentation are welcome.
Please take the time to fill out this form or contact us through
our Bulletin Board at 404/396-3630.
Name: __________________________________ Title: _________________________
Company: __________________________________
Address: __________________________________
Address: __________________________________
City, State: ________________________ _________
Zip Code
Date: ________________ Phone Number: ___________________________________
AREAFON -- Version 3.00
------------------------
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
__________________________________________________________________________
Send this form to: Bulletronics
Post Office Box 49743
Atlanta, Ga. 30359