home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / DATABASE / TTGEN10C.LBR / SPEC.TZ / SPEC.TT
Text File  |  2000-06-30  |  11KB  |  291 lines
  1.  
  2. TITLE:         Tiny Tafel Specification
  3.  
  4.  
  5. VERSION:       1.6 (11 December 1986)
  6.  
  7.  
  8. FROM:          COMMSOFT
  9.                2257 Old Middlefield Way
  10.                Mountain View, CA 94903
  11.                (415) 967-1900
  12.  
  13.                Please forward any comments and suggestions regarding this
  14.                specification to COMMSOFT at the above address.
  15.  
  16. OBJECTIVE:
  17.  
  18. Provide a compact way of describing a family database so that the information
  19. can be scanned visually or by computer.
  20.  
  21.  
  22. ACKNOWLEDGEMENTS:
  23.  
  24. This specification is based on an article titled Tiny-Tafel for Database Scope
  25. Indexing by Paul Andereck in the April-May-June 1986 (vol 5, number 4) issue of
  26. Genealogical Computing.
  27.  
  28.  
  29. CONSTRAINTS:
  30.  
  31. All data fields are fixed length for easy parsing by software with the obvious
  32. exceptions of the surnames and optional places.
  33.  
  34. Optional removal of apparent redundant lines (as determined by Soundex code and
  35. actual surname).
  36.  
  37.  
  38. FORMAT:
  39.  
  40. Header:
  41.  
  42. Column                     Description
  43. ______                     ___________
  44.  
  45. 1               Header type
  46. 2               Space delimiter
  47. 3 - n           Text (n < 38)
  48. (n + 1)         Carriage Return
  49.  
  50.  
  51. Defined types:
  52.  
  53. Header
  54.  Type                   Description                      Remarks
  55.  ____                   ___________                      _______
  56.  
  57. N       Name of person having custody of data          Mandatory first record
  58.  
  59. A       Address data                                   0 to 5 address lines
  60.                                                        Optional
  61.  
  62. T       Telephone number including area code           Optional
  63.  
  64. S       Communication Service/telephone number         0 to 5 service lines
  65.         (MCI, ITT, ONT, RCA, ESL, CIS, SOU, etc,       Optional
  66.         e.g., CIS/77123,512)
  67.  
  68. B       Bulletin Board/telephone number                Optional
  69.  
  70. C       Communications nnnn/X/P                        Optional
  71.             nnnn = maximum baud rate
  72.             X = O(riginate only), A(nswer only), B(oth)
  73.             P = Protocol (Xmodem, Kermit, etc.)
  74.  
  75. D       Diskette format d/f/c                          Optional
  76.             d = diameter (3, 5, 8)
  77.             f = format MS-DOS, Apple II, etc.
  78.             c = capacity, KB
  79.  
  80. F       File format                                    Free-form, optional
  81.             ROOTS II, ROOTS/M, PAF Version 1, etc.
  82.  
  83. R       Remark                                         Free-form, optional
  84.  
  85. Z       Number of data items with optional text        Required last item
  86.  
  87.         In the COMMSOFT Tiny Tafel, the name of the database, the version of
  88.         the database, and any special switches used when the Tiny Tafel was
  89.         generated are shown on the Z line.  The definitions of the special
  90.         switches are shown below.
  91.  
  92.         D
  93.                 DATEFILLDISABLED.  Tiny Tafel normally suppresses the output of
  94.                 data for which the birthdates necessary to establish each line
  95.                 of output are missing.  When this switch is on, The Tiny Tafel
  96.                 generator has estimated missing dates.  The Tiny Tafel program
  97.                 applies a 30 year per generation offset wherever it needs to
  98.                 re-construct missing dates.
  99.  
  100.         N
  101.                 NOGROUPING.  Tiny Tafel normally "groups" output lines that
  102.                 have a common ancestor into a single line containing the most
  103.                 recent birthdate.  Descendants marked with an interest level
  104.                 greater than zero, however, will have their own line of output
  105.                 (see below for definition of interest level).  Alternatively,
  106.                 when this switch is enabled, one line of output is created for
  107.                 every ultimate descendant (individual without children).
  108.  
  109.         M
  110.                 MULTIPLENAMES.  Tiny Tafel normally lists a surname derived
  111.                 from the descendant end of each line.  Specifying this option
  112.                 lists all unique spellings of each surname (up to five)
  113.                 separated by commas.
  114.  
  115.         P
  116.                 PLACENAMES.  Tiny Tafel will include place names for family
  117.                 lines when this switch is enabled.  Place names will be the
  118.                 most significant 14 to 16 characters of the birth field.  When
  119.                 this option is enabled, the place of birth of the ultimate
  120.                 ancestor and the place of birth of the ultimate descendant of a
  121.                 line of output, respectively, are added to the end of the line.
  122.  
  123.         S
  124.                 SINGLEITEMS.  Tiny Tafel normally suppresses lines of output
  125.                 that correspond to a single individual (that is, in which the
  126.                 ancestry and descendance dates are the same).  This switch
  127.                 includes single-person items in the output.
  128.  
  129.         #I
  130.                 INTERESTLEVEL.  Tiny Tafel normally includes all family lines
  131.                 meeting the above conditions no matter what its interest level.
  132.                 An Interest Level may be specified to limit the lines included
  133.                 to those having an Interest Level equal to or greater than the
  134.                 number specified.  For example, with the Interest Level set to
  135.                 1, all lines which have an ancestor or descendant Interest
  136.                 Level of 1 or higher will be listed.
  137.  
  138.  
  139. Tiny Tafel Data:
  140.  
  141. Col                        Description
  142. ___                        ___________
  143.  
  144. 1 thru 4        Soundex Code (note 1)
  145. 5               Space delimiter
  146. 6 thru 9        Earliest ancestor birth year
  147. 10              Interest flag, ancestor end of family line (note 2)
  148. 11 thru 14      Latest descendant birth year
  149. 15              Interest flag, descendant end of family line (note 2)
  150. 16 thru 16+SL   Surname string area (SL = total surname length) (note 3)
  151. above + PL      Place name area (PL = total place name length) (note 4)
  152. above + 1       Carriage return
  153.  
  154. NOTES:
  155.  
  156. 1. The Soundex code for any given line is obtained from the end of the line
  157. that has the highest interest level.  If interest level is the same at each
  158. end, however, the name at the ancestor end will be used.  If the application of
  159. these rules yield a surname that cannot be converted to Soundex, however, the
  160. program will attempt to obtain a Soundex code from the other end of the line.
  161.  
  162. 2. Interest flag:
  163.  
  164.         [space] No interest (level 0)
  165.         .       Low interest (level 1)
  166.         :       Moderate interest (level 2)
  167.         *       Highest interest (level 3)
  168.  
  169. 3. Up to five surnames can be accomodated for one line where surname has
  170. changed in that line.  If more than five surnames are found in a line, only the
  171. latest five will be shown.  The inclusion of additional surnames is enabled by
  172. the M switch.
  173.  
  174. 4. Place names for the birth of the earliest ancestor and the latest descendant
  175. may be included by using the P switch.  If a place name is not provided for the
  176. individual whose birth year is shown, the field will be blank.  The place for
  177. the ancestor is preceded by a backslash (\) and for the descendant by a slash
  178. (/).
  179.  
  180.  
  181. Terminator:
  182.  
  183. W       Date Tiny Tafel file was generated, DD MMM YYYY format.
  184.  
  185. Example:
  186.  
  187. N Howard L. Nurse
  188. A COMMSOFT
  189. A 2257 Old Middlefield Way
  190. A Mountain View, CA  94043
  191. T (415) 967-1900
  192. S FIDONet 143/26
  193. B COMMSOFT BBS/(415) 967-6730
  194. C 2400/B/X
  195. D 5/360K/DSDD
  196. F ROOTS II
  197. R Sample database
  198. Z 29 KENNEDY V24 DP
  199. A252 1915 1947 Auchincloss
  200. B160 1698 1933 Bouvier/Long Island NY
  201. B530 1906 1939 Bennett/New York
  202. B620 1869 1933 Burke/Suffolk Co. MA
  203. C200 1803 1833 Cox
  204. C414 1861 1899 Caulfield\Norfolk Co. MA/Suffolk Co. MA
  205. C540 1868 1928 Connelly/Suffolk Co. MA
  206. F326 1690 1890 Fitzgerald/Suffolk Co. MA
  207. F430 1806 1836 Field
  208. H200 1806 1857 Hickey/Suffolk Co. MA
  209. H500 1802 1865 Hannon/Middlesex Co. MA
  210. K500 1858 1892 Kane\Ireland/Suffolk Co. MA
  211. K530 1793*1957:Kennedy\Ireland/New York
  212. K530 1793*1984 Kennedy\Ireland/Wstchster Co. NY
  213. L000 1847 1906 Lee
  214. L163 1923 1961 Lawford\England/L.A. Co. CA
  215. L532 1753 1783 Lindsay
  216. M500 1847 1890 Mahoney\Suffolk Co. MA/Suffolk Co. MA
  217. M610 1791 1821 Murphy/Wxfrd Co. IRE
  218. M626 1710 1766 Mercier
  219. R324 1929 1959 Radziwill
  220. S240 1892 1928 Skakel\Cook Co. IL/Cook Co. IL
  221. S530 1927 1960 Smith\Kings Co. NY/Suffolk Co. MA
  222. S616 1915 1965 Shriver\Carroll Co. MD/Suffolk Co. MA
  223. S625 1831 1861 Sergeant
  224. T525 1947 1983 Townsend\Baltimore Co. MD/Middlesex Co. MA
  225. T653 1706 1736 Trintignant
  226. V650 1783 1813 Vernou
  227. W453 1767 1797 Wilmouth
  228. W 11 Dec 1986
  229.  
  230.  
  231. NOTE:  The above sample Tiny Tafel file was created using the Kennedy database
  232. supplied with ROOTS II, version 2.  The date fill and place switches were on.
  233.  
  234.  
  235. Multiple Tiny Tafel database extractions may be included in a Tiny Tafel file.
  236. If more than one database extraction is included, each extraction will be
  237. intitiated with a Z data line.  An example is shown below:
  238.  
  239.  
  240. N Howard L. Nurse
  241. A COMMSOFT
  242. A 2257 Old Middlefield Way
  243. A Mountain View, CA  94043
  244. T (415) 967-1900
  245. S FidoNet 143/26
  246. B COMMSOFT BBS/(415) 967-6730
  247. C 2400/B/X
  248. D 5/IBM DSDD/360
  249. F ROOTS II
  250. R Sample Kennedy database
  251. Z 29 KENNEDY V24 DP
  252. A252 1915 1947 Auchincloss
  253. B160 1698 1933 Bouvier/Long Island NY
  254. B530 1906 1939 Bennett/New York
  255. B620 1869 1933 Burke/Suffolk Co. MA
  256. C200 1803 1833 Cox
  257. C414 1861 1899 Caulfield\Norfolk Co. MA/Suffolk Co. MA
  258. C540 1868 1928 Connelly/Suffolk Co. MA
  259. F326 1690 1890 Fitzgerald/Suffolk Co. MA
  260. F430 1806 1836 Field
  261. H200 1806 1857 Hickey/Suffolk Co. MA
  262. H500 1802 1865 Hannon/Middlesex Co. MA
  263. K500 1858 1892 Kane\Ireland/Suffolk Co. MA
  264. K530 1793*1957:Kennedy\Ireland/New York
  265. K530 1793*1984 Kennedy\Ireland/Wstchster Co. NY
  266. L000 1847 1906 Lee
  267. L163 1923 1961 Lawford\England/L.A. Co. CA
  268. L532 1753 1783 Lindsay
  269. M500 1847 1890 Mahoney\Suffolk Co. MA/Suffolk Co. MA
  270. M610 1791 1821 Murphy/Wxfrd Co. IRE
  271. M626 1710 1766 Mercier
  272. R324 1929 1959 Radziwill
  273. S240 1892 1928 Skakel\Cook Co. IL/Cook Co. IL
  274. S530 1927 1960 Smith\Kings Co. NY/Suffolk Co. MA
  275. S616 1915 1965 Shriver\Carroll Co. MD/Suffolk Co. MA
  276. S625 1831 1861 Sergeant
  277. T525 1947 1983 Townsend\Baltimore Co. MD/Middlesex Co. MA
  278. T653 1706 1736 Trintignant
  279. V650 1783 1813 Vernou
  280. W453 1767 1797 Wilmouth
  281. R Only those having interest > 0
  282. Z 2 KENNEDY V24 D1
  283. K530 1793*1957:Kennedy
  284. K530 1793*1984 Kennedy
  285. W 15 Dec 1986
  286.  
  287.  
  288. In this Tiny Tafel, the first section contains an extracted Tiny Tafel file
  289. with date fill and places enabled.  The second section contains an extracted
  290. Tiny Tafel file with date fill and the interest level threshold set to 1.
  291.