home *** CD-ROM | disk | FTP | other *** search
/ PC Gamer 2.13 / 1997-02_Disc_2.13.iso / patches / fsfs501.exe / FLTSHP.EXE / FSFSIMP.TXT < prev    next >
Text File  |  1996-01-31  |  6KB  |  132 lines
  1. ======================================================
  2.  
  3. Flight Simulator Flight Shop - Database Import Utility
  4.  
  5. ======================================================
  6.  
  7. Copyright (c) 1995 by Robert M. MacKay - ALL RIGHTS RESERVED
  8.  
  9. This utility and its associated files may only be distributed via
  10. on-line services that are authorized by Robert MacKay. These services
  11. include the MicroWINGS WEB page, CompuServe FSFORUM, MSN, AOL FSRC,
  12. and the FTP.IUP.EDU internet FTP site. To request authorization to
  13. distribute these files, send internet email to fltsim@microwings.com.
  14.  
  15. ======================================================
  16.  
  17. Installation
  18. ------------
  19. To install, simply unzip the files in FSFSIMP.ZIP into your FLTSHOP
  20. directory.
  21.  
  22. How To Use The Importer
  23. -----------------------
  24. The importer works by reading data from a fixed record length ASCII file
  25. and adding the data to the database.
  26.  
  27. The Data Files
  28. --------------
  29. The file LAYOUT.TXT provides the specs for the layout of the data files.
  30. Since these are fixed record length files, no TAB or comma or quotation
  31. mark type delimeters are needed (in fact they will likely cause errors).
  32.  
  33. A seperate file is needed for each Flight Shop ATC database class:
  34.  
  35. 1) NavAids (VOR, NDB, Intersection, Reporting Point, VFR Reference, etc.)
  36.  
  37. 2) Airports
  38.  
  39. 3) Runways and associated ILS information
  40.  
  41. The User Interface
  42. ------------------
  43. The "Import What" group box allows you to specify which type of data you
  44. are going to import. Be sure this option is correctly set before pressing
  45. the IMPORT button, otherwise you will be in for alot of import errors as
  46. the program attempts to add the data.
  47.  
  48. The "From Where" group box allows you to find and select the file that
  49. contains the data you want to import. Be sure the data file is of the same
  50. type selected in the "Import What" group box.
  51.  
  52. The "Records Processed Successfuly" listbox will display the last 48k-64k
  53. worth of successful import messages. As each record is added successfully,
  54. an entry of the record is logged in this list box. If more than 64k worth
  55. of entries are logged, the program will automatically cut out the first 16k
  56. to make room for more entries (and to prevent an overflow error). After the
  57. import process is complete, you can print the contents of this list box by
  58. double clicking on it.
  59.  
  60. The "Records with Problems/Errors" listbox will display the last 48k-64k
  61. worth of records that could not be imported due to a problem or error of
  62. some kind. As each record with a problem is found, an entry of the record
  63. is logged in this list box. If more than 64k worth of entries are logged,
  64. the program will automatically cut out the first 16k to make room for more
  65. entries (and to prevent an overflow error). After the import process is
  66. complete, you can print the contents of this list box by double clicking
  67. on it.
  68.  
  69. The Import Process
  70. ------------------
  71. As each record is read from the data files, the program first attempts to
  72. be sure that all the data read is valid. If it is not, it will log an entry
  73. into the "Records with Problems/Errors" list box and will *not* add the
  74. record.
  75.  
  76. If all the data is considered valid, then the program will attempt to add it
  77. to the database. If there is no other entry already in the database, with
  78. the same Identifier, then the record should get imported without any
  79. problems.
  80.  
  81. If the Identifier turns out to be already in the database (i.e. not unique),
  82. then the program will take the first letter of the STATE/COUNTRY field and
  83. add it to the Identifier (ex. [SFD in the UK] would become SFDU). The
  84. program will then try to again add the record with the modified Identifier.
  85. If it fails again due to the Identifier not being unique, then the program
  86. will add the second letter of the STATE/COUNTRY field (ex. Our SFDU would
  87. now become SFDUK). The program will then try to again add the record with
  88. the modified Identifier. If it fails this second time, then the record is
  89. skipped and a message stating the various attemps is logged in the 
  90. "Records with Problems/Errors" list box. If the added letter(s) works and
  91. the Identifier is now unique, then the record is added to the database and
  92. an entry is made in the "Records Processed Successfuly" listbox, stating
  93. what the Identifier had to be changed to in order to import successfuly.
  94.  
  95. IMPORT Button
  96. -------------
  97. When you have selected your file and selected the appropriate Import What
  98. option... you then press the IMPORT button to start the import process. You
  99. will first see a warning box alerting you that there is *NO* undo feature.
  100. As such, you are strongly urged, before *every* import attempt, to back up
  101. your ATC database (FSFSDB.MDB in the FLTSHOP directory).
  102.  
  103. If the two "Records..." list boxes have any text in them, you will then be
  104. asked if you want to have the program clear them before starting or to just
  105. append the import messages to what is already present in the list boxes.
  106.  
  107. Finally, the program will begin importing the data. You will see a status
  108. message in the program's Title Bar counting the number of records processed.
  109. In the list boxes, you will see the status of each record as it is added or
  110. skipped (due to problems/errors).
  111.  
  112. When the Title Bar indicator says DONE. Then the import process has finished.
  113. At this point you can continue and add additional data/files, print the
  114. contents of the list boxes, or Exit.
  115.  
  116. WARRANTY
  117. --------
  118. This program is provided as is. No warranty is provided, implied or express,
  119. regarding performance, merchantability, fitness for a particular purpose,
  120. operation, or data loss. By using this software, the user assumes all risks
  121. and liabilities with regard to any loss arising out of the use of this
  122. software.
  123.  
  124. Support
  125. -------
  126. It is hoped that this readme file will provide sufficient information to
  127. enable the use of this software. Established support is not available for
  128. this product as it is provided free of charge and is considered to be a
  129. utility. However, in case the author is available and has time to help out,
  130. questions can be posted on the MicroWINGS WEB Page's MESSAGE BOARD, and also
  131. on the CompuServe FSFORUM.
  132.