home *** CD-ROM | disk | FTP | other *** search
/ Hacker Chronicles 2 / HACKER2.BIN / 1245.SHORT.DOC < prev    next >
Text File  |  1987-09-10  |  16KB  |  460 lines
  1.  
  2.  
  3.  
  4.               SHORTWAVE FREQUENCY DATABASE PROGRAM Version 1.4
  5.  
  6.                                   Overview
  7.  
  8.      The Shortwave Frequency Database program is designed to take frequency
  9. information from various sources and give one the ability to manipulate the
  10. data. The program can print the data in a regular columnar format or in the
  11. "BBC" format as found in their program guide.
  12.  
  13.      I wrote the program to help me keep track of English language broad-
  14. casts to North America, and I seemed to have gotten carried away. The pro-
  15. gram takes data in the form of
  16.  
  17.           United Kingdom  BBC   2200 - 2330   5.975, 6.175, 9.410
  18.           United Kingdom  BBC   0030 - 0100   5.975, 6.140
  19.           Netherlands           0000 - 0200   9.435, 7.125
  20.  
  21. and prints it out by country:
  22.  
  23.                             Greenwich Mean Time
  24.             0000 0100 0200 0300 0400 0500 ... 2100 2200 2300
  25.     NETHERLANDS                   DAILY
  26.       9.435 EEEE EEEE .... .... .... ....     .... .... ....  9.435
  27.       7.125 EEEE EEEE .... .... .... ....     .... .... ....  7.125
  28.     UNITED KINGDOM       BBC      DAILY
  29.       9.410 .... .... .... .... .... ....     .... EEEE EE..  9.410
  30.       6.175 .... .... .... .... .... ....     .... EEEE EE..  6.175
  31.       6.140 ..EE .... .... .... .... ....     .... .... ....  6.140
  32.       5.975 ..EE .... .... .... .... ....     .... EEEE EE..  5.975
  33.             1900 2000 2100 2200 2300 0000 ... 1600 1700 1800
  34.                                 Local Time
  35.  
  36. by frequency:
  37.  
  38.                             Greenwich Mean Time
  39.             0000 0100 0200 0300 0400 0500 ... 2100 2200 2300
  40.     UNITED KINGDOM       BBC      DAILY
  41.       5.975 ..EE .... .... .... .... ....     .... EEEE EE..  5.975
  42.       6.140 ..EE .... .... .... .... ....     .... .... ....  6.140
  43.       6.175 .... .... .... .... .... ....     .... EEEE EE..  6.175
  44.     NETHERLANDS                   DAILY
  45.       7.125 EEEE EEEE .... .... .... ....     .... .... ....  7.125
  46.     UNITED KINGDOM       BBC      DAILY
  47.       9.410 .... .... .... .... .... ....     .... EEEE EE..  9.410
  48.     NETHERLANDS                   DAILY
  49.       9.435 EEEE EEEE .... .... .... ....     .... .... ....  9.435
  50.             1900 2000 2100 2200 2300 0000 ... 1600 1700 1800
  51.                              Local Time
  52.  
  53. or in a standard columnar format:
  54.  
  55.                  SHORT WAVE DATABASE SORTED BY COUNTRY ON 09/04/87
  56. Country          Station  B-Tm E-Tm  Frequencies           Target  Language
  57. ---------------- -------- ---- ----  --------------------  ------- ---------
  58. GREAT BRITAIN    BBC      2200 2330  5.975  6.175  9.410   ENA     ENGLISH
  59. GREAT BRITAIN    BBC      2430 0100  5.975  6.140          ENA     ENGLISH
  60. NETHERLANDS               2400 0200  9.435  7.125          ENA     ENGLISH
  61.                    (columns shortened in above examples)
  62.  
  63.      By the way, in the "BBC" examples, the program consolidated the list-
  64. ings for 5.975 and printed it out on one line.
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      I offer my program to the SWLers out there who have an IBM PC and would
  71. like to tie together their computer and DXing hobbies.
  72.  
  73.      The program was written with Turbo Pascal 3.0, using the Turbo Database
  74. Toolbox. It was tested on an IBM PC-XT with a monochrome monitor and an IBM
  75. PC with a B&W monitor attached to a color/graphics adapter. The program
  76. requires 256K of RAM and DOS 2.0 or greater.
  77.  
  78.      This is my first program that I am offering to others, and I would like
  79. to see if the user-supported software concept works. I am asking for a dona-
  80. tion of $10.00 if you find this program useful. If you like the program (or
  81. even if you don't), please feel free to give the program to anyone you think
  82. would be interested in it. I am always open to comments or suggestions in
  83. order to make the program even better.
  84.  
  85.      Let me hear from you!
  86.  
  87.  
  88.                                Dan Keever
  89.                                2405 Highland Avenue
  90.                                Durham, NC  27704
  91.  
  92.  
  93.  
  94.  
  95.      MAIN CHANGES IN VERSION 1.4 OVER VERSION 1.0:
  96.  
  97.      1. I fixed a bug in the data consolidation routine when the program
  98. prints out the BBC report by frequency.
  99.      2. The editing routine allows you to page through and edit an entire
  100. country's data instead of editing one form at a time.
  101.      3. On the Update screen, the UTC times are given under the Beginning
  102. and Ending times.
  103.      4. The Report feature now sorts by country, frequency, AND days aired.            
  104. The '*' and '-' are no longer used to indicate that a broadcast is not
  105. directed toward North America.
  106.      5. The CAPS and NUM Lock on-screen indicators now work properly.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                     SHORTWAVE FREQUENCY DATABASE PROGRAM
  137.                              Using the program
  138.  
  139.      To Begin the program - Type SHORT at the DOS prompt. For example,
  140.                                   A>SHORT
  141.      To print the documentation on your printer type -
  142.                            A>TYPE SHORT.DOC>LPT1:
  143.  
  144.      The main menu appears:
  145.  
  146.     ╔═════════════════════════════════════════════════════════════════════╗
  147.     ║ Short Wave Frequency Database Program                               ║
  148.     ╟─────────────────────────────────────────────────────────────────────╢
  149.     ║                                                                     ║
  150.     ║    1... [U]pdate the database                                       ║
  151.     ║    2... Print a sorted [L]ist                                       ║
  152.     ║    3... Print out a BBC format [R]eport                             ║
  153.     ║    4... Print out [I]ndividual countries in BBC style               ║
  154.     ║    5... Set up [P]rinter for condensed print                        ║
  155.     ║                                                                     ║
  156.     ║    6... [Q]uit the program and save the data                        ║
  157.     ║   [ ]                                                               ║
  158.     .                                                                     .
  159.     .                                                                     .
  160.     ║                                                                     ║
  161.     ╚═════════════════════════════════════════════════════════════════════╝
  162.  
  163.      To select one of the choices, type in the number or the first letter of
  164.   the desired command. For example, to choose Update, type < 1 > or < U >.           
  165.   No carriage return is needed.
  166.  
  167.     Described below are the subcommands for each of the main menu choices:
  168.  
  169.         [U]PDATE THE DATABASE
  170.           Add  - add an additional form to the database.
  171.           Find - finds a country's first form so that any of the
  172.                  country's data can be edited or deleted.
  173.           Quit - ends the Update routine and returns to the main menu.
  174.  
  175.         PRINT A SORTED [L]IST
  176.           prints a listing sorted by Country, Station, Beginning Transmis-
  177.           sion Time, Target Area, or Language. The print can be routed to a
  178.           printer or to disk (to the file SHORT.PRN). This routine creates
  179.           the file NUM.INX in order to sort the data for the printout.
  180.  
  181.         PRINT OUT A BBC FORMAT [R]EPORT
  182.           prints the listing in the BBC format. The print can be routed to a
  183.           printer or to disk (to the file SHORT.CTY if it is sorted by
  184.           Country or SHORT.FRQ if sorted by Frequency). The program will ask
  185.           how many hours BEHIND UTC is your local time (for example, input
  186.           < 5 > if you are using Eastern Standard Time). It will print your
  187.           local time at the bottom of each printout page.
  188.  
  189.         PRINT OUT [I]NDIVIDUAL COUNTRIES IN BBC STYLE
  190.           prints out the same listing as REPORT, except that one can choose
  191.           which countries one wants on the printout. The information can go
  192.           to the printer or to a file (SHORT.IND).
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                              Using the program (cont.)
  202.  
  203.         SET UP [P]RINTER IN CONDENSED PRINT
  204.           allows you to change the default printer code to print in com-
  205.           pressed print. On the IBM Proprinter, for example, the code is
  206.           decimal 15 or Escape 15. For C-Itoh printers, the code is Escape Q
  207.           (entered in the program as their ASCII equivalents 27 and 81).     
  208.  
  209.         [Q]UIT THE PROGRAM AND SAVE THE DATA
  210.           will end the execution of the program. In order to preserve all of
  211.           the files, BE CERTAIN to QUIT out of the program until you get the
  212.           DOS prompt (i.e., A> or C> ).
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                     SHORTWAVE FREQUENCY DATABASE PROGRAM
  269.                                Update Command
  270.  
  271. 1                                  UPDATE <-----(Main Menu)--------------
  272.                                       |                                 | 
  273. 2   --> ADD ------------------------ FIND -----------------------------QUIT
  274.     |    |                            |                                  
  275. 3   |    |       --> NEXT -------- PREVIOUS ---------- QUIT              
  276.     |    |       |     |              |                 |                
  277.     |    |       ---------------------                  |                
  278.     |    |                          ---------------------                
  279.     |    |                          |                                    
  280. 4   |    |  --------> EDIT ----- DELETE ----- NEXT ----- QUIT            
  281.     |    |  |           |           |           |         |              
  282. 5   |    |  |           |          Yes -- No    |         |              
  283.     |    |  |           |           |      |    |         |              
  284.     |    |  |           |           |      |    |         |              
  285. 6   |   Add |         Edit       Delete    |    |         |              
  286.     |    |  |           |           |      |    |         |              
  287.     |    |   -----Go to country's next form------         |              
  288.     -------------------------------------------------------
  289.  
  290.      Level 1: UPDATE is found on the main menu.
  291.  
  292.      Level 2: ADD allows a new form to be entered.
  293.               Press <F10> when all the information is correct.
  294.  
  295.      Level 2: FIND will locate an existing form by Country for editing or
  296.      Level 3: deleting. Since there can be many forms for each country, you
  297.               have the ability to page through the forms with the NEXT and
  298.               PREVIOUS commands. When you have found the form you wish to
  299.               edit or delete, type Q to QUIT. You need not enter the entire
  300.               country name, but just a few characters. You may now edit each
  301.               form for a particular country without leaving the UPDATE rou-
  302.               tine.        
  303.  
  304.      Level 4: EDIT allows you to edit the newly found form. Again, press
  305.               <F10> when all the information is correct.
  306.               DELETE allows you to delete the form.
  307.  
  308.      Level 5: Type Y to delete the form or N to keep the form.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      Notes under the ADD command:
  335.  
  336.      1. The program will capitalize everything for you. You don't need to
  337. worry about upper and lower case characters.
  338.  
  339.      2. The previous Country and Station appear upon adding a new form,
  340. thereby making it unnecessary to reenter the same information over again.
  341.  
  342.      3. The Target Area defaults to ENA (Eastern North America). The program
  343. keys on the NA part, so if a station broadcasts to the USA, it is necessary
  344. to put NA as the target area. (More on this below.)
  345.  
  346.      4. The Language defaults to ENGLISH. The program takes the first
  347. character of the word and uses it in the BBC report. (Again, more on this
  348. below.)
  349.  
  350.      5. The When field defaults to DAILY. It is necessary for the program to
  351. see the complete word in order to function correctly. (Once again, more on
  352. this below.)
  353.  
  354.      6. The times are entered as follows:
  355.           Hour:   Enter the corresponding letter. Examples:
  356.                          X = 24 or 00 hours,
  357.                          B = 02 hours.
  358.           Minute: Enter 0 for 00, 1 for 15, 3 for 30, or 4 for 45
  359.                   minutes past the hour.
  360.      The program ONLY handles time in increments of 15 minutes.
  361.  
  362.      7. After the times are entered, the BBC format will be shown for those
  363. times. An example,
  364.  
  365.          .... EEEE EE.. .... .... .... .... .... .... .... .... ....
  366.          .... .... .... .... .... .... .... .... .... .... .... ....
  367.  
  368.      The program will show in CAPS any station that is broadcasting in
  369. English to North America (hence the need for NA in the Target Area field). 
  370. The program also takes the first character of the Language field and uses it
  371. to indicate what language the station is broadcasting.
  372.      Therefore, the above example shows the station broadcasts from
  373. 0100-0230 UTC in English to North America.
  374.  
  375.      Here is another example:
  376.  
  377.          eee. .... .... .... .... .... .... .... .... .... .... ....
  378.          .... .... .... .... .... .... .... .... .... .... .... eeee
  379.          (Broadcasts from 2300-0045 UTC in English but not to NA.)
  380.  
  381.      8. The frequencies can be entered in any format:
  382.  
  383.                           15.26 becomes 15.260.
  384.                           6     becomes  6.000.
  385.                           6.1   becomes  6.100.
  386.                           610   becomes  0.610.
  387.                           6175  becomes  6.175.
  388.  
  389.         As you can see, the program translates, if necessary, from kilohertz
  390. (kHz) to megahertz (mHz).
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      9. The format of the Updated field is MM/DD/YY. The program will add
  401. any leading zeroes if needed (e.g., 3/3/87 becomes 03/03/87). Also, if today
  402. is the update day, press ALT-D to automatically input the date.
  403.     10. Notes on the Numeric Keypad:
  404.  
  405.          To move from one field to another:
  406.             RETURN  or <down arrow>   to move forward.
  407.                        <up arrow>     to move backward.
  408.  
  409.          To move within the field:
  410.             --> moves one character to the right
  411.             <-- moves one character to the left.
  412.  
  413.          To erase the entire field:
  414.             Ctrl - End
  415.  
  416.          To go to the beginning of the field:
  417.             Home
  418.  
  419.          To go to the end of the field:
  420.             End
  421.  
  422.  
  423.     11. Continually pressing RETURN or <down arrow> will keep circling all
  424.             the data fields. To end the editing, press <F10>.
  425.  
  426.  
  427.  
  428.  
  429.  -------------------------------------------------------------------------
  430.  
  431.  
  432.  
  433.      DATASETS INCLUDED IN THIS PACKAGE:
  434.  
  435.          SHORT.COM - The main program.
  436.          SHORT.DAT - The database you create.
  437.          SHORT.INX - The index file for the database. This file contains the
  438.             sorted country fields to make finding a particular record in the
  439.             database easier.
  440.          SHORT.CTY - The BBC format sorted by Country.
  441.          SHORT.FRQ - The BBC format sorted by Frequency.
  442.          SHORT.PRN - The columnar listing of the data.
  443.  
  444.  
  445.          Only the .COM file is needed to begin using the program. The data
  446.             contained in the .DAT file is erroneous and is included as an
  447.             example.
  448.  
  449.          The program and the data expect to be on the same disk;so it would
  450.             be best to put the .COM program on its own floppy disk. If you
  451.             use a hard disk, place the program into whatever subdirectory
  452.             you wish - the datasets will be created on that subdirectory.
  453.  
  454.          The .INX file can, at times, become corrupted. You can tell that
  455.             when your data seems to go haywire. Usually a corrupted index
  456.             file occurs when you forget to exit the program completely. To
  457.             remedy the problem, type "}" at the main menu. This will create
  458.             a file called NUM.INX which you will need to put in place of the
  459.             SHORT.INX file.                                                  
  460.