home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1994 January / AMSOFT_1994.iso / misc / dxlocatr / prog / dx.doc < prev    next >
Encoding:
Text File  |  1993-12-31  |  11.4 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                      ╔══════════════════════════════════╗
  8.                      ║    The  K B 2 B K  DX Locator    ║
  9.                      ║              ─────               ║
  10.                      ║         Copyright (c) 1990       ║
  11.                      ╚══════════════════════════════════╝
  12.  
  13.  
  14.  
  15.  
  16.  
  17.          What the Heck is it?
  18.          ────────────────────
  19.  
  20.          In brief, the DX locator is an easy-to-use program which
  21.          allows you to quickly determine beam headings and distances
  22.          to countries all over the world.
  23.  
  24.          The program is flexible.  You can enter the callsign prefix
  25.          from a station you hear on the air, and before you lift your
  26.          finger from the Enter key, the country's name, heading and
  27.          distance appear on the screen.  You can also enter the
  28.          country's name and retrieve the prefix, heading and distance.
  29.          If you are in the mood to browse, you can take a page your
  30.          way through the entire database just to see what's there!
  31.  
  32.  
  33.          How do I run it?
  34.          ────────────────
  35.  
  36.          You can run the program from a single floppy disk drive or
  37.          you can install it on your hard drive.  The entire database
  38.          is read into your computer's memory when you run the program;
  39.          so other than convenience and shorter load time, there is no
  40.          particular advantage in fixed disk operation.  Run the
  41.          program from any drive you wish.
  42.  
  43.          To start the program, type DX <Enter>.  (Make sure all the
  44.          files are resident on the same drive you start DX.EXE from).
  45.          A title screen appears and the program waits for you to press
  46.          a key.  After your keystroke, it will take a few seconds to
  47.          load the database into memory.
  48.  
  49.          When the program's operating screen appears you will notice a
  50.          small (6 character) field near the lower-left corner.  All
  51.          communication with the program is done through this box.  You
  52.          can exit from the DX Locator by typing "STOP", "QUIT" or
  53.          "END" in the box.
  54.  
  55.  
  56.          Searching in the Prefix Mode
  57.          ────────────────────────────
  58.  
  59.          You can be as specific as you like when you initiate a
  60.          search.  But remember, if you are too specific the program
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.          may not be able to match a prefix with your input.  If you
  74.          are not specific enough, you may get extra output that you
  75.          will have to "wade" through to find what you really want.
  76.  
  77.          Let's look at an example.  Suppose you hear a station with a
  78.          UK5 prefix and decide you would like to answer his CQ.  Any
  79.          self respecting "DX hound" would know he was most likely
  80.          listening to a Club Station in the Ukraine.  But you would
  81.          like to be precise when you rotate that 5-element pigeon-
  82.          perch, wouldn't you?  QSL!
  83.  
  84.          Here are some possible entries you might make from the Prefix
  85.          mode, and the results:
  86.  
  87.          You type              DX Locator's output
  88.          ───────────────────────────────────────────────────────
  89.          <Enter>               The entire database (paged)
  90.          U <Enter>             All prefixes beginning with "U"
  91.          UK <Enter>            All prefixes beginning with "UK"
  92.          UK5 <Enter>           UK5 - The Ukraine
  93.          UK5XX <Enter>         (No match found)
  94.  
  95.          Note that the UK5 you seek is present in each of the first 4
  96.          entries.
  97.  
  98.  
  99.          Searching in the Country Mode
  100.          ─────────────────────────────
  101.  
  102.          Press F2 to put DX Locator into the "Country Mode".  Ok, you
  103.          are ready to go.  But wait!  How can long country names be
  104.          entered in a field only 6 characters wide?  Frankly, 6
  105.          characters is enough information to zero-in on most
  106.          individual countries.  But, in the Country Mode ALL of the
  107.          prefixes associated with the country will also be included in
  108.          the output.
  109.  
  110.          Let's search for the Ukraine as we did above, except we will
  111.          initiate the search from the Country Mode.
  112.  
  113.          You type              DX Locator's output
  114.          ───────────────────────────────────────────────────────
  115.          <Enter>               The entire database (paged)
  116.          U <Enter>             25 countries beginning with "U"
  117.          UK <Enter>            The Ukraine
  118.          UKR <Enter>           The Ukraine
  119.          UKRA <Enter>          The Ukraine
  120.  
  121.          In this case, you only needed to enter a couple of letters to
  122.          find the target country.
  123.  
  124.          NOTE: If you accidentally press <Enter> in either mode and
  125.          dump the entire database, you do not have to page your way
  126.          through all of the data.  Press <Esc> to terminate paging.
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          Date and Time Display
  140.          ─────────────────────
  141.  
  142.          A few words about date and time in the lower-right corner of
  143.          the screen.  When you start the program, the date and time
  144.          are retrieved from your system.  (If you do not keep correct
  145.          time on your system then the display is useless).  The time
  146.          element is converted to GMT or Zulu time offset from Eastern
  147.          Standard Time.  During the summer months the offset changes
  148.          by 1 hour since the local clocks are pushed ahead.
  149.  
  150.          You can show the correct GMT while EDT (E. Daylight Time) is
  151.          in effect by pressing F3.  Pressing F3 reduces the GMT offset
  152.          by 1 hour.
  153.  
  154.          Please note that the date displayed is ALWAYS the local
  155.          system date, NOT the date associated with GMT.  Between the
  156.          hours of 00:00Z and Midnight (local time) the date displayed
  157.          is actually 1 day BEHIND with respect to GMT.
  158.  
  159.  
  160.          The Browse Mode
  161.          ───────────────
  162.          As you have probably realized by now, the DX Locator has a
  163.          value beyond that of simply supplying beam headings.  It is a
  164.          source of general information.  Indeed, a DX'er running an
  165.          omni-directional antenna system or even an SWL will find the
  166.          program useful in rapidly identifying countries and making a
  167.          determination where the countries are located.  Using the
  168.          program may not exactly plot the location of Fletcher
  169.          Christian's doorstep, but it will lead you to the correct
  170.          ocean!
  171.  
  172.          Press F4 to enter the Browse mode.  Now you can use the data
  173.          as a look-up table.  When you start browse you will be
  174.          positioned at the first 10 records.  You can use the cursor
  175.          keys to scroll through the data one record at a time.  Using
  176.          the "Page Up" and "Page Down" keys will move you through the
  177.          data 10 records at a time.  Pressing the "Home" key will
  178.          return you to the first 10 records while pressing "End"
  179.          advances you to the end of the data.  Don't get too dizzy!
  180.  
  181.  
  182.          The Data File BEARING.DAT
  183.          ─────────────────────────
  184.  
  185.          The data found in BEARING.DAT assumes a station position near
  186.          the center of New York State.  Considering the angle of
  187.          optimum radiation of the typical directional HF antenna, the
  188.          headings given should produce acceptable results if your
  189.          station location is in the northeastern U.S.  If not, my
  190.          apologies.  Calculation of these headings is beyond the scope
  191.          of my intentions for this program.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.          The beam headings given are to the geographical centers of
  206.          the target countries.  In the case of a large country which
  207.          is also close, such as Canada, you will need to keep this in
  208.          mind and compensate as needed.
  209.  
  210.          The distances given are calculated in statute miles.  Any
  211.          distance represents the shortest distance (great circle) from
  212.          MY location to the geographical center of the target country.
  213.  
  214.          The file itself is a sequential, ASCII file.  It can be
  215.          edited with any text editor or word processor with the
  216.          capability of ASCII output.  You may edit the data file for
  217.          the purpose of adding new countries, deleting old countries
  218.          or optimizing the direction and distance data.  The only
  219.          caution I offer is to maintain the column format exactly as
  220.          it is.  To change the format will cause the data to be
  221.          misaligned with the program's template.
  222.  
  223.          The organization of the file follows, more or less, the order
  224.          laid out in the ARRL DXCC Countries listing.  If you choose
  225.          to add a new country, for convenience sake I suggest
  226.          insertion of the new country into a prefix block
  227.          alphabetically.  I suggest this because you can print-out the
  228.          data file and use it as a handy desk reference or a DXCC
  229.          checklist, perhaps.  If the data is organized alphabetically
  230.          by prefix, you will find countries easily.  In terms of
  231.          program function, however, the order of the data makes no
  232.          difference.  Each time a search is initiated, the entire
  233.          database is scanned regardless of the number of matching
  234.          records that are found.
  235.  
  236.  
  237.          Function Key Description
  238.          ────────────────────────
  239.  
  240.          F1 - Displays a Help panel.
  241.          F2 - Toggles between Prefix [Default] and Country mode.
  242.          F3 - Toggles Daylight Savings Time Off [Default] or On.
  243.          F4 - Enter Browse mode. <Esc> to exit Browse.
  244.  
  245.  
  246.          Why'd ya do it?
  247.          ───────────────
  248.  
  249.          I wrote this program for a number of reasons.  I sensed a
  250.          need.  I like Hams.  I like DX and appreciate the ART of
  251.          being a successful DX chaser.  (DXCC/CW #1011).  I always
  252.          wanted to get my hands on something that would give me this
  253.          kind of information, this fast.  I like to "play" with
  254.          computers.  It seemed like a worthy application.  I felt an
  255.          urge to give something back to the hobby that has given me so
  256.          much enjoyment.  So, why not?
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          The License (Oh yeah!)
  272.          ──────────────────────
  273.          You are granted a license to use this program, as long as you
  274.          wish, without monetary obligation.  You may make as many
  275.          copies as you need.  You may distribute copies to other Hams.
  276.          You may post this program and associated files on Bulletin
  277.          Board Systems.
  278.  
  279.          I only ask that you include all files, including this DOC,
  280.          with any copies you make.  In addition, please do not alter
  281.          or attempt to reverse-engineer the program or any of the
  282.          support files. (You may edit the BEARING.DAT as outlined
  283.          above).  I do retain Copyright.
  284.  
  285.  
  286.          A Parting Shot
  287.          ──────────────
  288.  
  289.          For those of you whom might be interested, the program was
  290.          written in Turbo Pascal 5.0.  It was fun to write and debug.
  291.          I was not able to test it on all conceivable system
  292.          configurations but I believe you will find it a well-behaved
  293.          little program.  I hope the DX Locator will be useful to you
  294.          and find a comfortable home on your system.  Enjoy!
  295.  
  296.          Comments are welcomed.  I'm good in the CallBook!
  297.  
  298.          73,
  299.  
  300.          KB2BK
  301.          Bob Joy
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.