home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / packet / pak_09 / amsoft.iii next >
Text File  |  1997-02-01  |  17KB  |  316 lines
  1.                                HAMCOM
  2.  
  3.                         Author: Dan Diehlman AE6G
  4.                                 5478 N. Bond
  5.                                 Fresno, CA 93710    209-439-5520
  6.  
  7. Note: The author of this program has expended considerable time and energy
  8.       in writing, testing and debugging of this program. Each copy is
  9.       customized for one call sign. If you would like to buy a registered copy,
  10.       contact me at the above address. You will then receive also any
  11.       corrections/updates.
  12.       It has, I believe, a couple of unique features, one being the QSO
  13.       card file which enables you to do away with any card file and gives
  14.       practically instantaneous response on Call Sign searches. The other
  15.       feature is the low RFI(noise) generated. This is very noticeable on
  16.       HF. During inactivity, the processor chip is put into a full halt
  17.       condition, thus eliminating birdies caused by instruction loops.
  18.       This was made possible by the fact that the program is completely
  19.       interrupt driven, therefore it can be put to sleep, then awakened by
  20.       a keystroke or communications activity. This was written to take
  21.       advantage of a PK232 -IBM/clone configuration, with 256K or more.
  22.       Although it can be used with other TNC's, it's full capabilities will
  23.       not be realized.
  24.  
  25.                   RUNNING THE PROGRAM
  26.  
  27. There are two files initially, this file "Ham.doc" and the program itself
  28. "Hamcom".  The program will create other files, and keep them updated as
  29. necessary. It uses the default diskette.
  30.  
  31. To run the program, copy the two files "Ham.doc" and "Hamcom.exe" onto a
  32. diskette which already has Dos on it.
  33. Then type "Hamcom"
  34.      The first time you run the program, it will ask for information necessary
  35. for customization as follows:
  36.           prompt                       reply
  37.  What is your validation number?  Insert your val number
  38.  What type TNC are you using?     Appropiate number.
  39.  What is your Call?               Your call
  40.  What is your Selcall?            Your Selcall (if you have not determined your
  41.                                                selcall, see 232 ref manual.)
  42.  Is this a PCJR? y/n             y or n
  43.  Which Comport 1 or 2 ?          1 or 2
  44.  Select type of Display Adapter  1-4
  45.  Are you using a Color Display?  y or n       n for monochrome monitors
  46.                                               y for any color monitors
  47.  Enter your CTEXT.Use > for CR   Your connect message. If you wish to imbed any
  48.                                           Carriage Returns, use the ">" symbol.
  49.  Enter your BTEXT.Use > for CR   Your beacon text.
  50.  Which Drive for default         Enter A,B,C or whatever drive you wish to be
  51.                                  the default drive for logging, receiving, and
  52.                                  sending files. It can be overridden in any
  53.                                  event when specifying a file i.e. B:xxx.xxx
  54.  Baud rate between TNC and computer.  Select any of the listed speeds. 1200 is
  55.                                  best. (You should use 1200 baud with the PK232)
  56.  Customized Packet Ending        This allows you to enter a special characters
  57.                                  which will be appended to your packets when
  58.                                  you release it with the "]" key. I set mine for
  59.                                  "==>" but set it for BK or whatever you like.
  60.  
  61. Special Parms:                   Opportunity to set additional/different
  62.                                  parameters. Separate them with a slash.
  63.                                  such as:    monitor on/txd 50
  64.  
  65. Do you have a 440-940 connected. Discussed later.
  66.  
  67. Is your primary output a Voice Synthesizer Y/N? Normally select "N". If "Y"
  68.                                  is selected then the screen is written thru
  69.                                  BIOS calls so that voice synthesizers can
  70.                                  intercept. Also assists the synthesizers in
  71.                                  pronouncing words instead of spelling the
  72.                                  words.
  73.  
  74. On subsequent runs of the program, you will not have to enter this information.
  75. It will be preserved in a file.  If, in the future, you desire to change these
  76. parameters, select "Alt A" from the main screen.
  77.  
  78. The program will then proceed and stop on the main display, with the heading
  79. "The following data was stored in the TNC". Below it will be listed any
  80. connects you received, while your computer was off.
  81. This data ends with the message "1: Proceed with TNC reset" and "2:Proceed
  82. without TNC reset". The first time you run the program, use "1". This will
  83. set certain parms in the TNC. On subsequent runs, if the TNC has not been
  84. powered off, you can use "2".
  85.  
  86. After you depress a key the program will load it's other files , ending up
  87. back on the Main Screen.
  88.  
  89. The Main Screen displays any text from the TNC above the horizontal line, and
  90. any text that you type is displayed below the line. If you would like to
  91. change the line position, use the "Alt D" to raise or lower the divider.
  92. The lower left hand corner displays the current Mode of the TNC.
  93. The lower right of the screen displays the status of whether you are also
  94. logging to diskette, the data received from the TNC. At the far right on the
  95. bottom of the screen, a number (0-99) will appear on some TNC's. This number is
  96. an indication of how many connects you have had. It is reset to 0 by going to
  97. the Scroll Back Buffer.
  98. Also on the bottom line you can display Help in any mode by depress "Alt H". It
  99. can be turned off in the same manner.
  100.  
  101.  
  102. The Main Screen has the feature of being able to scroll back thru the received
  103. text. To use this feature: use the "Page Up" key to scroll back further. If
  104. you reach the top of the buffer, a message at the top of the screen will say
  105. "Top of Buffer:". You can at any point, scroll back down through the buffer
  106. using the "Page Down" key, or the "Home" key to get to the top of the buffer,
  107. or you can return to the Main Screen by depressing the "Esc". At any
  108. time, while in the Scroll Back Buffer, you can depress "Alt M" for a menu.
  109. While in the Scroll Back Buffer, you can "Mark" the beginning and "End" of
  110. a block of text, and then either "Send" the block or "Write" it to a file, or
  111. "Print" it. You may also load any Text File into the buffer. You can also
  112. edit the text in this buffer. You may also "Search" for particular words.
  113.  
  114.  
  115. Notepad: You can reach the Notepad screen from the Main Screen by depressing
  116. "Alt N". This screen is useful for any notes. I use it for recording tuner
  117. settings etc. The only keys in effect on this screen are the regular alpha/
  118. numeric keys and the Cursor positioning keys. Anything written onto this
  119. screen will be preserved in a file and read back in automatically whenever
  120. you rerun the program. You may exit this screen with the "ESC" key.
  121.  
  122. Menu: You can recall the Menu screen from the Main Screen by depressing "Alt M"
  123. On this screen are listed all the functions available from the Main Screen.
  124. F11 through F20 are invoked by using the regular function keys along with
  125. the Shift Key. i.e. F12 is called by using "Shift F2". Similarly F21 is called
  126. by using the Ctrl Key along with F1, additionally F31 is called by using the
  127. Alt key long with F1.
  128.  
  129. F1-F30: This is the User Macro function
  130.         Depressing F1 to F30 will execute Macros 1 to 30.
  131.         Initially all the macros will be empty. To create a macro depress
  132.         "Alt F". This will take you to a screen which displays the macros,
  133.         and gives you the opportunity to enter any macro. The screen is
  134.         self explanatory.
  135.     examples: "c w1aw>"  will initiate a connect to w1aw.
  136.               "m 4> mfrom yes all> mto yes all>" will set monitor to 4 etc.
  137.  
  138. F31: This will pull down a window and allow you to select different modes
  139.      on those TNC's that have different modes.
  140.  
  141. F32:Log to Disk. Initially the received data is being logged to "Logdat.1"
  142.     as indicated in the lower right hand part of the Main Screen.
  143.     This key will pull down a small window, allowing you to stop/restart a
  144.     new log, or to display the previous log, or to view any ASCII file.
  145.  
  146. F33: This will set the Date and Time in the TNC from the Dos clock.
  147.  
  148. F34: Allows you to Create/Send a Brag tape, the size is limited only by
  149.      Available disk space.
  150.  
  151. F35:File Transfer. This will send/receive any Ascii or Binary file. using
  152.     Hamcom's own protocol or Yapp protocol.
  153.     You will be prompted for the name of the file to send. A "File Xfer in
  154.     progress" message will be posted and at the completion a "File Xfer
  155.     Complete" message will be posted when all the data has been sent from
  156.     the computer to the TNC. Note: There may be remaining packets yet to be
  157.     sent and acknowledged in the TNC before the xfer is fully complete.
  158.     NOTE: To do Binary Transfers, you must have a Computer to TNC cable
  159.           that has pins 1-8 and 20. You cannot have just (TD,RD and ground).
  160.             (N O T E   T H I S   I S   V E R Y    I M P O R T A N T)
  161.  
  162. F37:CW Output. Causes your computer to output received text in CW. You can
  163.     vary the speed up or down.  This feature is for the DieHard CW man who
  164.     would rather copy CW even while working packet or rtty.
  165.  
  166. F39:Tone. This key toggles a tone on/off to help the visually impaired to
  167.     tune in data modes on hf. It sounds a 2100 hz note in all modes except
  168.     for Morse, in which mode, it sounds a 800 hz note.
  169.  
  170. F40:This will cause the received data to also go to the printer. Successive
  171.     depressions of this key toggles the feature On/Off.
  172.  
  173. Alt B:Sound. This pulls down a menu which gives you control over the bell etc.
  174.     The soft bell can be selected or the regular bell, which is the default.
  175.     The soft bell is rather nice when you are in the room, and don't require
  176.     the harshness of the loud regular bell.
  177.  
  178. Alt X:End Program. Always use this to exit the Program. It will insure that all
  179.     necessary files are updated, and that the tnc is put in the proper state
  180.     to receive connect messages, and also set monitoring to 0.
  181.  
  182. Alt M: Menu.  Takes you to the Menu Screen from the Main Screen.
  183.  
  184. Alt N: Notepad. Takes you to the Notepad Screen, already discussed
  185.  
  186. Home: Clears the Main Screen.
  187.  
  188. Del: When using a PK232, this clears the transmit buffer in all modes.
  189.  
  190. Alt F: Setup Macros....previously discussed
  191.  
  192. Alt C: Sends CQ-automtically adjusts to whatever mode is in effect.
  193.  
  194. Alt H: Toggles On/Off a summary of commands at the bottom of the Main Screen.
  195.  
  196. Alt K: This clears the Scroll Back Buffer.
  197.  
  198.         The program is set up so that the Esc key duplicates the Ctrl C
  199.         function, thus lessening the number of keystrokes necessary therefore
  200.         whenever you want to enter a Ctrl C, just hit the ESC key.
  201.         The Tab key is set up in packet to do Channel Switching more easily.
  202.         For instance, if you are in converse mode, in packet, and you wish to
  203.         switch to another channel, instead of typing Ctrl C,Chs X, K simply
  204.         type "Tab" and the number of the channel you are going to. It will
  205.         switch you to that channel and return you to converse mode.
  206.  
  207.         The program is set up so that the "Enter Key" does send the packet.
  208.         Or you may use the "right bracket" key to send the packet with your
  209.         customized ending. (substitute for BK or K or whatever).
  210.  
  211. Alt S:  Shows the current state of all packet streams.
  212.         Incidentally, when in a multiple connection situation, any change in
  213.         the received data stream, will automatically insert a solid line
  214.         accross the screen to alert you to the change.
  215. Alt Z:  Allows you to create messages for individual callers. Allows
  216.         personalized connect messages.
  217. Ctrl D: If in packet, sends a disconnect.
  218.  
  219. Baudot: self explanatory
  220. Ascii:  self explanatory
  221. Morse:  self explanatory
  222. Amtor:  normal operation except for turnaround, type only the "+". It is not
  223.         necessary to type the "?" also.
  224.         The "Tab" key has been setup to force Turnaround. It is the equivalent
  225.         of going to control mode, typing ACHG, enter, k, enter. Again, we are
  226.         trying to save unnecessary keystrokes.
  227. FAX:    selects Fax mode, and turns Prcon On.
  228.  
  229. Alt L      This is a very usefull feature in that it is not necessary to
  230.            maintain a card file on your contacts. You can quickly go from
  231.            the Main Screen to search on Calls, and return, knowing the
  232.            calling party's name,qth, etc.
  233.            To implement this feature, type "Alt L".
  234.            You will be given several choices, however, until you have
  235.            created a database using the "Create" option, none of the other
  236.            functions will actually do anything. So intially choose.
  237.            "Scratch and Create DATABASE". It will then ask you to type the
  238.            word "CONFIRM" (must be in upper case), to proceed. The reason
  239.            for this added entry, is to prevent any accidental erasure. I
  240.            have a 128K file, and would hate to lose mine accidentally.
  241.            Enter a couple calls and the other requested information and then
  242.            do some searches to become familiar with this feature. A search
  243.            on a call is almost instantaneous with 1500 entries in the file.
  244.            Searches on QTH's, Activity(dates), takes longer as it must
  245.            sequentially go through the file to search for matches.
  246.            An "*" asterisk, limits the field searches, such as searching on
  247.            QTH thusly "TO*" will list all contacts with Tokyo and Toledo  and
  248.            Toocumcari if Toocumcari were spelled that way.
  249.            An Activity search such as "12/*/86" will list all qso's in Dec of
  250.            86. etc.
  251.            A Call Search such as "W3*" will list all qso's with W3's.
  252.  
  253. Alt P:     DOS SHELL. This feature allows you to temporarily leave the
  254.            program and go to DOS and run whatever you like. Whenever you
  255.            are finished, and have the Dos prompt, type "EXIT" and you will
  256.            return right back into the ham.com program, as though you had never
  257.            left. During your absence, the TNC will store any incoming messages
  258.            and give them to you on your return.
  259.  
  260. Alt T:     This is only active if you have stipulated in the configuration
  261.            the presence of a Kenwood 440 or 940 and the Kenwood inteface.
  262.            Selecting this function, will take you to a screen which
  263.            has a simulated transceiver dial, displaying the frequency, offset
  264.            modes, etc. The options are listed at the bottom of the screen.
  265.            To return to the Main Screen, depress Escape. If you are using a
  266.            440 you can build several databases using F14, and select any of
  267.            them to be loaded into the 440 memories.
  268.  
  269.            Naturally, it would be wise to backup your files occassionally.
  270.  
  271. If you have "snow" on the screen, redo the Hamparms and answer "Y" to the
  272.      question "Is your Primary Output a Voice Synthesizer".
  273.  
  274. If for some reason you need to include an ESC character ($1B or dec 27),
  275. the reverse apostrophe will send that character.
  276. You can store the other fellow's call by typing a tilda "~", and you can
  277. recall it by typing the left brace"{". This is handy for modes other than
  278. packet where you must identify periodically. The right brace "}" will recall
  279. your callsign.
  280.  
  281. If you are transferring a physical card file into the program's card file,
  282. it is best not to enter them in a sorted order, but rather in a harem/scarem
  283. order. Because of the search algorithm, search times will be reduced.
  284.  
  285. When using a PK232 in Morse, Baudot, Ascii modes, you can type ahead the
  286. text you want to send, even while receiving, and when you actually want
  287. transmission to begin, enter a "ctrl X".
  288.  
  289. Additionally, when using a PK232, you are far better off to remove the
  290. batteries. Sometimes the PK232 can get into a state wherefrom it is hard
  291. to exit as long as the batteries are inserted.
  292.  
  293. There are 2 parameters that can be used when calling the program.
  294. If you call the program thusly "Hamcom/1", it will load,restart then tnc,
  295. and continue without intervention.
  296. If you call the program thusly "Hamcom/2", it will load, and continue
  297. without manual intervention.
  298. You may also eliminate the beginning audible cw greeting by using the "/q"
  299. parameter.
  300.  
  301.                 I would appreciate any criticism . Thank You
  302.                 Hope you enjoy using the program.
  303.  
  304.  
  305.  
  306.    ***** NOTE: PLEASE DO NOT USE WRITE PROTECT TAB ON YOUR WORKING DISK
  307.                HAMCOM NEEDS TO WRITE SEVERAL FILES TO THIS DISK
  308.  
  309.                -------------------------------------------------
  310.                              Dan Diehlman AE6G
  311.                              5478 N. Bond
  312.                              Fresno, CA 93710
  313.                              209-439-5520
  314.                        5478 N. Bond
  315.                              Fresno, CA 93710
  316.