X-Git-Url: http://dxcluster.org/gitweb/gitweb.cgi?a=blobdiff_plain;f=txt%2Fusermanual.txt;h=a373bc0db718359c9ffd58e50939fb14c3992f9c;hb=5b621c40fa6165a9f0eaf592d24a63a174e4b902;hp=023783051c02cf1613df1a7c4120a182505315b9;hpb=efefa52cf2a2f34cf57fb202b558880e167a28a4;p=spider.git diff --git a/txt/usermanual.txt b/txt/usermanual.txt index 02378305..a373bc0d 100644 --- a/txt/usermanual.txt +++ b/txt/usermanual.txt @@ -1,6 +1,6 @@ - The DXSpider User Manual - Ian Maude, G0VGS, (ianmaude@btinternet.com) - Version 1.0, 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. ______________________________________________________________________ @@ -159,27 +159,29 @@ 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 ______________________________________________________________________ @@ -212,18 +214,19 @@ 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 @@ -259,8 +262,12 @@ - connect GB7MBC - connect GB7MBC-1 + connect GB7MBC + connect GB7MBC-1 + + + + 22..22.. NNeettrroomm llooggiinnss.. @@ -284,12 +291,11 @@ 22..33.. TTeellnneett llooggiinnss.. - 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. EExxaammppllee:: @@ -314,15 +320,14 @@ 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. - 33.. SSeettttiinngg yyoouurr ppeerrssoonnaall ddeettaaiillss.. Once logged in to the cluster, you should set your details so that @@ -388,12 +393,14 @@ + will show the last 10, 5 and 20 spots received by the cluster respectively. EExxaammpplleess + show/dx on 20m show/dx 10 on 20m show/dx 20 on 20m @@ -453,8 +460,6 @@ EExxaammppllee:: - - show/dx 20 prefix 9a on vhf day 30 @@ -521,11 +526,6 @@ 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. - - - - - 55..11.. SSuunn The SSHHOOWW//SSUUNN command can be used in three different ways. It can be @@ -1323,9 +1323,6 @@ AA..Use the SSEETT//BBEEEEPP command. You can find information on this in the "DXSpider Command Reference" section. - QQ..I keep getting disconnected from the cluster, what is happening and - how can I stop it? - QQ..I got disconnected from the cluster and now I can't log back in again. What is wrong? @@ -1334,10 +1331,6 @@ again adding an ssid to your callsign as DXSpider treats G0YLM and G0YLM-1 as different users. - QQ..I notice that all the commands are shown in lower case in the main - section of this manual, but in upper case in the "DXSpider Command - Reference" section. Why is that? - QQ..How do I know if I have got the latest version of this user manual? AA..The latest and greatest will always be on the Website. It will also @@ -1383,7 +1376,6 @@ - some examples:- @@ -1392,9 +1384,6 @@ acc/ann 2 by_zone 14,15,16 (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16) - - - or @@ -1419,7 +1408,7 @@ 1122..22.. aacccceepptt//ssppoottss - aacccceepptt//aannnnoouunnccee [[00--99]] <> Set an accept filter line for spots + aacccceepptt//ssppoottss [[00--99]] <> Set an accept filter line for spots Create an 'accept this spot' line for a filter. @@ -1450,6 +1439,7 @@ + For frequencies, you can use any of the band names defined in SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb - thus: hf/ssb. You can also just have a simple range like: 0/30000 - @@ -1460,8 +1450,8 @@ - acc/spot 1 on hf/cw - acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16) + acc/spot 1 on hf/cw + acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16) @@ -1521,15 +1511,20 @@ - by eg: G,M,2 - origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone - channel + + + + + + by eg: G,M,2 + origin + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu + origin_zone + by_dxcc + by_itu + by_zone + channel @@ -1581,10 +1576,12 @@ bbyyee Exit from the cluster - This will disconnect you from the cluster + + + 1122..99.. cclleeaarr//ssppoottss cclleeaarr//ssppoottss [[11||aallll]] Clear a spot filter line @@ -1647,14 +1644,10 @@ ddbbsshhooww <> <> Display an entry, if it exists, in a database - This is the generic user interface to the database to the database system. It is expected that the sysop will add an entry to the local Aliases file so that users can use the more familiar AK1A style of enquiry such as: - - - SH/BUCK G1TLH @@ -1721,9 +1714,6 @@ This is how you send a DX Spot to other users. You can, in fact, now enter the and the either way round. - - - DX FR0G 144.600 DX 144.600 FR0G DX 144600 FR0G @@ -1777,9 +1767,6 @@ the sysop). - - - 1122..1166.. lliinnkkss lliinnkkss Show which nodes are physically connected @@ -1793,8 +1780,6 @@ rreeaadd Read the next unread personal message addressed to you rreeaadd <> Read the specified message - - You can read any messages that are sent as 'non-personal' and also any message either sent by or sent to your callsign. @@ -1846,6 +1831,9 @@ rej/ann all + + + but this probably for advanced users... @@ -1910,8 +1898,6 @@ but this probably for advanced users... - - 1122..2200.. rreejjeecctt//wwccyy rreejjeecctt//wwccyy [[00--99]] <> Set a reject WCY filter @@ -1922,15 +1908,19 @@ - by eg: G,M,2 - origin - origin_dxcc eg: 61,62 (from eg: sh/pre G) - origin_itu - origin_zone - by_dxcc - by_itu - by_zone - channel + + + + + by eg: G,M,2 + origin + origin_dxcc eg: 61,62 (from eg: sh/pre G) + origin_itu + origin_zone + by_dxcc + by_itu + by_zone + channel @@ -1978,6 +1968,7 @@ is probably the only useful thing to do (which will only show WWV broadcasts by stations in the US). + See HELP FILTER for information. @@ -2044,6 +2035,7 @@ sseett//aannnnoouunnccee Allow announce messages + Allow announce messages to arrive at your terminal. @@ -2110,6 +2102,8 @@ sent to you will normally find their way there should you not be connected. eg:- + + SET/HOMENODE gb7djk @@ -2176,12 +2170,12 @@ Setting it explicitly to 0 will disable paging. + SET/PAGE 30 SET/PAGE 0 - The setting is stored in your user profile. @@ -2242,58 +2236,64 @@ Allow WWV information to be seen at your console. You can switch off WWV messages with the _u_n_s_e_t_/_w_w_v command. + + 1122..4422.. sseett//wwxx sseett//wwxx Allow WX messages to be seen at your console - Allow WX information to be seen at your console. You can switch off WX messages with the _u_n_s_e_t_/_w_x command. - 1122..4433.. sshhooww//ddaattee + 1122..4433.. sshhooww//ccoonnffiigguurraattiioonn - sshhooww//ddaattee [[<>||<>]] Show the local time + sshhooww//ccoonnffiigguurraattiioonn [[<>]] Show all visible nodes and their users - This is very nearly the same as SHOW/TIME, the only difference the - format of the date string if no arguments are given. - - If no prefixes or callsigns are given then this command returns the - local time and UTC as the computer has it right now. If you give some - prefixes then it will show UTC and UTC + the local offset (not - including DST) at the prefixes or callsigns that you specify. - - - 1122..4444.. sshhooww//ddxx - - sshhooww//ddxx [[ooppttiioonnss]] interrogate the spot database + This command allows you to see all the users that can be seen and the + nodes to which they are connected. With the optional _n_o_d_e, you can + specify a particular node to look at. + This command is normally abbreviated to: sh/c - If you just type SHOW/DX you will get the last so many spots (sysop - configurable, but usually 10). - - In addition you can add any number of these options in very nearly any - order to the basic SHOW/DX command, they are:- - + BE WARNED: the list that is returned can be VERY long + 1122..4444.. sshhooww//ccoonnffiigguurraattiioonn//nnooddee + sshhooww//ccoonnffiigguurraattiioonn//nnooddee Show all the nodes connected + Show all the nodes connected locally and the nodes they have + connected. + 1122..4455.. sshhooww//ddaattee + sshhooww//ddaattee [[<>||<>]] Show the local time + This is very nearly the same as SHOW/TIME, the only difference the + format of the date string if no arguments are given. + If no prefixes or callsigns are given then this command returns the + local time and UTC as the computer has it right now. If you give some + prefixes then it will show UTC and UTC + the local offset (not + including DST) at the prefixes or callsigns that you specify. + 1122..4466.. sshhooww//ddxx + sshhooww//ddxx [[ooppttiioonnss]] interrogate the spot database + If you just type SHOW/DX you will get the last so many spots (sysop + configurable, but usually 10). + In addition you can add any number of these options in very nearly any + order to the basic SHOW/DX command, they are:- @@ -2358,7 +2358,7 @@ - 1122..4455.. sshhooww//ddxxcccc + 1122..4477.. sshhooww//ddxxcccc sshhooww//ddxxcccc <> Interrogate the spot database by country @@ -2381,7 +2381,7 @@ - 1122..4466.. sshhooww//ffiilleess + 1122..4488.. sshhooww//ffiilleess sshhooww//ffiilleess [[<> [[<>]]]] List the contents of a filearea @@ -2413,7 +2413,7 @@ See also TYPE - to see the contents of a file. - 1122..4477.. sshhooww//ffiilltteerr + 1122..4499.. sshhooww//ffiilltteerr sshhooww//ffiilltteerr Show the filters you have set @@ -2422,7 +2422,7 @@ displays all the filters set - for all the various categories. - 1122..4488.. sshhooww//mmoooonn + 1122..5500.. sshhooww//mmoooonn sshhooww//mmoooonn [[<>||<>]] Show moon rise and set times @@ -2451,7 +2451,7 @@ - 1122..4499.. sshhooww//mmuuff + 1122..5511.. sshhooww//mmuuff sshhooww//mmuuff <> [[<>]][[lloonngg]] Show the likely propagation to @@ -2546,7 +2546,7 @@ terrible accurate, but it is included for completeness. - 1122..5500.. sshhooww//pprreeffiixx + 1122..5522.. sshhooww//pprreeffiixx sshhooww//pprreeffiixx <> Interrogate the prefix database @@ -2559,7 +2559,7 @@ See also SHOW/DXCC - 1122..5511.. sshhooww//qqrraa + 1122..5533.. sshhooww//qqrraa sshhooww//qqrraa <> [[<>]] Show the distance between locators sshhooww//qqrraa <> <> Convert latitude and longitude to a locator @@ -2595,7 +2595,7 @@ - 1122..5522.. sshhooww//qqrrzz + 1122..5544.. sshhooww//qqrrzz sshhooww//qqrrzz <> Show any callbook details on a callsign @@ -2605,7 +2605,7 @@ provided for users of this software by http://www.qrz.com - 1122..5533.. sshhooww//rroouuttee + 1122..5555.. sshhooww//rroouuttee sshhooww//rroouuttee <> Show the route to @@ -2621,7 +2621,7 @@ - 1122..5544.. sshhooww//ssaatteelllliittee + 1122..5566.. sshhooww//ssaatteelllliittee sshhooww//ssaatteelllliittee <> [[<> <>]] Show satellite tracking data @@ -2654,7 +2654,7 @@ - 1122..5555.. sshhooww//ssuunn + 1122..5577.. sshhooww//ssuunn sshhooww//ssuunn [[<>||<>]] Show sun rise and set times @@ -2681,7 +2681,7 @@ - 1122..5566.. sshhooww//ttiimmee + 1122..5588.. sshhooww//ttiimmee sshhooww//ttiimmee [[<>||<>]] Show the local time @@ -2692,7 +2692,7 @@ including DST) at the prefixes or callsigns that you specify. - 1122..5577.. sshhooww//wwccyy + 1122..5599.. sshhooww//wwccyy sshhooww//wwccyy Show the last 10 WCY broadcasts sshhooww//wwccyy <> Show the last WCY broadcasts @@ -2704,7 +2704,7 @@ - 1122..5588.. sshhooww//wwwwvv + 1122..6600.. sshhooww//wwwwvv sshhooww//wwwwvv Show the last 10 WWV broadcasts sshhooww//wwwwvv <> Show the last WWV broadcasts @@ -2714,7 +2714,7 @@ system - 1122..5599.. ssyyssoopp + 1122..6611.. ssyyssoopp ssyyssoopp Regain your privileges if you login remotely @@ -2756,7 +2756,7 @@ case sensitive. - 1122..6600.. ttaallkk + 1122..6622.. ttaallkk ttaallkk <> Enter talk mode with ttaallkk <> <> Send a text message to @@ -2807,7 +2807,7 @@ - 1122..6611.. ttyyppee + 1122..6633.. ttyyppee ttyyppee <>//<> Look at a file in one of the fileareas @@ -2827,7 +2827,7 @@ content. - 1122..6622.. wwhhoo + 1122..6644.. wwhhoo wwhhoo Show who is physically connected locally @@ -2836,7 +2836,7 @@ what sort of connection they have - 1122..6633.. wwxx + 1122..6655.. wwxx wwxx <> Send a weather message to local users wwxx ffuullll <> Send a weather message to all cluster users