home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / f / rootsm.arc / BPRINT.DOC < prev    next >
Encoding:
Text File  |  1979-12-31  |  5.5 KB  |  123 lines
  1.                    ROOTS BASEFILE PRINT UTILITY
  2.    
  3.    
  4.    
  5.    The ROOTS Basefile PRINT Utility (BPRINT) sends  all  of the
  6.    data in a specified  basefile to a printer.  BPRINT provides
  7.    a written copy of all data created  by the ROOTS  editor for
  8.    the  primary purpose of creating a compact permanent record.
  9.    To  save paper, cross referencing is used for  many  of  the
  10.    record  components.
  11.    
  12.    BPRINT will interface with 72, 80  or  132  column printers.
  13.    An example of the  how to use the  BPRINT  output  with  the
  14.    Bright  basefile  (BASEFILE.BIN  in  the  HDOS  version  and
  15.    BRIGHT.BIN in the CP/M version) is  given  below.  Refer  to
  16.    the  instructions given in the  next  section to create your
  17.    own  copy  of  the Bright  basefile  listing.  The  printout
  18.    starts  with  the file name, and is followed by  the reports
  19.    listed below (note that all numeric values are in decimal):
  20.    
  21.    SUBJECT RECORDS.  The subject records are printed in numeric
  22.    sequence, starting with record number 1.  Record numbers are
  23.    the  same  as those provided by  the  ROOTS  editor.  BPRINT
  24.    then  prints  the  subject's sex,  birthplace,  death  date,
  25.    deathplace, father and mother.  Dates are shown as  they are
  26.    printed  on  the  ROOTS Pedigree  Charts  and  Family  Group
  27.    Sheets, but places are given as numeric  place  code  refer-
  28.    ences.  Next,  BPRINT  will search the marriage records  for
  29.    any  marriages which include the current subject.  The first
  30.    four marriages are  listed by numeric marriage record number
  31.    (any additional marriages  will be  included in the marriage
  32.    printout,  but will not be referenced  in  the  subject  re-
  33.    cord).  Finally,  the  name  of  each subject is printed  in
  34.    full,  followed by an  asterisk if the flag is set for  that
  35.    subject.
  36.    
  37.    PLACE  RECORDS.  Places are listed by place  code,  starting
  38.    with place number 1. A place code record might be coded as a
  39.    "string-1" place, a "string-2" place,  or a "string-1" place
  40.    that  includes  a  reference  to a  2nd  string  place.  For
  41.    convenience, each place printout is expanded to include both
  42.    strings  in the  same format as is used on the ROOTS editor,
  43.    viz
  44.    
  45.              1st only______  ________________
  46.              ______________  2nd only________
  47.              1st of two____  2nd of two______
  48.    
  49.    MARRIAGE RECORDS.  Marriage records are  listed  in  the se-
  50.    quence  encountered in  the file.  Marriage listings include
  51.    the marriage number, which is  referred  to  in  the subject
  52.    record.  The marriage number  is  followed  by  the marriage
  53.    date  and  place  code, the husband subject number, and  the
  54.    wife subject number.
  55.    
  56.    To see how the BPRINT cross referencing works,  find  record
  57.    number  3  on  the  Subject Records listing.  Note that this
  58.    record is for Archibald Bright, who is male,  was born on 11
  59.    Mar 0813, in place number 1 (Moorhead).  Archibald died on 8
  60.    Sep 0851 in place 2 (Oxland).  His father  was person number
  61.    1 (Alistair Bright) and his mother was person number 2 (Anne
  62.    Pritkin).  Finally, his marriage data is  contained  in mar-
  63.    riage record number 1.  Going to the Marriage Record listing
  64.    we find that marriage number 1  was on 4 Dec 0829 in place 3
  65.    (Regencia) between person  number  3  (Archibald Bright) and
  66.    person number 4 (Gwendolyn Gibbon).
  67.    
  68.    
  69.    
  70.    Using the Basefile Print Utility
  71.    
  72.    
  73.    BPRINT is a stand-alone utility which operates independently
  74.    of  ROOTS89  or  ROOTS/M.  The LP: device driver is used for
  75.    the HDOS version, while the LST:  device is used for CP/M.
  76.    
  77.    To run the program when in the HDOS command mode, type
  78.    
  79.            BPRINT filename.ext
  80.    
  81.    The name of the file to be printed should be  typed in place
  82.    of  "filename.ext".  If  a drive number does not precede the
  83.    filename, SY0 will be assumed.  Follow  the filename  with a
  84.    RETURN.
  85.    
  86.    To  run the program when in the CP/M command  mode  use  the
  87.    same procedure.  The  default drive will be the one on which
  88.    BPRINT resides.  If the  filename is on another drive, spec-
  89.    ify the drive as part of the filename.
  90.    
  91.    Once  the  program starts you will be asked  for  the  print
  92.    format.  A  column  width of 72, 80 or 132 may be specified.
  93.    Note that the 132 column format is the  easiest  to read and
  94.    is most efficient in its use of paper.
  95.    
  96.    
  97.    
  98.    What can be learned from the BPRINT listing
  99.    
  100.    
  101.    In addition to serving as a permanent  hard  copy  of all of
  102.    the  data in your  basefile, BPRINT can help you spot errors
  103.    in  data entry.  Once you remove the  errors with the  ROOTS
  104.    Editor, the Basefile can be refined  with the ROOTS  Cleanup
  105.    Utility to provide more room for correct data.
  106.    
  107.    The  errors  to  look  for  in the basefile listing  include
  108.    inconsistencies  in names and places, extra spaces added  in
  109.    the place fields, and incorrectly  spelled  names.  For  ex-
  110.    ample,  if  you  use  "NJ" in one place and "New Jersey"  in
  111.    another,  memory space is wasted.  If sometimes you  use the
  112.    TAB key to move the cursor to the second place  field and at
  113.    other  times use the SPACE bar,  the  two  entries  will  be
  114.    considered  to  be  separate entries and extra memory  space
  115.    will be used.
  116. bbon).
  117.    
  118.    
  119.    
  120.    Using the Basefile Print Utility
  121.    
  122.    
  123.    BPRINT is a stand-alone utility which operates independ