home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / fcc100.zip / FCC.DOC < prev    next >
Text File  |  1993-02-27  |  19KB  |  389 lines
  1.         INTRODUCTION
  2.  
  3.            Copyright  1993 by  SCAN-WARE, Gene McAvoy and Matt Amis.  All
  4.         Rights Reserved.  No part of this publication or program  may  be 
  5.         reproduced, photocopied, or transmitted except as provided by the 
  6.         License below. 
  7.  
  8.            FCC  is  a copyrighted,  program and is  protected  under  the 
  9.         United  States  Copyright  Law and various  International  Treaty 
  10.         provisions.  It is offered "as is" for personal use, testing, and 
  11.         evaluation.  We make no claim as to the program's suitability for 
  12.         any  specific purpose and shall not be held responsible  for  any 
  13.         consequential  damages that may possibly occur through the use or 
  14.         misuse of the program. 
  15.  
  16.            Your  first  use  of FCC constitutes  your  agreement  to  the 
  17.         following provisions: 
  18.  
  19.            Shareware License:  A  limited license at no charge is granted 
  20.         to  all to use,  test and duplicate the copy of FCC you  received 
  21.         for no more than 30  calendar days.   Thereafter,  if you did not 
  22.         license FCC directly from us, you must either pay the license fee 
  23.         to  continue to use FCC or cease all use of FCC.   You will be in 
  24.         violation  of  this  limited license agreement if  you  use  this 
  25.         version  of FCC for more than 30  days without paying the license 
  26.         fee. 
  27.  
  28.            License: Upon payment of the registration fee, we will grant a 
  29.         non-exclusive  license  to  use FCC by one person  regardless  of 
  30.         whether the license is owned by the person or by a business  (the 
  31.         "licensee").    Licensed  copies  of  FCC may  be  kept  only  on 
  32.         computers actually used by the licensee. 
  33.  
  34.            Disclaimer  of  Warranties.    We  make no claims  as  to  the 
  35.         suitability of FCC for any specific use.  We disclaim any and all 
  36.         warranties,  express or implied,  oral or written,  including any 
  37.         implied warranties of merchantability or fitness for a particular 
  38.         purpose. 
  39.  
  40.            Limitation of Liability.   In no event shall we be liable  for 
  41.         any damages whatsoever arising out of the use of FCC,  including, 
  42.         and without limitation,  any direct,  incidental or consequential 
  43.         damages. 
  44.  
  45.            The  user  is granted a license to distribute the  program  as 
  46.         he/she  received it to anyone he/she sees fit to do so.   FCC may 
  47.         not  be "resold"  by Shareware distributors for a cost  exceeding 
  48.         $5.00.     The   Shareware  distributor  should  have  a   notice 
  49.         prominently  displayed in their advertisement that  the  programs 
  50.         they  distribute  are  Copyrighted by others and  by  paying  the 
  51.         Shareware  distributor  a  fee  to purchase  the  disk  does  not 
  52.         constitute the registration of the program. 
  53.  
  54.  
  55.         Section 1.  GENERAL
  56.  
  57.         1.1  DOCUMENTATION.
  58.  
  59.            The  purpose  of  this  documentation is to  provide  a  brief 
  60.         description  of  the FCC Frequency Retrieval System.  The  user's 
  61.         guide  is not intended to be all encompassing in its scope or  to 
  62.         answer   all  possible  questions  regarding  the  operation   or 
  63.         capabilities of the program.   It is hoped that the Help  Screens 
  64.         included  within  the program will answer most  users  questions. 
  65.         Operation  of the program has been made as simple as possible and 
  66.         most menu choices should be clear to the user. 
  67.  
  68.         1.2  BACKGROUND.
  69.  
  70.            The  FCC Frequency Retrieval System is the brainchild of  Matt 
  71.         Amis, AA7LP and Gene McAvoy, KG7XD.  It was developed in order to 
  72.         fill  a  need that became apparent when the FCC  database  became 
  73.         available in computerized form.   The original FCC database is in 
  74.         an  ASCII format and due to its size is quite unwieldy to  handle 
  75.         and  very  time  consuming to search.   The  frequency  retrieval 
  76.         system  is  a  compiled  program written  in  Clipper  and  makes 
  77.         searching and retrieval of frequency information a very quick  an 
  78.         easy task. 
  79.  
  80.         1.3  SYSTEM REQUIREMENTS.
  81.  
  82.            As  with  any  database handling  software,   the  larger  the 
  83.         database  to  be handled,  the more time it takes to  complete  a 
  84.         given task.   Conversely,  the more powerful the computer  system 
  85.         being used,  the faster the handling of the database becomes.  In 
  86.         development of the program, most operations were done on a 286-12 
  87.         Mhz system using a limited data set.   Most testing operations of 
  88.         the  program were done on a 386-33  Mhz machine with  a  complete 
  89.         data  set  for  the state of Washington  which  comprised  nearly 
  90.         50,000  records.   As an example of performance,  the 286  system 
  91.         with  a 1000  record database will pack and re-index within  less 
  92.         than 3 minutes.  The 386  system performs the same task using the 
  93.         50,000 record database in about 20 minutes.  
  94.  
  95.            Another  important  factor  to  consider  in  handling   large 
  96.         databases  is  the amount of hard drive space that is needed  for 
  97.         operation of the program.  The following table will give you some 
  98.         idea of the amount of space needed for the system. 
  99.  
  100.         Database       Records          Size (bytes)
  101.          KITSAP          1460              210818
  102.          KING           11590             1669538
  103.          PIERCE          2818              406370
  104.          SNOHOMISH       2224              320834
  105.          THURSTON        1848              266690
  106.          WEST WA        10725             1544978
  107.          EAST WA        14775             2128178
  108.  
  109.  
  110.            The  FCC  Frequency Retrieval System uses a unique  system  to 
  111.         dynamically create index files as a database is selected.    This 
  112.         method  greatly  reduces the amount of memory that is needed  for 
  113.         the program and allows for much faster processing of information.  
  114.         Six  individual indexes are created when the database is selected 
  115.         which allows for many variations of information retrieval.   Each 
  116.         index  file requires a certain amount of hard disk space which is 
  117.         proportional to the overall size of the database in use. 
  118.  
  119.            Considerable  variations  in the amount of  hard  drive  space 
  120.         required  can be expected depending on which database set you are 
  121.         using the program with. 
  122.  
  123.            Since  the  program is theoretically capable  of  manipulating 
  124.         databases  of  any given size,  the only limitations to be  dealt 
  125.         with are hard disk space available and system operating speed. 
  126.  
  127.         1.4  BASIC HARDWARE AND SOFTWARE RECOMMENDATIONS
  128.  
  129.            As  noted  earlier,  the system has been operated  on  several 
  130.         systems with varying degrees of performance.   Although  designed 
  131.         for  optimum performance on today's newer systems,   the  program 
  132.         will nonetheless function on older machines. 
  133.  
  134.            a. The minimum hardware configuration is as follows:
  135.  
  136.               (1)  640K random access memory (RAM)
  137.  
  138.               (2)  sufficient hard disk space (see figure 1.)
  139.  
  140.               (3)  One 360K double-sided, double-density or 
  141.                    1.2 megabyte high-density 5.25" disk drive
  142.  
  143.                    or
  144.  
  145.                    One 720K double-sided, double-density or
  146.                    1.44 megabyte high-density 3.5" disk drive
  147.  
  148.               (4)  One color monitor (EGA or VGA; preferably, VGA)
  149.                    A future update to the program will allow its use
  150.                    on monochrome systems.
  151.  
  152.               (5)  Optional - Printer
  153.  
  154.            b.  The minimum operating system is:
  155.  
  156.                MicroSoft Disk Operating System (MS-DOS) 3.30 or newer.
  157.  
  158.  
  159. Section 2:  GETTING STARTED
  160.  
  161.         2.1 SYSTEM BASICS.
  162.  
  163.            This  section describes the basics for using the FCC Frequency 
  164.         Retrieval System,  such as: where to get help,  important keys to 
  165.         know, and some features that are designed to make your use of the 
  166.         program  more efficient and less time-consuming.    In  addition, 
  167.         you'll   find   vital   information  about   exporting   database 
  168.         information. 
  169.  
  170.         2.2 PROGRAM INSTALLATION.
  171.  
  172.            Installation  is  as  simple as copying  all  files  from  the 
  173.         distrubtion diskettes to your hard drive,  (in the  sub-directory 
  174.         of your choice), and unzipping all files.  The archive files MUST 
  175.         be unzipped with PKUNZIP, Version 2.04g or higher.  The number of 
  176.         disks you have will depend on the disk media size, and whether or 
  177.         not  you  purchased  any  additional  counties.    The   original 
  178.         registered version comes complete with your choice of 2 counties.  
  179.         Counties available are: 
  180.  
  181.            Kitsap, King, Pierce, Snohomish, Thurston, Western Washington, 
  182.         and Eastern Washington. 
  183.  
  184.            When  completed,   you will have the following files  in  your 
  185.         selected sub-directory: 
  186.  
  187.                  FCC.EXE         <-- The main executable
  188.                  FCC.GF          <-- Supplementary file containing colors
  189.                  FCC1.FRM        <-- Report form template
  190.                  FCC2.FRM        <-- Report form template
  191.                  FCC3.FRM        <-- Report form template
  192.                  HELP.DBF        <-- Guess what?  Help file
  193.                  HELP.DBT        <-- Yup, goes with help file
  194.                  QUERIES.DBF     <-- Sample queries
  195.                  QUERIES.DBT     <-- Used with queries.dbf
  196.  
  197.                  FCC?.DBF        <-- Files for each county (REGISTERED version 
  198.                                      only)
  199.  
  200.            Once  all files have been unzipped,  simply type FCC to  begin 
  201.         the program.  The first time FCC is run,   the program will check 
  202.         to  ensure that all necessary files exist in the directory  where 
  203.         FCC was started.   If any are not found,  the program will inform 
  204.         you of the missing file(s) and return to DOS. 
  205.  
  206.            If this is the first time you have run FCC,  it will look  for 
  207.         the main database file FCC.DBF.  If it does not find one, and you 
  208.         are  running  the  SHAREWARE version of FCC,   the  program  will 
  209.         terminate and return to DOS.  If you have the REGISTERED version, 
  210.         FCC  will create the FCC.DBF file from the county of your  choice 
  211.         (from those you purchased). 
  212.  
  213.            During the building of the FCC.DBF file,  or when you select a 
  214.         different  county,   the program will present you with  a  window 
  215.         showing  all  available  counties.   While all counties  will  be 
  216.         displayed  in the window,  only those counties that you have data 
  217.         files  for  will be highlighted or selectable.  Upon selecting  a 
  218.         county  to  use  (you may use only one county at  a  time),   the 
  219.         program  will copy the selected county to the file FCC.DBF.    If 
  220.         you  have any data in FCC.DBF that you do not wish to loose,  you 
  221.         should  back up that file before continuing.   Upon completion of 
  222.         building  the FCC.DBF file,  the program will rebuild all indexes 
  223.         and return you to the menu. 
  224.  
  225.            The SHAREWARE version will not allow the following:
  226.  
  227.         1.  Creation of the FCC database if it does not exist.
  228.         2.  Editing of any database.
  229.         3.  Use of any other county database other than that provided.
  230.         4.  Output of records to file or dBase file.
  231.  
  232.         2.3 HELP
  233.  
  234.            On-screen  help is available for nearly every field.   If  you 
  235.         have a problem or need clarification,  press the F1  key.    Help 
  236.         screens  are sometimes larger than the window they are  displayed 
  237.         in.  To view the entire text,  use the up,  or down-arrow keys to 
  238.         scroll  up or down.   Some of the larger Help Screens also  allow 
  239.         you the option to print out the material contained therein. 
  240.  
  241.         2.4 KEYS TO KNOW
  242.  
  243.             <-  ->    Move one field at a time left or right
  244.  
  245.             \/        Move down a line while in the browse window
  246.  
  247.             /\        Move up a line while in the browse window
  248.  
  249.             Home      Move back to the prior sequential data field within
  250.                       the selected index
  251.  
  252.             End       Move forward to the next sequential data field
  253.                       within the selected index
  254.  
  255.             Ctrl-Home Move to the leftmost column of the browse screen
  256.  
  257.             Ctrl-End  Move to the rightmost column of the browse screen
  258.  
  259.             Esc       Exit from the program
  260.  
  261.             F1        Display on-screen information (Help window)
  262.                       regarding the current selection
  263.  
  264.             PgUp      Move up one screen
  265.  
  266.             Ctrl-PgUp Move to the top of the database
  267.  
  268.             PgDn      Move down one screen
  269.  
  270.             Ctrl-PgDn Move to the bottom of the database
  271.  
  272.             Shift/PrtSc
  273.                       Print the screen currently displayed
  274.  
  275.             Q         Perform a query of the database
  276.  
  277.             S         Perform a search within the selected index
  278.  
  279.             V         View a formatted screen of the current selection
  280.  
  281.             L         Lock from 1 to 6 columns on the left side of the
  282.                       view screen
  283.  
  284.             O         Output the current database to the printer
  285.  
  286.             Alt-S     Sets the low and high limits of the database within
  287.                       the confines of the selected index
  288.  
  289.         2.5 SYSTEM USE EFFICIENCY
  290.  
  291.            Much  can be done to speed your use of the system.   The  tips 
  292.         which follow are by no means meant to be all-inclusive.  They are 
  293.         merely  some of the features which have proven to be most  useful 
  294.         in using the program to its best advantage. 
  295.  
  296.            Always  begin a [Q]uery from the top of the database to ensure 
  297.         that  all records are searched.   Press <Ctrl-PgUp>   before  you 
  298.         begin the query. 
  299.  
  300.            The [S]earch function is case-sensitive.   Always depress  the 
  301.         Caps Lock key before beginning a search. 
  302.  
  303.            The  [V]iew  screen will give you a quick look at all  of  the 
  304.         fields  of  the  data item selected regardless of the  number  of 
  305.         columns selected for viewing on the screen. 
  306.  
  307.            The [O]utput selection prints only those columns selected  for 
  308.         viewing  on  the screen.   This feature allows you  to  customize 
  309.         printouts with ease.  Additionally, any output will be limited to 
  310.         the fields selected at the time of viewing.   If the width of the 
  311.         selected  columns  is greater than 80  characters,  you  will  be 
  312.         informed of this and asked if you wish to continue.  If the width 
  313.         is greater than 132  columns,  you will also be asked if you wish 
  314.         to continue.   If you do, and the width is greater than 132,  the 
  315.         output will be truncated to a total overall width of 132. 
  316.  
  317.            The [Alt-S]ubset allows you to limit the range of the database 
  318.         which  is  to  be considered for any operations.    This  feature 
  319.         allows  you to view or print very specific selections  from  your 
  320.         database  regardless of the total database size.   It  also  will 
  321.         greatly  decrease  the  amount of time needed for  searching  and 
  322.         processing information requests within the program. 
  323.  
  324.         2.6 FREQUENCY REPORT GENERATOR
  325.  
  326.            This  powerful  utility portion of the program allows  you  to 
  327.         define various subsets of your main database.   By employing this 
  328.         method  you  can actually build smaller databases for general  or 
  329.         very specific uses.  These databases can then be saved as totally 
  330.         separate  DBF  files  and be used with their own index  files  as 
  331.         well.   Great increases in speed can be realized when this method 
  332.         is used especially if the main database is considerable in size. 
  333.  
  334.         2.7 REPORTING ERRORS OR DISCREPANCIES
  335.  
  336.            Every  effort has  been made  to ensure  that the  product you
  337.         recieve is  free from errors or bugs.   Should you have a problem
  338.         that is related to the program,  please contact us at the address
  339.         below.  Additionally,  we gladly accept any  suggestions or ideas
  340.         for improvements to the program.  You may contact us at:
  341.  
  342.  
  343.            SCAN-WARE Associates
  344.            7910 NE Double Hitch Ct
  345.            Bremerton, WA 98310-3801
  346.  
  347.            (206) 698-1383 Voice
  348.            (206) 698-8207 FAX
  349.  
  350.         3.0 ADDENDUM
  351.  
  352.          The WESTERN WA database contains:
  353.                 Clallam                 Mason
  354.                 Clark                   Pacific
  355.                 Cowlitz                 San Juan
  356.                 Grays Harbor            Skagit
  357.                 Island                  Skamania
  358.                 Jefferson               Wahkiakum
  359.                 Lewis                   Whatcom
  360.  
  361.          The EASTERN WA database contains:
  362.                Adams                   Franklin                Pend Oreille
  363.                Asotin                  Garfield                Spokane
  364.                Benton                  Grant                   Stevens
  365.                Chelan                  Kittitas                Walla Walla
  366.                Columbia                Klickitat               Whitman
  367.                Douglas                 Lincoln                 Yakima
  368.                Ferry                   Okanogan
  369.  
  370.  
  371.         Note from Matt Amis:
  372.  
  373.            I  would  like to take this opportunity  to  personally  thank 
  374.         Grumpfish  Inc.   and  Greg Lief of  Grumpfish  for  his  Clipper 
  375.         Library.    Without  this  tool,   programming  would  have  been 
  376.         esentially impossible.  Greg, I owe you one. 
  377.  
  378.  
  379.         TRADEMARK ACKNOWLEDGEMENTS
  380.  
  381.         Clipper is a registered trademark of Computer Associates
  382.  
  383.         PKUNZIP is a registered trademark of PKWARE, Inc.
  384.  
  385.         MS-DOS is a registered trademark of Microsoft Corporation
  386.  
  387.         Other products and marks mentioned in this documentation are trademarks
  388.         or registered trademarks of their respective owners.
  389.