home *** CD-ROM | disk | FTP | other *** search
/ World of Shareware - Software Farm 2 / wosw_2.zip / wosw_2 / DESKTOP / AC-EXCHG.ZIP / AC_11FEB.EXE / AC.DOC < prev    next >
Text File  |  1991-02-18  |  14KB  |  302 lines
  1.  
  2.                                    -  AC  -
  3.  
  4.                           The Comprehensive Area Code
  5.                              and Exchange Locator
  6.  
  7.                                    <11feb91>
  8.  
  9.                               (C) Copyright 1991
  10.                               Robert K. Ricketts
  11.  
  12.  
  13.           AC is a comprehensive area code, state, city (central office),
  14.      and exchange locator.  The data files accessed by AC were compressed
  15.      from the telephone company VNH tables which is nearly two megabytes
  16.      of raw data containing directory information for our country's
  17.      telephone system.  Other area code programs simply show you the state
  18.      and a few larger cities.  But AC goes WAY beyond that!
  19.  
  20.           For instance, you can locate all area codes in a state, display
  21.      the central office cities owning those area codes, and even display
  22.      all the valid exchanges belonging to the CO city!  Even podunk-hollow
  23.      will show up if it has a telephone company central office.
  24.  
  25.           You can search based on state or area code.  You can narrow the
  26.      search by specifying a city search mask.  You can search for CO
  27.      cities having a certain number of exchanges - or search for a range
  28.      of exchanges.  You can find a city and it's state even if all you
  29.      know is the area code and phone number.  And once all this is found,
  30.      you can display either with exchanges listed or not listed.
  31.  
  32.  
  33.      Parameter overview
  34.      ------------------
  35.  
  36.  
  37.           Syntax for executing AC:
  38.  
  39.             AC (state|areacode)[.city|.xchg] [-P] [-X] [-Cx:y]
  40.  
  41.                ( ) = required parm.
  42.                [ ] = optional parm.
  43.                 |  = select one from listed parms.
  44.  
  45.  
  46.       where:   state      : Two letter postal code or portion of state
  47.                             name for a search.
  48.                areacode   : Three digit area code.
  49.                city       : Find only CO city names starting with this.
  50.                xchg       : Find only CO cities having at least this
  51.                             exchange.
  52.                -P         : Pause after every twenty lines of output.
  53.                -X         : Also display all valid exchanges found.
  54.                -Cx:y      : Only look for CO cities with between x and y
  55.                             exchanges.
  56.  
  57.  
  58.  
  59.      Paramter detail
  60.      ---------------
  61.  
  62.  
  63.      state   (either state or areacode required)
  64.           Official USPS two letter postal code representing the state that
  65.      you wish to search.  If the two character abbreviation is not located
  66.      as a state postal code or if you specify three or more characters,
  67.      then AC will invoke a character by character search - looking
  68.      anywhere in the state name for a match.  If AC finds more than one
  69.      state name matching your search specification, it'll display what it
  70.      finds and instruct you to narrow your search a bit more.
  71.  
  72.           Once AC finds your state, it will display all area codes and CO
  73.      cities that have at least fifteen exchanges.  Having this minimum
  74.      prevents AC from flooding you with output.  You can specify different
  75.      minimum and maximum exchange values - more on this under '-Cx:y'.
  76.  
  77.  
  78.      areacode   (either state or areacode required)
  79.           Three digit area code that you wish to search.  AC will show the
  80.      state owning this area code as well as all CO cities having at least
  81.      five exchanges.  Use this parm if you are not sure of the state.
  82.  
  83.  
  84.      city
  85.           AC allows you to narrow your search to only those CO cities
  86.      whose name begins with what you specify here.  You must specify
  87.      either a state or area code along with this parm.  When specifying a
  88.      city, the minimum exchange value automatically defaults to one to
  89.      yield the greatest chance of locating your item.
  90.  
  91.  
  92.      xchg
  93.           AC also allows you to specify the exchange (first three digits
  94.      of the local phone number) as the search criteria.  This is most
  95.      useful if you have only an area code and phone number - and wish to
  96.      know it's location (state and CO city name).  As with the 'city'
  97.      parm, you must specify either a state or area code along with this
  98.      parm.  When specifying an exchange, the minimum exchange value
  99.      automatically defaults to one to yield the greatest chance of
  100.      locating your item.
  101.  
  102.  
  103.      -P
  104.           Pause after every twenty lines of output.  AC is capable of
  105.      generating huge amounts of output if you widen the search too much.
  106.      But sometimes a sidw search is necessary.  You can either redirect
  107.      AC's output to a file or use the -P switch.
  108.  
  109.  
  110.      -X
  111.           Normally, AC only shows the state name, area code, and CO city
  112.      in it's output.  By using this switch, AC will also display all
  113.      exchanges belonging to the located CO cities.  Be advised that this
  114.      option can generate ALOT of output if the search specification is too
  115.      wide.
  116.  
  117.  
  118.      -Cx:y
  119.           AC allows you to locate CO cities with at least x number of
  120.      exchanges but no more than y number of exchanges.  This is useful if
  121.      you wish to locate CO cities of an approximate size.  ie: You could
  122.      specify -C10:999 to find mostly larger CO cities, or -C1:2 to find
  123.      smaller CO cities.  If you do not specify this parm, then AC will
  124.      select values based on your other search specifications as follows:
  125.  
  126.           parm slected  minimum  maximum
  127.           ------------  -------  -------
  128.           state          15       999
  129.           areacode        5       999
  130.           city            1       999
  131.           xchg            1       999
  132.  
  133.           The lowest value calculated based on your search specification
  134.      will be used.  To widen the search where a minimum other than one is
  135.      calculated, simply include '-C1:999' on the command line.
  136.  
  137.  
  138.      Example
  139.      -------
  140.  
  141.           The command 'ac 713.buf -x'  will display:
  142. TX  Texas
  143.  
  144.     A/C Central Office  Current Valid Exchange(s)
  145.     --- --------------- -------------------------------------------------------
  146.     713 buffalo         293 493 496 497 531 556 558 584 588 589 596 870
  147.  
  148.  done
  149.  
  150.           This shows you:  The state of Texas has a central office called
  151.      'buffalo' in the 713 area code and has twelve exchanges listed.
  152.  
  153.           The most common way you're likely to execute AC is by specifying
  154.      just a state or an area code - with no additional parameters.
  155.  
  156.           By specifying a city search mask after the state or area code,
  157.      you'll narrow the search to only those cities.  This is useful if you
  158.      get gobs of output otherwise.  The default minimum of fifteen is
  159.      lowered to one to ensure the greatest possible chance of locating
  160.      your city.  Since city searches add overhead to AC, you'll likely
  161.      notice a small delay between city displays while AC accesses the data
  162.      files.  This delay is more noticable on XT type mechines.  On ATs and
  163.      386's, this delay is much less noticeable regardless of how narrow
  164.      the search.
  165.  
  166.           By specifying an exchange after the state or area code, you'll
  167.      narrow the search to only those cities having that exchange.  This is
  168.      especially useful if all you have is a phone number with area code
  169.      and you wish to locate the city.  As with the city search mask, this
  170.      parm may delay the output slightly.
  171.  
  172.  
  173.      Operational notes
  174.      -----------------
  175.  
  176.           You must minimally specify either the state or areacode to
  177.      search.  All other parameters are optional.
  178.  
  179.  
  180.      PLEASE NOTE:
  181.  
  182.           The cities displayed are not technically cities per se - but
  183.      rather the telephone company's CENTRAL OFFICE designation from the
  184.      VNH tables.  As it happens, CO designators are generally the city
  185.      name - but not always.  Take the Buffalo example above.  There is no
  186.      Buffalo in texas (well, maybe some buffalo chips - wear boots, heh
  187.      heh).  The Buffalo CO is *inside* the Houston city limits.  But the
  188.      CO designator is Buffalo.  If you make an L/D call to any exchange in
  189.      that CO, you'll see Buffalo (not Houston) on your L/D phone bill!
  190.      This may change - but for now, it's Buffalo!
  191.  
  192.           Also, some city names may appear to be spelled incorrectly.
  193.      Again, this is due to it being a CO designator.  If it appears to be
  194.      misspelled, it's not.  The CO is spelled that way.  This is why the
  195.      city specific parameter is a search mask - not an exact match.  It
  196.      helps you to locate a city that may not be spelled the 'regular' way.
  197.      But it only locates from the first character forward - not a sliding
  198.      match.  ie:
  199.  
  200.           you specify:  tx.ros
  201.  
  202.           Texas has two CO's with 'ros' in the name:  Crosby and Rosharon.
  203.      But only Rosharon will be displayed.  Obviously, I could have coded
  204.      AC to find both - but I figured that this way is more useful.  If you
  205.      want to find Rosharon but were not sure of the spelling, 'ros' would
  206.      find it for you.  You almost certainly weren't looking for Crosby -
  207.      or you'd have specified 'cro' (or the like) instead.
  208.  
  209.           You can terminate AC at anytime during execution by striking any
  210.      key (other than shift, alt, etc.).  Because AC aborts when any key is
  211.      struck, you cannot stack keystrokes after entering your AC command or
  212.      you'll immediately abort.
  213.  
  214.  
  215.      Configuring path for data file
  216.      ------------------------------
  217.  
  218.           AC has a setup option that allows you to configure the drive and
  219.      path location of the AC-DATA.* files.  Until you configure AC to look
  220.      on a specific drive/path, it will look only in the current directory.
  221.  
  222.           Suppose you have a subdirectory called 'c:\text'.  You can
  223.      configure AC to always look there - regardless of what drive or
  224.      directory is current.  To invoke the configuration option, just
  225.      enter:
  226.  
  227.           AC -setup   (enter)
  228.  
  229.           You'll be shown the old path, if one exists, and prompted to
  230.      enter a new one.  The setup option actually patches the AC.EXE
  231.      program file with the path you specify, so AC.EXE *must* be in the
  232.      CURRENT subdirectory for the setup option to work.  Also, it must not
  233.      be write-protected.  Once AC.EXE has been configured, you can execute
  234.      AC from any drive/directory (as long as it's on the path, of course)
  235.      and the data files can be placed on the drive/directory you
  236.      specified.
  237.  
  238.  
  239.      Miscellaneous
  240.      -------------
  241.  
  242.           AC, like many other programs, flies under the shareware banner.
  243.      If you like and use AC, then *please* register.  You've heard this
  244.      before, so....  Please register - it's is only affordable way to
  245.      bring software to you.
  246.  
  247.           The shareware copy you have before you functions the same in
  248.      every respect as the registered version - but with an opening
  249.      'register-me' screen that appears randomly (approx.  50% of the time)
  250.      at the beginning of execution.  This screen will forcibly remain for
  251.      ten seconds, after which you can press a key to continue to display
  252.      your data.
  253.  
  254.           Registration is twenty five dollars.  For your $$$, you'll
  255.      receive a non-advertising copy and free updates for one year.  You
  256.      can register by sending check, money order, and even cash (imagine
  257.      that, ha ha) to the following address.  Or you can register using
  258.      Visa/MC by calling the following number.
  259.  
  260.  
  261.                Robert K. Ricketts
  262.                PC Consultant
  263.                P.O. Box 42086
  264.                Houston TX 77242-2086
  265.                Ph. 713/826-2629  (v-mail no answer)
  266.                BBS 713/870-1508  (thats in Buffalo, no chips here!)
  267.  
  268.           Thank you for using AC and for registering if you like it!
  269.  
  270.  
  271.          ∙-═≡═-∙  Other products offered by the PC Consultant  ∙-═≡═-∙
  272.  
  273.  
  274.           « TimeLock »
  275.  
  276.           TimeLock is a tiny memory resident security utility that locks
  277.      the PC keyboard after a user pre-specified period of inactivity,
  278.      thereby protecting a sensitive LAN/mainframe userid or application
  279.      program from spying eyes and curious fingers while you are away.  An
  280.      invaluable addition to your company's PC security arsenal!
  281.  
  282.           TimeLock can be instantly locked via hot-key, batch file, or
  283.      through keyboard inactivity.  The *only* way to gain re-access to the
  284.      PC once the keyboard is locked is by entering your secret password.
  285.      Otherwise the PC must be cold-booted (powered off & on).  And that,
  286.      of course, will terminate your sensitive LAN/mainframe connection -
  287.      protecting your userid from intrusion!
  288.  
  289.           TimeLock is written entirely in assembly language for optimum
  290.      speed and size.  Uses only 2K RAM!
  291.  
  292.           Please telephone at the above number for more details on
  293.      TimeLock.  If you are a corporate network administrator in charge of
  294.      company PCs or PC products manager charged with software evaluation
  295.      and recommendation, I'll send you a diskette free of charge so you
  296.      can evaluate TimeLock for yourself.  Or, if you wish, you can
  297.      download TimeLock from my support BBS.  You need register only if you
  298.      decide to use TimeLock.
  299.  
  300.           Thank you once again for choosing software by the PC Consultant!
  301.  
  302.