home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / crm_demo / relative / relative.txt < prev   
Text File  |  1988-07-17  |  46KB  |  1,071 lines

  1.                      It's All Relative (tm)
  2.  
  3.        A Truly "Relational" Database for the Atari ST
  4.  
  5.                  (c)May 1988 Greg Kopchak
  6.                              2233 Keeven Lane
  7.                              Florissant, MO 63031
  8.                              1-314-831-9482
  9.  
  10.  
  11.                      VERSION 1.0 MANUAL
  12.  
  13.  
  14. I.    Introduction
  15.  
  16. II.   Quick Start for those who hate manuals
  17.  
  18. III.  Setting up your work disk
  19.  
  20. IV.   Loading the program the first time
  21.  
  22. V.    Adding a person to the database
  23.  
  24. VI.   Adding a second or third marriage for a person
  25.  
  26. VII.  Adding a memory resident note
  27.  
  28. VIII. Editing an individual's record
  29.  
  30. IX.   Printer controls
  31.  
  32. X.    Data output to the monitor screen
  33.  
  34. XI.   Data output to your printer
  35.  
  36. XII.  Using the quick search features
  37.  
  38. XIII. File commands
  39.  
  40. XIV.  Using the extended notes feature for unlimited notes
  41.  
  42. XV.   Organizing your records for data entry
  43.  
  44. XVI.  Tips on data entry and keeping records
  45.  
  46. XVII. Running from a hard disk
  47.  
  48. XVIII.Error handling
  49.  
  50. IXX.  The Utilities program REL_UTIL.PRG
  51.  
  52. XX.   New features planned and support information
  53.  
  54.  
  55.  
  56. I. INTRODUCTION
  57.  
  58. "It's  all Relative" is a descendants based  genealogical  program 
  59. written  with  the  ST in mind from  the  ground  up.  Track  your 
  60. family's  line  from its earliest know member to the  present  and 
  61. compute relationships  with a user friendly Gem based program. 
  62.  
  63. A  descendants  based  genealogy  program  tracks  the  progenitor 
  64. (the  earliest  known member) of a family line and  all  of  their 
  65. direct  descendants.  In a descendants based program  all  persons 
  66. with a primary ID number are direct descendants of the progenitor. 
  67.  
  68. This  differs  from an ancestors based program where  both  direct 
  69. descendants  and relations by marriage may have a primary  number. 
  70. In  an ancestors based program all persons with a  primary  record 
  71. number  may  or may not be directly related to all  other  members 
  72. with a primary number. Some may be related by marriage only.
  73.  
  74. Minimum System Requirements:
  75.                          
  76.                          Atari 520 ST
  77.                          SF-354 or equivalent disk drive
  78.                          Monitor (color or monochrome)
  79.                          Printer
  80.  
  81. II. QUICK START
  82.  
  83. For  those who don't like to wade through a lengthy  manual,  this 
  84. section will get you up and running.  I would suggest reading  the 
  85. entire manual before you begin to create a large database.
  86.  
  87. 1. Loading the program
  88.  
  89. Your  "It's All Relative" can be booted from any drive  or  folder 
  90. within  a drive.  The data file it creates will be created on  the 
  91. drive and directory selected when the program was booted.
  92.  
  93. Click on create new data file.  A Gem selector box will appear. If 
  94. you want the data files to be created in the root directory of the 
  95. drive you loaded the program from,  press return.  Four files will 
  96. be created and the program will run.
  97.  
  98. You can have your extended notes written  and read to   either the 
  99. drive  and  folder you selected or to the root directory of  drive 
  100. A. Click on yes or no for your selection.
  101.  
  102. Go to the EDIT menu and select CHANGE.  Edit the record for ID  #1 
  103. to  be  the  progenitor of your family  line  (Your  oldest  known 
  104. ancestor).  Fill  in the known information on the  individual  and 
  105. their spouse.
  106.  
  107. From  the  EDIT  menu,  ADD all of their  children.  ADD  all  the 
  108. children of their children. Repeat until all family members are in 
  109. the database.  Children should be entered only after the parent is 
  110. entered and marriage file created for the parent.
  111.  
  112. Before  quitting "It's All Relative" go to the FILE menu and  SAVE 
  113. your  work.  Your file will be saved to the drive you  loaded  the 
  114. program from and will automatically load the next time the program 
  115. is run.
  116.  
  117. III. SETTING UP YOUR WORK DISK
  118.  
  119. "It's  All Relative" is not copy protected.  Make a copy  of  your 
  120. original disk (see your computer manual).  Store the original  and 
  121. work with the copy.  Format a blank disk for each family line  you 
  122. are working with. You will use these disks to store your data.
  123.  
  124. You  may either make a copy of RELATIVE.PRG on each work  disk  by 
  125. using  the  Gem file copy function (see your computer  manual)  or 
  126. load the program each time from the program work disk you created.
  127.  
  128. If  you keep a copy of RELATIVE.PRG on each work  disk,  you  will 
  129. have  room  to store about 700 records on a  single-sided  double-
  130. density  disk.  If  you don't keep a copy of RELATIVE.PRG  on  the 
  131. disk,  you  will have room for about 900 records on  each  single-
  132. sided double density disk.
  133.  
  134. IV. LOADING THE PROGRAM
  135.  
  136. "It's All Relative" can be loaded from any drive or folder on  the 
  137. disk in the drive.  All data files will be created and saved  into 
  138. the disk and folder that you selected when the program was loaded.
  139.  
  140. To  start the program highlight and double-click on  RELATIVE.PRG. 
  141. The first time you run the program,  you will be asked if you wish 
  142. to create a new set of data files.  Click on YES.
  143.  
  144. A  Gem selector box will appear on your screen.  Select the  Drive 
  145. and  folder to create the data files in and type in  NAMES.IAR  as 
  146. the  filename in the box.  To put the data on the disk you  loaded 
  147. the  program from,  simply hit return when the file  selector  box 
  148. appears. 
  149.  
  150. You  can  either have your extended notes files written  and  read 
  151. from  the  drive  and folder you selected for data  or  have  them 
  152. written and read from the root directory of your A drive.  If  you 
  153. answer  NO at the prompt,  all extended notes will be  written  to 
  154. your  selected drive and folder.  If you answer YES  all  extended 
  155. notes will be written to your A drive's root directory.
  156.  
  157. If you are using a floppy disk,  I would suggest not creating  the 
  158. files inside a folder on the disk. Trying to save to a floppy disk 
  159. that  doesn't have the same folder on it will result in  a  folder 
  160. not found error.
  161.  
  162. Four files will be created on the drive and folder you selected:
  163.  
  164.                          FAMILY.IAR
  165.                          MARRIAGE.IAR
  166.                          WHERE.IAR
  167.                          NOTES.IAR
  168.  
  169. All four of these files must be present everytime your program  is 
  170. run after the first time or your data may be damaged.
  171.  
  172. The first thing to do after creating and loading a new set of data 
  173. files is to CHANGE the data for ID #1. Select CHANGE from the EDIT 
  174. menu and type 1 at the prompt for Id number. Edit the data in this 
  175. file  to make ID #1 the oldest known member of your  family  line. 
  176. Fill  in as much information as you know about him/her  and  their 
  177. spouse. The parent of ID #1 should remain ID #0 for now.
  178.  
  179. Read  the  sections on adding and changing  information  for  more 
  180. details.
  181.  
  182. V. ADDING A PERSON
  183.  
  184. Select ADD from the EDIT menu.  To ADD a person, you must know the 
  185. ID number of his parent and a marriage file must have been created 
  186. for that parent.
  187.  
  188. The  arrow  keys will move you up or down in the  entry  box.  The 
  189. escape key will erase all data from the line of the record you are 
  190. working on. Pressing return will move you down a line in the entry 
  191. box.  HITTING RETURN ON THE LAST LINE OF THE BOX  will take you to 
  192. the  review/add/abort screen where your data can be  reviewed  one 
  193. last  time before being entered into the database.  Click  on  Ok, 
  194. edit or abort.  The default of this box is Ok. Hitting return will 
  195. add the record to the database.
  196.  
  197. You can also move around within the entry box with the mouse. Move 
  198. the arrow to where you want to be and click the left mouse button.
  199.  
  200. Fill in as much information as you know on the individual you  are 
  201. adding.  If  you plan on adding a child for this  individual,  you 
  202. must enter y or Y in the married box. This automatically creates a 
  203. marriage/child  file for the individual.  If an individual  is  an 
  204. unwed parent,  still put a y or Y in the married box.  The  spouse 
  205. name can be left blank or the notation Unwed can be entered as the 
  206. spouse name.
  207.  
  208. Use ??  or __ for missing date information or leave it  blank.  If 
  209. the  date of death field is blank,  the program assumes  that  the 
  210. individual is living.
  211.  
  212. Use the full maiden name for females.
  213.  
  214. You  can't add a child to a individuals record unless  a  marriage 
  215. record  has  already  been  entered  for  the  individual.   In  a 
  216. descendants based database, all of the individuals are related. An 
  217. individual  can't be entered into the database unless they  are  a 
  218. relative  of  the  first  person  entered  in  the  database,  the 
  219. progenitor of your family line.
  220.  
  221. The  last entry in the add box is Special ID number.  This can  be 
  222. used  to  tie  this record to either a numbering  system  you  are 
  223. already  using  or some other records you have kept.  Its  use  is 
  224. optional.
  225.  
  226. After adding a record, hitting return again at the onscreen prompt 
  227. will  take you back to ADD record again.  Pointing to NO with  the 
  228. mouse arrow and clicking the left mouse button will take you  back 
  229. to the main menu.
  230.  
  231. See  the  Utilities disk section for information  on  formats  for 
  232. entering names and titles so they may be alphabetized correctly by 
  233. this utility.
  234.  
  235. VI. ADDING A SECOND OR THIRD MARRIAGE
  236.  
  237. To  add  a second or third marriage for an  individual,  click  on 
  238. MARRIAGE from the EDIT menu. Enter the ID number of the person you 
  239. are adding the marriage for. Fill in the data on the spouse of the 
  240. individual  and  press  return from  the  bottom  line.  All  edit 
  241. commands in this box work the same as in the ADD person box.
  242.  
  243. Since  this is a descendants based program,  children are tied  to 
  244. the individual rather than the spouse of that individual. You must 
  245. have  created  a first marriage before adding a  second  or  third 
  246. marriage.
  247.  
  248. VII. ADDING A NOTE
  249.  
  250. A  two line note can be tacked onto any record.  Select NOTE  from 
  251. the EDIT menu.  Enter the Id number of the person to tack the note 
  252. to. Enter your note. Hitting return on the second line of the note 
  253. will take you to the confirm/abort option. You can move up or down 
  254. in the notes using either the arrow keys or mouse. 
  255.  
  256. If  the  person already had a memory resident note tacked  to  his 
  257. record,  the  new note will replace the old one.  Only one  memory 
  258. resident note per person is allowed.
  259.  
  260. Rather than using the memory resident notes function, you may want 
  261. to  use  the  extended notes feature of the  "It's  All  Relative" 
  262. program.  See the section on extended notes.  There is no limit on 
  263. the extended notes function.
  264.  
  265. VIII. EDITING DATA
  266.  
  267. 1. EDITING  INDIVIDUAL RECORDS
  268.  
  269. Select CHANGE from the EDIT menu.  Enter the number of the  person 
  270. you  wish to add or change the data for.  The commands and  cursor 
  271. movements in the edit box work the same as they do in the ADD box. 
  272. Change  the information,  go to the review box and either  confirm 
  273. the change or abort the procedure.
  274.  
  275. WARNING:  Changing  marriage from Y or y will delete the  marriage 
  276. record for the individual being edited.  All child information for 
  277. this  individual  will also be deleted.  Try to avoid  deleting  a 
  278. first marriage if possible and edit instead.  If a first  marriage 
  279. with  children is deleted for some reason,  you must re-enter  the 
  280. children after re-entering the marriage.
  281.  
  282. 2. EDITING MARRIAGES
  283.  
  284. Select  MARRIAGE from the EDIT menu.  You can then add  change  or 
  285. delete  information  on  the  second and  third  marriages  of  an 
  286. individual.  Follow the prompts. Information on first marriages is 
  287. changed from the CHANGE function on the EDIT menu.
  288.  
  289. 3. EDITING CHILD
  290.  
  291. You  can add,  delete or rearrange the children of an  individual. 
  292. Select  CHILD  from the EDIT menu.  You will be prompted  for  the 
  293. record  number of the individual to change.  Enter the  number.  A 
  294. list  of their current children will appear on the  screen.  Enter 
  295. the new or corrected children of the individual.  As you enter the 
  296. Id  number of each child,  their name will appear on  the  screen. 
  297. Enter  0 to end the edit process.  You will be allowed  to  either 
  298. confirm the changes or redo or abort the process.
  299.  
  300. Children  may be entered in any order.  When doing  printouts  and 
  301. reports,  the oldest child should be first and the youngest  last. 
  302. If  you entered children in the wrong order or didn't  know  their 
  303. birth dates when their name was entered you can use this screen to 
  304. make corrections.
  305.  
  306. 4. EDITING LEVEL
  307.  
  308. Each  person in the database was assigned a level when  they  were 
  309. first entered into the database.  If you entered your  grandfather 
  310. as  the  first record and later found information  on  your  great 
  311. grandfather  the level of the entire database must be  changed  to 
  312. make room for him.
  313.  
  314. From the DISPLAY menu select ANALYSIS.  You will be shown a report 
  315. of the status of the database in memory.  Click either the left or 
  316. right  mouse  button or hit a key.  A level  adjustment  box  will 
  317. appear on your screen. Move ALL levels UP. You can now enter a new 
  318. progenitor (first person) for your family line. Enter 0 as his/her 
  319. parent  and  enter the data as usual making sure that  a  marriage 
  320. file is created. 
  321.  
  322. Select  CHILD from the EDIT menu and add the individuals  children 
  323. to the marriage record.  Select CHANGE from the EDIT menu and make 
  324. the  corresponding change in the parent number of the children  to 
  325. reflect the newfound parent.
  326.  
  327. If  you make a mistake with the UP level function,  you  can  also 
  328. move the level of the entire database down again by choosing  down 
  329. from the level adjustment box.
  330.  
  331. If  you have entered a wrong parent for an  individual,  make  the 
  332. corrections in the Individual's record and the CHILD correction in 
  333. the parent file of the wrong parent and the correct parent.
  334.  
  335. Check  the level of the individual.  It should be  one  generation 
  336. higher than his parent. If it isn't you can change the individuals 
  337. level from the ANALYSIS option of the DISPLAY menu.  You may  also 
  338. need  to correct the level of the children of the individual  that 
  339. had  the wrong parent and the children of their children till  the 
  340. end of the chain.
  341.  
  342. Use  some  thought before attempting a level change  through  many 
  343. generations  on  part  of the database.  It is very  easy  to  get 
  344. tangled  up  in  levels.  Not making  parent  errors  when  adding 
  345. individuals is good way to start.
  346.  
  347. IX. PRINTER CONTROLS
  348.  
  349. The  program  uses the Epson command codes  for  printer  control. 
  350. Future  versions  of  the  program will  support  a  print  driver 
  351. construction set to make drivers for any printer.
  352.  
  353. 1. NLQ 
  354.  
  355. Selecting NLQ from the PRINTER menu will put your printer into its 
  356. near letter quality mode. A check mark will appear in the menu. If 
  357. your printer is turned off after selecting NLQ, it will need to be 
  358. set again by selecting NLQ after restoring power.
  359.  
  360. 2. FF
  361.  
  362. Selecting FF from the PRINTER menu will form feed your printer  to 
  363. the top of the page.
  364.  
  365. 3. CONDENSED
  366.  
  367. Selecting CONDENSED from the PRINTER menu will put you printer  in 
  368. condensed print mode.  A  check mark will appear on the menu  here 
  369. also.  If your printer is turned off after selecting CONDENSED  it 
  370. will need to be set again by selecting CONDENSED.
  371.  
  372. 4. CLEAR
  373.  
  374. Selecting  CLEAR  from the PRINTER menu will  clear  all  previous 
  375. settings and return your printer to its startup default mode. This 
  376. is  the  same as turning off your printer and turning it  back  on 
  377. again.
  378.  
  379. 5. PRINT TO DISK
  380.  
  381. Selecting PRINT TO DISK from the PRINTER menu will send the output 
  382. of your very next print option to a disk file.  You will be  taken 
  383. to  a selector box and allowed to chose the drive and filename  to 
  384. print to.  To cancel the option click on cancel from the  selector 
  385. box. Your output will be re-directed back to the printer.
  386.  
  387. After one printout, the print output defaults back to printer. You 
  388. must  select  PRINT TO DISK before each print option you  wish  to 
  389. send to disk.
  390.  
  391. The  output  is in ASCII format and can be imported  to  the  word 
  392. processing or desktop publishing program of your choice for  final 
  393. adjustments and professional quality output.
  394.  
  395. WARNING:  The filename you selected, if it already exists, will be 
  396. erased and a new file written in its place. Selecting the PRINT TO 
  397. DISK  option  and then doing a LONG FORM descendants  chart  of  a 
  398. large database can result in a large output printfile.  Make  sure 
  399. the disk you use has enough room for the output you are sending.
  400.  
  401. The print to disk option can be directed to any disk or folder  in 
  402. your  system.  All data files with the exception to PRINT TO  DISK 
  403. files  are written to the same drive and folder you selected  when 
  404. the program was loaded. This is the only exception.
  405.  
  406. X. DATA OUTPUT TO SCREEN
  407.  
  408. 1. RECORD
  409.  
  410. Selecting  RECORD  from  the DISPLAY function  will  display  that 
  411. record on the monitor screen.  You will get all information on the 
  412. individual  plus  any note tacked to his/her record.  If  all  the 
  413. record can't fit on the screen, hitting any key or clicking either 
  414. mouse  button will scroll additional information onto the  screen. 
  415. Hit a key or click either mouse button to return to the main menu.
  416.  
  417. 2. ANALYSIS
  418.  
  419. Selecting ANALYSIS from the DISPLAY menu will give you a status of 
  420. the  database  in  memory.  You will get  information  on  levels, 
  421. marriages  and sex of the individuals in the database.  Click  the 
  422. mouse  and hit return or hit return twice to get back to the  main 
  423. menu.
  424.  
  425. 3. SOUNDEX
  426.  
  427. Selecting SOUNDEX from the DISPLAY menu will prompt you to enter a 
  428. name.  Type in the last name you want to compute the soundex  code 
  429. for.  The name and Soundex code will appear on the screen. Hitting 
  430. return or clicking the left mouse button  on Ok will allow you  to 
  431. enter  another name.  Pointing at exit and clicking on  the  mouse 
  432. button will take you back to the main menu.
  433.  
  434. Names  like  Von  Burren are usually coded using  only  Burren  to 
  435. calculate the code.  The coding of last names with multiple  parts 
  436. varies.  Consult  an expert on Soundex for the  possibilities  for 
  437. names like these. The program does not support spaces in names for 
  438. this  reason.  Numerals,  accents,  and punctuations are also  not 
  439. supported.
  440.  
  441. The  Soundex  code  has  been used  extensively  to  index  census 
  442. records.  Your  local library should have more information on  the 
  443. coding and be able to order microfilms of census records for you.
  444.  
  445. 4. NAME LIST
  446.  
  447. Selecting NAME LIST from the Display menu will display all of  the 
  448. individuals in the database,  their record number, and the name of 
  449. their spouses. Click a mouse button or hit a key for the next page 
  450. of data.
  451.  
  452. 5. DESCENDANTS CHART
  453.  
  454. Selecting  DESCENDANTS CHART from the DISPLAY menu will  create  a 
  455. descendants chart on your screen for the individual selected. Only 
  456. the short chart can be viewed on the monitor screen.
  457.  
  458. Each generation is indented in from the previous  generation.  The 
  459. generation of the individual relative to the progenitor chosen  is 
  460. also displayed with their Id number. Click a mouse button or hit a 
  461. key for the next page of data.
  462.  
  463. 6. RELATIONS
  464.  
  465. Selecting  RELATIONS  from the DISPLAY menu will take  you  to  an 
  466. input  screen.  Enter  the ID number of an individual and  the  ID 
  467. number  of another individual.  The relationship between  the  two 
  468. individuals will be calculated and displayed. Hit return to return 
  469. to the input screen. Hit enter twice to return to the main menu.
  470.  
  471. 7. DATABASE STATUS
  472.  
  473. Selecting  RELATIVE  from  the DESK menu will give  you  a  status 
  474. report of memory available and records used in the database. Since 
  475. "It's  All Relative" is a memory resident  database,  booting  the 
  476. computer  with accessories or ramdisk will have an impact  on  the 
  477. total number of records that may be entered in the system during a 
  478. given  entry  session.  The total of individual,  spouse  or  note 
  479. records can't exceed the number of records available for your  use 
  480. based on memory available.
  481.  
  482. 8. EXTENDED NOTES
  483.  
  484. Selecting  EXTENDED NOTES from the DISPLAY menu will  display  the 
  485. extended  notes for an individual if they exist on the  drive  and 
  486. folder selected when the program was loaded.
  487.  
  488. XI. PRINT OPTIONS
  489.  
  490. 1. RECORDS
  491.  
  492. Selecting  RECORDS from the PRINT menu will send the record of  an 
  493. individual  to the printer.  You can print either a range  or  all 
  494. records.  The  default is range.  To print one record,  enter  its 
  495. number as both the starting and ending number of the range.  Check 
  496. your  supply  of  paper before choosing the ALL  option  of  print 
  497. record.
  498.  
  499. 2. DATA ANALYSIS
  500.  
  501. Selecting  ANALYSIS  from  the  PRINT menu  will  print  the  data 
  502. analysis of the records in memory.
  503.  
  504. 3. FAMILY GROUPS
  505.  
  506. Selecting  FAMILY GROUPS from the PRINT menu will print  a  family 
  507. group  sheet for the individual selected with information  on  the 
  508. individual, their spouse and children, one page for each family. A 
  509. long record with multiple marriages or many children will run over 
  510. to a second page. A heading is also printed on the second page.
  511.  
  512. 4. NAMES LIST
  513.  
  514. Selecting NAMES LIST from the PRINT menu will print out a list  of 
  515. all individuals in the database, their record number and the names 
  516. of their spouses.
  517.  
  518. 5. DESCENDANTS CHART
  519.  
  520. Selecting DESCENDANTS CHART from the PRINT menu will allow you  to 
  521. print out two types of descendants charts.
  522.  
  523. SHORT  CHART will print all the descendants of the progenitor  you 
  524. choose, the record number of the individual, and the level of that 
  525. person relative to the progenitor choosen.
  526.  
  527. As  you enter data into the database it is a good idea to print  a 
  528. short  chart  from time to time to make sure your  information  is 
  529. correct  and all children are tied to the right  parent.  It  also 
  530. aides  in data entry to make notations on the short chart  on  new 
  531. individuals to add to the database.  See the section on organizing 
  532. data.
  533.  
  534. LONG  CHART will print a descendants chart for the progenitor  you 
  535. select giving full information on birth, marriage and death dates, 
  536. spouse  information and relationship between an individual  and  a 
  537. person you have selected. The person selected for the computing of 
  538. relations  does  not  have  to  be  the  progenitor  chosen.  Each 
  539. generation display is indented from the previous generation.
  540.  
  541. Relations  and information is displayed for the generation of  the 
  542. progenitor  chosen  through twelve generations of  descendants  of 
  543. that individual.
  544.  
  545. You are given the option of printing out the record number of each 
  546. individual and their Special record number if you used one.  Click 
  547. on Yes or No.
  548.  
  549. ******************************************************************
  550. WARNING:  If you are using an eighty column printer the LONG CHART 
  551. must  be printed in condensed mode.  A wide carriage  printer  can 
  552. print a long chart in the standard type size.
  553. ******************************************************************
  554.  
  555. XII. SEARCH
  556.  
  557. The search function of "It's All Relative" is very fast.  Over 500 
  558. records can be searched in less than two seconds.  This is where a 
  559. memory  resident database beats a disk based database by  a  mile. 
  560. Your  searches are not limited to a small index  field.  The  full 
  561. record can be searched through for almost any criteria.
  562.  
  563. 1. BY NAME
  564.  
  565. Select BY NAME from the SEARCH menu.  You can enter either a  full 
  566. name,  last name or first name to search for. You can also enter a 
  567. portion of a name to search for.  If the name you entered  matches 
  568. any individual or spouse in the database, their record will appear 
  569. on  the screen.  With a large database,  be specific.  One  letter 
  570. searches will give very large results.
  571.  
  572. The  search  is case sensitive.  The name "greg"  will  not  match 
  573. "Gregory". "Greg" or "reg" or "egory" will come up with a match.
  574.  
  575. A space alone " " will match all names in the database.
  576.  
  577. Enter alone will take you back to the main menu.
  578.  
  579. 2. BY NUMBER
  580.  
  581. Select BY NUMBER from the SEARCH menu. Enter a low and high number 
  582. to search. All records between the two numbers will be displayed.
  583.  
  584. Enter alone will return you to the main menu.
  585.  
  586. 3. BY LOCATION
  587.  
  588. Select BY LOCATION from the SEARCH menu.  Enter a full place  name 
  589. or any part of a name.  The program will display all records  that 
  590. have  either  a birth,  death or marriage location for  the  place 
  591. name.
  592.  
  593. This  search  is also case sensitive.  If you use the  two  letter 
  594. state designation for states (OH = Ohio),  it is very easy to pull 
  595. records by state.
  596.  
  597. 4. BY MONTH
  598.  
  599. If you used "??/??/????" in the date field when entering data, you 
  600. can search for these missing or unsure dates by entering a "?"  in 
  601. the  search  field  criteria for  the  missing  information.  This 
  602. applies to the use of "__" also.
  603.  
  604. Select  BY MONTH from the SEARCH menu.  Enter the month number  to 
  605. search  for using the two digit number of the month.  Enter  alone 
  606. will  take  you  back to the main menu.  All  records  and  spouse 
  607. records  for  that month for birth,  death and  marriage  will  be 
  608. displayed.
  609.  
  610. Hit enter only for the main menu.
  611.  
  612. This  feature is handy to display anniversaries and birthdays  for 
  613. the coming month.
  614.  
  615. 5. BY DAY
  616.  
  617. Select  BY DATE from the SEARCH menu.  Enter the month and day  to 
  618. search for. Enter 1 as the year to display. All entries for birth, 
  619. death  and marriage for the day chosen will be  displayed.   Enter 
  620. only takes you back to the main menu.
  621.  
  622. 6. BY DATE
  623.  
  624. Select  BY DATE from the SEARCH menu.  All records for  the  exact 
  625. date entered will be displayed.
  626.  
  627. XIII. FILE
  628.  
  629. 1. SAVE
  630.  
  631. Selecting SAVE from the FILE menu saves your database to disk. You 
  632. are  prompted to put your data disk in the drive you booted  from. 
  633. Click  on  OK  and your four "It's All  Relative"  files  will  be 
  634. written to disk.
  635.  
  636. To avoid confusion,  keep a separate "It's All Relative" data disk 
  637. for  each family line you are working on and make sure the  family 
  638. name is well marked on the disk.  Nothing is worse than saving the 
  639. data for the wrong family on the wrong disk.  Keep your data  well 
  640. marked.
  641.  
  642. When I do extended data entry,  I put what I call my work disk  in 
  643. the  save drive.  Every 15-30 minutes save your data to  the  work 
  644. disk. In case of power failure or brownout, only a portion of your 
  645. work will be lost.  After finishing the data entry session,  do  a 
  646. final save to your actual data disk. If something should happen to 
  647. your save disk (out of room or bad disk error),  you have the work 
  648. disk from the session to fall back on.
  649.  
  650. WARNING: The files are saved to the same drive and folder that you 
  651. originally loaded them from. 
  652.  
  653. If you loaded from a floppy disk, make sure that the write-protect
  654. tab is closed and you have a "save" disk with sufficient room  for 
  655. the  database  on it.  If you loaded from a folder,  make  sure  a 
  656. folder with the same name exists on your "save" disk.
  657.  
  658. It  is not a good idea to use your "It's All Relative"  data  disk 
  659. for the PRINT TO DISK option of the program. You may find yourself 
  660. with a full disk and no place to save your data.
  661.  
  662. 2. QUIT
  663.  
  664. Selecting  QUIT  from  the FILES menu will quit  the  program  and 
  665. return you back to the ST desktop.  All unsaved data is lost  when 
  666. you quit the program.  You are given a warning before the  program 
  667. exits to the desktop.
  668.  
  669. If  you  made some serious parent/child/level errors  during  your 
  670. data entry session,  quitting and reloading may be easier and more 
  671. accurate than trying to make extensive corrections.
  672.  
  673. XIV. EXTENDED NOTES
  674.  
  675. When printing out records, you are prompted for EXTENDED NOTES. If 
  676. you choose this option,  when a record is printed,  if a  matching 
  677. file  exists on the drive and folder you selected when the program
  678. was  loaded,  the  information  is  tacked  onto  the record being
  679. printed.  There is no limit to the length that this record can be.
  680. If the extended record exceeds the  page limit  a new  heading  is
  681. printed for the record and the balance of the note is printed.
  682.  
  683. 1. CREATING AN EXTENDED NOTES FILE
  684.  
  685. Select EXTENDED NOTES from the EDIT menu.  Enter the number of the 
  686. person to add an extended notes file for.  Type up to 13 lines  of 
  687. notes. Cursor control is the same as it is within the ADD box. Hit 
  688. return  on the bottom line of the box to end entry and  write  the 
  689. file to disk. Make sure that a disk with sufficient room is in the 
  690. drive you selected as your note drive and the write protect tab is
  691. in the closed position.  If you selected a folder when you  loaded 
  692. the program, the folder must exist on your data drive.
  693.  
  694. The  lines of notes you typed up to the first blank line  will  be 
  695. added to the extended notes of the individual. If you want a blank 
  696. line  in  your extended notes enter a space " " on  the  line  hit 
  697. return and keep on typing.
  698.  
  699. If  you wish more than 13 lines,  select EXTENDED NOTES  from  the 
  700. EDIT  menu  and APPEND additional notes onto the record  you  have 
  701. created for an individual.
  702.  
  703. You are given the option of REPLACE,  APPEND,  or  ABORT.
  704.  
  705. REPLACE  will  replace  any  old  extended  notes  file  for  this 
  706. individual with a new extended notes file.
  707.  
  708. APPEND  will tack your new note onto the end of any existing  note 
  709. for that individual, creating a new file if no extended notes file 
  710. for the  individual  exists.  Append will leave  one line  spacing 
  711. between your note segments.
  712.  
  713. ABORT  will  exit you back to the main menu  without  any  changes 
  714. being made or file written.
  715.  
  716. 2. CREATING AN EXTENDED NOTES FILE WITH A WORD PROCESSOR
  717.  
  718. The  name  of the extended notes file  must  be  RECORD#.DOC.  The 
  719. extended notes file for record 2 would be 2.DOC.  123.DOC would be 
  720. the name of the extended notes file for record #123.
  721.  
  722. The record is created by typing the record in a word processor and 
  723. saving it as an ASCII file.  In a program like First Word or First 
  724. Word Plus,  turn off word processor mode before saving to make the 
  725. save in ASCII format.
  726.  
  727. Your  left margin should be 0 and your right margin no  more  than 
  728. 65. The record can be as long as you want to make it. Do not worry 
  729. about page breaks.  "It's All Relative" will paginate the file for 
  730. you as it prints. 
  731.  
  732. See your word processor manual for information on saving a file in 
  733. plain ASCII text format.
  734.  
  735. ******************************************************************
  736. WARNING:  DO NOT ATTEMPT TO EDIT ANYTHING BUT EXTENDED NOTES IN  A 
  737. WORD PROCESSOR.  ANY OF THE FILES WITH THE .IAR EXTENSION CAN'T BE 
  738. CHANGED IN A WORD PROCESSOR AS THEY ARE FIXED LENGTH RECORDS.  ANY 
  739. ATTEMPT TO DO SO WILL SCRAMBLE YOUR DATA BEYOND ALL HOPE.
  740. ******************************************************************
  741.  
  742. 2. USING EXTENDED RECORDS
  743.  
  744. It  is  a  good idea to make a disk for each 50 to 100 members  of
  745. each family line you are working with. This will allow you up to a 
  746. full page  of notes for every individual in  your  database.  When 
  747. doing  printouts for yourself or others,print in ranges  of  these 
  748. numbers making sure you  have the  correct  extended  records disk
  749. in the drive  that you booted from.
  750.  
  751. Extended  notes are a good place to keep  current  address,  phone 
  752. number,  place  of burial,  newspaper  clipping,  personal  notes, 
  753. sources of information, clarification of data and related items.
  754.  
  755. Your final printouts of individual records will look better if you 
  756. keep  a consistant format to your extended  notes.  Experiment  to 
  757. find  a  format  that fits your needs.  When  making  a  duplicate 
  758. printout for other,  all information you have on an individual can 
  759. be  printed  with a couple mouse clicks and keystrokes in  a  neat 
  760. organized format.
  761.  
  762. XV. ORGANIZING YOUR RECORDS FOR ENTRY 
  763.  
  764. "It's All Relative" is a descendants based program. You will begin 
  765. your data entry with the oldest known member of your family  line. 
  766. If  the oldest known member of your family line also has  brothers 
  767. or sisters you are aware of,  you may want to make record number 1 
  768. "the father/mother of ...".
  769.  
  770. You  can either enter all information for each individual  as  you 
  771. make  each entry or simply enter each individual  and  appropriate 
  772. marriage/spouse  information and go back and fill in  the  missing 
  773. information  later.  You can print out the descendants  chart  for 
  774. this partial listing of relatives and use it to make notes on  for 
  775. each individual.  This saves you from flipping between 200  sheets 
  776. of notes and old records while trying to enter the data.
  777.  
  778. You  will  create one set of "IT'S ALL RELATIVE"  files  for  each 
  779. family  line you are recording.  Every individual with  a  primary 
  780. record  in  your database will be a direct relation of  all  other 
  781. individuals with a primary number in the database.
  782.  
  783. Error trapping is extensive in "It's All Relative",  but if  wrong 
  784. information  is put into the computer wrong information will  come 
  785. out.  The most common mistake made is wrong parent number. Be very 
  786. careful that your parent numbers are correct.
  787.  
  788. XVI. TIPS ON DATA ENTRY
  789.  
  790. Be  consistent in your data entry.  You may be entering data  over 
  791. days,  months or years.  Keep the format the same for all entries. 
  792. If  you  use  "Firstname Lastname",  don't  switch  to  "Firstname 
  793. LASTNAME" format halfway through your data entry. If you use "??" 
  794. for missing dates don't switch to "__" without a reason. This will 
  795. make  for neater printouts and reports and more  complete  results 
  796. for your searches.
  797.  
  798. Enter a small group of individuals into the database (your father, 
  799. brothers  and sisters and their children).  Play around  with  the 
  800. data.  Become proficient with the edit features.  Add,  delete and 
  801. edit some records.  Try the different print,  display and  search 
  802. commands.  When you feel comfortable with the program,  begin data 
  803. entry in earnest.
  804.  
  805. Back up your data disk on a regular basis.  Store a remote  backup 
  806. of extensive information.  Having two backup disks and a hard copy 
  807. printout  of your information at your computer desk won't  do  any 
  808. good  if  a disaster destroys the desk.  The information  you  are 
  809. gathering  can be passed on to your children and  their  children, 
  810. Treat it with care.
  811.  
  812. When making a backup copy of your data,  copy each file one by one 
  813. from the desktop of your ST rather than making a disk  copy.  This 
  814. will prevent what is known as file fragmentation.
  815.  
  816. "It's All Relative" will work with well-behaved accessories.  Each 
  817. accessory you add will take away room for data.  Some  accessories 
  818. may  try  to  overwrite  your  data.   Experiment  with  any   new 
  819. accessories you add for use with "It's All Relative".
  820.  
  821. All  printouts are date stamped.  Be sure to set your system  date 
  822. before  running the program.  The control panel accessory  shipped 
  823. with  your computer has a function to set the time and  date.  See 
  824. your manual on its use.  Check with your local user  group.  There 
  825. are  many public domain date/time programs that are easier to  use 
  826. and take less memory than the control accessory.
  827.  
  828. Using  an accessory program like Wholly Macro by  Sedroc  Software 
  829. can  make your data entry easier.  A keyboard macro can be set  up 
  830. for frequently used names and locations.
  831.  
  832. XVII. RUNNING FROM A HARD DRIVE
  833.  
  834. Before  running the "It's All Relative" program,  create a  folder 
  835. for each family line line you plan to create.  The folder may have 
  836. any legal folder name.  I use the first eight letter of the family 
  837. name being worked with.
  838.  
  839. When  the program is run for the first time,  a gem  selector  box 
  840. appears. Select the folder with your mouse and open it up. Type in 
  841. the  filename  NAMES.IAR in the Gem box as the  filename  you  are 
  842. using.  The program will create the four .IAR files in this folder 
  843. for you.  All data files and extended notes files will be  created 
  844. inside this folder for you.
  845.  
  846. You are given the option of writing your extended notes to a  disk 
  847. in  drive A rather than into the folder you created on  your  hard 
  848. drive.  Having many extended notes on your hard drive can fill the 
  849. directory  of the drive rather quickly.  The extended notes  files 
  850. can  also  slow down the operation of the hard drive if  they  are 
  851. large in number.
  852.  
  853. If you want your extended notes written and read from a floppy  in 
  854. drive A,  select YES from the alert box when the program is  first 
  855. loaded. I suggest 50-100 extended notes per floppy disk. This will 
  856. make  sure you do not get disk full errors as your extended  notes 
  857. gain  in depth and quantity of information stored  in  them.  Mark 
  858. your  extended  notes disks with family line and  IAR  files  they 
  859. belong with.
  860.  
  861. Create  a  new folder for each line you  are  working  with.  Make 
  862. backups of your folders on a regular basis and make sure that your 
  863. hard disk has enough room to store the data you are creating. Each 
  864. name  record  with marriage and note takes 383 bytes  of  storage. 
  865. Extended  notes vary in size.  The PRINT TO DISK option will  also 
  866. vary.  When  in doubt about space remaining,  PRINT TO DISK  to  a 
  867. floppy disk rather than your hard drive. Running out of room while 
  868. saving the .IAR data set will make your data unusable. 
  869.  
  870. XVIII. Error Handling
  871.  
  872. Most of all input errors are fully trapped.  The program will stop 
  873. you  from entering a wrong number or name in most  places.  If  an 
  874. error does happen to occur in data entry,  let us know about it so 
  875. future versions of the program can be corrected.
  876.  
  877. You may get some errors when reading and writing to a disk  drive. 
  878. When a read or write error occurs,  the program goes to a recovery 
  879. routine  that attempts to correct the problem.  When a  read/write 
  880. error  occurs,  all open files are closed and you are returned  to 
  881. the  menu screen.  An error code is reported.  The following is  a 
  882. list of more common error codes and what they mean:
  883.  
  884.     -13 Write Protected    Your write protect tab must be closed
  885.  
  886.     -33 File not found     A file is missing from your disk
  887.  
  888.     -34 Path not found     A folder is missing from your disk. If
  889.                            you booted from a folder on a floppy 
  890.                            disk, that folder must be on your data
  891.                            disk and extended notes disk too.
  892.  
  893. If you can correct the error,  try resaving or reloading the  data 
  894. files after attempting correction.  See your Atari owner's  manual 
  895. for a complete list of error codes and their causes.
  896.  
  897. IXX. The utility program REL_UTIL.PRG
  898.  
  899. The  program  REL_UTIL.PRG on your "It's All Relative"  disk  does 
  900. five  new  types  of  printouts using  the  data  created  by  the 
  901. RELATIVE.PRG.
  902.  
  903. To  load  REL_UTIL.PRG,  double-click  on the file  from  the  Gem 
  904. desktop selector.  The program can be run from any drive or folder 
  905. in a drive.
  906.  
  907. A Gem file selector will appear when the program loads. Select the 
  908. drive  and folder that contains your .IAR data  set.  Double-click 
  909. on the file NAMES.IAR. You are now ready to use the program.
  910.  
  911. If all four .IAR files are not in the disk and folder you selected 
  912. you  will be taken back to the Gem desktop.  Find the problem  and 
  913. run the program again.
  914.  
  915. Most of the printouts are dated.  Make sure you have set the  date 
  916. before running the program.
  917.  
  918. The  printer  control  menu  works  just  like  the  menu  in  the 
  919. RELATIVE.PRG.  Any  print  output  can  be  directed  to  disk  by 
  920. selecting this option.
  921.  
  922. 1. CALENDAR
  923.  
  924. You have five options of printouts in the CALENDAR menu.  You  may 
  925. print a calendar for BIRTHDAYS, ANNIVERSARIES, BOTH (birthdays and 
  926. anniversaries),  NECROLOGY,  or ALL (birthdays, anniversaries, and 
  927. necrology).
  928.  
  929. Select either output to screen or printer.  Enter the name of  the 
  930. family  you are printing a calendar for.  Enter the  starting  and 
  931. ending  month  number.  The ending month must be larger  than  the 
  932. starting  month  number.  Hit  return and your  calendar  will  be 
  933. printed out.
  934.  
  935. All  events that have a complete month and day in  an  individuals 
  936. record will be displayed for the events chosen. 
  937.  
  938. If you chose ALL and months 1-12 as the range of the  calendar,  a 
  939. full listing of number of family and spouse  births,  deaths,  and 
  940. marriages you have recorded by month is made.
  941.  
  942. 2. TIME LINE
  943.  
  944. Select  TIME LINE for a complete time-line for the family in  your 
  945. .IAR  database. Enter the family name you are working with.
  946.  
  947. The program goes through your data and finds the earliest and most 
  948. recent year that had an event occur in it.  An event is any birth, 
  949. death or marriage you have recorded.  Incomplete year  information 
  950. is skipped.  Any event with a complete year will be displayed. Any 
  951. year before 1500 is also skipped.
  952.  
  953. Each  year from the earliest to most recent is displayed  and,  if 
  954. you have a recorded event for that year,  the event is printed.  A 
  955. summary is printed as the last page of the printout.
  956.  
  957. 3. PROGENITORS
  958.  
  959. Selecting PROGENITORS from the LIST menu will display or print out 
  960. a  listing of one branch of the family tree from its tip  back  to 
  961. the root.  Enter the ID number of the person to trace ancestry  on 
  962. and press return.
  963.  
  964. You can print this list with or without ID numbers.
  965.  
  966. The following information will be displayed:
  967.  
  968. Name / ID number / date of birth / date of death
  969. Relationship
  970. marriage date / Spouse Name / date of birth / date of death
  971.  
  972. If  there  is information on the parent of  the  individual  being 
  973. displayed  the  same information will be  printed  for  them.  The 
  974. program  continues  till  the  last  known  parent  is  found  and 
  975. displayed.
  976.  
  977. 4. BY LEVEL
  978.  
  979. Select  BY LEVEL from the LIST menu.  Enter a starting  generation 
  980. level  and  an  ending  generation  level.   Information  will  be 
  981. displayed  or printed for all individuals in the database for  all 
  982. generations between the low and high generation level chosen. Each 
  983. level is printed from the oldest to most recent. 
  984.  
  985. The following information is displayed:
  986.  
  987. Name / ID number / date of birth / date of death
  988. marriage date / Spouse Name / date of birth / date of death
  989.  
  990. 5. ALPHABETICAL
  991.  
  992. When a name is entered into "It's All Relative",  it is entered in 
  993. the format [firstname lastname].   This routine converts the  name 
  994. to  the  format  [lastname,  firstname] and  sorts  them  into  an 
  995. alphabetical index. Both family and spouse names are sorted.
  996.  
  997. Select  ALPHABETICAL  from the LIST menu.  Be  patient  here.  The 
  998. program  must  turn  the  name  around  and  then  sort  it   into 
  999. alphabetical  order  before either printing out or  displaying  to 
  1000. screen.  This is one routine that is not lightening  fast!  Future 
  1001. versions  may be faster,  but there is quite a bit of  work  being 
  1002. done with the names.
  1003.  
  1004. If you use the following conventions of data entry for names, your 
  1005. list will print in the correct order.
  1006.  
  1007. a.  All titles must be three letters or less.
  1008.  
  1009.     MD SJ JR Jr. IV III V are all good.
  1010.     M.D. S.J.  VIII is not good.
  1011.  
  1012.     Ben Casey M.D. or Ben Casey Junior is not good.
  1013.     Ben Casey MD or Ben Casey III or Ben Casey Jr. is good.
  1014.  
  1015. b.  Titles at the beginning of a name can be any length.
  1016.  
  1017.     Doctor Ben Casey or Sister Mary Williams is good.
  1018.  
  1019. c.  All last names must be at least 4 letters long.  Pad the last 
  1020.     name  of  a  one,  two,  or three letter  last  name  with  a 
  1021.     character of your chosing.
  1022.  
  1023.     William Lee_
  1024.     Bill Yi__
  1025.  
  1026. d.  You may designate missing name information any way you  want, 
  1027.     but if you are consistent, your indexes will be neater. I use
  1028.     ???? ???? to designate missing name information. This appears 
  1029.     in an index as ????, ????.
  1030.  
  1031. You  can print the alphabetical index with or without ID  numbers. 
  1032. If you chose the ID number option. The ID number of the individual 
  1033. along  with any special ID number you may have assigned them  will 
  1034. be  printed.  The ID number for a spouse will be the ID number  of 
  1035. the family member they are married to with an S to signify  spouse
  1036. (S-1).
  1037.  
  1038.  
  1039. XX. NEW ADDITIONS COMING
  1040.  
  1041. The  additional print options utility addition to the program  was 
  1042. released in July 1988.  If you have a print option that we haven't 
  1043. covered yet,  please let us know.  It can be included in a  future 
  1044. release of the program.
  1045.  
  1046. We  will make an update disk available  to  all registers users of
  1047. the program in the future. Additional printouts and utilities will
  1048. be included on  the update disk. Be sure to register your  copy of
  1049. the program to receive information on the updates.
  1050.  
  1051. For additional support for "It's All Relative" you may call 1-314-
  1052. 831-9482 between 9:00  a.m and 7:00 p.m. EST. E-mail  messages can
  1053. also be left to GREG on the GEnie network. The mailbox  is checked
  1054. every few days.
  1055.  
  1056. You  may  also  post  questions in Category  2  of  the  Genealogy
  1057. Roundtable of the GEnie Information System.  There is a topic  set 
  1058. up  for  "It's  All Relative".  Information  on  the  program  and 
  1059. updates are posted there on a regular basis.
  1060.  
  1061. If you have a wish list for the update disk,  let us know.  We are 
  1062. currently working on some  import/export routines for moving  data 
  1063. to and from the program.
  1064.  
  1065. "It's All Relative" is available for $25.00 postpaid from:
  1066.  
  1067.                          Greg Kopchak
  1068.                          2233 Keeven Lane
  1069.                          Florissant, MO 63031
  1070.  
  1071.