home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / windows / win_40 / prog / c_read.me_ / c_read.me
Text File  |  1997-02-01  |  43KB  |  815 lines
  1. ++++++++++++++++++++++++++++
  2. ClusterMaster v 4.10 by I0JX
  3. ++++++++++++++++++++++++++++
  4.  
  5. 1. GENERAL
  6.    =======
  7.  
  8. PAY ATTENTION:
  9.  
  10. *** FOR WHAT CONCERNS THE PROGRAM COMPATIBILITY WITH DIFFERENT TNCS SEE FILE
  11.     C_EXPLA_TXT.
  12. *** IT IS ABSOLUTELY NECESSARY THAT THE TNC PARAMETERS BE SET AS INDICATED AT
  13.     PAR. 9.1.
  14.  
  15. ----------------
  16.  
  17. ClusterMaster is a Windows 3.1 program, intended to support PacketCluster
  18. ver. 5 (registered mark of Pavillion Software) operations, with a TNC2 (or
  19. equivalent) Packet Radio controller.
  20.  
  21. The main characteristics of ClusterMaster are:
  22.  
  23. - pre-programmed buttons allowing you to send commands, without having to
  24.   remember the commands syntax;
  25. - the possibility to automatically set the transceiver on the frequency of
  26.   the DX station being announced. To be able to achieve this, it is necessary
  27.   to simultaneously run either:
  28.   * RigMaster, a full-featured program intended to control the new-generation
  29.     Kenwood transceivers (ver. 5.00 or higher is required);
  30.   * RigMate, a simple program intended to control ICOM transceivers
  31.   * ICOMtrol, an ICOM control program developed by IK0AOC.
  32.   Which program is booted first is irrelevant. These programs "dialogue" with
  33.   ClusterMaster through the Windows DDE (Dynamic Data Exchange) function.
  34. - the immediate identification of the DXCC country corresponding to any
  35.   displayed prefix, and provision of relevant information including the bands
  36.   and modes in which the country has been worked and/or confirmed and the 
  37.   relevant call-signs. Additionally, it is possible to visualize and print the
  38.   address of the station, utilizing the Buckmaster HamCall CD-ROM (April 1995
  39.   release, or later);
  40. - voice announcement of incoming DX alerts (call-sign and frequency band),
  41.   messages and announcements, with an identification of unconfirmed countries.
  42.   Please be advised that the voice functions are available even if the program
  43.   runs minimized, thus not taking room on the window desktop;
  44. - the possibility to automatically turn your antenna to the country of the
  45.   DX being announced (you need a special board, see sect.6);
  46. - the possibility to enjoy all program features either if one is connected to
  47.   the PacketCluster ("CONN. MODE"), or if one is disconnected and therefore
  48.   operates by simply monitoring the PacketCluster traffic ("MON. MODE");
  49. - the possibility to anyway monitor the PacketCluster traffic, in a separate
  50.   window, even if one operates in the CONN. MODE.
  51.  
  52. 2. FILES
  53.    =====
  54.  
  55. The following files are part of ClusterMaster 4.10 (after installation):
  56.  
  57. - CLU_I0JX.EXE   the main Windows 3.1 executable file
  58. - PHONETIC.WAV   the voice file
  59. - CLUSTER.AEA    a file containing the parameters appropriate to the AEA TNCs 
  60. - CLUSTER.DSP    a file containing the parameters appropriate to the DSP-2232
  61. - CLUSTER.TN2    a file containing the parameters appropriate to the TNC2
  62. - CLUSTER.TNC    a file containing the parameters which the programs delivers
  63.                  the TNC, either upon user command or, if so desired,
  64.                  automatically on COM port start (initially this file
  65.                  coincides with CLUSTER.TN2, but the user may replace it with
  66.                  the appropriate  file) 
  67. - CLUSTER.EXI    a file which contains the parameters which, if so desired,
  68.                  the program automatically delivers the TNC on COM port
  69.                  closure. This file must be modified with a normal ASCII
  70.                  editor to customize it to your needs (see file C_EXPLA.TXT)
  71. - CLUSTER.CFG    a default configuration file (to be customized)
  72. - C_READ.ME      this file
  73. - C_LEGGI.MI     this file translated into Italian
  74. - KCTWIN.DLL     the antenna tracker management file
  75. - HAMCALL.DLL    the HamCall CD-ROM management file
  76. - PREFIXES.TBL   the prefixes data base
  77. - DXCC.TBL       the DXCC countries data base
  78. - INFO.TBL       user notes
  79. - C_EXPLA.TXT    additional information
  80. - C_SPIEG.TXT    C_EXPLA.TXT translated into Italian
  81. - DXCC.DAT       the file indicating bands and modes in which each country
  82.                  has been worked and/or confirmed
  83. - CALLSIGN.DAT   the file containing the call signs for the various bands/modes
  84.  
  85. 3. DISTRIBUTION
  86.    ============
  87.  
  88. These programs may be freely used, copied and distributed, as long as the
  89. following conditions are met:
  90.  
  91. (1) CLU_I0JX.EXE is distributed in their original, unmodified form;
  92. (2) The C_READ.ME and C_LEGGI.MI files are included with the executable files
  93.     without modifications;
  94. (3) CLU_I0JX.EXE may not be sold or licensed upon a fee. Nor it can be
  95.     bundled with, or transferred as part of, any software package or radio
  96.     equipment which is sold or for which any licensing fee is charged.
  97.  
  98. 4. WARRANTY
  99.    ========
  100.  
  101. ClusterMaster has been tested on 80386/80486 33/66 MHz PCs, having an ET4000
  102. SVGA board and a SoundBlaster Pro sound board. Operation has been verified in
  103. the VGA (640x480) and SVGA (800x600 and 1024x768) modes, with 256 colors in
  104. all cases.
  105.  
  106. ClusterMaster has esclusively been tested on a TNC2 (TAPR) and on an AEA
  107. PK-232, PK-96 and DSP-2232.
  108.  
  109. Print functions has been exclusively tested on an Epson LX-400 printer.
  110.  
  111. Antenna control has been tested with a Kansas City Tracker board and a Star
  112. Track CCR-2 board.
  113.  
  114. ClusterMaster is provided "AS IS" without warranty of any kind, either
  115. expressed or implied that any specific feature will work on any particular
  116. machine or in conjunction with any radio equipment. I cannot commit myself to
  117. support this software in the future.
  118.  
  119. The author as no affiliation with amateur radio equipment manufacturer /
  120. reseller or software developer.
  121.  
  122. 5. DISCLAIMER
  123.    ==========
  124.  
  125. The author accepts no responsibility whatsoever, he not being in particular
  126. liable for any damage or loss resulting from unexpected radio equipment
  127. operation as a consequence of software bugs or wrong design.
  128.  
  129. 6. HARDWARE REQUIREMENTS
  130.    =====================
  131.  
  132. See file C_EXPLA.TXT.
  133.  
  134. 7. SOFTWARE REQUIREMENTS
  135.    =====================
  136.  
  137. See file C_EXPLA.TXT.
  138.  
  139. 8. INSTALLATION
  140.    ============
  141.  
  142. Put your distribution disk in a drive, then Select "Run" in the Windows
  143. Program Manager "File" menu, finally type A:\SETUP.EXE (if A: is the drive
  144. you have chosen).
  145.  
  146. Select ClusterMaster as the program to be installed and follow the
  147. instructions until you will get the ClusterMaster 4.10 icon in the new "I0JX
  148. ham radio" window. At this point, you can start the program by clicking twice
  149. on it.
  150.  
  151. P.S. Every time you re-install the program, the files DXCC.DAT and 
  152. CALLSIGN.DAT are overwritten. Not to lose their content, make first a back-up
  153. copy of these files.
  154.  
  155. 9. OPERATIONS
  156.    ==========
  157.  
  158. 9.1. Foreword
  159.      --------
  160. For proper operation, ClusterMaster requires that certain TNC parameters be
  161. appropriately set. Such settings are contained in file CLUSTER.AEA for the
  162. AEA TNCs, in file CLUSTER.DSP for the DSP-2232 case, and file CLUSTER.TN2 for
  163. the TNC2 case. You shall first copy one of these files as CLUSTER.TNC, i.e.
  164. the file name to which the program makes reference. Remember then to modify
  165. CLUSTER.TNC (by means of a normal ASCII editor), by changing the line "MY
  166. MYCALL" into "MY <your own call>".
  167.  
  168. When desired, the parameters contained in file CLUSTER.TNC can be sent to the
  169. TNC, while the program is running, by means of the "Set TNC" choice in the
  170. "Miscellaneous" menu (as already mentioned it is also possible to download
  171. the file CLUSTER.TNC every time the COM port is open, see par. 9.2.).
  172.  
  173. You can easily distinguish three large windows in the program; from top to
  174. bottom:
  175.  
  176. - a white windows termed main window (MAIN WINDOW);
  177. - a yellow windows termed auxiliary window (AUX WINDOW);
  178. - a blue windows termed transmit window (TX WINDOW).
  179.  
  180. The separation line between the MAIN WINDOW and the AUX WINDOW can be moved
  181. in the Configuration" menu (see par. 9.2.), or by means of the sliding cursor
  182. located at the extreme right hand side of the program window.
  183.  
  184. The MAIN WINDOW is the one upon which certain program functions operate.
  185. (voce announcement, transceiver frequency setting, DXCC country identifi-
  186. cation).
  187.  
  188. The text to be transmitted shall be written into the TX WINDOW, while the
  189. received text will appear either in the MAIN WINDOW or in the AUX WINDOW
  190. according to the following criterion:
  191.  
  192. - when in CONN. MODE, incoming text addressed to yourself will appear in the
  193.   MAIN WINDOW, while the PacketCluster traffic will be monitored in the
  194.   AUX WINDOW;
  195.  
  196. - when in MON. MODE, the PacketCluster traffic will be monitored in the MAIN
  197.   WINDOW, while nothing will appear in the AUX WINDOW.
  198.  
  199. The choice between the CONN. MODE and the MON. MODE is discussed at par. 9.2.
  200.  
  201. 9.2. Program start
  202.      -------------
  203. Switch the TNC on before booting the program, verifying that it is set with
  204. AWLEN 8 e PAR 0.
  205.  
  206. After booting the program, you will be operating on default parameters i.e.
  207. those written in the CLUSTER.CFG file provided with the program. Therefore
  208. you shall firstly proceed to customize the program by means of the
  209. "Configure" menu.
  210.  
  211. When you are still unfamiliar with the program, you are advised to limit
  212. yourself to the following customizations:
  213.  
  214. - "Port": select the desired COM port (COM1 through COM4). The selected port
  215.   is shown in the small blue window
  216. - "Baud": select the serial port baud rate, in the range 1200 through 19200
  217.   baud. The selected baud rate will appear in the small purple window
  218. - "Sysops": enter two PacketCluster callsigns. The active one will always
  219.   be shown in the small brown window
  220. - "Home call": enter your own call (e.g. I0JX)
  221. - "WW locator": enter the locator (6 characters) of your station
  222. - "Voice": specify whether or not you wish that voice announcements be made
  223.   (assuming that you have a sound card).
  224.  
  225. Once you have made all your selections, use "Save configuration" to store the
  226. program configuration on the CLUSTER.CFG file. The next time you will boot
  227. the program, you will note that the selected configuration is now the default
  228. one and you will obviously not be required to configure again the program.
  229. You can modify the configuration at any time and re-save it, if so desired.
  230.  
  231. Once you get accustomed with program operation, you may proceed with the
  232. remaining customizations:
  233.  
  234. - "Antenna track": specify whether or not you wish to use the automatic
  235.   antenna tracking facility (only with an ad-hoc board)
  236. - "Font": select the desired font among those installed
  237. - "Font size": choose the selected font size (size of non-scalable fonts
  238.    cannot be varied)
  239. - "Boldface": choose whether you wish that characters appear in bold
  240. - "Window width": select the percentage of the screen width that you wish the
  241.   program window to occupy. Please note that this percentage can also be
  242.   varied by simply resizing the program window by means of the usual Windows
  243.   techniques
  244. - "Window height": select the percentage of the screen height that you wish
  245.   the program window to occupy. Same note as above
  246. - "Auxiliary window height": select the percentage of the program window
  247.   height occupied by the AUX WINDOW
  248. - "Set TNC on start": select whether or not the file CLUSTER.TNC shall be
  249.   automatically sent to the TNC on COM port start
  250. - "Set TNC on exit": select whether or not the file CLUSTER.EXI, when
  251.    available, shall be automatically sent to the TNC on COM port closure
  252. - "System command 1": enter the name of a "System command", to be selected
  253.   among those implemented by the Sysop (use the "SH/COM" command to
  254.   determine available System commands). Once entered, the System command #1
  255.   name will appear on one of the Menu 2 buttons (see sect. 9.3), thus
  256.   allowing to readily send the command at any time. The default name for
  257.   System command #1 is "IOTA" (this provides access to Island-On-The-Air
  258.   data)
  259. - "System command 2": you can enter another System command among the
  260.   available ones, which will also appear on one of the Menu 2 buttons. The
  261.   default name for System command #2 is "OBLAST" (this provides access to
  262.   Russian Oblast data)
  263. - "Alert profile": on a DX spot arrival, the programs spells the DX callsign
  264.   and pronounces its band. If you do not have confirmed, on that band or on
  265.   the corresponding mode, any of the DXCC countries associated the DX station
  266.   prefix, the announcement will be preceded by a bell alert-sound (the alert
  267.   procedure utilizes information contained in file DXCC.DAT, see sect. 9.6).
  268.   You may not want to be alerted on bands/modes on which you do not normally
  269.   operate. The "Alert profile" option allows you to specify, for each band
  270.   and each mode, whether you want or you do not want to be alerted. The alert
  271.   function is anyway inactive for the 2 and 0.7-meter bands. If you do not
  272.   have a sound board, although the DX call/band will clearly not be
  273.   pronounced, an alert sound consisting of 3 "beeps" will be generated when
  274.   appropriate. 
  275. - "HamCall CD-ROM drive": specify the unit of your CD-ROM drive (e.g. D:) or
  276.   NONE if no CD-ROM drive is available.
  277.  
  278. Note that the "Antenna track" can be set to ON only if you have installed the
  279. tracker driver prior to booting Windows (see sect. 7).
  280.  
  281. Please note that, when saving the configuration, the program window position
  282. on the screen is also stored; therefore it will be convenient for you to
  283. first select your preferred window position (also by means of the normal
  284. Windows techniques) and then save the configuration.
  285.  
  286. As far as "Font" and "Font size" are concerned, choices will have to be taken
  287. such as to meet your personal preferences on the one hand, and, on the other
  288. hand, such that incoming messages (e.g. DX alert messages) do not result to
  289. be split in two lines. You can play with "Font size" and "Window width" until
  290. you get an acceptable appearance (note that the screen resolution 640x480,
  291. 800x600 or 1024x768 plays an important role in this regard). You are advised
  292. to use the "8514oem" or "Fixedsys" fonts.
  293.  
  294. Once the initial configuration phase is completed, the 16 buttons located in
  295. the bottom part of the window should all still be disabled.
  296.  
  297. In the  "Actions" menu choose use "Start COMn" (n = 1, 2, 3 o 4) to open the
  298. serial port. At this point, all buttons and menus will become enabled and the
  299. program will be operational.
  300.  
  301. The program is then automatically put in the MON. MODE (as witnessed by the
  302. the indicator placed at the right hand side of the TX WINDOW), so that the 
  303. incoming PacketCluster traffic will be monitored in the MAIN WINDOW (please
  304. note that, at the moment the program is set in the MON. MODE, two parameters
  305. are delivered to the TNC, namely HEADERLN ON and MFILTER 00, without which
  306. the program may not operate correctly in the MON. MODE).
  307.  
  308. The first time you use the program, you shall call the "Set TNC" selection
  309. in the "Miscellaneous" menu. The program will then deliver the TNC the
  310. parameters contained in file CLUSTER.TNC. Verify that the TNC responds
  311. correctly to these parameters.
  312.  
  313. At this point, by clicking on the "Connect" button, the program immediately
  314. switches into the CONN. MODE and the TNC attempts to connect the 
  315. PacketCluster (also in this case two parameters necessary for the CONN. MODE
  316. are sent to the TNC, namely HEADRLN OFF e MFILTER 13). Own text is received
  317. in the MAIN WINDOW, while the PacketCluster traffic is monitored in the AUX.
  318. WINDOW. Once connected, one may deliver the PacketCluster some text by
  319. typing it into the TX WINDOW, or clicking on the pre-defined buttons (see
  320. par. 9.3.).
  321.  
  322. To disconnect from the PacketCluster, click on the "Discon." button, which
  323. will cause the program to revert into the MON. MODE.
  324.  
  325. For any evenience, rememeber that it is possible to "force" the CONN. MODE or
  326. the MON. MODE at any time, by simply clicking on the relevant option button;
  327. nevertheless in case of inconsistency (for instance if one operates in the
  328. MON. MODE while he is connected to the PacketCluster), the program may mix up
  329. your own text with the monitored text.
  330.  
  331. When monitoring the PacketCluster traffic in the MON. MODE, a DX alert will
  332. appear repeated many times (one for each station currently connected to the
  333. PacketCluster); however this is not a problem as the program will not repeat
  334. the same voice announcement twice.
  335.  
  336. Once you get accustomed to program operation, you may want that, on boot, the
  337. program automatically starts the COMn and tries to connect the PacketCluster
  338. without your intervention. This is possible by firstly selecting the Cluster-
  339. Master icon (click once on it) and then modifying the Command line field in
  340. the "Properties" selection of the "Files" menu of the Windows Program
  341. Manager.
  342.  
  343. Command line syntax:
  344.  
  345. \XXX\CLU_I0JX.EXE      normal mode
  346. \XXX\CLU_I0JX.EXE C    on boot, COMn is open and connection to PacketCluster
  347.                        is attempted. Program window starts minimized (i.e.
  348.                        reduced to an icon), although fully operational
  349. \XXX\CLU_I0JX.EXE E    as above, but the program window starts in normal mode
  350.  
  351. (XXX is the ClusterMaster directory)
  352.  
  353. 9.3. Buttons usage
  354.      -------------
  355. The button  marked "Mute" located near the middle of the screen can be used
  356. to stop voice announcements at any time (clicking it is equivalent to
  357. setting "Voice" to OFF in the "Configure" menu). Pressing "Speak" re-enables
  358. voice announcements.
  359.  
  360. When sending text to the TNC (by means of the "File manager" or of the 
  361. "Set TNC" or the "Reset TNC 8-N-1" buttons, see sect. 9.4.), the same button
  362. gets labelled "Stop". Pressing it halts text trasmission.
  363.  
  364. To simplify sending commands, 16 buttons with pre-defined messages were made
  365. available. Please note that the button in the lower right corner allows to
  366. change the meaning of all the other buttons, by passing to the Menu 2, from
  367. which it is possible to go back to Menu 1 by pressing again the same button.
  368. The total number of available functions is then 30. The buttons usage is
  369. explained in the following.
  370.  
  371. - Menu 1 -
  372.  
  373. "Connect":      sends the connect message to the PacketCluster
  374. "Discon.":      sends the disconnect message to the PacketCluster
  375. "Command":      sends a CTRL-C, thus putting the TNC in Command Mode
  376. "Converse":     sends the command which puts the TNC (while in Command mode)
  377.                 in Converse mode
  378. "Message end":  sends the sequence CTRL-Z <CR> which the PacketCluster
  379.                 interprets as an end-of-message indicator
  380. "Cancel":       sends the sequence CTRL-Y <CR> which instructs the
  381.                 PacketCluster not to store a message or file just sent. This
  382.                 command can also be used to halt the download of message or
  383.                 a file
  384. "Mail":         requests the existing messages directory
  385. "Own mail":     requests the list of messages addressed to your own callsign
  386. "Bull. mail":   requests the directory of messages addressed to ALL (i.e. the
  387.                 bullettins)
  388. "Delete mail":  requests a message to be cancelled. You shall be prompted to
  389.                 specify the number of the message to be cancelled
  390. "Send mail":    requests the authorization to send a message to be stored in
  391.                 the PacketCluster. You will be prompted to specify the
  392.                 callsign of the addressed station. After answering the Packet
  393.                 Cluster request to enter the message subject, you can answer
  394.                 the subsequent PacketCluster request to send the message
  395.                 text either by directly typing it on the keyboard (and
  396.                 terminating it with the button "Message end") or by sending a
  397.                 file by means of the "Send" button in the "File manager"
  398.                 window ("Files" menu). Message is sent with the "private"
  399.                 option (i.e.it can only be read by the addressee)
  400. "Read mail":    requests a message download. You will be prompted to specify
  401.                 the desired file number. If you wish the incoming message to
  402.                 be stored, you can use the "Capture to file" options in the
  403.                 "Files" menu. Similarly, if you wish to directly print the
  404.                 incoming message, use the "Dump to buffer" options in the
  405.                 "Text print" menu
  406. "Talk"          requests to send an immediate message to a user currently
  407.                 connected to the PacketCluster. You will be prompted to
  408.                 specify the station callsign and the text to be transmitted.
  409.                 If at this point you just hit <CR>, instead of a proper
  410.                 message text, you will enter the Talk mode, by which you can
  411.                 have a chat with your correspondent
  412. "Sysop"         selects the active Sysop between the two declared when
  413.                 configuring the program
  414. "DX alert"      sends a DX alert message. You will initially be prompted to
  415.                 enter the DX station callsign. Then you will be asked to
  416.                 enter the DX frequency, unless a rig control program (e.g.
  417.                 RigMaster or RigMate) linked to ClusterMaster via DDE is
  418.                 concurrently running in Windows (see sect. 9.5), in which
  419.                 case frequency is entered automatically. You will finally be
  420.                 prompted to enter your comments (simply type <CR> if you have
  421.                 no comments.
  422.  
  423. - Menu 2 -
  424.  
  425. "Here"          informs the PacketCluster that the operator is present at the
  426.                 station
  427. "Not here"      informs the PacketCluster that the operator is not present at
  428.                 the station (callsign will appear in brackets)
  429.  
  430.  Name of        sends the System command #1 (see sect.9.2). You will be
  431.  System         prompted to specify a datum appropriate to the command
  432.  command #1      
  433.  
  434.  Name of        same as System command #1
  435.  System         
  436.  command #2
  437.  
  438. "Station info"  requests information on a user registered to the Packet
  439.                 Cluster. You will be prompted to specify the station callsign
  440. "Last DX"       requests the last announced DXs. You will be prompted to
  441.                 select the number of calls to be shown and the band
  442. "Users"         requests the callsign of the users currently connected to the
  443.                 Packet Cluster
  444. "Area dir"      requests the names of the available PacketCluster file areas                
  445. "Area: ROOT"    allows to specify the PacketCluster files area for the "Files
  446.                 dir", "Send file" and "Read file" commands. The default files
  447.                 area is "ROOT", i.e. the area at the highest hierarchical
  448.                 level. To know the available file areas,send the command 
  449.                 "SH/FILEAREA"
  450. "Files dir"     requests the directory of the files stored in the specified
  451.                 files area
  452. "Send file"     requests the authorization to send a file. You will be
  453.                 prompted to specify the name eventually used to store the
  454.                 file in the specified files area. After confirmation, you can
  455.                 either directly type the file on the keyboard (terminating
  456.                 with button "Message end") or send a file / write text by
  457.                 means of the "File manager" ("Files" menu)
  458. "Read file"     requests the download of a file contained in the specified
  459.                 file area. Also in this case it is possible to store the
  460.                 incoming file by means of the "Capture to file" options of
  461.                 the "Files" menu or print it by means of the "Dump to buffer"
  462.                 option of the "Text print" menu
  463. "Announce"      requests to send an immediate message to all the local Packet
  464.                 Cluster users currently connected. You will be prompted
  465.                 to write the message text
  466. "Full ann."     as "Announce", but not limited to local users
  467. "QSL info"      requests the QSL Manager of a station. You will be prompted
  468.                 to specify the station callsign
  469.  
  470. 9.4. Menus usage
  471.      -----------
  472. It is described inthe following.
  473.  
  474. Menu "Action":   allows to open the serial port ("Start COMn"), to close it
  475.                  ("Close COMn"), to terminate the program ("Quit"), to close
  476.                  the port and terminate the program ("Close COMn and quit"),
  477.                  to clear the MAIN WINDOW ("Clear main window"), to clear the
  478.                  AUX WINDOW ("Clear auxiliary window") and to clear the TX
  479.                  WINDOW ("Clear transmit window")
  480. Menu "Files"     allows to send a file ("File manager", see note below), to
  481.                  start saving text received in MAIN WINDOW on file ("Capture
  482.                  to file (main window)"), or that received in AUX WINDOW
  483.                  ("Capture to file (auxiliary window)"), or that received in both
  484.                  windows ("Capture to file (both windows)"), or to stop saving
  485.                  ("End capture"). If you forget to terminate the capture, this
  486.                  will automatically occur when you exit the program. The
  487.                  capture file name is shown in the small green window
  488. Menu             allows to print incoming text on your printer. Selecting the
  489. "Text print"     "Dump to buffer (main window)" option, text appearing in the
  490.                  MAIN WINDOW starts getting stored on a print buffer. Text will
  491.                  actually be printed when the "Print buffer" option is then
  492.                  selected. Similarly, text appearing in the AUX WINDOW or in both windows
  493.                  starts getting stored in the print buffer with the "Dump
  494.                  to buffer (auxiliary window)" and "Dump to buffer (both 
  495.                  windows)" option respectively
  496. Menu "DXCC"      allows to display a new window with DXCC country identifica-
  497.                  tion & status and automatic antenna pointing ("Search and
  498.                  point", see sect. 9.6), to visualize and print the DXCC
  499.                  countries worked/confirmed in each band/mode ("DXCC status",
  500.                  see sect 9.7), to update the prefixes data base PREFIXES.TBL
  501.                  ("Update prefix table)" or the DXCC countries data base 
  502.                  DXCC.TBL("Update country table"), and to re-initialize the
  503.                  data bases ("Re-init tables"), which must be done after any 
  504.                  data base updating
  505. Menu             allows to send the TNC ("Set TNC") the CLUSTER.TNC file,
  506. "Miscellaneous"  which sets the desired TNC parameters, to reset the TNC
  507.                  ("Reset TNC (8-N-1)") configuring the serial port at 8 bit,
  508.                  no parity, 1 stop and then sending the CLUSTER.TNC file to
  509.                  the TNC, to test the voice spelling facility ("Voice test"),
  510.                  to visualize the current DDE status, i.e. whether the DDE
  511.                  link to either RigMaster or RigMate has been established
  512.                  ("DDE status") and to takes some notes and possibly store
  513.                  them on the file INFO.TBL ("Take notes").
  514. Menu "Configure" described before (sect.9.2)
  515. Menu "Hints"     allows to visualize this file ("Help (English)") and the
  516.                  Italian version ("Help (Italiano)") or to get information on
  517.                  the program ("About")
  518.  
  519. - Note on the "File Manager" option of the "Files" menu -
  520.  
  521. When this option is activated, a new panel will appear, allowing to
  522. immediately select the directory and the name of the desired file. When you
  523. select a file, its content will be immediately displayed in a dedicated
  524. window (this effectively implements a Browse function), as long as it is a
  525. text file not exceeding 21,000 characters in length. When the "Send" button
  526. is pressed, the text contained in the window is transmitted; please note that
  527. this text can be manually edited just before transmission (select text by
  528. dragging the mouse cursor on text, then use CTRL-C to copy, CTRL-X to cut and
  529. CTRL-V to paste text). The "Clear" button clears the window content. The
  530. "Print" button prints the window content.
  531.  
  532. The File Manager can also be usd as a mini word processor to prepare a text
  533. before transmission.
  534.  
  535. 9.5. Frequency and mode management
  536.      -----------------------------
  537. Transceiver frequency and mode management is obtained through the DDE
  538. built-in Windows feature which allows data exchange between programs
  539. operating concurrently. ClusterMaster automatically transfers frequency and
  540. mode data to / from suitable transceiver control program, i.e. RigMaster
  541. (starting from ver. 5.00) for Kenwood rigs and RigMate (starting from ver.
  542. 1.00) for ICOM rigs.
  543.  
  544. In practice:
  545.  
  546. - when you receive a DX alert (or you receive the list of the last DX alerts,
  547.   see button "Last DX"), you may double click on the frequency indication (in
  548.   the MAIN WINDOW only), and this will cause the transceiver to shift to that
  549.   frequency. This occurs unless DDE is disabled, see the "DDE" menu options
  550.   in RigMaster or RigMate. If you have selected the "Frequency + mode" option
  551.   in the "DDE" menu, the transceiver will also change to the mode appropriate
  552.   to that frequency (e.g. for 14250 it will pass to USB).
  553.  
  554. - if you wish to send a DX alert (see "DX alert" button), you need not typing
  555.   the DX frequency, as ClusterMaster gets, through Rigmaster or RigMate,
  556.   access to the current transceiver frequency (in the case of RigMaster this
  557.   only occurs if the "Auto" feature is set to ON).
  558.  
  559. To achieve the above automatic mode of operation, ClusterMaster and the rig
  560. control program must obviously both to be running (the booting order is
  561. irrelevant).
  562.  
  563. For both RigMaster and RigMate, the strat-up DDE option can be automatically
  564. selected by means of the boot command line (see the RigMaster and RigMate
  565. help files). Please remember that also RigMaster and RigMate can operate
  566. minimized, not to take room on the Windows desktop, while the DDE feature
  567. remains fully operational.
  568.  
  569. 9.6. DXCC data base and antenna pointing
  570.      -----------------------------------
  571. ClusterMaster contains a detailed radioamateur prefix and DXCC country data
  572. base (both current and deletewd ones), thus allowing to immediately recognize
  573. the country corresponding to each prefix, including non-standard prefixes
  574. (provided that they meet the ITU rules). Should a prefix correspond to more
  575. than one country, all applicable countries will be displayed. The data base is
  576. not limited to identify the country, it also providing, where possible, the
  577. "region" where the station is located on the basis of its prefix (i.e. for
  578.  prefix CE3 it will recognize the country Chile and the region Santiago).
  579.  
  580. The data base, constituted by files PREFIXES.TBL and DXCC.TBL, will have to be
  581. updated every time ARRL changes a country status (from current to deleted) or
  582. adds a new country.
  583.  
  584. The prefix and DXCC country data bases are plain ASCII files which can be
  585. updated with an editor (follow CLOSELY the instructions given in the
  586. file C_EXPLA.TXT). You can edit the data base files PREFIXES.TBL and DXCC.TBL
  587. from within the program with the "Update prefix table" and "Update country
  588. table" options of the "DXCC" menu. Once these files are updated, they must
  589. be re-initialized ("Re-init tables" option in the "DXCC" menu).
  590.  
  591. You can gain access to the data base by:
  592.  
  593. - either choosing the "Search and point" option in the "DXCC" menu;
  594. - or double-clicking (only in the MAIN WINDOW) the call-sign of a DX station.
  595.  
  596. In both cases, a new window will appear, allowing to obtain several data
  597. relevant to the prefix or the callsign that you write in the text box marked
  598. "Enter call/prefix" (if you double-clicked a call-sign, this will 
  599. automatically appear in that text box).
  600.  
  601. At any time you can write the desired call-sign or prefix in the text box
  602. marked "Enter call/prefix", and the program will immediately react showing 
  603. the official country prefix and country name.
  604.  
  605. If you check the "deleted" indicator, you will retrieve deleted DXCC
  606. countr(ies) corresponding to the entered prefix. For instance if you enter
  607. AC3 and the deleted indicator is checked, you will get the deleted country
  608. Sikkim and the frame surrounding the country list will become light blue;
  609. otherwise, with the indicator unchecked, you will get U.S.A and the frame
  610. will turn to light brown.
  611.  
  612. Finally, pressing the "Address" button will cause the country list to be
  613. replaced by a panel showing the station address (press "Address" only when
  614. the HamCall CD-ROM is actually in its drive). The address can be printed by
  615. pressing the "Print" button. You may go back to the country list by pressing
  616. the "Country" button.   
  617.  
  618. The following data are provided:
  619.  
  620. Upper panel:
  621. -----------
  622. the normal prefix of the recognized country (possibly followed by an old
  623. prefix) and the country/region name.
  624.  
  625. In case more than one country/region corresponding to the same prefix are
  626. shown, one can obtain data relevant to the desired one by simply clicking
  627. on the country name.
  628.  
  629. Center right panel:
  630. ------------------
  631. - continent where the country is located ("Continent:")
  632. - ITU and CQ zones ("Zone ITU/CQ:")
  633. - time difference with respect to GMT ("Local time    GMT")
  634. - distance in kilometers ("Distance (Km):")
  635. - latitude in degrees ("Latitude (deg):")
  636. - longitude in degrees ("Longitude (deg):")
  637. - WorldWide locator ("WW locator:")
  638. - sunrise time expressed in GMT ("Sunrise (GMT):")
  639. - sunset time expressed in GMT ("Sunset (GMT):")
  640.  
  641. When information is insufficient to determine ITU/CQ zones, the indication
  642. "**" will be displayed.
  643.  
  644. If you know that in the selected country the Daylight Saving Time (DST) is
  645. currently in use, you may press the "time" button, causing this to change
  646. into "DST": at this point the label will read "Local DST   GMT" and the time
  647. difference with respect to GMT will be increased by one hour. Pressing again
  648. the button "DST", this will revert back to default (toggle mode).
  649.  
  650. If the environment variable TZ, which defines the difference between your
  651. local time and GMT, has been declared (see sect. 7), the following 
  652. enhancements will be available:
  653.  
  654. - the selected country time will now be explicitly shown, it no longer
  655.   being expressed as a difference with respect to GMT. The label will now
  656.   read "Local time", or "Local DST" if you have pressed the "time" button
  657.   (see above)
  658.  
  659. - the sunrise and sunset times of the selected country will now be expressed
  660.   in your local time and the labels will simply read "Sunrise:" and 
  661.   "Sunset:".
  662.  
  663. Center left panel (marked "Antenna heading"):
  664. --------------------------------------------
  665. - your antenna heading to the identified DXCC country/region ("Local") in deg
  666. - the reciprocal heading, i.e. the antenna heading of your correspondant
  667.  
  668. If the "long path" indicator is checked, both the "Local" and the
  669. "Reciprocal" heading text boxes will show the diametrically opposite
  670. heading. The changed parameters, including distance which is also
  671. calculated on the long-path route, are identified by a yellow background.
  672.  
  673. If the "Antenna track" option of the "Configure" menu is set to ON the
  674. following facilities become available:
  675.  
  676. - pressing the "Point" button, the antenna is automatically turned to the
  677.   heading shown in the "Local" text box. While the antenna is being rotated,
  678.   the heading is shown in blue; it returns to red when rotation has finished.
  679.   If desired, antenna rotation can be halted by pressing the "Stop" button.
  680. - after a few seconds after the antenna has stopped, the current antenna
  681.   heading (in deg) is shown in the "Current" text box. If so desired (e.g.
  682.   when the antenna has been turned manually), one can update this indication
  683.   by pressing the "Read" button. The indication is anyway updated every time
  684.   the "Search and point" window is activated.
  685.  
  686. Please note that the operator can write data into all text boxes containing
  687. indications in red (i.e. "Local", "Latitude (deg):", "Longitude (deg):" and
  688. "WW locator:"). This allows him to point the antenna to a manually specified
  689. heading or to determine the longitude and latitude corresponding to a given
  690. WW locator, etc. When data contained in such text boxes are changed, all
  691. other indications disappear, them becoming meaningless. Data can be re-
  692. displayed by simply clicking on the country name.
  693.  
  694. Lower panel:
  695. -----------
  696. On this panel it is possible to store whether the selected country has been
  697. confirmed, worked or not yet worked in the various bands and modes (this
  698. information is stored on file DXCC.DAT). It will be sufficient to click one
  699. or more times on the little square located at the immediate left of the
  700. button which shows the the desired band or mode, until one of the two
  701. following conditions is obtained:
  702.  
  703. - the square is checked and the band/mode button is blue: country worked
  704. - the square is checked and the band/mode button is red: country confirmed
  705.  
  706. Initially, the square was unchecked and the band/mode button was black, 
  707. to signify that the country had not been worked.
  708.  
  709. Before any other action, you shall press the "Save" button to store the 
  710. data on file. Please note that, every time you press "Save", all band/mode
  711. data for the selected country are stored, just as currently shown on the
  712. panel.
  713.  
  714. At any time, it shall be possible to update, with the same procedure, the
  715. bands and modes for any DXCC country.
  716.  
  717. Once data have been entered and stored, they will be immediately shown each
  718. time a DXCC country is selected.
  719.  
  720. Please note that file DXCC.DAT stores bands/modes for each proper DXCC
  721. country. This means that different regions of the same DXCC country are
  722. not distinguished (e.g. CE2 and CE3 are both associated to the same
  723. country "Chile"). Data stored on file are also used to decide whether the
  724. bell alert sound has to be generated or not upon arrival of a DX spot with
  725. a prefix corresponding to a DXCC country which is unconfirmed in the 
  726. relevant band/mode (see. sect. 9.2, item "Alert profile").
  727.  
  728. It is also possible to store the callsign (10 characters max.) of the 
  729. station which was worked or is confirmed in the various bands/modes for
  730. the selected country. It will be sufficient to press the button showing
  731. the desired band/mode (as long as it is blue or red), then to write the 
  732. callsign in the window located at the upper right corner of the panel
  733. and finally to press the "Save" button, thus storing the datum on file
  734. CALLSIGN.DAT. As a general rule remember that if, at the moment the
  735. "Save" button is pressed,
  736.  
  737. - the call-sign window is not empty and the small band/mode window (i.e.
  738.   the one located at the immediate left-hand side of the call-sign
  739.   window) shows any band or mode, the datum shown in the call-sign
  740.   window will be stored on file as the call-sign associated to the
  741.   currently shown band/mode;
  742.  
  743. - if both the call-sign window and the band/mode small window are empty,
  744.   the call-sign data base file will not be modified at all;
  745.  
  746. - if the call-sign window is empty and the small band/mode window shows
  747.   any band/mode, a void call-sign will be stored for that band/mode
  748.   (just as if no call-sign was ever entered for that band/mode).
  749.  
  750. At any time it is possible to show, by pressing a band/mode button, the
  751. callsign worked or confirmed in that band/mode for the selected country.
  752.  
  753. You can go back to the normal program window with the "Cancel" button.
  754.  
  755. 9.7 DXCC status
  756.     -----------
  757. By clicking the "DXCC status" option in the "DXCC" menu, you will get to
  758. a panel which shows, alternatively for current, deleted or all countries:
  759.  
  760. - the total number of worked (blue) and confirmed (red) countries for
  761.   each band/mode or in absolute ("Overall");
  762. - the total number of countries contained in the DXCC list ("DXCC"),
  763.   reflecting the content of file DXCC.TBL, independently of whether they
  764.   have been worked and/or confirmed;
  765. - the list of countries confirmed, unconfirmed, worked, not worked or
  766.   waiting QSL (in the bottom right window) relevant to the label which,
  767.   at that moment, has a red background. In case the "DXCC" label is red,
  768.   the full ARRL DXCC list will be shown, with the indication, country by
  769.   country, of the number which designates the country itself in DXCC.TBL.
  770.  
  771. The following actions can be taken:
  772.  
  773. - to choose, by clicking the "Current", the "Deleted" or the "All"
  774.   command, whether program operates on current, deleted or all (current +
  775.   deleted) countries;
  776. - to choose, by clicking the "Confirmed", "Unconfirmed", "Worked", "Not
  777.   worked" or "Waiting QSL" command, if the list will show countries 
  778.   confirmed, unconfirmed, worked, not worked or waiting QSL respectively;
  779. - to select the band/mode for which one wish to show the unconfirmed
  780.   countries list. To achieve this, just click the desired band/mode label,
  781.   the background of which will immediately shift to red;
  782. - to print the list currently being shown list ("Print missing");
  783. - to print the country totals for each band/mode, as currently being shown
  784.   in the list ("Print totals");
  785. - to print the status (worked "W" or confirmed "C") for each country of 
  786.   the DXCC list in any band/mode ("Print status"). This facility is only 
  787.   possible if the "DXCC" label is currently red.
  788.  
  789. 9.8. Scrolling text
  790.      --------------
  791. If you wish to examine text which has already scrolled out of the receive
  792. window, you may press the vertical bar placed at the right hand side of the
  793. receive window and marked "S".
  794.  
  795. At this point, text reception is halted and it is then possible to examine
  796. old text by using the normal Windows scrolling facilities. In the meanwhile
  797. incoming text does not get lost, it being stored in a buffer (32768 bytes
  798. max.) and then shown as soon as normal operation is restored (i.e. the
  799. "Cancel" button is pressed).
  800.  
  801. One may select some text (in the MAIN WINDOW only) by using the normal
  802. Windows techniques (be careful not to double-click text, as this may activate
  803. the functions described in sects. 9.5 and 9.6) and then copy it to the
  804. Clipboard e.g. to transfer it into a Word Processor ("Copy" button) or 
  805. directly print it ("Print" button) or store it on a file ("Save" button) 
  806. which will be placed in the program directory. In this last case, remember
  807. to specify the file name by writing it into the "File name" text box.
  808.  
  809. 10. CONCLUSIONS
  810.     ===========
  811.  
  812. Enjoy the program and please let me know of any problem or suggestions to
  813. improve them.
  814.  
  815. Tony, I0JX / AB6VZ