]> scm.dxcluster.org Git - spider.git/blob - sgml/usermanual_en.sgml
Add CTY-2502 prefixes
[spider.git] / sgml / usermanual_en.sgml
1 <!doctype linuxdoc system>
2
3 <article>
4
5 <!-- Title information -->
6
7 <title>The DXSpider User Manual v1.51</title> 
8 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net)</author>
9 <date>June 2004 revision 1</date>
10
11 <abstract>
12 A complete reference for users of the DXSpider DXCluster program.
13 </abstract>
14
15 <!-- Table of contents -->
16 <toc>
17
18 <!-- Begin the document -->
19
20 <sect>Introduction
21
22 <sect1>What is a DX Cluster?
23
24 <p>
25 A DX Cluster is a packet node where DX chasers on any band or mode can
26 post rare or interesting stations that they have worked or heard.  Of 
27 course other people are doing the same thing too, so you can find new 
28 DX as well as telling others about the stations you have worked.  
29 Clusters tend to be linked to each other so that the amount of people 
30 using them is increased, thereby increasing the amount of posted DX.  
31 Other information can be found on clusters such as on-line call books, 
32 mail etc.  You can talk to other stations connected to the cluster 
33 network too, in real time, whether at the node you are logged into or 
34 on another node connected to the network.  You can also use converse 
35 mode, where several stations can talk to each other in the same way.  
36 Of course, the DX is still posted to you all the while!
37  
38 <sect1>So what is DXSpider?
39
40 <p>
41 PacketCluster nodes have been around since roughly 1985. The original 
42 PacketCluster idea came from Dick Newell, AK1A, and ran under DOS.
43 In about 1992 Dick stopped the development of the PacketCluster 
44 software for amateur radio. Many systems are still using this 
45 relatively old DOS software today.
46
47 There are several new compatible cluster programs around now, 
48 including DXSpider.  DXSpider is a clone of PacketCluster software that runs 
49 under several operating systems including Linux and Windows.  Linux is fast 
50 becoming the choice for amateur radio stations because of it's flexibility, 
51 reliability and the lack of the memory limitations of DOS.  Linux supports 
52 multitasking and is also multiuser. It has support for AX25, ROSE, 
53 NetROM and TCPIP built in, making it the ideal choice for amateur
54 radio.  It is also totally free!
55
56 DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an
57 exercise in perl programming.  It has developed rapidly and today is a
58 very powerful cluster program.  It was designed to be totally compatible
59 with the AK1A program, although several commands have been extended to
60 improve functionality.
61
62 This manual is designed to help you become familiar with the commands
63 that DXSpider supports and to help you get the best from the program so 
64 you can enjoy working that rare DX!  As DXSpider is being improved all the 
65 time, commands will be added as time goes by, so make sure you have 
66 the most upto date version of this manual.  The latest version will
67 always be included with the cluster program so if you are unsure, simply
68 ask your sysop.  The manual will also be available on the wesite.
69
70
71 <sect>Logins and logouts.
72
73 <p>
74 You might not think that there is a lot of point of including a 
75 section on how to log in and out of DXSpider.  However, you would be 
76 suprised at the difficulties some people have in simply getting in 
77 and out of the cluster!
78
79 There are several ways a login might be achieved, dependant on how 
80 the sysop has DXSpider configured.  It is impossible for me to cover all 
81 variations but here are the basic ones.
82
83 <sect1>AX25 logins.
84
85 <p>
86 Simplicity itself.  The usual <bf>CONNECT</bf> command will log you straight
87 into the cluster and you will not have to do anything else.  
88 Obviously, you will have to connect to the correct callsign.  Some 
89 nodes use an SSID with their call so you would have to add that.
90
91 <bf>Examples:</bf>
92
93 <tscreen><verb>
94 connect GB7MBC
95 connect GB7MBC-1
96 </verb></tscreen>
97
98 <sect1>Netrom logins.
99
100 <p>
101 There are several possibilities here, dependant on how the sysop has
102 configured his system.  If you are connecting via netrom then you are
103 most probably connecting from another station.  Listing the nodes in
104 that station with the <bf>NODES</bf> command will tell you what callsign 
105 or netrom alias to connect to. Then just issue the connect command 
106 from there.  It is possible that the netrom alias may connect you to 
107 a node with an alias for the cluster, such as DXC.  Just type this 
108 and you will be connected.
109
110 <bf>Example:</bf>
111 <tscreen><verb>
112 connect MBCDX
113 </verb></tscreen>
114
115 <sect1>Telnet logins.
116
117 <p>
118 With telnet connections, the source callsign is not seen by DXSpider, so 
119 you will be asked to login with your callsign.  
120 To telnet to DXSpider, you would connect to a specific port.  There is no 
121 standard at the moment for a cluster telnet port but ask the sysop if 
122 you are unsure.
123
124 <bf>Example:</bf>
125
126 <tscreen><verb>
127 telnet gb7mbc 8000
128 </verb></tscreen>
129
130 All the above are possible ways of connecting to a DXSpider cluster.  You
131 may have some or all of these available to you.  There may be one or 
132 two additional ways to connect dependant on the network local to you.
133 However I am sure you get the idea.
134
135 <sect1>Logouts.
136
137 <p>
138 Logging out can be done by simply issuing the standard <bf>BYE</bf>
139 command.
140
141 You could also send a disconnect if you are using AX25, or a <bf>CLOSE</bf>
142 command if you are connected via telnet.
143 If you do not log out gracefully using one of the above commands, 
144 you may find you are unable to get a full connect next time.  This
145 may also happen if a netrom connection drops.  You may get connected, 
146 but nothing else will happen because the program thinks you are still 
147 connected and will not let you connect twice under the same call.  
148 However you could reconnect by adding a number to the end of your call,
149 for example G0YLM-2.  
150 This can be done by either altering your MYCALL setting in the TNC or 
151 by altering your program configuration.  
152
153
154 <sect>Setting your personal details.
155
156 <p>
157 Once logged in to the cluster, you should set your details so that 
158 anybody who wishes to contact you can find out who and where you are.
159 There are four items to set, your name, qth, location and home node.  
160 Setting these details also allows the use of the SHOW/HEADING and
161 SHOW/SUN commands from within the cluster.  Unless you set your QTH
162 and location, these commands cannot function.
163 Once you have set your name, DXSpider will greet you with it next time 
164 you login.  Your QTH setting is where you live and it is a good idea 
165 to add your locator to this as the location setting is converted to 
166 latitude and longitude once inputted.  You can actually set your location 
167 in latitude/longitude or as a locator.  Setting your home node will 
168 tell the program where you wish mail to be sent to you.
169
170 <bf>Examples:</bf>
171
172 <tscreen><verb>
173 set/name Ian
174 set/qth Morecambe, Lancashire IO84NB
175 set/location 48 34 n 12 12 e
176 set/qra IO84NB
177 set/home gb7mbc
178 </verb></tscreen>
179
180 <sect>Getting and posting DX.
181
182 <p>
183 When all is said and done, this is the main function of a DX cluster.
184 In its simplest form you can just connect to the node and you will 
185 start to receive DX spots almost immediately!  You can check on 
186 recent postings in either a general manner or on a particular band or
187 mode.  You can even check DX by callsign or a fragment of a callsign.
188 Of course, once you get the hang of things, it is expected that you 
189 start posting some yourself!  After all, there would be no clusters 
190 if people did not post DX and you get the added thrill of the hunt!
191
192 <sect1>Receiving DX.
193
194 <p>
195 As we have already said, it is possible just to connect to the 
196 cluster and you will receive spots automatically.  However, you may 
197 wish to check on spots just posted.  Maybe you wish to see if a 
198 particular band is open or if a certain callsign is active, perhaps a
199 DXpedition.  The command to do this is <bf>SHOW/DX</bf>.  Without any 
200 other arguments, this command will output the last 10 spots 
201 posted.  It is possible to look at more than this, for example the 
202 last 20 or 50 spots, by adding the number to the command.  You can 
203 make it even more specific by adding a band in either wavelength or 
204 frequency, and/or any additional information such as QSL details.
205
206 <bf>Examples:</bf>
207
208 <tscreen><verb>
209 show/dx
210 show/dx 5
211 show/dx 20
212 </verb></tscreen>
213
214 will show the last 10, 5 and 20 spots received by the cluster 
215 respectively.
216
217 <bf>Examples</bf>
218
219 <tscreen><verb>
220 show/dx on 20m
221 show/dx 10 on 20m
222 show/dx 20 on 20m
223 </verb></tscreen>
224
225 will show the last 5, 10 or 20 spots on 20 metres only.
226
227 It is also possible to check for certain callsigns, or fragments of 
228 callsigns in the same way.
229
230 <bf>Examples:</bf>
231
232 <tscreen><verb>
233 show/dx g0vgs
234 show/dx 10 g0vgs
235 </verb></tscreen>
236
237 would show the last 5 or 10 dx spots containing the callsign g0vgs.
238
239 <p>
240 You can check for DX by offset and also by specifying a comment to 
241 search for.
242
243 <bf>Examples:</bf>
244
245 <tscreen><verb>
246 show/dx 30-40
247 show/dx 14000-14033
248 show/dx iota
249 </verb></tscreen>
250
251 would show the spots that arrived between 30 and 40 spots ago and any 
252 spots with the word <em>iota</em> in the comment field.  The case of 
253 the comment is not important.
254  
255 Checking DX posted on a certain day is possible too.  All you have
256 to do here is to specify how many days ago it was like this ...
257
258 <bf>Example:</bf>
259
260 <tscreen><verb>
261 show/dx day 30 
262 </verb></tscreen>
263
264 It is of course possible to specify multiple arguments.
265
266 <bf>Example:</bf>
267
268 <tscreen><verb>
269 show/dx 20 prefix 9a on vhf day 30
270 </verb></tscreen>
271
272 This would show the last 20 spots posted by or about calls with the prefix
273 9a on vhf 30 days ago.
274
275 As you can see the <bf>SHOW/DX</bf> command is very flexible, so if you are
276 not sure whether something will work or not, try it and see!  More
277 information can be found in the Command Set section.
278
279 <sect1>Posting DX.
280
281 <p>
282 To post DX you use the <bf>DX</bf> command.  The syntax is shown below. 
283
284 <bf>Example:</bf>
285
286 <tscreen><verb>
287 dx (frequency) (callsign) (remarks)
288 </verb></tscreen>
289
290 Where frequency is in kilohertz and the callsign is the callsign of
291 the station you have worked or heard, (ie not your own callsign!).  
292 The remarks section allows you to add information like the operators 
293 name or perhaps a location.  Actually DXSpider will allow the frequency
294 and callsign fields to be entered in any order.
295
296 <bf>Example:</bf>
297
298 <tscreen><verb>
299 dx 14004 pa3ezl OP Aurelio 599
300 </verb></tscreen>
301
302 In fact, all the following will give the same result...
303
304 <tscreen><verb>
305 dx 14004 pa3ezl OP Aurelio 599
306 dx pa3ezl 14004 OP Aurelio 599
307 dx pa3ezl 14.004 OP Aurelio 599
308 </verb></tscreen>
309
310 This posting, or callout as it is known, will be forwarded to all 
311 other connected stations both at the cluster you are connected to and
312 other active clusters in the network.  The callout will also be sent 
313 to you as proof of receipt. 
314  
315 <sect>Headings and propagation
316
317 <p>
318 There are three commands in DXSpider to help you get the best DX possible.
319 These are <bf>SHOW/SUN</bf>, <bf>SHOW/MOON</bf> and
320 <bf>SHOW/HEADING</bf>.  These commands will only work for you if you
321 have entered your personal details.  They use your entered location as
322 a reference, so if you have not entered it or have entered it incorrectly
323 they will not return the correct information.
324
325 <sect1>Sun
326
327 <p>
328 The <bf>SHOW/SUN</bf> command can be used in three different ways.  It
329 can be used to show sunrise and sunset times for your own station, a 
330 particular callsign or a prefix.  
331
332 <bf>Example:</bf>
333
334 <tscreen><verb>
335 show/sun
336 </verb></tscreen>
337
338 The output from this would look something like this ..
339
340 <tscreen><verb>
341 sh/sun
342 Location                              Rise   Set      Azim   Elev
343 G0VGS  Morecambe, Lancashire          07:08Z 17:39Z  205.3   24.1
344 </verb></tscreen>
345
346 <tscreen><verb>
347 sh/sun 5b4
348 </verb></tscreen>
349
350 would look like this ...
351
352 <tscreen><verb>
353 sh/sun 5b4
354 Location                              Rise   Set      Azim   Elev
355 5B     Cyprus-5B                      04:23Z 15:40Z  244.0   18.8  
356 </verb></tscreen>
357
358 You can also specify multiple arguments like this ...
359
360 <tscreen><verb>
361 sh/sun gw4veq 5b4ab zs
362 </verb></tscreen>
363
364 and then the output would look like this ...
365
366 <tscreen><verb>
367 sh/sun gw4veq 5b4ab zs
368 Location                              Rise   Set      Azim   Elev
369 GW4VEQ Brungwran, Isle of Anglesey IO 07:14Z 17:48Z  204.9   24.9
370 5B     Cyprus-5B                      04:23Z 15:40Z  244.5   18.3
371 ZS     So-Africa-ZS1-ZS               04:31Z 17:28Z  289.9   41.3
372 ZS     So-Africa-ZS5-ZS               03:44Z 16:34Z  278.5   32.0
373 ZS     So-Africa-ZS6-ZS               03:59Z 16:42Z  277.6   35.0 
374 </verb></tscreen>
375
376 <sect1>Moon
377
378 <p>
379 The <bf>SHOW/MOON</bf> command works in the same way as the 
380 <bf>SHOW/SUN</bf> command.  This program however, calculates the
381 rise and set times of the moon for a prefix or callsign, together
382 with the current azimuth and elevation of the sun at these
383 locations.
384
385 <bf>Example:</bf>
386
387 <tscreen><verb>
388 show/moon ea
389 </verb></tscreen>
390
391 The output from this command would look like this ..
392
393 <tscreen><verb>
394 sh/moon ea
395 Location                              Rise   Set      Azim   Elev  RGain dB
396 EA     Spain-EA                       08:15Z 20:09Z  257.2    9.5      -0.6  
397 </verb></tscreen>
398  
399 You can see that the output is similar to the <bf>SHOW/SUN</bf>
400 command, with slightly different fields.
401
402 <sect1>Heading
403
404 <p>
405 The <bf>SHOW/HEADING</bf> command works in the same way as the 
406 <bf>SHOW/SUN</bf> and <bf>SHOW/MOON</bf> commands but outputs beam 
407 headings for a specified callsign or prefix.  Reciprocal beam headings 
408 are also calculated.
409
410 <bf>Example</bf>
411
412 <tscreen><verb>
413 show/heading zl
414 </verb></tscreen>
415
416 The output from this command would look like this ..
417
418 <tscreen><verb>
419 sh/heading zl
420 ZL New-Zealand-ZL1-ZL: 7 degs - dist: 11238 mi, 18087 km Reciprocal heading: 355 degs
421 ZL New-Zealand-ZL2-ZL: 9 degs - dist: 11540 mi, 18574 km Reciprocal heading: 353 degs
422 ZL New-Zealand-ZL3-ZL: 19 degs - dist: 11634 mi, 18724 km Reciprocal heading: 345 degs
423 ZL New-Zealand-ZL4-ZL: 34 degs - dist: 11783 mi, 18963 km Reciprocal heading: 332 degs
424 </verb></tscreen>
425
426 <sect>Announcements.
427
428 <sect1>Making announcements.
429
430 <p>
431 Occasionally, you may wish to post something that does not fall into 
432 the normal parameters for a DX callout.  You may wish to tell 
433 everybody connected that 10 FM is open for example, or ask if anyone 
434 knows the QSL manager for a certain callsign etc.  You can do this 
435 using the <bf>ANNOUNCE</bf> command.
436
437 <bf>Example:</bf>
438
439 <tscreen><verb>
440 announce 10 FM is open in IO84NB to europe.
441 </verb></tscreen>
442
443 That would let everyone know locally that this was the case, however
444 it would not be forwarded to other nodes connected.  To send
445 announcements to other connected nodes as well, you would use the
446 <bf>FULL</bf> extension.
447
448 <bf>Example:</bf>
449
450 <tscreen><verb>
451 announce full Anyone seen EA7WA today?
452 </verb></tscreen>
453
454 Be cautious in your use of announce full.  There are many other tools
455 available to get the information you require and the judicious use of
456 this command is frowned upon as it creates a great deal of traffic
457 across the network.
458
459 <sect1>Listing announcements.
460
461 <p>
462 You can list previous announcements in the standard format with the 
463 <bf>SHOW</bf> command.  As before you can list just the last 5 or as 
464 many as you wish.
465
466 <bf>Example:</bf>
467
468 <tscreen><verb>
469 show/announcements
470 show/announcements 10
471 </verb></tscreen>
472
473 <sect>Nodes and users.
474
475 <p>
476 You can check which nodes are connected in the network, who is 
477 logged on locally, who is logged on at all the nodes or even 
478 just one node in particular. This is handy if you wish to see whether
479 a friend is connected at the node they use.  To see who is connected 
480 to the nodes, the <bf>SHOW/CONFIGURATION</bf> command is used.
481
482 <bf>Example:</bf>
483
484 <tscreen><verb>
485 show/configuration
486 show/configuration/nodes
487 show/configuration (node_call)
488 show/configuration (prefix)
489 </verb></tscreen>
490
491 The first of our three examples would output something like this,
492
493 <tscreen><verb>
494 sh/c
495 Node         Callsigns
496 EI5TCR       (7 users)
497 GB7ADX
498 GB7BAA       G4FPV        G8TIC
499 GB7BIG       (GD0TEP)     GD3UMW
500 GB7BPQ       (G0INA)      G0RCI        G3AKU        G3OCA
501 (GB7CDX)     G3JNB        G4ALR
502 GB7DJK       G0FYD        G0REK        G1TLH        G4PEL        G4SOZ
503              G4TVR        G7SQW        K8AZ         M0CTQ-1      MM1CXE-10
504              ON7WP
505 GB7DXA       G0RDI        G8SJP
506 GB7DXC       (G0HDB)      G0WFK        (G1FYC)      G3KWK        G3LME
507              G3OIL        G4BGW        G4FUJ        (G4PDQ)      GW7SMV
508 GB7DXE       G1NNB
509 (GB7DXG)     GU6EFB       GU7DHI
510 GB7DXK       G1NTW        G3IBI        G3NSM        G3XAQ        G4CUS
511              G4XQY        G7GAN
512 GB7DXM       G1EUC        G3GAF        G3LAS        G4ZTR        G8WXU
513              M0BCT        M1EMF
514 </verb></tscreen>
515
516 You will notice that EI5TCR is showing only that it has 7 users and not
517 giving the actual callsigns.  This means that this node is on a limited
518 protocol of some kind, probably because of a contest situation where
519 slow radio links can block up and fail if too much information is sent
520 between nodes.
521
522 The second example would just show the nodes connected in the
523 network, like this,
524
525 <tscreen><verb>
526 sh/c/n
527 Node         Callsigns
528 GB7BAA       GB7BAA       GB7BPQ       (GB7CDX)     GB7DJK       GB7DXA      
529              GB7DXC       GB7DXE       (GB7DXG)     GB7DXK       GB7DXL      
530              GB7DXM       GB7DXS       GB7IPT       GB7MRS       GB7UJS      
531              GB7YDX       KL7G         N2TLY        (ON0DXK)                 
532 GB7BIG       EI5TCR       GB7ADX       GB7BIG       GB7UDX                   
533 GB7MBC                                                                       
534 PA4AB-14     PA4AB-14                                                        
535 PI4TUE-8     PI4TUE-8    
536 </verb></tscreen>
537
538 If we insert the node_call pi4tue-8 into the third example, then
539 this would be the output,
540
541 <tscreen><verb>
542 Node         Callsigns
543 PI4TUE-8     9A1CMA-6     DF6PW        DL4FAY       DL4KAK       DL4WF-2     
544              F5NOD-2      F5PAC        IZ0CSR       N6CR         OH2BLD      
545              ON1LVL-13    ON4CBT       ON4CJP       ON5DXL-14    ON7NQ       
546              PA0RCT       PA3DYS       PA3FDO       PA5KW-4      PI4TUE-9    
547              YT1XX        
548 </verb></tscreen>
549
550 As you can see, only the users of the requested node are shown.
551
552 You can also use a prefix to show only a group of nodes.  For example
553 you may only wish to see who is connected to the nodes in the UK.  To
554 do this simply use a prefix like this ...
555
556 <verb>
557 show/configuration gb7
558 </verb>
559
560 To show the locally connected users, the <bf>SHOW/USERS</bf> command is
561 used
562
563 <bf>Example:</bf>
564
565 <tscreen><verb>
566 show/users
567 </verb></tscreen>
568
569 The output of this command would look like this,
570
571 <tscreen><verb>
572 Callsigns connected to GB7MBC
573 G0JHC        G0NEI        G0VGS        G0VGS-2      G0YLM                    
574 G3JAG        G3OWO        G3UEU
575 </verb></tscreen>
576
577 <sect>Talk mode.
578
579 <p>
580 You can send a single comment or start a dedicated talk session to 
581 another user by using the <bf>TALK</bf> command. 
582
583 <p>
584 Talk mode is used to send a one line comment or greeting to a 
585 specific user connected either at your node or another in the 
586 network.  You can also enter into a dedicated talk session with 
587 another user.  Talks will be automatically forwarded to other nodes 
588 if the station you are talking to is not connected locally. 
589 You can find out who is connected by using the 
590 <bf>SHOW/CONFIGURATION</bf> command, (described earlier).
591
592 <bf>Examples:</bf>
593
594 <tscreen><verb> 
595 talk g0rdi Having a good day Iain?
596 </verb></tscreen>
597
598 This example would send the line "Having a good day Iain?" to the
599 user g0rdi but would leave you in normal mode.  
600
601 <tscreen><verb>
602 talk g0rdi
603 Entering Talkmode, /EX to end, /<cmd> to run a command
604 Talk (G0RDI)>
605 </verb></tscreen>
606
607 As you can see, you can still run commands whilst in talk mode.
608 Simply prefix the command with a / like /sh/dx and you will get
609 the expected output.
610 If the user is connected to another node, you may have to use a 
611 slightly extended version of the <bf>TALK</bf> command.
612
613 <tscreen><verb>
614 talk g0rdi > gb7djk
615 </verb></tscreen>
616
617 To exit talk mode, you issue the command <bf>/ex</bf>. 
618
619 Whilst in talk mode you will still receive DX spots.  This means that
620 you can chat to a friend whilst working DX.  
621
622 <sect>Mail.
623
624 <p>
625 You can send and receive both personal mail and bulletins with DXSpider 
626 quite easily.
627
628 <sect1>The "directory" command.
629
630 <p>
631 To list mail you would use the <bf>DIRECTORY</bf> command.  On its 
632 own, this command will output the last ten messages received by the 
633 node, either to or from yourself or bulletins such as "DX" and "ALL".
634 As with other commands you can display more by specifying a number 
635 with the command.  You should be aware that Spider will accept
636 these commands by separating with either a slash or a space, so
637 <em>dir new</em> and <em>dir/new</em> work in the same way.
638
639 <bf>Example:</bf>
640
641 <tscreen><verb>
642 directory
643 directory/20
644 directory 20
645 </verb></tscreen>
646
647 Of course most of the time you will only want to list new mail sent 
648 to you personally since your last login.  However you might also like 
649 to check for general mail received by the node.  In fact if there is 
650 new mail for you, the cluster will tell you when you login. You will 
651 also be informed if new mail arrives for you during the time you are 
652 logged in.
653 Mail is not only sent to callsigns though.  Mail can also be sent to 
654 subjects like "all" or "local" or "dx" etc.  You can treat these 
655 bulletins in the same way as personal mail with the directory 
656 command.
657
658 <bf>Examples:</bf>
659
660 <tscreen><verb>
661 directory/new
662 directory/own
663 directory/own/10
664 directory/all
665 directory/from <call>
666 </verb></tscreen>  
667
668 The last option will only show mail from a callsign if it was sent to
669 you personally or was sent as a bulletin.  There are some additional
670 commands and these can be found in the DXSpider Command Reference section.
671
672 <sect1>Reading mail.
673
674 <p>
675 The output of the <bf>DIRECTORY</bf> command could be something like 
676 this.
677
678 <tscreen><verb>
679 dir
680  20735      2      ALL   GW7SMV 21-Feb 1204Z REC 9E1S QSL TDY 50Mhz....    
681  20823    308       UK    G0HDB 22-Feb 2334Z Help - which district code?   
682  20824    105      ALL     W9AE 23-Feb 0349Z S0NY QSL address?             
683  20825      2       UK    G0LRJ 23-Feb 0806Z QSL REC LZ2CJ/1.CARD NO-750.  
684  20858      2      ALL   GW7SMV 24-Feb 0905Z REC S92DX QSL CARD TDY 50Mhz  
685  20921    200      ALL   GM4FDM 27-Feb 2203Z Trip to VP8                   
686  20949    375      ALL     K0MN 27-Feb 0428Z ST0P cards are gd @ ARRL      
687  20950      2       UK    G0LRJ 28-Feb 0835Z QSL REC SV9/IZ0CKJ/P EU-187.  
688  20987    569      ALL   GD0TEP  1-Mar 1733Z Portable contests             
689  21076      2      ALL    G4AFJ  3-Mar 1743Z kh6nd/kh5 qsl received
690  21184-p  599   GW4HAT    G0VGS  4-Mar 1518Z Re: Time 
691 </verb></tscreen>
692
693 The first column is the actual message number.  If the message is a
694 personal one to you, you will see a letter 'p' after this number.  If
695 the message has been read, there will be a '-' between the message
696 number and the 'p'.  This only works for personal messages.  The next
697 column shows the file size of the message.  The third column shows the
698 address the message was sent to and the next column shows who sent it.
699 The rest is fairly self-explanatory.
700
701 Reading a message is as simple as typing read, followed by the 
702 message number that you wish to read.
703
704 <bf>Example:</bf>
705
706 <tscreen><verb>
707 read 25
708 </verb></tscreen>
709
710 will read message number 25.  However the mail will be displayed in it's
711 entirety unless you specify a page length. You can set your page length
712 to any number you like and when the message reaches that number of lines
713 you will get a prompt giving you options.
714
715 <bf>Example:</bf>
716
717 <tscreen><verb>
718 set/page 20
719 </verb></tscreen>
720
721
722 <sect1>Sending mail.
723
724 <p>
725 Sending mail is done in the time honoured way.  First you specify
726 a recipient for the message, then you will be prompted for a subject.
727 Once you have done this you will be asked to type your message.
728 Please remember that there is no automatic word wrap, so unless you
729 are using a client that wraps lines automatically, remember to hit
730 return at the end of each line.
731
732 <bf>Example:</bf>
733
734 <tscreen><verb>
735 send m0azm
736 Enter Subject (30 characters):
737 See you Thursday
738 Enter Message /EX to send or /ABORT to exit
739 Hi Ian,            
740 Just a quick note to say that I can make Thursday after all.  The
741 appointment I had has cancelled so we are go!
742 Cheers
743 Ian
744 </verb></tscreen>
745
746 At this point you can either hit return and enter /ex to send the
747 message or use /abort at any time to abort it.  You can now display
748 the message in the normal way.  There are several send options and 
749 these are listed in the Command Set section.  These include sending
750 mail to several recipients and asking for a return receipt.
751
752
753 <sect1>Replying to mail.
754
755 <p>
756 If mail is addressed to you or to a bulletin address, you can use the
757 <bf>REPLY</bf> command to reply to it.  Using this command, the 
758 subject will be automatically set for you as "Re: subject", whatever 
759 the subject was. 
760  
761 <bf>Example:</bf>
762
763 <tscreen><verb>
764 reply 2500
765 </verb></tscreen>
766
767 <sect1>Deleting mail
768
769 <P>
770 To delete a message, you use the <em>delete</em> command.
771 You can only delete messages sent to or received by yourself.  
772 Bulletins are dealt with automatically or by the sysop.
773
774 <sect>Filtering (From version 1.45)
775
776 <sect1>General filter rules
777
778 <P>
779 Upto v1.44 it was not possible for the user to set their own filters.  From 
780 v1.45 though that has all changed.  It is now possible to set filters for just 
781 about anything you wish.  If you have just updated from an older version of 
782 DXSpider you will need to update your new filters.  You do not need to do 
783 anything with your old filters, they will be renamed as you update.
784
785 <P>
786 There are 3 basic commands involved in setting and manipulating filters.  These 
787 are <em>accept</em>, <em>reject</em> and <em>clear</em>.  First we will look
788 generally at filtering. There are a number of things you can filter in the 
789 DXSpider system. They all use the same general mechanism.
790
791 <P>
792 In general terms you can create a 'reject' or an 'accept' filter which can have 
793 up to 10 lines in it. You do this using, for example ... 
794
795 <tscreen><verb> 
796 accept/spots .....
797 reject/spots .....
798 </verb></tscreen>
799
800 where ..... are the specific commands for that type of filter. There are
801 filters for spots, wwv, announce, wcy and (for sysops) connects. See each 
802 different accept or reject command reference for more details.
803
804 There is also a command to clear out one or more lines in a filter. They are ...
805
806 <tscreen><verb>
807 clear/spots 1
808 clear/spots all
809 </verb></tscreen>
810
811 There is clear/xxxx command for each type of filter.
812
813 <P>
814 and you can check that your filters have worked by the command ... 
815
816 <tscreen><verb>  
817 show/filter
818 </verb></tscreen>
819
820 <P>
821 For now we are going to use spots for the examples, but you can apply the same
822 principles to all types of filter.
823
824 <sect1>Types of filter
825
826 <P>
827 There are two main types of filter, <em>accept</em> or <em>reject</em>.  You 
828 can use either to achieve the result you want dependent on your own preference 
829 and which is more simple to do.  It is pointless writing 8 lines of reject 
830 filters when 1 accept filter would do the same thing!  Each filter has 10 
831 lines (of any length) which are tried in order.  If a line matches then the 
832 action you have specified is taken (ie reject means ignore it and accept 
833 means take it)
834
835 <P>
836 If you specify reject filters, then any lines that arrive that match the filter 
837 will be dumped but all else will be accepted.  If you use an accept filter, 
838 then ONLY the lines in the filter will be accepted and all else will be dumped.
839 For example if you have a single line <em>accept</em> filter ...
840
841 <tscreen><verb>
842 accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
843 </verb></tscreen>
844
845 then you will <em>ONLY</em> get VHF spots <em>from</em> or <em>to</em> CQ zones 
846 14, 15 and 16.
847
848 <P>
849 If you set a reject filter like this ...
850
851 <tscreen><verb>
852 reject/spots on hf/cw
853 </verb></tscreen>
854
855 Then you will get everything <em>EXCEPT</em> HF CW spots.  You could make this 
856 single filter even more flexible.  For example, if you are interested in IOTA 
857 and will work it even on CW even though normally you are not interested in 
858 CW, then you could say ...
859
860 <tscreen><verb>
861 reject/spots on hf/cw and not info iota
862 </verb></tscreen>
863
864 But in that case you might only be interested in iota and say:-
865
866 <tscreen><verb>
867 accept/spots not on hf/cw or info iota
868 </verb></tscreen>
869
870 which achieves exactly the same thing. You should choose one or the other 
871 until you are comfortable with the way it works. You can mix them if you 
872 wish (actually you can have an accept AND a reject on the same line) but 
873 don't attempt this until you are sure you know what you are doing!
874
875 <P>
876 You can arrange your filter lines into logical units, either for your own
877 understanding or simply convenience. Here is an example ...
878
879 <tscreen><verb>
880 reject/spots 1 on hf/cw
881 reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
882 </verb></tscreen>
883
884 What this does is to ignore all HF CW spots and also rejects any spots on VHF 
885 which don't either originate or spot someone in Europe. 
886
887 <P>
888 This is an example where you would use a line number (1 and 2 in this case), if 
889 you leave the digit out, the system assumes '1'. Digits '0'-'9' are available.  
890 This make it easier to see just what filters you have set.  It also makes it 
891 more simple to remove individual filters, during a contest for example.
892
893 <P>
894 You will notice in the above example that the second line has brackets.  Look 
895 at the line logically.  You can see there are 2 separate sections to it.  We 
896 are saying reject spots that are VHF or above <em>APART</em> from those in 
897 zones 14, 15 and 16 (either spotted there or originated there).  If you did 
898 not have the brackets to separate the 2 sections, then Spider would read it 
899 logically from the front and see a different expression entirely ...
900
901 <tscreen><verb>
902 (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
903 </verb></tscreen>
904
905 The simple way to remember this is, if you use OR - use brackets. Whilst we are 
906 here CASE is not important. 'And BY_Zone' is just the same as 'and by_zone'.
907
908 As mentioned earlier, setting several filters can be more flexible than 
909 simply setting one complex one.  Doing it in this way means that if you want 
910 to alter your filter you can just redefine or remove one or more lines of it or 
911 one line. For example ...
912
913 <tscreen><verb>
914 reject/spots 1 on hf/ssb
915 </verb></tscreen>
916
917 would redefine our earlier example, or 
918
919 <tscreen><verb>
920 clear/spots 1
921 </verb></tscreen>
922
923 To remove all the filter lines in the spot filter ...
924
925 <tscreen><verb>
926 clear/spots all
927 </verb></tscreen>
928
929 <sect1>Filter options
930
931 <P>
932 You can filter in several different ways.  The options are listed in the
933 various helpfiles for accept, reject and filter.
934
935 <sect1>Advanced filtering
936
937 <P>
938 Once you are happy with the results you get, you may like to experiment. 
939
940 <P>
941 The previous example that filters hf/cw spots and accepts vhf/uhf spots from EU 
942 can be written with a mixed filter, for example ... 
943
944 <tscreen><verb>
945 rej/spot on hf/cw
946 acc/spot on 0/30000
947 acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
948 </verb></tscreen>
949
950 Note that the first filter has not been specified with a number.  This 
951 will automatically be assumed to be number 1.  In this case, we have 
952 said <em>reject all HF spots in the CW section of the bands but accept 
953 all others at HF.  Also accept anything in VHF and above spotted in or 
954 by operators in the zones 14, 15 and 16</em>.  Each filter slot actually 
955 has a 'reject' slot and an 'accept' slot. The reject slot is executed 
956 BEFORE the accept slot.
957
958 <P>
959 It was mentioned earlier that after a reject test that doesn't match, the 
960 default for following tests is 'accept', the reverse is true for 'accept'. 
961 In the example what happens is that the reject is executed first, any non 
962 hf/cw spot is passed to the accept line, which lets through everything 
963 else on HF.  The next filter line lets through just VHF/UHF spots from EU.
964
965 <sect1>A Filtering Tutorial
966
967 <P>
968 There is now an excellent primer/tutorial on filtering written by Jim
969 Samuels, W3BG with an introduction by Dave Hawes N3RD that I strongly
970 suggest you read.  You can read it here
971 <htmlurl url="filtering_en.html" name="The DXSpider User Filtering Primer">
972
973 <sect>Hints, tips and common questions.
974
975 <p>
976 <bf/Q./These commands seem very long!  Can I shorten them?
977
978 <bf/A./Of course you can and the usual abbreviations work.  If you
979 are unsure, try it. 
980
981 <bf/Q./I am not sure if this command is correct.  Can I cause any
982 harm if I try it?
983
984 <bf/A./Do not be afraid to try a command to see if it will work,
985 at the worst you will get an error message.  If you require any
986 help on a command, just type help followed by the command you
987 want help on.  Look at the "DXSpider Command Reference" section to see 
988 what help can be found.
989
990 <bf/Q./How should I use the announce command?
991
992 <bf/A./With respect.  Use the command by all means, but please
993 only use the "full" extension if absolutely necessary.  It can 
994 create a LOT of messages passing between clusters.
995
996 <bf/Q./I like to be working in the shack while logged into the
997 cluster but I can't be looking at the screen all the time. How
998 can I be alerted when anything happens?
999
1000 <bf/A./Use the <bf>SET/BEEP</bf> command.  You can find information 
1001 on this in the "DXSpider Command Reference" section.
1002
1003 <bf/Q./I got disconnected from the cluster and now I can't log
1004 back in again.  What is wrong?
1005
1006 <bf/A./Probably the cluster thinks you are still logged on and
1007 will not let you reconnect using the same call to prevent loops.
1008 Try logging on again adding an ssid to your callsign as DXSpider
1009 treats G0YLM and G0YLM-1 as different users.
1010
1011 <bf/Q./How do I know if I have got the latest version of this
1012 user manual?
1013
1014 <bf/A./The latest and greatest will always be on the Website.  It will
1015 also be included with every release of DXSpider.  As always, if unsure,
1016 ask your sysop what version number is the latest. 
1017
1018 <sect>The DXSpider Command Reference
1019
1020 <sect1>accept
1021
1022 <P>
1023 <tt>
1024 <bf>accept</bf> Set a filter to accept something
1025 </tt>
1026
1027 <P>
1028 Create a filter to accept something
1029
1030 There are 2 types of filter, accept and reject.  See HELP FILTERING for more
1031 info.
1032 <sect1>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;
1033
1034 <P>
1035 <tt>
1036 <bf>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an 'accept' filter line for announce
1037 </tt>
1038
1039 <P>
1040 Create an 'accept this announce' line for a filter. 
1041
1042 An accept filter line means that if the announce matches this filter it is
1043 passed onto the user. See HELP FILTERING for more info. Please read this
1044 to understand how filters work - it will save a lot of grief later on.
1045
1046 You can use any of the following things in this line:-
1047
1048 <tscreen><verb>
1049   info &lt;string&gt;            eg: iota or qsl
1050   by &lt;prefixes&gt;            eg: G,M,2         
1051   origin &lt;prefixes&gt;
1052   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1053   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1054   origin_zone &lt;prefixes or numbers&gt;
1055   origin_state &lt;states&gt;                eg: VA,NH,RI,NH
1056   by_dxcc &lt;prefixes or numbers&gt;
1057   by_itu &lt;prefixes or numbers&gt;
1058   by_zone &lt;prefixes or numbers&gt;
1059   by_state &lt;states&gt;
1060   channel &lt;prefixes&gt;
1061   wx 1                     filter WX announces
1062   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
1063 </verb></tscreen>
1064
1065 some examples:-
1066
1067 <tscreen><verb>
1068   acc/ann dest 6MUK
1069   acc/ann 2 by_zone 14,15,16
1070   (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
1071 </verb></tscreen>
1072 or
1073 <tscreen><verb>
1074   acc/ann by G,M,2 
1075 </verb></tscreen>
1076
1077 for american states
1078
1079 <tscreen><verb>
1080   acc/ann by_state va,nh,ri,nh
1081 </verb></tscreen>
1082
1083 You can use the tag 'all' to accept everything eg:
1084
1085 <tscreen><verb>
1086   acc/ann all
1087 </verb></tscreen>
1088
1089 but this probably for advanced users...
1090 <sect1>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;
1091
1092 <P>
1093 <tt>
1094 <bf>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an 'accept' filter line for spots
1095 </tt>
1096
1097 <P>
1098 Create an 'accept this spot' line for a filter. 
1099
1100 An accept filter line means that if the spot matches this filter it is
1101 passed onto the user. See HELP FILTERING for more info. Please read this
1102 to understand how filters work - it will save a lot of grief later on.
1103
1104 You can use any of the following things in this line:-
1105
1106 <tscreen><verb>
1107   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
1108   on &lt;range&gt;             same as 'freq'
1109   call &lt;prefixes&gt;        eg: G,PA,HB9
1110   info &lt;string&gt;          eg: iota or qsl
1111   by &lt;prefixes&gt;            
1112   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1113   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1114   call_zone &lt;prefixes or numbers&gt;
1115   call_state &lt;states&gt;                eg: VA,NH,RI,ME
1116   by_dxcc &lt;prefixes or numbers&gt;
1117   by_itu &lt;prefixes or numbers&gt;
1118   by_zone &lt;prefixes or numbers&gt;
1119   by_state &lt;states&gt;                eg: VA,NH,RI,ME
1120   origin &lt;prefixes&gt;
1121   channel &lt;prefixes&gt;
1122 </verb></tscreen>
1123
1124 'call' means the callsign that has spotted 'by' whoever.
1125
1126 For frequencies, you can use any of the band names defined in
1127 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
1128 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
1129 this is more efficient than saying simply: freq HF (but don't get
1130 too hung up about that)
1131
1132 some examples:-
1133
1134 <tscreen><verb>
1135   acc/spot 1 on hf/cw
1136   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1137 </verb></tscreen>
1138
1139 You can use the tag 'all' to accept everything, eg:
1140
1141 <tscreen><verb>
1142   acc/spot 3 all
1143 </verb></tscreen>
1144
1145 for US states 
1146
1147 <tscreen><verb>
1148   acc/spots by_state VA,NH,RI,MA,ME
1149 </verb></tscreen>
1150
1151 but this probably for advanced users...
1152 <sect1>accept/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;
1153
1154 <P>
1155 <tt>
1156 <bf>accept/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set an 'accept' WCY filter
1157 </tt>
1158
1159 <P>
1160 It is unlikely that you will want to do this, but if you do then you can
1161 filter on the following fields:-
1162
1163 <tscreen><verb>
1164   by &lt;prefixes&gt;            eg: G,M,2         
1165   origin &lt;prefixes&gt;
1166   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1167   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1168   origin_zone &lt;prefixes or numbers&gt;
1169   by_dxcc &lt;prefixes or numbers&gt;
1170   by_itu &lt;prefixes or numbers&gt;
1171   by_zone &lt;prefixes or numbers&gt;
1172   channel &lt;prefixes&gt;
1173 </verb></tscreen>
1174
1175 There are no examples because WCY Broadcasts only come from one place and
1176 you either want them or not (see UNSET/WCY if you don't want them).
1177
1178 This command is really provided for future use.
1179
1180 See HELP FILTER for information.
1181 <sect1>accept/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;
1182
1183 <P>
1184 <tt>
1185 <bf>accept/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set an 'accept' WWV filter
1186 </tt>
1187
1188 <P>
1189 It is unlikely that you will want to do this, but if you do then you can
1190 filter on the following fields:-
1191
1192 <tscreen><verb>
1193   by &lt;prefixes&gt;            eg: G,M,2         
1194   origin &lt;prefixes&gt;
1195   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1196   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1197   origin_zone &lt;prefixes or numbers&gt;
1198   by_dxcc &lt;prefixes or numbers&gt;
1199   by_itu &lt;prefixes or numbers&gt;
1200   by_zone &lt;prefixes or numbers&gt;
1201   channel &lt;prefixes&gt;
1202 </verb></tscreen>
1203
1204 for example 
1205
1206 <tscreen><verb>
1207   accept/wwv by_zone 4
1208 </verb></tscreen>
1209
1210 is probably the only useful thing to do (which will only show WWV broadcasts
1211 by stations in the US).
1212
1213 See HELP FILTER for information.
1214 <sect1>announce &lt;text&gt;
1215
1216 <P>
1217 <tt>
1218 <bf>announce &lt;text&gt;</bf> Send an announcement to LOCAL users only
1219 </tt>
1220
1221 <P>
1222 &lt;text&gt; is the text of the announcement you wish to broadcast 
1223 <sect1>announce full &lt;text&gt;
1224
1225 <P>
1226 <tt>
1227 <bf>announce full &lt;text&gt;</bf> Send an announcement cluster wide
1228 </tt>
1229
1230 <P>
1231 This will send your announcement cluster wide
1232 <sect1>apropos &lt;string&gt;
1233
1234 <P>
1235 <tt>
1236 <bf>apropos &lt;string&gt;</bf> Search help database for &lt;string&gt;
1237 </tt>
1238
1239 <P>
1240 Search the help database for &lt;string&gt; (it isn't case sensitive), and print
1241 the names of all the commands that may be relevant.
1242 <sect1>blank &lsqb;&lt;string&gt;&rsqb; &lsqb;&lt;nn&gt;&rsqb;
1243
1244 <P>
1245 <tt>
1246 <bf>blank &lsqb;&lt;string&gt;&rsqb; &lsqb;&lt;nn&gt;&rsqb;</bf> Print nn (default 1) blank lines (or strings)
1247 </tt>
1248
1249 <P>
1250 In its basic form this command prints one or more blank lines. However if
1251 you pass it a string it will replicate the string for the width of the 
1252 screen (default 80) and then print that one or more times, so:
1253
1254 <tscreen><verb>
1255   blank 2
1256 </verb></tscreen>
1257
1258 prints two blank lines
1259
1260 <tscreen><verb>
1261   blank - 
1262 </verb></tscreen>
1263
1264 prints a row of - characters once.
1265
1266 <tscreen><verb>
1267   blank abc
1268 </verb></tscreen>
1269
1270 prints 'abcabcabcabcabcabc....'
1271
1272 This is really only of any use in a script file and you can print a maximum
1273 of 9 lines.
1274 <sect1>bye
1275
1276 <P>
1277 <tt>
1278 <bf>bye</bf> Exit from the cluster
1279 </tt>
1280
1281 <P>
1282 This will disconnect you from the cluster
1283 <sect1>chat &lt;group&gt; &lt;text&gt;
1284
1285 <P>
1286 <tt>
1287 <bf>chat &lt;group&gt; &lt;text&gt;</bf> Chat or Conference to a group
1288 </tt>
1289
1290 <P>
1291 It is now possible to JOIN a group and have network wide conferencing to that
1292 group. DXSpider does not (and probably will not) implement the AK1A 
1293 conference mode as this seems very limiting, is hardly used and doesn't seem
1294 to work too well anyway.
1295
1296 This system uses the existing ANN system and is compatible with both other
1297 DXSpider nodes and AK1A clusters (they use ANN/&lt;group&gt;). 
1298
1299 You can be a member of as many "groups" as you want. To join a group type:-
1300
1301 <tscreen><verb>
1302   JOIN FOC    (where FOC is the group name)
1303 </verb></tscreen>
1304
1305 To leave a group type:-
1306
1307 <tscreen><verb>
1308   LEAVE FOC
1309 </verb></tscreen>
1310
1311 You can see which groups you are in by typing:-
1312
1313 <tscreen><verb>
1314   STAT/USER
1315 </verb></tscreen>
1316
1317 and you can see whether your mate is in the group, if he connects to the
1318 same node as you, by typing:-
1319
1320 <tscreen><verb>
1321   STAT/USER g1tlh
1322 </verb></tscreen>
1323
1324 To send a message to a group type:-
1325
1326 <tscreen><verb>
1327   CHAT FOC hello everyone
1328 </verb></tscreen>
1329
1330 or
1331
1332 <tscreen><verb>
1333   CH #9000 hello I am back
1334 </verb></tscreen>
1335
1336 See also JOIN, LEAVE, SHOW/CHAT
1337 <sect1>clear/announce &lsqb;1|all&rsqb;
1338
1339 <P>
1340 <tt>
1341 <bf>clear/announce &lsqb;1|all&rsqb;</bf> Clear a announce filter line
1342 </tt>
1343
1344 <P>
1345 This command allows you to clear (remove) a line in a annouce filter or to 
1346 remove the whole filter.
1347
1348 see CLEAR/SPOTS for a more detailed explanation.
1349 <sect1>clear/route &lsqb;1|all&rsqb;
1350
1351 <P>
1352 <tt>
1353 <bf>clear/route &lsqb;1|all&rsqb;</bf> Clear a route filter line
1354 </tt>
1355
1356 <P>
1357 This command allows you to clear (remove) a line in a route filter or to 
1358 remove the whole filter.
1359
1360 see CLEAR/SPOTS for a more detailed explanation.
1361 <sect1>clear/spots &lsqb;0-9|all&rsqb;
1362
1363 <P>
1364 <tt>
1365 <bf>clear/spots &lsqb;0-9|all&rsqb;</bf> Clear a spot filter line
1366 </tt>
1367
1368 <P>
1369 This command allows you to clear (remove) a line in a spot filter or to 
1370 remove the whole filter.
1371
1372 If you have a filter:-
1373
1374 <tscreen><verb>
1375   acc/spot 1 on hf/cw
1376   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1377 </verb></tscreen>
1378
1379 and you say:-
1380
1381 <tscreen><verb>
1382   clear/spot 1
1383 </verb></tscreen>
1384
1385 you will be left with:-
1386
1387 <tscreen><verb>
1388   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1389 </verb></tscreen>
1390
1391 If you do:
1392
1393 <tscreen><verb>
1394   clear/spot all
1395 </verb></tscreen>
1396
1397 the filter will be completely removed.
1398 <sect1>clear/wcy &lsqb;1|all&rsqb;
1399
1400 <P>
1401 <tt>
1402 <bf>clear/wcy &lsqb;1|all&rsqb;</bf> Clear a WCY filter line
1403 </tt>
1404
1405 <P>
1406 This command allows you to clear (remove) a line in a WCY filter or to 
1407 remove the whole filter.
1408
1409 see CLEAR/SPOTS for a more detailed explanation.
1410 <sect1>clear/wwv &lsqb;1|all&rsqb;
1411
1412 <P>
1413 <tt>
1414 <bf>clear/wwv &lsqb;1|all&rsqb;</bf> Clear a WWV filter line
1415 </tt>
1416
1417 <P>
1418 This command allows you to clear (remove) a line in a WWV filter or to 
1419 remove the whole filter.
1420
1421 see CLEAR/SPOTS for a more detailed explanation.
1422 <sect1>dbavail
1423
1424 <P>
1425 <tt>
1426 <bf>dbavail</bf> Show a list of all the Databases in the system
1427 </tt>
1428
1429 <P>
1430 Title says it all really, this command lists all the databases defined
1431 in the system. It is also aliased to SHOW/COMMAND.
1432 <sect1>dbshow &lt;dbname&gt; &lt;key&gt;
1433
1434 <P>
1435 <tt>
1436 <bf>dbshow &lt;dbname&gt; &lt;key&gt;</bf> Display an entry, if it exists, in a database
1437 </tt>
1438
1439 <P>
1440 This is the generic user interface to the database to the database system.
1441 It is expected that the sysop will add an entry to the local Aliases file
1442 so that users can use the more familiar AK1A style of enquiry such as:
1443
1444 <tscreen><verb>
1445   SH/BUCK G1TLH
1446 </verb></tscreen>
1447
1448 but if he hasn't and the database really does exist (use DBAVAIL or
1449 SHOW/COMMAND to find out) you can do the same thing with:
1450
1451 <tscreen><verb>
1452   DBSHOW buck G1TLH
1453 </verb></tscreen>
1454
1455 <sect1>directory
1456
1457 <P>
1458 <tt>
1459 <bf>directory</bf> List messages 
1460 </tt>
1461
1462 <P>
1463 <sect1>directory &lt;from&gt;-&lt;to&gt;
1464
1465 <P>
1466 <tt>
1467 <bf>directory &lt;from&gt;-&lt;to&gt;</bf> List messages &lt;from&gt; message &lt;to&gt; message 
1468 </tt>
1469
1470 <P>
1471 List the messages in the messages directory.
1472
1473 If there is a 'p' one space after the message number then it is a 
1474 personal message. If there is a '-' between the message number and the
1475 'p' then this indicates that the message has been read.
1476
1477 You can use shell escape characters such as '*' and '?' in the &lt;call&gt;
1478 fields.
1479
1480 You can combine some of the various directory commands together eg:-
1481
1482 <tscreen><verb>
1483    DIR TO G1TLH 5
1484 </verb></tscreen>
1485 or 
1486 <tscreen><verb>
1487    DIR SUBJECT IOTA 200-250
1488 </verb></tscreen>
1489
1490 You can abbreviate all the commands to one letter and use ak1a syntax:-
1491
1492 <tscreen><verb>
1493    DIR/T G1* 10
1494    DIR/S QSL 10-100 5
1495 </verb></tscreen>
1496
1497 <sect1>directory &lt;nn&gt;
1498
1499 <P>
1500 <tt>
1501 <bf>directory &lt;nn&gt;</bf> List last &lt;nn&gt; messages
1502 </tt>
1503
1504 <P>
1505 <sect1>directory all
1506
1507 <P>
1508 <tt>
1509 <bf>directory all</bf> List all messages
1510 </tt>
1511
1512 <P>
1513 <sect1>directory from &lt;call&gt;
1514
1515 <P>
1516 <tt>
1517 <bf>directory from &lt;call&gt;</bf> List all messages from &lt;call&gt;
1518 </tt>
1519
1520 <P>
1521 <sect1>directory new
1522
1523 <P>
1524 <tt>
1525 <bf>directory new</bf> List all new messages
1526 </tt>
1527
1528 <P>
1529 <sect1>directory own
1530
1531 <P>
1532 <tt>
1533 <bf>directory own</bf> List your own messages
1534 </tt>
1535
1536 <P>
1537 <sect1>directory subject &lt;string&gt;
1538
1539 <P>
1540 <tt>
1541 <bf>directory subject &lt;string&gt;</bf> List all messages with &lt;string&gt; in subject
1542 </tt>
1543
1544 <P>
1545 <sect1>directory to &lt;call&gt;
1546
1547 <P>
1548 <tt>
1549 <bf>directory to &lt;call&gt;</bf> List all messages to &lt;call&gt;
1550 </tt>
1551
1552 <P>
1553 <sect1>dx &lsqb;by &lt;call&gt;&rsqb; &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;
1554
1555 <P>
1556 <tt>
1557 <bf>dx &lsqb;by &lt;call&gt;&rsqb; &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</bf> Send a DX spot
1558 </tt>
1559
1560 <P>
1561 This is how you send a DX Spot to other users. You can, in fact, now
1562 enter the &lt;freq&gt; and the &lt;call&gt; either way round. 
1563
1564 <tscreen><verb>
1565    DX FR0G 144.600
1566    DX 144.600 FR0G
1567    DX 144600 FR0G 
1568 </verb></tscreen>
1569
1570 will all give the same result. You can add some remarks to the end
1571 of the command and they will be added to the spot.
1572
1573 <tscreen><verb>
1574    DX FR0G 144600 this is a test
1575 </verb></tscreen>
1576
1577 You can credit someone else by saying:-
1578
1579 <tscreen><verb>
1580    DX by G1TLH FR0G 144.600 he isn't on the cluster
1581 </verb></tscreen>
1582
1583 The &lt;freq&gt; is compared against the available bands set up in the 
1584 cluster.  See SHOW/BANDS for more information.
1585 <sect1>echo &lt;line&gt;
1586
1587 <P>
1588 <tt>
1589 <bf>echo &lt;line&gt;</bf> Echo the line to the output
1590 </tt>
1591
1592 <P>
1593 This command is useful in scripts and so forth for printing the
1594 line that you give to the command to the output. You can use this
1595 in user_default scripts and the SAVE command for titling and so forth
1596
1597 The script will interpret certain standard "escape" sequences as follows:-
1598
1599 <tscreen><verb>
1600   \t - becomes a TAB character (0x09 in ascii)
1601   \a - becomes a BEEP character (0x07 in ascii)
1602   \n - prints a new line
1603 </verb></tscreen>
1604
1605 So the following example:-
1606
1607 <tscreen><verb>
1608   echo GB7DJK is a dxcluster
1609 </verb></tscreen>
1610
1611 produces:-
1612
1613 <tscreen><verb>
1614   GB7DJK is a dxcluster
1615 </verb></tscreen>
1616
1617 on the output. You don't need a \n on the end of the line you want to send.
1618
1619 A more complex example:-
1620
1621 <tscreen><verb>
1622   echo GB7DJK\n\tg1tlh\tDirk\n\tg3xvf\tRichard
1623 </verb></tscreen>
1624
1625 produces:-
1626
1627 <tscreen><verb>
1628   GB7DJK
1629           g1tlh   Dirk
1630           g3xvf   Richard
1631 </verb></tscreen>
1632
1633 on the output.
1634                                       
1635 <sect1>filtering...
1636
1637 <P>
1638 <tt>
1639 <bf>filtering...</bf> Filtering things in DXSpider
1640 </tt>
1641
1642 <P>
1643 There are a number of things you can filter in the DXSpider system. They
1644 all use the same general mechanism.
1645
1646 In general terms you can create a 'reject' or an 'accept' filter which
1647 can have up to 10 lines in it. You do this using, for example:-
1648  
1649 <tscreen><verb>
1650   accept/spots .....
1651   reject/spots .....
1652 </verb></tscreen>
1653
1654 where ..... are the specific commands for that type of filter. There
1655 are filters for spots, wwv, announce, wcy and (for sysops)
1656 connects. See each different accept or reject command reference for
1657 more details.
1658
1659 There is also a command to clear out one or more lines in a filter and
1660 one to show you what you have set. They are:-
1661
1662 <tscreen><verb>
1663   clear/spots 1
1664   clear/spots all
1665 </verb></tscreen>
1666
1667 and 
1668   
1669 <tscreen><verb>
1670   show/filter
1671 </verb></tscreen>
1672
1673 There is clear/xxxx command for each type of filter.
1674
1675 For now we are going to use spots for the examples, but you can apply
1676 the principles to all types of filter.
1677
1678 There are two main types of filter 'accept' or 'reject'; which you use
1679 depends entirely on how you look at the world and what is least
1680 writing to achieve what you want. Each filter has 10 lines (of any
1681 length) which are tried in order. If a line matches then the action
1682 you have specified is taken (ie reject means ignore it and accept
1683 means gimme it).
1684
1685 The important thing to remember is that if you specify a 'reject'
1686 filter (all the lines in it say 'reject/spots' (for instance)) then if
1687 a spot comes in that doesn't match any of the lines then you will get
1688 it BUT if you specify an 'accept' filter then any spots that don't
1689 match are dumped. For example if I have a one line accept filter:-
1690
1691 <tscreen><verb>
1692   accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1693 </verb></tscreen>
1694
1695 then automatically you will ONLY get VHF spots from or to CQ zones 14
1696 15 and 16.  If you set a reject filter like:
1697
1698 <tscreen><verb>
1699   reject/spots on hf/cw
1700 </verb></tscreen>
1701
1702 Then you will get everything EXCEPT HF CW spots, If you am interested in IOTA
1703 and will work it even on CW then you could say:-
1704
1705 <tscreen><verb>
1706   reject/spots on hf/cw and not info iota
1707 </verb></tscreen>
1708
1709 But in that case you might only be interested in iota and say:-
1710
1711 <tscreen><verb>
1712   accept/spots not on hf/cw or info iota
1713 </verb></tscreen>
1714
1715 which is exactly the same. You should choose one or the other until
1716 you are confortable with the way it works. Yes, you can mix them
1717 (actually you can have an accept AND a reject on the same line) but
1718 don't try this at home until you can analyse the results that you get
1719 without ringing up the sysop for help.
1720
1721 Another useful addition now is filtering by US state
1722
1723 <tscreen><verb>
1724   accept/spots by_state VA,NH,RI,ME
1725 </verb></tscreen>
1726
1727 You can arrange your filter lines into logical units, either for your
1728 own understanding or simply convenience. I have one set frequently:-
1729
1730 <tscreen><verb>
1731   reject/spots 1 on hf/cw
1732   reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
1733 </verb></tscreen>
1734
1735 What this does is to ignore all HF CW spots (being a class B I can't
1736 read any CW and couldn't possibly be interested in HF :-) and also
1737 rejects any spots on VHF which don't either originate or spot someone
1738 in Europe.
1739
1740 This is an exmaple where you would use the line number (1 and 2 in
1741 this case), if you leave the digit out, the system assumes '1'. Digits
1742 '0'-'9' are available.
1743
1744 You can leave the word 'and' out if you want, it is implied. You can
1745 use any number of brackets to make the 'expression' as you want
1746 it. There are things called precedence rules working here which mean
1747 that you will NEED brackets in a situation like line 2 because,
1748 without it, will assume:-
1749
1750 <tscreen><verb>
1751   (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
1752 </verb></tscreen>
1753
1754 annoying, but that is the way it is. If you use OR - use
1755 brackets. Whilst we are here CASE is not important. 'And BY_Zone' is
1756 just 'and by_zone'.
1757
1758 If you want to alter your filter you can just redefine one or more
1759 lines of it or clear out one line. For example:-
1760
1761 <tscreen><verb>
1762   reject/spots 1 on hf/ssb
1763 </verb></tscreen>
1764
1765 or 
1766
1767 <tscreen><verb>
1768   clear/spots 1
1769 </verb></tscreen>
1770
1771 To remove the filter in its entirty:-
1772
1773 <tscreen><verb>
1774   clear/spots all
1775 </verb></tscreen>
1776
1777 There are similar CLEAR commands for the other filters:-
1778
1779 <tscreen><verb>
1780   clear/announce
1781   clear/wcy
1782   clear/wwv
1783 </verb></tscreen>
1784
1785 ADVANCED USERS:-
1786
1787 Once you are happy with the results you get, you may like to experiment. 
1788
1789 my example that filters hf/cw spots and accepts vhf/uhf spots from EU
1790 can be written with a mixed filter, eg:
1791
1792 <tscreen><verb>
1793   rej/spot on hf/cw
1794   acc/spot on 0/30000
1795   acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
1796 </verb></tscreen>
1797
1798 each filter slot actually has a 'reject' slot and an 'accept'
1799 slot. The reject slot is executed BEFORE the accept slot.
1800
1801 It was mentioned earlier that after a reject test that doesn't match,
1802 the default for following tests is 'accept', the reverse is true for
1803 'accept'. In the example what happens is that the reject is executed
1804 first, any non hf/cw spot is passed to the accept line, which lets
1805 thru everything else on HF.
1806
1807 The next filter line lets through just VHF/UHF spots from EU.
1808 <sect1>help
1809
1810 <P>
1811 <tt>
1812 <bf>help</bf> The HELP Command
1813 </tt>
1814
1815 <P>
1816 HELP is available for a number of commands. The syntax is:-
1817
1818 <tscreen><verb>
1819   HELP &lt;cmd&gt;
1820 </verb></tscreen>
1821   
1822 Where &lt;cmd&gt; is the name of the command you want help on.
1823
1824 All commands can be abbreviated, so SHOW/DX can be abbreviated
1825 to SH/DX, ANNOUNCE can be shortened to AN and so on.
1826
1827 Look at the APROPOS &lt;string&gt; command which will search the help database
1828 for the &lt;string&gt; you specify and give you a list of likely commands
1829 to look at with HELP.
1830 <sect1>join &lt;group&gt;
1831
1832 <P>
1833 <tt>
1834 <bf>join &lt;group&gt;</bf> Join a chat or conference group
1835 </tt>
1836
1837 <P>
1838 JOIN allows you to join a network wide conference group. To join a
1839 group (called FOC in this case) type:-
1840
1841 <tscreen><verb>
1842   JOIN FOC
1843 </verb></tscreen>
1844
1845 See also CHAT, LEAVE, SHOW/CHAT
1846 <sect1>kill &lt;from msgno&gt;-&lt;to msgno&gt;
1847
1848 <P>
1849 <tt>
1850 <bf>kill &lt;from msgno&gt;-&lt;to msgno&gt;</bf> Delete a range of messages
1851 </tt>
1852
1853 <P>
1854 <sect1>kill &lt;msgno&gt; &lsqb;&lt;msgno..&rsqb;
1855
1856 <P>
1857 <tt>
1858 <bf>kill &lt;msgno&gt; &lsqb;&lt;msgno..&rsqb;</bf> Delete a message from the local system
1859 </tt>
1860
1861 <P>
1862 <sect1>kill &lt;msgno&gt; &lsqb;&lt;msgno&gt; ...&rsqb;
1863
1864 <P>
1865 <tt>
1866 <bf>kill &lt;msgno&gt; &lsqb;&lt;msgno&gt; ...&rsqb;</bf> Remove or erase a message from the system
1867 </tt>
1868
1869 <P>
1870 You can get rid of any message to or originating from your callsign using 
1871 this command. You can remove more than one message at a time.
1872 <sect1>kill from &lt;regex&gt;
1873
1874 <P>
1875 <tt>
1876 <bf>kill from &lt;regex&gt;</bf> Delete messages FROM a callsign or pattern
1877 </tt>
1878
1879 <P>
1880 <sect1>kill to &lt;regex&gt;
1881
1882 <P>
1883 <tt>
1884 <bf>kill to &lt;regex&gt;</bf> Delete messages TO a callsign or pattern
1885 </tt>
1886
1887 <P>
1888 <sect1>leave &lt;group&gt;
1889
1890 <P>
1891 <tt>
1892 <bf>leave &lt;group&gt;</bf> Leave a chat or conference group
1893 </tt>
1894
1895 <P>
1896 LEAVE allows you to leave a network wide conference group. To leave a
1897 group (called FOC in this case) type:-
1898
1899 <tscreen><verb>
1900   LEAVE FOC
1901 </verb></tscreen>
1902
1903 See also CHAT, JOIN, SHOW/CHAT
1904 <sect1>links
1905
1906 <P>
1907 <tt>
1908 <bf>links</bf> Show which nodes is physically connected
1909 </tt>
1910
1911 <P>
1912 This is a quick listing that shows which links are connected and
1913 some information about them. See WHO for a list of all connections.
1914 <sect1>read
1915
1916 <P>
1917 <tt>
1918 <bf>read</bf> Read the next unread personal message addressed to you
1919 </tt>
1920
1921 <P>
1922 <sect1>read &lt;msgno&gt;
1923
1924 <P>
1925 <tt>
1926 <bf>read &lt;msgno&gt;</bf> Read the specified message
1927 </tt>
1928
1929 <P>
1930 You can read any messages that are sent as 'non-personal' and also any
1931 message either sent by or sent to your callsign.
1932 <sect1>reject
1933
1934 <P>
1935 <tt>
1936 <bf>reject</bf> Set a filter to reject something
1937 </tt>
1938
1939 <P>
1940 Create a filter to reject something
1941
1942 There are 2 types of filter, accept and reject.  See HELP FILTERING for more
1943 info.
1944 <sect1>reject/announce &lsqb;0-9&rsqb; &lt;pattern&gt;
1945
1946 <P>
1947 <tt>
1948 <bf>reject/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a 'reject' filter line for announce
1949 </tt>
1950
1951 <P>
1952 Create an 'reject this announce' line for a filter. 
1953
1954 A reject filter line means that if the announce matches this filter it is
1955 passed onto the user. See HELP FILTERING for more info. Please read this
1956 to understand how filters work - it will save a lot of grief later on.
1957
1958 You can use any of the following things in this line:-
1959
1960 <tscreen><verb>
1961   info &lt;string&gt;            eg: iota or qsl
1962   by &lt;prefixes&gt;            eg: G,M,2         
1963   origin &lt;prefixes&gt;
1964   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1965   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1966   origin_zone &lt;prefixes or numbers&gt;
1967   origin_state &lt;states&gt;                eg: VA,NH,RI,ME
1968   by_dxcc &lt;prefixes or numbers&gt;
1969   by_itu &lt;prefixes or numbers&gt;
1970   by_zone &lt;prefixes or numbers&gt;
1971   by_state &lt;states&gt;                eg: VA,NH,RI,ME
1972   channel &lt;prefixes&gt;
1973   wx 1                     filter WX announces
1974   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
1975 </verb></tscreen>
1976
1977 some examples:-
1978
1979 <tscreen><verb>
1980   rej/ann by_zone 14,15,16 and not by G,M,2
1981 </verb></tscreen>
1982  
1983 You can use the tag 'all' to reject everything eg:
1984
1985 <tscreen><verb>
1986   rej/ann all
1987 </verb></tscreen>
1988
1989 but this probably for advanced users...
1990 <sect1>reject/spots &lsqb;0-9&rsqb; &lt;pattern&gt;
1991
1992 <P>
1993 <tt>
1994 <bf>reject/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a 'reject' filter line for spots
1995 </tt>
1996
1997 <P>
1998 Create a 'reject this spot' line for a filter. 
1999
2000 A reject filter line means that if the spot matches this filter it is
2001 dumped (not passed on). See HELP FILTERING for more info. Please read this
2002 to understand how filters work - it will save a lot of grief later on.
2003
2004 You can use any of the following things in this line:-
2005
2006 <tscreen><verb>
2007   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
2008   on &lt;range&gt;             same as 'freq'
2009   call &lt;prefixes&gt;        eg: G,PA,HB9
2010   info &lt;string&gt;          eg: iota or qsl
2011   by &lt;prefixes&gt;            
2012   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2013   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2014   call_zone &lt;prefixes or numbers&gt;
2015   call_state &lt;states&gt;                eg: VA,NH,RI,ME
2016   by_dxcc &lt;prefixes or numbers&gt;
2017   by_itu &lt;prefixes or numbers&gt;
2018   by_zone &lt;prefixes or numbers&gt;
2019   by_state &lt;states&gt;                eg: VA,NH,RI,ME
2020   origin &lt;prefixes&gt;
2021   channel &lt;prefixes&gt;
2022 </verb></tscreen>
2023
2024 'call' means the callsign that has spotted 'by' whoever.
2025  
2026 For frequencies, you can use any of the band names defined in
2027 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
2028 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
2029 this is more efficient than saying simply: on HF (but don't get
2030 too hung up about that)
2031
2032 some examples:-
2033
2034 <tscreen><verb>
2035   rej/spot 1 on hf
2036   rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
2037 </verb></tscreen>
2038
2039 You can use the tag 'all' to reject everything eg:
2040
2041 <tscreen><verb>
2042   rej/spot 3 all
2043 </verb></tscreen>
2044
2045 but this probably for advanced users...
2046 <sect1>reject/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;
2047
2048 <P>
2049 <tt>
2050 <bf>reject/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set a 'reject' WCY filter
2051 </tt>
2052
2053 <P>
2054 It is unlikely that you will want to do this, but if you do then you can
2055 filter on the following fields:-
2056
2057 <tscreen><verb>
2058   by &lt;prefixes&gt;            eg: G,M,2         
2059   origin &lt;prefixes&gt;
2060   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2061   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2062   origin_zone &lt;prefixes or numbers&gt;
2063   by_dxcc &lt;prefixes or numbers&gt;
2064   by_itu &lt;prefixes or numbers&gt;
2065   by_zone &lt;prefixes or numbers&gt;
2066   channel &lt;prefixes&gt;
2067 </verb></tscreen>
2068
2069 There are no examples because WCY Broadcasts only come from one place and
2070 you either want them or not (see UNSET/WCY if you don't want them).
2071
2072 This command is really provided for future use.
2073
2074 See HELP FILTER for information.
2075 <sect1>reject/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;
2076
2077 <P>
2078 <tt>
2079 <bf>reject/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set a 'reject' WWV filter
2080 </tt>
2081
2082 <P>
2083 It is unlikely that you will want to do this, but if you do then you can
2084 filter on the following fields:-
2085
2086 <tscreen><verb>
2087   by &lt;prefixes&gt;            eg: G,M,2         
2088   origin &lt;prefixes&gt;
2089   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2090   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2091   origin_zone &lt;prefixes or numbers&gt;
2092   by_dxcc &lt;prefixes or numbers&gt;
2093   by_itu &lt;prefixes or numbers&gt;
2094   by_zone &lt;prefixes or numbers&gt;
2095   channel &lt;prefixes&gt;
2096 </verb></tscreen>
2097
2098 for example 
2099
2100 <tscreen><verb>
2101   reject/wwv by_zone 14,15,16
2102 </verb></tscreen>
2103
2104 is probably the only useful thing to do (which will only show WWV broadcasts
2105 by stations in the US).
2106
2107 See HELP FILTER for information.
2108 <sect1>reply
2109
2110 <P>
2111 <tt>
2112 <bf>reply</bf> Reply (privately) to the last message that you have read
2113 </tt>
2114
2115 <P>
2116 <sect1>reply &lt;msgno&gt;
2117
2118 <P>
2119 <tt>
2120 <bf>reply &lt;msgno&gt;</bf> Reply (privately) to the specified message
2121 </tt>
2122
2123 <P>
2124 <sect1>reply b &lt;msgno&gt;
2125
2126 <P>
2127 <tt>
2128 <bf>reply b &lt;msgno&gt;</bf> Reply as a Bulletin to the specified message
2129 </tt>
2130
2131 <P>
2132 <sect1>reply noprivate &lt;msgno&gt;
2133
2134 <P>
2135 <tt>
2136 <bf>reply noprivate &lt;msgno&gt;</bf> Reply as a Bulletin to the specified message
2137 </tt>
2138
2139 <P>
2140 <sect1>reply rr &lt;msgno&gt;
2141
2142 <P>
2143 <tt>
2144 <bf>reply rr &lt;msgno&gt;</bf> Reply to the specified message with read receipt
2145 </tt>
2146
2147 <P>
2148 You can reply to a message and the subject will automatically have
2149 "Re:" inserted in front of it, if it isn't already present.
2150
2151 You can also use all the extra qualifiers such as RR, PRIVATE, 
2152 NOPRIVATE, B that you can use with the SEND command (see SEND
2153 for further details)
2154 <sect1>send &lt;call&gt; &lsqb;&lt;call&gt; ...&rsqb;
2155
2156 <P>
2157 <tt>
2158 <bf>send &lt;call&gt; &lsqb;&lt;call&gt; ...&rsqb;</bf> Send a message to one or more callsigns
2159 </tt>
2160
2161 <P>
2162 <sect1>send copy &lt;msgno&gt; &lt;call&gt;
2163
2164 <P>
2165 <tt>
2166 <bf>send copy &lt;msgno&gt; &lt;call&gt;</bf> Send a copy of a  message to someone
2167 </tt>
2168
2169 <P>
2170 <sect1>send noprivate &lt;call&gt;
2171
2172 <P>
2173 <tt>
2174 <bf>send noprivate &lt;call&gt;</bf> Send a message to all stations
2175 </tt>
2176
2177 <P>
2178 All the SEND commands will create a message which will be sent either to
2179 an individual callsign or to one of the 'bulletin' addresses. 
2180
2181 SEND &lt;call&gt; on its own acts as though you had typed SEND PRIVATE, that is
2182 it will mark the message as personal and send it to the cluster node that
2183 that callsign is connected to. If the &lt;call&gt; you have specified is in fact
2184 a known bulletin category on your node (eg: ALL) then the message should
2185 automatically become a bulletin.
2186
2187 You can have more than one callsign in all of the SEND commands.
2188
2189 You can have multiple qualifiers so that you can have for example:-
2190
2191 <tscreen><verb>
2192   SEND RR COPY 123 PRIVATE G1TLH G0RDI
2193 </verb></tscreen>
2194
2195 which should send a copy of message 123 to G1TLH and G0RDI and you will
2196 receive a read receipt when they have read the message.
2197
2198 SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
2199 SP is an alias for SEND PRIVATE
2200
2201 The system will ask you for a subject. Conventionally this should be 
2202 no longer than 29 characters for compatibility. Most modern cluster
2203 software should accept more.
2204
2205 You will now be prompted to start entering your text. 
2206
2207 You finish the message by entering '/EX' on a new line. For instance:
2208
2209 <tscreen><verb>
2210   ...
2211   bye then Jim
2212   73 Dirk
2213   /ex
2214 </verb></tscreen>
2215
2216 If you have started a message and you don't want to keep it then you
2217 can abandon the message with '/ABORT' on a new line, like:-
2218
2219 <tscreen><verb>
2220   line 1
2221   line 2
2222   oh I just can't be bothered with this
2223   /abort
2224 </verb></tscreen>
2225
2226 If you abort the message it will NOT be sent.
2227
2228 When you are entering the text of your message, most normal output (such
2229 as DX announcements and so on are suppressed and stored for latter display
2230 (upto 20 such lines are stored, as new ones come along, so the oldest
2231 lines are dropped).
2232
2233 Also, you can enter normal commands commands (and get the output 
2234 immediately) whilst in the middle of a message. You do this by typing
2235 the command preceeded by a '/' character on a new line, so:-
2236
2237 <tscreen><verb>
2238   /dx g1tlh 144010 strong signal
2239 </verb></tscreen>
2240
2241 Will issue a dx annoucement to the rest of the cluster. 
2242
2243 Also, you can add the output of a command to your message by preceeding 
2244 the command with '//', thus :-
2245
2246 <tscreen><verb>
2247   //sh/vhftable
2248 </verb></tscreen>
2249
2250 This will show YOU the output from SH/VHFTABLE and also store it in the
2251 message. 
2252
2253 You can carry on with the message until you are ready to send it. 
2254 <sect1>send private &lt;call&gt;
2255
2256 <P>
2257 <tt>
2258 <bf>send private &lt;call&gt;</bf> Send a personal message
2259 </tt>
2260
2261 <P>
2262 <sect1>send rr &lt;call&gt;
2263
2264 <P>
2265 <tt>
2266 <bf>send rr &lt;call&gt;</bf> Send a message and ask for a read receipt
2267 </tt>
2268
2269 <P>
2270 <sect1>set/address &lt;your address&gt;
2271
2272 <P>
2273 <tt>
2274 <bf>set/address &lt;your address&gt;</bf> Record your postal address
2275 </tt>
2276
2277 <P>
2278 <sect1>set/announce
2279
2280 <P>
2281 <tt>
2282 <bf>set/announce</bf> Allow announce messages to come out on your terminal
2283 </tt>
2284
2285 <P>
2286 <sect1>set/anntalk
2287
2288 <P>
2289 <tt>
2290 <bf>set/anntalk</bf> Allow talk like announce messages on your terminal
2291 </tt>
2292
2293 <P>
2294 <sect1>set/beep
2295
2296 <P>
2297 <tt>
2298 <bf>set/beep</bf> Add a beep to DX and other messages on your terminal
2299 </tt>
2300
2301 <P>
2302 <sect1>set/dx
2303
2304 <P>
2305 <tt>
2306 <bf>set/dx</bf> Allow DX messages to come out on your terminal
2307 </tt>
2308
2309 <P>
2310 <sect1>set/dxcq
2311
2312 <P>
2313 <tt>
2314 <bf>set/dxcq</bf> Show CQ Zones on the end of DX announcements
2315 </tt>
2316
2317 <P>
2318 <sect1>set/dxgrid
2319
2320 <P>
2321 <tt>
2322 <bf>set/dxgrid</bf> Allow QRA Grid Squares on the end of DX announcements
2323 </tt>
2324
2325 <P>
2326 <sect1>set/dxitu
2327
2328 <P>
2329 <tt>
2330 <bf>set/dxitu</bf> Show ITU Zones on the end of DX announcements
2331 </tt>
2332
2333 <P>
2334 <sect1>set/echo
2335
2336 <P>
2337 <tt>
2338 <bf>set/echo</bf> Make the cluster echo your input
2339 </tt>
2340
2341 <P>
2342 <sect1>set/email &lt;email&gt; ...
2343
2344 <P>
2345 <tt>
2346 <bf>set/email &lt;email&gt; ...</bf> Set email address(es) and forward your personals
2347 </tt>
2348
2349 <P>
2350 <sect1>set/here
2351
2352 <P>
2353 <tt>
2354 <bf>set/here</bf> Tell the system you are present at your terminal
2355 </tt>
2356
2357 <P>
2358 <sect1>set/homenode &lt;node&gt; 
2359
2360 <P>
2361 <tt>
2362 <bf>set/homenode &lt;node&gt; </bf> Set your normal cluster callsign
2363 </tt>
2364
2365 <P>
2366 Tell the cluster system where you normally connect to. Any Messages sent
2367 to you will normally find their way there should you not be connected.
2368 eg:-
2369 <tscreen><verb>
2370   SET/HOMENODE gb7djk
2371 </verb></tscreen>
2372
2373 <sect1>set/language &lt;lang&gt;
2374
2375 <P>
2376 <tt>
2377 <bf>set/language &lt;lang&gt;</bf> Set the language you want to use
2378 </tt>
2379
2380 <P>
2381 You can select the language that you want the cluster to use. Currently
2382 the languages available are en (English), de (German), es (Spanish),
2383 Czech (cz), French (fr), Portuguese (pt), Italian (it) and nl (Dutch).
2384 <sect1>set/location &lt;lat & long&gt;
2385
2386 <P>
2387 <tt>
2388 <bf>set/location &lt;lat & long&gt;</bf> Set your latitude and longitude
2389 </tt>
2390
2391 <P>
2392 <sect1>set/logininfo
2393
2394 <P>
2395 <tt>
2396 <bf>set/logininfo</bf> Inform when a station logs in/out locally
2397 </tt>
2398
2399 <P>
2400 <sect1>set/name &lt;your name&gt;
2401
2402 <P>
2403 <tt>
2404 <bf>set/name &lt;your name&gt;</bf> Set your name
2405 </tt>
2406
2407 <P>
2408 Tell the system what your name is eg:-
2409 <tscreen><verb>
2410   SET/NAME Dirk
2411 </verb></tscreen>
2412
2413 <sect1>set/page &lt;lines per page&gt;
2414
2415 <P>
2416 <tt>
2417 <bf>set/page &lt;lines per page&gt;</bf> Set the lines per page
2418 </tt>
2419
2420 <P>
2421 Tell the system how many lines you wish on a page when the number of line
2422 of output from a command is more than this. The default is 20. Setting it
2423 explicitly to 0 will disable paging. 
2424 <tscreen><verb>
2425   SET/PAGE 30
2426   SET/PAGE 0
2427 </verb></tscreen>
2428
2429 The setting is stored in your user profile.
2430 <sect1>set/password
2431
2432 <P>
2433 <tt>
2434 <bf>set/password</bf> Set your own password
2435 </tt>
2436
2437 <P>
2438 This command only works for a 'telnet' user (currently). It will
2439 only work if you have a password already set. This initial password
2440 can only be set by the sysop.
2441
2442 When you execute this command it will ask you for your old password,
2443 then ask you to type in your new password twice (to make sure you
2444 get it right). You may or may not see the data echoed on the screen
2445 as you type, depending on the type of telnet client you have.
2446 <sect1>set/prompt &lt;string&gt;
2447
2448 <P>
2449 <tt>
2450 <bf>set/prompt &lt;string&gt;</bf> Set your prompt to &lt;string&gt;
2451 </tt>
2452
2453 <P>
2454 <sect1>set/qra &lt;locator&gt;
2455
2456 <P>
2457 <tt>
2458 <bf>set/qra &lt;locator&gt;</bf> Set your QRA Grid locator
2459 </tt>
2460
2461 <P>
2462 Tell the system what your QRA (or Maidenhead) locator is. If you have not
2463 done a SET/LOCATION then your latitude and longitude will be set roughly
2464 correctly (assuming your locator is correct ;-). For example:-
2465 <tscreen><verb>
2466   SET/QRA JO02LQ
2467 </verb></tscreen>
2468
2469 <sect1>set/qth &lt;your qth&gt;
2470
2471 <P>
2472 <tt>
2473 <bf>set/qth &lt;your qth&gt;</bf> Set your QTH
2474 </tt>
2475
2476 <P>
2477 Tell the system where you are. For example:-
2478 <tscreen><verb>
2479   SET/QTH East Dereham, Norfolk
2480 </verb></tscreen>
2481
2482 <sect1>set/startup
2483
2484 <P>
2485 <tt>
2486 <bf>set/startup</bf> Create your own startup script
2487 </tt>
2488
2489 <P>
2490 Create a startup script of DXSpider commands which will be executed
2491 everytime that you login into this node. You can only input the whole
2492 script afresh, it is not possible to 'edit' it. Inputting a new script is
2493 just like typing in a message using SEND. To finish inputting type: /EX
2494 on a newline, to abandon the script type: /ABORT.
2495
2496 You may find the (curiously named) command BLANK useful to break 
2497 up the output. If you simply want a blank line, it is easier to 
2498 input one or more spaces and press the &lt;return&gt; key.
2499
2500 See UNSET/STARTUP to remove a script.
2501 <sect1>set/talk
2502
2503 <P>
2504 <tt>
2505 <bf>set/talk</bf> Allow TALK messages to come out on your terminal
2506 </tt>
2507
2508 <P>
2509 <sect1>set/usstate
2510
2511 <P>
2512 <tt>
2513 <bf>set/usstate</bf> Allow US State info on the end of DX announcements
2514 </tt>
2515
2516 <P>
2517 <sect1>set/wcy
2518
2519 <P>
2520 <tt>
2521 <bf>set/wcy</bf> Allow WCY messages to come out on your terminal
2522 </tt>
2523
2524 <P>
2525 <sect1>set/wwv
2526
2527 <P>
2528 <tt>
2529 <bf>set/wwv</bf> Allow WWV messages to come out on your terminal
2530 </tt>
2531
2532 <P>
2533 <sect1>set/wx
2534
2535 <P>
2536 <tt>
2537 <bf>set/wx</bf> Allow WX messages to come out on your terminal
2538 </tt>
2539
2540 <P>
2541 <sect1>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb;
2542
2543 <P>
2544 <tt>
2545 <bf>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb;</bf> Show any chat or conferencing 
2546 </tt>
2547
2548 <P>
2549 This command allows you to see any chat or conferencing that has  
2550 occurred whilst you were away. SHOW/CHAT on its own will show data for
2551 all groups. If you use a group name then it will show only chat for
2552 that group.
2553 <sect1>show/configuration &lsqb;&lt;node&gt;&rsqb;
2554
2555 <P>
2556 <tt>
2557 <bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
2558 </tt>
2559
2560 <P>
2561 This command allows you to see all the users that can be seen
2562 and the nodes to which they are connected.
2563
2564 This command is normally abbreviated to: sh/c
2565
2566 Normally, the list returned will be just for the nodes from your 
2567 country (because the list otherwise will be very long).
2568
2569 <tscreen><verb>
2570   SH/C ALL 
2571 </verb></tscreen>
2572
2573 will produce a complete list of all nodes. 
2574
2575 BE WARNED: the list that is returned can be VERY long
2576
2577 It is possible to supply a node or part of a prefix and you will get 
2578 a list of the users for that node or list of nodes starting with
2579 that prefix.
2580
2581 <tscreen><verb>
2582   SH/C GB7DJK
2583 </verb></tscreen>
2584
2585 <tscreen><verb>
2586   SH/C SK
2587 </verb></tscreen>
2588
2589 <sect1>show/configuration/node
2590
2591 <P>
2592 <tt>
2593 <bf>show/configuration/node</bf> Show all the nodes connected locally
2594 </tt>
2595
2596 <P>
2597 Show all the nodes connected to this node.
2598 <sect1>show/contest &lt;year and month&gt;
2599
2600 <P>
2601 <tt>
2602 <bf>show/contest &lt;year and month&gt;</bf> Show all the contests for a month
2603 </tt>
2604
2605 <P>
2606 Show all known contests which are maintained at http://www.sk3bg.se/contest/
2607 for a particular month or year. The format is reasonably flexible.
2608 For example:-
2609   
2610 <tscreen><verb>
2611   SH/CONTEST sep2003
2612   SH/CONTEST 03 march
2613 </verb></tscreen>
2614
2615 <sect1>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2616
2617 <P>
2618 <tt>
2619 <bf>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
2620 </tt>
2621
2622 <P>
2623 This is very nearly the same as SHOW/TIME, the only difference the format
2624 of the date string if no arguments are given.
2625
2626 If no prefixes or callsigns are given then this command returns the local
2627 time and UTC as the computer has it right now. If you give some prefixes
2628 then it will show UTC and UTC + the local offset (not including DST) at
2629 the prefixes or callsigns that you specify.
2630 <sect1>show/db0sdx &lt;callsign&gt;
2631
2632 <P>
2633 <tt>
2634 <bf>show/db0sdx &lt;callsign&gt;</bf> Show QSL infomation from DB0SDX database
2635 </tt>
2636
2637 <P>
2638 This command queries the DB0SDX QSL server on the internet
2639 and returns any information available for that callsign. This service
2640 is provided for users of this software by http://www.qslinfo.de.
2641
2642 See also SHOW/QRZ, SHOW/WM7D.
2643 <sect1>show/dx
2644
2645 <P>
2646 <tt>
2647 <bf>show/dx</bf> Interrogate the spot database
2648 </tt>
2649
2650 <P>
2651 If you just type SHOW/DX you will get the last so many spots
2652 (sysop configurable, but usually 10).
2653    
2654 In addition you can add any number of these commands in very nearly
2655 any order to the basic SHOW/DX command, they are:-
2656    
2657 <tscreen><verb>
2658  on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
2659  on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
2660  on &lt;from&gt;/&lt;to&gt;  - eg 1000/4000 14000-30000  (in Khz)
2661     &lt;from&gt;-&lt;to&gt;
2662 </verb></tscreen>
2663    
2664 <tscreen><verb>
2665  &lt;number&gt;        - the number of spots you want
2666  &lt;from&gt;-&lt;to&gt;     - &lt;from&gt; spot no &lt;to&gt; spot no in the selected list
2667  &lt;from&gt;/&lt;to&gt;
2668 </verb></tscreen>
2669    
2670 <tscreen><verb>
2671  &lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
2672  *&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
2673  *&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
2674 </verb></tscreen>
2675    
2676 <tscreen><verb>
2677  day &lt;number&gt;    - starting &lt;number&gt; days ago
2678  day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
2679      &lt;from&gt;/&lt;to&gt;   
2680 </verb></tscreen>
2681
2682 <tscreen><verb>
2683  info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
2684 </verb></tscreen>
2685     
2686 <tscreen><verb>
2687  by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; is the 
2688                    same).
2689 </verb></tscreen>
2690
2691 <tscreen><verb>
2692  qsl             - this automatically looks for any qsl info on the call
2693                    held in the spot database.
2694 </verb></tscreen>
2695
2696 <tscreen><verb>
2697  iota [&lt;iota&gt;]   - If the iota island number is missing it will look for
2698                   the string iota and anything which looks like an iota
2699                   island number. If you specify then it will look for  
2700                   that island.
2701 </verb></tscreen>
2702
2703 <tscreen><verb>
2704  qra [&lt;locator&gt;] - this will look for the specific locator if you specify
2705                    one or else anything that looks like a locator.
2706 </verb></tscreen>
2707
2708 <tscreen><verb>
2709  dxcc            - treat the prefix as a 'country' and look for spots
2710                    from that country regardless of actual prefix.
2711                    eg dxcc oq2 
2712 </verb></tscreen>
2713                   
2714 <tscreen><verb>
2715                    You can also use this with the 'by' keyword so 
2716                    eg by W dxcc  
2717 </verb></tscreen>
2718  
2719 <tscreen><verb>
2720  real or rt      - Format the output the same as for real time spots. The
2721                    formats are deliberately different (so you can tell
2722                    one sort from the other). This is useful for some 
2723                    logging programs that can't cope with normal sh/dx 
2724                    output. An alias of SHOW/FDX is available.
2725 </verb></tscreen>
2726        
2727 <tscreen><verb>
2728  filter          - Filter the spots, before output, with the user's 
2729                    spot filter. An alias of SHOW/MYDX is available.
2730 </verb></tscreen>
2731
2732 <tscreen><verb>
2733  zone &lt;zones&gt;    - look for spots in the cq zone (or zones) specified.
2734                    zones are numbers separated by commas.
2735 </verb></tscreen>
2736
2737 <tscreen><verb>
2738  by_zone &lt;zones&gt; - look for spots spotted by people in the cq zone
2739                    specified.
2740 </verb></tscreen>
2741
2742 <tscreen><verb>
2743  itu &lt;itus&gt;      - look for spots in the itu zone (or zones) specified
2744                    itu zones are numbers separated by commas.
2745 </verb></tscreen>
2746
2747 <tscreen><verb>
2748  by_itu &lt;itus&gt;   - look for spots spotted by people in the itu zone
2749                    specified.
2750 </verb></tscreen>
2751   
2752 <tscreen><verb>
2753  state &lt;list&gt;    - look for spots in the US state (or states) specified
2754                    The list is two letter state codes separated by commas.
2755 </verb></tscreen>
2756
2757 <tscreen><verb>
2758  by_state &lt;list&gt; - look for spots spotted by people in the US state
2759                    specified.
2760 </verb></tscreen>
2761  
2762 <tscreen><verb>
2763  e.g. 
2764 </verb></tscreen>
2765    
2766 <tscreen><verb>
2767    SH/DX 9m0
2768    SH/DX on 20m info iota
2769    SH/DX 9a on vhf day 30
2770    SH/DX rf1p qsl
2771    SH/DX iota 
2772    SH/DX iota eu-064
2773    SH/DX qra jn86
2774    SH/DX dxcc oq2
2775    SH/DX dxcc oq2 by w dxcc
2776    SH/DX zone 4,5,6
2777    SH/DX by_zone 4,5,6
2778    SH/DX state in,oh
2779    SH/DX by_state in,oh
2780 </verb></tscreen>
2781   
2782 <sect1>show/dxcc &lt;prefix&gt;
2783
2784 <P>
2785 <tt>
2786 <bf>show/dxcc &lt;prefix&gt;</bf> Interrogate the spot database by country
2787 </tt>
2788
2789 <P>
2790 This command takes the &lt;prefix&gt; (which can be a full or partial 
2791 callsign if desired), looks up which internal country number it is
2792 and then displays all the spots as per SH/DX for that country.
2793
2794 This is now an alias for 'SHOW/DX DXCC' 
2795    
2796 The options for SHOW/DX also apply to this command.   
2797 e.g. 
2798    
2799 <tscreen><verb>
2800    SH/DXCC G
2801    SH/DXCC W on 20m iota
2802 </verb></tscreen>
2803
2804 This can be done with the SHOW/DX command like this:-
2805
2806 <tscreen><verb>
2807    SH/DX dxcc g
2808    SH/DX dxcc w on 20m iota
2809 </verb></tscreen>
2810
2811 This is an alias for: SH/DX dxcc
2812 <sect1>show/dxqsl &lt;callsign&gt;
2813
2814 <P>
2815 <tt>
2816 <bf>show/dxqsl &lt;callsign&gt;</bf> Show any QSL info gathered from spots
2817 </tt>
2818
2819 <P>
2820 The node collects information from the comment fields in spots (things
2821 like 'VIA EA7WA' or 'QSL-G1TLH') and stores these in a database.
2822
2823 This command allows you to interrogate that database and if the callsign
2824 is found will display the manager(s) that people have spotted. This 
2825 information is NOT reliable, but it is normally reasonably accurate if
2826 it is spotted enough times.
2827
2828 For example:-
2829
2830 <tscreen><verb>
2831   sh/dxqsl 4k9w
2832 </verb></tscreen>
2833
2834 You can check the raw input spots yourself with:-
2835
2836 <tscreen><verb>
2837   sh/dx 4k9w qsl
2838 </verb></tscreen>
2839
2840 This gives you more background information.
2841 <sect1>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2842
2843 <P>
2844 <tt>
2845 <bf>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the DX Statistics
2846 </tt>
2847
2848 <P>
2849 Show the total DX spots for the last &lt;days&gt; no of days (default is 31), 
2850 starting from a &lt;date&gt; (default: today).
2851 <sect1>show/fdx
2852
2853 <P>
2854 <tt>
2855 <bf>show/fdx</bf> Show the DX data in realtime format.
2856 </tt>
2857
2858 <P>
2859 Normally SHOW/DX outputs spot data in a different format to the
2860 realtime data. This is a deliberate policy (so you can tell the 
2861 difference between the two). Some logging programs cannot handle
2862 this so SHOW/FDX outputs historical data in real time format.
2863
2864 This is an alias for: SHOW/DX real
2865 <sect1>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;
2866
2867 <P>
2868 <tt>
2869 <bf>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;</bf> List the contents of a filearea
2870 </tt>
2871
2872 <P>
2873 SHOW/FILES on its own will show you a list of the various fileareas
2874 available on the system. To see the contents of a particular file
2875 area type:-
2876 <tscreen><verb>
2877    SH/FILES &lt;filearea&gt;
2878 </verb></tscreen>
2879 where &lt;filearea&gt; is the name of the filearea you want to see the 
2880 contents of.
2881
2882 You can also use shell globbing characters like '*' and '?' in a
2883 string to see a selection of files in a filearea eg:-
2884 <tscreen><verb>
2885    SH/FILES bulletins arld*
2886 </verb></tscreen>
2887
2888 See also TYPE - to see the contents of a file.
2889 <sect1>show/filter
2890
2891 <P>
2892 <tt>
2893 <bf>show/filter</bf> Show the contents of all the filters you have set
2894 </tt>
2895
2896 <P>
2897 Show the contents of all the filters that are set. This command displays
2898 all the filters set - for all the various categories.
2899 <sect1>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2900
2901 <P>
2902 <tt>
2903 <bf>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the HF DX Statistics 
2904 </tt>
2905
2906 <P>
2907 Show the HF DX spots breakdown by band for the last &lt;days&gt; no of days 
2908 (default is 31), starting from a &lt;date&gt; (default: today).
2909 <sect1>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
2910
2911 <P>
2912 <tt>
2913 <bf>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the HF DX Spotter Table
2914 </tt>
2915
2916 <P>
2917 Show the HF DX Spotter table for the list of prefixes for the last 
2918 &lt;days&gt; no of days (default is 31), starting from a &lt;date&gt; (default: today).
2919
2920 If there are no prefixes then it will show the table for your country.
2921
2922 Remember that some countries have more than one "DXCC country" in them
2923 (eg G :-), to show them (assuming you are not in G already which is
2924 specially treated in the code) you must list all the relevant prefixes
2925
2926 <tscreen><verb>
2927   sh/hftable g gm gd gi gj gw gu 
2928 </verb></tscreen>
2929
2930 Note that the prefixes are converted into country codes so you don't have
2931 to list all possible prefixes for each country.
2932
2933 If you want more or less days than the default simply include the
2934 number you require:-
2935
2936 <tscreen><verb>
2937   sh/hftable 20 pa
2938 </verb></tscreen>
2939
2940 If you want to start at a different day, simply add the date in some 
2941 recognizable form:-
2942
2943 <tscreen><verb>
2944   sh/hftable 2 25nov02
2945   sh/hftable 2 25-nov-02 
2946   sh/hftable 2 021125 
2947   sh/hftable 2 25/11/02
2948 </verb></tscreen>
2949
2950 This will show the stats for your DXCC for that CQWW contest weekend. 
2951
2952 You can specify either prefixes or full callsigns (so you can see how you
2953 did against all your mates). You can also say 'all' which will then print
2954 the worldwide statistics.
2955
2956 <tscreen><verb>
2957   sh/hftable all 
2958 </verb></tscreen>
2959
2960 <sect1>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2961
2962 <P>
2963 <tt>
2964 <bf>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show Moon rise and set times
2965 </tt>
2966
2967 <P>
2968 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
2969 together with the azimuth and elevation of the sun currently at those
2970 locations.
2971
2972 If you don't specify any prefixes or callsigns, it will show the times for
2973 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2974 together with the current azimuth and elevation.
2975
2976 In addition, it will show the illuminated fraction of the moons disk.
2977
2978 If all else fails it will show the Moonrise and set times for the node
2979 that you are connected to. 
2980
2981 For example:-
2982
2983 <tscreen><verb>
2984   SH/MOON
2985   SH/MOON G1TLH W5UN
2986 </verb></tscreen>
2987
2988 You can also use this command to see into the past or the future, so
2989 if you want to see yesterday's times then do:-
2990
2991 <tscreen><verb>
2992   SH/MOON -1 
2993 </verb></tscreen>
2994
2995 or in three days time:-
2996
2997 <tscreen><verb>
2998   SH/MOON +3 W9
2999 </verb></tscreen>
3000
3001 Upto 366 days can be checked both in the past and in the future.
3002
3003 Please note that the rise and set times are given as the UT times of rise and 
3004 set on the requested UT day.
3005 <sect1>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;
3006
3007 <P>
3008 <tt>
3009 <bf>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;</bf> Show the likely propagation to a prefix
3010 </tt>
3011
3012 <P>
3013 This command allow you to estimate the likelihood of you contacting
3014 a station with the prefix you have specified. The output assumes a modest
3015 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
3016
3017 The result predicts the most likely operating frequencies and signal
3018 levels for high frequency (shortwave) radio propagation paths on
3019 specified days of the year and hours of the day. It is most useful for
3020 paths between 250 km and 6000 km, but can be used with reduced accuracy
3021 for paths shorter or longer than this.
3022
3023 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
3024 used to predict the MUF given the predicted flux, day of the year,
3025 hour of the day and geographic coordinates of the transmitter and
3026 receiver. This routine is reasonably accurate for the purposes here,
3027 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
3028 than the programs used by major shortwave broadcasting organizations,
3029 such as the Voice of America.
3030
3031 The command will display some header information detailing its
3032 assumptions, together with the locations, latitude and longitudes and
3033 bearings. It will then show UTC (UT), local time at the other end
3034 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
3035 (Zen) and the likely signal strengths. Then for each frequency for which
3036 the system thinks there is a likelihood of a circuit it prints a value.
3037
3038 The value is currently a likely S meter reading based on the conventional
3039 6dB / S point scale. If the value has a '+' appended it means that it is
3040 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
3041 there is likely to be much fading and by an 's' that the signal is likely
3042 to be noisy.  
3043
3044 By default SHOW/MUF will show the next two hours worth of data. You
3045 can specify anything up to 24 hours worth of data by appending the no of
3046 hours required after the prefix. For example:-
3047
3048 <tscreen><verb>
3049   SH/MUF W
3050 </verb></tscreen>
3051
3052 produces:
3053
3054 <tscreen><verb>
3055   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
3056   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
3057   Location                       Lat / Long           Azim
3058   East Dereham, Norfolk          52 41 N 0 57 E         47
3059   United-States-W                43 0 N 87 54 W        299
3060   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
3061   18 23 11.5 -35  mS0+ mS2   S3
3062   19  0 11.2 -41  mS0+ mS2   S3
3063 </verb></tscreen>
3064
3065 indicating that you will have weak, fading circuits on top band and 
3066 80m but usable signals on 40m (about S3).
3067
3068 inputing:-
3069
3070 <tscreen><verb>
3071   SH/MUF W 24
3072 </verb></tscreen>
3073
3074 will get you the above display, but with the next 24 hours worth of
3075 propagation data.
3076
3077 <tscreen><verb>
3078   SH/MUF W L 24
3079   SH/MUF W 24 Long
3080 </verb></tscreen>
3081
3082 Gives you an estimate of the long path propagation characterics. It
3083 should be noted that the figures will probably not be very useful, nor
3084 terrible accurate, but it is included for completeness.
3085 <sect1>show/mydx
3086
3087 <P>
3088 <tt>
3089 <bf>show/mydx</bf> Show the DX data filtered with your spot filter.
3090 </tt>
3091
3092 <P>
3093 SHOW/DX potentially shows all the spots available in the system. Using
3094 SHOW/MYDX will, instead, filter the availble spots using any spot filter 
3095 that you have set, first. 
3096
3097 This command, together with ACCEPT/SPOT or REJECT/SPOT, will allow
3098 you to customise the spots that you receive.
3099
3100 So if you have said: ACC/SPOT on hf
3101
3102 Doing a SHOW/MYDX will now only, ever, show HF spots. All the other 
3103 options on SH/DX can still be used.
3104 <sect1>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;
3105
3106 <P>
3107 <tt>
3108 <bf>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
3109 </tt>
3110
3111 <P>
3112 This command allows you to see all the users that can be seen
3113 and the nodes to which they are connected. 
3114
3115 This command produces essentially the same information as 
3116 SHOW/CONFIGURATION except that it shows all the duplication of
3117 any routes that might be present It also uses a different format
3118 which may not take up quite as much space if you don't have any
3119 loops.
3120
3121 BE WARNED: the list that is returned can be VERY long
3122 <sect1>show/newconfiguration/node
3123
3124 <P>
3125 <tt>
3126 <bf>show/newconfiguration/node</bf> Show all the nodes connected locally
3127 </tt>
3128
3129 <P>
3130 Show all the nodes connected to this node in the new format.
3131 <sect1>show/prefix &lt;callsign&gt;
3132
3133 <P>
3134 <tt>
3135 <bf>show/prefix &lt;callsign&gt;</bf> Interrogate the prefix database 
3136 </tt>
3137
3138 <P>
3139 This command takes the &lt;callsign&gt; (which can be a full or partial 
3140 callsign or a prefix), looks up which internal country number 
3141 it is and then displays all the relevant prefixes for that country
3142 together with the internal country no, the CQ and ITU regions. 
3143
3144 See also SHOW/DXCC
3145 <sect1>show/qra &lt;lat&gt; &lt;long&gt;
3146
3147 <P>
3148 <tt>
3149 <bf>show/qra &lt;lat&gt; &lt;long&gt;</bf> Convert lat/long to a QRA Grid locator
3150 </tt>
3151
3152 <P>
3153 This is a multipurpose command that allows you either to calculate the
3154 distance and bearing between two locators or (if only one locator is
3155 given on the command line) the distance and beraing from your station
3156 to the locator. For example:-
3157
3158 <tscreen><verb>
3159  SH/QRA IO92QL 
3160  SH/QRA JN06 IN73
3161 </verb></tscreen>
3162
3163 The first example will show the distance and bearing to the locator from
3164 yourself, the second example will calculate the distance and bearing from
3165 the first locator to the second. You can use 4 or 6 character locators.
3166
3167 It is also possible to convert a latitude and longitude to a locator by 
3168 using this command with a latitude and longitude as an argument, for
3169 example:-
3170
3171 <tscreen><verb>
3172  SH/QRA 52 41 N 0 58 E
3173 </verb></tscreen>
3174
3175 <sect1>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;
3176
3177 <P>
3178 <tt>
3179 <bf>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;</bf> Show distance between QRA Grid locators
3180 </tt>
3181
3182 <P>
3183 <sect1>show/qrz &lt;callsign&gt;
3184
3185 <P>
3186 <tt>
3187 <bf>show/qrz &lt;callsign&gt;</bf> Show any callbook details on a callsign
3188 </tt>
3189
3190 <P>
3191 This command queries the QRZ callbook server on the internet
3192 and returns any information available for that callsign. This service
3193 is provided for users of this software by http://www.qrz.com 
3194
3195 See also SHOW/WM7D for an alternative.
3196 <sect1>show/route &lt;callsign&gt; ...
3197
3198 <P>
3199 <tt>
3200 <bf>show/route &lt;callsign&gt; ...</bf> Show the route to the callsign
3201 </tt>
3202
3203 <P>
3204 This command allows you to see to which node the callsigns specified are
3205 connected. It is a sort of inverse sh/config.
3206
3207 <tscreen><verb>
3208  sh/route n2tly
3209 </verb></tscreen>
3210
3211 <sect1>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;
3212
3213 <P>
3214 <tt>
3215 <bf>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;</bf> Show tracking data
3216 </tt>
3217
3218 <P>
3219 Show the tracking data from your location to the satellite of your choice
3220 from now on for the next few hours.
3221
3222 If you use this command without a satellite name it will display a list
3223 of all the satellites known currently to the system. 
3224
3225 If you give a name then you can obtain tracking data of all the passes
3226 that start and finish 5 degrees below the horizon. As default it will
3227 give information for the next three hours for every five minute period.
3228
3229 You can alter the number of hours and the step size, within certain 
3230 limits. 
3231
3232 Each pass in a period is separated with a row of '-----' characters
3233
3234 So for example:-
3235
3236 <tscreen><verb>
3237  SH/SAT AO-10 
3238  SH/SAT FENGYUN1 12 2
3239 </verb></tscreen>
3240
3241 <sect1>show/startup
3242
3243 <P>
3244 <tt>
3245 <bf>show/startup</bf> View your own startup script
3246 </tt>
3247
3248 <P>
3249 View the contents of a startup script created with SET/STARTUP.
3250 <sect1>show/station &lsqb;&lt;callsign&gt; ..&rsqb;
3251
3252 <P>
3253 <tt>
3254 <bf>show/station &lsqb;&lt;callsign&gt; ..&rsqb;</bf> Show information about a callsign
3255 </tt>
3256
3257 <P>
3258 Show the information known about a callsign and whether (and where)
3259 that callsign is connected to the cluster.
3260
3261 <tscreen><verb>
3262   SH/ST G1TLH
3263 </verb></tscreen>
3264
3265 If no callsign is given then show the information for yourself.
3266 <sect1>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
3267
3268 <P>
3269 <tt>
3270 <bf>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show sun rise and set times
3271 </tt>
3272
3273 <P>
3274 Show the sun rise and set times for a (list of) prefixes or callsigns, 
3275 together with the azimuth and elevation of the sun currently at those
3276 locations.
3277
3278 If you don't specify any prefixes or callsigns, it will show the times for
3279 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
3280 together with the current azimuth and elevation.
3281
3282 If all else fails it will show the sunrise and set times for the node
3283 that you are connected to. 
3284
3285 For example:-
3286
3287 <tscreen><verb>
3288   SH/SUN
3289   SH/SUN G1TLH K9CW ZS
3290 </verb></tscreen>
3291
3292 You can also use this command to see into the past or the future, so
3293 if you want to see yesterday's times then do:-
3294
3295 <tscreen><verb>
3296   SH/SUN -1 
3297 </verb></tscreen>
3298
3299 or in three days time:-
3300
3301 <tscreen><verb>
3302   SH/SUN +3 W9
3303 </verb></tscreen>
3304
3305 Upto 366 days can be checked both in the past and in the future.
3306
3307 Please note that the rise and set times are given as the UT times of rise 
3308 and set on the requested UT day.
3309 <sect1>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
3310
3311 <P>
3312 <tt>
3313 <bf>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
3314 </tt>
3315
3316 <P>
3317 If no prefixes or callsigns are given then this command returns the local
3318 time and UTC as the computer has it right now. If you give some prefixes
3319 then it will show UTC and UTC + the local offset (not including DST) at
3320 the prefixes or callsigns that you specify.
3321 <sect1>show/usdb &lsqb;call ..&rsqb;
3322
3323 <P>
3324 <tt>
3325 <bf>show/usdb &lsqb;call ..&rsqb;</bf> Show information held on the FCC Call database
3326 </tt>
3327
3328 <P>
3329 Show the City and State of a Callsign held on the FCC database if
3330 his is being run on this system, eg:-
3331
3332 <tscreen><verb>
3333   sh/usdb k1xx
3334 </verb></tscreen>
3335
3336 <sect1>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
3337
3338 <P>
3339 <tt>
3340 <bf>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the VHF DX Statistics
3341 </tt>
3342
3343 <P>
3344 Show the VHF DX spots breakdown by band for the last 
3345 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3346 <sect1>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
3347
3348 <P>
3349 <tt>
3350 <bf>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the VHF DX Spotter Table
3351 </tt>
3352
3353 <P>
3354 Show the VHF DX Spotter table for the list of prefixes for the last 
3355 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3356
3357 If there are no prefixes then it will show the table for your country.
3358
3359 Remember that some countries have more than one "DXCC country" in them
3360 (eg G :-), to show them (assuming you are not in G already which is
3361 specially treated in the code) you must list all the relevant prefixes
3362
3363 <tscreen><verb>
3364   sh/vhftable g gm gd gi gj gw gu 
3365 </verb></tscreen>
3366
3367 Note that the prefixes are converted into country codes so you don't have
3368 to list all possible prefixes for each country.
3369
3370 If you want more or less days than the default simply include the
3371 number you require:-
3372
3373 <tscreen><verb>
3374   sh/vhftable 20 pa
3375 </verb></tscreen>
3376
3377 If you want to start at a different day, simply add the date in some 
3378 recognizable form:-
3379
3380 <tscreen><verb>
3381   sh/vhftable 2 25nov02
3382   sh/vhftable 2 25-nov-02 
3383   sh/vhftable 2 021125 
3384   sh/vhftable 2 25/11/02
3385 </verb></tscreen>
3386
3387 This will show the stats for your DXCC for that CQWW contest weekend. 
3388
3389 You can specify either prefixes or full callsigns (so you can see how you
3390 did against all your mates). You can also say 'all' which will then print
3391 the worldwide statistics.
3392
3393 <tscreen><verb>
3394   sh/vhftable all 
3395 </verb></tscreen>
3396
3397 <sect1>show/wcy
3398
3399 <P>
3400 <tt>
3401 <bf>show/wcy</bf> Show last 10 WCY broadcasts
3402 </tt>
3403
3404 <P>
3405 <sect1>show/wcy &lt;n&gt;
3406
3407 <P>
3408 <tt>
3409 <bf>show/wcy &lt;n&gt;</bf> Show last &lt;n&gt; WCY broadcasts
3410 </tt>
3411
3412 <P>
3413 Display the most recent WCY information that has been received by the system
3414  
3415 <sect1>show/wm7d &lt;callsign&gt;
3416
3417 <P>
3418 <tt>
3419 <bf>show/wm7d &lt;callsign&gt;</bf> Show callbook details on a US callsigns
3420 </tt>
3421
3422 <P>
3423 This command queries the WM7D callbook server on the internet
3424 and returns any information available for that US callsign. This service
3425 is provided for users of this software by http://www.wm7d.net.
3426
3427 See also SHOW/QRZ. 
3428 <sect1>show/wwv
3429
3430 <P>
3431 <tt>
3432 <bf>show/wwv</bf> Show last 10 WWV broadcasts
3433 </tt>
3434
3435 <P>
3436 <sect1>show/wwv &lt;n&gt;
3437
3438 <P>
3439 <tt>
3440 <bf>show/wwv &lt;n&gt;</bf> Show last &lt;n&gt; WWV broadcasts
3441 </tt>
3442
3443 <P>
3444 Display the most recent WWV information that has been received by the system
3445 <sect1>sysop
3446
3447 <P>
3448 <tt>
3449 <bf>sysop</bf> Regain your privileges if you login remotely
3450 </tt>
3451
3452 <P>
3453 The system automatically reduces your privilege level to that of a
3454 normal user if you login in remotely. This command allows you to
3455 regain your normal privilege level. It uses the normal system: five
3456 numbers are returned that are indexes into the character array that is
3457 your assigned password (see SET/PASSWORD). The indexes start from
3458 zero.
3459
3460 You are expected to return a string which contains the characters
3461 required in the correct order. You may intersperse those characters
3462 with others to obscure your reply for any watchers. For example (and
3463 these values are for explanation :-):
3464
3465 <tscreen><verb>
3466   password = 012345678901234567890123456789
3467   &gt; sysop
3468   22 10 15 17 3
3469 </verb></tscreen>
3470 you type:-
3471 <tscreen><verb>
3472  aa2bbbb0ccc5ddd7xxx3n
3473  or 2 0 5 7 3
3474  or 20573
3475 </verb></tscreen>
3476
3477 They will all match. If there is no password you will still be offered
3478 numbers but nothing will happen when you input a string. Any match is
3479 case sensitive.
3480 <sect1>talk &lt;call&gt; &gt; &lt;node&gt; &lsqb;&lt;text&gt;&rsqb;
3481
3482 <P>
3483 <tt>
3484 <bf>talk &lt;call&gt; &gt; &lt;node&gt; &lsqb;&lt;text&gt;&rsqb;</bf> Send a text message to another station via a node
3485 </tt>
3486
3487 <P>
3488 Send a short message to any other station that is visible on the cluster
3489 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
3490 command, they don't have to be connected locally.
3491
3492 The second form of TALK is used when other cluster nodes are connected
3493 with restricted information. This usually means that they don't send 
3494 the user information usually associated with logging on and off the cluster.
3495
3496 If you know that G3JNB is likely to be present on GB7TLH, but you can only
3497 see GB7TLH in the SH/C list but with no users, then you would use the
3498 second form of the talk message.
3499
3500 If you want to have a ragchew with someone you can leave the text message
3501 out and the system will go into 'Talk' mode. What this means is that a
3502 short message is sent to the recipient telling them that you are in a
3503 'Talking' frame of mind and then you just type - everything you send will
3504 go to the station that you asked for. 
3505
3506 All the usual announcements, spots and so on will still come out on your
3507 terminal.
3508
3509 If you want to do something (such as send a spot) you preceed the normal 
3510 command with a '/' character, eg:-
3511
3512 <tscreen><verb>
3513    /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
3514    /HELP talk
3515 </verb></tscreen>
3516
3517 To leave talk mode type:
3518    
3519 <tscreen><verb>
3520    /EX
3521 </verb></tscreen>
3522
3523 If you are in 'Talk' mode, there is an extention to the '/' command which
3524 allows you to send the output to all the people you are talking to. You do 
3525 with the '//' command. For example:-
3526
3527 <tscreen><verb>
3528   //sh/hftable
3529 </verb></tscreen>
3530
3531 will send the hftable as you have it to all the people you are currently 
3532 talking to.
3533 <sect1>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;
3534
3535 <P>
3536 <tt>
3537 <bf>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;</bf> Send a text message to another station
3538 </tt>
3539
3540 <P>
3541 <sect1>type &lt;filearea&gt;/&lt;name&gt;
3542
3543 <P>
3544 <tt>
3545 <bf>type &lt;filearea&gt;/&lt;name&gt;</bf> Look at the contents of a file in one of the fileareas
3546 </tt>
3547
3548 <P>
3549 Type out the contents of a file in a filearea. So, for example, in 
3550 filearea 'bulletins' you want to look at file 'arld051' you would 
3551 enter:-
3552 <tscreen><verb>
3553    TYPE bulletins/arld051
3554 </verb></tscreen>
3555
3556 See also SHOW/FILES to see what fileareas are available and a 
3557 list of content.
3558 <sect1>unset/announce
3559
3560 <P>
3561 <tt>
3562 <bf>unset/announce</bf> Stop announce messages coming out on your terminal
3563 </tt>
3564
3565 <P>
3566 <sect1>unset/anntalk
3567
3568 <P>
3569 <tt>
3570 <bf>unset/anntalk</bf> Stop talk like announce messages on your terminal
3571 </tt>
3572
3573 <P>
3574 The announce system on legacy cluster nodes is used as a talk 
3575 substitute because the network is so poorly connected. If you:
3576
3577 <tscreen><verb>
3578   unset/anntalk
3579 </verb></tscreen>
3580
3581 you will suppress several of these announces, you may miss the odd 
3582 useful one as well, but you would probably miss them anyway in the
3583 welter of useless ones.
3584
3585 <tscreen><verb>
3586   set/anntalk 
3587 </verb></tscreen>
3588
3589 allows you to see them again. This is the default.
3590 <sect1>unset/beep
3591
3592 <P>
3593 <tt>
3594 <bf>unset/beep</bf> Stop beeps for DX and other messages on your terminal
3595 </tt>
3596
3597 <P>
3598 <sect1>unset/dx
3599
3600 <P>
3601 <tt>
3602 <bf>unset/dx</bf> Stop DX messages coming out on your terminal
3603 </tt>
3604
3605 <P>
3606 <sect1>unset/dxcq
3607
3608 <P>
3609 <tt>
3610 <bf>unset/dxcq</bf> Stop CQ Zones on the end of DX announcements
3611 </tt>
3612
3613 <P>
3614 Display both the Spotter's and the Spotted's CQ Zone on the end
3615 of a DX announcement (there is just enough room). Some user programs
3616 cannot cope with this. The Spotter's CQ is on the RHS of the 
3617 time, the Spotted's CQ is on the LHS.
3618
3619 Conflicts with: SET/DXGRID, SET/DXITU, SHOW/USSTATE
3620
3621 Do a STAT/USER to see which flags you have set if you are confused.  
3622 <sect1>unset/dxgrid
3623
3624 <P>
3625 <tt>
3626 <bf>unset/dxgrid</bf> Stop QRA Grid Squares on the end of DX announcements
3627 </tt>
3628
3629 <P>
3630 A standard feature which is enabled in version 1.43 and above is 
3631 that if the spotter's grid square is known it is output on the end
3632 of a DX announcement (there is just enough room). Some user programs
3633 cannot cope with this. You can use this command to reset (or set)
3634 this feature.
3635
3636 Conflicts with: SET/DXCQ, SET/DXITU
3637
3638 Do a STAT/USER to see which flags you have set if you are confused.  
3639 <sect1>unset/dxitu
3640
3641 <P>
3642 <tt>
3643 <bf>unset/dxitu</bf> Stop ITU Zones on the end of DX announcements
3644 </tt>
3645
3646 <P>
3647 Display both the Spotter's and the Spotted's ITU Zone on the end
3648 of a DX announcement (there is just enough room). Some user programs
3649 cannot cope with this. The Spotter's ITU is on the RHS of the 
3650 time, the Spotted's ITU is on the LHS.
3651
3652 Conflicts with: SET/DXGRID, SET/DXCQ, SHOW/USSTATE
3653
3654 Do a STAT/USER to see which flags you have set if you are confused.  
3655 <sect1>unset/echo
3656
3657 <P>
3658 <tt>
3659 <bf>unset/echo</bf> Stop the cluster echoing your input
3660 </tt>
3661
3662 <P>
3663 If you are connected via a telnet session, different implimentations
3664 of telnet handle echo differently depending on whether you are 
3665 connected via port 23 or some other port. You can use this command
3666 to change the setting appropriately. 
3667
3668 The setting is stored in your user profile.
3669
3670 YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
3671 <sect1>unset/email
3672
3673 <P>
3674 <tt>
3675 <bf>unset/email</bf> Stop personal msgs being forwarded by email
3676 </tt>
3677
3678 <P>
3679 If any personal messages come in for your callsign then you can use
3680 these commands to control whether they are forwarded onto your email
3681 address. To enable the forwarding do something like:-
3682
3683 <tscreen><verb>
3684   SET/EMAIL mike.tubby@somewhere.com
3685 </verb></tscreen>
3686
3687 You can have more than one email address (each one separated by a space).
3688 Emails are forwarded to all the email addresses you specify.
3689
3690 You can disable forwarding by:-
3691
3692 <tscreen><verb>
3693   UNSET/EMAIL
3694 </verb></tscreen>
3695
3696 <sect1>unset/here
3697
3698 <P>
3699 <tt>
3700 <bf>unset/here</bf> Tell the system you are absent from your terminal
3701 </tt>
3702
3703 <P>
3704 <sect1>unset/logininfo
3705
3706 <P>
3707 <tt>
3708 <bf>unset/logininfo</bf> No longer inform when a station logs in/out locally
3709 </tt>
3710
3711 <P>
3712 <sect1>unset/privilege
3713
3714 <P>
3715 <tt>
3716 <bf>unset/privilege</bf> Remove any privilege for this session
3717 </tt>
3718
3719 <P>
3720 You can use this command to 'protect' this session from unauthorised
3721 use. If you want to get your normal privilege back you will need to
3722 either logout and login again (if you are on a console) or use the
3723 SYSOP command.
3724 <sect1>unset/prompt
3725
3726 <P>
3727 <tt>
3728 <bf>unset/prompt</bf> Set your prompt back to default
3729 </tt>
3730
3731 <P>
3732 This command will set your user prompt to the string that you 
3733 say. The point of this command to enable a user to interface to programs
3734 that are looking for a specific prompt (or else you just want a different
3735 prompt).
3736
3737 <tscreen><verb>
3738   SET/PROMPT clx &gt;
3739 </verb></tscreen>
3740
3741 There are some substitutions that can be added to the prompt:
3742
3743 <tscreen><verb>
3744   %C - callsign [which will have ( and ) around it if not here]
3745   %D - date
3746   %T - time
3747   %M - cluster 'mycall'
3748 </verb></tscreen>
3749
3750 The standard prompt is defined as:
3751
3752 <tscreen><verb>
3753   SET/PROMPT %C de %M %D %T dxspider &gt;
3754 </verb></tscreen>
3755
3756 UNSET/PROMPT will undo the SET/PROMPT command and set your prompt back to
3757 normal.
3758 <sect1>unset/startup
3759
3760 <P>
3761 <tt>
3762 <bf>unset/startup</bf> Remove your own startup script
3763 </tt>
3764
3765 <P>
3766 You can remove your startup script with UNSET/STARTUP.  
3767 <sect1>unset/talk
3768
3769 <P>
3770 <tt>
3771 <bf>unset/talk</bf> Stop TALK messages coming out on your terminal
3772 </tt>
3773
3774 <P>
3775 <sect1>unset/usstate
3776
3777 <P>
3778 <tt>
3779 <bf>unset/usstate</bf> Stop US State info on the end of DX announcements
3780 </tt>
3781
3782 <P>
3783 If the spotter's or spotted's US State is known it is output on the 
3784 end of a DX announcement (there is just enough room). 
3785
3786 A spotter's state will appear on the RHS of the time (like 
3787 SET/DXGRID) and the spotted's State will appear on the LHS of the
3788 time field. Any information found will override any locator 
3789 information from SET/DXGRID.
3790
3791 Some user programs cannot cope with this. You can use this command 
3792 to reset (or set) this feature.
3793
3794 Conflicts with: SET/DXCQ, SET/DXITU
3795
3796 Do a STAT/USER to see which flags you have set if you are confused.  
3797 <sect1>unset/wcy
3798
3799 <P>
3800 <tt>
3801 <bf>unset/wcy</bf> Stop WCY messages coming out on your terminal
3802 </tt>
3803
3804 <P>
3805 <sect1>unset/wwv
3806
3807 <P>
3808 <tt>
3809 <bf>unset/wwv</bf> Stop WWV messages coming out on your terminal
3810 </tt>
3811
3812 <P>
3813 <sect1>unset/wx
3814
3815 <P>
3816 <tt>
3817 <bf>unset/wx</bf> Stop WX messages coming out on your terminal
3818 </tt>
3819
3820 <P>
3821 <sect1>who
3822
3823 <P>
3824 <tt>
3825 <bf>who</bf> Show who is physically connected
3826 </tt>
3827
3828 <P>
3829 This is a quick listing that shows which callsigns are connected and
3830 what sort of connection they have
3831 <sect1>wx &lt;text&gt;
3832
3833 <P>
3834 <tt>
3835 <bf>wx &lt;text&gt;</bf> Send a weather message to local users
3836 </tt>
3837
3838 <P>
3839 <sect1>wx full &lt;text&gt;
3840
3841 <P>
3842 <tt>
3843 <bf>wx full &lt;text&gt;</bf> Send a weather message to all cluster users
3844 </tt>
3845
3846 <P>
3847 </article>