THE AVIAN RECORD SYSTEM
v1.2
6/24/89



copyright(c) 1989
BAIRD SOFTWARE DESIGNS



-----------------------------------------------------------------------
TABLE OF CONTENTS
-----------------------------------------------------------------------


License ........................................................ 1

Warranty ....................................................... 2

Ordering Information ........................................... 3

Order Form ..................................................... 4

Thanks ......................................................... 5

Features ....................................................... 6

Getting Started ................................................ 7

The Avian Record System ........................................ 8

Edit ....................................................... 9-10

Browse ..................................................... 11-12

Search ..................................................... 13

Report ..................................................... 14-15

Sort ....................................................... 16

Options .................................................... 17

Revision History ............................................... 18

















i

-----------------------------------------------------------------------
LICENSE
-----------------------------------------------------------------------


Version 1.2 of THE AVIAN RECORD SYSTEM (ARS), and all future versions,
are not public domain software, nor are they free software.

THE AVIAN RECORD SYSTEM is copyright (c) 1989 by Baird Software
Designs.

Non-registered users are granted a limited license to use ARS on a
trial basis for the purpose of determining whether ARS is suitable for
their needs. Use of ARS, except for this limited purpose, requires
registration.

Use of non-registered copies of ARS by any person, business,
corporation, governmental agency, or other entity or institution is
strictly forbidden.

Registration permits a user the license to use ARS only on a single
computer; a registered user may use the program on a different
computer, but may not use the program on more than one computer at the
same time.

No user may modify THE AVIAN RECORD SYSTEM in any way, including but
not limited to decompiling, disassembling or otherwise reverse the
engineering of the program.

All users are granted a limited license to copy ARS only for the trial
use of others subject to the above limitations, and also the following:

ARS must be copied in unmodified form, complete with the file
containing this license information.

The full ARS documentation must be included with the copy.

No fee, charge or other compensation may be accepted or requested
by any licensee.

ARS may not be distributed in conjunction with any other product.

Operators of electronic bulletin board systems (SYSOPS) may post ARS
for downloading by their users only as long as the above conditions are
met.

Distributors of public domain or user supported software may distribute
copies of ARS subject to the above conditions only after obtaining
written permission from Baird Software Designs. Such permission is
usually granted; please write for details.

See the ordering section for more information on registration.







-1-




-----------------------------------------------------------------------
WARRANTY
-----------------------------------------------------------------------


Baird Software Designs makes no warranty of any kind, express or
implied, including without limitation, any warranties of
merchantability and/or fitness for a particular purpose. Baird
Software Designs shall 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. Baird Software
Designs 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 Baird Software Designs BE LIABLE TO YOU FOR ANY
DAMAGES, INCLUDING 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 ANY OTHER PARTY.










































-2-




-----------------------------------------------------------------------
ORDERING INFORMATION
-----------------------------------------------------------------------


An ARS registration licenses you to use the product on a regular basis.
Registration includes mailed notification of updates and priority
support on our BBS. Registered users will also be granted access to
special areas of the AVIARY BBS. Users need only register one copy of
THE AVIAN RECORD SYSTEM; registration includes licensed use of all
upgrades.

Individual registration of the AVIAN RECORD SYSTEM is $35.00 and
includes a license to use the program and all future upgrades, your
choice of an additional interchangeable catalogue other than the North
American Catalogue, free phone support, access to the AVIARY BBS, and
the field notebook program (in the testing stage, will be available
with v2.0), and notification of all updates. Updates will be mailed to
you upon receipt of the order form and the requisite postage and
handling, or can be downloaded from your section of the AVIARY by
prior arrangements with the SYSOP.

Please use the enclosed order form when placing an order for the AVIAN
RECORD SYSTEM.

ORDERS OUTSIDE THE US: Funds must be in the form of a certified check
or money order drawn on a US bank in US dollars. We will accept non-US
currency provided an additional $5.00 dollars is enclosed to cover
conversion and collection costs.






























-3-




-----------------------------------------------------------------------
ORDER FORM
-----------------------------------------------------------------------


Remit to: Baird Software Designs
9721 Kempwood Drive #1434
Houston, Texas 77080


_____ ARS Registered Disk (current version) ...... $35.00 ea _____
Includes choice of additional catalogue. Please
indicate choice. (North America, Britain and Europe,
Mexico and Central America - more
in near future.)

Which catalogue: __________________________

Additional catalogues: ____________________ $10.00 ea ______
____________________
____________________ Sub Total ______

Discount <______>


Total $______


Payment by: ( ) Check ( ) Money order ( ) Certified check

Name: ______________________________________________________

Company: ______________________________________________________

Address: ______________________________________________________

______________________________________________________

______________________________________________________

Day Phone: _______________________ Evening: ____________________


ORDERS OUTSIDE THE US: Funds must be in the form of a certified
check or money order drawn on a US bank in US dollars. We will accept
non-US currency provided an additional $5.00 dollars is enclosed to
cover conversion and collection costs.

Sorry, No C. O. D. orders will be accepted.









-4-




-----------------------------------------------------------------------
THANKS
-----------------------------------------------------------------------




I would also like to acknowlege the following who have reviewed the
program, suggested changes, given support and encouragement to the
author:

Mel Douglass
Larry Westermann
Douglas Pippel


I want to thank the following people for their encouragement.

Dr. Gordon L. Kirkland The York Audobon Society
William Kline Sean Stibitz
General Computer Center

And all of the users of THE AVIAN RECORD SYSTEM

If I have missed anyone, I apologize. Special credit goes to my wife
Cheryl and my son Johnny. Without their patience in not seeing their
husband and father, this project would never have been completed.

Hopefully, that patience will continue as revisions need to be done.

THANKS!!




































-5-




-----------------------------------------------------------------------
FEATURES
-----------------------------------------------------------------------


The AVIAN RECORD SYSTEM:

1. Was written in Turbo Pascal* and designed to be run on IBM**
PC/XT/AT's or close compatibles.

2. Supports monochrome, CGA, or EGA video displays. No switching of
programs necessary.

3. On-Line help screens to facilitate use.

4. Pre-installed database containing all of the birds found in North
America and Canada.

5. Interchangeable databases for each area of the world, containing
all birds in that area.

6. Report function featuring printing Life Lists in numerical order,
date seen order, or common name order, or state or province lists.

7. Capability to print checklists for each area of the US and Canada.

8. Sort on Common Name, Life List Number, Date Seen, Place Seen.

9. Fast, easy search to find any bird in the database.

10. The AVIAN RECORD SYSTEM is a shareware product. This means that
it is not public domain or free software. It is provided to the
end user at little or no cost for an evaluation. If the user
decides to use the AVIAN RECORD SYSTEM past a reasonable (30 day)
evaluation period, then the user is expected to submit the
requested donation and register the program. In this spirit, the
AVIAN RECORD SYSTEM, uses a time delay at startup. Each usage of
the program increases the delay up to 1 full minute. However,
when the user registers the AVIAN RECORD SYSTEM, a key will be
provided that will unlock the delay and provide the user access to
the program without pause.














* Turbo Pascal is the registered trademark of Borland International.
** IBM is the registered trademark of the International Business Machine Compay.




-6-




-----------------------------------------------------------------------
GETTING STARTED
-----------------------------------------------------------------------



Welcome to the world of the AVIAN RECORD SYSTEM. The program
consists of a number of files. If you downloaded the program
(ARS10.zip) from a bulletin board, you should have the following files:

ARS.EXE - The main program.
ARS.DAT - The main programs data file.
ARSSort.DAT - The sort data file.
ARS.000 --
ARS.001 | - The main program's overlay files.
ARS.002 --
ARS.DOC - This documentation package.


There is one more file that is created by the program when it is
run for the first time. This file, ARS.CNF, is the configure file. If
it is present when you unzip the files, erase it. The program will
prompt you for the information it needs to run the program and then
store it as the configure file.

The first thing to do is to make a backup copy of the program
disk, or copy the complete archive to a disk. Keep this in a safe
place. Most computer users hate to hear the word backup. Believe me!
Make backup copies of the data files regularly. That way, if the worst
happens you can always restore the last backup copy of the files and
continue to work.

All you have to do is type ARS at the prompt and a way we go!



























-7-




-----------------------------------------------------------------------
THE AVIAN RECORD SYSTEM
-----------------------------------------------------------------------


When you begin the program, you are presented with the following
screen:


Quit Edit Browse Search Report sorT Options

AVIAN RECORD SYSTEM - v1.2 by John Baird

Life List Number - 0 Sorted On - Common Name Rec # 1

Common Name: Scientific Name:
.................... ....................

Date First Seen: Place First Seen:
...... ....................

North American Catalogue
AL: . DE: . IN: . MI: . NE: . OK: . TX: . WY: . NS: .
AK: . DC: . KS: . MN: . NH: . OR: . UT: . Canada NW: .
AR: . FL: . KY: . MO: . NJ: . PA: . VA: . AB: . ON: .
AZ: . GA: . LA: . MS: . NM: . RI: . VT: . BC: . PE: .
CA: . IA: . MA: . MT: . NV: . SC: . WA: . MB: . QU: .
CO: . ID: . MD: . NC: . NY: . SD: . WI: . NB: . SA: .
CN: . IL: . ME: . ND: . OH: . TN: . WV: . NF: . YU: .


As you can see, the main program functions are:

Quit, Edit, Browse, Search, Report, sorT, Options

These options are chosen by using either the arrow keys, typing
the capitalized character in each word, or by using the backspace key.
The option is highlighted as you move through the program's functions.
You select the desired function by pressing the key.

Help is available at most points by pressing the key.

The following pages will discuss in detail each of the program's
main functions.

The middle section contains the program's data. This is the
section you will use to enter and manipulate the data file.

The bottom section of the screen (lines 24 and 25) is the command
window. The options available to you with each command are
highlighted in this window.









-8-




-----------------------------------------------------------------------
EDIT
-----------------------------------------------------------------------


The edit command permits you to add, delete, or change the data in
a record. When you select the edit function from the main menu, the
following commands are highlighted in the bottom window.

F1 Next - Pages forward through the database record by
one record.

F3 Prev - Pages backward through the database record by
one record.

F5 Goto - Allows you to goto any record number in the
database. A command window opens requesting the
record number. You type your response and that
record number is displayed for you.

F7 Edit - Allows you to edit the current screen. The
Common and Scientific Names are protected from
regular edit.

F8 - This command does not appear with the others,
but has been added for your convenience. It
allows you to edit the Common and Scientific
Name fields.

F9 Edit State - Allows you to move anywhere within the North
American catalogue and toggle the state (X or .)
via the F1 key.

F10 Quit - Quits edit and places you back in the main
program functions menu.

Most of these options are self-explanatory; however F7 needs more
clarification.

Choosing F7 highlights the Life List Number field in the main
display. The field is displayed in inverse video and the data present
is colored red. I have written a mini-editor to make editing the data
easier. When the data is displayed in red, the program displays a set
of commands in the bottom area of the display.

These are: (^ designates pressing control key and the following
key together)

Left Arrow - move one char left.
Right Arrow - move one char right.
Home - move to 1st position in data.
End - move to last position in data.
Del - delete char under cursor.
^End - delete from cursor to end of data.
^PgDn - delete entire data.
F10 - quits edit and moves to next field.




-9-



-----------------------------------------------------------------------
EDIT (Cont'd)
-----------------------------------------------------------------------


Life List Number

As I said, the Life List Number is highlighted when edit (F7) is
called. The following illustrates what can be done in each field.

The program automatically inserts a life list number (1-855)
when the record is edited for the first time. If a life list number
is already present, the program accepts the current value. You
terminate editing data by pressing . If no changes are desired
press or F10.



Date First Seen

The date must be entered in YYMMDD format. If not, the sort
routine for date will not work properly. For example, if the date you
first saw the bird was April 25, 1977, you must enter 77 for year, 04
for April, and 25 for the day. If the month has one digit (i.e.
September = 9) a '0' must be added to make '09'. The same applies for
the day or the year after 1999.


North American Catalogue

The program displays a window and asks you to enter the state code
from the list below. That is the list of two letter standard
abbreviations in the bottom of the display screen. If you are unsure
which code represents what state, press the Escape key and a help
screen will appear to show which state code is which.


Place First Seen

Once again the data is highlighted and displayed in red indicating
you are in the editor. Only 30 spaces have been allowed here for the
place description, so please be terse in your description. A program
is in the works to record field sightings, which will give you as much
room as you need to make a complete description of the area. For now, I
suggest just the city and state. Again, the editor commands appear at
the bottom of the main display screen.















-10-




-----------------------------------------------------------------------
BROWSE
-----------------------------------------------------------------------


The BROWSE command permits you to look at the records in the
database 15 records at a time. When you select the BROWSE function
from the main menu, the following commands are highlighted in the
bottom window:

F1 Next - Pages forward through the database record by
one record.

F3 Prev - Pages backward through the database record by
one record.

F5 Goto - Allows you to goto any record number in the
database. A command window opens requesting the
record number. You type your response and that
record is displayed for you.

F7 All - Allows you display 15 records at a time on the
screen. The display includes the Common Name,
Life List Number, Record Number, and Date First
Seen.

F10 Quit - Quits BROWSE and places you back in the main
program functions menu.

Choosing the F7 (All) command clears the main display and writes
the following to the screen:


Common Name Life List # Rec # Date Seen

Abert's Towhee ... 1 ......
Acadian Flycatcher ... 2 ......
Acorn Woodpecker ... 3 ......
Alder Flycatcher ... 4 ......
Aleutian Tern ... 5 ......
Allen's Hummingbird ... 6 ......
Altamira Oriole ... 7 ......
American Avocet ... 8 ......
American Bittern ... 9 ......
American Black Duck ... 10 ......
American Black Oystercatcher ... 11 ......
American Coot ... 12 ......
American Crow ... 13 ......
American Dipper ... 14 ......
American Goldfinch ... 15 ......










-11-




-----------------------------------------------------------------------
BROWSE (Cont'd)
-----------------------------------------------------------------------


The following commands are highlighted at the bottom of the BROWSE
ALL screen:

F1 Next - Pages forward displaying the next page of 15
records.

F3 Prev - Pages backward displaying the previous page of
15 records.

F5 Top - Returns to the 1st page of 15 records.

F7 Bot - Goes to the last page (57) of 15 records.

F9 Goto - Allows you to goto any page number (1-57) in the
database. A command window opens requesting the
page number. You type your response and the 15
records on that page are displayed for you.

F10 Quit - Quit BROWSE ALL and return to Browse.




































-12-




-----------------------------------------------------------------------
SEARCH
-----------------------------------------------------------------------


The search function permits you to retrieve any record in the
database and display it on the screen. The search routine works with a
binary search algorithm so the database must be sorted by Common Name
(Alphabetical). There is a status window in the middle of the first
line in the main display that shows the current status of the sort.
The search function is operable when sorted by Common Name only. If
the database is sorted by any other means and you call the search
routine, a window is opened an error message is displayed informing you
that you must sort the database by Common Name prior to using the
search routine.

Invoking the search routine opens a command window prompting you
for the Common Name to search by. The data file contains the Common
Names for the birds in the United States and Canada according to the
New Audubon Society's Master Field Guide. There have been numerous
changes in the names, so you must be familiar with the new names to use
the search.

At the window's prompt, you type as much of the name necessary to
make it specific. For example, if you are searching for the 'Common
Poorwill' and type 'Common' at the prompt and strike the key,
the program searches for the first occurrence of 'Common' and displays
the record for the Common Barn-Owl. If you type 'Common P', the
program returns the record for the 'Common Paraque'. If you type
'Common Po', the program returns the record for the 'Common Pochard'.
However, if you type 'Common Poor', the program returns with 'Common
Poorwill'. Therefore, you do not need to type the entire common name,
but just enough to make it specific.

The search routine is not case sensitive (i.e. you can type upper,
lower, or mixed case (CoMon BARN-owl)), and still find your match.

The search is really fast, so it will speed up finding records in
the database.



















-13-






-----------------------------------------------------------------------
REPORT
-----------------------------------------------------------------------


The report routines have been written to allow you to keep printed
records of your life list in a variety of ways. When you choose
report, the following report format commands are displayed below the
main display area:

F1 Life List - This report will print your life list in
order of species seen. The data base must
be sorted on the Life List Number using the
sort option.

F3 Check List - This option permits you to print field
checklists for any area within the
catalogue you are using. For example,
with the North American catalogue, you can
print out field check lists for each of the
states and Canadian territories.

F5 Not Seen - This option permits you to print list by
state or province of the birds you have
not seen in those areas.

F7 State List - This option permits you to print lists
of all species sighted within a particular
state.

F8 Date - This option permits you to print lists by
specific dates. If you participated in
the annual christmas count, and you want
to print a list of all birds seen during
that count, utilize this selection.

F9 Place - Using this option, you can print reports
for specific places. If you have done
alot of birdwatching at the James
Buchanan State Park in Pennsylvania, you
could print a comprehensive list of all
birds seen at this location regardless of
date.

F10 Quit - Quit report section and return to main
menu.


Each option opens a command window, prompts you for information,
and the prints the report you have chosen. There is a built in routine
that checks to see if your printer is on line and ready to receive



-14-




-----------------------------------------------------------------------
REPORT (Cont'd)
-----------------------------------------------------------------------


information. If it is not, you are given an error message. You must
then correct the problem and re-enter the report routine.

At any of the prompts for information, the program will display
the edit commands at the bottom of the main display screen.

ARS is printer sensitive, in that it checks whether or not a printer
is connected or if it is online. If no printer is connected and you
choose the Report option, ARS displays an message to you indicating that
it has detected no printer, and asks if you want the report dumped to a
disk file. If you answer no, ARS aborts the report request; otherwise,
if prints the report to the diskfile you indicate at the prompt.
















































-15-




-----------------------------------------------------------------------
SORT
-----------------------------------------------------------------------


The sort routine utilizes the Quicksort algorithm and as such is a
fairly fast sort routine. The only problem is, that on a floppy based
system, it takes approximately 2-3 minutes to sort the database. On a
hard disk AT, it takes approx 10-12 seconds. The majority of time, is
the time spent reading and writing the records to disk.

If you choose the sort routine, the following commands are
displayed:

F1 Sort on Common Name - This is the normal mode for
operation of the program. The
search routine will not work unless
the database is in common name
order.

F3 Sort on Date Seen - Allows you to display via the
BROWSE command, all records for a
specific date.

F5 Sort on Life List # - Allows you to display via the
BROWSE command, all records in Life
List number order or to print the
life list report.

F7 Sort on Place Seen - Allows you to display via the
BROWSE command, all records for a
specific place.

F10 Quit - Aborts the sort command and returns
to the main menu.























-16-




-----------------------------------------------------------------------
OPTIONS
-----------------------------------------------------------------------


There are currently only three options available. The following
commands are displayed when this option is chosen.

F1 Add Record - This routine searches for the first empty
record in the database and then enters the
edit mode to enter the Common and Scientific
names. The rest of the data can only be
entered via the EDIT command.

F3 Delete Record - This option allows you to delete any record
in the database. All the information in the
record, including Common and Scientific
Names are erased.

F5 Reconfig - This allows you to change the User Name that
prints on reports. Changes the logged disk
for the data file, and updates the current
Life List number for the automatic numbering
function.

F10 Quit - Quit options and return to the main menu.

If you use the add or delete functions, try to do all of your
additions or deletions at one time, because you must resort the
database at the completion of the add or delete routines or else the
search routine will not work.
























-17-




-----------------------------------------------------------------------
Revision History
-----------------------------------------------------------------------


6-24-89 Release of ARS v1.2
- Added check for connected printer - suggested by Mel Douglass
- Added DiskFile option - suggested by Mel Douglass
- Fixed a minor bug in header centering routines.

6-4-89 Release of ARS v1.1
- Fixed bug in Options found by Doug Pippel.
- Added automatic Life List Numbering
- Changed from crippleware to full use

4-15-89 Release of ARS v1.0


















































- 18 -