home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / scanutil / filecnvt.doc next >
Encoding:
Text File  |  1990-08-11  |  6.0 KB  |  130 lines
  1.  
  2.  
  3.  
  4.                          S C A N N E R   B U F F !
  5.  
  6.                           File Conversion Utility
  7.     
  8.                                Version 1.00ß
  9.     
  10.     
  11.     
  12.     August 11, 1990
  13.     
  14.     
  15.     
  16.     This utility was put together quickly as a tool for Scanner Buff!
  17.     users.  The purpose of FILECNVT is to convert ASCII delimited files
  18.     to Scanner Buff! .MDF files, as well as to output ASCII delimited
  19.     files from Scanner Buff! .MDF files.  As a bonus, FILECNVT will also
  20.     reorganize an ASCII delimited file so that FILECNVT can convert its
  21.     new order to an .MDF file.  Although FILECNVT was put together
  22.     quickly, it does exactly what it is supposed to do.  This is a beta
  23.     release, however, and users are encouraged to provide me with
  24.     suggestions, comments, or bug reports.  Instructions aren't really
  25.     necessary for most operations, but I'll give a little explanation
  26.     regardless.
  27.     
  28.     
  29.     Converting A .MDF File To Sequential
  30.     
  31.     Almost every database program I have seen or used is able to read
  32.     delimited ASCII files.  These are the files that contain field data
  33.     between quotation marks, and each field is separated by a comma.
  34.     FILECNVT is able to read a Scanner Buff! .MDF file and output a
  35.     delimited ASCII file so that you may use the contents of the new file
  36.     in another program, such as Scanner Buff! On-Line v3.xx (this is the
  37.     door version).
  38.     
  39.     To do this, the .MDF file must be in the same directory as the
  40.     FILECNVT program.  Accept the first menu item and you will be asked
  41.     for the name of the file to convert.  Enter this name without the .MDF
  42.     extension.  If the file is not found you will abort to the main menu,
  43.     otherwise, you will be asked to input the name of the delimited ASCII
  44.     file to create.  Once you have done this a delimited ASCII file with
  45.     an extension of .TXT will be created.  All fourteen Scanner Buff!
  46.     fields will be exported, regardless of their value to you.
  47.     
  48.     
  49.     Converting A Sequential File To .MDF
  50.     
  51.     Many users of Scanner Buff! have delimited ASCII files obtained from
  52.     other sources.  These files may be converted to .MDF files that
  53.     Scanner Buff! may read.  This is assuming that the order of the data
  54.     is in the proper order of Agency, Frequency, Callsign, City, County,
  55.     State, Group and Comments.  There are other fields used by Scanner
  56.     Buff!, but these given here are the only significant ones.  If your
  57.     file contains this information, but is in a different order, see the
  58.     next section called Reorganizing.  Otherwise, follow these
  59.     instructions to convert your sequential file to a .MDF file:
  60.     
  61.     Selecting the menu item Sequential To MDF will prompt you for the name
  62.     of the sequential file to convert.  Enter this file name without the
  63.     extension.  If this file exists in the program directory you will be
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.     asked to enter the output .MDF file name.  Enter this name without the
  71.     extension.  Your sequential file will be converted to a .MDF file.
  72.     YOU are responsible for the order that data appears in the .MDF file.
  73.     If you use a file with a different field order weird data may appear
  74.     in Scanner Buff! fields.
  75.     
  76.     
  77.     Reorganizing A Sequential File
  78.     
  79.     This is probably the most useful function to you.  It will allow you
  80.     to create a Scanner Buff! ordered sequential file from nearly any
  81.     delimited ASCII file.  Once you have accomplished this, you may also
  82.     convert the created file to a .MDF file.  There are several steps
  83.     required to do this:
  84.     
  85.     Step 1:  View your sequential file with an editor and determine what
  86.     fields appear in what position.  An example of this would be Agency =
  87.     position 1  -->  "Temple City Station","483.2375","WII803" , Callsign
  88.     = position 3, and Frequency is in position 2.  You will need to know
  89.     this information for the next step to work, so view your file and
  90.     write down the order on a piece of paper.
  91.     
  92.     Step 2:  Accept the menu item Reorganize and enter the file name of
  93.     your sequential file without the extension.  If this file exists you
  94.     will be asked to enter the name of the sequential file to create.
  95.     Enter this without the extension.  Once these names have been
  96.     determined you will be shown a screen asking you to enter the position
  97.     information that you determined on your own.  Enter this field
  98.     information where indicated.  All cursor keys are available to you to
  99.     move around the screen.  Enter a number equal to or greater than the
  100.     number of fields if the field position does not exist in your file.
  101.     Zeros in any field are not accepted.
  102.     
  103.     The last item asked for on this screen is the total number of fields
  104.     in YOUR sequential file.  FILECNVT will be creating a temporary
  105.     database and your data will be read in.  By telling FILECNVT how many
  106.     fields you have your chances increase for a successful reorganization.
  107.     
  108.     You may have up to 99 fields in your sequential files, although I
  109.     doubt any of you have files this large.  Regardless, FILECNVT will now
  110.     read your sequential file and transpose the order of each record to
  111.     Scanner Buff! order of Agency, Frequency, Callsign, City, County,
  112.     State, Group, and Comments.  As you can see, even if you have 99
  113.     fields only the Scanner Buff! significant fields will be transferred
  114.     to your output file.
  115.     
  116.     Step 3:  Once you have reorganized your sequential file you can then
  117.     convert it to a .MDF file by following the steps required in menu item
  118.     2.
  119.     
  120.     FILECNVT will always alert you if your outfile file is going to be
  121.     overwritten, or your input file does not exist.  FILECNVT will not
  122.     monitor disk space, so if you are in doubt do some house cleaning
  123.     (what do you expect for quick and dirty programming... and free?).
  124.     
  125.     This covers your quick tour through FILECNVT, the Scanner Buff! file
  126.     conversion utility.
  127.  
  128.     Bob Ricci
  129.     A Scanner Buff!
  130.