home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / ped205.zip / PED205.EXE / PEDIGREE.DOC < prev    next >
Text File  |  1991-06-08  |  69KB  |  2,059 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                       /- PEDIGREE
  19.                           PEDIGREE ---|
  20.                                       \- PEDIGREE
  21.  
  22.  
  23.  
  24.                                Version 2.0x
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.     (C) 1988-1991 By Charles H. Orange
  43.                      702 Maple Avenue
  44.                      Downers Grove, Ill. 60515
  45.                      (708)964-8898
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.                                  INTRODUCTION
  53.  
  54.  
  55.     PEDIGREE is a program to keep track of dog pedigrees and American
  56.     Kennel Club Titles.  The original intent for writing this program was
  57.     to keep track of pedigree data for our own line of dogs only.  I soon
  58.     expanded it to maintain show title information and enlarged my data
  59.     file to include as many animals as possible in our breeds.  I wrote
  60.     the program to be flexible enough to allow historical data from old
  61.     books, foreign pedigrees and show catalogs to be used as well as the
  62.     American Kennel Club Stud Book and American Kennel Club Awards
  63.     periodicals.  I provided for the inclusion of customized titles or
  64.     awards in addition to the A.K.C. recognized awards.  The most recent
  65.     version includes provisions for customizing all title and award fields
  66.     to make the program useful in other countries.
  67.  
  68.     I am releasing this program for distribution as user supported
  69.     software subject to the license agreement at the end of this manual.
  70.     The non-registered version of the program will only support 300 animal
  71.     records.  There is a registration form in a separate file on the
  72.     distribution disk.  The registered version of the program will support
  73.     over 2 million animal records.  There is no difference between the
  74.     registered version and the non-registered version except for the limit
  75.     to the number of animal records.  I welcome all comments, suggestions
  76.     and ideas for improvements as well as reports of problems from users.
  77.     I will try to incorporate as many improvements as possible in future
  78.     releases.
  79.  
  80.     This program is not in the public domain and is not distributed as
  81.     free software.  You may use this product on a trial basis only in
  82.     order to determine it's suitability to your needs.  If you wish to
  83.     continue using the product on a regular basis, you must register by
  84.     sending $40.00 to the address listed below.  Registered users will
  85.     receive announcements of future upgrades and additional products as
  86.     available.
  87.  
  88.  
  89.                Charles H. Orange
  90.                702 Maple Avenue
  91.                Downers Grove, Ill. 60515
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 1
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.                                    OVERVIEW
  114.  
  115.  
  116.     PEDIGREE is a program to aid in the keeping of dog pedigree and title
  117.     records.  It consists of two basic parts, one to add or change
  118.     records, and one to create pedigrees and other useful reports.  A
  119.     complete description of each process is given in the following
  120.     sections.
  121.  
  122.     Reports generated include three to seven generation pedigrees, seven
  123.     generation line breeding lists, lines of descendancy and top producing
  124.     sire and dam lists.
  125.  
  126.     Data may be input from any number of sources.  The complete selection
  127.     of A.K.C. awards may be entered as well as data from other sources.
  128.     As new data is entered, it is checked against any data in the system.
  129.     Any discrepancies that are found will display an error message and the
  130.     new data will not replace the data already in the system.
  131.  
  132.     PEDIGREE is menu driven with a single letter required to move to an
  133.     item on a menu.  This choice may be a function of the program, or
  134.     another menu of items.  To exit to the previous menu, press the
  135.     <ESCAPE> key.  Help topics are available at all menus and at all
  136.     places requiring keyboard input.  Help is available by pressing the
  137.     function key <F1>.  An index of the major Help Topics is available by
  138.     pressing <F1> again.
  139.  
  140.          The program files are as follows:
  141.                PEDIGREE.EXE     the pedigree program itself.
  142.                PEDIGREE.HLF     the help file.
  143.  
  144.          Supplemental files for documentation and installation only:
  145.                PEDIGREE.DOC     this document file.
  146.                PEDIGREE.ORD     an order form for registration.
  147.                PEDIGREE.REV     list of revision level changes.
  148.                PED1SEQ.EXE      conversion program from version 1 files.
  149.                PED1SEQ.DOC      instructions for PED1SEQ.EXE conversion.
  150.                README.1ST       quick start instructions.
  151.  
  152.          The data files are created as follows:
  153.                Breed.P00        the breed setup file.
  154.                Breed.P01        the main database file.
  155.                Breed.P02        the name index file.
  156.                Breed.P03        the sire index file.
  157.                Breed.P04        the dam index file.
  158.                Breed.P05        the alias name file.
  159.                Breed.P06        the alias index file.
  160.  
  161.                Breed.TXT        text file output for other programs.
  162.  
  163.  
  164.  
  165.  
  166.  
  167.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 2
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.                              SYSTEM REQUIREMENTS
  175.  
  176.  
  177.          Computer: IBM PC or compatible with at least 384k memory.  A hard
  178.                    disk is preferred as the data files require a mimimum
  179.                    of 190 bytes per animal to a maximum of 320 bytes.  A
  180.                    data file of fewer than 1100 animals could fill a 360k
  181.                    disk.
  182.  
  183.           Printer: Any printer should work.  A printer that supports the
  184.                    IBM extended character set can print pedigrees with
  185.                    lines connecting related animals.  In printing a
  186.                    listing of the complete data file, a printer capable of
  187.                    printing 160 characters on a line may be utilized to
  188.                    print on fewer pages.  Printer definition codes may be
  189.                    entered when the program is run.  The default settings
  190.                    are for Epson printers.
  191.  
  192.           Monitor: Any monitor that supports IBM monochrome displays may
  193.                    be used.  Color is supported but not required for the
  194.                    program to operate.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 3
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                                GETTING STARTED
  236.  
  237.  
  238.     The first step to running PEDIGREE is to make a back-up copy of the
  239.     disk.  Consult your DOS manual for any details of the copy process
  240.     that you are not sure about.  Take your original disk and put it away
  241.     in a safe place.
  242.  
  243.     The steps below which refer to installing PEDIGREE on a hard disk may
  244.     have been completed during the process of unarchiving the program and
  245.     this file from the distribution floppy disk.  If that is the case,
  246.     skip to the section on changing the file named CONFIG.SYS.
  247.  
  248.     If you are using a computer without a hard disk, copy the files
  249.     PEDIGREE.EXE and PEDIGREE.HLF onto a separate floppy disk.  This will
  250.     become your working disk.  If you only have one floppy disk drive, it
  251.     is advisable to delete the file PEDIGREE.HLF from the working disk
  252.     only to conserve space for data files.  You will then have to refer to
  253.     this manual in place of using the help screens from within the
  254.     program.
  255.  
  256.     If you are using a computer with a hard disk, create a directory on
  257.     that disk named \PEDIGREE.  The pedigree program and the help file
  258.     should be located in the same directory.  Copy the files PEDIGREE.EXE
  259.     and PEDIGREE.HLF from the distribution disk into the directory that
  260.     you just created.
  261.  
  262.     Change the file CONFIG.SYS on your boot disk to include the following
  263.     lines:
  264.  
  265.                buffers=20
  266.                files=20
  267.  
  268.     Any number for files or buffers equal or greater than twenty is
  269.     acceptable.  If no CONFIG.SYS file exists on your boot disk, then
  270.     consult your DOS manual for instructions on creating text files using
  271.     the COPY command from the keyboard.
  272.  
  273.     For advanced DOS users, with DOS version 3.0 or greater, the
  274.     PEDIGREE.EXE file may be either in the current directory or in the DOS
  275.     Path.  The PEDIGREE.HLF file must be either in the current directory,
  276.     or in the same directory as PEDIGREE.EXE.
  277.  
  278.     Change drives and directories to the one that contain your working
  279.     copies of PEDIGREE.EXE and PEDIGREE.HLF or to the directory where you
  280.     want the breed data files to be stored.  You are now ready to run the
  281.     program.
  282.  
  283.     Start PEDIGREE by typing PEDIGREE <RETURN>.  After you have read the
  284.     introductory screen, press any key to be prompted for a breed name.
  285.     The breed name will become the name of the files created by the
  286.     computer.  If a name longer than 8 characters is used, only the first
  287.  
  288.  
  289.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 4
  290.  
  291.  
  292.  
  293.     8, or up to the first space in the name will be used for the file
  294.     names.  If the breed name entered is found on the disk, the existing
  295.     files are opened.  If the name is not found, confirmation is required
  296.     before new data files are created.  Alternatively, you may enter the
  297.     breed name on the command line after the word PEDIGREE.
  298.  
  299.     If this is the first time you are using this breed, a message will
  300.     state that no database exists and prompt for creation of a new one.
  301.     Answering 'Y' to this question will start the creation of new breed
  302.     files.  The first step in creating new breed data files is to answer
  303.     the question about redefining the A.K.C. awards.  For United States
  304.     users who are working with American Kennel Club registered dogs, this
  305.     should be answered 'N'.  Users from other countries or those with dogs
  306.     registered with other kennel clubs should answer 'Y'.  Customization
  307.     of titles and certifications is performed next.  These may be changed
  308.     at any time and are fully described in the section labeled
  309.     'Supplemental Title Definition'.
  310.  
  311.     After completing the customization of titles, the main menu will
  312.     appear.  The functions will be described in the remaining sections of
  313.     this manual except for the Exit function, which saves your data,
  314.     closes all files and ends the program.  Always exit the program before
  315.     turning off your computer as valuable data may be lost otherwise.
  316.  
  317.     If the display on a monochrome monitor or laptop computer is not clear
  318.     because of color selection, the program may be started with a command
  319.     line parameter of '/m' to force monochrome output.  This should
  320.     increase legibility on laptop displays.
  321.  
  322.  
  323.  
  324.                           ACCESSING THE HELP SYSTEM
  325.  
  326.     When the program is started a message appears on the lower center of
  327.     the screen to show whether help is available or not.  If the help file
  328.     is not found, the message will say 'Help File PEDIGREE.HLF not found.'
  329.     If the help file is found, the message will say 'Press <F1> for help.'
  330.     If help is available, the help system may be activated at any time by
  331.     pressing the <F1> key.  The first help message will be information
  332.     concerning the current menu command or required input line.  If the
  333.     help for the current topic requires more than one screen for display,
  334.     a message will appear in the lower border for <PgUp>/<PgDn> for more
  335.     help.  An index of help topics may be obtained by pressing <F1> again.
  336.     Further topics may be selected from this index by using the cursor
  337.     keys to position the highlite over the topic and pressing <Return>.
  338.     The help system may be exited by pressing <Escape> at any time.
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 5
  351.  
  352.  
  353.  
  354.  
  355.  
  356.                             CONVENTIONS FOR INPUT
  357.  
  358.     SELECTING MENU ITEMS
  359.     Menu items may be selected by pressing the highlighted letter, or
  360.     using the <Up Arrow> or <Down Arrow> key to highlight the item and
  361.     pressing the <Return> key.
  362.  
  363.  
  364.     KEYBOARD ENTRY EDITING
  365.  
  366.                              edit keys available:
  367.  
  368.     <Escape> ...................... abort the entry with no changes.
  369.     <Insert>, Ctrl-V .............. toggle insert/overwrite mode.
  370.     <Back Space>, Ctrl-H .......... delete character left of cursor.
  371.     <Delete>, Ctrl-G .............. delete the character under the cursor.
  372.     Ctrl-Y ........................ delete the entire field.
  373.     <Left Arrow>, Ctrl-S .......... move 1 character left in field.
  374.     <Right Arrow>, Ctrl-D ......... move 1 character right in field.
  375.     Home .......................... move to beginning of field.
  376.     End ........................... move to end of field.
  377.     <Return>, <Tab> ............... accept input from field.
  378.  
  379.     The following edit keys are available for multiple field editing:
  380.  
  381.     <Return>, <Tab> ............... move to next field.
  382.     Shift-<Tab> ................... move to previous field.
  383.     Ctrl-<Home> ................... move to first field.
  384.     Ctrl-<End> .................... move to last field.
  385.     <F10> ......................... accept all fields on screen.
  386.  
  387.     Other edit keys will be displayed in the border when available.
  388.  
  389.     Whenever keyboard input is required for multiple fields on a screen,
  390.     the only ways to exit the input mode are to press the <F10> key or one
  391.     of the keys displayed in the border to accept the entry, or press the
  392.     <Escape> key to discard the entry.  The <Return>, <Tab>, or Shift-
  393.     <Tab> keys will only move from one field to the next without accepting
  394.     the inputs.  When keyboard input is required for only one field, the
  395.     <Return> key will accept the input.
  396.  
  397.     Insert mode of keboard operation is the default.  When overwrite mode
  398.     is toggled on, the cursor appears as a fat block instead of an
  399.     underline.
  400.  
  401.  
  402.     MOUSE USAGE
  403.     If a mouse is present, the program will respond to it's usage.  The
  404.     mouse may select a menu item by moving the mouse cursor over an entry
  405.     and pressing the left mouse button to select.  The right button acts
  406.     like the <Escape> key.  Entry fields may be selected for input by
  407.     selecting in the same manner.  Pressing the right button will discard
  408.     the present entry.  Pressing both mouse buttons together act like
  409.  
  410.  
  411.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 6
  412.  
  413.  
  414.  
  415.     pressing the <F10> key.  Multiple selection items may be selected by
  416.     two clicks of the left mouse button.
  417.  
  418.  
  419.     INPUT FIELDS
  420.     Where text or numerical inputs are required, they take the following
  421.     form:
  422.  
  423.     The entry length is limited to the size of the highlighted underline.
  424.     Date fields are forced into the proper format.  Alphabetic input is
  425.     rejected if numeric input is required.
  426.  
  427.  
  428.     AKC NUMBER
  429.     The AKC number is input with a two letter prefix followed by a 6 digit
  430.     number.  With newer numbers, the number is a litter number followed by
  431.     a slash and a number from 0 to 99.  Either upper case or lower case
  432.     may be used.  If there is only one letter in the prefix, use a '-' in
  433.     place of the second letter.
  434.  
  435.  
  436.     ALIAS NAME
  437.     A field for an additional name by which a specific animal is known.
  438.     The same limits apply as to the animal's registered name.
  439.  
  440.  
  441.     ANIMAL REGISTERED NAME
  442.     The registered name of the animal in question.  Do not include any
  443.     Championship or Obedience Titles.  Length is limited to 35 characters
  444.     including spaces and punctuation.
  445.  
  446.  
  447.     ANIMAL SEX
  448.     For dogs use 'M' or 'D'.         For bitches use 'F' or 'B'.
  449.  
  450.     Either upper case or lower case may be used.  If sex is not known, use
  451.     either a <SPACE> or a <RETURN>.  Any other character will be ignored.
  452.  
  453.  
  454.     BIRTH DATE
  455.     The month, day and year inputs should be in the format of a one or two
  456.     digit month followed by any of '/', '-', '.', or space followed by a
  457.     one or two digit day followed any of '/', '-', '.', or space followed
  458.     by the year.  The year may be two or four digits.  If only two digits,
  459.     the year is assumed to be in the 20th century (eg. 88 becomes 1988).
  460.  
  461.          The following are all acceptable examples:
  462.           05/03/87     5/3/1987     5-03-87     05,03,1987     5 3 87
  463.  
  464.  
  465.     BREED NAME
  466.     The first word of the breed name (up to 8 characters) will become the
  467.     name of the files created by the computer.  The entire breed name will
  468.     be used for titles to some reports.  If records for more than one
  469.     breed are to be kept on the same disk, be certain that the first word
  470.  
  471.  
  472.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 7
  473.  
  474.  
  475.  
  476.     in each name is different.  If the name is found on the disk, the
  477.     existing files are opened.  If the name is not found, confirmation is
  478.     required before new data files are created.
  479.  
  480.     The breed name may also be included as a parameter on the command line
  481.     when starting the program.
  482.  
  483.  
  484.     BREEDER NAME
  485.     An unformatted field for the name of the breeder/owner of the animal.
  486.  
  487.  
  488.     COMMENT
  489.     An unformatted field for any comments about the animal.
  490.  
  491.  
  492.     COUNTRY NAMES
  493.     The input of an abbreviation for a country name is required.
  494.     Suggested abbreviations are the ones used by the International Olympic
  495.     Committee.
  496.  
  497.         AFG  Afghanistan     GBR  Great Britain   NOR  Norway
  498.         ALG  Algeria         GDR  East Germany    NZL  New Zealand
  499.         AND  Andorra         GRE  Greece          PAK  Pakistan
  500.         ANG  Angola          GUA  Guatemala       PAN  Panama
  501.         ARG  Argentina       GUI  Guinea          PER  Peru
  502.         AUS  Australia       GUY  Guyana          POL  Poland
  503.         AUT  Austria         HOL  Netherlands     POR  Portugal
  504.         BAH  Bahamas         HUN  Hungary         PKR  North Korea
  505.         BAR  Barbados        INA  Indonesia       PUR  Puerto Rico
  506.         BEL  Belgium         IND  India           QAT  Qatar
  507.         BEN  Benin           IRL  Ireland         ROM  Romania
  508.         BER  Bermuda         IRQ  Iraq            SAU  Saudi Arabia
  509.         BIR  Burma           ISL  Iceland         SEN  Senegal
  510.         BOT  Botswana        ISR  Israel          SEY  Seychelles
  511.         BRA  Brazil          ITA  Italy           SLE  Sierra Leone
  512.         BUL  Bulgaria        JAM  Jamaica         SMR  San Marino
  513.         CAN  Canada          JOR  Jordan          SRI  Sri Lanka
  514.         CGO  Congo           KEN  Kenya           SUD  Sudan
  515.         CHI  Chile           KOR  South Korea     SUI  Switzerland
  516.         CHN  China           KUW  Kuwait          SWE  Sweden
  517.         CIV  Ivory Coast     LAO  Laos            SYR  Syria
  518.         CMR  Cameroun        LBA  Lybia           TAN  Tanzania
  519.         COL  Columbia        LES  Lesotho         TCH  Czechoslovakia
  520.         CRC  Costa Rica      LIB  Lebanon         THA  Thailand
  521.         CUB  Cuba            LIE  Liechtenstein   TPE  Chinese Taipei
  522.         CYP  Cyprus          LUX  Luxembourg      TRI  Trinidad and
  523.         DEN  Denmark         MAD  Madagascar            Tobago
  524.         DJI  Djibouti        MAL  Malaysia        TUR  Turkey
  525.         DOM  Dominican       MAR  Morocco         UGA  Uganda
  526.               Republic       MEX  Mexico          URS  U.S.S.R.
  527.         ECU  Ecuador         MGL  Mongolia        USA  United States
  528.         EGY  Egypt           MLI  Mali            VEN  Venezuela
  529.         ESP  Spain           MLT  Malta           VIE  Vietnam
  530.         ETH  Ethopia         MOZ  Mozambique      YUG  Yugoslavia
  531.  
  532.  
  533.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 8
  534.  
  535.  
  536.  
  537.         FIN  Finland         NCA  Nicaragua       ZAM  Zambia
  538.         FRA  France          NEP  Nepal           ZIM  Zimbabwe
  539.         FRG  West Germany    NGR  Nigeria
  540.  
  541.  
  542.     DATA RELIABILITY
  543.     The data reliability number is a number between 0 and 255.  The higher
  544.     the reliability of the source of data, the lower the number should be.
  545.     Any data input from an official AKC publication automatically has a
  546.     reliability number of 0.  The entries created for sires or dams will
  547.     start out with a reliability of 255.  Numbers between should be used
  548.     for other data sources.  Consistency should be maintained to keep
  549.     track of data sources.  This should enable back-tracking in the event
  550.     of conflicting data from different sources.
  551.  
  552.  
  553.     DESCRIPTION
  554.     An unformatted field for any descriptive data.
  555.  
  556.  
  557.     FILE PATH
  558.     A valid path to a directory or subdirectory is required.  The
  559.     directory and drive must both exist.  A blank entry will use the
  560.     current directory.  A single character is valid as a root directory on
  561.     that drive.  The trailing '\' is not necessary.
  562.  
  563.     Valid examples are:
  564.                    A:
  565.                    A:\
  566.                    b:\terriers
  567.                    b:\TERRIERS\MYDOGS\
  568.  
  569.  
  570.     KENNEL NAME
  571.     The input consists of a string to be searched for within animal name.
  572.     This string may be either a whole word or characters included within
  573.     longer words.  Punctuation is ignored, but spaces between words are
  574.     significant.
  575.  
  576.  
  577.     NUMBER INPUT
  578.     The input of a whole number is required.  Digits 1 through 9 and 0 are
  579.     the only acceptable input keys.  A <RETURN> is required to end the
  580.     input.  An error message will be displayed on the bottom screen line
  581.     if the entry is not within the acceptable range.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 9
  595.  
  596.  
  597.  
  598.     PUBLISHED DATE
  599.     The month and year inputs should be in the format of a one or two
  600.     digit month followed by any of '/', '-', '.', or space followed by the
  601.     year.  The year may be two or four digits.  If only two digits, the
  602.     year is assumed to be in the 20th century (eg. 87 becomes 1987).  If
  603.     the month is not known, enter 00/87 for any time in 1987.  If a title
  604.     is known to exist but no date is known, enter y or yes.
  605.  
  606.          The following are all acceptable examples:
  607.           05/87    5/87    05/1987    5-87    5,87    5 87    05 1987
  608.  
  609.  
  610.     REGISTRATION NUMBER
  611.     The registration number may be input in this field.  As there are
  612.     differing registration number-letter sequences in different countries,
  613.     there are no checks to determine proper format for this field.
  614.  
  615.  
  616.     TITLE ABBREVIATIONS
  617.     The abbreviation for Titles should be limited to 4 characters.
  618.     Abbreviations will be attached to the animal's name on reports.
  619.  
  620.  
  621.     TITLE DEFINITIONS
  622.     The proper name for a Title should be limited to 30 characters.  Some
  623.     examples are:
  624.  
  625.          Champion of Record
  626.          Certificate of Gameness
  627.          Working Certificate
  628.          Register of Merit.
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 10
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                               ADD or REVISE DATA
  663.  
  664.  
  665.     Selecting 'ADD or REVISE DATA' will bring up another menu showing
  666.     choices for adding, revising or deleting records from the main
  667.     database; as well as choices for adding or deleting foreign champion
  668.     data and alias names.  Two selections for reorganizing the database
  669.     and creating sequential file output are described in detail in the
  670.     section on Data File Management.
  671.  
  672.  
  673.                Add New Entries To Database:
  674.  
  675.     If the A.K.C. titles have been left unchanged, the selection of 'Add
  676.     New Entries' will display a list of possible sources for new data.  If
  677.     the titles have been modified, the selection of 'Add New Entries' will
  678.     be identical to adding data from other sources below.  If the animal
  679.     is found in the data file then only blank fields  will be available
  680.     for input.  When inputs are from A.K.C. publications, the date of the
  681.     publication will be required before the animal entry screen is
  682.     displayed and only fields that are in the A.K.C. publication will be
  683.     available for input.
  684.  
  685.     Inputs may come from the following sources:
  686.  
  687.                From AKC Stud Book
  688.                Championships From AKC Gazette
  689.                CD Titles From AKC Gazette
  690.                CDX Titles From AKC Gazette
  691.                UD Titles From AKC Gazette
  692.                TD Titles From AKC Gazette
  693.                TDX Titles From AKC Gazette
  694.                OTCH Titles From AKC Gazette
  695.                AFC Titles From AKC Gazette
  696.                FC Titles From AKC Gazette
  697.                JH Titles From AKC Gazette
  698.                SH Titles From AKC Gazette
  699.                MH Titles From AKC Gazette
  700.                Data From Other Sources
  701.  
  702.     Data From Other Sources includes such items as records of the
  703.     customized titles or data from pedigrees and other publications.  A
  704.     default data reliability is entered for this entry session.  The data
  705.     reliability entry should reflect the confidence in the accuracy of the
  706.     source of data.  A lower number for reliability indicates a lower
  707.     chance of bad data.  If the animal is found in the data file, then
  708.     only blank fields will be available for input.  All empty data fields
  709.     are available for input.
  710.  
  711.     There is a second chance to ignore data that has just been entered.
  712.     After all fields have been entered, the cursor will move to the first
  713.     highlighted field on the screen.  The cursor may be moved to any field
  714.  
  715.  
  716.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 11
  717.  
  718.  
  719.  
  720.     available for input at any time.  This allows for corrections and
  721.     additions to the data.  If there are any errors in the data fields,
  722.     pressing the <Escape> key will erase the screen and start over.
  723.     Pressing the <F10> key will accept the data as shown.  For entries
  724.     made using 'Data From Other Sources' there will be four additional
  725.     function key choices highlited in the lower screen border.  These
  726.     choices will allow immediate addition of data about an animal's sire
  727.     or dam, or the addition and revision of foreign data or supplemental
  728.     information about the animal.
  729.  
  730.  
  731.                Revise An Entry:
  732.  
  733.     The selection of 'Revise an Entry' will request an animal name for
  734.     data revision.  All fields of data may be revised.  Care should be
  735.     taken for it is possible to revise not only an animal's name, but to
  736.     change the names of the animal's sire and dam.  If there are any
  737.     errors in data revised, pressing the <Escape> key will erase the
  738.     screen and start over.  Pressing the <F10> key will accept the input
  739.     data as shown.  There will be four additional function key choices
  740.     highlited in the lower screen border.  These choices will allow
  741.     immediate addition or revision of data about an animal's sire or dam,
  742.     or the addition or revision of foreign data or supplemental
  743.     information about the animal.
  744.  
  745.  
  746.                Delete An Entry:
  747.  
  748.     The selection of 'Delete an Entry' will allow an entry to be removed
  749.     from the data file or exchanged for another if duplicate entries have
  750.     been made with misspellings of name.  Confirmation will be requested
  751.     before any action is taken.  If a replacement name is specified, the
  752.     data on the two records will be combined in the record for the
  753.     replacement name.  Records for all offspring will be changed to show
  754.     the replacement name as parent.  If there is any conflicting data an
  755.     error message will be displayed and no changes will be made.
  756.  
  757.  
  758.                Enter Foreign Champion Data:
  759.  
  760.     Foreign Champion data is entered from a second screen selected after
  761.     entering data or revising an entry.  This screen is available when the
  762.     prompt is displayed in the lower border.
  763.  
  764.     Foreign Champion Entries may be entered with an abbreviation for the
  765.     country.  This will allow limited record keeping of animals with
  766.     foreign titles.  There are positions for up to 25 abbreviations of
  767.     foreign country names.
  768.  
  769.     Foreign Champion Entries made by mistake may be removed from the data
  770.     file.  The country should be deleted from the field with either a
  771.     Control-Y at the beginning of the field or repeated use of the
  772.     <DELETE> key.  If all Foreign Champion Entries for the animal have
  773.     been deleted, the foreign record will be deleted from the database.
  774.  
  775.  
  776.  
  777.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 12
  778.  
  779.  
  780.  
  781.  
  782.                Enter Alias Name Data:
  783.  
  784.     The selection of 'Enter Alias' name data will allow a second name to
  785.     be entered or deleted for an animal.  This is useful for an imported
  786.     animal that has a different registered name in another country.  The
  787.     entry in the data file should be the name by which the animal is
  788.     registered with the A.K.C. while the alternate name or names used are
  789.     added here.  Alias names may also be added from the supplemental data
  790.     screen after entering or revising animal data.  Alias names are not
  791.     displayed in any way.  They are used only for determining the
  792.     registered name of an animal.
  793.  
  794.  
  795.                Reorganize Datafile:
  796.  
  797.     The selection of 'Reorganize the Datafile' will be useful if some of
  798.     the index files have been damaged by a power failure or through some
  799.     fault.  The possibility of this may be reduced by keeping regular back
  800.     up disks of data files.
  801.  
  802.  
  803.                Sequential File Processing:
  804.  
  805.     'Sequential File Processing' will be used to import or export data for
  806.     other programs.  Currently, no other programs have been written to
  807.     take advantage of this feature.  A valid drive or directory entry is
  808.     required to find the sequential ASCII files for data transfer.
  809.     Appendix A describes the structure of the sequential files created.
  810.     These files may be directly imported into a word processor or
  811.     commercial data base manager if desired.  This sequential file
  812.     processing feature is used as described in Appendix B for the transfer
  813.     of files from version 1.10 of PEDIGREE into this version.
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 13
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                                GENERATE REPORTS
  846.  
  847.  
  848.     The selection of 'Generate Reports' will allow the making of pedigrees
  849.     and other useful information for breeding selection.  The entire data
  850.     file and an alphabetical list of registered names also may be printed.
  851.     The program checks to make certain that the printer is turned on
  852.     before any data is printed.  An error message will appear if the
  853.     printer is not ready.  Simply correct the problem and press any key to
  854.     continue.  The following is a descriptive list of the available
  855.     reports:
  856.  
  857.  
  858.                Create Pedigree:
  859.  
  860.     A 3 generation pedigree may be displayed on the screen, or a pedigree
  861.     with between 3 and 7 generations may be printed.  A menu with the
  862.     selection of these options will appear.
  863.  
  864.     A pedigree with a blank line for later filling in of the animal's name
  865.     can be made by using an asterisk (*) in place of the name.  This
  866.     allows for creating a pedigree for a yet unregistered puppy.  Proposed
  867.     breedings can be seen by filling in a fictitious name and then
  868.     answering the requests for sire and dam.
  869.  
  870.     Three and four generation pedigrees will be printed on the top half of
  871.     a sheet of paper.  Five generation pedigrees will fill an entire
  872.     sheet.  Six and seven generation pedigrees will spill over onto the
  873.     next sheet and probably will not be very neat nor easy to read.
  874.  
  875.     Extended data may be printed on the pedigree.  This extended data
  876.     consists of all titles which are defined as printing under an animal's
  877.     name, any data in the three information fields and the description
  878.     from the supplemental data input screen.  The extended data may be
  879.     printed for all animals which are in the pedigree, or for only the
  880.     main animal.
  881.  
  882.  
  883.                Line Breeding List:
  884.  
  885.     A line breeding list is a listing of the ancestors in the previous 7
  886.     generations.  Each animal is listed only once with a key to the
  887.     generations and frequencies of appearance in the pedigree.  A line
  888.     breeding list may be printed sorted either by genetic weight of the
  889.     ancestors or by frequency of appearance in the background.  The line
  890.     breeding list shows the generations in which an animal appears with
  891.     the sire's side on the left and the dam's side on the right of a
  892.     decimal point.  For example:
  893.  
  894.          14.062%  CH Back Ancestor (7557.4)
  895.  
  896.     implies that CH Back Ancestor appears in the 7th generation twice, and
  897.  
  898.  
  899.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 14
  900.  
  901.  
  902.  
  903.     in the 5th generation twice on the sire's side of the pedigree; and in
  904.     the 4th generation once on the dam's side of the pedigree.
  905.  
  906.     The percentage of genetic contribution which an animal provides in all
  907.     generations is listed.  The percentage in the above example is
  908.     calculated as follows:
  909.  
  910.        seventh generation: 128 ancestors > 1/128 * 2 appearances = .01562
  911.        sixth generation:    32 ancestors > 1/32  * 2 appearances = .06250
  912.        fifth generation:    16 ancestors > 1/16  * 1 appearance  = .06250
  913.        Total genetic contribution for all generations            = .14062
  914.  
  915.     The number of ancestors not included in the report is printed.
  916.  
  917.     The total genetic contribution of each generation must total 100%.
  918.     Because of this, the total for all 7 generations will add up to 700%.
  919.     This will explain why an animal may contribute more than 50% of the
  920.     genetic background through appearance in more than one generation.
  921.  
  922.     Extended data may be printed on the line breeding list.  This extended
  923.     data consists of all titles which are defined as printing under an
  924.     animal's name, any data in the three information fields and the
  925.     description from the supplemental data input screen.  The extended
  926.     data may be printed for all animals which are in the pedigree, or for
  927.     only the main animal and it's sire and dam.
  928.  
  929.  
  930.                Top Producing List:
  931.  
  932.     A list of sires or dams with the highest number of titled offspring
  933.     may be produced.  The minimum number of titled offspring for inclusion
  934.     on the list must be specified.  This number must be one or greater in
  935.     order to produce a report.  The titles to be used must be selected
  936.     from the displayed list.  Select the titles by moving the cursor with
  937.     the cursor control keys and press <SPACE> to select or deselect a
  938.     title.  At least one title must be selected.  The list will be sorted
  939.     from highest to lowest number of titled offspring produced.  The
  940.     number in parenthesis is the number of titled offspring.  If only one
  941.     title has been selected then the listing for each offspring contains
  942.     the animal's sex and the publication date of the the title.  The
  943.     offspring are listed in order of birth date.
  944.  
  945.  
  946.                Descendant List:
  947.  
  948.     A list of descendants from an animal may be produced.  The list can
  949.     either include all descendants or only continuous lines of titled
  950.     descendancy.  The titles to be used must be selected from the
  951.     displayed list.  Select the titles by moving the cursor with the
  952.     cursor control keys and press <SPACE> to select or deselect a title.
  953.     If no titles are selected then all offspring will be included.  The
  954.     generation appears in parenthesis before each animal's name.  The sex
  955.     of each animal appears at the right of the line.  If the list was
  956.     requested only to contain continuous title lines for only one title,
  957.     the issue date of the title is also on the right of the entry.
  958.  
  959.  
  960.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 15
  961.  
  962.  
  963.  
  964.  
  965.     The list may include the opposite parent's name along with the name of
  966.     each descendant if desired.  If this name is included, the date of the
  967.     animal's title or the sex of the animal will not appear.
  968.  
  969.     The length of the list may be limited by requesting only those animals
  970.     within a specific number of generations be considered for inclusion.
  971.     This will be helpful for producing descendant lists of animals who are
  972.     top producers when only the first few generations are relevant as it
  973.     considerably reduces the time and paper consumed.
  974.  
  975.     Extended data may be printed on the descendant list.  This extended
  976.     data consists of all titles which are defined as printing under an
  977.     animal's name, any data in the three information fields and the
  978.     description from the supplemental data input screen.
  979.  
  980.  
  981.                List Datafile:
  982.  
  983.     The contents of the data file may be printed in sequential format.
  984.     The listing will include all data entered for every animal in the
  985.     database.
  986.  
  987.     Titles and their dates will be enclosed in brackets, and up to four
  988.     lines will be used if there is any supplemental information or com-
  989.     ments about an animal.
  990.  
  991.  
  992.                List Names In Alphabetical Order:
  993.  
  994.     An alphabetical index of animals in the data file may be printed.
  995.     This list contains a cross-reference number to the entry in the
  996.     complete data file.
  997.  
  998.     The format will be as follows:
  999.  
  1000.  
  1001.         1701 $ Animal Name A               300 # Animal Name C
  1002.           31 * Animal Name B              5122   Animal Name D
  1003.  
  1004.     The symbols between the number and the name indicate the following:
  1005.  
  1006.          $  Birth date and Sex of animal are known
  1007.          #  Sire and Dam of animal are known
  1008.          *  Sire, Dam, Birth date, and Sex of animal are known
  1009.  
  1010.     The listing will be in three columns on paper if the printer setup has
  1011.     been specified that 160 characters may be printed on one line.  If 160
  1012.     characters per line is not available, the page will contain only two
  1013.     columns.  Output to the screen will be one column wide.
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 16
  1022.  
  1023.  
  1024.  
  1025.                Statistical Summary:
  1026.  
  1027.     This selection will count the entries in the data file and report on
  1028.     the number of animals in each category.
  1029.  
  1030.  
  1031.                Search for Kennel Name
  1032.  
  1033.     This selection will list all animals whose names have a word or kennel
  1034.     name in common.  Any string of letters and spaces in the database of
  1035.     animal names may be searched for.  Be cautious of searching for too
  1036.     short of a word or part of a word because of the large number of names
  1037.     which might be selected.
  1038.  
  1039.     An example of a string of characters to search might be 'Jones'.  This
  1040.     will find the following names:
  1041.                Best of Jones
  1042.                Jonestown Better
  1043.                J'Ones Greatest
  1044.  
  1045.     This will not find the following names:
  1046.                J' Ones Greatest
  1047.                Jon Estimate
  1048.  
  1049.  
  1050.                Find Comment Text
  1051.  
  1052.     This selection will list all animals that have a comment record which
  1053.     contains the text specified.  Any combination of letters and spaces in
  1054.     the comment field of an animal record may be searched for.  The search
  1055.     may be specified to be insensitive to upper/lower case letters, or
  1056.     look for an exact match by case.  Be cautious of searching for too
  1057.     short of a word or part of a word because of the large number of names
  1058.     which might be selected.  Since the file is not indexed on the comment
  1059.     field, this search must read the entire data file looking for the
  1060.     specified text.  This is a time consuming operation in direct propor-
  1061.     tion to the number of animals in the data file.
  1062.  
  1063.  
  1064.                Search for Breeder Name
  1065.  
  1066.     This selection will list all animals whose breeder name has a word or
  1067.     name in common.  Any string of letters and spaces in the database of
  1068.     breeder name may be searched for.  Be cautious of searching for too
  1069.     short of a word or part of a word because of the large number of names
  1070.     which might be selected.  Since the file is not indexed on breeder
  1071.     name, this search must read the entire data file looking for the
  1072.     specified text.  This is a time consuming operation in direct propor-
  1073.     tion to the number of animals in the data file.
  1074.  
  1075.  
  1076.                Redirect Printer Output:
  1077.  
  1078.     This selection will redirect output between the printer, a text file
  1079.     on the disk, and the screen.  The text file will contain all data that
  1080.  
  1081.  
  1082.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 17
  1083.  
  1084.  
  1085.  
  1086.     would normally be sent to the printer except for printer control
  1087.     commands.  This is a plain ASCII text file suitable for inclusion into
  1088.     word processor files or other programs.  The text file will have the
  1089.     name 'Breed.TXT' and will be appended to with new text every time the
  1090.     output is redirected to the file.  Output sent to the screen might
  1091.     wrap to the next line if there are too many characters to display on
  1092.     one line.  The output may be switched between printer, text file, and
  1093.     screen as often as desired.  Output will be sent to the printer at the
  1094.     start of the program.  When output is sent to the screen, there will
  1095.     be a pause after every screen full of new information.  Press any key
  1096.     to continue with the report, or <Escape> to exit back to the menu
  1097.     item.
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 18
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.                           SETUP PROGRAM INFORMATION
  1151.  
  1152.  
  1153.     The selection of Setup Program Information will allow you to setup the
  1154.     control codes required for your printer, unlock your registered
  1155.     version of PEDIGREE, define the titles and awards for inclusion in the
  1156.     datafile, and setup the screen colors for your monitor.
  1157.  
  1158.  
  1159.                Printer Setup
  1160.  
  1161.     To set up your printer for proper operation of PEDIGREE, you will need
  1162.     to refer to the printer operator's manual or programmer's guide.  You
  1163.     will need to determine the correct codes necessary to configure the
  1164.     printer to perform and to cancel the following operations:
  1165.  
  1166.                12 character per inch printing
  1167.                8 lines per inch printing
  1168.                160 characters per line
  1169.                letter quality printing
  1170.                enhanced or bold type
  1171.  
  1172.     If your printer is not capable of supporting any of these, the program
  1173.     will still run, but the output will not be as neat as it could be.
  1174.  
  1175.     The program initially configures the printer as using the Epson
  1176.     character set for printer controls.  The first time the program is
  1177.     run, the printer configuration process should be done.  Answering yes
  1178.     to the question of reset to default codes will restore the program to
  1179.     these Epson style control codes.  If you know what the proper codes
  1180.     for your printer are, you may enter them.  At any time the printer may
  1181.     be set up again through the main menu function C.
  1182.  
  1183.     Non-printable control codes are input as a back slash '\' followed by
  1184.     a 3 digit decimal number only.  For example, an ESCAPE code is entered
  1185.     as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
  1186.  
  1187.     The following sequence is used in defining a printer:
  1188.  
  1189.  
  1190.                Maximum Line Length:
  1191.  
  1192.     For printing the entire contents of the database and the contents of
  1193.     the alphabetical index to the database, the program will utilize a
  1194.     line length of 160 characters.  If the printer is not capable of
  1195.     printing 160 characters on one line then these two report formats will
  1196.     print out on multiple lines.  The questions about condensed print mode
  1197.     are asked only if the printer is capable of printing 160 characters
  1198.     per line.
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 19
  1205.  
  1206.  
  1207.  
  1208.                IBM Character Set Compatibility:
  1209.  
  1210.     For printing pedigrees with a graphic tree structure, a printer with
  1211.     the IBM Extended Character set is required.  If the printer is not
  1212.     capable of this, then pedigrees will be printed without a line tree.
  1213.  
  1214.  
  1215.                Set Left Margin Indentation
  1216.  
  1217.     The left margin defaults to 10 character indent.  This is a good value
  1218.     to use if the printer is set up to print at the very left edge of the
  1219.     page.  If the printer is set to include a margin automatically, this
  1220.     value should be reduced or set to zero.
  1221.  
  1222.  
  1223.                Set Condensed Print Mode:
  1224.  
  1225.     Some printers are capable of using a wide sheet of paper to print
  1226.     lines of 160 characters.  If the printer is like this, the current
  1227.     input line should be cleared.  Other printers will require a sequence
  1228.     of characters to set a condensed print mode.
  1229.  
  1230.  
  1231.                Reset From Condensed Print Mode:
  1232.  
  1233.     If printer codes were not used to set condensed mode then the current
  1234.     input line should be cleared.  Other printers will require a sequence
  1235.     of characters to reset from condensed print mode.
  1236.  
  1237.  
  1238.                Set Lines Per Page:
  1239.  
  1240.     When the printer is set up for wide sheets of paper, the number of
  1241.     lines per page may not be the standard 66.  In this case, enter the
  1242.     actual number of lines on the page.
  1243.  
  1244.  
  1245.                Set 12 Characters Per Inch:
  1246.  
  1247.     Pedigrees are printed at 12 characters per inch if possible.  If the
  1248.     printer is not capable of printing at 12 characters per inch, the
  1249.     current input line should be cleared.  Other printers will require a
  1250.     sequence of characters to set the pitch.
  1251.  
  1252.  
  1253.                Reset From 12 Characters Per Inch:
  1254.  
  1255.     If printer codes were not used to set 12 characters per inch then the
  1256.     current input line should be cleared.  Other printers will require a
  1257.     sequence of characters to reset the pitch to standard 10 characters
  1258.     per inch.
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 20
  1266.  
  1267.  
  1268.  
  1269.                Set 8 Lines Per Inch:
  1270.  
  1271.     Pedigrees are printed at 8 lines per inch if possible.  If the printer
  1272.     is not capable of printing at 12 characters per inch, the current
  1273.     input line should be cleared.  Other printers will require a sequence
  1274.     of characters to set the line spacing.
  1275.  
  1276.  
  1277.                Reset From 8 Lines Per Inch:
  1278.  
  1279.     If printer codes were not used to set 8 lines per inch then the
  1280.     current input line should be cleared.  Other printers will require a
  1281.     +sequence of characters to reset the line spacing to the standard 6
  1282.     lines per inch.
  1283.  
  1284.  
  1285.                Set Letter Quality Mode:
  1286.  
  1287.     Some reports are printed in letter quality mode if possible.  If the
  1288.     printer is not capable of switching to letter quality, or is only a
  1289.     letter quality printer, the current input line should be cleared.
  1290.     Other printers will require a sequence of characters to set letter
  1291.     quality mode.
  1292.  
  1293.  
  1294.                Reset From Letter Quality Mode:
  1295.  
  1296.     If printer codes were not used to set letter quality mode then the
  1297.     current input line should be cleared.  Other printers will require a
  1298.     sequence of characters to reset from letter quality mode.
  1299.  
  1300.  
  1301.                Set Enhanced Character Mode:
  1302.  
  1303.     Some reports are printed with enhanced characters if possible.  If the
  1304.     printer is not capable of enhanced printing, the current input line
  1305.     should be cleared.  Other printers will require a sequence of
  1306.     characters to set letter quality mode.
  1307.  
  1308.  
  1309.                Reset From Enhanced Character Mode:
  1310.  
  1311.     If printer codes were not used to set enhanced character mode then the
  1312.     current input line should be cleared.  Other printers will require a
  1313.     sequence of characters to reset from letter quality mode.
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 21
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.                Install License Registration
  1333.  
  1334.     The selection of Install License Registration will allow registered
  1335.     users to unlock PEDIGREE to accept over 2 million animal records.
  1336.     Prompts will be asked for the name of the license owner, the license
  1337.     number and the 16 character key code that is included with the
  1338.     license.  Keep the written record of these three items safe, as they
  1339.     will unlock all future upgrades to PEDIGREE as they are released.
  1340.  
  1341.          1) Enter the Name of the license owner as shown on the
  1342.     registration form.
  1343.  
  1344.          2) Enter the License Number from the registration form.
  1345.  
  1346.          3) Enter the Code Key from the registration form.
  1347.  
  1348.     An incorrect entry will display an error message and wait for
  1349.     corrections to the incorrect field.  Simply try again and double check
  1350.     each line before going on to the next entry.
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 22
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.                Supplemental Title Definition
  1394.  
  1395.     The first step in changing the titles and awards used is to answer the
  1396.     question about redefining the A.K.C. awards.  For United States users
  1397.     who are working with American Kennel Club registered dogs, this should
  1398.     be answered 'N'.  Users from other countries or those with dogs
  1399.     registered with other kennel clubs should answer 'Y'.  If the A.K.C.
  1400.     awards are not changed, then sixteen additional titles may be defined
  1401.     for any awards desired.  The first twelve awards will follow the
  1402.     A.K.C. standards for abbreviation and method of display.  If the
  1403.     A.K.C. awards are changed, then all 28 awards may be defined.
  1404.     Changing the A.K.C. awards also replaces the eleven character AKC
  1405.     number field with a twenty character REG number field.  This is more
  1406.     flexible for international users.
  1407.  
  1408.     Each title definition consists of a three parts.  The formal title is
  1409.     used on the Statistical Summary of the data file.  An abbreviation of
  1410.     the title will be reported with all references to an animal's name.
  1411.     The position for the title will determine whether the title goes
  1412.     BEFORE, AFTER, or UNDER the animal's name.  Another possibility for
  1413.     title position is NEVER, which will cause the title to be printed only
  1414.     on the listing of the entire database.  It would never be printed on a
  1415.     pedigree or other report.
  1416.  
  1417.     Some examples are:
  1418.  
  1419.  
  1420.          Formal Title                Abbreviation    Position
  1421.  
  1422.          Certificate of Gameness          CG          After
  1423.          Register of Merit                ROM         After
  1424.          Field Winner                     FW          Before
  1425.  
  1426.     When an animal's name is displayed, the first title defined will be
  1427.     closest to the name, either before, after or under as defined.
  1428.  
  1429.     Entry of data on animals with these titles will be done from the Add
  1430.     New Data menu item.
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 23
  1449.  
  1450.  
  1451.  
  1452.  
  1453.                Color Setup
  1454.  
  1455.     Color information may be set for the CRT to your personal taste.  All
  1456.     of the 16 foreground colors on 8 background colors may be used.  The
  1457.     color and monochrome attributes may be set for each type of text.  If
  1458.     the program detects a monochrome video adapter, or if the command line
  1459.     contains a '/m' parameter, the monochrome attributes will be available
  1460.     for modification.  These attributes are selected from a color chart
  1461.     for the foreground followed by the background.  The current settings
  1462.     are highlighted above the marker.  The marker may be moved with the
  1463.     <Cursor Left> and <Cursor Right> and the selection ended with
  1464.     <Return>.
  1465.  
  1466.     Settings are required for the following types of text:
  1467.  
  1468.          Normal text and entry prompts.
  1469.          Entry fields which are not currently selected.
  1470.          Highlighted text and the current entry field.
  1471.          One line help message and error messages.
  1472.          The screen border.
  1473.          The trace number for data items.
  1474.          The mouse cursor if a mouse is active.
  1475.  
  1476.     If any of the settings are changed, the program will save the changes,
  1477.     save all data, close the database and exit.  This is necessary to
  1478.     properly assign the new colors.
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 24
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                                 ERROR HANDLING
  1517.  
  1518.  
  1519.     When an error occurs either in data file handling, or in keyboard data
  1520.     entry, a message is displayed on the bottom line of the screen.  The
  1521.     message will be cleared and the program will continue after pressing
  1522.     any key.  Further help on most errors is available by pressing the
  1523.     <F1> key.  If the error is severe enough to cause the program to fail,
  1524.     all files will be closed and data saved automatically where possible.
  1525.     The importance of keeping back up data files cannot be overemphasized.
  1526.  
  1527.     Non fatal errors will have no effect on the data files and are
  1528.     summarized below:
  1529.  
  1530.  
  1531.                Record Was Previously Deleted:
  1532.  
  1533.     This entry has already been deleted from the data file.  Reenter a
  1534.     different animal name.
  1535.  
  1536.  
  1537.                Conflicting Record Data:
  1538.  
  1539.     These two records have conflicting data.  The error codes are summed
  1540.     up to the number shown:
  1541.  
  1542.       128 = Differing Names             64 = Differing AKC Numbers
  1543.        32 = Differing Sex               16 = Differing Birth Dates
  1544.         8 = Differing Sires              4 = Differing Dams
  1545.         2 = Differing Stud Book Dates    1 = Differing Title Dates
  1546.  
  1547.     Example:  Error of 37  = 32 + 4 + 1  means records are different
  1548.               in SEX  and DAM NAMES and TITLE DATES.
  1549.  
  1550.  
  1551.                Conflicting Supplement Data
  1552.  
  1553.     These two records have conflicting supplemental data.  The error codes
  1554.     are summed up to the number shown:
  1555.  
  1556.        32 = Differing Import Country    16 = Differing Original Reg.
  1557.         4 = Differing Description        2 = Differing Breeder Name
  1558.  
  1559.     Example:  Error of 36 = 32 + 4  means records are different in IMPORT
  1560.               COUNTRY and DESCRIPTION.
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 25
  1571.  
  1572.  
  1573.  
  1574.     These two records have conflicting supplemental data.  The error codes
  1575.     are summed up to the number shown:
  1576.  
  1577.         8 = Differing Registration #1     4 = Differing Registration #2
  1578.         2 = Differing Registration #3     1 = Differing Title Dates
  1579.  
  1580.     Example:  Error of 9 = 8 + 1  means records are different in
  1581.               REGISTRATION #1 and  TITLE DATES.
  1582.  
  1583.  
  1584.                Conflicting Comment Data
  1585.  
  1586.     Combining these two records would loose the comment fields on the
  1587.     record being deleted.  Write down the comment fields for both records
  1588.     before proceeding.  They may be entered again after combining the
  1589.     records.
  1590.  
  1591.  
  1592.                Animal Is Not In Database:
  1593.  
  1594.     Foreign championship data and alias names may not be entered for an
  1595.     animal which has not yet been added to the data file.  Likewise,
  1596.     revisions may not be made without first adding the animal to the data
  1597.     file nor may an animal that is not in the data file be removed.
  1598.  
  1599.  
  1600.                Name Is Already In Alias File:
  1601.  
  1602.     The alias name has already been entered in the file as an alias for a
  1603.     different animal.
  1604.  
  1605.  
  1606.                Name Is Already In Data File - Delete First:
  1607.  
  1608.     The name being added as an alias or as a revised name to an existing
  1609.     entry already exists in the data file.  If this entry is correct, then
  1610.     the existing animal must be deleted from the database first.
  1611.  
  1612.  
  1613.                Alias Is Not In Data File:
  1614.  
  1615.     The alias name being deleted is not in the alias file.
  1616.  
  1617.  
  1618.                Published Data Does Not Agree With Data File:
  1619.  
  1620.     The date of the Stud Book or AKC Gazette does not agree with existing
  1621.     data in the file for this animal.
  1622.  
  1623.  
  1624.                Animal Is Not Of This Sex:
  1625.  
  1626.     The animal being entered as a Sire or Dam is already in the data file
  1627.     and has the wrong sex to be used in this situation.  This must be
  1628.     corrected by reentering a different animal name.
  1629.  
  1630.  
  1631.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 26
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.                Animal Is Of Opposite Sex For Offspring Listed:
  1638.  
  1639.     The animal has offspring in the data file that show this animal to be
  1640.     of the opposite sex.  The entry must be deleted and then be reentered
  1641.     to change the sex, or the offspring must be changed.
  1642.  
  1643.  
  1644.                Not A Valid Date
  1645.  
  1646.     Separators for dates are: / - . or space
  1647.  
  1648.     Inputs for birthday should be in the format of a one or two digit
  1649.     month, a separator, a one or two digit day, a separator, then the
  1650.     year.
  1651.  
  1652.     The following are all acceptable examples:
  1653.          05/03/87     5/3/1987     5-03-87     05,03,1987     5 3 8
  1654.  
  1655.     Inputs for published dates should be in the format of a one or two
  1656.     digit month, a separator, then the year.
  1657.  
  1658.     The following are all acceptable examples:
  1659.          05/87    5/87    05/1987    5-87    5,87    5 87    05 1987
  1660.          00/87   00/1987  y          yes
  1661.  
  1662.  
  1663.                Can't Replace Animal With Itself
  1664.  
  1665.     Replacement animal for one being deleted is the same animal.  One of
  1666.     the entries is probably in the Alias file as another name for the
  1667.     other one.
  1668.  
  1669.  
  1670.                Can't Delete Animal's Name
  1671.  
  1672.     An animal's name cannot be removed from the Revise function.  To
  1673.     remove an animal from the data file, use the Delete menu selection.
  1674.  
  1675.  
  1676.                Control Code Not Valid
  1677.  
  1678.     This entry is not valid for a printer control code.  Reenter.
  1679.  
  1680.     Non-printable control codes are input as a back slash '\' followed by
  1681.     a 3 digit decimal number only.  For example, an ESCAPE code is entered
  1682.     as \027, and an ESCAPE followed by a Control-W is entered as \027\023.
  1683.  
  1684.  
  1685.                Not a Valid Directory Path
  1686.  
  1687.     This is not a path to a valid directory.  Either the directory does
  1688.     not exist on the drive, or the disk is invalid.  Enter a new path to
  1689.     correct.
  1690.  
  1691.  
  1692.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 27
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.                Data File Was Made by Wrong Version
  1699.  
  1700.     The sequential data files were created by a version of PEDIGREE that
  1701.     does not format data in the same manner.  The oldest version of
  1702.     PEDIGREE that creates compatible files is Ver. 1.10.  The solution to
  1703.     this is to create new sequential files with this version of PEDIGREE.
  1704.  
  1705.  
  1706.                Index Files Are In Error
  1707.  
  1708.     There is an error in the index files which will interpret this entry
  1709.     in an incorrect manner.  Re-index the datafile on all fields before
  1710.     continuing to correct.
  1711.  
  1712.  
  1713.                Error in Creating File
  1714.  
  1715.     There is an error which prohibits the program from creating all of the
  1716.     required dta files.  Exit the program and determine if there is
  1717.     sufficient disk space and available directory entries to create files.
  1718.     Confirm that there is a statement 'FILES=20' or greater in the file
  1719.     CONFIG.SYS on the boot disk or root directory.
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 28
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.                              DATA FILE MANAGEMENT
  1761.  
  1762.  
  1763.                File Reindexing:
  1764.  
  1765.     Reorganization of the database may become necessary if index files
  1766.     have been corrupted through power outages or computer errors.  As
  1767.     these errors can occur at any time, it is very strongly recommended
  1768.     that you keep back up copies of all data files at regular intervals.
  1769.     The database is indexed on five separate fields for rapid retrieval of
  1770.     information.  If an error that causes the index files to mismatch the
  1771.     data files occurs, reindexing of the appropriate index file will be
  1772.     necessary.
  1773.  
  1774.     The menu selection for reorganizing the data file will allow for
  1775.     reindexing all index files or only selected files.
  1776.  
  1777.  
  1778.                Sequential File Processing:
  1779.  
  1780.     Sequential files may be created from the main data files.  Sequential
  1781.     files may also be appended to the main data files.  The appending
  1782.     process checks for discrepancies between the main data files and the
  1783.     sequential files.  Any records with discrepancies are not appended to
  1784.     the data files, but are entered in a file named 'Breed.ERR' in the
  1785.     same directory as the main data files.  See the section titled ERROR
  1786.     HANDLING - Conflicting Record Data for the error codes.  In order for
  1787.     the appending process to work correctly all titles in the sequential
  1788.     file must refer to the same information as the corresponding field in
  1789.     the data file, and the sequential data files must have been created by
  1790.     PEDIGREE ver. 1.10 or later.
  1791.  
  1792.     These files may be used by other programs if desired or may be read
  1793.     into a word processor.  They are plain ASCII files with fields
  1794.     separated by a comma and each entry is terminated with a carriage
  1795.     return and line feed.
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 29
  1815.  
  1816.  
  1817.  
  1818.     The structure is as follows:
  1819.  
  1820.          Breed.DA1   Main data in the following order:
  1821.  
  1822.          Name - maximum of 35 characters.
  1823.          Registration number.
  1824.          Sex - B D or space.
  1825.          Birth date - yyyymmdd.
  1826.          Sire Name - maximum of 35 characters.
  1827.          Dam Name - maximum of 35 characters.
  1828.          Date Published in Stud Book - packed form.
  1829.          Championship Published - packed form.
  1830.          Companion Dog Published - packed form.
  1831.          Companion Dog Excellent Published - packed form.
  1832.          Utility Dog Published - packed form.
  1833.          Tracking Dog Published - packed form.
  1834.          Tracking Dog Excellent Published - packed form.
  1835.          Obedience Trial Championship Published - packed form.
  1836.          Amateur Field Trial Championship Published - packed form.
  1837.          Field Trial Championship Published - packed form.
  1838.          Junior Hunter Published - packed form.
  1839.          Senior Hunter Published - packed form.
  1840.          Master Hunter Published - packed form.
  1841.          User Defined Field #1 Published - packed form.
  1842.          User Defined Field #2 Published - packed form.
  1843.  
  1844.          Packed form for published dates may be expanded to valid dates as
  1845.          follows:
  1846.                0 -- means that no published date exists in
  1847.                     file.
  1848.                1 -- means that published date is known to
  1849.                     exist, but the date is not known.
  1850.          other # -- add 188000 to the number.  The right 2 digits are the
  1851.                     month and the left 4 digits are the year.  If the
  1852.                     month is 00 then the year is known but the month is
  1853.                     not.
  1854.  
  1855.          Breed.DA2   Alias names in the following order:
  1856.  
  1857.          Actual name of animal in Breed.DA1.
  1858.          Alias name of animal - 35 characters maximum.
  1859.  
  1860.          Breed.DA3   Foreign Champions in the following order:
  1861.  
  1862.          Actual name of animal in Breed.DA1.
  1863.          Country of foreign championship. (repeated 25 times)
  1864.  
  1865.          Breed.DA4   1st Supplemental Data in the following order:
  1866.  
  1867.          Actual name of animal in Breed.DA1.
  1868.          Country of import.
  1869.          Registration number in original country.
  1870.          Description of animal.
  1871.          Name of breeder.
  1872.  
  1873.  
  1874.  
  1875.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 30
  1876.  
  1877.  
  1878.  
  1879.          Breed.DA5   2nd Supplemental Data in the following order:
  1880.  
  1881.          Actual name of animal in Breed.DA1.
  1882.          Clearance 1 data.
  1883.          Clearance 2 data.
  1884.          Clearance 3 data.
  1885.          User Defined Field #3 Published - packed form.
  1886.          User Defined Field #4 Published - packed form.
  1887.          User Defined Field #5 Published - packed form.
  1888.          User Defined Field #6 Published - packed form.
  1889.          User Defined Field #7 Published - packed form.
  1890.          User Defined Field #8 Published - packed form.
  1891.          User Defined Field #9 Published - packed form.
  1892.          User Defined Field #10 Published - packed form.
  1893.          User Defined Field #11 Published - packed form.
  1894.          User Defined Field #12 Published - packed form.
  1895.          User Defined Field #13 Published - packed form.
  1896.          User Defined Field #14 Published - packed form.
  1897.          User Defined Field #15 Published - packed form.
  1898.          User Defined Field #16 Published - packed form.
  1899.  
  1900.  
  1901.          Breed.DA6   Comment data in the following order:
  1902.  
  1903.          Actual name of animal in Breed.DA1.
  1904.          First comment line.
  1905.          Second comment line.
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923.  
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 31
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.                               LICENSE AGREEMENT
  1944.  
  1945.  
  1946.                Terms and conditions of use:
  1947.  
  1948.     All versions of PEDIGREE by Charles H. Orange are not public domain
  1949.     software, nor are they free software.
  1950.  
  1951.     Non-registered users are granted a limited license to use PEDIGREE on
  1952.     a trial basis only for the purpose of determining it's suitability for
  1953.     their needs.  Use of PEDIGREE except for this limited purpose requires
  1954.     registration.  Non-registered versions of PEDIGREE are limited to only
  1955.     300 animal entries.
  1956.  
  1957.     Registration permits a user the license to use PEDIGREE on a single
  1958.     computer; a registered user may use the program on a different
  1959.     computer, but may not use the program on more than one computer at the
  1960.     same time.  Registered versions of PEDIGREE support over 2 million
  1961.     animal entries.
  1962.  
  1963.                Terms and conditions of copying:
  1964.  
  1965.     All users are granted a limited license to copy the non-regstered
  1966.     version of PEDIGREE for the purpose of archive or backup protection as
  1967.     well as for the trial use by others subject to the above limitations
  1968.     and to the following restrictions:
  1969.  
  1970.     Non-registered versions of PEDIGREE must be distributed in unmodified
  1971.     form, complete with the help and text files with this license
  1972.     information.
  1973.  
  1974.     No fee or charge may be made by anyone beyond the reasonable cost of
  1975.     duplication and media.
  1976.  
  1977.     Non-registered versions of PEDIGREE may be distributed in an archived
  1978.     format by operators of electronic bulletin boards if they observe the
  1979.     previous conditions.
  1980.  
  1981.     Versions of PEDIGREE with the license and Code Key installed may not
  1982.     be copied except for the purpose of archive or backup protection.
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 32
  1998.  
  1999.  
  2000.  
  2001.                                   Order Form
  2002.  
  2003.  
  2004.     To register your copy of PEDIGREE, please fill in the information
  2005.     below and send with $40.00 to:
  2006.  
  2007.                                 Charles H. Orange
  2008.                                 702 Maple Avenue
  2009.                                 Downers Grove, Ill. 60515
  2010.  
  2011.  
  2012.     Name _________________________________________      Circle Disk Size
  2013.  
  2014.     Address ______________________________________      3 1/2"    5 1/4"
  2015.  
  2016.             ______________________________________
  2017.  
  2018.     City ____________________________  State _____  Zip __________
  2019.  
  2020.     Registered users will receive the latest version on disk as well as
  2021.     announcements of future upgrades and additional products as available.
  2022.  
  2023.     The following is optional and for my information only.
  2024.  
  2025.     Breed _________________________  Kennel Name _________________________
  2026.  
  2027.     Please check here if I may give your name to other users in your breed
  2028.     for the purpose of exchanging data files.    _____(YES)   _____(NO)
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.     PEDIGREE  (c) 1988-1991 Charles H. Orange                    Page: 33
  2059.