home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / GE / GE003C.ZIP / SECTION2.DOC < prev    next >
Text File  |  1990-07-08  |  43KB  |  794 lines

  1.  
  2.  
  3.  
  4.       II.  Getting Started.
  5.  
  6.       A. Creating working copies of the programs
  7.  
  8.       The basic set of programs in the Family History System is distributed 
  9.       on three 5 1/4" diskettes or two 3 1/2" diskette.  The diskettes 
  10.       should be labeled B1, B2 (and B3) for identification purposes during 
  11.       the installation of the programs.  If your diskettes do not have 
  12.       external labels marked in this way, you may identify the diskettes by 
  13.       the following:  
  14.       Place a diskette in the A drive and enter:    A>dir A:
  15.            the B1 diskette will have a file named:  FHSDISK.B1
  16.            the B2 diskette will have a file named:  FHSDISK.B2   
  17.        and the B3 diskette will have a file named:  FHSDISK.B3
  18.  
  19.       The B1 diskette has an "orientation" procedure that may be started by 
  20.       placing the diskette in the "A" drive of your PC and entering:  A:GO
  21.       This 80+ page manual can be printed from files on the diskette by 
  22.       entering the command:  A:GO PRINT MANUAL
  23.  
  24.       The "GO" procedure requires that the B1 diskette be in the "A" drive 
  25.       of your PC.  If you have received the diskettes in a format that is 
  26.       not compatible with your "A" drive, you may still be able to use this 
  27.       procedure by employing the DOS ASSIGN command.  For example, suppose 
  28.       you have received the programs on 5 1/4" diskettes but you have a 
  29.       3 1/2" A drive and a 5 1/4" B drive.  If you enter:  ASSIGN A B
  30.       and place the B1 diskette in the B drive, you may use the GO procedure 
  31.       to print the manual and install the programs on a hard disk.  After 
  32.       finishing those tasks, you will want to "undo" the reassignment of 
  33.       drives by simply entering:   ASSIGN
  34.       which will return all drive assignments to normal.
  35.  
  36.       These "distribution" diskettes  contain many files which are not 
  37.       required during the normal operation of the system.  For instructions 
  38.       on how to create a working copy of the programs, without those 
  39.       unnecessary files, place the B1 diskette in drive "A" and enter: 
  40.            A:GO INSTALL    
  41.       Instructions are provided for installing the programs on either floppy 
  42.       diskettes or a hard disk.  For example, you will be instructed to 
  43.       enter:    A:GO INSTALL 2D B   to install the programs on 2 360k disks
  44.              or A:GO INSTALL 1D B   to install the programs on 1 diskette
  45.                                     with capacity >= 720k
  46.              or A:GO INSTALL HD C   to install the programs on hard disk
  47.                                     drive "C"
  48.  
  49.       Those running the programs from 360k, 5 1/4" floppy diskettes should 
  50.       note that two program diskettes are now required (a STARTUP and a 
  51.       REPORT Program diskette).  During an FHS working session it will be 
  52.       necessary for you to change program diskettes when some options are 
  53.       selected from the Main Menu. 
  54.  
  55.       If you are installing the programs on a hard disk, they will be placed 
  56.       in a FAMILY sub-directory of the hard disk.  If you are reinstalling 
  57.       the programs, they will simply replace the existing programs in the 
  58.       FAMILY sub-directory.  
  59.  
  60.  
  61.                                       4
  62.  
  63.  
  64.  
  65.  
  66.       After installing the programs on diskette(s), you may start the system 
  67.       by placing the STARTUP program diskette in drive "A" and entering:    
  68.             A>fhs      or    A>faminit
  69.       If the programs are installed on a hard disk, you will start the 
  70.       system by entering:   C>fhs
  71.       or by entering:  C>cd \family  
  72.                   and  C>faminit
  73.  
  74.       On the PCjr, the BASIC language cartridge must be installed in one of 
  75.       the cartridge slots when using the "interpreted" or uncompiled version 
  76.       of the programs.  
  77.  
  78.  
  79.       B. Beginning a Family History System work session
  80.  
  81.       When starting the Family History System, the screen will be cleared 
  82.       and reformatted with the system's `introductory panel'. This panel, 
  83.       which shows the `update' of the program diskette that you are using, 
  84.       will only appear for a few seconds, after which the MAIN MENU of 
  85.       system options will appear.
  86.  
  87.  
  88.       1. MAIN MENU Program
  89.  
  90.       Besides being the first functioning panel that you will see when 
  91.       entering the system, the MAIN MENU provides the only `authorized' and 
  92.       `safe' means of exiting the system (by pressing F10).  You are never 
  93.       far from the MAIN MENU.  It can be reached from any of the programs in 
  94.       the system by pressing the `F9' key.
  95.  
  96.       The purpose of the MAIN MENU is to permit you to easily select the 
  97.       system function that you wish to perform.  These functions include:
  98.              1. F1 - Display/Update/Create Family History System files
  99.              2. F2 - Produce Reports
  100.              3. F3 - Utility Functions
  101.              4. F4 - Set current DATE, TIME and DATE Format
  102.              5. F8 - Execute DOS Commands (DOS 3.0 or later)
  103.              6. F10- Exit from the system (Return to DOS)
  104.  
  105.       The system functions are selected by pressing the indicated `function 
  106.       key'.  If any other key is pressed, a soft tone is sounded and nothing 
  107.       else happens.  When a `legal' key is pressed, the corresponding func-
  108.       tion key designator, next to the function description on the screen, 
  109.       will be hilited.  If you have selected a function, such as F2, that 
  110.       has several options to choose from, you will be prompted to enter a 
  111.       character corresponding to the one you wish to select.
  112.  
  113.       When you have fully described the system function you wish to perform, 
  114.       the program which performs that function will be read from the program 
  115.       diskette and given control.  If the program cannot be read from the 
  116.       diskette (for example, if the correct program diskette is not in the 
  117.       `default' drive, or the drive door is open, or the program diskette is 
  118.       for some other reason unreadable), the message: 
  119.                "Put Program diskette in default drive..." 
  120.  
  121.  
  122.                                       5
  123.  
  124.  
  125.  
  126.       will appear on the bottom line of the screen.  If you are able to 
  127.       determine the reason for the problem and correct it (for example, by 
  128.       putting the correct program diskette in the appropriate drive), you 
  129.       may press the `space bar' and the system will make another attempt to 
  130.       read the program from the diskette.  If for any reason you decide not 
  131.       to continue with the selected option, you may press the `ESC' key and 
  132.       you will be able to reselect any MAIN MENU option.  (The ESCape key is 
  133.       recognised by most programs in the set as an operator request to 
  134.       terminate a process that has been started.)
  135.  
  136.       The next paragraph discusses the setting of current date and time.  
  137.       The section following that discusses some procedures for "customizing" 
  138.       the system for your configuration.  If you are a first time user of 
  139.       the Family History System, I recommend that you review these sections 
  140.       before going into any other area of the system.
  141.  
  142.  
  143.       2. Setting CURRENT DATE, TIME and DATE Format
  144.  
  145.       The setting of the current date, time and default format for entering 
  146.       dates are the only system functions that are performed within the MAIN 
  147.       MENU program.  
  148.  
  149.       Unless you have a `clock calendar' board on your computer or have 
  150.       previously set the date and time under the control of DOS or another 
  151.       program, the current DATE will probably be `01-01-1980'.  Because the 
  152.       current date is used to determine the ages of living persons that 
  153.       appear on some of the reports and in the file maintenance program, it 
  154.       is important that it be properly set if any reports are to be 
  155.       produced.  The time is not used by the system and is only included for 
  156.       your convenience.  
  157.  
  158.       If you press the F4 key, you will be prompted to:
  159.              Select:  1) Change DATE and TIME   2) Change DATE Format
  160.  
  161.       If you select "2) Change DATE Format", you will be prompted to:
  162.              Select:  1) MM-DD-YYYY  2) DD.MM.YYYY  3) YYYY.MM.DD  4) SAVE
  163.       If you press "1", "2" or "3" the format for the current date will be 
  164.       changed accordingly.  The format that appears there will be the one 
  165.       that must be used for entering dates in the file update program.  
  166.       After you have selected your preferred format, you may press "4" to 
  167.       SAVE the date format in file FAMILY.DAT so that it will be 
  168.       "remembered" the next time you begin a FHS working session.  If you 
  169.       simply press the Enter key, the format will be used only for the 
  170.       remainder of the current working session.
  171.  
  172.       If you select "1) Change DATE and TIME", you will be prompted to:
  173.                         Enter the current DATE and TIME
  174.       and the cursor will appear at the left most character of the displayed 
  175.       date.  You must enter the date in the format displayed.  Further, it 
  176.       must be a valid date and not be before "Jan 1,1980".  After entering 
  177.       the date, the cursor will automatically advance to the first character 
  178.       of the time.  The time must be entered in the form HH:MM:SS.  You may 
  179.       use the 24 hour convention for denoting AM or PM.  If you wish to go 
  180.       back to reenter the date, press the SHIFT+TAB keys at the same time.  
  181.  
  182.  
  183.                                       6
  184.  
  185.  
  186.  
  187.       After you have keyed in the date and time to your liking, you may 
  188.       indicate to the program that you wish to reset the current values by 
  189.       pressing the RETURN or ENTER key.  If an error is found in either the 
  190.       date or time, a tone will be sounded and you may correct the error.
  191.  
  192.       If for any reason you wish to terminate the option, you may press the 
  193.       ESC key and you will then be able to reselect any of the MAIN MENU 
  194.       options.
  195.  
  196.  
  197.       3. Setting DEFAULT System Parameters
  198.  
  199.       One thing you may wish to do when you first begin a FHS session is to 
  200.       examine the system defaults for the file names, screen attribute 
  201.       table, and printer setup table used by the system (Main Menu options 
  202.       F3-A,B,C).  Some reasons for doing this are:
  203.  
  204.          a. To customize the default family file names.  For example, you 
  205.             may want to change the names of the family file datasets from 
  206.             FAMILY.NAM, FAMILY.ADR and FAMILY.OTH to something like 
  207.             RUSSELL.NAM, RUSSELL.ADR and RUSSELL.OTH.  You can of course 
  208.             build multiple family files and it is common to use the primary 
  209.             surname as a dataset prefix to distinguish them.  You will also 
  210.             want to make sure that the "drive identifiers", that is, the two 
  211.             characters at the beginning of each dataset name ("A:", "B:", 
  212.             "C:" etc.), are correct for your placement of the datasets.  
  213.             These adjustments can be made using Main Menu option F3-A.
  214.  
  215.          b. To choose a more satisfactory set of screen attributes (colors 
  216.             or light/normal/dim brightness) for the display of information 
  217.             on the screen.  Although the system, upon first entry, checks to 
  218.             see whether the IBM monochrome or a graphics display adapter is 
  219.             being used and selects a "screen attribute table" accordingly, 
  220.             if you are using a color monitor you may find the colors used to 
  221.             be unappealing or difficult to read. Main Menu option F3-B 
  222.             permits you to adjust these.
  223.  
  224.          c. To choose a printer control table more appropriate for your 
  225.             equipment.  While the original printer table is based upon a 
  226.             common standard, there are a number of tables for more specific 
  227.             printers selectable under Main Menu option F3-C.  You may also 
  228.             create a custom printer setup for printers not formally 
  229.             supported by a prepared setup. 
  230.  
  231.       (Please see Sections III-H,I,J for more complete discussions of these 
  232.       options).
  233.  
  234.  
  235.       4. CREATING and UPDATING a set of Family files
  236.  
  237.       Data files for the Family History System are initialized and updated 
  238.       in the system's FILE MAINTENANCE Program which is selected by MAIN 
  239.       MENU option F1.  This program is distinguished by its use of `seg-
  240.       mented' displays.  Sections III.G and III.F discuss in more detail 
  241.       the design of these displays and the general rules for updating infor-
  242.  
  243.  
  244.                                       7
  245.  
  246.  
  247.  
  248.       mation on them.  In the following discussion I will refer to each of 
  249.       the formatted segments of the screen as a "view". 
  250.  
  251.       The first `view' you are presented in the file update program shows 
  252.       the Menu of options available in the File Maintenance program.  This 
  253.       view provides the only `legal' means for EXITing the file maintenance 
  254.       program (by pressing `F9' to request a return to the system's MAIN 
  255.       MENU display).  At that time, all "open" files will be "closed" and 
  256.       all updates which may have been held in memory by DOS will be 
  257.       permanently written to your family files.  If the program diskette has 
  258.       been removed from the default drive (for example if a separate data 
  259.       diskette has been placed in that drive) you will be prompted to 
  260.       replace the program diskette at the appropriate time.  You should not 
  261.       replace the program diskette before being prompted to do so because 
  262.       the "open" files may not have been completely updated yet.  (You are 
  263.       never `far' from this list of primary options while in the file 
  264.       maintenance program.  It can be reached from just about any part of 
  265.       the program by pressing the ESCape key enough times.)
  266.  
  267.       The first option selected whenever the file update program is being 
  268.       used should be `F1', Open/Close/Create Family Files.  (It is automat-
  269.       ically selected for you when you enter this program.)  When a program 
  270.       `opens' a file, it is requesting the operating system to permit it to 
  271.       read information from or write information to the file.  Ordinarily 
  272.       this is done automatically by a program without the user's having to 
  273.       do anything.  In this program however, because the files remain open 
  274.       for long periods of time to process multiple user requests, and 
  275.       because a file could potentially become `damaged' if the user were to 
  276.       change data diskettes or `illegally' exit from the system (for 
  277.       example, by turning the machine off) while the file is open, I have 
  278.       chosen to require you to explicitly request that the files be opened 
  279.       at the beginning of the program as a reminder of the situation that 
  280.       prevails.  All open files will automatically be closed when you return 
  281.       to the MAIN MENU program.  (See section II.C for a discussion about 
  282.       protecting yourself from loss of information in damaged files.)
  283.  
  284.       When the "Open/Close/Create" option is selected, you will see dis-
  285.       played in the upper right viewing area a list of the "datasets" used 
  286.       to store your family information as well as the options that may be 
  287.       `function key' selected from this view.  You should also note that the 
  288.       `hilited' border moves from the upper left to the upper right viewing 
  289.       area.  While in this program, the `active' view (the one from which 
  290.       program options may be selected) is enclosed by a `hilited' border.  
  291.  
  292.       (NOTE: The term "dataset" is used here to refer to a named area on a 
  293.       diskette or hard disk which contains a program or data.  I am told 
  294.       that this term is peculiar to an IBM environment, but it is one that I 
  295.       find natural and will use frequently in this document.  Many people 
  296.       will use the term "file" for what I am calling a dataset, however I 
  297.       usually think of a "file" as a collection of logically related infor-
  298.       mation and as such it may consist of several datasets.  When I speak 
  299.       of a "Family File" I will mean the entire collection of information 
  300.       that is stored in the three datasets described here.)
  301.  
  302.       Three datasets are used by the system to store your family history 
  303.  
  304.  
  305.                                       8
  306.  
  307.  
  308.  
  309.       information.  You might think of these as three card files used to 
  310.       store different types of information.  The first dataset, the NAME 
  311.       dataset, is used to store basic information concerning an individual, 
  312.       including the name, sex, birth and death dates of the individual.  The 
  313.       second dataset is used to store the various types of ADDRESSes that 
  314.       are permitted in the system.  The third dataset of OTHER data 
  315.       contains: birth, death and marriage places; marriage records; health, 
  316.       education, military and work information; and notes or comments.
  317.  
  318.       Because you may wish to maintain multiple family files, with different 
  319.       names, or you may wish to place the datasets on one or more separate 
  320.       data diskettes located on a different drive from the program diskette, 
  321.       you are permitted to change the file `specifications' displayed before 
  322.       opening or creating the files.  I refer you to your DOS manual for a 
  323.       description of file naming conventions which you should use.  (Please 
  324.       note that the "A:" before the dataset name describes the drive on 
  325.       which the program is to look for the dataset.  You may change this to 
  326.       "B:", "C:", etc. if you want the program to look for the datasets on a 
  327.       drive other than the "A" drive.)
  328.  
  329.       If this is your FIRST time using the system you will want to `CREATE' 
  330.       or initialize the file by selecting option F3.  (If the datasets 
  331.       already exist, you will be asked to confirm that it is okay to DELETE 
  332.       the datasets during the process of re-initializing them.  Be WARNED 
  333.       that REinitializing a set of family datasets will result in the LOSS 
  334.       of ALL DATA currently stored in them.)  After the file has been 
  335.       CREATEd, in future executions of this program you will use F1 to 
  336.       simply OPEN the files.  When the datasets are open you may return to 
  337.       the view of main options of the file maintenance program by pressing 
  338.       the ESCape key.
  339.  
  340.       (Before continuing with this section, you may want to read Appendix B 
  341.       concerning the recording of information on Family Group Worksheets 
  342.       prior to entry in the system.)
  343.  
  344.       In what follows, I will not attempt to fully describe all the options 
  345.       available in the file maintenance program, however I will try to 
  346.       describe the following:
  347.  
  348.          a) ADDING a NAME record to the file;
  349.          b) Recording MARRIAGE information;
  350.          c) Maintaining ADDRESS information;
  351.          d) Listing CHILDREN of an individual or `marriage';
  352.          e) `Climbing' the ancestor tree through PARENT relationships;
  353.          f) SEARCHing name records.
  354.  
  355.       I hope that you will experiment to become familiar with these and 
  356.       other parts of the file maintenance program so that you may determine 
  357.       which options of the program are appropriate for recording the histor-
  358.       ical information of your family.
  359.  
  360.       a) ADDING a NAME RECORD to the File
  361.          If you are just beginning to enter data into your family file then, 
  362.          after opening the files and returning to the primary menu of file 
  363.          maintenance options,you will select option "F2  ADD a Name Record".  
  364.  
  365.  
  366.                                       9
  367.  
  368.  
  369.  
  370.          The `current viewing area' will move to the upper right corner of 
  371.          the screen which will be formatted with labels describing the 
  372.          information that you may enter into the name record for the first 
  373.          individual to be added to the system.  
  374.  
  375.          You will note that the assigned record ID (on the first line of the 
  376.          screen) is `1'.  Each NAME record that you create will be assigned 
  377.          an ID number which just indicates the order in which the records 
  378.          have been entered into the file.  These ID numbers are used to 
  379.          identify records for the purpose of defining relationships between 
  380.          them (such as parent-child or spousal relationships) but the value 
  381.          of the ID number itself has no special significance.  
  382.  
  383.          When you start to enter information into a Name record, the 
  384.          blinking cursor appears in the 1st position of the SURNAME field.  
  385.          Pressing the "TAB" key (to the left of the "Q" on most keyboards) 
  386.          causes the cursor to advance successively to other updatable fields 
  387.          on the screen.  You will note that pressing the ENTER or RETURN key 
  388.          will move the cursor to the first position of the first updatable 
  389.          field on the NEXT line.  You must use the TAB key to move to other 
  390.          fields which are to the right of the cursor on the SAME line.  
  391.          Section III.F.1 describes other rules for entering information into 
  392.          the formatted displays used in this program.
  393.  
  394.          Of course the ID # of a parent cannot be entered into a child's 
  395.          record unless a record has previously been created for the parent.  
  396.          If the parent's record is added after the child's, then you may go 
  397.          back and update the child's record with the correct ID number for 
  398.          the parent to establish the parent-child relationship.
  399.  
  400.          Although the Birth and Death places appear in the view of the name 
  401.          record information, they are not actually stored in the NAME
  402.          record.  Because this information is not generally known for 
  403.          distant ancestors or relatives, I have made this part of a separate 
  404.          record.  If neither location is known, leave the fields blank and 
  405.          no space will be used on the data diskette.  Entry of anything in 
  406.          either data item will result in the creation of a single 50 
  407.          character record for storing the information.
  408.  
  409.          I have allowed for recording the times of birth and death in the 
  410.          NAME record.  Although this is also information which is not 
  411.          generally known about distant ancestors or relatives, in this case 
  412.          a total of only 4 `characters' are required to store the informa-
  413.          tion so relatively little space is lost if these times are unknown 
  414.          or you decide not to maintain a record of them.
  415.  
  416.          You will note four unlabeled single-character fields to the right 
  417.          of the birth/death dates and father/mother ID's.  These are 
  418.          "status" fields whose use is described in Appendix C.  Among other 
  419.          things, these may be used to distinguish adoptive parent/child 
  420.          relationships.
  421.  
  422.          The "Use:" field to the right of the Surname field was added in 
  423.          February 1987 to handle a "problem" that arises when creating 
  424.          indexes or printing reports using some of the extended options of 
  425.  
  426.  
  427.                                      10
  428.  
  429.  
  430.  
  431.          the system.  There you are permitted to request that a woman's 
  432.          surname be replaced with that of her (most recent) husband, which 
  433.          seems more appropriate for things like Birthday or Anniversary 
  434.          lists.  However this didn't take into account the situation in 
  435.          which a woman chooses to continue using her own surname after 
  436.          marriage.  A value of "Y" entered in the "Surname...Use:" field of 
  437.          a married woman tells those programs that her own surname is always 
  438.          to be used when building indexes or printing reports.
  439.  
  440.          After all information has been correctly entered, press F1 to 
  441.          cause a record to be created in the file.  The bottom line of the 
  442.          viewing area will then be replaced with a list of standard 
  443.          options available when displaying an individual's information.
  444.  
  445.          The displayed Name record information may be modified by pressing 
  446.          function key F1 twice, and making changes as above.  Another record 
  447.          may be added by pressing the F1 key, then the F2 key and proceeding 
  448.          as above.  Other options will be discussed in the following 
  449.          sections.
  450.  
  451.          Please note when adding or updating a NAME record, the action of 
  452.          the F3 key is described as "RESTORE FIELD VALUE".  This means that 
  453.          when you press the F3 key, the field that contains the cursor will 
  454.          be restored to the last displayed value.  This should simplify the 
  455.          sequential entry of records with repeated values in certain fields.  
  456.          For example birth or death places, or the Surnames of children in 
  457.          the same family.
  458.  
  459.       b) Creating a MARRIAGE or FAMILY record.
  460.          After name records have been created for each of the participants 
  461.          in a marriage, the marriage or family record may be created by 
  462.          pressing the F4 (SPOUSE) key in the view of name record informa-
  463.          tion for either spouse (a single marriage record is maintained 
  464.          for both spouses).  The `current viewing area' will shift to the 
  465.          upper left corner of the screen, which will be formatted with 
  466.          descriptions of the information stored in a marriage record.  If 
  467.          a marriage has previously been recorded for the spouse whose name 
  468.          record is displayed, information from the most recent marriage 
  469.          record will be shown.  A new record may be created by pressing the 
  470.          F1 key, then the F2 key.  If no marriage record currently exists 
  471.          for the displayed spouse, the view will be ready for information to 
  472.          be entered.  If you do not want to enter information at that time, 
  473.          you may press the ESCape key to return to the Name record viewing 
  474.          area.
  475.  
  476.          When entering marriage information, to describe the other partner 
  477.          in the marriage, press the F2 key, type the record ID for that 
  478.          individual and press the RETURN key.  The individual's NAME record 
  479.          will be retrieved and descriptive information displayed to confirm 
  480.          that the correct ID # has been entered.  If it is incorrect, you 
  481.          may press the F2 key again to change the value of the spouse ID.
  482.          
  483.          To update the marriage STATUS, Date and Place fields, press the F3 
  484.          key and use the TAB key to move to the fields that need to be 
  485.          updated.  Although the beginning status field will normally 
  486.  
  487.  
  488.                                      11
  489.  
  490.  
  491.  
  492.          indicate that a marriage was performed, other types of arrangements 
  493.          may be indicated such as common-law (marriage), communal (living 
  494.          arrangement), etc; the partners in the relationship will still be 
  495.          identified as spouses in all reports.  The termination status field 
  496.          may indicate: "wife died", "husband died", "divorced", "annulled", 
  497.          "agreement", etc.  If a relationship is known to have terminated 
  498.          but the date is unknown, the year of the ending date should be 
  499.          9999.  Please note that it is necessary for you to manually enter 
  500.          this termination date even when one or both spouses are recorded as 
  501.          deceased.  It is not automatically updated with the death date of a 
  502.          spouse because that may represent an incorrect assumption on the 
  503.          part of the program.  The report programs will take the death dates 
  504.          of the spouses into consideration when computing the number of 
  505.          years married, however an "*" will appear to the right of that 
  506.          number, if a death date was used to determine it, to call your 
  507.          attention to the fact that the program has made what may be an 
  508.          incorrect assumption in computing it. 
  509.  
  510.          The PLACE fields that appear after the STATUS/DATE fields are 
  511.          handled similarly to BIRTH/DEATH place fields.  If nothing is 
  512.          entered in either of the fields, then no space is taken in the file 
  513.          for them.  If any text is entered in either field, then a single 50 
  514.          character record is created to hold both 22 character fields.
  515.  
  516.          Press the F1 key when all status information has been correctly 
  517.          entered.  
  518.  
  519.          After both spouse ID and status information have been satisfac-
  520.          torily entered, pressing the F1 key again will cause the record to 
  521.          be written to the family file.  If either spouse has other spouse 
  522.          records on file, the record being added will be merged with the 
  523.          others in reverse order of the beginning dates (so that the most 
  524.          recent record occurs first).  If there is an earlier marriage 
  525.          record on file for the spouse whose name record is displayed in the 
  526.          NAME record viewing area, there will be a message at the bottom of 
  527.          the screen informing you that you may:
  528.                   Press the PGUP key to display an earlier record
  529.          You cannot press the PGDN key to display a later record.  If you 
  530.          wish to back up in a series of marriages, you must press the ESCape 
  531.          key to return to the NAME record viewing area, then press the F4 
  532.          key to begin again with the most recent marriage record.
  533.  
  534.          Please note that there are three separate steps to creating a 
  535.          marriage record:
  536.               a. Update the ID for spouse
  537.               b. Update the status fields, dates and places
  538.               c. Save the information in a file record
  539.          No information is placed in the file until the last step is 
  540.          performed.
  541.  
  542.          You should also be aware that a marriage record need not be created 
  543.          in order to establish parent/child relationships.  Within the FHS 
  544.          family files, there is no forced connection between parenting and 
  545.          marriages.
  546.  
  547.  
  548.  
  549.                                      12
  550.  
  551.  
  552.  
  553.          Options available to you after the marriage record has been added 
  554.          are shown on the bottom line of the viewing area and include:
  555.               F1 UPDATE (Change, Add or Delete);
  556.               F2 SELECT (the spouse to be displayed in Name record viewing 
  557.                  area);  
  558.               F3 List CHILDren having both spouses as parents;
  559.               F4 List RESidence information;
  560.               F5 Display/Enter COMments about the family relationship.
  561.  
  562.          Pressing the ESCape key in the view of SPOUSE or MARRIAGE informa-
  563.          tion returns you to the Name record viewing area.
  564.  
  565.       c) Maintaining ADDRESS information.
  566.          Address information may be recorded in a number of places within an 
  567.          individual's total information record.  It may indicate the indivi-
  568.          dual's residence, a family residence (under the spouse record), or 
  569.          an address related to one of the additional records for education, 
  570.          health, work or military information.  The information which is 
  571.          stored in an address record includes:
  572.                 Beginning and ending dates during which the address 
  573.                    information was current;
  574.                 Address (two 30 character lines);
  575.                 City    (15 character field);
  576.                 State   (4 character abbreviation);
  577.                 Zip or country (5 character field);
  578.                 Telephone (3 numeric fields; early phone numbers using 
  579.                    alphabetic prefixes cannot be recorded here.) 
  580.  
  581.          Comments may subsequently be recorded concerning information that 
  582.          is particularly relevant to the address record. (This might include 
  583.          a physical description of a home.)
  584.  
  585.          Multiple addresses may be recorded of each of the above types.  
  586.          All addresses under a given type record (name, spouse, health, 
  587.          etc.) will be `chained' together in reverse order of beginning date 
  588.          so that the most recent address occurs first.  The extended system 
  589.          offers options for producing lists of latest (residence) addresses 
  590.          and for creating a MailMerge format file of address information.  
  591.          The MailMerge file can be used with many database programs for 
  592.          printing mailing labels.  It may also be used with many word 
  593.          processors for printing form letters.
  594.  
  595.          (NOTE: it has come to my attention that the above described format 
  596.          for address information is not appropriate for many foreign 
  597.          addresses, and some domestic U.S. ones as well.  I do plan to 
  598.          make adjustments to this area sometime in the future, but it will 
  599.          not likely be in the very near future because it will require that 
  600.          all users go thru a conversion process for their family files.)
  601.  
  602.       d) Listing CHILDREN of an individual or marriage
  603.          Pressing the F3 key in the display for the individual's Name 
  604.          record or for a SPOUSE record results in the listing of children 
  605.          parented by the individual or by both spouses.  The list appears 
  606.          in a viewing area occupying the bottom half of the screen.  Up to 
  607.          9 children may be listed; if there are more, you may continue the 
  608.  
  609.  
  610.                                      13
  611.  
  612.  
  613.  
  614.          list by pressing the PGDN key.
  615.  
  616.          You may request to select one of the children for display in the 
  617.          Name record viewing area by pressing the F1 key and using the UP 
  618.          and DOWN cursor control keys to select the ID number of the desired 
  619.          child.  Another child may be selected by returning to the child 
  620.          list (as a result of pressing the ESCape key in the view of Name 
  621.          record information) or by pressing the CTRL+PGDN or CTRL+PGUP key 
  622.          combinations in the view of Name record information for the pre-
  623.          viously selected child.
  624.  
  625.       e) Climbing Ancestor Trees through PARENT relationships.
  626.          The file maintenance program was designed so that the user could 
  627.          easily follow lines of ancestry (or descendancy) from one gene-
  628.          ration to another.  The previous section described how you might 
  629.          start with an individual, list his/her children, select one of the 
  630.          children for display, after which the grandchildren parented by 
  631.          that child may be listed, a grandchild selected for display, etc.  
  632.          The family tree may be examined in the `reverse' direction also.  
  633.  
  634.          From the display of an individual's Name record information, 
  635.          pressing the F2 key moves the current viewing area to the upper 
  636.          left corner of the screen where information about the parents is 
  637.          displayed.  From that view, the parents' children may be displayed 
  638.          (the full brothers and sisters of the original individual) by 
  639.          pressing the F3 key, or the Father or Mother may be selected for 
  640.          display in the Name record viewing area by pressing the F1 or F2 
  641.          function keys respectively.  If a parent is selected for display, 
  642.          then their parents (one set of grandparents of the original indivi-
  643.          dual) may be displayed using the F2 key.  Continuing in this way, a 
  644.          single chain of ancestor relationships may be examined to exhaus-
  645.          tion.  
  646.  
  647.          To help you remember how far the ancestor chain has been examined, 
  648.          the `RELATIVE GENERATION LEVEL' of the displayed individual(s) is 
  649.          shown in the upper right corner of the Name record, parent, spouse 
  650.          and child displays.  The generation level is reset to 0 whenever an 
  651.          individual is selected for viewing for some reason other than a 
  652.          parent, child or spouse relationship (for example, by selecting 
  653.          from a `search list'...see below).
  654.  
  655.       f) SEARCHing the Name Records on file.
  656.          The file maintenance program contains a procedure for making 
  657.          (limited) searches of the Name records on file.  This would ordi-
  658.          narily be used to determine the record ID for some individual whose 
  659.          information or family relationships were to be examined or modi-
  660.          fied.
  661.  
  662.          The view for initiating searches is displayed by pressing the F4 
  663.          function key from the view of primary options for the file mainte-
  664.          nance program.  The viewing area in the upper left corner of the 
  665.          screen will be cleared and reformatted with fields describing the 
  666.          criteria for limiting the search.  These include:
  667.                limits on record ID;
  668.                Surname (or portion of a surname...e.g. the first 2 char);
  669.  
  670.  
  671.                                      14
  672.  
  673.  
  674.  
  675.                Given name (or portion of a Given name);
  676.                Range of Birth dates;
  677.                Range of Death dates.
  678.          The searches on Surname and Given name are sensitive to upper and 
  679.          lower cases; i.e. neither `brown' nor `BROWN' will match a record 
  680.          with Surname `Brown' (but a search for `Brown' will match).  Also 
  681.          the range comparisons on dates make the month-day and Year checks 
  682.          independently.  Therefore a search with:
  683.                    02/00/1930 <= Birth Date <= 02/99/1940
  684.          will locate name records with birth dates in the month of February 
  685.          and between the years 1930, 1940 inclusive.
  686.  
  687.          After the search criteria have been satisfactorily entered, the 
  688.          search is started by pressing the F1 key.  The current viewing area 
  689.          moves to the lower half of the screen and the search begins.  A 
  690.          reverse-video display in the lower left corner of the screen shows 
  691.          the record ID for the name record currently being examined.  The 
  692.          search process can be interrupted by pressing the space bar,  then 
  693.          the search may be continued by pressing the PGDN key or you may 
  694.          select for display one of the record ID's already found by pressing 
  695.          the F1 key and using the UP and DOWN cursor controls to move the 
  696.          reverse-video `box' to the correct ID #, and  then pressing the 
  697.          ENTER or RETURN key.
  698.  
  699.          After displaying a name record located through a search, other 
  700.          members in the `active search list' may be selected for display 
  701.          by either pressing the ESCape key from the name record viewing 
  702.          area to return to the search list (if it has not been overlain) 
  703.          or by pressing the PGDN or PGUP keys in the Name record viewing 
  704.          area.
  705.  
  706.          A search list becomes inactive when another search begins or when 
  707.          the ESCape key is pressed in the search list viewing area.
  708.  
  709.  
  710.       C. Importance of `BACKING UP' your FAMILY Files
  711.  
  712.       As with all `dynamic' files whose creation and maintenance represents 
  713.       a considerable investment of time, the importance of keeping multiple 
  714.       backup copies of the files cannot be overemphasized.
  715.  
  716.       All of the information you enter is stored in the three datasets that 
  717.       make up a FHS family file.  Using the "default" names, these are the 
  718.       FAMILY.NAM, FAMILY.ADR and FAMILY.OTH datasets.  These are the only 
  719.       files that you need "backup" to preserve your data.  There is one 
  720.       other file that you may consider backing up...the FAMILY.DAT file.  
  721.       That is where any changes that you make to the file name table, the 
  722.       screen colors, the error tone, the printer tables and the date format 
  723.       are kept.
  724.  
  725.       The standard DOS COPY utility should be adequate for most users to 
  726.       create these `backup' files.  If one of your family file datasets 
  727.       exceeds the capacity of your backup device, then you must use the DOS 
  728.       BACKUP utility (or something equivalent) to create your backup files. 
  729.       The BACKUP utility will prompt you for additional diskettes if they 
  730.  
  731.  
  732.                                      15
  733.  
  734.  
  735.  
  736.       are needed to receive the backup copy of your family information.  
  737.  
  738.       The DOS RESTORE utility is required to recover a file from a backup 
  739.       created with the BACKUP program.  Furthermore, the 'backup' files that 
  740.       you create with the BACKUP utility cannot be used directly by the FHS 
  741.       programs.  The backup files MUST be RESTOREd in order to be used by 
  742.       the programs.  The usual COPY command is used to recover a file from 
  743.       backups created with the COPY command.  The copies created by the COPY 
  744.       command ARE usable by the programs without having to copy them back to 
  745.       their original location.
  746.  
  747.       I would recommend always creating a backup copy of the data files 
  748.       before each extended file maintenance session, especially if your area 
  749.       is subject to power fluctuations.  I would also recommend that you not 
  750.       reuse a backup diskette until at least two subsequent backups have 
  751.       been taken.
  752.  
  753.       If portions of a data file do become unreadable, you are cautioned 
  754.       that when using standard disk utilities to remove the damaged 
  755.       sections, direct file pointers joining information together within the 
  756.       files may become unusable.  It is best in this case to return to a 
  757.       backup copy of the files.  The "validation" option, Main Menu option 
  758.       F3-E described in Section VI of this manual, may be able to eliminate 
  759.       the "pointer errors" but it will not be able to "correct" them.
  760.  
  761.       If it is necessary to restore your family file from a backup copy, you 
  762.       should always restore all three datasets from the same backup copy.  
  763.       Attempting to restore just part of a family file will likely result in 
  764.       some system maintained pointer fields becoming invalid.  This can 
  765.       cause abnormal program termination, spurious messages, or "garbage" or 
  766.       invalid information in reports.  Again the validaton program may be 
  767.       able to eliminate the problems associated with "bad pointers" if it is 
  768.       necessary to "partially restore" a file, but you will have to 
  769.       carefully examine the resulting file to determine whether any informa-
  770.       tion will have to be reentered.
  771.  
  772.       If you have an extended update session interrupted by a power failure 
  773.       or by inadvertantly turning off your PC, it is possible that some of 
  774.       the updates will not have been written to the file, which could result 
  775.       in incorrect "pointer fields" connecting records in the family file.    
  776.       The "pointer validation option" can locate and help eliminate such 
  777.       file errors as well.
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                      16
  794.