home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 3 / hamradioversion3.0examsandprograms1992.iso / control / tenx10 / manual. < prev    next >
Text File  |  1991-06-27  |  23KB  |  541 lines
  1.  
  2.  
  3.  
  4.                                    10-X
  5.  
  6.  
  7.  
  8.                      Ten Ten  Number and Contact Manager
  9.  
  10.  
  11.                             copyright (c) 1991 by
  12.  
  13.  
  14.                           Robin A. Gist, NE4L/ZF2PM
  15.                       Renaissance Software & Development
  16.  
  17.  
  18.                              all rights reserved
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                                  L I C E N S E
  28.  
  29.  
  30.  
  31.         This program and documentation copyright (c) 1991 by Robin Gist
  32.         and Renaissance Software & Development.  No duplication of these
  33.         pages and software can be made without the permission of
  34.         Robin Gist and Renaissance Software & Development.  This does not
  35.         include the free distribution and duplication of this program
  36.         (which may be done freely, without explicit permission).  Again,
  37.         you may give away copies of this program to anyone that you see
  38.         fit, as long as you give them the ENTIRE package (see README file).
  39.  
  40.  
  41.         Robin Gist and Renaissance Software & Development makes no guarantee
  42.         to the performance of this software and is not liable for any
  43.         damages that may occur by using it.  By using the software, you
  44.         explicitly agree to these terms.
  45.  
  46.  
  47.         You may give copies of this software away ONLY if you make copies of
  48.         all of the files on the diskette, and you do not modify any of the
  49.         text files.  If you are a distributor, you must not charge more than
  50.         a nominal fee of $4 per disk (not including shipping)
  51.  
  52.  
  53.         If you use the program regularly, and for more than 30 days, you
  54.         are required to register it with the author in order to comply with
  55.         the license agreement.
  56.  
  57.  
  58.         -----------
  59.  
  60.         Now that I have the legalese out of the way, lets get down to
  61.         business.
  62.  
  63.         -----------
  64.  
  65.  
  66.         What is 10-X??
  67.         --------------
  68.  
  69.  
  70.         10-X is an information management system for ham radio operators
  71.         who collect 10-10 numbers.  If you don't know what a 10-10 number
  72.         is, just get on 10 meters and ask anyone who frequents the band
  73.         a lot, or just tune around.  If the band is open, you are bound
  74.         to hear tons of people exchanging numbers like '31224', etc., and
  75.         other information that doesn't really make any sense to the
  76.         untrained ear.
  77.  
  78.         For those of you who are 10-10 number hunters, this program is
  79.         here to help you.  I wrote it in response to a call from a
  80.         gentleman in South Carolina who was looking for just such a program.
  81.         (I'm sorry that I can't remember his name or call, but I hope that
  82.         he gets a copy of it!!!)  He needed a program that would let him
  83.         keep track of all of the 10-10 numbers he collected, the information
  84.         that he needed in order to get credit for working that number and
  85.         a way to quickly and easily submit new numbers.  Well, here it is!
  86.  
  87.  
  88.         What will 10-X do???
  89.         --------------------
  90.  
  91.         10-X will do several things that are very handy to the number
  92.         collector.  First of all, 10-X will install as a TSR (terminate
  93.         and stay resident) program so that you can use your present
  94.         logging program and pop-up 10-X anytime you want in order to
  95.         access the information that you need.  This way, you don't have
  96.         to leave your logging program in order to get at your 10-10
  97.         collection.  If you don't want to install it as a TSR, then you
  98.         can just run it in regular mode - no problem at all.
  99.  
  100.         With 10-X, you can enter new stations worked, all of their
  101.         information and even add notes containing information about
  102.         their awards (a peculiarity about avid 10-10 paper chasers
  103.         that I don't quite understand, but hey - we're hams!), you can
  104.         look up any 10-10 number to see if you have worked it, you can
  105.         look up any callsign to see if you have worked, you can
  106.         print out a list of ALL 10-10 numbers you have worked, showing
  107.         whether or not they have been submitted for credit (as well as
  108.         all other information about the number), you can print out a
  109.         submission listing of all new numbers so that you can get your
  110.         "bars", you can browse the database in its entirity, making
  111.         group changes as you see fit and everything is saved in dBase 3
  112.         file format so that you can use external programs (such as
  113.         dBase, Alpha4, dBXL, label makers, etc.), to do what ever you want
  114.         with the data.
  115.  
  116.  
  117.         Installing 10-X
  118.         ---------------
  119.  
  120.         It is recommended that you put 10-X on a hard drive system so that
  121.         is has plenty of room to operate.  Placing it on any system is an
  122.         easy task:
  123.  
  124.                 1>  Make a subdirectory named TENX by typing
  125.                     in MD TENX from the root directory of your
  126.                     hard drive.
  127.  
  128.                 2>  Copy all of the files from the floppy to
  129.                     the subdirectory by doing this:
  130.  
  131.                               A:
  132.                               COPY *.* C:\TENX
  133.                     (or whatever subdirectory you are using )
  134.  
  135.  
  136.                 3>  Go to the TENX subdirectory and run the CUSTOM
  137.                     program.  This will personalize 10-X for your
  138.                     system.  MAKE SURE THAT YOU RUN THIS, OTHERWISE
  139.                     10-X WILL NOT RUN PROPERLY.  To run it, just type:
  140.  
  141.                                     CUSTOM
  142.  
  143.  
  144.                 4>  Now you can run the program as you desire, either as
  145.                     a TSR or stand-alone.  See below for details.
  146.  
  147.         IMPORTANT:  If you change subdirectories for 10-X, you must
  148.         run the customizer again.  If you don't, you will get all sorts
  149.         of error messages.
  150.  
  151.  
  152.         In order to run 10-X as a TSR, it is HIGHLY recommended that you
  153.         have 640k RAM and a hard drive.  10-X installs itself and remains
  154.         resident by only taking up 6k RAM when it is not running, but for
  155.         good measure, it is recommended that you have 640k RAM so that
  156.         your other applications can run comfortably.
  157.  
  158.         WARNING:  DO NOT TRY TO INSTALL 10-X AS A TSR RUNNING UNDER
  159.         MICROSOFT WINDOWS.  YOUR SYSTEM WILL ALMOST DEFINITELY CRASH.
  160.         (to run under Windows, see below) ALSO, DO NOT RUN 10-X AS A
  161.         TSR WHILE RUNNING A COMMUNICATIONS PROGRAM. YOU ARE BOUND TO LOSE
  162.         INFORMATION GOING TO THE COMM PROGRAM.  THE SAME GOES FOR
  163.         INSTALLING AS A TSR AHEAD OF DESQVIEW OR DOUBLEDOS.  RIG CONTROL
  164.         PROGRAMS ALSO FALL UNDER THIS CATAGORY.
  165.  
  166.  
  167.  
  168.         In order to install 10-X as a TSR, just type:
  169.  
  170.         TENX (return)
  171.  
  172.         You will be told whether or not is has been successful.  If
  173.         it has been, you can pop up 10-X anytime by hitting the ALT-TAB
  174.         key combination (hold them down both at the same time). ( If you
  175.         are running 512k RAM or less, you might experience a system lock-up
  176.         or crash when you try to load another program. )  Now you are
  177.         ready to load most any other program that you choose.  Be careful,
  178.         TSR's are funny creatures and some not-so-well-behaved programs
  179.         will stop things, although it is rare if you have plenty of
  180.         memory.
  181.  
  182.         As mentioned earlier, when 10-X is installed, it takes up only 6k
  183.         RAM when it is not active.  It swaps out the rest of the program
  184.         to EMS (if available) of disk.  You must make sure that you have
  185.         plenty of free disk space available (around 500k) when using
  186.         10-X (actually, that figure is a bit high, but just in case...)
  187.  
  188.  
  189.  
  190.         In order to run 10-X without running it as a TSR, type:
  191.  
  192.         TENX NOTSR (return)
  193.  
  194.         This will load up 10-X and let you do whatever you want.  If you
  195.         want to run 10-X under Windows 3.0, this is the way to do it.
  196.         Just let it run in its own window as a DOS program, BUT NOT AS A TSR.
  197.  
  198.  
  199.  
  200.  
  201.         Using 10-X
  202.         ----------
  203.  
  204.         Using 10-X is very simple and straigtforward.  If you are used to
  205.         ham radio logging programs, then you can easily use 10-X.
  206.  
  207.  
  208.  
  209.                 Enter #  -  This menu selection allows you to enter
  210.                             the information on a new 10-10 contact.
  211.                             You can enter the date, time, frequency,
  212.                             callsign, mode, number name and QTH, as
  213.                             well as entering notes into the memo
  214.                             editor.  In order to enter notes, place
  215.                             the cursor into the INFO field (where it
  216.                             says MEMO), and hit CTRL-HOME.  An editor
  217.                             will pop up and you can enter most anything
  218.                             you desire about this particular station.
  219.  
  220.  
  221.              Find Number  - You can look for ANY number that you have
  222.                             worked, as long as it has been entered
  223.                             into 10-X.  Choose this selection and a
  224.                             dialogbox will pop up asking you for the
  225.                             number you wish to look up.  Enter it and
  226.                             10-X searches the entire database.  If it
  227.                             is found, it will be displayed and you will
  228.                             be able to modify it, if you wish.  If you
  229.                             do not wish to modify it, just press ESC
  230.                             or PAGE-DOWN when you are finished viewing
  231.                             it.  If you do wish to modify, just move the
  232.                             cursor to the field(s) that you want to
  233.                             change, make your changes and press PAGE-DOWN
  234.                             or press RETURN until the cursor moves out of
  235.                             the bottom of the window.
  236.  
  237.  
  238.                 Find Call - You can look for any call that you may have
  239.                             worked.  Make this selection and enter the
  240.                             callsign in question.  From here on, 10-X
  241.                             behaves like the FIND NUMBER selection above.
  242.  
  243.  
  244.                      Pack - Pack lets you permanently remove any entries
  245.                             that you have marked DELETED from the Browse
  246.                             selection.  Be careful, this totally removes
  247.                             the information that you have marked for
  248.                             deletion.
  249.  
  250.                    Submit - Submit lets you prepare a submission of new
  251.                             numbers worked since your last submission.
  252.                             When chosen, you are prompted for your callsign.
  253.                             After that, 10-X asks you if you want to mark
  254.                             each record that has not been submitted as such.
  255.                             In other words, if this is your "official"
  256.                             submission list, it wants to know if you want
  257.                             to change the database to reflect that the
  258.                             new entries have now been submitted.  Make sure
  259.                             your printer is on, and that it has plenty of
  260.                             paper for your needs and go.  10-X will prepare
  261.                             a submission list for you of just those entries
  262.                             that are marked "not yet submitted".
  263.  
  264.                     Print - Print lets you make a printout of EVERY Ten Ten
  265.                             number you have worked, regardless of submission
  266.                             status.  It prints the numbers in order (not
  267.                             callsign order).  Make sure that you have plenty
  268.                             of paper on hand.
  269.  
  270.                    Browse - 10-X's Browse feature lets you look at the entire
  271.                             database in a "spreadsheet" format.  Each entry
  272.                             is on a line all of it's own, and you can modify,
  273.                             delete and edit any information that you see fit.
  274.                             You can even pack the database from Browse.
  275.  
  276.                      Exit - Exit means just what it says.  Lets leave the
  277.                             program.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.         TroubleShooting
  285.         ---------------
  286.  
  287.  
  288.         Here are a few common problems that arise from using 10-X.  Hopefully
  289.         it will save you a little time and effort by looking at this first.
  290.  
  291.  
  292.         Q>  When I load 10-X, I get a record count mismatch or corrupted
  293.             index file error, and the program stops.
  294.  
  295.         A>  Delete the index files and let the program rebuild them.
  296.  
  297.  
  298.         Why>  You run into this when you shut down your PC without exiting
  299.               10-X properly (i.e. 10-X is active, or running, with the
  300.               menu displayed).  Always shut down the program properly before
  301.               turning off the computer.  If you do, in fact, need to rebuild
  302.               the index files, just delete them by typing DEL *.IND from
  303.               the 10-X subdirectory. If you have a lot of contacts in 10-X,
  304.               then it may take a minute or two for the program to rebuild
  305.               the index.
  306.  
  307.  
  308.  
  309.         Q>  My Packet program won't work right when 10-X is installed as
  310.             a TSR.
  311.  
  312.         A>  Don't run 10-X as a TSR when you run a communications program.
  313.  
  314.         Why>  TSR's are activity stealers.  When you activate a TSR, it
  315.               takes over the PC, and puts everything else on hold.  This
  316.               means that any information coming over the serial port will
  317.               be lost.  If you need to run a comm program and 10-X
  318.               simultaneously, I recommend that you purchase a multitasker,
  319.               such as DESQView, DoubleDOS, VM/386 or Windows and run
  320.               10-X as a non-TSR, in a window of it's own.
  321.  
  322.  
  323.  
  324.         Q>  My system seems to lock up when running some programs and
  325.             10-X as a TSR.
  326.  
  327.         A>  Some programs hate TSR's and won't let them work right.
  328.  
  329.         Why>  TSR's are handy creatures that aren't supposed to really
  330.               exist (don't ask me, ask Microsoft).  Some programs swamp
  331.               every bit of memory that they can get their hands on,
  332.               and won't cooperate with anything else at all.  Some DOS
  333.               extenders behave like that too.  Consult the other program's
  334.               manual and their support services and see if others have
  335.               had the same problem.  Chances are, if you're having it,
  336.               so are other folks.
  337.  
  338.  
  339.         Q>  I have loaded up 10-X as a TSR, but when I try to Hotkey it
  340.             in, it does nothing?
  341.  
  342.         A>  10-X cannot find it's swap file(s)
  343.  
  344.         Why>  In order for 10-X to work properly as a TSR that only takes
  345.               up 6k RAM when it is inactive, it must "swap" out the program
  346.               to disk or EMS.  If there is no available EMS (not to be
  347.               confused with extended memory), it swaps out to disk.  If 10-X
  348.               cannot find the swap file, then it cannot load up.  Make sure
  349.               that you run the CUSTOM program mentioned in the beginning.
  350.  
  351.  
  352.  
  353.         Q>  I cannot get 10-X to work right with a floppy disk.
  354.  
  355.         A>  10-X needs to be installed on a disk WITH its swap files.
  356.  
  357.         Why>  See above explanation.  Make sure that the program that
  358.               you are going to use has the 10-X program on it also.  It
  359.               might be very difficult to do that with a standard 360k
  360.               floppy (at least as a TSR - it should work fine in non-TSR
  361.               mode), but you should be a little better off with a 720k
  362.               floppy or better.
  363.  
  364.  
  365.  
  366.  
  367.  
  368.         I'll keep this file updated as need be.
  369.  
  370.  
  371.  
  372.         How to get help
  373.         ---------------
  374.  
  375.         If you need help, you can get it several ways.  The quickest is
  376.         to leave a comment to the sysop on The AirWaves! BBS at
  377.         (205)757-1348.  It is a closed system, but anyone can log on and
  378.         leave messages to the sysop.  The second quickest is to leave
  379.         a message for me on GEnie (my mailbox is R.GIST), or you can
  380.         call Renaissance Software & Development technical support at
  381.         (205)757-8388 from 10-3 CST, Monday-Thursday.  We are about
  382.         to change hours and numbers shortly, but you can still find out
  383.         how to get in touch with me or my associates via that number.
  384.         You can also write to us at:
  385.  
  386.  
  387.  
  388.                      Renaissance Software & Development
  389.                      10-X Technical Support
  390.                      Box 819
  391.                      Killen, AL 35645
  392.  
  393.  
  394.  
  395.         We will surely respond to those who are registered users of the
  396.         program, but it might take a while for us to get back to
  397.         unregistered users as we put the registered ones ahead of all
  398.         others.
  399.  
  400.  
  401.  
  402.         Registration
  403.         ------------
  404.  
  405.         Normally, I haven't gotten bent out of shape over registrations,
  406.         but from my lack of registrations for my last shareware ham program
  407.         (MorseMan, which is now MorseMan Plus, and is commercial), I figure
  408.         I now have to insist on it.  If you use 10-X, like it and continue
  409.         to use it, you MUST register it.  Registration is only $20 and
  410.         includes:
  411.  
  412.                    1>  The latest version of 10-X, with bug fixes
  413.                        (if any have cropped up) and shareware
  414.                        notices removed.
  415.  
  416.                    2>  New 10-X utilities that help you to make
  417.                        your 10 meter activities even more fun.
  418.  
  419.                    3>  Technical support
  420.  
  421.                    4>  Notification of updates (and how to get them cheap!)
  422.  
  423.                    5>  A version of the program that has added features
  424.                        that aren't available in the shareware version.
  425.  
  426.                    6>  Piece of mind
  427.  
  428.  
  429.  
  430.  
  431.         Keep in mind that I will continue the upkeep and maintenance on
  432.         this program only as long as I get good response from registrations.
  433.         If I do get a lot of response, you can rest assured that the
  434.         program will be maintained and new features will regularly be
  435.         added.  Amateur radio is in desperate need of new software and this
  436.         is one way of making sure that programmers who write ham software
  437.         keep on writing it, instead of going on to more profitable
  438.         projects (which we have already done).
  439.  
  440.  
  441.         Oh yes, the next version (provided that I get adequate response)
  442.         will have many new features, including TSR unload, so you don't
  443.         have to reboot the machine to get 10-X out, an information "grabber"
  444.         that will pull the information right off the screen of your logbook
  445.         program, keeping you from having to type it in twice, and much more.
  446.         If I get a good response on registrations, I will make that version
  447.         shareware.  If I don't get a good response, it will become a
  448.         commercial program.  Yes, I am even considering a Windows 3.0
  449.         and Macintosh version of 10-X - anyone interested???
  450.  
  451.  
  452.         How to register
  453.         ---------------
  454.  
  455.  
  456.                 You can register two ways:
  457.  
  458.                 1>  Send a check (or money order) for $20/US (drawn on
  459.                     a US Bank), or include your Visa/MC number and send
  460.                     to:
  461.  
  462.                         Renaissance Software & Development
  463.                         Killen Plaza
  464.                         Box 640
  465.                         Killen, AL 35645
  466.  
  467.  
  468.                     Make sure that you include your name, callsign
  469.                     and address, as well as disk size that you desire.
  470.  
  471.  
  472.  
  473.  
  474.                 2>  Order by phone and use your Visa or Mastercard.  Call
  475.                     toll free, 1-800-525-7235 or 205-757-5928  (Please
  476.                     no technical questions on the order lines) and order
  477.                     "10-X, Registered Version".  There is no surcharge
  478.                     for credit cards, and domestic first class shipping is
  479.                     included (overseas, please add $3 for Air Mail)
  480.  
  481.  
  482.         All registrations will be sent out in short order, but if we are
  483.         about to release a new version, we may hold it for 3-4 days in order
  484.         to give you the latest update.
  485.  
  486.  
  487.  
  488.  
  489.         One Final Note
  490.         --------------
  491.  
  492.  
  493.         Of course, new software is hardly ever perfect.  The programmer
  494.         gets caught up in what he is doing and forgets a few keen features
  495.         that any yo-yo would have known to put in.  A bug or two might slip
  496.         through the cracks, no matter how much we beta test.  If you are
  497.         using 10-X, and find a bug, or you know a feature that you would
  498.         like added, by all means, let us know.  We will be more than
  499.         happy to consider it.
  500.  
  501.  
  502.  
  503.         About 10-X
  504.         ----------
  505.  
  506.         10-X was written in Turbo Pascal 6.0 (copyright Borland International),
  507.         using Topaz 3.0 (by Software Science, Inc.) and Object Professional
  508.         1.1 (by Turbo Power).  The system was developed on a 80386SX-16
  509.         system using the Digital Research DOS 5.0.
  510.  
  511.  
  512.  
  513.  
  514.         About the author of 10-X
  515.         ------------------------
  516.  
  517.         10-X was written by Robin A. Gist, NE4L/ZF2PM, the president
  518.         and founder of Renaissance Software & Development in Killen, Alabama.
  519.         Robin graduated from Auburn University in 1988 with BA's in
  520.         Industrial Psychology and Economics and is presently earning a
  521.         Master of Science in Management from the University of Alabama in
  522.         Huntsville.  Robin was licensed in 1977 at the age of 13 and
  523.         passed the Extra in 1980, when he got his present callsign.
  524.         Robin is also the author of MorseMan Plus, the highly successful
  525.         Morse Code training program that more than 2000 people have used
  526.         to help them get their tickets or upgrades.  Robin is also a
  527.         member of the Huntsville Lacrosse Team, where he is a starting
  528.         crease attackman and was 1991 Attackman of the Year.
  529.  
  530.         Oh yes, Robin is also a Ten-Ten member (31224), and has put on
  531.         such places as The Bahamas (C6A) in '86, St. Pierre (FP) in '87
  532.         and Grand Cayman (ZF) in '90 on the air.  He works mostly CW
  533.         (about 95% of the time).
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.