Add changes to the installation manual for Windows users from K1XX
[spider.git] / txt / usermanual.txt
index 8fb82898b22bb9132c3ab0f3e1b572f0817c7753..a373bc0db718359c9ffd58e50939fb14c3992f9c 100644 (file)
@@ -1,6 +1,6 @@
-  The DXSpider User Manual
-  Ian Maude, G0VGS, (ianmaude@btinternet.com)
-  Version 1.0 (Revision 3), March 2001
+  The DXSpider User Manual v1.50
+  Ian Maude, G0VGS, (g0vgs@gb7mbc.net)
+  September 2002 revision 0.1
 
   A complete reference for users of the DXSpider DXCluster program.
   ______________________________________________________________________
      12.40 set/wcy
      12.41 set/wwv
      12.42 set/wx
-     12.43 show/date
-     12.44 show/dx
-     12.45 show/dxcc
-     12.46 show/files
-     12.47 show/filter
-     12.48 show/moon
-     12.49 show/muf
-     12.50 show/prefix
-     12.51 show/qra
-     12.52 show/qrz
-     12.53 show/route
-     12.54 show/satellite
-     12.55 show/sun
-     12.56 show/time
-     12.57 show/wcy
-     12.58 show/wwv
-     12.59 sysop
-     12.60 talk
-     12.61 type
-     12.62 who
-     12.63 wx
+     12.43 show/configuration
+     12.44 show/configuration/node
+     12.45 show/date
+     12.46 show/dx
+     12.47 show/dxcc
+     12.48 show/files
+     12.49 show/filter
+     12.50 show/moon
+     12.51 show/muf
+     12.52 show/prefix
+     12.53 show/qra
+     12.54 show/qrz
+     12.55 show/route
+     12.56 show/satellite
+     12.57 show/sun
+     12.58 show/time
+     12.59 show/wcy
+     12.60 show/wwv
+     12.61 sysop
+     12.62 talk
+     12.63 type
+     12.64 who
+     12.65 wx
 
 
   ______________________________________________________________________
 
   There are several new compatible cluster programs around now,
   including DXSpider.  DXSpider is a clone of PacketCluster software
-  that runs under the Linux operating system.  Linux is fast becoming
-  the choice for amateur radio stations because of it's flexibility,
-  reliability and the lack of the memory limitations of DOS.  Linux
-  supports multitasking and is also multiuser. It has support for AX25,
-  ROSE, NetROM and TCPIP built in, making it the ideal choice for
-  amateur radio.  It is also totally free!
+  that runs under several operating systems including Linux and Windows.
+  Linux is fast becoming the choice for amateur radio stations because
+  of it's flexibility, reliability and the lack of the memory
+  limitations of DOS.  Linux supports multitasking and is also
+  multiuser. It has support for AX25, ROSE, NetROM and TCPIP built in,
+  making it the ideal choice for amateur radio.  It is also totally
+  free!
 
   DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an
   exercise in perl programming.  It has developed rapidly and today is a
   very powerful cluster program.  It was designed to be totally
   compatible with the AK1A program, although several commands have been
-  extended to try and improve functionality.
+  extended to improve functionality.
 
   This manual is designed to help you become familiar with the commands
   that DXSpider supports and to help you get the best from the program
 
 
 
-       connect GB7MBC
-       connect GB7MBC-1
+  connect GB7MBC
+  connect GB7MBC-1
+
+
+
+
 
   2\b2.\b.2\b2.\b.  N\bNe\bet\btr\bro\bom\bm l\blo\bog\bgi\bin\bns\bs.\b.
 
 
   2\b2.\b.3\b3.\b.  T\bTe\bel\bln\bne\bet\bt l\blo\bog\bgi\bin\bns\bs.\b.
 
-  Because DXSpider runs under the Linux operating system, it is possible
-  to make a direct telnet connection into the cluster.  With telnet
-  connections, the source callsign is not seen by DXSpider, so you will
-  be asked to login with your callsign.  To telnet to DXSpider, you
-  would connect to a specific port.  There is no standard at the moment
-  for a cluster telnet port but ask the sysop if you are unsure.
+  With telnet connections, the source callsign is not seen by DXSpider,
+  so you will be asked to login with your callsign.  To telnet to
+  DXSpider, you would connect to a specific port.  There is no standard
+  at the moment for a cluster telnet port but ask the sysop if you are
+  unsure.
 
   E\bEx\bxa\bam\bmp\bpl\ble\be:\b:
 
   command if you are connected via telnet.  If you do not log out
   gracefully using one of the above commands, you may find you are
   unable to get a full connect next time.  This may also happen if a
-  NETRom connection drops.  You may get connected, but nothing else will
+  netrom connection drops.  You may get connected, but nothing else will
   happen because the program thinks you are still connected and will not
   let you connect twice under the same call.  However you could
   reconnect by adding a number to the end of your call, for example
-  G0YLM2.  This can be done by either altering your MYCALL setting in
+  G0YLM-2.  This can be done by either altering your MYCALL setting in
   the TNC or by altering your program configuration.
 
 
-
   3\b3.\b.  S\bSe\bet\btt\bti\bin\bng\bg y\byo\bou\bur\br p\bpe\ber\brs\bso\bon\bna\bal\bl d\bde\bet\bta\bai\bil\bls\bs.\b.
 
   Once logged in to the cluster, you should set your details so that
 
 
 
+
   will show the last 10, 5 and 20 spots received by the cluster
   respectively.
 
   E\bEx\bxa\bam\bmp\bpl\ble\bes\bs
 
 
+
        show/dx on 20m
        show/dx 10 on 20m
        show/dx 20 on 20m
 
   E\bEx\bxa\bam\bmp\bpl\ble\be:\b:
 
-
-
        show/dx 20 prefix 9a on vhf day 30
 
 
   details.  They use your entered location as a reference, so if you
   have not entered it or have entered it incorrectly they will not
   return the correct information.
-
-
-
-
-
   5\b5.\b.1\b1.\b.  S\bSu\bun\bn
 
   The S\bSH\bHO\bOW\bW/\b/S\bSU\bUN\bN command can be used in three different ways.  It can be
 
   1\b12\b2.\b.2\b2.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/s\bsp\bpo\bot\bts\bs
 
-  a\bac\bcc\bce\bep\bpt\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Set an accept filter line for spots
+  a\bac\bcc\bce\bep\bpt\bt/\b/s\bsp\bpo\bot\bts\bs [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Set an accept filter line for spots
 
 
   Create an 'accept this spot' line for a filter.
   WX messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bw_\bx command.
 
 
-  1\b12\b2.\b.4\b43\b3.\b.  s\bsh\bho\bow\bw/\b/d\bda\bat\bte\be
+  1\b12\b2.\b.4\b43\b3.\b.  s\bsh\bho\bow\bw/\b/c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn
+
+  s\bsh\bho\bow\bw/\b/c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn [\b[<\b<n\bno\bod\bde\be>\b>]\b] Show all visible nodes and their users
+
+
+  This command allows you to see all the users that can be seen and the
+  nodes to which they are connected.  With the optional _\bn_\bo_\bd_\be, you can
+  specify a particular node to look at.
+
+  This command is normally abbreviated to: sh/c
+
+  BE WARNED: the list that is returned can be VERY long
+
+
+  1\b12\b2.\b.4\b44\b4.\b.  s\bsh\bho\bow\bw/\b/c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn/\b/n\bno\bod\bde\be
+
+  s\bsh\bho\bow\bw/\b/c\bco\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn/\b/n\bno\bod\bde\be Show all the nodes connected
+
+
+  Show all the nodes connected locally and the nodes they have
+  connected.
+
+
+
+  1\b12\b2.\b.4\b45\b5.\b.  s\bsh\bho\bow\bw/\b/d\bda\bat\bte\be
 
   s\bsh\bho\bow\bw/\b/d\bda\bat\bte\be [\b[<\b<p\bpr\bre\bef\bfi\bix\bx>\b>|\b|<\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b>]\b] Show the local time
 
   including DST) at the prefixes or callsigns that you specify.
 
 
-  1\b12\b2.\b.4\b44\b4.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bx
+  1\b12\b2.\b.4\b46\b6.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bx
 
   s\bsh\bho\bow\bw/\b/d\bdx\bx [\b[o\bop\bpt\bti\bio\bon\bns\bs]\b] interrogate the spot database
 
 
 
 
-       on <band>       - eg 160m 20m 2m 23cm 6mm
-       on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
 
-       <number>        - the number of spots you want
-       <from>-<to>     - <from> spot no <to> spot no in
-                         the selected list
 
-       <prefix>        - for a spotted callsign beginning with <prefix>
-       *<suffix>       - for a spotted callsign ending in <suffix>
-       *<string>*      - for a spotted callsign containing <string>
 
-       day <number>    - starting <number> days ago
-       day <from>-<to> - <from> days <to> days ago
 
-       info <text>     - any spots containing <text> in the info or remarks
 
-       by <call>       - any spots spotted by <call> (spotter <call>
-                               is the same).
 
-       qsl             - this automatically looks for any qsl info on the call
-                         held in the spot database.
 
-       iota [<iota>]   - If the iota island number is missing it will
-                         look for the string iota and anything which looks like
-                         an iota island number. If you specify then it will look
-                         for that island.
 
-       qra [<locator>] - this will look for the specific locator if
-                         you specify one or else anything that looks like a locator.
 
 
+  on <band>       - eg 160m 20m 2m 23cm 6mm
+  on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
+
+  <number>        - the number of spots you want
+  <from>-<to>     - <from> spot no <to> spot no in
+                    the selected list
+
+  <prefix>        - for a spotted callsign beginning with <prefix>
+  *<suffix>       - for a spotted callsign ending in <suffix>
+  *<string>*      - for a spotted callsign containing <string>
+
+  day <number>    - starting <number> days ago
+  day <from>-<to> - <from> days <to> days ago
+
+  info <text>     - any spots containing <text> in the info or remarks
+
+  by <call>       - any spots spotted by <call> (spotter <call>
+                          is the same).
+
+  qsl             - this automatically looks for any qsl info on the call
+                    held in the spot database.
+
+  iota [<iota>]   - If the iota island number is missing it will
+                    look for the string iota and anything which looks like
+                    an iota island number. If you specify then it will look
+                    for that island.
+
+  qra [<locator>] - this will look for the specific locator if
+                    you specify one or else anything that looks like a locator.
+
 
 
 
 
 
 
-  1\b12\b2.\b.4\b45\b5.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bxc\bcc\bc
+  1\b12\b2.\b.4\b47\b7.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bxc\bcc\bc
 
   s\bsh\bho\bow\bw/\b/d\bdx\bxc\bcc\bc <\b<p\bpr\bre\bef\bfi\bix\bx>\b> Interrogate the spot database by country
 
 
 
 
-          SH/DXCC G
-          SH/DXCC W on 20m info iota
 
 
+     SH/DXCC G
+     SH/DXCC W on 20m info iota
 
 
 
-  1\b12\b2.\b.4\b46\b6.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\ble\bes\bs
+
+
+  1\b12\b2.\b.4\b48\b8.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\ble\bes\bs
 
   s\bsh\bho\bow\bw/\b/f\bfi\bil\ble\bes\bs [\b[<\b<f\bfi\bil\ble\bea\bar\bre\bea\ba>\b> [\b[<\b<s\bst\btr\bri\bin\bng\bg>\b>]\b]]\b] List the contents of a filearea
 
 
 
 
+
   See also TYPE - to see the contents of a file.
 
 
-  1\b12\b2.\b.4\b47\b7.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br
+  1\b12\b2.\b.4\b49\b9.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br
 
   s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br Show the filters you have set
 
   displays all the filters set - for all the various categories.
 
 
-  1\b12\b2.\b.4\b48\b8.\b.  s\bsh\bho\bow\bw/\b/m\bmo\boo\bon\bn
+  1\b12\b2.\b.5\b50\b0.\b.  s\bsh\bho\bow\bw/\b/m\bmo\boo\bon\bn
 
   s\bsh\bho\bow\bw/\b/m\bmo\boo\bon\bn [\b[<\b<p\bpr\bre\bef\bfi\bix\bx>\b>|\b|<\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b>]\b] Show moon rise and set times
 
 
   If all else fails it will show the Moonrise and set times for the node
   that you are connected to.
-
   For example:-
 
 
 
 
 
-  1\b12\b2.\b.4\b49\b9.\b.  s\bsh\bho\bow\bw/\b/m\bmu\buf\bf
+  1\b12\b2.\b.5\b51\b1.\b.  s\bsh\bho\bow\bw/\b/m\bmu\buf\bf
 
   s\bsh\bho\bow\bw/\b/m\bmu\buf\bf <\b<p\bpr\bre\bef\bfi\bix\bx>\b> [\b[<\b<h\bho\bou\bur\brs\bs>\b>]\b][\b[l\blo\bon\bng\bg]\b] Show the likely propagation to
   <prefix>
   with a claimed RMS error of 3.8 MHz, but much smaller and less complex
   than the programs used by major shortwave broadcasting organizations,
   such as the Voice of America.
+
   The command will display some header information detailing its
   assumptions, together with the locations, latitude and longitudes and
   bearings. It will then show UTC (UT), local time at the other end
 
 
 
-         RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
-         Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
-         Location                       Lat / Long           Azim
-         East Dereham, Norfolk          52 41 N 0 57 E         47
-         United-States-W                43 0 N 87 54 W        299
-         UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
-         18 23 11.5 -35  mS0+ mS2   S3
-         19  0 11.2 -41  mS0+ mS2   S3
+
+    RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
+    Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
+    Location                       Lat / Long           Azim
+    East Dereham, Norfolk          52 41 N 0 57 E         47
+    United-States-W                43 0 N 87 54 W        299
+    UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
+    18 23 11.5 -35  mS0+ mS2   S3
+    19  0 11.2 -41  mS0+ mS2   S3
 
 
 
   terrible accurate, but it is included for completeness.
 
 
-  1\b12\b2.\b.5\b50\b0.\b.  s\bsh\bho\bow\bw/\b/p\bpr\bre\bef\bfi\bix\bx
+  1\b12\b2.\b.5\b52\b2.\b.  s\bsh\bho\bow\bw/\b/p\bpr\bre\bef\bfi\bix\bx
 
   s\bsh\bho\bow\bw/\b/p\bpr\bre\bef\bfi\bix\bx <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Interrogate the prefix database
 
   See also SHOW/DXCC
 
 
-  1\b12\b2.\b.5\b51\b1.\b.  s\bsh\bho\bow\bw/\b/q\bqr\bra\ba
+  1\b12\b2.\b.5\b53\b3.\b.  s\bsh\bho\bow\bw/\b/q\bqr\bra\ba
 
   s\bsh\bho\bow\bw/\b/q\bqr\bra\ba <\b<l\blo\boc\bca\bat\bto\bor\br>\b> [\b[<\b<l\blo\boc\bca\bat\bto\bor\br>\b>]\b] Show the distance between locators
   s\bsh\bho\bow\bw/\b/q\bqr\bra\ba <\b<l\bla\bat\bt>\b> <\b<l\blo\bon\bng\bg>\b> Convert latitude and longitude to a locator
 
 
 
-       SH/QRA IO92QL
-       SH/QRA JN06 IN73
+  SH/QRA IO92QL
+  SH/QRA JN06 IN73
 
 
 
 
 
 
-  1\b12\b2.\b.5\b52\b2.\b.  s\bsh\bho\bow\bw/\b/q\bqr\brz\bz
+  1\b12\b2.\b.5\b54\b4.\b.  s\bsh\bho\bow\bw/\b/q\bqr\brz\bz
 
   s\bsh\bho\bow\bw/\b/q\bqr\brz\bz <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show any callbook details on a callsign
 
   provided for users of this software by http://www.qrz.com
 
 
-  1\b12\b2.\b.5\b53\b3.\b.  s\bsh\bho\bow\bw/\b/r\bro\bou\but\bte\be
+  1\b12\b2.\b.5\b55\b5.\b.  s\bsh\bho\bow\bw/\b/r\bro\bou\but\bte\be
 
   s\bsh\bho\bow\bw/\b/r\bro\bou\but\bte\be <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the route to <callsign>
 
+
   This command allows you to see to which node the callsigns specified
   are connected. It is a sort of inverse sh/config.
 
 
 
 
-  1\b12\b2.\b.5\b54\b4.\b.  s\bsh\bho\bow\bw/\b/s\bsa\bat\bte\bel\bll\bli\bit\bte\be
+  1\b12\b2.\b.5\b56\b6.\b.  s\bsh\bho\bow\bw/\b/s\bsa\bat\bte\bel\bll\bli\bit\bte\be
 
   s\bsh\bho\bow\bw/\b/s\bsa\bat\bte\bel\bll\bli\bit\bte\be <\b<n\bna\bam\bme\be>\b> [\b[<\b<h\bho\bou\bur\brs\bs>\b> <\b<i\bin\bnt\bte\ber\brv\bva\bal\bl>\b>]\b] Show satellite tracking
   data
 
 
 
-  1\b12\b2.\b.5\b55\b5.\b.  s\bsh\bho\bow\bw/\b/s\bsu\bun\bn
+  1\b12\b2.\b.5\b57\b7.\b.  s\bsh\bho\bow\bw/\b/s\bsu\bun\bn
 
   s\bsh\bho\bow\bw/\b/s\bsu\bun\bn [\b[<\b<p\bpr\bre\bef\bfi\bix\bx>\b>|\b|<\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b>]\b] Show sun rise and set times
 
 
 
 
+         SH/SUN
+         SH/SUN G1TLH K9CW ZS
 
 
-    SH/SUN
-    SH/SUN G1TLH K9CW ZS
-
 
 
 
-
-  1\b12\b2.\b.5\b56\b6.\b.  s\bsh\bho\bow\bw/\b/t\bti\bim\bme\be
+  1\b12\b2.\b.5\b58\b8.\b.  s\bsh\bho\bow\bw/\b/t\bti\bim\bme\be
 
   s\bsh\bho\bow\bw/\b/t\bti\bim\bme\be [\b[<\b<p\bpr\bre\bef\bfi\bix\bx>\b>|\b|<\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b>]\b] Show the local time
 
   including DST) at the prefixes or callsigns that you specify.
 
 
-  1\b12\b2.\b.5\b57\b7.\b.  s\bsh\bho\bow\bw/\b/w\bwc\bcy\by
+  1\b12\b2.\b.5\b59\b9.\b.  s\bsh\bho\bow\bw/\b/w\bwc\bcy\by
 
   s\bsh\bho\bow\bw/\b/w\bwc\bcy\by Show the last 10 WCY broadcasts
   s\bsh\bho\bow\bw/\b/w\bwc\bcy\by <\b<n\bn>\b> Show the last <n> WCY broadcasts
   system
 
 
-  1\b12\b2.\b.5\b58\b8.\b.  s\bsh\bho\bow\bw/\b/w\bww\bwv\bv
+
+
+  1\b12\b2.\b.6\b60\b0.\b.  s\bsh\bho\bow\bw/\b/w\bww\bwv\bv
 
   s\bsh\bho\bow\bw/\b/w\bww\bwv\bv Show the last 10 WWV broadcasts
   s\bsh\bho\bow\bw/\b/w\bww\bwv\bv <\b<n\bn>\b> Show the last <n> WWV broadcasts
   system
 
 
-  1\b12\b2.\b.5\b59\b9.\b.  s\bsy\bys\bso\bop\bp
+  1\b12\b2.\b.6\b61\b1.\b.  s\bsy\bys\bso\bop\bp
 
   s\bsy\bys\bso\bop\bp Regain your privileges if you login remotely
 
 
   you type:-
 
+
+
         aa2bbbb0ccc5ddd7xxx3n
         or 2 0 5 7 3
         or 20573
   case sensitive.
 
 
-  1\b12\b2.\b.6\b60\b0.\b.  t\bta\bal\blk\bk
+  1\b12\b2.\b.6\b62\b2.\b.  t\bta\bal\blk\bk
 
   t\bta\bal\blk\bk <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Enter talk mode with <callsign>
   t\bta\bal\blk\bk <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> <\b<t\bte\bex\bxt\bt>\b> Send a text message to <callsign>
 
 
 
-
-
-
-  1\b12\b2.\b.6\b61\b1.\b.  t\bty\byp\bpe\be
+  1\b12\b2.\b.6\b63\b3.\b.  t\bty\byp\bpe\be
 
   t\bty\byp\bpe\be <\b<f\bfi\bil\ble\bea\bar\bre\bea\ba>\b>/\b/<\b<n\bna\bam\bme\be>\b> Look at a file in one of the fileareas
 
   content.
 
 
-  1\b12\b2.\b.6\b62\b2.\b.  w\bwh\bho\bo
+  1\b12\b2.\b.6\b64\b4.\b.  w\bwh\bho\bo
 
   w\bwh\bho\bo Show who is physically connected locally
 
   what sort of connection they have
 
 
-  1\b12\b2.\b.6\b63\b3.\b.  w\bwx\bx
+  1\b12\b2.\b.6\b65\b5.\b.  w\bwx\bx
 
   w\bwx\bx <\b<t\bte\bex\bxt\bt>\b> Send a weather message to local users
   w\bwx\bx f\bfu\bul\bll\bl <\b<t\bte\bex\bxt\bt>\b>  Send a weather message to all cluster users
 
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+