home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / GENEFILE / FHS1.ZIP / MANUAL.ARC / SECTION5.DOC < prev    next >
Text File  |  1988-09-22  |  51KB  |  916 lines

  1.  
  2.  
  3.  
  4.       V. System Reports
  5.  
  6.       This section discusses the various reports produced by the FAMILY 
  7.       HISTORY SYSTEM.  While these are standard types of reports expected 
  8.       from a genealogical record system, that is: Ancestor Report, Ancestor 
  9.       (TREE) Chart, Descendant Report, Relative Report and Individual/Family 
  10.       Group Information, some of the information displayed or terms used in 
  11.       describing the reports may be unfamiliar to you.  The following para-
  12.       graphs describe some of these terms, including those of `ancestor', 
  13.       `descendant', `lineage number', `generation level', `bloodline' and 
  14.       `related individuals'.
  15.  
  16.       A.Definitions and Report Descriptions
  17.  
  18.       An `ANCESTOR' of an individual refers to one of the parents, grand-
  19.       parents, great-grandparents, etc., of the individual.  A `DESCENDANT' 
  20.       of an individual refers to any one of his or her children, grand-
  21.       children, great-grandchildren, etc.  The parent-child relationships 
  22.       described are `blood' relationships and do not refer to `legal' or 
  23.       adoptive relationships.  (Adoptive relationships may be recorded and 
  24.       distinguished from other parent-child relationships, as described in 
  25.       Appendix C.)  Two individuals are considered to be `RELATED' if they 
  26.       have a common ancestor.  Therefore we would not consider individuals 
  27.       who are only `inlaws', that is `related' through marriage, to be rela-
  28.       tives in the above sense.  A `SPOUSE' refers to either partner in a 
  29.       marital relationship.  (One aspect of this system's files and reports 
  30.       is that they have been designed so as not to give a preferential 
  31.       status to any individual based upon their sex.)
  32.  
  33.       The `GENERATION LEVEL' of an ancestor or descendant of an individual 
  34.       refers to the number of `parent-child' relationships that separate the 
  35.       ancestor or descendant from the individual.  For example, with respect 
  36.       to a selected individual (who is said to have generation level 0), the 
  37.       generation levels of some relatives are: children (GL=+1), grand-
  38.       children (GL=+2), great grandchildren (GL=+3), parents (GL=-1), grand-
  39.       parents (GL=-2), great grandparents (GL=-3).  Notice that descendants 
  40.       have positive generation levels and ancestors have negative generation 
  41.       levels.
  42.  
  43.       The `BLOODLINE' between an ancestor and any of his/her descendants 
  44.       refers to a sequence of numbers, one for each parent-child relation-
  45.       ship that separates the ancestor from the descendant, where the number 
  46.       for a given parent-child relationship refers to the number of the 
  47.       child in that generation level who is an ancestor of the descendant.  
  48.       For example, the bloodline (3,2,4,2) indicates that the descendant is 
  49.       the 2nd child, of the 4th child of the 2nd child of the 3rd child of 
  50.       the ancestor in question.
  51.  
  52.       The `LINEAGE NUMBER' of an ancestor refers to a number that is 
  53.       assigned sequentially to the ancestors of the individual in the 
  54.       following manner:
  55.            the base individual has lineage number 1;
  56.            the individual's father has lineage number 2;
  57.            the individual's mother has lineage number 3;
  58.            the father's father has lineage number 4;
  59.  
  60.  
  61.                                      27
  62.  
  63.  
  64.  
  65.            the father's mother has lineage number 5;
  66.            the mother's father has lineage number 6;
  67.            the mother's mother has lineage number 7; etc.
  68.       In general, if an ancestor has lineage number n, then that ancestor's 
  69.       father will have lineage number 2n and the ancestor's mother will have 
  70.       lineage number 2n+1.  These are the `counting' numbers that would 
  71.       naturally be assigned to persons on the traditional `horizontal' 
  72.       ancestor tree chart.  Some relationships to notice: all male ancestors 
  73.       have "even" lineage numbers and all female ancestors have "odd" 
  74.       lineage numbers, and for a given ancestor on the chart, the lineage 
  75.       number of the child which appears on the chart is found by dividing 
  76.       the parent's lineage number by 2 (and discarding the remainder, if 
  77.       any...for example, an ancestor with lineage number 127 will have a 
  78.       child with lineage number 63 appearing on the ancestor tree).  Since 
  79.       beginning to work on these programs I have become aware that the term 
  80.       "ahnentafel number" is more commonly applied to the lineage number in 
  81.       genealogical literature, though I have become accustomed to the term 
  82.       "lineage number" and so will continue to use it in this manual.
  83.  
  84.       While "lineage number" and "bloodline" are convenient "numerical" 
  85.       concepts for describing "direct" relationships such as exist between 
  86.       an individual and his/her ancestors or descendants, the problem of 
  87.       uniquely describing one's non-direct relatives (aunts, uncles, 
  88.       cousins, etc.) is a bit more complicated.  The very definition of 
  89.       "relative" given above suggests a natural approach which would combine 
  90.       these concepts to label relatives with a "lineage number"+"bloodline" 
  91.       where the lineage number is that of the "nearest common ancestor" of 
  92.       the two individuals (that is the common ancestor with lowest lineage 
  93.       number) and the "bloodline" is the one that describes the line of 
  94.       descendancy of the relative from the common ancestor.  This is the 
  95.       approach that is used by this system's relative report for grouping 
  96.       and listing all recorded relatives of an individual.   The family 
  97.       group report provides an option for showing the relationship and 
  98.       LINEAGE of the subject of the report.  In that case, the LINEAGE 
  99.       displayed consists of:
  100.              a. the LINEAGE Number if it is an ancestor
  101.              b. the BLOODLINE, in the format (x,x,x,...,x), if it is a 
  102.                 descendant
  103.           or c. the LINEAGE Number + BLOODLINE as described above if it is a 
  104.                 non-direct relative.
  105.  
  106.       There is another method for describing relatives which, though it 
  107.       assigns a non-numeric and non-unique label to relatives, gives a more 
  108.       generally understood idea of the relationship between individuals.  
  109.       These labels are ones such as: mother, father, cousin, aunt, grand-
  110.       mother, great-great-grand-uncle, etc.  The set of rules used to assign 
  111.       such labels in the relative report (and the relative report index of 
  112.       the extended system) is the one which describes the child of a First-
  113.       Cousin as a First-Cousin-once-Removed, rather than as a Second Cousin.  
  114.       These are sometimes called the "Common" rules for relationships.  
  115.  
  116.       1. ANCESTOR Report
  117.  
  118.       The `Ancestor REPORT' produced by the system groups ancestors by 
  119.       generation level and shows the lineage numbers of the ancestors 
  120.  
  121.  
  122.                                      28
  123.  
  124.  
  125.  
  126.       listed.  Because no lines are printed for `missing' lineage numbers, 
  127.       (for ancestors not yet recorded in the files), this report is much 
  128.       more concise than the traditional ancestor chart.  The lineage numbers 
  129.       may be used to follow lines of ancestry on the ancestor report using 
  130.       the relationships described in the previous discussion concerning 
  131.       lineage numbers.  (The term `Ahnentafel list' is also used for reports 
  132.       of this type.)
  133.  
  134.       Before printing an ancestor report (or any of the other "relationship" 
  135.       reports described in this section) you must identify which individuals 
  136.       are to be listed.  This is done by entering a "Base ID" for the 
  137.       individual whose ancestors are to be listed and the number of genera-
  138.       tions of ancestors that are to be included in the report, and letting 
  139.       the program create an Ancestor WORK dataset in which the ID#'s of the 
  140.       ancestors are recorded.  This "work" dataset does not have to be 
  141.       recreated each time an ancestor report is printed if there is no 
  142.       change to the family file that would change the relationships recorded 
  143.       in it.
  144.        
  145.       If the ancestor report is printed with a "margin" of 4 or more, line 
  146.       number indicators will be printed in the margin.  These are useful 
  147.       when locating an individual by references in an ancestor report index. 
  148.       (Printing an ancestor report index is one of the extended options 
  149.       available to registered users.)
  150.  
  151.       If you have decided to identify adoptive relationships as indicated 
  152.       in Appendix C, the adoptive parent will be noted by an "*" to the 
  153.       right of the lineage number in this report.
  154.  
  155.       If a child is born to related individuals, the common ancestor of 
  156.       those individuals will appear twice on an ancestor report for that 
  157.       child.  In the ancestor reports produced by this system, such common 
  158.       ancestors will be noted and the lineage of the ancestor will be 
  159.       continued only for the ancestor's occurrence with the smallest lineage 
  160.       number.
  161.  
  162.       If you have elected to show marriage dates in this report, the date of 
  163.       marriage will only be shown on the line for female ancestors.  The 
  164.       number of years married is computed from the dates in the marriage 
  165.       record, the death dates of the spouses and/or the current date at the 
  166.       time the report is produced.  If the death date of one of the spouses 
  167.       is used to determine the number of years married, then an "*" will 
  168.       appear to the right of that number in the report.
  169.  
  170.  
  171.       2. DESCENDANT Report
  172.  
  173.       The Descendant Report may be produced in several formats.  Individuals 
  174.       may be grouped either by "generations" or by "families".  The genera-
  175.       tion grouping uses the `bloodline' to  group and `label' the indivi-
  176.       duals listed.  In so doing, individuals in the same generation who are 
  177.       `closely related' appear near one another in the report.  Brothers and 
  178.       sisters appear in succession in birth date sequence, with 1st cousins, 
  179.       2nd cousins, etc. grouped around them.  It is also easy to locate, in 
  180.       previous generations, the ancestor which an individual has on that 
  181.  
  182.  
  183.                                      29
  184.  
  185.  
  186.  
  187.       generation level by locating the individual on that level whose blood-
  188.       line forms the initial sequence of numbers in the bloodline of the 
  189.       descendant in question.  The "family" grouping will have children 
  190.       located closer to their parents, though brothers and sisters will be 
  191.       more widely separated in the report.  The report for "family" grouping 
  192.       is printed in a "chart" or "outline" format with each individual's 
  193.       name offset according to the generation in which he/she belongs.  This 
  194.       outline format will probably be easier for most people to use.
  195.  
  196.       Before printing a descendant report (or any of the other "relation-
  197.       ship" reports described in this section) you must identify which 
  198.       individuals are to be listed.  This is done by entering a "Base ID" 
  199.       for the individual whose descendants are to be listed and the number 
  200.       of generations of descendants that are to be included in the report 
  201.       and letting the program create a Descendant WORK dataset in which the 
  202.       ID#'s of the descendants are recorded.  This "work" dataset does not 
  203.       have to be recreated each time a descendant report is printed if there 
  204.       is no change to the family file that would change the relationships 
  205.       recorded in it.
  206.  
  207.       If the descendant report is printed with a "margin" of 4 or more, line 
  208.       number indicators will be printed in the margin.  These are useful 
  209.       when locating an individual by references in a descendant report 
  210.       index. (Printing a descendant report index is one of the extended 
  211.       options available to registered users.)
  212.  
  213.       If you have decided to identify adoptive relationships within the 
  214.       system as described in Appendix C, you may optionally include or 
  215.       exclude the adoptees and their descendants in this report.  When 
  216.       included, the bloodline will have an "*" next to an entry resulting 
  217.       from an adoptive parent-child relationship.
  218.  
  219.       If you have elected to show spouse information  in this report, the   
  220.       number of years married is computed from the dates in the marriage 
  221.       record, the death dates of the spouses and/or the current date at the 
  222.       time the report is produced.  If the death date of one of the spouses 
  223.       is used to determine the number of years married then an "*" will 
  224.       appear to the right of that number in the report.
  225.  
  226.       It should be noted that an individual may have more than one bloodline 
  227.       to an ancestor in the case that a child has been born to cousins or 
  228.       other related individuals, and that such persons would appear more 
  229.       than once on the `descendant tree' of such an ancestor.  The children 
  230.       of such unions are noted on the descendant report produced by the 
  231.       system and their descendants will be continued only under the first 
  232.       listed bloodline.
  233.  
  234.       3. RELATIVE Report
  235.  
  236.       This report includes entries for all relatives of an individual found 
  237.       during a search of the files which:
  238.          a. First locates all ancestors of the individual going back a user 
  239.             specified number of generations, and
  240.          b. then finds all descendants of the individual and all located 
  241.             ancestors, going forward a user specified number of generations.
  242.  
  243.  
  244.                                      30
  245.  
  246.  
  247.  
  248.       The limits on numbers of generations searched allow some control over 
  249.       the maximum "distance" located relatives will be from the individual 
  250.       used to start the search.  For example, if you are only interested in 
  251.       "offline" relations to the 1st cousin level, you would set the number 
  252.       of descendant generations searched to 2.
  253.  
  254.       Before printing a relative report (or any of the other "relationship" 
  255.       reports described in this section) you must identify which individuals 
  256.       are to be listed by first entering the "Base ID" for the individual 
  257.       whose relatives are to be listed and the numbers of generations of 
  258.       ancestors and descendants that are to be included in the report, and 
  259.       then letting the program create a Relative WORK dataset in which the 
  260.       ID#'s of the relatives are recorded.  This "work" dataset does not 
  261.       have to be recreated each time a relative report is printed if there 
  262.       is no change to the family file that would change the relationships 
  263.       recorded in it.
  264.  
  265.       The report produced is a combination of the ancestor and descendant 
  266.       reports which have been described above.  In fact the ancestor and 
  267.       descendant reports are "special cases" of the relative report as 
  268.       follows:
  269.          a. the Ancestor report is a relative report in which the number of 
  270.             "descendant" generations searched is 0, and
  271.          b. the Descendant report is a relative report in which the number 
  272.             of "ancestor" generations located is 0.
  273.       All three types of reports are produced by the same program.  
  274.  
  275.       Prior to the introduction of the relative report, the ancestor and 
  276.       descendant reports were produced by separate programs so, for the 
  277.       sake of continuity, the separate MainMenu entries are retained for 
  278.       producing ancestor and descendant reports and the format of the 
  279.       displays produced by these options reproduce those of the previous 
  280.       programs.  To avoid making the user have to unnecessarily go back to 
  281.       the MainMenu program to return to a different one of the three func-
  282.       tions of this program, a method of directly switching between these 
  283.       options is provided as follows:
  284.          a. pressing ALT+A selects the Ancestor report function (while in 
  285.             the descendant or relative report portions of the program)
  286.          b. pressing ALT+D selects the Descendant report function (while in 
  287.             the ancestor or relative report portions of the program) and
  288.          c. pressing ALT+R selects the Relative report function (while in 
  289.             the ancestor or descendant report portions of the program).
  290.  
  291.       The relative report is like a combination of the descendant reports of 
  292.       the "base" individual and all the located ancestors.  These individual 
  293.       descendant reports are presented in the lineage number sequence of the 
  294.       ancestors.  If an individual occurs in more than one descendant report 
  295.       (for example the father will appear as a child in the descendant 
  296.       report of each paternal grand-parent) then the descendants of the 
  297.       individual will only appear within the descendant report for the 
  298.       ancestor of lowest lineage number.  In subsequent "descendant" 
  299.       reports, only a single line of information will appear for the indivi-
  300.       dual with a reference to the page and line number of the next previous 
  301.       reference to the individual in the relative report.  This has the 
  302.       effect of eliminating much of the redundancy that results when pro-
  303.  
  304.  
  305.                                      31
  306.  
  307.  
  308.  
  309.       ducing separate and complete descendant reports for each of your 
  310.       ancestors.
  311.  
  312.       There is an additional piece of information that can be shown for each 
  313.       entry on the relative reports.  It is a literal describing the 
  314.       "common" relationship between the relative and the individual on whom 
  315.       the report is based.  Some of these relationship labels are:
  316.          Child, gChild, ggChild, g2gChild (great,great grandchild) etc;
  317.          Father, Mother, ggFather, ggMother, g3gFather (great,great,great 
  318.             grandfather) etc;
  319.          Brother, Sister, Niece, Nephew, gNiece, g2gNephew, etc;
  320.          Aunt, Uncle, ggAunt, g4gUncle, etc;
  321.          Cousin, 2Cousin, 3Cousin (third cousin), 4Cousin, etc;
  322.          1C1R (1st cousin, once removed), 2C3R, 4C11R, etc.
  323.       These relationships are particularly useful for getting over that 
  324.       "bloodline barrier" that sometimes makes relatives seem more distant 
  325.       than they really are.
  326.  
  327.       The options for formatting each of the "descendant" reports within the 
  328.       relative report are the same as previously described for the full 
  329.       descendant reports.  They may be produced with descendants grouped by 
  330.       generations or by families, and when grouped by families they will 
  331.       appear in a "chart" or "outline" format with names offset according to 
  332.       the generation level within the descendant report.
  333.  
  334.       If you have elected to show spouse information  in this report, the   
  335.       number of years married is computed from the dates in the marriage 
  336.       record, the death dates of the spouses and/or the current date at the 
  337.       time the report is produced.  If the death date of one of the spouses 
  338.       is used to determine the number of years married then an "*" will 
  339.       appear to the right of that number in the report.
  340.  
  341.       Another type of information that can be included in the relative 
  342.       report (and after Sept 86 also the Ancestor and Descendant reports) is 
  343.       the "COMments" that you have recorded under the name and spouse 
  344.       records in your family files.   Prior to the introduction of this 
  345.       report, comment information was only printable in the Family Group 
  346.       Reports. Being able to include these notes in the lists produced by 
  347.       the system, should make them more accessible and useful in your 
  348.       continuing research efforts.
  349.  
  350.       The COMment information appears on separate lines following the line 
  351.       of standard information for a relative or spouse.  It is preceded by a 
  352.       "COM:" literal, and individual comment lines in the family files are 
  353.       joined together to form longer lines whose length is determined by the 
  354.       length of the standard data line for the types of information you have 
  355.       chosen to include in the report.
  356.  
  357.       Beginning in Sept 1988, it became possible to isolate parts of the 
  358.       comment information for optional exclusion from the printed comments.  
  359.       This is done by enclosing the text of those comments within "braces" 
  360.       or "curly brackets" ("{" and "}").  If you choose to print comments, 
  361.       then you will be asked if you want to"
  362.                       Print Bracketed Comments? (Y/N/S)
  363.       If you respond "Y", the "bracketed" comments will be included in the 
  364.  
  365.  
  366.                                      32
  367.  
  368.  
  369.  
  370.       report, though the braces will be replaced with spaces.  If you reply 
  371.       "N", then the bracketed comments and the enclosing braces will be 
  372.       replaced by a single space in the formatted comments.  (If the entire 
  373.       comment area is enclosed in braces, then no comment area will be 
  374.       printed.)  Finally, if you respond with an "S" then the bracketed 
  375.       comments will be printed along with the enclosing braces.  (The "S" 
  376.       stands for "S"how braces.)
  377.  
  378.       Note: This joining of comment lines may have an adverse effect on the 
  379.         appearance of your reference material if you have made any attempt 
  380.         to "prettily" format the information in the "view" for entering 
  381.         comments in the file maintenance program.  Any "vertical alignment" 
  382.         of information will be lost, and imbedded strings of three or more 
  383.         successive blanks (in the middle of a file comment line) will result 
  384.         in the loss of text on that line that follows the blank interval.  
  385.         My suggestion for entering comment information is that you use a 
  386.         "free form" format, typing everything as one continuous line.   Do 
  387.         not use hyphens at the end of lines in the entered text.  The 
  388.         routines for printing comments will rejoin words which span two 
  389.         comment lines.  Words which would extend beyond the end of a printed 
  390.         comment line are moved to the beginning of the next line (wordwrap).
  391.  
  392.         After Dec 1986, a backslash "\" character in a comment line will be 
  393.         treated as a request to begin a new line in the formatted comment 
  394.         text.  You may use this to keep the comment lines from all being 
  395.         combined into a single block of text.
  396.  
  397.       4. ANCESTOR CHARTs and MAPs
  398.  
  399.       The system also produces ANCESTOR CHARTS for an individual in the 
  400.       traditional `horizontal tree' format, with an individual appearing on 
  401.       the left (center) of the page and the parents appearing to the right 
  402.       above (father) and below (mother) the line on which the individual is 
  403.       identified.  Because only 4 generations of ancestors (comprising 15 
  404.       individuals) may appear on a single chart, several charts may be 
  405.       required to show all ancestors on file for an individual.  The Family 
  406.       History System has been designed to produce as many `subcharts' as are 
  407.       required to show all recorded ancestors.  In doing so, it is necessary 
  408.       to employ some scheme to show how to proceed from one chart to the 
  409.       next in a set.  I have chosen to assign a `chart-ID' to each of the 
  410.       charts produced.  This chart-ID consists of the generation level of 
  411.       the ancestor appearing to the left on the chart, and the number of 
  412.       that ancestor within that generation level.  Some chart-ID's would be 
  413.       0-1 (the first chart of a set), 4-1, 4-2, 4-3,...,4-16,8-1,8-2,...,8-
  414.       256, etc.  Charts will be printed only if an ancestor has been 
  415.       recorded on the chart.  If an ancestral line may be continued beyond 
  416.       one of the charts in the series, then the chart-ID for the appropriate 
  417.       continuation chart will be shown on the right side of the chart to be 
  418.       continued.
  419.  
  420.       Individual entries on the chart may be numbered from 1 to 16 on each 
  421.       chart, or you may choose to label each entry with the lineage number 
  422.       of the ancestor recorded on the line.  
  423.  
  424.       If you have decided to identify adoptive relationships as indicated in 
  425.  
  426.  
  427.                                      33
  428.  
  429.  
  430.  
  431.       Appendix C, the adopted parent will be noted on the ancestor chart 
  432.       with an "*" in the first position of the NAME field.
  433.  
  434.       The "Spouse of Entry #1" appearing in the lower left corner of each 
  435.       chart is the most recent spouse of the individual listed in entry #1 
  436.       and may not be the "paired" ancestor on the chart.
  437.        
  438.       Blank ancestral charts may be produced for recording ancestral infor-
  439.       mation prior to entering the information into the system's files.
  440.  
  441.       (New in Sept 1988) You may also print an ALL GENERATION Chart which, 
  442.       though not as formally presentable as the 4 Generation Charts, has the 
  443.       advantage of providing a complete overview or MAP of ALL (up to 50 
  444.       generations) of the recorded ancestors for an individual in a single 
  445.       report.  The format of this report is such that:
  446.            the information for each ancestor occupies a single line 
  447.            no lines are produced for "missing" ancestors
  448.            the line for the father of an individual on the report is above 
  449.                the line of information for the individual
  450.            the line for the mother of an individual on the report is below 
  451.                the line of information for the individual
  452.            the information for ancestors is offset 4 spaces to the right for 
  453.                each generation level
  454.            all parent-child relationships are graphically represented by 
  455.                lines connecting the child to the parent(s).
  456.  
  457.       The information shown for each ancestor includes:
  458.            The lineage number of the ancestor
  459.            (Optionally) the ID # of the ancestor, within parentheses
  460.            The ancestor's NAME, in "Given-Name Surname" format
  461.            (Optionally) the birth/death dates and age, in the format
  462.                     b. 7 Apr 1863,d.10 Feb 1937 at age 73
  463.            (the age is shown only if both birth and death years are known 
  464.             and if either date's month and day are unknown an "?" will 
  465.             appear to the right of the age)
  466.  
  467.       This ALL GENERATION Ancestor Chart or MAP is printed continuously 
  468.       in a single long report with no breaks at page boundaries.  Up to 20 
  469.       generations of ancestors may be printed using compressed print on   
  470.       8 1/2" wide paper.  Reports which exceed the width of the available 
  471.       paper can be printed out in 2 or more strips using the OFFSET Printer 
  472.       parameter.  For example, suppose you wish to print a report that would 
  473.       require a 150 character print line but you are using a font and form 
  474.       which only allow 80 printed characters.  You can then print the report 
  475.       once with a Form Width of 80 and OFFSET=0 to get the left most 80 
  476.       characters of each print line and then print it again with an OFFSET 
  477.       of 80 to get the right most 70 characters of each print line.  The two 
  478.       strips can then be joined together along the side to produce a 
  479.       complete ancestor Map.
  480.        
  481.  
  482.       5. Family Group Report
  483.  
  484.       The FAMILY GROUP REPORT produced by the system is intended to provide 
  485.       a complete listing of information on record for an individual.  Infor-
  486.  
  487.  
  488.                                      34
  489.  
  490.  
  491.  
  492.       mation that may be printed includes: personal information (name, 
  493.       birth/death dates and places), parents, spouse(s), spouse's parents, 
  494.       children, child's (latest) spouse, and all residence information for 
  495.       the individual.  The report may also show the "other" types of infor-
  496.       mation from Medical, Educational, Work and Military records.  In 
  497.       addition, all addresses and comments relating to the above information 
  498.       can be included in the report.  Beginning in Sept 1988 it is also 
  499.       possible to include a line which shows the Relationship and Lineage of 
  500.       the subject of the report based upon a supplied relationship work 
  501.       file (i.e. an Ancestor/Descendant/Relative work file).
  502.  
  503.       The `viewing area' in the lower right corner of the screen lists the 
  504.       types of family file information that you may optionally include in 
  505.       the family group report.  Using program option F6, you may specify 
  506.       whether or not a category of information is to be INCluded and the 
  507.       MINimum number of entries of that type that are to be shown.  If a 
  508.       category is to be included but the minimum number of entries is set to 
  509.       0, then a section for that type of information will appear in the 
  510.       report only if there is information of that type recorded in the 
  511.       family file.  A section will appear in a blank family group report 
  512.       form only if the MINimum number of entries for that section is not 0.
  513.  
  514.       There are two entries for comments in the list of information types.  
  515.       The first controls the printing of NAME and SPOUSE record comments; 
  516.       the last entry in the list controls all other comments.  Several 
  517.       people have requested being able to print both the SPOUSE record 
  518.       comments and the spouse's NAME record comments under the spouse entry 
  519.       in this report.  This is allowed by the INClude parameter for the 4th 
  520.       item in the list.  If it has a value of "A" (for ALL), then both the 
  521.       spouse record comments and the spouse's name record comments will be 
  522.       printed (with a blank line separating them if they are both present); 
  523.       if the INC parameter has a value of "Y" then just the spouse record 
  524.       comments will be printed.   
  525.  
  526.       You will probably want to produce a Family Group report for each of 
  527.       your ancestors (male and female) and any descendants who have main-
  528.       tained separate households.  To help simplify the task of printing the 
  529.       many Family Group reports that you will want to be saving, you are 
  530.       given several options for BATCH printing of family group reports.  You 
  531.       may enter a list of ID #'s for reports that you want printed, or you 
  532.       can instruct the program to read a relationship file (Ancestor/ 
  533.       Descendant/ Relative Work file) or a SELECT.WRK file to determine 
  534.       which reports are to be printed.  It is therefore relatively easy to 
  535.       print reports for all ancestors of an individual or for all descen-
  536.       dants or relatives of a given individual.  When printing reports using 
  537.       one of these lists of ID#'s, you may also request to BYPASS the 
  538.       printing of reports for children whose own group report contains no 
  539.       information that is not found on the one being printed for a parent or 
  540.       for wives whose own family group report contains no information that 
  541.       is not found on the one being printed for the husband.  (The last 
  542.       option may sound a bit sexist, but I believe it probably conforms to a 
  543.       common procedure for maintaining files of family group reports.)
  544.  
  545.       Program option F4 requests the printing of reports for the selected 
  546.       individuals.  When printing reports for ID's in a list (either entered 
  547.  
  548.  
  549.                                      35
  550.  
  551.  
  552.  
  553.       individually or read from a file) you may specify whether to print the 
  554.       reports in ID# sequence or in the order specified by an INDEX file. 
  555.       (Creating an INDEX file is one of the extended options for the system.  
  556.       It may be either a SORTED Index or one which sequences a group of 
  557.       ancestors, descendants or relatives in the order that they would 
  558.       appear in one of the relationship reports.)  Further, you may request 
  559.       that the reports be printed separately or that they be merged into a 
  560.       single report with a line of asterisks separating individual reports.  
  561.       In the merged report, pages are numbered sequentially and line number 
  562.       indicators are placed in the margins (when the margin is >3) to assist 
  563.       in locating the source of references in the report indexes produced by 
  564.       one of the system's extended options.  The merged family group report 
  565.       is intended to simplify the task of producing booklets of family 
  566.       information. 
  567.  
  568.       a. Identifying Group Reports to be Printed
  569.  
  570.          Group reports that are to be printed are identified by giving the 
  571.          program the ID # of the primary subject of the report.  Program 
  572.          option:  "F3  Change SELECT Type or ID's"   allows you three ways 
  573.          of entering these ID's.  When you press the F3 key you will be 
  574.          asked to:
  575.           Select: 1)Single ID 2)List of ID's 3)Select File 4)Relative File 
  576.  
  577.          If you choose "1", you will be asked to enter a single ID (in the 
  578.          middle of the screen where it says:  "Processing ID #:"
  579.          The Name record corresponding to the ID # will be retrieved and 
  580.          the name found there will be displayed to confirm your selection.  
  581.          This option was the only one provided prior to Oct 87.  When using 
  582.          this mode of selection, the printing of the reports is handled just 
  583.          the same as it was prior to Oct 87.
  584.  
  585.          If you choose SELECT option "2) List of ID's", the bottom line of 
  586.          the screen will be formatted with an "option line", and the 
  587.          blinking cursor will appear near the middle of the screen to the 
  588.          right of the label "Processing ID #:".  You can enter a list of 
  589.          individual ID numbers by typing each one on the screen and pressing 
  590.          the enter key.  After entering an ID#, the corresponding name 
  591.          record will be retrieved and the name found in the record will be 
  592.          displayed to the right of the ID#.  You can enter a range of ID #'s 
  593.          by pressing the F2 key and following the prompts that appear on the 
  594.          bottom line of the screen.  Pressing the F3 key will delete the 
  595.          currently displayed ID from the list.  All ID #'s entered are kept 
  596.          in a list in ID# sequence and you may use the PGUP and PGDN keys to 
  597.          move up and down the list to review previously entered ID's.  The 
  598.          CTRL+PGUP and CTRL+PGDN key combinations will move you respectively 
  599.          to the lowest and highest ID #'s in the list.  Near the right 
  600.          center portion of the screen the number of ID #'s currently in the 
  601.          list and the total number of name records in the file are 
  602.          displayed.  You may press the F10 key to SAVE the list in a SELECT 
  603.          Work file for later reuse.  After you have finished adding all the 
  604.          ID #'s to the list that you want, press the F1 key to terminate the 
  605.          process. You can return to change a previously entered list of ID 
  606.          #'s by pressing the F3 key and then the SPACE bar.
  607.  
  608.  
  609.  
  610.                                      36
  611.  
  612.  
  613.  
  614.          If you choose SELECT options "3" or "4" then the SELECT work file 
  615.          or the relationship work file, respectively, (identified in the 
  616.          File name section of the screen display) will be used to determine 
  617.          the ID #'s for which family group reports are to be printed.  The 
  618.          name record for the first ID in the resulting list will be 
  619.          retrieved and the individual's NAME displayed.  The number of 
  620.          reports selected for printing and the total number of name records 
  621.          in the file will be displayed at the right center part of the 
  622.          screen.  You may then proceed to change the list just as described 
  623.          in the previous paragraph.
  624.  
  625.       b. Printing Family Group Reports
  626.          
  627.          When you use function F4 to print family group reports for a list 
  628.          of ID#'s or for ID #'s in a work file, you will be given the 
  629.          choice of printing the reports in ID # sequence or in INDEXed 
  630.          sequence (described by the INDEX File in the File name section).  
  631.          Creation of an INDEX file is one of the functions provided by the 
  632.          extended protion of the system.
  633.  
  634.          You will be asked whether you want to:
  635.                   Show Relationship and LINEAGE? (Y/N)
  636.          If you reply "Y", then the file described by the RELATIVE file 
  637.          description among the FILE NAMES will be used to create a relative 
  638.          table.  While the group reports are being printed, the relative 
  639.          table will be used to determine the RELATIONSHIP (g3gFather, 3C4R, 
  640.          etc.) and LINEAGE (lineage number+bloodline) of the subject of the 
  641.          report, if the subject is among the individuals included in the 
  642.          table. 
  643.  
  644.          You will also be asked whether you want to:
  645.                    Print Bracketed Comments? (Y/N/S)
  646.          Beginning with the Sept 1988 update, you were given the option of 
  647.          enclosing the text of certain comments with braces or "curly 
  648.          brackets" ("{" and "}"), for instance to isolate sensitive or 
  649.          conjectural remarks that you might not want to make generally 
  650.          available.  If you reply "Y" to the above query, then bracketed 
  651.          comments will be printed along with the rest and the brackets will 
  652.          be replaced with spaces.  If you reply "N", the bracketed comments 
  653.          (including the brackets) will be replaced by a single space.  If 
  654.          you reply "S" then the bracketed comments will be printed along 
  655.          with the brackets.
  656.  
  657.          When printing family group reports from a list of ID's, you are 
  658.          given an opportunity to eliminate the printing of certain reports 
  659.          whose information duplicates that found on another report that is 
  660.          being printed.  In particular, you will be asked:
  661.             Bypass Blank reports for  1)Children  2)Wives  3)Both  4)Neither
  662.          Bypassing "Blank reports for Children", means to eliminate the 
  663.          printing of a report for an individual whose parent's group report 
  664.          is being printed and for whom there is no information being printed 
  665.          in the child's report beyond that which appears in that of the 
  666.          parent(s).  For instance, if you are printing family group reports 
  667.          for all descendants of an ancestor this option would allow you to 
  668.          skip printing Family Group Reports for the many persons (including 
  669.  
  670.  
  671.                                      37
  672.  
  673.  
  674.  
  675.          minor children) who have simply been listed as a child on one 
  676.          Family Group Worksheet but for whom you have never received or had 
  677.          need to create a separate Family Group Worksheet of their own.  
  678.          Similarly, bypassing "Blank reports for Wives" means to eliminate 
  679.          the printing of a report for a wife if the husband's report is to 
  680.          be printed and her own group report would have no information on it 
  681.          beyond that that appears on the group report of her husband.  
  682.  
  683.          You are given two format options for printing family group reports 
  684.          from a list of ID's.  In particular, you will be asked to:
  685.                     Select:  1)Separate Reports  2)Merged Reports
  686.          If you enter "1" then separate Family Group Reports will be printed 
  687.          for each ID in the ID List that has been created (who is not 
  688.          Bypassed as described in the preceding paragraph) just as if you 
  689.          had printed them separately and individually.  Any other response 
  690.          will result in all family group reports being printed continuously 
  691.          with a line of "* * * *" separating them.  The pages in the 
  692.          resulting report will also be sequentially numbered.  In effect, 
  693.          this provides you with still another type of report...one which can 
  694.          show ALL information in the file for each individual.  The MINimum 
  695.          counts of the types of information to be included will be assumed 
  696.          to be zero (sections will be shown for information of a given type 
  697.          only if it is to be INCluded and there actually is information in 
  698.          the file for the individual whose family group report is being 
  699.          printed).  One of the options in the extended part of the system 
  700.          allows you to produce a printed index for this report with the page 
  701.          and line numbers for each reference to each individual in any of 
  702.          the family group reports printed.
  703.  
  704.          When printing batches of family group reports, you will be asked 
  705.          whether to:   Start at Beginning of LIST? (Y/N)
  706.          If you reply "N" then if you are printing separate group reports, 
  707.          you will be asked to:
  708.                     Enter Starting ID=xxxx
  709.          or if you are printing a merged family group report, you will be 
  710.          asked to:  Enter Starting Page=xxxx
  711.          This allows you to restart the printing of a batch of family group 
  712.          reports without having to reprint those that have already been 
  713.          successfully processed.  
  714.  
  715.          Finally, when printing batches of family group reports, you will be 
  716.          asked before printing each report:
  717.                         Print Report for ID=xxxx  (Y/N/A)
  718.          If you reply "N" then the next ID to be printed will be looked up 
  719.          and a similar message will be shown for it.  If you reply "A" then 
  720.          this report and all succeeding ones will be printed until you 
  721.          terminate a report by pressing the SPACE key to pause it, and then 
  722.          the ESCape key to cancel it.  If you cancel a report, then you will 
  723.          again be asked whether you want to print a report for the next ID.  
  724.          If you press the ESCape key when this prompt is displayed, then the 
  725.          entire print process will be terminated.
  726.  
  727.       Note: The batch printing of family group reports was added in Oct 87.  
  728.         Although I had previously tried to keep all references to extended 
  729.         options out of the basic set of programs, at that time I was forced 
  730.  
  731.  
  732.                                      38
  733.  
  734.  
  735.  
  736.         to either leave the references to the INDEX file in the family group 
  737.         report program distributed with the basic set of programs or 
  738.         maintain two separate group report programs (one of which would 
  739.         probably not have any "batch" print option in it).  I decided that 
  740.         it would be better that the users of the basic set of programs have 
  741.         to put up with these extraneous (to them) references rather than 
  742.         limit them to having to print group reports one at a time.  In fact, 
  743.         the Merged Family Group report adds an ID sequenced list feature 
  744.         that has previously been missing from the public version of the 
  745.         programs.    
  746.  
  747.  
  748.       B. Report Program Parameters
  749.  
  750.       Each report program permits the operator to change several 'para-
  751.       meters' that control the information going into a report as well as 
  752.       the format of the output.  This includes the names of system input and 
  753.       work files as well as printer destination and `setup', and form size.  
  754.  
  755.       Changes to the report parameters are made by selecting the type infor-
  756.       mation to be changed using the appropriate function key, changing the 
  757.       information on the screen (using TAB and SHIFT+TAB to move between 
  758.       updatable fields just as in the file maintenance program) and pressing 
  759.       the ENTER or RETURN key when all desired changes have been made.  
  760.  
  761.       Printer destination can be LPT1: or  LPT2: (parallel printers), COM1: 
  762.       or COM2: (serial printers), or SCRN:.  In the case that the destina-
  763.       tion is set for SCRN:, you will not be prompted to identify whether a 
  764.       report is to be sent to the screen or printer.  The printer setups 
  765.       selected must previously have been created (using MAIN MENU option  
  766.       F3-C).  The report programs will issue a form feed and print new 
  767.       header lines when the number of lines printed on a page exceeds .9 of 
  768.       the form length.  
  769.  
  770.       The report programs will also permit you to route your printer output 
  771.       to a file.  Some users have taken advantage of this feature to print 
  772.       reports with a longer print line than is normally allowed for their 
  773.       printer and then using a sideways printing utility to process the 
  774.       report output file.  You may want to create a separate printer table 
  775.       just for this process.
  776.  
  777.       The `MARGIN' parameter allows you to indicate the left margin offset 
  778.       in numbers of blank characters.  This is to allow room for binding or 
  779.       punching holes for inserting the report in a notebook.  (Note that 
  780.       when printing the Ancestor, Descendant, Relative or "batched" Family 
  781.       Group reports, use of a margin >3 will result in the placement of 
  782.       "line number" indicators in the margin area.  These are useful when 
  783.       locating a reference from the report index, which may be produced as 
  784.       an option of the extended system.
  785.  
  786.       The `Form OFFSET' parameter may be used to print a report (in more 
  787.       than one pass) when a selected printer or printer font is unable to 
  788.       print an entire report line.  For example, if you are using a font 
  789.       which allows only 80 characters across a page but the report line 
  790.       requires 132 characters, you could print the first eighty characters 
  791.  
  792.  
  793.                                      39
  794.  
  795.  
  796.  
  797.       of the line with an OFFSET=0 and print the report again with OFFSET=80 
  798.       to pick up the last 52 characters of the report line.
  799.  
  800.       The ancestor/descendant/relative report program will print each indi-
  801.       vidual's information on two lines in the case that birth and death 
  802.       places are to be shown and the form size is too narrow to put all 
  803.       information on a single line.  When individual record ID's are also 
  804.       being printed, these may appear on a 2nd line if the form is too 
  805.       narrow to include the information on a single line.
  806.  
  807.       While producing any of the reports, the program may be temporarily 
  808.       interrupted by pressing the `space bar' or any of the `character 
  809.       keys'.  The report may then be continued by again pressing the space 
  810.       bar (or one of the character keys) or may be terminated by pressing 
  811.       the ESC key.  If you use the PGDN key to continue a report, then the 
  812.       program will pause at the top of the next page of output.  This may 
  813.       prove convenient for pausing a printer that is running low on forms.  
  814.       You can continue the printing by pressing any key.
  815.  
  816.  
  817.       C. Report Program WORK FILES
  818.  
  819.       There are several types of "work" datasets that are used in the Family 
  820.       History System.   These are semi-temporary files that are used to 
  821.       store information derived from certain processes so that those 
  822.       sometimes lengthy processes do not have to be repeated too frequently.  
  823.       Among these work datasets are the RELATIONSHIP Work Files, the SELECT 
  824.       Work file and the INDEX File.
  825.  
  826.       A RELATIONSHIP WORK FILE must be created prior to producing the 
  827.       ancestor, descendant or relative reports or the ancestor charts.  
  828.       Although there appear to be three types of relationship files: 
  829.       ancestor, descendant and relative, in fact these all share a common 
  830.       format...the only differences being in the number of generations of 
  831.       ancestors or descendants that are to be searched in order to build the 
  832.       work file.  In building an Ancestor work file, no search is performed 
  833.       for descendants at all.  In building a descendant work file, no search 
  834.       is performed for ancestors.  While in creating a relative work file, 
  835.       the program first searches for all ancestors and then all descendants 
  836.       of the ancestors.  Actually, you are asked to specify the maximum 
  837.       number of generations that are to be included in the work dataset.  
  838.       This is done to permit you to exercise some control over the extent to 
  839.       which lines of ancestry or descendancy will be followed in producing 
  840.       the report.  A work dataset may be reused (without recreating it) if 
  841.       no new or changed relationships have been recorded in the family file 
  842.       used to create it.
  843.  
  844.       Another type of work file is the SELECT file used by the Family Group 
  845.       Report program and the export/import program.  (Among the file 
  846.       extensions, this work file is also used in the Search/Select/LIST 
  847.       program and in the Report Indexing program.)  This file is essentially 
  848.       an ID sequenced "check list" of individuals that have been chosen for 
  849.       processing.  It permits the system to isolate the sometimes complex 
  850.       process of selecting ID #'s to certain programs but to pass the 
  851.       results of the selection process to other programs in the system.
  852.  
  853.  
  854.                                      40
  855.  
  856.  
  857.  
  858.  
  859.       Still another type work file used by programs in the public portion of 
  860.       the Family History System is the INDEX File.  This is a file which 
  861.       contains a complete but re-ordered sequence of ID #'s.  The reordering 
  862.       could be accomplished by SORTing the ID#'s based upon the contents of 
  863.       certain fields, for instance in Surname, Given Name sequence or in 
  864.       birthdate sequence.  The reordering could also represent the sequence 
  865.       that individuals identified in a relationship work file would be 
  866.       listed in an ancestor, descendant or relative report.  This last type 
  867.       index is most likely to be used for printing family group reports in 
  868.       "relationship sequence".  The option for creating an INDEX file is one 
  869.       of the extended options provided to registered users of the system.
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.                                      41
  916.