home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
database
/
ped205.zip
/
PED205.EXE
/
PEDIGREE.DOC
< prev
next >
Wrap
Text File
|
1991-06-08
|
69KB
|
2,059 lines
/- PEDIGREE
PEDIGREE ---|
\- PEDIGREE
Version 2.0x
(C) 1988-1991 By Charles H. Orange
702 Maple Avenue
Downers Grove, Ill. 60515
(708)964-8898
INTRODUCTION
PEDIGREE is a program to keep track of dog pedigrees and American
Kennel Club Titles. The original intent for writing this program was
to keep track of pedigree data for our own line of dogs only. I soon
expanded it to maintain show title information and enlarged my data
file to include as many animals as possible in our breeds. I wrote
the program to be flexible enough to allow historical data from old
books, foreign pedigrees and show catalogs to be used as well as the
American Kennel Club Stud Book and American Kennel Club Awards
periodicals. I provided for the inclusion of customized titles or
awards in addition to the A.K.C. recognized awards. The most recent
version includes provisions for customizing all title and award fields
to make the program useful in other countries.
I am releasing this program for distribution as user supported
software subject to the license agreement at the end of this manual.
The non-registered version of the program will only support 300 animal
records. There is a registration form in a separate file on the
distribution disk. The registered version of the program will support
over 2 million animal records. There is no difference between the
registered version and the non-registered version except for the limit
to the number of animal records. I welcome all comments, suggestions
and ideas for improvements as well as reports of problems from users.
I will try to incorporate as many improvements as possible in future
releases.
This program is not in the public domain and is not distributed as
free software. You may use this product on a trial basis only in
order to determine it's suitability to your needs. If you wish to
continue using the product on a regular basis, you must register by
sending $40.00 to the address listed below. Registered users will
receive announcements of future upgrades and additional products as
available.
Charles H. Orange
702 Maple Avenue
Downers Grove, Ill. 60515
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 1
OVERVIEW
PEDIGREE is a program to aid in the keeping of dog pedigree and title
records. It consists of two basic parts, one to add or change
records, and one to create pedigrees and other useful reports. A
complete description of each process is given in the following
sections.
Reports generated include three to seven generation pedigrees, seven
generation line breeding lists, lines of descendancy and top producing
sire and dam lists.
Data may be input from any number of sources. The complete selection
of A.K.C. awards may be entered as well as data from other sources.
As new data is entered, it is checked against any data in the system.
Any discrepancies that are found will display an error message and the
new data will not replace the data already in the system.
PEDIGREE is menu driven with a single letter required to move to an
item on a menu. This choice may be a function of the program, or
another menu of items. To exit to the previous menu, press the
<ESCAPE> key. Help topics are available at all menus and at all
places requiring keyboard input. Help is available by pressing the
function key <F1>. An index of the major Help Topics is available by
pressing <F1> again.
The program files are as follows:
PEDIGREE.EXE the pedigree program itself.
PEDIGREE.HLF the help file.
Supplemental files for documentation and installation only:
PEDIGREE.DOC this document file.
PEDIGREE.ORD an order form for registration.
PEDIGREE.REV list of revision level changes.
PED1SEQ.EXE conversion program from version 1 files.
PED1SEQ.DOC instructions for PED1SEQ.EXE conversion.
README.1ST quick start instructions.
The data files are created as follows:
Breed.P00 the breed setup file.
Breed.P01 the main database file.
Breed.P02 the name index file.
Breed.P03 the sire index file.
Breed.P04 the dam index file.
Breed.P05 the alias name file.
Breed.P06 the alias index file.
Breed.TXT text file output for other programs.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 2
SYSTEM REQUIREMENTS
Computer: IBM PC or compatible with at least 384k memory. A hard
disk is preferred as the data files require a mimimum
of 190 bytes per animal to a maximum of 320 bytes. A
data file of fewer than 1100 animals could fill a 360k
disk.
Printer: Any printer should work. A printer that supports the
IBM extended character set can print pedigrees with
lines connecting related animals. In printing a
listing of the complete data file, a printer capable of
printing 160 characters on a line may be utilized to
print on fewer pages. Printer definition codes may be
entered when the program is run. The default settings
are for Epson printers.
Monitor: Any monitor that supports IBM monochrome displays may
be used. Color is supported but not required for the
program to operate.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 3
GETTING STARTED
The first step to running PEDIGREE is to make a back-up copy of the
disk. Consult your DOS manual for any details of the copy process
that you are not sure about. Take your original disk and put it away
in a safe place.
The steps below which refer to installing PEDIGREE on a hard disk may
have been completed during the process of unarchiving the program and
this file from the distribution floppy disk. If that is the case,
skip to the section on changing the file named CONFIG.SYS.
If you are using a computer without a hard disk, copy the files
PEDIGREE.EXE and PEDIGREE.HLF onto a separate floppy disk. This will
become your working disk. If you only have one floppy disk drive, it
is advisable to delete the file PEDIGREE.HLF from the working disk
only to conserve space for data files. You will then have to refer to
this manual in place of using the help screens from within the
program.
If you are using a computer with a hard disk, create a directory on
that disk named \PEDIGREE. The pedigree program and the help file
should be located in the same directory. Copy the files PEDIGREE.EXE
and PEDIGREE.HLF from the distribution disk into the directory that
you just created.
Change the file CONFIG.SYS on your boot disk to include the following
lines:
buffers=20
files=20
Any number for files or buffers equal or greater than twenty is
acceptable. If no CONFIG.SYS file exists on your boot disk, then
consult your DOS manual for instructions on creating text files using
the COPY command from the keyboard.
For advanced DOS users, with DOS version 3.0 or greater, the
PEDIGREE.EXE file may be either in the current directory or in the DOS
Path. The PEDIGREE.HLF file must be either in the current directory,
or in the same directory as PEDIGREE.EXE.
Change drives and directories to the one that contain your working
copies of PEDIGREE.EXE and PEDIGREE.HLF or to the directory where you
want the breed data files to be stored. You are now ready to run the
program.
Start PEDIGREE by typing PEDIGREE <RETURN>. After you have read the
introductory screen, press any key to be prompted for a breed name.
The breed name will become the name of the files created by the
computer. If a name longer than 8 characters is used, only the first
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 4
8, or up to the first space in the name will be used for the file
names. If the breed name entered is found on the disk, the existing
files are opened. If the name is not found, confirmation is required
before new data files are created. Alternatively, you may enter the
breed name on the command line after the word PEDIGREE.
If this is the first time you are using this breed, a message will
state that no database exists and prompt for creation of a new one.
Answering 'Y' to this question will start the creation of new breed
files. The first step in creating new breed data files is to answer
the question about redefining the A.K.C. awards. For United States
users who are working with American Kennel Club registered dogs, this
should be answered 'N'. Users from other countries or those with dogs
registered with other kennel clubs should answer 'Y'. Customization
of titles and certifications is performed next. These may be changed
at any time and are fully described in the section labeled
'Supplemental Title Definition'.
After completing the customization of titles, the main menu will
appear. The functions will be described in the remaining sections of
this manual except for the Exit function, which saves your data,
closes all files and ends the program. Always exit the program before
turning off your computer as valuable data may be lost otherwise.
If the display on a monochrome monitor or laptop computer is not clear
because of color selection, the program may be started with a command
line parameter of '/m' to force monochrome output. This should
increase legibility on laptop displays.
ACCESSING THE HELP SYSTEM
When the program is started a message appears on the lower center of
the screen to show whether help is available or not. If the help file
is not found, the message will say 'Help File PEDIGREE.HLF not found.'
If the help file is found, the message will say 'Press <F1> for help.'
If help is available, the help system may be activated at any time by
pressing the <F1> key. The first help message will be information
concerning the current menu command or required input line. If the
help for the current topic requires more than one screen for display,
a message will appear in the lower border for <PgUp>/<PgDn> for more
help. An index of help topics may be obtained by pressing <F1> again.
Further topics may be selected from this index by using the cursor
keys to position the highlite over the topic and pressing <Return>.
The help system may be exited by pressing <Escape> at any time.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 5
CONVENTIONS FOR INPUT
SELECTING MENU ITEMS
Menu items may be selected by pressing the highlighted letter, or
using the <Up Arrow> or <Down Arrow> key to highlight the item and
pressing the <Return> key.
KEYBOARD ENTRY EDITING
edit keys available:
<Escape> ...................... abort the entry with no changes.
<Insert>, Ctrl-V .............. toggle insert/overwrite mode.
<Back Space>, Ctrl-H .......... delete character left of cursor.
<Delete>, Ctrl-G .............. delete the character under the cursor.
Ctrl-Y ........................ delete the entire field.
<Left Arrow>, Ctrl-S .......... move 1 character left in field.
<Right Arrow>, Ctrl-D ......... move 1 character right in field.
Home .......................... move to beginning of field.
End ........................... move to end of field.
<Return>, <Tab> ............... accept input from field.
The following edit keys are available for multiple field editing:
<Return>, <Tab> ............... move to next field.
Shift-<Tab> ................... move to previous field.
Ctrl-<Home> ................... move to first field.
Ctrl-<End> .................... move to last field.
<F10> ......................... accept all fields on screen.
Other edit keys will be displayed in the border when available.
Whenever keyboard input is required for multiple fields on a screen,
the only ways to exit the input mode are to press the <F10> key or one
of the keys displayed in the border to accept the entry, or press the
<Escape> key to discard the entry. The <Return>, <Tab>, or Shift-
<Tab> keys will only move from one field to the next without accepting
the inputs. When keyboard input is required for only one field, the
<Return> key will accept the input.
Insert mode of keboard operation is the default. When overwrite mode
is toggled on, the cursor appears as a fat block instead of an
underline.
MOUSE USAGE
If a mouse is present, the program will respond to it's usage. The
mouse may select a menu item by moving the mouse cursor over an entry
and pressing the left mouse button to select. The right button acts
like the <Escape> key. Entry fields may be selected for input by
selecting in the same manner. Pressing the right button will discard
the present entry. Pressing both mouse buttons together act like
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 6
pressing the <F10> key. Multiple selection items may be selected by
two clicks of the left mouse button.
INPUT FIELDS
Where text or numerical inputs are required, they take the following
form:
The entry length is limited to the size of the highlighted underline.
Date fields are forced into the proper format. Alphabetic input is
rejected if numeric input is required.
AKC NUMBER
The AKC number is input with a two letter prefix followed by a 6 digit
number. With newer numbers, the number is a litter number followed by
a slash and a number from 0 to 99. Either upper case or lower case
may be used. If there is only one letter in the prefix, use a '-' in
place of the second letter.
ALIAS NAME
A field for an additional name by which a specific animal is known.
The same limits apply as to the animal's registered name.
ANIMAL REGISTERED NAME
The registered name of the animal in question. Do not include any
Championship or Obedience Titles. Length is limited to 35 characters
including spaces and punctuation.
ANIMAL SEX
For dogs use 'M' or 'D'. For bitches use 'F' or 'B'.
Either upper case or lower case may be used. If sex is not known, use
either a <SPACE> or a <RETURN>. Any other character will be ignored.
BIRTH DATE
The month, day and year inputs should be in the format of a one or two
digit month followed by any of '/', '-', '.', or space followed by a
one or two digit day followed any of '/', '-', '.', or space followed
by the year. The year may be two or four digits. If only two digits,
the year is assumed to be in the 20th century (eg. 88 becomes 1988).
The following are all acceptable examples:
05/03/87 5/3/1987 5-03-87 05,03,1987 5 3 87
BREED NAME
The first word of the breed name (up to 8 characters) will become the
name of the files created by the computer. The entire breed name will
be used for titles to some reports. If records for more than one
breed are to be kept on the same disk, be certain that the first word
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 7
in each name is different. If the name is found on the disk, the
existing files are opened. If the name is not found, confirmation is
required before new data files are created.
The breed name may also be included as a parameter on the command line
when starting the program.
BREEDER NAME
An unformatted field for the name of the breeder/owner of the animal.
COMMENT
An unformatted field for any comments about the animal.
COUNTRY NAMES
The input of an abbreviation for a country name is required.
Suggested abbreviations are the ones used by the International Olympic
Committee.
AFG Afghanistan GBR Great Britain NOR Norway
ALG Algeria GDR East Germany NZL New Zealand
AND Andorra GRE Greece PAK Pakistan
ANG Angola GUA Guatemala PAN Panama
ARG Argentina GUI Guinea PER Peru
AUS Australia GUY Guyana POL Poland
AUT Austria HOL Netherlands POR Portugal
BAH Bahamas HUN Hungary PKR North Korea
BAR Barbados INA Indonesia PUR Puerto Rico
BEL Belgium IND India QAT Qatar
BEN Benin IRL Ireland ROM Romania
BER Bermuda IRQ Iraq SAU Saudi Arabia
BIR Burma ISL Iceland SEN Senegal
BOT Botswana ISR Israel SEY Seychelles
BRA Brazil ITA Italy SLE Sierra Leone
BUL Bulgaria JAM Jamaica SMR San Marino
CAN Canada JOR Jordan SRI Sri Lanka
CGO Congo KEN Kenya SUD Sudan
CHI Chile KOR South Korea SUI Switzerland
CHN China KUW Kuwait SWE Sweden
CIV Ivory Coast LAO Laos SYR Syria
CMR Cameroun LBA Lybia TAN Tanzania
COL Columbia LES Lesotho TCH Czechoslovakia
CRC Costa Rica LIB Lebanon THA Thailand
CUB Cuba LIE Liechtenstein TPE Chinese Taipei
CYP Cyprus LUX Luxembourg TRI Trinidad and
DEN Denmark MAD Madagascar Tobago
DJI Djibouti MAL Malaysia TUR Turkey
DOM Dominican MAR Morocco UGA Uganda
Republic MEX Mexico URS U.S.S.R.
ECU Ecuador MGL Mongolia USA United States
EGY Egypt MLI Mali VEN Venezuela
ESP Spain MLT Malta VIE Vietnam
ETH Ethopia MOZ Mozambique YUG Yugoslavia
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 8
FIN Finland NCA Nicaragua ZAM Zambia
FRA France NEP Nepal ZIM Zimbabwe
FRG West Germany NGR Nigeria
DATA RELIABILITY
The data reliability number is a number between 0 and 255. The higher
the reliability of the source of data, the lower the number should be.
Any data input from an official AKC publication automatically has a
reliability number of 0. The entries created for sires or dams will
start out with a reliability of 255. Numbers between should be used
for other data sources. Consistency should be maintained to keep
track of data sources. This should enable back-tracking in the event
of conflicting data from different sources.
DESCRIPTION
An unformatted field for any descriptive data.
FILE PATH
A valid path to a directory or subdirectory is required. The
directory and drive must both exist. A blank entry will use the
current directory. A single character is valid as a root directory on
that drive. The trailing '\' is not necessary.
Valid examples are:
A:
A:\
b:\terriers
b:\TERRIERS\MYDOGS\
KENNEL NAME
The input consists of a string to be searched for within animal name.
This string may be either a whole word or characters included within
longer words. Punctuation is ignored, but spaces between words are
significant.
NUMBER INPUT
The input of a whole number is required. Digits 1 through 9 and 0 are
the only acceptable input keys. A <RETURN> is required to end the
input. An error message will be displayed on the bottom screen line
if the entry is not within the acceptable range.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 9
PUBLISHED DATE
The month and year inputs should be in the format of a one or two
digit month followed by any of '/', '-', '.', or space followed by the
year. The year may be two or four digits. If only two digits, the
year is assumed to be in the 20th century (eg. 87 becomes 1987). If
the month is not known, enter 00/87 for any time in 1987. If a title
is known to exist but no date is known, enter y or yes.
The following are all acceptable examples:
05/87 5/87 05/1987 5-87 5,87 5 87 05 1987
REGISTRATION NUMBER
The registration number may be input in this field. As there are
differing registration number-letter sequences in different countries,
there are no checks to determine proper format for this field.
TITLE ABBREVIATIONS
The abbreviation for Titles should be limited to 4 characters.
Abbreviations will be attached to the animal's name on reports.
TITLE DEFINITIONS
The proper name for a Title should be limited to 30 characters. Some
examples are:
Champion of Record
Certificate of Gameness
Working Certificate
Register of Merit.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 10
ADD or REVISE DATA
Selecting 'ADD or REVISE DATA' will bring up another menu showing
choices for adding, revising or deleting records from the main
database; as well as choices for adding or deleting foreign champion
data and alias names. Two selections for reorganizing the database
and creating sequential file output are described in detail in the
section on Data File Management.
Add New Entries To Database:
If the A.K.C. titles have been left unchanged, the selection of 'Add
New Entries' will display a list of possible sources for new data. If
the titles have been modified, the selection of 'Add New Entries' will
be identical to adding data from other sources below. If the animal
is found in the data file then only blank fields will be available
for input. When inputs are from A.K.C. publications, the date of the
publication will be required before the animal entry screen is
displayed and only fields that are in the A.K.C. publication will be
available for input.
Inputs may come from the following sources:
From AKC Stud Book
Championships From AKC Gazette
CD Titles From AKC Gazette
CDX Titles From AKC Gazette
UD Titles From AKC Gazette
TD Titles From AKC Gazette
TDX Titles From AKC Gazette
OTCH Titles From AKC Gazette
AFC Titles From AKC Gazette
FC Titles From AKC Gazette
JH Titles From AKC Gazette
SH Titles From AKC Gazette
MH Titles From AKC Gazette
Data From Other Sources
Data From Other Sources includes such items as records of the
customized titles or data from pedigrees and other publications. A
default data reliability is entered for this entry session. The data
reliability entry should reflect the confidence in the accuracy of the
source of data. A lower number for reliability indicates a lower
chance of bad data. If the animal is found in the data file, then
only blank fields will be available for input. All empty data fields
are available for input.
There is a second chance to ignore data that has just been entered.
After all fields have been entered, the cursor will move to the first
highlighted field on the screen. The cursor may be moved to any field
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 11
available for input at any time. This allows for corrections and
additions to the data. If there are any errors in the data fields,
pressing the <Escape> key will erase the screen and start over.
Pressing the <F10> key will accept the data as shown. For entries
made using 'Data From Other Sources' there will be four additional
function key choices highlited in the lower screen border. These
choices will allow immediate addition of data about an animal's sire
or dam, or the addition and revision of foreign data or supplemental
information about the animal.
Revise An Entry:
The selection of 'Revise an Entry' will request an animal name for
data revision. All fields of data may be revised. Care should be
taken for it is possible to revise not only an animal's name, but to
change the names of the animal's sire and dam. If there are any
errors in data revised, pressing the <Escape> key will erase the
screen and start over. Pressing the <F10> key will accept the input
data as shown. There will be four additional function key choices
highlited in the lower screen border. These choices will allow
immediate addition or revision of data about an animal's sire or dam,
or the addition or revision of foreign data or supplemental
information about the animal.
Delete An Entry:
The selection of 'Delete an Entry' will allow an entry to be removed
from the data file or exchanged for another if duplicate entries have
been made with misspellings of name. Confirmation will be requested
before any action is taken. If a replacement name is specified, the
data on the two records will be combined in the record for the
replacement name. Records for all offspring will be changed to show
the replacement name as parent. If there is any conflicting data an
error message will be displayed and no changes will be made.
Enter Foreign Champion Data:
Foreign Champion data is entered from a second screen selected after
entering data or revising an entry. This screen is available when the
prompt is displayed in the lower border.
Foreign Champion Entries may be entered with an abbreviation for the
country. This will allow limited record keeping of animals with
foreign titles. There are positions for up to 25 abbreviations of
foreign country names.
Foreign Champion Entries made by mistake may be removed from the data
file. The country should be deleted from the field with either a
Control-Y at the beginning of the field or repeated use of the
<DELETE> key. If all Foreign Champion Entries for the animal have
been deleted, the foreign record will be deleted from the database.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 12
Enter Alias Name Data:
The selection of 'Enter Alias' name data will allow a second name to
be entered or deleted for an animal. This is useful for an imported
animal that has a different registered name in another country. The
entry in the data file should be the name by which the animal is
registered with the A.K.C. while the alternate name or names used are
added here. Alias names may also be added from the supplemental data
screen after entering or revising animal data. Alias names are not
displayed in any way. They are used only for determining the
registered name of an animal.
Reorganize Datafile:
The selection of 'Reorganize the Datafile' will be useful if some of
the index files have been damaged by a power failure or through some
fault. The possibility of this may be reduced by keeping regular back
up disks of data files.
Sequential File Processing:
'Sequential File Processing' will be used to import or export data for
other programs. Currently, no other programs have been written to
take advantage of this feature. A valid drive or directory entry is
required to find the sequential ASCII files for data transfer.
Appendix A describes the structure of the sequential files created.
These files may be directly imported into a word processor or
commercial data base manager if desired. This sequential file
processing feature is used as described in Appendix B for the transfer
of files from version 1.10 of PEDIGREE into this version.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 13
GENERATE REPORTS
The selection of 'Generate Reports' will allow the making of pedigrees
and other useful information for breeding selection. The entire data
file and an alphabetical list of registered names also may be printed.
The program checks to make certain that the printer is turned on
before any data is printed. An error message will appear if the
printer is not ready. Simply correct the problem and press any key to
continue. The following is a descriptive list of the available
reports:
Create Pedigree:
A 3 generation pedigree may be displayed on the screen, or a pedigree
with between 3 and 7 generations may be printed. A menu with the
selection of these options will appear.
A pedigree with a blank line for later filling in of the animal's name
can be made by using an asterisk (*) in place of the name. This
allows for creating a pedigree for a yet unregistered puppy. Proposed
breedings can be seen by filling in a fictitious name and then
answering the requests for sire and dam.
Three and four generation pedigrees will be printed on the top half of
a sheet of paper. Five generation pedigrees will fill an entire
sheet. Six and seven generation pedigrees will spill over onto the
next sheet and probably will not be very neat nor easy to read.
Extended data may be printed on the pedigree. This extended data
consists of all titles which are defined as printing under an animal's
name, any data in the three information fields and the description
from the supplemental data input screen. The extended data may be
printed for all animals which are in the pedigree, or for only the
main animal.
Line Breeding List:
A line breeding list is a listing of the ancestors in the previous 7
generations. Each animal is listed only once with a key to the
generations and frequencies of appearance in the pedigree. A line
breeding list may be printed sorted either by genetic weight of the
ancestors or by frequency of appearance in the background. The line
breeding list shows the generations in which an animal appears with
the sire's side on the left and the dam's side on the right of a
decimal point. For example:
14.062% CH Back Ancestor (7557.4)
implies that CH Back Ancestor appears in the 7th generation twice, and
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 14
in the 5th generation twice on the sire's side of the pedigree; and in
the 4th generation once on the dam's side of the pedigree.
The percentage of genetic contribution which an animal provides in all
generations is listed. The percentage in the above example is
calculated as follows:
seventh generation: 128 ancestors > 1/128 * 2 appearances = .01562
sixth generation: 32 ancestors > 1/32 * 2 appearances = .06250
fifth generation: 16 ancestors > 1/16 * 1 appearance = .06250
Total genetic contribution for all generations = .14062
The number of ancestors not included in the report is printed.
The total genetic contribution of each generation must total 100%.
Because of this, the total for all 7 generations will add up to 700%.
This will explain why an animal may contribute more than 50% of the
genetic background through appearance in more than one generation.
Extended data may be printed on the line breeding list. This extended
data consists of all titles which are defined as printing under an
animal's name, any data in the three information fields and the
description from the supplemental data input screen. The extended
data may be printed for all animals which are in the pedigree, or for
only the main animal and it's sire and dam.
Top Producing List:
A list of sires or dams with the highest number of titled offspring
may be produced. The minimum number of titled offspring for inclusion
on the list must be specified. This number must be one or greater in
order to produce a report. The titles to be used must be selected
from the displayed list. Select the titles by moving the cursor with
the cursor control keys and press <SPACE> to select or deselect a
title. At least one title must be selected. The list will be sorted
from highest to lowest number of titled offspring produced. The
number in parenthesis is the number of titled offspring. If only one
title has been selected then the listing for each offspring contains
the animal's sex and the publication date of the the title. The
offspring are listed in order of birth date.
Descendant List:
A list of descendants from an animal may be produced. The list can
either include all descendants or only continuous lines of titled
descendancy. The titles to be used must be selected from the
displayed list. Select the titles by moving the cursor with the
cursor control keys and press <SPACE> to select or deselect a title.
If no titles are selected then all offspring will be included. The
generation appears in parenthesis before each animal's name. The sex
of each animal appears at the right of the line. If the list was
requested only to contain continuous title lines for only one title,
the issue date of the title is also on the right of the entry.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 15
The list may include the opposite parent's name along with the name of
each descendant if desired. If this name is included, the date of the
animal's title or the sex of the animal will not appear.
The length of the list may be limited by requesting only those animals
within a specific number of generations be considered for inclusion.
This will be helpful for producing descendant lists of animals who are
top producers when only the first few generations are relevant as it
considerably reduces the time and paper consumed.
Extended data may be printed on the descendant list. This extended
data consists of all titles which are defined as printing under an
animal's name, any data in the three information fields and the
description from the supplemental data input screen.
List Datafile:
The contents of the data file may be printed in sequential format.
The listing will include all data entered for every animal in the
database.
Titles and their dates will be enclosed in brackets, and up to four
lines will be used if there is any supplemental information or com-
ments about an animal.
List Names In Alphabetical Order:
An alphabetical index of animals in the data file may be printed.
This list contains a cross-reference number to the entry in the
complete data file.
The format will be as follows:
1701 $ Animal Name A 300 # Animal Name C
31 * Animal Name B 5122 Animal Name D
The symbols between the number and the name indicate the following:
$ Birth date and Sex of animal are known
# Sire and Dam of animal are known
* Sire, Dam, Birth date, and Sex of animal are known
The listing will be in three columns on paper if the printer setup has
been specified that 160 characters may be printed on one line. If 160
characters per line is not available, the page will contain only two
columns. Output to the screen will be one column wide.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 16
Statistical Summary:
This selection will count the entries in the data file and report on
the number of animals in each category.
Search for Kennel Name
This selection will list all animals whose names have a word or kennel
name in common. Any string of letters and spaces in the database of
animal names may be searched for. Be cautious of searching for too
short of a word or part of a word because of the large number of names
which might be selected.
An example of a string of characters to search might be 'Jones'. This
will find the following names:
Best of Jones
Jonestown Better
J'Ones Greatest
This will not find the following names:
J' Ones Greatest
Jon Estimate
Find Comment Text
This selection will list all animals that have a comment record which
contains the text specified. Any combination of letters and spaces in
the comment field of an animal record may be searched for. The search
may be specified to be insensitive to upper/lower case letters, or
look for an exact match by case. Be cautious of searching for too
short of a word or part of a word because of the large number of names
which might be selected. Since the file is not indexed on the comment
field, this search must read the entire data file looking for the
specified text. This is a time consuming operation in direct propor-
tion to the number of animals in the data file.
Search for Breeder Name
This selection will list all animals whose breeder name has a word or
name in common. Any string of letters and spaces in the database of
breeder name may be searched for. Be cautious of searching for too
short of a word or part of a word because of the large number of names
which might be selected. Since the file is not indexed on breeder
name, this search must read the entire data file looking for the
specified text. This is a time consuming operation in direct propor-
tion to the number of animals in the data file.
Redirect Printer Output:
This selection will redirect output between the printer, a text file
on the disk, and the screen. The text file will contain all data that
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 17
would normally be sent to the printer except for printer control
commands. This is a plain ASCII text file suitable for inclusion into
word processor files or other programs. The text file will have the
name 'Breed.TXT' and will be appended to with new text every time the
output is redirected to the file. Output sent to the screen might
wrap to the next line if there are too many characters to display on
one line. The output may be switched between printer, text file, and
screen as often as desired. Output will be sent to the printer at the
start of the program. When output is sent to the screen, there will
be a pause after every screen full of new information. Press any key
to continue with the report, or <Escape> to exit back to the menu
item.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 18
SETUP PROGRAM INFORMATION
The selection of Setup Program Information will allow you to setup the
control codes required for your printer, unlock your registered
version of PEDIGREE, define the titles and awards for inclusion in the
datafile, and setup the screen colors for your monitor.
Printer Setup
To set up your printer for proper operation of PEDIGREE, you will need
to refer to the printer operator's manual or programmer's guide. You
will need to determine the correct codes necessary to configure the
printer to perform and to cancel the following operations:
12 character per inch printing
8 lines per inch printing
160 characters per line
letter quality printing
enhanced or bold type
If your printer is not capable of supporting any of these, the program
will still run, but the output will not be as neat as it could be.
The program initially configures the printer as using the Epson
character set for printer controls. The first time the program is
run, the printer configuration process should be done. Answering yes
to the question of reset to default codes will restore the program to
these Epson style control codes. If you know what the proper codes
for your printer are, you may enter them. At any time the printer may
be set up again through the main menu function C.
Non-printable control codes are input as a back slash '\' followed by
a 3 digit decimal number only. For example, an ESCAPE code is entered
as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
The following sequence is used in defining a printer:
Maximum Line Length:
For printing the entire contents of the database and the contents of
the alphabetical index to the database, the program will utilize a
line length of 160 characters. If the printer is not capable of
printing 160 characters on one line then these two report formats will
print out on multiple lines. The questions about condensed print mode
are asked only if the printer is capable of printing 160 characters
per line.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 19
IBM Character Set Compatibility:
For printing pedigrees with a graphic tree structure, a printer with
the IBM Extended Character set is required. If the printer is not
capable of this, then pedigrees will be printed without a line tree.
Set Left Margin Indentation
The left margin defaults to 10 character indent. This is a good value
to use if the printer is set up to print at the very left edge of the
page. If the printer is set to include a margin automatically, this
value should be reduced or set to zero.
Set Condensed Print Mode:
Some printers are capable of using a wide sheet of paper to print
lines of 160 characters. If the printer is like this, the current
input line should be cleared. Other printers will require a sequence
of characters to set a condensed print mode.
Reset From Condensed Print Mode:
If printer codes were not used to set condensed mode then the current
input line should be cleared. Other printers will require a sequence
of characters to reset from condensed print mode.
Set Lines Per Page:
When the printer is set up for wide sheets of paper, the number of
lines per page may not be the standard 66. In this case, enter the
actual number of lines on the page.
Set 12 Characters Per Inch:
Pedigrees are printed at 12 characters per inch if possible. If the
printer is not capable of printing at 12 characters per inch, the
current input line should be cleared. Other printers will require a
sequence of characters to set the pitch.
Reset From 12 Characters Per Inch:
If printer codes were not used to set 12 characters per inch then the
current input line should be cleared. Other printers will require a
sequence of characters to reset the pitch to standard 10 characters
per inch.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 20
Set 8 Lines Per Inch:
Pedigrees are printed at 8 lines per inch if possible. If the printer
is not capable of printing at 12 characters per inch, the current
input line should be cleared. Other printers will require a sequence
of characters to set the line spacing.
Reset From 8 Lines Per Inch:
If printer codes were not used to set 8 lines per inch then the
current input line should be cleared. Other printers will require a
+sequence of characters to reset the line spacing to the standard 6
lines per inch.
Set Letter Quality Mode:
Some reports are printed in letter quality mode if possible. If the
printer is not capable of switching to letter quality, or is only a
letter quality printer, the current input line should be cleared.
Other printers will require a sequence of characters to set letter
quality mode.
Reset From Letter Quality Mode:
If printer codes were not used to set letter quality mode then the
current input line should be cleared. Other printers will require a
sequence of characters to reset from letter quality mode.
Set Enhanced Character Mode:
Some reports are printed with enhanced characters if possible. If the
printer is not capable of enhanced printing, the current input line
should be cleared. Other printers will require a sequence of
characters to set letter quality mode.
Reset From Enhanced Character Mode:
If printer codes were not used to set enhanced character mode then the
current input line should be cleared. Other printers will require a
sequence of characters to reset from letter quality mode.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 21
Install License Registration
The selection of Install License Registration will allow registered
users to unlock PEDIGREE to accept over 2 million animal records.
Prompts will be asked for the name of the license owner, the license
number and the 16 character key code that is included with the
license. Keep the written record of these three items safe, as they
will unlock all future upgrades to PEDIGREE as they are released.
1) Enter the Name of the license owner as shown on the
registration form.
2) Enter the License Number from the registration form.
3) Enter the Code Key from the registration form.
An incorrect entry will display an error message and wait for
corrections to the incorrect field. Simply try again and double check
each line before going on to the next entry.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 22
Supplemental Title Definition
The first step in changing the titles and awards used is to answer the
question about redefining the A.K.C. awards. For United States users
who are working with American Kennel Club registered dogs, this should
be answered 'N'. Users from other countries or those with dogs
registered with other kennel clubs should answer 'Y'. If the A.K.C.
awards are not changed, then sixteen additional titles may be defined
for any awards desired. The first twelve awards will follow the
A.K.C. standards for abbreviation and method of display. If the
A.K.C. awards are changed, then all 28 awards may be defined.
Changing the A.K.C. awards also replaces the eleven character AKC
number field with a twenty character REG number field. This is more
flexible for international users.
Each title definition consists of a three parts. The formal title is
used on the Statistical Summary of the data file. An abbreviation of
the title will be reported with all references to an animal's name.
The position for the title will determine whether the title goes
BEFORE, AFTER, or UNDER the animal's name. Another possibility for
title position is NEVER, which will cause the title to be printed only
on the listing of the entire database. It would never be printed on a
pedigree or other report.
Some examples are:
Formal Title Abbreviation Position
Certificate of Gameness CG After
Register of Merit ROM After
Field Winner FW Before
When an animal's name is displayed, the first title defined will be
closest to the name, either before, after or under as defined.
Entry of data on animals with these titles will be done from the Add
New Data menu item.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 23
Color Setup
Color information may be set for the CRT to your personal taste. All
of the 16 foreground colors on 8 background colors may be used. The
color and monochrome attributes may be set for each type of text. If
the program detects a monochrome video adapter, or if the command line
contains a '/m' parameter, the monochrome attributes will be available
for modification. These attributes are selected from a color chart
for the foreground followed by the background. The current settings
are highlighted above the marker. The marker may be moved with the
<Cursor Left> and <Cursor Right> and the selection ended with
<Return>.
Settings are required for the following types of text:
Normal text and entry prompts.
Entry fields which are not currently selected.
Highlighted text and the current entry field.
One line help message and error messages.
The screen border.
The trace number for data items.
The mouse cursor if a mouse is active.
If any of the settings are changed, the program will save the changes,
save all data, close the database and exit. This is necessary to
properly assign the new colors.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 24
ERROR HANDLING
When an error occurs either in data file handling, or in keyboard data
entry, a message is displayed on the bottom line of the screen. The
message will be cleared and the program will continue after pressing
any key. Further help on most errors is available by pressing the
<F1> key. If the error is severe enough to cause the program to fail,
all files will be closed and data saved automatically where possible.
The importance of keeping back up data files cannot be overemphasized.
Non fatal errors will have no effect on the data files and are
summarized below:
Record Was Previously Deleted:
This entry has already been deleted from the data file. Reenter a
different animal name.
Conflicting Record Data:
These two records have conflicting data. The error codes are summed
up to the number shown:
128 = Differing Names 64 = Differing AKC Numbers
32 = Differing Sex 16 = Differing Birth Dates
8 = Differing Sires 4 = Differing Dams
2 = Differing Stud Book Dates 1 = Differing Title Dates
Example: Error of 37 = 32 + 4 + 1 means records are different
in SEX and DAM NAMES and TITLE DATES.
Conflicting Supplement Data
These two records have conflicting supplemental data. The error codes
are summed up to the number shown:
32 = Differing Import Country 16 = Differing Original Reg.
4 = Differing Description 2 = Differing Breeder Name
Example: Error of 36 = 32 + 4 means records are different in IMPORT
COUNTRY and DESCRIPTION.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 25
These two records have conflicting supplemental data. The error codes
are summed up to the number shown:
8 = Differing Registration #1 4 = Differing Registration #2
2 = Differing Registration #3 1 = Differing Title Dates
Example: Error of 9 = 8 + 1 means records are different in
REGISTRATION #1 and TITLE DATES.
Conflicting Comment Data
Combining these two records would loose the comment fields on the
record being deleted. Write down the comment fields for both records
before proceeding. They may be entered again after combining the
records.
Animal Is Not In Database:
Foreign championship data and alias names may not be entered for an
animal which has not yet been added to the data file. Likewise,
revisions may not be made without first adding the animal to the data
file nor may an animal that is not in the data file be removed.
Name Is Already In Alias File:
The alias name has already been entered in the file as an alias for a
different animal.
Name Is Already In Data File - Delete First:
The name being added as an alias or as a revised name to an existing
entry already exists in the data file. If this entry is correct, then
the existing animal must be deleted from the database first.
Alias Is Not In Data File:
The alias name being deleted is not in the alias file.
Published Data Does Not Agree With Data File:
The date of the Stud Book or AKC Gazette does not agree with existing
data in the file for this animal.
Animal Is Not Of This Sex:
The animal being entered as a Sire or Dam is already in the data file
and has the wrong sex to be used in this situation. This must be
corrected by reentering a different animal name.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 26
Animal Is Of Opposite Sex For Offspring Listed:
The animal has offspring in the data file that show this animal to be
of the opposite sex. The entry must be deleted and then be reentered
to change the sex, or the offspring must be changed.
Not A Valid Date
Separators for dates are: / - . or space
Inputs for birthday should be in the format of a one or two digit
month, a separator, a one or two digit day, a separator, then the
year.
The following are all acceptable examples:
05/03/87 5/3/1987 5-03-87 05,03,1987 5 3 8
Inputs for published dates should be in the format of a one or two
digit month, a separator, then the year.
The following are all acceptable examples:
05/87 5/87 05/1987 5-87 5,87 5 87 05 1987
00/87 00/1987 y yes
Can't Replace Animal With Itself
Replacement animal for one being deleted is the same animal. One of
the entries is probably in the Alias file as another name for the
other one.
Can't Delete Animal's Name
An animal's name cannot be removed from the Revise function. To
remove an animal from the data file, use the Delete menu selection.
Control Code Not Valid
This entry is not valid for a printer control code. Reenter.
Non-printable control codes are input as a back slash '\' followed by
a 3 digit decimal number only. For example, an ESCAPE code is entered
as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
Not a Valid Directory Path
This is not a path to a valid directory. Either the directory does
not exist on the drive, or the disk is invalid. Enter a new path to
correct.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 27
Data File Was Made by Wrong Version
The sequential data files were created by a version of PEDIGREE that
does not format data in the same manner. The oldest version of
PEDIGREE that creates compatible files is Ver. 1.10. The solution to
this is to create new sequential files with this version of PEDIGREE.
Index Files Are In Error
There is an error in the index files which will interpret this entry
in an incorrect manner. Re-index the datafile on all fields before
continuing to correct.
Error in Creating File
There is an error which prohibits the program from creating all of the
required dta files. Exit the program and determine if there is
sufficient disk space and available directory entries to create files.
Confirm that there is a statement 'FILES=20' or greater in the file
CONFIG.SYS on the boot disk or root directory.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 28
DATA FILE MANAGEMENT
File Reindexing:
Reorganization of the database may become necessary if index files
have been corrupted through power outages or computer errors. As
these errors can occur at any time, it is very strongly recommended
that you keep back up copies of all data files at regular intervals.
The database is indexed on five separate fields for rapid retrieval of
information. If an error that causes the index files to mismatch the
data files occurs, reindexing of the appropriate index file will be
necessary.
The menu selection for reorganizing the data file will allow for
reindexing all index files or only selected files.
Sequential File Processing:
Sequential files may be created from the main data files. Sequential
files may also be appended to the main data files. The appending
process checks for discrepancies between the main data files and the
sequential files. Any records with discrepancies are not appended to
the data files, but are entered in a file named 'Breed.ERR' in the
same directory as the main data files. See the section titled ERROR
HANDLING - Conflicting Record Data for the error codes. In order for
the appending process to work correctly all titles in the sequential
file must refer to the same information as the corresponding field in
the data file, and the sequential data files must have been created by
PEDIGREE ver. 1.10 or later.
These files may be used by other programs if desired or may be read
into a word processor. They are plain ASCII files with fields
separated by a comma and each entry is terminated with a carriage
return and line feed.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 29
The structure is as follows:
Breed.DA1 Main data in the following order:
Name - maximum of 35 characters.
Registration number.
Sex - B D or space.
Birth date - yyyymmdd.
Sire Name - maximum of 35 characters.
Dam Name - maximum of 35 characters.
Date Published in Stud Book - packed form.
Championship Published - packed form.
Companion Dog Published - packed form.
Companion Dog Excellent Published - packed form.
Utility Dog Published - packed form.
Tracking Dog Published - packed form.
Tracking Dog Excellent Published - packed form.
Obedience Trial Championship Published - packed form.
Amateur Field Trial Championship Published - packed form.
Field Trial Championship Published - packed form.
Junior Hunter Published - packed form.
Senior Hunter Published - packed form.
Master Hunter Published - packed form.
User Defined Field #1 Published - packed form.
User Defined Field #2 Published - packed form.
Packed form for published dates may be expanded to valid dates as
follows:
0 -- means that no published date exists in
file.
1 -- means that published date is known to
exist, but the date is not known.
other # -- add 188000 to the number. The right 2 digits are the
month and the left 4 digits are the year. If the
month is 00 then the year is known but the month is
not.
Breed.DA2 Alias names in the following order:
Actual name of animal in Breed.DA1.
Alias name of animal - 35 characters maximum.
Breed.DA3 Foreign Champions in the following order:
Actual name of animal in Breed.DA1.
Country of foreign championship. (repeated 25 times)
Breed.DA4 1st Supplemental Data in the following order:
Actual name of animal in Breed.DA1.
Country of import.
Registration number in original country.
Description of animal.
Name of breeder.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 30
Breed.DA5 2nd Supplemental Data in the following order:
Actual name of animal in Breed.DA1.
Clearance 1 data.
Clearance 2 data.
Clearance 3 data.
User Defined Field #3 Published - packed form.
User Defined Field #4 Published - packed form.
User Defined Field #5 Published - packed form.
User Defined Field #6 Published - packed form.
User Defined Field #7 Published - packed form.
User Defined Field #8 Published - packed form.
User Defined Field #9 Published - packed form.
User Defined Field #10 Published - packed form.
User Defined Field #11 Published - packed form.
User Defined Field #12 Published - packed form.
User Defined Field #13 Published - packed form.
User Defined Field #14 Published - packed form.
User Defined Field #15 Published - packed form.
User Defined Field #16 Published - packed form.
Breed.DA6 Comment data in the following order:
Actual name of animal in Breed.DA1.
First comment line.
Second comment line.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 31
LICENSE AGREEMENT
Terms and conditions of use:
All versions of PEDIGREE by Charles H. Orange are not public domain
software, nor are they free software.
Non-registered users are granted a limited license to use PEDIGREE on
a trial basis only for the purpose of determining it's suitability for
their needs. Use of PEDIGREE except for this limited purpose requires
registration. Non-registered versions of PEDIGREE are limited to only
300 animal entries.
Registration permits a user the license to use PEDIGREE 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. Registered versions of PEDIGREE support over 2 million
animal entries.
Terms and conditions of copying:
All users are granted a limited license to copy the non-regstered
version of PEDIGREE for the purpose of archive or backup protection as
well as for the trial use by others subject to the above limitations
and to the following restrictions:
Non-registered versions of PEDIGREE must be distributed in unmodified
form, complete with the help and text files with this license
information.
No fee or charge may be made by anyone beyond the reasonable cost of
duplication and media.
Non-registered versions of PEDIGREE may be distributed in an archived
format by operators of electronic bulletin boards if they observe the
previous conditions.
Versions of PEDIGREE with the license and Code Key installed may not
be copied except for the purpose of archive or backup protection.
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 32
Order Form
To register your copy of PEDIGREE, please fill in the information
below and send with $40.00 to:
Charles H. Orange
702 Maple Avenue
Downers Grove, Ill. 60515
Name _________________________________________ Circle Disk Size
Address ______________________________________ 3 1/2" 5 1/4"
______________________________________
City ____________________________ State _____ Zip __________
Registered users will receive the latest version on disk as well as
announcements of future upgrades and additional products as available.
The following is optional and for my information only.
Breed _________________________ Kennel Name _________________________
Please check here if I may give your name to other users in your breed
for the purpose of exchanging data files. _____(YES) _____(NO)
PEDIGREE (c) 1988-1991 Charles H. Orange Page: 33