ade4c0d94ad5e25a100900e41eb3d66a614cff61
[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.50</title> 
8 <author>Ian Maude, G0VGS, (g0vgs@gb7mbc.net)</author>
9 <date>March 2003 revision 0.4</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
1019 <sect1>accept
1020
1021 <P>
1022 <tt>
1023 <bf>accept</bf> Set a filter to accept something
1024 </tt>
1025
1026 <P>
1027 Create a filter to accept something
1028
1029 There are 2 types of filter, accept and reject.  See HELP FILTERING for more
1030 info.
1031 <sect1>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;
1032
1033 <P>
1034 <tt>
1035 <bf>accept/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an 'accept' filter line for announce
1036 </tt>
1037
1038 <P>
1039 Create an 'accept this announce' line for a filter. 
1040
1041 An accept filter line means that if the announce matches this filter it is
1042 passed onto the user. See HELP FILTERING for more info. Please read this
1043 to understand how filters work - it will save a lot of grief later on.
1044
1045 You can use any of the following things in this line:-
1046
1047 <tscreen><verb>
1048   info &lt;string&gt;            eg: iota or qsl
1049   by &lt;prefixes&gt;            eg: G,M,2         
1050   origin &lt;prefixes&gt;
1051   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1052   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1053   origin_zone &lt;prefixes or numbers&gt;
1054   origin_state &lt;states&gt;                eg: VA,NH,RI,NH
1055   by_dxcc &lt;prefixes or numbers&gt;
1056   by_itu &lt;prefixes or numbers&gt;
1057   by_zone &lt;prefixes or numbers&gt;
1058   by_state &lt;states&gt;
1059   channel &lt;prefixes&gt;
1060   wx 1                     filter WX announces
1061   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
1062 </verb></tscreen>
1063
1064 some examples:-
1065
1066 <tscreen><verb>
1067   acc/ann dest 6MUK
1068   acc/ann 2 by_zone 14,15,16
1069   (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
1070 </verb></tscreen>
1071 or
1072 <tscreen><verb>
1073   acc/ann by G,M,2 
1074 </verb></tscreen>
1075
1076 for american states
1077
1078 <tscreen><verb>
1079   acc/ann by_state va,nh,ri,nh
1080 </verb></tscreen>
1081
1082 You can use the tag 'all' to accept everything eg:
1083
1084 <tscreen><verb>
1085   acc/ann all
1086 </verb></tscreen>
1087
1088 but this probably for advanced users...
1089 <sect1>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;
1090
1091 <P>
1092 <tt>
1093 <bf>accept/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set an 'accept' filter line for spots
1094 </tt>
1095
1096 <P>
1097 Create an 'accept this spot' line for a filter. 
1098
1099 An accept filter line means that if the spot matches this filter it is
1100 passed onto the user. See HELP FILTERING for more info. Please read this
1101 to understand how filters work - it will save a lot of grief later on.
1102
1103 You can use any of the following things in this line:-
1104
1105 <tscreen><verb>
1106   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
1107   on &lt;range&gt;             same as 'freq'
1108   call &lt;prefixes&gt;        eg: G,PA,HB9
1109   info &lt;string&gt;          eg: iota or qsl
1110   by &lt;prefixes&gt;            
1111   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1112   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1113   call_zone &lt;prefixes or numbers&gt;
1114   call_state &lt;states&gt;                eg: VA,NH,RI,ME
1115   by_dxcc &lt;prefixes or numbers&gt;
1116   by_itu &lt;prefixes or numbers&gt;
1117   by_zone &lt;prefixes or numbers&gt;
1118   by_state &lt;states&gt;                eg: VA,NH,RI,ME
1119   origin &lt;prefixes&gt;
1120   channel &lt;prefixes&gt;
1121 </verb></tscreen>
1122
1123 'call' means the callsign that has spotted 'by' whoever.
1124
1125 For frequencies, you can use any of the band names defined in
1126 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
1127 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
1128 this is more efficient than saying simply: freq HF (but don't get
1129 too hung up about that)
1130
1131 some examples:-
1132
1133 <tscreen><verb>
1134   acc/spot 1 on hf/cw
1135   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1136 </verb></tscreen>
1137
1138 You can use the tag 'all' to accept everything, eg:
1139
1140 <tscreen><verb>
1141   acc/spot 3 all
1142 </verb></tscreen>
1143
1144 for US states 
1145
1146 <tscreen><verb>
1147   acc/spots by_state VA,NH,RI,MA,ME
1148 </verb></tscreen>
1149
1150 but this probably for advanced users...
1151 <sect1>accept/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;
1152
1153 <P>
1154 <tt>
1155 <bf>accept/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set an 'accept' WCY filter
1156 </tt>
1157
1158 <P>
1159 It is unlikely that you will want to do this, but if you do then you can
1160 filter on the following fields:-
1161
1162 <tscreen><verb>
1163   by &lt;prefixes&gt;            eg: G,M,2         
1164   origin &lt;prefixes&gt;
1165   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1166   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1167   origin_zone &lt;prefixes or numbers&gt;
1168   by_dxcc &lt;prefixes or numbers&gt;
1169   by_itu &lt;prefixes or numbers&gt;
1170   by_zone &lt;prefixes or numbers&gt;
1171   channel &lt;prefixes&gt;
1172 </verb></tscreen>
1173
1174 There are no examples because WCY Broadcasts only come from one place and
1175 you either want them or not (see UNSET/WCY if you don't want them).
1176
1177 This command is really provided for future use.
1178
1179 See HELP FILTER for information.
1180 <sect1>accept/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;
1181
1182 <P>
1183 <tt>
1184 <bf>accept/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set an 'accept' WWV filter
1185 </tt>
1186
1187 <P>
1188 It is unlikely that you will want to do this, but if you do then you can
1189 filter on the following fields:-
1190
1191 <tscreen><verb>
1192   by &lt;prefixes&gt;            eg: G,M,2         
1193   origin &lt;prefixes&gt;
1194   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1195   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1196   origin_zone &lt;prefixes or numbers&gt;
1197   by_dxcc &lt;prefixes or numbers&gt;
1198   by_itu &lt;prefixes or numbers&gt;
1199   by_zone &lt;prefixes or numbers&gt;
1200   channel &lt;prefixes&gt;
1201 </verb></tscreen>
1202
1203 for example 
1204
1205 <tscreen><verb>
1206   accept/wwv by_zone 4
1207 </verb></tscreen>
1208
1209 is probably the only useful thing to do (which will only show WWV broadcasts
1210 by stations in the US).
1211
1212 See HELP FILTER for information.
1213 <sect1>announce &lt;text&gt;
1214
1215 <P>
1216 <tt>
1217 <bf>announce &lt;text&gt;</bf> Send an announcement to LOCAL users only
1218 </tt>
1219
1220 <P>
1221 &lt;text&gt; is the text of the announcement you wish to broadcast 
1222 <sect1>announce full &lt;text&gt;
1223
1224 <P>
1225 <tt>
1226 <bf>announce full &lt;text&gt;</bf> Send an announcement cluster wide
1227 </tt>
1228
1229 <P>
1230 This will send your announcement cluster wide
1231 <sect1>apropos &lt;string&gt;
1232
1233 <P>
1234 <tt>
1235 <bf>apropos &lt;string&gt;</bf> Search help database for &lt;string&gt;
1236 </tt>
1237
1238 <P>
1239 Search the help database for &lt;string&gt; (it isn't case sensitive), and print
1240 the names of all the commands that may be relevant.
1241 <sect1>blank &lsqb;&lt;string&gt;&rsqb; &lsqb;&lt;nn&gt;&rsqb;
1242
1243 <P>
1244 <tt>
1245 <bf>blank &lsqb;&lt;string&gt;&rsqb; &lsqb;&lt;nn&gt;&rsqb;</bf> Print nn (default 1) blank lines (or strings)
1246 </tt>
1247
1248 <P>
1249 In its basic form this command prints one or more blank lines. However if
1250 you pass it a string it will replicate the string for the width of the 
1251 screen (default 80) and then print that one or more times, so:
1252
1253 <tscreen><verb>
1254   blank 2
1255 </verb></tscreen>
1256
1257 prints two blank lines
1258
1259 <tscreen><verb>
1260   blank - 
1261 </verb></tscreen>
1262
1263 prints a row of - characters once.
1264
1265 <tscreen><verb>
1266   blank abc
1267 </verb></tscreen>
1268
1269 prints 'abcabcabcabcabcabc....'
1270
1271 This is really only of any use in a script file and you can print a maximum
1272 of 9 lines.
1273 <sect1>bye
1274
1275 <P>
1276 <tt>
1277 <bf>bye</bf> Exit from the cluster
1278 </tt>
1279
1280 <P>
1281 This will disconnect you from the cluster
1282 <sect1>chat &lt;group&gt; &lt;text&gt;
1283
1284 <P>
1285 <tt>
1286 <bf>chat &lt;group&gt; &lt;text&gt;</bf> Chat or Conference to a group
1287 </tt>
1288
1289 <P>
1290 It is now possible to JOIN a group and have network wide conferencing to that
1291 group. DXSpider does not (and probably will not) implement the AK1A 
1292 conference mode as this seems very limiting, is hardly used and doesn't seem
1293 to work too well anyway.
1294
1295 This system uses the existing ANN system and is compatible with both other
1296 DXSpider nodes and AK1A clusters (they use ANN/&lt;group&gt;). 
1297
1298 You can be a member of as many "groups" as you want. To join a group type:-
1299
1300 <tscreen><verb>
1301   JOIN FOC    (where FOC is the group name)
1302 </verb></tscreen>
1303
1304 To leave a group type:-
1305
1306 <tscreen><verb>
1307   LEAVE FOC
1308 </verb></tscreen>
1309
1310 You can see which groups you are in by typing:-
1311
1312 <tscreen><verb>
1313   STAT/USER
1314 </verb></tscreen>
1315
1316 and you can see whether your mate is in the group, if he connects to the
1317 same node as you, by typing:-
1318
1319 <tscreen><verb>
1320   STAT/USER g1tlh
1321 </verb></tscreen>
1322
1323 To send a message to a group type:-
1324
1325 <tscreen><verb>
1326   CHAT FOC hello everyone
1327 </verb></tscreen>
1328
1329 or
1330
1331 <tscreen><verb>
1332   CH #9000 hello I am back
1333 </verb></tscreen>
1334
1335 See also JOIN, LEAVE, SHOW/CHAT
1336 <sect1>clear/announce &lsqb;1|all&rsqb;
1337
1338 <P>
1339 <tt>
1340 <bf>clear/announce &lsqb;1|all&rsqb;</bf> Clear a announce filter line
1341 </tt>
1342
1343 <P>
1344 This command allows you to clear (remove) a line in a annouce filter or to 
1345 remove the whole filter.
1346
1347 see CLEAR/SPOTS for a more detailed explanation.
1348 <sect1>clear/route &lsqb;1|all&rsqb;
1349
1350 <P>
1351 <tt>
1352 <bf>clear/route &lsqb;1|all&rsqb;</bf> Clear a route filter line
1353 </tt>
1354
1355 <P>
1356 This command allows you to clear (remove) a line in a route filter or to 
1357 remove the whole filter.
1358
1359 see CLEAR/SPOTS for a more detailed explanation.
1360 <sect1>clear/spots &lsqb;0-9|all&rsqb;
1361
1362 <P>
1363 <tt>
1364 <bf>clear/spots &lsqb;0-9|all&rsqb;</bf> Clear a spot filter line
1365 </tt>
1366
1367 <P>
1368 This command allows you to clear (remove) a line in a spot filter or to 
1369 remove the whole filter.
1370
1371 If you have a filter:-
1372
1373 <tscreen><verb>
1374   acc/spot 1 on hf/cw
1375   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1376 </verb></tscreen>
1377
1378 and you say:-
1379
1380 <tscreen><verb>
1381   clear/spot 1
1382 </verb></tscreen>
1383
1384 you will be left with:-
1385
1386 <tscreen><verb>
1387   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1388 </verb></tscreen>
1389
1390 If you do:
1391
1392 <tscreen><verb>
1393   clear/spot all
1394 </verb></tscreen>
1395
1396 the filter will be completely removed.
1397 <sect1>clear/wcy &lsqb;1|all&rsqb;
1398
1399 <P>
1400 <tt>
1401 <bf>clear/wcy &lsqb;1|all&rsqb;</bf> Clear a WCY filter line
1402 </tt>
1403
1404 <P>
1405 This command allows you to clear (remove) a line in a WCY filter or to 
1406 remove the whole filter.
1407
1408 see CLEAR/SPOTS for a more detailed explanation.
1409 <sect1>clear/wwv &lsqb;1|all&rsqb;
1410
1411 <P>
1412 <tt>
1413 <bf>clear/wwv &lsqb;1|all&rsqb;</bf> Clear a WWV filter line
1414 </tt>
1415
1416 <P>
1417 This command allows you to clear (remove) a line in a WWV filter or to 
1418 remove the whole filter.
1419
1420 see CLEAR/SPOTS for a more detailed explanation.
1421 <sect1>dbavail
1422
1423 <P>
1424 <tt>
1425 <bf>dbavail</bf> Show a list of all the Databases in the system
1426 </tt>
1427
1428 <P>
1429 Title says it all really, this command lists all the databases defined
1430 in the system. It is also aliased to SHOW/COMMAND.
1431 <sect1>dbshow &lt;dbname&gt; &lt;key&gt;
1432
1433 <P>
1434 <tt>
1435 <bf>dbshow &lt;dbname&gt; &lt;key&gt;</bf> Display an entry, if it exists, in a database
1436 </tt>
1437
1438 <P>
1439 This is the generic user interface to the database to the database system.
1440 It is expected that the sysop will add an entry to the local Aliases file
1441 so that users can use the more familiar AK1A style of enquiry such as:
1442
1443 <tscreen><verb>
1444   SH/BUCK G1TLH
1445 </verb></tscreen>
1446
1447 but if he hasn't and the database really does exist (use DBAVAIL or
1448 SHOW/COMMAND to find out) you can do the same thing with:
1449
1450 <tscreen><verb>
1451   DBSHOW buck G1TLH
1452 </verb></tscreen>
1453
1454 <sect1>directory
1455
1456 <P>
1457 <tt>
1458 <bf>directory</bf> List messages 
1459 </tt>
1460
1461 <P>
1462 <sect1>directory &lt;from&gt;-&lt;to&gt;
1463
1464 <P>
1465 <tt>
1466 <bf>directory &lt;from&gt;-&lt;to&gt;</bf> List messages &lt;from&gt; message &lt;to&gt; message 
1467 </tt>
1468
1469 <P>
1470 List the messages in the messages directory.
1471
1472 If there is a 'p' one space after the message number then it is a 
1473 personal message. If there is a '-' between the message number and the
1474 'p' then this indicates that the message has been read.
1475
1476 You can use shell escape characters such as '*' and '?' in the &lt;call&gt;
1477 fields.
1478
1479 You can combine some of the various directory commands together eg:-
1480
1481 <tscreen><verb>
1482    DIR TO G1TLH 5
1483 </verb></tscreen>
1484 or 
1485 <tscreen><verb>
1486    DIR SUBJECT IOTA 200-250
1487 </verb></tscreen>
1488
1489 You can abbreviate all the commands to one letter and use ak1a syntax:-
1490
1491 <tscreen><verb>
1492    DIR/T G1* 10
1493    DIR/S QSL 10-100 5
1494 </verb></tscreen>
1495
1496 <sect1>directory &lt;nn&gt;
1497
1498 <P>
1499 <tt>
1500 <bf>directory &lt;nn&gt;</bf> List last &lt;nn&gt; messages
1501 </tt>
1502
1503 <P>
1504 <sect1>directory all
1505
1506 <P>
1507 <tt>
1508 <bf>directory all</bf> List all messages
1509 </tt>
1510
1511 <P>
1512 <sect1>directory from &lt;call&gt;
1513
1514 <P>
1515 <tt>
1516 <bf>directory from &lt;call&gt;</bf> List all messages from &lt;call&gt;
1517 </tt>
1518
1519 <P>
1520 <sect1>directory new
1521
1522 <P>
1523 <tt>
1524 <bf>directory new</bf> List all new messages
1525 </tt>
1526
1527 <P>
1528 <sect1>directory own
1529
1530 <P>
1531 <tt>
1532 <bf>directory own</bf> List your own messages
1533 </tt>
1534
1535 <P>
1536 <sect1>directory subject &lt;string&gt;
1537
1538 <P>
1539 <tt>
1540 <bf>directory subject &lt;string&gt;</bf> List all messages with &lt;string&gt; in subject
1541 </tt>
1542
1543 <P>
1544 <sect1>directory to &lt;call&gt;
1545
1546 <P>
1547 <tt>
1548 <bf>directory to &lt;call&gt;</bf> List all messages to &lt;call&gt;
1549 </tt>
1550
1551 <P>
1552 <sect1>dx &lsqb;by &lt;call&gt;&rsqb; &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;
1553
1554 <P>
1555 <tt>
1556 <bf>dx &lsqb;by &lt;call&gt;&rsqb; &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</bf> Send a DX spot
1557 </tt>
1558
1559 <P>
1560 This is how you send a DX Spot to other users. You can, in fact, now
1561 enter the &lt;freq&gt; and the &lt;call&gt; either way round. 
1562
1563 <tscreen><verb>
1564    DX FR0G 144.600
1565    DX 144.600 FR0G
1566    DX 144600 FR0G 
1567 </verb></tscreen>
1568
1569 will all give the same result. You can add some remarks to the end
1570 of the command and they will be added to the spot.
1571
1572 <tscreen><verb>
1573    DX FR0G 144600 this is a test
1574 </verb></tscreen>
1575
1576 You can credit someone else by saying:-
1577
1578 <tscreen><verb>
1579    DX by G1TLH FR0G 144.600 he isn't on the cluster
1580 </verb></tscreen>
1581
1582 The &lt;freq&gt; is compared against the available bands set up in the 
1583 cluster.  See SHOW/BANDS for more information.
1584 <sect1>echo &lt;line&gt;
1585
1586 <P>
1587 <tt>
1588 <bf>echo &lt;line&gt;</bf> Echo the line to the output
1589 </tt>
1590
1591 <P>
1592 This command is useful in scripts and so forth for printing the
1593 line that you give to the command to the output. You can use this
1594 in user_default scripts and the SAVE command for titling and so forth
1595
1596 The script will interpret certain standard "escape" sequences as follows:-
1597
1598 <tscreen><verb>
1599   \t - becomes a TAB character (0x09 in ascii)
1600   \a - becomes a BEEP character (0x07 in ascii)
1601   \n - prints a new line
1602 </verb></tscreen>
1603
1604 So the following example:-
1605
1606 <tscreen><verb>
1607   echo GB7DJK is a dxcluster
1608 </verb></tscreen>
1609
1610 produces:-
1611
1612 <tscreen><verb>
1613   GB7DJK is a dxcluster
1614 </verb></tscreen>
1615
1616 on the output. You don't need a \n on the end of the line you want to send.
1617
1618 A more complex example:-
1619
1620 <tscreen><verb>
1621   echo GB7DJK\n\tg1tlh\tDirk\n\tg3xvf\tRichard
1622 </verb></tscreen>
1623
1624 produces:-
1625
1626 <tscreen><verb>
1627   GB7DJK
1628           g1tlh   Dirk
1629           g3xvf   Richard
1630 </verb></tscreen>
1631
1632 on the output.
1633                                       
1634 <sect1>filtering...
1635
1636 <P>
1637 <tt>
1638 <bf>filtering...</bf> Filtering things in DXSpider
1639 </tt>
1640
1641 <P>
1642 There are a number of things you can filter in the DXSpider system. They
1643 all use the same general mechanism.
1644
1645 In general terms you can create a 'reject' or an 'accept' filter which
1646 can have up to 10 lines in it. You do this using, for example:-
1647  
1648 <tscreen><verb>
1649   accept/spots .....
1650   reject/spots .....
1651 </verb></tscreen>
1652
1653 where ..... are the specific commands for that type of filter. There
1654 are filters for spots, wwv, announce, wcy and (for sysops)
1655 connects. See each different accept or reject command reference for
1656 more details.
1657
1658 There is also a command to clear out one or more lines in a filter and
1659 one to show you what you have set. They are:-
1660
1661 <tscreen><verb>
1662   clear/spots 1
1663   clear/spots all
1664 </verb></tscreen>
1665
1666 and 
1667   
1668 <tscreen><verb>
1669   show/filter
1670 </verb></tscreen>
1671
1672 There is clear/xxxx command for each type of filter.
1673
1674 For now we are going to use spots for the examples, but you can apply
1675 the principles to all types of filter.
1676
1677 There are two main types of filter 'accept' or 'reject'; which you use
1678 depends entirely on how you look at the world and what is least
1679 writing to achieve what you want. Each filter has 10 lines (of any
1680 length) which are tried in order. If a line matches then the action
1681 you have specified is taken (ie reject means ignore it and accept
1682 means gimme it).
1683
1684 The important thing to remember is that if you specify a 'reject'
1685 filter (all the lines in it say 'reject/spots' (for instance)) then if
1686 a spot comes in that doesn't match any of the lines then you will get
1687 it BUT if you specify an 'accept' filter then any spots that don't
1688 match are dumped. For example if I have a one line accept filter:-
1689
1690 <tscreen><verb>
1691   accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1692 </verb></tscreen>
1693
1694 then automatically you will ONLY get VHF spots from or to CQ zones 14
1695 15 and 16.  If you set a reject filter like:
1696
1697 <tscreen><verb>
1698   reject/spots on hf/cw
1699 </verb></tscreen>
1700
1701 Then you will get everything EXCEPT HF CW spots, If you am interested in IOTA
1702 and will work it even on CW then you could say:-
1703
1704 <tscreen><verb>
1705   reject/spots on hf/cw and not info iota
1706 </verb></tscreen>
1707
1708 But in that case you might only be interested in iota and say:-
1709
1710 <tscreen><verb>
1711   accept/spots not on hf/cw or info iota
1712 </verb></tscreen>
1713
1714 which is exactly the same. You should choose one or the other until
1715 you are confortable with the way it works. Yes, you can mix them
1716 (actually you can have an accept AND a reject on the same line) but
1717 don't try this at home until you can analyse the results that you get
1718 without ringing up the sysop for help.
1719
1720 Another useful addition now is filtering by US state
1721
1722 <tscreen><verb>
1723   accept/spots by_state VA,NH,RI,ME
1724 </verb></tscreen>
1725
1726 You can arrange your filter lines into logical units, either for your
1727 own understanding or simply convenience. I have one set frequently:-
1728
1729 <tscreen><verb>
1730   reject/spots 1 on hf/cw
1731   reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
1732 </verb></tscreen>
1733
1734 What this does is to ignore all HF CW spots (being a class B I can't
1735 read any CW and couldn't possibly be interested in HF :-) and also
1736 rejects any spots on VHF which don't either originate or spot someone
1737 in Europe.
1738
1739 This is an exmaple where you would use the line number (1 and 2 in
1740 this case), if you leave the digit out, the system assumes '1'. Digits
1741 '0'-'9' are available.
1742
1743 You can leave the word 'and' out if you want, it is implied. You can
1744 use any number of brackets to make the 'expression' as you want
1745 it. There are things called precedence rules working here which mean
1746 that you will NEED brackets in a situation like line 2 because,
1747 without it, will assume:-
1748
1749 <tscreen><verb>
1750   (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
1751 </verb></tscreen>
1752
1753 annoying, but that is the way it is. If you use OR - use
1754 brackets. Whilst we are here CASE is not important. 'And BY_Zone' is
1755 just 'and by_zone'.
1756
1757 If you want to alter your filter you can just redefine one or more
1758 lines of it or clear out one line. For example:-
1759
1760 <tscreen><verb>
1761   reject/spots 1 on hf/ssb
1762 </verb></tscreen>
1763
1764 or 
1765
1766 <tscreen><verb>
1767   clear/spots 1
1768 </verb></tscreen>
1769
1770 To remove the filter in its entirty:-
1771
1772 <tscreen><verb>
1773   clear/spots all
1774 </verb></tscreen>
1775
1776 There are similar CLEAR commands for the other filters:-
1777
1778 <tscreen><verb>
1779   clear/announce
1780   clear/wcy
1781   clear/wwv
1782 </verb></tscreen>
1783
1784 ADVANCED USERS:-
1785
1786 Once you are happy with the results you get, you may like to experiment. 
1787
1788 my example that filters hf/cw spots and accepts vhf/uhf spots from EU
1789 can be written with a mixed filter, eg:
1790
1791 <tscreen><verb>
1792   rej/spot on hf/cw
1793   acc/spot on 0/30000
1794   acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
1795 </verb></tscreen>
1796
1797 each filter slot actually has a 'reject' slot and an 'accept'
1798 slot. The reject slot is executed BEFORE the accept slot.
1799
1800 It was mentioned earlier that after a reject test that doesn't match,
1801 the default for following tests is 'accept', the reverse is true for
1802 'accept'. In the example what happens is that the reject is executed
1803 first, any non hf/cw spot is passed to the accept line, which lets
1804 thru everything else on HF.
1805
1806 The next filter line lets through just VHF/UHF spots from EU.
1807 <sect1>help
1808
1809 <P>
1810 <tt>
1811 <bf>help</bf> The HELP Command
1812 </tt>
1813
1814 <P>
1815 HELP is available for a number of commands. The syntax is:-
1816
1817 <tscreen><verb>
1818   HELP &lt;cmd&gt;
1819 </verb></tscreen>
1820   
1821 Where &lt;cmd&gt; is the name of the command you want help on.
1822
1823 All commands can be abbreviated, so SHOW/DX can be abbreviated
1824 to SH/DX, ANNOUNCE can be shortened to AN and so on.
1825
1826 Look at the APROPOS &lt;string&gt; command which will search the help database
1827 for the &lt;string&gt; you specify and give you a list of likely commands
1828 to look at with HELP.
1829 <sect1>join &lt;group&gt;
1830
1831 <P>
1832 <tt>
1833 <bf>join &lt;group&gt;</bf> Join a chat or conference group
1834 </tt>
1835
1836 <P>
1837 JOIN allows you to join a network wide conference group. To join a
1838 group (called FOC in this case) type:-
1839
1840 <tscreen><verb>
1841   JOIN FOC
1842 </verb></tscreen>
1843
1844 See also CHAT, LEAVE, SHOW/CHAT
1845 <sect1>kill &lt;from msgno&gt;-&lt;to msgno&gt;
1846
1847 <P>
1848 <tt>
1849 <bf>kill &lt;from msgno&gt;-&lt;to msgno&gt;</bf> Delete a range of messages
1850 </tt>
1851
1852 <P>
1853 <sect1>kill &lt;msgno&gt; &lsqb;&lt;msgno..&rsqb;
1854
1855 <P>
1856 <tt>
1857 <bf>kill &lt;msgno&gt; &lsqb;&lt;msgno..&rsqb;</bf> Delete a message from the local system
1858 </tt>
1859
1860 <P>
1861 <sect1>kill &lt;msgno&gt; &lsqb;&lt;msgno&gt; ...&rsqb;
1862
1863 <P>
1864 <tt>
1865 <bf>kill &lt;msgno&gt; &lsqb;&lt;msgno&gt; ...&rsqb;</bf> Remove or erase a message from the system
1866 </tt>
1867
1868 <P>
1869 You can get rid of any message to or originating from your callsign using 
1870 this command. You can remove more than one message at a time.
1871 <sect1>kill from &lt;regex&gt;
1872
1873 <P>
1874 <tt>
1875 <bf>kill from &lt;regex&gt;</bf> Delete messages FROM a callsign or pattern
1876 </tt>
1877
1878 <P>
1879 <sect1>kill to &lt;regex&gt;
1880
1881 <P>
1882 <tt>
1883 <bf>kill to &lt;regex&gt;</bf> Delete messages TO a callsign or pattern
1884 </tt>
1885
1886 <P>
1887 <sect1>leave &lt;group&gt;
1888
1889 <P>
1890 <tt>
1891 <bf>leave &lt;group&gt;</bf> Leave a chat or conference group
1892 </tt>
1893
1894 <P>
1895 LEAVE allows you to leave a network wide conference group. To leave a
1896 group (called FOC in this case) type:-
1897
1898 <tscreen><verb>
1899   LEAVE FOC
1900 </verb></tscreen>
1901
1902 See also CHAT, JOIN, SHOW/CHAT
1903 <sect1>links
1904
1905 <P>
1906 <tt>
1907 <bf>links</bf> Show which nodes is physically connected
1908 </tt>
1909
1910 <P>
1911 This is a quick listing that shows which links are connected and
1912 some information about them. See WHO for a list of all connections.
1913 <sect1>read
1914
1915 <P>
1916 <tt>
1917 <bf>read</bf> Read the next unread personal message addressed to you
1918 </tt>
1919
1920 <P>
1921 <sect1>read &lt;msgno&gt;
1922
1923 <P>
1924 <tt>
1925 <bf>read &lt;msgno&gt;</bf> Read the specified message
1926 </tt>
1927
1928 <P>
1929 You can read any messages that are sent as 'non-personal' and also any
1930 message either sent by or sent to your callsign.
1931 <sect1>reject
1932
1933 <P>
1934 <tt>
1935 <bf>reject</bf> Set a filter to reject something
1936 </tt>
1937
1938 <P>
1939 Create a filter to reject something
1940
1941 There are 2 types of filter, accept and reject.  See HELP FILTERING for more
1942 info.
1943 <sect1>reject/announce &lsqb;0-9&rsqb; &lt;pattern&gt;
1944
1945 <P>
1946 <tt>
1947 <bf>reject/announce &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a 'reject' filter line for announce
1948 </tt>
1949
1950 <P>
1951 Create an 'reject this announce' line for a filter. 
1952
1953 A reject filter line means that if the announce matches this filter it is
1954 passed onto the user. See HELP FILTERING for more info. Please read this
1955 to understand how filters work - it will save a lot of grief later on.
1956
1957 You can use any of the following things in this line:-
1958
1959 <tscreen><verb>
1960   info &lt;string&gt;            eg: iota or qsl
1961   by &lt;prefixes&gt;            eg: G,M,2         
1962   origin &lt;prefixes&gt;
1963   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1964   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1965   origin_zone &lt;prefixes or numbers&gt;
1966   origin_state &lt;states&gt;                eg: VA,NH,RI,ME
1967   by_dxcc &lt;prefixes or numbers&gt;
1968   by_itu &lt;prefixes or numbers&gt;
1969   by_zone &lt;prefixes or numbers&gt;
1970   by_state &lt;states&gt;                eg: VA,NH,RI,ME
1971   channel &lt;prefixes&gt;
1972   wx 1                     filter WX announces
1973   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
1974 </verb></tscreen>
1975
1976 some examples:-
1977
1978 <tscreen><verb>
1979   rej/ann by_zone 14,15,16 and not by G,M,2
1980 </verb></tscreen>
1981  
1982 You can use the tag 'all' to reject everything eg:
1983
1984 <tscreen><verb>
1985   rej/ann all
1986 </verb></tscreen>
1987
1988 but this probably for advanced users...
1989 <sect1>reject/spots &lsqb;0-9&rsqb; &lt;pattern&gt;
1990
1991 <P>
1992 <tt>
1993 <bf>reject/spots &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> Set a 'reject' filter line for spots
1994 </tt>
1995
1996 <P>
1997 Create a 'reject this spot' line for a filter. 
1998
1999 A reject filter line means that if the spot matches this filter it is
2000 dumped (not passed on). See HELP FILTERING for more info. Please read this
2001 to understand how filters work - it will save a lot of grief later on.
2002
2003 You can use any of the following things in this line:-
2004
2005 <tscreen><verb>
2006   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
2007   on &lt;range&gt;             same as 'freq'
2008   call &lt;prefixes&gt;        eg: G,PA,HB9
2009   info &lt;string&gt;          eg: iota or qsl
2010   by &lt;prefixes&gt;            
2011   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2012   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2013   call_zone &lt;prefixes or numbers&gt;
2014   call_state &lt;states&gt;                eg: VA,NH,RI,ME
2015   by_dxcc &lt;prefixes or numbers&gt;
2016   by_itu &lt;prefixes or numbers&gt;
2017   by_zone &lt;prefixes or numbers&gt;
2018   by_state &lt;states&gt;                eg: VA,NH,RI,ME
2019   origin &lt;prefixes&gt;
2020   channel &lt;prefixes&gt;
2021 </verb></tscreen>
2022
2023 'call' means the callsign that has spotted 'by' whoever.
2024  
2025 For frequencies, you can use any of the band names defined in
2026 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
2027 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
2028 this is more efficient than saying simply: on HF (but don't get
2029 too hung up about that)
2030
2031 some examples:-
2032
2033 <tscreen><verb>
2034   rej/spot 1 on hf
2035   rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
2036 </verb></tscreen>
2037
2038 You can use the tag 'all' to reject everything eg:
2039
2040 <tscreen><verb>
2041   rej/spot 3 all
2042 </verb></tscreen>
2043
2044 but this probably for advanced users...
2045 <sect1>reject/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;
2046
2047 <P>
2048 <tt>
2049 <bf>reject/wcy &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set a 'reject' WCY filter
2050 </tt>
2051
2052 <P>
2053 It is unlikely that you will want to do this, but if you do then you can
2054 filter on the following fields:-
2055
2056 <tscreen><verb>
2057   by &lt;prefixes&gt;            eg: G,M,2         
2058   origin &lt;prefixes&gt;
2059   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2060   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2061   origin_zone &lt;prefixes or numbers&gt;
2062   by_dxcc &lt;prefixes or numbers&gt;
2063   by_itu &lt;prefixes or numbers&gt;
2064   by_zone &lt;prefixes or numbers&gt;
2065   channel &lt;prefixes&gt;
2066 </verb></tscreen>
2067
2068 There are no examples because WCY Broadcasts only come from one place and
2069 you either want them or not (see UNSET/WCY if you don't want them).
2070
2071 This command is really provided for future use.
2072
2073 See HELP FILTER for information.
2074 <sect1>reject/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;
2075
2076 <P>
2077 <tt>
2078 <bf>reject/wwv &lsqb;0-9&rsqb; &lt;pattern&gt;</bf> set a 'reject' WWV filter
2079 </tt>
2080
2081 <P>
2082 It is unlikely that you will want to do this, but if you do then you can
2083 filter on the following fields:-
2084
2085 <tscreen><verb>
2086   by &lt;prefixes&gt;            eg: G,M,2         
2087   origin &lt;prefixes&gt;
2088   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
2089   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
2090   origin_zone &lt;prefixes or numbers&gt;
2091   by_dxcc &lt;prefixes or numbers&gt;
2092   by_itu &lt;prefixes or numbers&gt;
2093   by_zone &lt;prefixes or numbers&gt;
2094   channel &lt;prefixes&gt;
2095 </verb></tscreen>
2096
2097 for example 
2098
2099 <tscreen><verb>
2100   reject/wwv by_zone 14,15,16
2101 </verb></tscreen>
2102
2103 is probably the only useful thing to do (which will only show WWV broadcasts
2104 by stations in the US).
2105
2106 See HELP FILTER for information.
2107 <sect1>reply
2108
2109 <P>
2110 <tt>
2111 <bf>reply</bf> Reply (privately) to the last message that you have read
2112 </tt>
2113
2114 <P>
2115 <sect1>reply &lt;msgno&gt;
2116
2117 <P>
2118 <tt>
2119 <bf>reply &lt;msgno&gt;</bf> Reply (privately) to the specified message
2120 </tt>
2121
2122 <P>
2123 <sect1>reply b &lt;msgno&gt;
2124
2125 <P>
2126 <tt>
2127 <bf>reply b &lt;msgno&gt;</bf> Reply as a Bulletin to the specified message
2128 </tt>
2129
2130 <P>
2131 <sect1>reply noprivate &lt;msgno&gt;
2132
2133 <P>
2134 <tt>
2135 <bf>reply noprivate &lt;msgno&gt;</bf> Reply as a Bulletin to the specified message
2136 </tt>
2137
2138 <P>
2139 <sect1>reply rr &lt;msgno&gt;
2140
2141 <P>
2142 <tt>
2143 <bf>reply rr &lt;msgno&gt;</bf> Reply to the specified message with read receipt
2144 </tt>
2145
2146 <P>
2147 You can reply to a message and the subject will automatically have
2148 "Re:" inserted in front of it, if it isn't already present.
2149
2150 You can also use all the extra qualifiers such as RR, PRIVATE, 
2151 NOPRIVATE, B that you can use with the SEND command (see SEND
2152 for further details)
2153 <sect1>send &lt;call&gt; &lsqb;&lt;call&gt; ...&rsqb;
2154
2155 <P>
2156 <tt>
2157 <bf>send &lt;call&gt; &lsqb;&lt;call&gt; ...&rsqb;</bf> Send a message to one or more callsigns
2158 </tt>
2159
2160 <P>
2161 <sect1>send copy &lt;msgno&gt; &lt;call&gt;
2162
2163 <P>
2164 <tt>
2165 <bf>send copy &lt;msgno&gt; &lt;call&gt;</bf> Send a copy of a  message to someone
2166 </tt>
2167
2168 <P>
2169 <sect1>send noprivate &lt;call&gt;
2170
2171 <P>
2172 <tt>
2173 <bf>send noprivate &lt;call&gt;</bf> Send a message to all stations
2174 </tt>
2175
2176 <P>
2177 All the SEND commands will create a message which will be sent either to
2178 an individual callsign or to one of the 'bulletin' addresses. 
2179
2180 SEND &lt;call&gt; on its own acts as though you had typed SEND PRIVATE, that is
2181 it will mark the message as personal and send it to the cluster node that
2182 that callsign is connected to. If the &lt;call&gt; you have specified is in fact
2183 a known bulletin category on your node (eg: ALL) then the message should
2184 automatically become a bulletin.
2185
2186 You can have more than one callsign in all of the SEND commands.
2187
2188 You can have multiple qualifiers so that you can have for example:-
2189
2190 <tscreen><verb>
2191   SEND RR COPY 123 PRIVATE G1TLH G0RDI
2192 </verb></tscreen>
2193
2194 which should send a copy of message 123 to G1TLH and G0RDI and you will
2195 receive a read receipt when they have read the message.
2196
2197 SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
2198 SP is an alias for SEND PRIVATE
2199
2200 The system will ask you for a subject. Conventionally this should be 
2201 no longer than 29 characters for compatibility. Most modern cluster
2202 software should accept more.
2203
2204 You will now be prompted to start entering your text. 
2205
2206 You finish the message by entering '/EX' on a new line. For instance:
2207
2208 <tscreen><verb>
2209   ...
2210   bye then Jim
2211   73 Dirk
2212   /ex
2213 </verb></tscreen>
2214
2215 If you have started a message and you don't want to keep it then you
2216 can abandon the message with '/ABORT' on a new line, like:-
2217
2218 <tscreen><verb>
2219   line 1
2220   line 2
2221   oh I just can't be bothered with this
2222   /abort
2223 </verb></tscreen>
2224
2225 If you abort the message it will NOT be sent.
2226
2227 When you are entering the text of your message, most normal output (such
2228 as DX announcements and so on are suppressed and stored for latter display
2229 (upto 20 such lines are stored, as new ones come along, so the oldest
2230 lines are dropped).
2231
2232 Also, you can enter normal commands commands (and get the output 
2233 immediately) whilst in the middle of a message. You do this by typing
2234 the command preceeded by a '/' character on a new line, so:-
2235
2236 <tscreen><verb>
2237   /dx g1tlh 144010 strong signal
2238 </verb></tscreen>
2239
2240 Will issue a dx annoucement to the rest of the cluster. 
2241
2242 Also, you can add the output of a command to your message by preceeding 
2243 the command with '//', thus :-
2244
2245 <tscreen><verb>
2246   //sh/vhftable
2247 </verb></tscreen>
2248
2249 This will show YOU the output from SH/VHFTABLE and also store it in the
2250 message. 
2251
2252 You can carry on with the message until you are ready to send it. 
2253 <sect1>send private &lt;call&gt;
2254
2255 <P>
2256 <tt>
2257 <bf>send private &lt;call&gt;</bf> Send a personal message
2258 </tt>
2259
2260 <P>
2261 <sect1>send rr &lt;call&gt;
2262
2263 <P>
2264 <tt>
2265 <bf>send rr &lt;call&gt;</bf> Send a message and ask for a read receipt
2266 </tt>
2267
2268 <P>
2269 <sect1>set/address &lt;your address&gt;
2270
2271 <P>
2272 <tt>
2273 <bf>set/address &lt;your address&gt;</bf> Record your postal address
2274 </tt>
2275
2276 <P>
2277 <sect1>set/announce
2278
2279 <P>
2280 <tt>
2281 <bf>set/announce</bf> Allow announce messages to come out on your terminal
2282 </tt>
2283
2284 <P>
2285 <sect1>set/anntalk
2286
2287 <P>
2288 <tt>
2289 <bf>set/anntalk</bf> Allow talk like announce messages on your terminal
2290 </tt>
2291
2292 <P>
2293 <sect1>set/beep
2294
2295 <P>
2296 <tt>
2297 <bf>set/beep</bf> Add a beep to DX and other messages on your terminal
2298 </tt>
2299
2300 <P>
2301 <sect1>set/dx
2302
2303 <P>
2304 <tt>
2305 <bf>set/dx</bf> Allow DX messages to come out on your terminal
2306 </tt>
2307
2308 <P>
2309 <sect1>set/dxcq
2310
2311 <P>
2312 <tt>
2313 <bf>set/dxcq</bf> Show CQ Zones on the end of DX announcements
2314 </tt>
2315
2316 <P>
2317 <sect1>set/dxgrid
2318
2319 <P>
2320 <tt>
2321 <bf>set/dxgrid</bf> Allow QRA Grid Squares on the end of DX announcements
2322 </tt>
2323
2324 <P>
2325 <sect1>set/dxitu
2326
2327 <P>
2328 <tt>
2329 <bf>set/dxitu</bf> Show ITU Zones on the end of DX announcements
2330 </tt>
2331
2332 <P>
2333 <sect1>set/echo
2334
2335 <P>
2336 <tt>
2337 <bf>set/echo</bf> Make the cluster echo your input
2338 </tt>
2339
2340 <P>
2341 <sect1>set/email &lt;email&gt; ...
2342
2343 <P>
2344 <tt>
2345 <bf>set/email &lt;email&gt; ...</bf> Set email address(es) and forward your personals
2346 </tt>
2347
2348 <P>
2349 <sect1>set/here
2350
2351 <P>
2352 <tt>
2353 <bf>set/here</bf> Tell the system you are present at your terminal
2354 </tt>
2355
2356 <P>
2357 <sect1>set/homenode &lt;node&gt; 
2358
2359 <P>
2360 <tt>
2361 <bf>set/homenode &lt;node&gt; </bf> Set your normal cluster callsign
2362 </tt>
2363
2364 <P>
2365 Tell the cluster system where you normally connect to. Any Messages sent
2366 to you will normally find their way there should you not be connected.
2367 eg:-
2368 <tscreen><verb>
2369   SET/HOMENODE gb7djk
2370 </verb></tscreen>
2371
2372 <sect1>set/language &lt;lang&gt;
2373
2374 <P>
2375 <tt>
2376 <bf>set/language &lt;lang&gt;</bf> Set the language you want to use
2377 </tt>
2378
2379 <P>
2380 You can select the language that you want the cluster to use. Currently
2381 the languages available are en (English), de (German), es (Spanish) 
2382 and nl (Dutch).
2383 <sect1>set/location &lt;lat & long&gt;
2384
2385 <P>
2386 <tt>
2387 <bf>set/location &lt;lat & long&gt;</bf> Set your latitude and longitude
2388 </tt>
2389
2390 <P>
2391 <sect1>set/logininfo
2392
2393 <P>
2394 <tt>
2395 <bf>set/logininfo</bf> Inform when a station logs in locally
2396 </tt>
2397
2398 <P>
2399 <sect1>set/name &lt;your name&gt;
2400
2401 <P>
2402 <tt>
2403 <bf>set/name &lt;your name&gt;</bf> Set your name
2404 </tt>
2405
2406 <P>
2407 Tell the system what your name is eg:-
2408 <tscreen><verb>
2409   SET/NAME Dirk
2410 </verb></tscreen>
2411
2412 <sect1>set/page &lt;lines per page&gt;
2413
2414 <P>
2415 <tt>
2416 <bf>set/page &lt;lines per page&gt;</bf> Set the lines per page
2417 </tt>
2418
2419 <P>
2420 Tell the system how many lines you wish on a page when the number of line
2421 of output from a command is more than this. The default is 20. Setting it
2422 explicitly to 0 will disable paging. 
2423 <tscreen><verb>
2424   SET/PAGE 30
2425   SET/PAGE 0
2426 </verb></tscreen>
2427
2428 The setting is stored in your user profile.
2429 <sect1>set/password
2430
2431 <P>
2432 <tt>
2433 <bf>set/password</bf> Set your own password
2434 </tt>
2435
2436 <P>
2437 This command only works for a 'telnet' user (currently). It will
2438 only work if you have a password already set. This initial password
2439 can only be set by the sysop.
2440
2441 When you execute this command it will ask you for your old password,
2442 then ask you to type in your new password twice (to make sure you
2443 get it right). You may or may not see the data echoed on the screen
2444 as you type, depending on the type of telnet client you have.
2445 <sect1>set/prompt &lt;string&gt;
2446
2447 <P>
2448 <tt>
2449 <bf>set/prompt &lt;string&gt;</bf> Set your prompt to &lt;string&gt;
2450 </tt>
2451
2452 <P>
2453 <sect1>set/qra &lt;locator&gt;
2454
2455 <P>
2456 <tt>
2457 <bf>set/qra &lt;locator&gt;</bf> Set your QRA Grid locator
2458 </tt>
2459
2460 <P>
2461 Tell the system what your QRA (or Maidenhead) locator is. If you have not
2462 done a SET/LOCATION then your latitude and longitude will be set roughly
2463 correctly (assuming your locator is correct ;-). For example:-
2464 <tscreen><verb>
2465   SET/QRA JO02LQ
2466 </verb></tscreen>
2467
2468 <sect1>set/qth &lt;your qth&gt;
2469
2470 <P>
2471 <tt>
2472 <bf>set/qth &lt;your qth&gt;</bf> Set your QTH
2473 </tt>
2474
2475 <P>
2476 Tell the system where you are. For example:-
2477 <tscreen><verb>
2478   SET/QTH East Dereham, Norfolk
2479 </verb></tscreen>
2480
2481 <sect1>set/talk
2482
2483 <P>
2484 <tt>
2485 <bf>set/talk</bf> Allow TALK messages to come out on your terminal
2486 </tt>
2487
2488 <P>
2489 <sect1>set/usstate
2490
2491 <P>
2492 <tt>
2493 <bf>set/usstate</bf> Allow US State info on the end of DX announcements
2494 </tt>
2495
2496 <P>
2497 <sect1>set/wcy
2498
2499 <P>
2500 <tt>
2501 <bf>set/wcy</bf> Allow WCY messages to come out on your terminal
2502 </tt>
2503
2504 <P>
2505 <sect1>set/wwv
2506
2507 <P>
2508 <tt>
2509 <bf>set/wwv</bf> Allow WWV messages to come out on your terminal
2510 </tt>
2511
2512 <P>
2513 <sect1>set/wx
2514
2515 <P>
2516 <tt>
2517 <bf>set/wx</bf> Allow WX messages to come out on your terminal
2518 </tt>
2519
2520 <P>
2521 <sect1>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb;
2522
2523 <P>
2524 <tt>
2525 <bf>show/chat &lsqb;&lt;group&gt;&rsqb; &lsqb;&lt;lines&gt;&rsqb;</bf> Show any chat or conferencing 
2526 </tt>
2527
2528 <P>
2529 This command allows you to see any chat or conferencing that has  
2530 occurred whilst you were away. SHOW/CHAT on its own will show data for
2531 all groups. If you use a group name then it will show only chat for
2532 that group.
2533 <sect1>show/configuration &lsqb;&lt;node&gt;&rsqb;
2534
2535 <P>
2536 <tt>
2537 <bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
2538 </tt>
2539
2540 <P>
2541 This command allows you to see all the users that can be seen
2542 and the nodes to which they are connected.
2543
2544 This command is normally abbreviated to: sh/c
2545
2546 Normally, the list returned will be just for the nodes from your 
2547 country (because the list otherwise will be very long).
2548
2549 <tscreen><verb>
2550   SH/C ALL 
2551 </verb></tscreen>
2552
2553 will produce a complete list of all nodes. 
2554
2555 BE WARNED: the list that is returned can be VERY long
2556
2557 It is possible to supply a node or part of a prefix and you will get 
2558 a list of the users for that node or list of nodes starting with
2559 that prefix.
2560
2561 <tscreen><verb>
2562   SH/C GB7DJK
2563 </verb></tscreen>
2564
2565 <tscreen><verb>
2566   SH/C SK
2567 </verb></tscreen>
2568
2569 <sect1>show/configuration/node
2570
2571 <P>
2572 <tt>
2573 <bf>show/configuration/node</bf> Show all the nodes connected locally
2574 </tt>
2575
2576 <P>
2577 Show all the nodes connected to this node.
2578 <sect1>show/contest &lt;year and month&gt;
2579
2580 <P>
2581 <tt>
2582 <bf>show/contest &lt;year and month&gt;</bf> Show all the contests for a month
2583 </tt>
2584
2585 <P>
2586 Show all known contests which are maintained at http://www.sk3bg.se/contest/
2587 for a particular month or year. The format is reasonably flexible.
2588 For example:-
2589   
2590 <tscreen><verb>
2591   SH/CONTEST sep2003
2592   SH/CONTEST 03 march
2593 </verb></tscreen>
2594
2595 <sect1>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2596
2597 <P>
2598 <tt>
2599 <bf>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
2600 </tt>
2601
2602 <P>
2603 This is very nearly the same as SHOW/TIME, the only difference the format
2604 of the date string if no arguments are given.
2605
2606 If no prefixes or callsigns are given then this command returns the local
2607 time and UTC as the computer has it right now. If you give some prefixes
2608 then it will show UTC and UTC + the local offset (not including DST) at
2609 the prefixes or callsigns that you specify.
2610 <sect1>show/db0sdx &lt;callsign&gt;
2611
2612 <P>
2613 <tt>
2614 <bf>show/db0sdx &lt;callsign&gt;</bf> Show QSL infomation from DB0SDX database
2615 </tt>
2616
2617 <P>
2618 This command queries the DB0SDX QSL server on the internet
2619 and returns any information available for that callsign. This service
2620 is provided for users of this software by http://www.qslinfo.de.
2621
2622 See also SHOW/QRZ, SHOW/WM7D.
2623 <sect1>show/dx
2624
2625 <P>
2626 <tt>
2627 <bf>show/dx</bf> Interrogate the spot database
2628 </tt>
2629
2630 <P>
2631 If you just type SHOW/DX you will get the last so many spots
2632 (sysop configurable, but usually 10).
2633    
2634 In addition you can add any number of these commands in very nearly
2635 any order to the basic SHOW/DX command, they are:-
2636    
2637 <tscreen><verb>
2638  on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
2639  on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
2640  on &lt;from&gt;/&lt;to&gt;  - eg 1000/4000 14000-30000  (in Khz)
2641     &lt;from&gt;-&lt;to&gt;
2642 </verb></tscreen>
2643    
2644 <tscreen><verb>
2645  &lt;number&gt;        - the number of spots you want
2646  &lt;from&gt;-&lt;to&gt;     - &lt;from&gt; spot no &lt;to&gt; spot no in the selected list
2647  &lt;from&gt;/&lt;to&gt;
2648 </verb></tscreen>
2649    
2650 <tscreen><verb>
2651  &lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
2652  *&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
2653  *&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
2654 </verb></tscreen>
2655    
2656 <tscreen><verb>
2657  day &lt;number&gt;    - starting &lt;number&gt; days ago
2658  day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
2659      &lt;from&gt;/&lt;to&gt;   
2660 </verb></tscreen>
2661
2662 <tscreen><verb>
2663  info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
2664 </verb></tscreen>
2665     
2666 <tscreen><verb>
2667  by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; is the 
2668                    same).
2669 </verb></tscreen>
2670
2671 <tscreen><verb>
2672  qsl             - this automatically looks for any qsl info on the call
2673                    held in the spot database.
2674 </verb></tscreen>
2675
2676 <tscreen><verb>
2677  iota [&lt;iota&gt;]   - If the iota island number is missing it will look for
2678                   the string iota and anything which looks like an iota
2679                   island number. If you specify then it will look for  
2680                   that island.
2681 </verb></tscreen>
2682
2683 <tscreen><verb>
2684  qra [&lt;locator&gt;] - this will look for the specific locator if you specify
2685                    one or else anything that looks like a locator.
2686 </verb></tscreen>
2687
2688 <tscreen><verb>
2689  dxcc            - treat the prefix as a 'country' and look for spots
2690                    from that country regardless of actual prefix.
2691                    eg dxcc oq2 
2692 </verb></tscreen>
2693                   
2694 <tscreen><verb>
2695                    You can also use this with the 'by' keyword so 
2696                    eg by W dxcc  
2697 </verb></tscreen>
2698    
2699 <tscreen><verb>
2700  e.g. 
2701 </verb></tscreen>
2702    
2703 <tscreen><verb>
2704    SH/DX 9m0
2705    SH/DX on 20m info iota
2706    SH/DX 9a on vhf day 30
2707    SH/DX rf1p qsl
2708    SH/DX iota 
2709    SH/DX iota eu-064
2710    SH/DX qra jn86
2711    SH/DX dxcc oq2
2712    SH/DX dxcc oq2 by w dxcc
2713 </verb></tscreen>
2714   
2715 <sect1>show/dxcc &lt;prefix&gt;
2716
2717 <P>
2718 <tt>
2719 <bf>show/dxcc &lt;prefix&gt;</bf> Interrogate the spot database by country
2720 </tt>
2721
2722 <P>
2723 This command takes the &lt;prefix&gt; (which can be a full or partial 
2724 callsign if desired), looks up which internal country number it is
2725 and then displays all the spots as per SH/DX for that country.
2726
2727 This is now an alias for 'SHOW/DX DXCC' 
2728    
2729 The options for SHOW/DX also apply to this command.   
2730 e.g. 
2731    
2732 <tscreen><verb>
2733    SH/DXCC G
2734    SH/DXCC W on 20m iota
2735 </verb></tscreen>
2736
2737 This can be done with the SHOW/DX command like this:-
2738
2739 <tscreen><verb>
2740    SH/DX dxcc g
2741    SH/DX dxcc w on 20m iota
2742 </verb></tscreen>
2743
2744 <sect1>show/dxqsl &lt;callsign&gt;
2745
2746 <P>
2747 <tt>
2748 <bf>show/dxqsl &lt;callsign&gt;</bf> Show any QSL info gathered from spots
2749 </tt>
2750
2751 <P>
2752 The node collects information from the comment fields in spots (things
2753 like 'VIA EA7WA' or 'QSL-G1TLH') and stores these in a database.
2754
2755 This command allows you to interrogate that database and if the callsign
2756 is found will display the manager(s) that people have spotted. This 
2757 information is NOT reliable, but it is normally reasonably accurate if
2758 it is spotted enough times.
2759
2760 For example:-
2761
2762 <tscreen><verb>
2763   sh/dxqsl 4k9w
2764 </verb></tscreen>
2765
2766 You can check the raw input spots yourself with:-
2767
2768 <tscreen><verb>
2769   sh/dx 4k9w qsl
2770 </verb></tscreen>
2771
2772 This gives you more background information.
2773 <sect1>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2774
2775 <P>
2776 <tt>
2777 <bf>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the DX Statistics
2778 </tt>
2779
2780 <P>
2781 Show the total DX spots for the last &lt;days&gt; no of days (default is 31), 
2782 starting from a &lt;date&gt; (default: today).
2783 <sect1>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;
2784
2785 <P>
2786 <tt>
2787 <bf>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;</bf> List the contents of a filearea
2788 </tt>
2789
2790 <P>
2791 SHOW/FILES on its own will show you a list of the various fileareas
2792 available on the system. To see the contents of a particular file
2793 area type:-
2794 <tscreen><verb>
2795    SH/FILES &lt;filearea&gt;
2796 </verb></tscreen>
2797 where &lt;filearea&gt; is the name of the filearea you want to see the 
2798 contents of.
2799
2800 You can also use shell globbing characters like '*' and '?' in a
2801 string to see a selection of files in a filearea eg:-
2802 <tscreen><verb>
2803    SH/FILES bulletins arld*
2804 </verb></tscreen>
2805
2806 See also TYPE - to see the contents of a file.
2807 <sect1>show/filter
2808
2809 <P>
2810 <tt>
2811 <bf>show/filter</bf> Show the contents of all the filters you have set
2812 </tt>
2813
2814 <P>
2815 Show the contents of all the filters that are set. This command displays
2816 all the filters set - for all the various categories.
2817 <sect1>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2818
2819 <P>
2820 <tt>
2821 <bf>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the HF DX Statistics 
2822 </tt>
2823
2824 <P>
2825 Show the HF DX spots breakdown by band for the last &lt;days&gt; no of days 
2826 (default is 31), starting from a &lt;date&gt; (default: today).
2827 <sect1>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
2828
2829 <P>
2830 <tt>
2831 <bf>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the HF DX Spotter Table
2832 </tt>
2833
2834 <P>
2835 Show the HF DX Spotter table for the list of prefixes for the last 
2836 &lt;days&gt; no of days (default is 31), starting from a &lt;date&gt; (default: today).
2837
2838 If there are no prefixes then it will show the table for your country.
2839
2840 Remember that some countries have more than one "DXCC country" in them
2841 (eg G :-), to show them (assuming you are not in G already which is
2842 specially treated in the code) you must list all the relevant prefixes
2843
2844 <tscreen><verb>
2845   sh/hftable g gm gd gi gj gw gu 
2846 </verb></tscreen>
2847
2848 Note that the prefixes are converted into country codes so you don't have
2849 to list all possible prefixes for each country.
2850
2851 If you want more or less days than the default simply include the
2852 number you require:-
2853
2854 <tscreen><verb>
2855   sh/hftable 20 pa
2856 </verb></tscreen>
2857
2858 If you want to start at a different day, simply add the date in some 
2859 recognizable form:-
2860
2861 <tscreen><verb>
2862   sh/hftable 2 25nov02
2863   sh/hftable 2 25-nov-02 
2864   sh/hftable 2 021125 
2865   sh/hftable 2 25/11/02
2866 </verb></tscreen>
2867
2868 This will show the stats for your DXCC for that CQWW contest weekend. 
2869
2870 You can specify either prefixes or full callsigns (so you can see how you
2871 did against all your mates). You can also say 'all' which will then print
2872 the worldwide statistics.
2873
2874 <tscreen><verb>
2875   sh/hftable all 
2876 </verb></tscreen>
2877
2878 <sect1>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2879
2880 <P>
2881 <tt>
2882 <bf>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show Moon rise and set times
2883 </tt>
2884
2885 <P>
2886 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
2887 together with the azimuth and elevation of the sun currently at those
2888 locations.
2889
2890 If you don't specify any prefixes or callsigns, it will show the times for
2891 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2892 together with the current azimuth and elevation.
2893
2894 In addition, it will show the illuminated fraction of the moons disk.
2895
2896 If all else fails it will show the Moonrise and set times for the node
2897 that you are connected to. 
2898
2899 For example:-
2900
2901 <tscreen><verb>
2902   SH/MOON
2903   SH/MOON G1TLH W5UN
2904 </verb></tscreen>
2905
2906 You can also use this command to see into the past or the future, so
2907 if you want to see yesterday's times then do:-
2908
2909 <tscreen><verb>
2910   SH/MOON -1 
2911 </verb></tscreen>
2912
2913 or in three days time:-
2914
2915 <tscreen><verb>
2916   SH/MOON +3 W9
2917 </verb></tscreen>
2918
2919 Upto 366 days can be checked both in the past and in the future.
2920
2921 Please note that the rise and set times are given as the UT times of rise and 
2922 set on the requested UT day.
2923 <sect1>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;
2924
2925 <P>
2926 <tt>
2927 <bf>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;</bf> Show the likely propagation to a prefix
2928 </tt>
2929
2930 <P>
2931 This command allow you to estimate the likelihood of you contacting
2932 a station with the prefix you have specified. The output assumes a modest
2933 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
2934
2935 The result predicts the most likely operating frequencies and signal
2936 levels for high frequency (shortwave) radio propagation paths on
2937 specified days of the year and hours of the day. It is most useful for
2938 paths between 250 km and 6000 km, but can be used with reduced accuracy
2939 for paths shorter or longer than this.
2940
2941 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
2942 used to predict the MUF given the predicted flux, day of the year,
2943 hour of the day and geographic coordinates of the transmitter and
2944 receiver. This routine is reasonably accurate for the purposes here,
2945 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
2946 than the programs used by major shortwave broadcasting organizations,
2947 such as the Voice of America.
2948
2949 The command will display some header information detailing its
2950 assumptions, together with the locations, latitude and longitudes and
2951 bearings. It will then show UTC (UT), local time at the other end
2952 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
2953 (Zen) and the likely signal strengths. Then for each frequency for which
2954 the system thinks there is a likelihood of a circuit it prints a value.
2955
2956 The value is currently a likely S meter reading based on the conventional
2957 6dB / S point scale. If the value has a '+' appended it means that it is
2958 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
2959 there is likely to be much fading and by an 's' that the signal is likely
2960 to be noisy.  
2961
2962 By default SHOW/MUF will show the next two hours worth of data. You
2963 can specify anything up to 24 hours worth of data by appending the no of
2964 hours required after the prefix. For example:-
2965
2966 <tscreen><verb>
2967   SH/MUF W
2968 </verb></tscreen>
2969
2970 produces:
2971
2972 <tscreen><verb>
2973   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
2974   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
2975   Location                       Lat / Long           Azim
2976   East Dereham, Norfolk          52 41 N 0 57 E         47
2977   United-States-W                43 0 N 87 54 W        299
2978   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
2979   18 23 11.5 -35  mS0+ mS2   S3
2980   19  0 11.2 -41  mS0+ mS2   S3
2981 </verb></tscreen>
2982
2983 indicating that you will have weak, fading circuits on top band and 
2984 80m but usable signals on 40m (about S3).
2985
2986 inputing:-
2987
2988 <tscreen><verb>
2989   SH/MUF W 24
2990 </verb></tscreen>
2991
2992 will get you the above display, but with the next 24 hours worth of
2993 propagation data.
2994
2995 <tscreen><verb>
2996   SH/MUF W L 24
2997   SH/MUF W 24 Long
2998 </verb></tscreen>
2999
3000 Gives you an estimate of the long path propagation characterics. It
3001 should be noted that the figures will probably not be very useful, nor
3002 terrible accurate, but it is included for completeness.
3003 <sect1>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;
3004
3005 <P>
3006 <tt>
3007 <bf>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
3008 </tt>
3009
3010 <P>
3011 This command allows you to see all the users that can be seen
3012 and the nodes to which they are connected. 
3013
3014 This command produces essentially the same information as 
3015 SHOW/CONFIGURATION except that it shows all the duplication of
3016 any routes that might be present It also uses a different format
3017 which may not take up quite as much space if you don't have any
3018 loops.
3019
3020 BE WARNED: the list that is returned can be VERY long
3021 <sect1>show/newconfiguration/node
3022
3023 <P>
3024 <tt>
3025 <bf>show/newconfiguration/node</bf> Show all the nodes connected locally
3026 </tt>
3027
3028 <P>
3029 Show all the nodes connected to this node in the new format.
3030 <sect1>show/prefix &lt;callsign&gt;
3031
3032 <P>
3033 <tt>
3034 <bf>show/prefix &lt;callsign&gt;</bf> Interrogate the prefix database 
3035 </tt>
3036
3037 <P>
3038 This command takes the &lt;callsign&gt; (which can be a full or partial 
3039 callsign or a prefix), looks up which internal country number 
3040 it is and then displays all the relevant prefixes for that country
3041 together with the internal country no, the CQ and ITU regions. 
3042
3043 See also SHOW/DXCC
3044 <sect1>show/qra &lt;lat&gt; &lt;long&gt;
3045
3046 <P>
3047 <tt>
3048 <bf>show/qra &lt;lat&gt; &lt;long&gt;</bf> Convert lat/long to a QRA Grid locator
3049 </tt>
3050
3051 <P>
3052 This is a multipurpose command that allows you either to calculate the
3053 distance and bearing between two locators or (if only one locator is
3054 given on the command line) the distance and beraing from your station
3055 to the locator. For example:-
3056
3057 <tscreen><verb>
3058  SH/QRA IO92QL 
3059  SH/QRA JN06 IN73
3060 </verb></tscreen>
3061
3062 The first example will show the distance and bearing to the locator from
3063 yourself, the second example will calculate the distance and bearing from
3064 the first locator to the second. You can use 4 or 6 character locators.
3065
3066 It is also possible to convert a latitude and longitude to a locator by 
3067 using this command with a latitude and longitude as an argument, for
3068 example:-
3069
3070 <tscreen><verb>
3071  SH/QRA 52 41 N 0 58 E
3072 </verb></tscreen>
3073
3074 <sect1>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;
3075
3076 <P>
3077 <tt>
3078 <bf>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;</bf> Show distance between QRA Grid locators
3079 </tt>
3080
3081 <P>
3082 <sect1>show/qrz &lt;callsign&gt;
3083
3084 <P>
3085 <tt>
3086 <bf>show/qrz &lt;callsign&gt;</bf> Show any callbook details on a callsign
3087 </tt>
3088
3089 <P>
3090 This command queries the QRZ callbook server on the internet
3091 and returns any information available for that callsign. This service
3092 is provided for users of this software by http://www.qrz.com 
3093
3094 See also SHOW/WM7D for an alternative.
3095 <sect1>show/route &lt;callsign&gt; ...
3096
3097 <P>
3098 <tt>
3099 <bf>show/route &lt;callsign&gt; ...</bf> Show the route to the callsign
3100 </tt>
3101
3102 <P>
3103 This command allows you to see to which node the callsigns specified are
3104 connected. It is a sort of inverse sh/config.
3105
3106 <tscreen><verb>
3107  sh/route n2tly
3108 </verb></tscreen>
3109
3110 <sect1>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;
3111
3112 <P>
3113 <tt>
3114 <bf>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;</bf> Show tracking data
3115 </tt>
3116
3117 <P>
3118 Show the tracking data from your location to the satellite of your choice
3119 from now on for the next few hours.
3120
3121 If you use this command without a satellite name it will display a list
3122 of all the satellites known currently to the system. 
3123
3124 If you give a name then you can obtain tracking data of all the passes
3125 that start and finish 5 degrees below the horizon. As default it will
3126 give information for the next three hours for every five minute period.
3127
3128 You can alter the number of hours and the step size, within certain 
3129 limits. 
3130
3131 Each pass in a period is separated with a row of '-----' characters
3132
3133 So for example:-
3134
3135 <tscreen><verb>
3136  SH/SAT AO-10 
3137  SH/SAT FENGYUN1 12 2
3138 </verb></tscreen>
3139
3140 <sect1>show/station &lsqb;&lt;callsign&gt; ..&rsqb;
3141
3142 <P>
3143 <tt>
3144 <bf>show/station &lsqb;&lt;callsign&gt; ..&rsqb;</bf> Show information about a callsign
3145 </tt>
3146
3147 <P>
3148 Show the information known about a callsign and whether (and where)
3149 that callsign is connected to the cluster.
3150
3151 <tscreen><verb>
3152   SH/ST G1TLH
3153 </verb></tscreen>
3154
3155 If no callsign is given then show the information for yourself.
3156 <sect1>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
3157
3158 <P>
3159 <tt>
3160 <bf>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show sun rise and set times
3161 </tt>
3162
3163 <P>
3164 Show the sun rise and set times for a (list of) prefixes or callsigns, 
3165 together with the azimuth and elevation of the sun currently at those
3166 locations.
3167
3168 If you don't specify any prefixes or callsigns, it will show the times for
3169 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
3170 together with the current azimuth and elevation.
3171
3172 If all else fails it will show the sunrise and set times for the node
3173 that you are connected to. 
3174
3175 For example:-
3176
3177 <tscreen><verb>
3178   SH/SUN
3179   SH/SUN G1TLH K9CW ZS
3180 </verb></tscreen>
3181
3182 You can also use this command to see into the past or the future, so
3183 if you want to see yesterday's times then do:-
3184
3185 <tscreen><verb>
3186   SH/SUN -1 
3187 </verb></tscreen>
3188
3189 or in three days time:-
3190
3191 <tscreen><verb>
3192   SH/SUN +3 W9
3193 </verb></tscreen>
3194
3195 Upto 366 days can be checked both in the past and in the future.
3196
3197 Please note that the rise and set times are given as the UT times of rise 
3198 and set on the requested UT day.
3199 <sect1>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
3200
3201 <P>
3202 <tt>
3203 <bf>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
3204 </tt>
3205
3206 <P>
3207 If no prefixes or callsigns are given then this command returns the local
3208 time and UTC as the computer has it right now. If you give some prefixes
3209 then it will show UTC and UTC + the local offset (not including DST) at
3210 the prefixes or callsigns that you specify.
3211 <sect1>show/usdb &lsqb;call ..&rsqb;
3212
3213 <P>
3214 <tt>
3215 <bf>show/usdb &lsqb;call ..&rsqb;</bf> Show information held on the FCC Call database
3216 </tt>
3217
3218 <P>
3219 Show the City and State of a Callsign held on the FCC database if
3220 his is being run on this system, eg:-
3221
3222 <tscreen><verb>
3223   sh/usdb k1xx
3224 </verb></tscreen>
3225
3226 <sect1>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
3227
3228 <P>
3229 <tt>
3230 <bf>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the VHF DX Statistics
3231 </tt>
3232
3233 <P>
3234 Show the VHF DX spots breakdown by band for the last 
3235 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3236 <sect1>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
3237
3238 <P>
3239 <tt>
3240 <bf>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the VHF DX Spotter Table
3241 </tt>
3242
3243 <P>
3244 Show the VHF DX Spotter table for the list of prefixes for the last 
3245 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3246
3247 If there are no prefixes then it will show the table for your country.
3248
3249 Remember that some countries have more than one "DXCC country" in them
3250 (eg G :-), to show them (assuming you are not in G already which is
3251 specially treated in the code) you must list all the relevant prefixes
3252
3253 <tscreen><verb>
3254   sh/vhftable g gm gd gi gj gw gu 
3255 </verb></tscreen>
3256
3257 Note that the prefixes are converted into country codes so you don't have
3258 to list all possible prefixes for each country.
3259
3260 If you want more or less days than the default simply include the
3261 number you require:-
3262
3263 <tscreen><verb>
3264   sh/vhftable 20 pa
3265 </verb></tscreen>
3266
3267 If you want to start at a different day, simply add the date in some 
3268 recognizable form:-
3269
3270 <tscreen><verb>
3271   sh/vhftable 2 25nov02
3272   sh/vhftable 2 25-nov-02 
3273   sh/vhftable 2 021125 
3274   sh/vhftable 2 25/11/02
3275 </verb></tscreen>
3276
3277 This will show the stats for your DXCC for that CQWW contest weekend. 
3278
3279 You can specify either prefixes or full callsigns (so you can see how you
3280 did against all your mates). You can also say 'all' which will then print
3281 the worldwide statistics.
3282
3283 <tscreen><verb>
3284   sh/vhftable all 
3285 </verb></tscreen>
3286
3287 <sect1>show/wcy
3288
3289 <P>
3290 <tt>
3291 <bf>show/wcy</bf> Show last 10 WCY broadcasts
3292 </tt>
3293
3294 <P>
3295 <sect1>show/wcy &lt;n&gt;
3296
3297 <P>
3298 <tt>
3299 <bf>show/wcy &lt;n&gt;</bf> Show last &lt;n&gt; WCY broadcasts
3300 </tt>
3301
3302 <P>
3303 Display the most recent WCY information that has been received by the system
3304  
3305 <sect1>show/wm7d &lt;callsign&gt;
3306
3307 <P>
3308 <tt>
3309 <bf>show/wm7d &lt;callsign&gt;</bf> Show callbook details on a US callsigns
3310 </tt>
3311
3312 <P>
3313 This command queries the WM7D callbook server on the internet
3314 and returns any information available for that US callsign. This service
3315 is provided for users of this software by http://www.wm7d.net.
3316
3317 See also SHOW/QRZ. 
3318 <sect1>show/wwv
3319
3320 <P>
3321 <tt>
3322 <bf>show/wwv</bf> Show last 10 WWV broadcasts
3323 </tt>
3324
3325 <P>
3326 <sect1>show/wwv &lt;n&gt;
3327
3328 <P>
3329 <tt>
3330 <bf>show/wwv &lt;n&gt;</bf> Show last &lt;n&gt; WWV broadcasts
3331 </tt>
3332
3333 <P>
3334 Display the most recent WWV information that has been received by the system
3335 <sect1>sysop
3336
3337 <P>
3338 <tt>
3339 <bf>sysop</bf> Regain your privileges if you login remotely
3340 </tt>
3341
3342 <P>
3343 The system automatically reduces your privilege level to that of a
3344 normal user if you login in remotely. This command allows you to
3345 regain your normal privilege level. It uses the normal system: five
3346 numbers are returned that are indexes into the character array that is
3347 your assigned password (see SET/PASSWORD). The indexes start from
3348 zero.
3349
3350 You are expected to return a string which contains the characters
3351 required in the correct order. You may intersperse those characters
3352 with others to obscure your reply for any watchers. For example (and
3353 these values are for explanation :-):
3354
3355 <tscreen><verb>
3356   password = 012345678901234567890123456789
3357   &gt; sysop
3358   22 10 15 17 3
3359 </verb></tscreen>
3360 you type:-
3361 <tscreen><verb>
3362  aa2bbbb0ccc5ddd7xxx3n
3363  or 2 0 5 7 3
3364  or 20573
3365 </verb></tscreen>
3366
3367 They will all match. If there is no password you will still be offered
3368 numbers but nothing will happen when you input a string. Any match is
3369 case sensitive.
3370 <sect1>talk &lt;call&gt; &gt; &lt;node&gt; &lsqb;&lt;text&gt;&rsqb;
3371
3372 <P>
3373 <tt>
3374 <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
3375 </tt>
3376
3377 <P>
3378 Send a short message to any other station that is visible on the cluster
3379 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
3380 command, they don't have to be connected locally.
3381
3382 The second form of TALK is used when other cluster nodes are connected
3383 with restricted information. This usually means that they don't send 
3384 the user information usually associated with logging on and off the cluster.
3385
3386 If you know that G3JNB is likely to be present on GB7TLH, but you can only
3387 see GB7TLH in the SH/C list but with no users, then you would use the
3388 second form of the talk message.
3389
3390 If you want to have a ragchew with someone you can leave the text message
3391 out and the system will go into 'Talk' mode. What this means is that a
3392 short message is sent to the recipient telling them that you are in a
3393 'Talking' frame of mind and then you just type - everything you send will
3394 go to the station that you asked for. 
3395
3396 All the usual announcements, spots and so on will still come out on your
3397 terminal.
3398
3399 If you want to do something (such as send a spot) you preceed the normal 
3400 command with a '/' character, eg:-
3401
3402 <tscreen><verb>
3403    /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
3404    /HELP talk
3405 </verb></tscreen>
3406
3407 To leave talk mode type:
3408    
3409 <tscreen><verb>
3410    /EX
3411 </verb></tscreen>
3412
3413 If you are in 'Talk' mode, there is an extention to the '/' command which
3414 allows you to send the output to all the people you are talking to. You do 
3415 with the '//' command. For example:-
3416
3417 <tscreen><verb>
3418   //sh/hftable
3419 </verb></tscreen>
3420
3421 will send the hftable as you have it to all the people you are currently 
3422 talking to.
3423 <sect1>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;
3424
3425 <P>
3426 <tt>
3427 <bf>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;</bf> Send a text message to another station
3428 </tt>
3429
3430 <P>
3431 <sect1>type &lt;filearea&gt;/&lt;name&gt;
3432
3433 <P>
3434 <tt>
3435 <bf>type &lt;filearea&gt;/&lt;name&gt;</bf> Look at the contents of a file in one of the fileareas
3436 </tt>
3437
3438 <P>
3439 Type out the contents of a file in a filearea. So, for example, in 
3440 filearea 'bulletins' you want to look at file 'arld051' you would 
3441 enter:-
3442 <tscreen><verb>
3443    TYPE bulletins/arld051
3444 </verb></tscreen>
3445
3446 See also SHOW/FILES to see what fileareas are available and a 
3447 list of content.
3448 <sect1>unset/announce
3449
3450 <P>
3451 <tt>
3452 <bf>unset/announce</bf> Stop announce messages coming out on your terminal
3453 </tt>
3454
3455 <P>
3456 <sect1>unset/anntalk
3457
3458 <P>
3459 <tt>
3460 <bf>unset/anntalk</bf> Stop talk like announce messages on your terminal
3461 </tt>
3462
3463 <P>
3464 The announce system on legacy cluster nodes is used as a talk 
3465 substitute because the network is so poorly connected. If you:
3466
3467 <tscreen><verb>
3468   unset/anntalk
3469 </verb></tscreen>
3470
3471 you will suppress several of these announces, you may miss the odd 
3472 useful one as well, but you would probably miss them anyway in the
3473 welter of useless ones.
3474
3475 <tscreen><verb>
3476   set/anntalk 
3477 </verb></tscreen>
3478
3479 allows you to see them again. This is the default.
3480 <sect1>unset/beep
3481
3482 <P>
3483 <tt>
3484 <bf>unset/beep</bf> Stop beeps for DX and other messages on your terminal
3485 </tt>
3486
3487 <P>
3488 <sect1>unset/dx
3489
3490 <P>
3491 <tt>
3492 <bf>unset/dx</bf> Stop DX messages coming out on your terminal
3493 </tt>
3494
3495 <P>
3496 <sect1>unset/dxcq
3497
3498 <P>
3499 <tt>
3500 <bf>unset/dxcq</bf> Stop CQ Zones on the end of DX announcements
3501 </tt>
3502
3503 <P>
3504 Display both the Spotter's and the Spotted's CQ Zone on the end
3505 of a DX announcement (there is just enough room). Some user programs
3506 cannot cope with this. The Spotter's CQ is on the RHS of the 
3507 time, the Spotted's CQ is on the LHS.
3508
3509 Conflicts with: SET/DXGRID, SET/DXITU, SHOW/USSTATE
3510
3511 Do a STAT/USER to see which flags you have set if you are confused.  
3512 <sect1>unset/dxgrid
3513
3514 <P>
3515 <tt>
3516 <bf>unset/dxgrid</bf> Stop QRA Grid Squares on the end of DX announcements
3517 </tt>
3518
3519 <P>
3520 A standard feature which is enabled in version 1.43 and above is 
3521 that if the spotter's grid square is known it is output on the end
3522 of a DX announcement (there is just enough room). Some user programs
3523 cannot cope with this. You can use this command to reset (or set)
3524 this feature.
3525
3526 Conflicts with: SET/DXCQ, SET/DXITU
3527
3528 Do a STAT/USER to see which flags you have set if you are confused.  
3529 <sect1>unset/dxitu
3530
3531 <P>
3532 <tt>
3533 <bf>unset/dxitu</bf> Stop ITU Zones on the end of DX announcements
3534 </tt>
3535
3536 <P>
3537 Display both the Spotter's and the Spotted's ITU Zone on the end
3538 of a DX announcement (there is just enough room). Some user programs
3539 cannot cope with this. The Spotter's ITU is on the RHS of the 
3540 time, the Spotted's ITU is on the LHS.
3541
3542 Conflicts with: SET/DXGRID, SET/DXCQ, SHOW/USSTATE
3543
3544 Do a STAT/USER to see which flags you have set if you are confused.  
3545 <sect1>unset/echo
3546
3547 <P>
3548 <tt>
3549 <bf>unset/echo</bf> Stop the cluster echoing your input
3550 </tt>
3551
3552 <P>
3553 If you are connected via a telnet session, different implimentations
3554 of telnet handle echo differently depending on whether you are 
3555 connected via port 23 or some other port. You can use this command
3556 to change the setting appropriately. 
3557
3558 The setting is stored in your user profile.
3559
3560 YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
3561 <sect1>unset/email
3562
3563 <P>
3564 <tt>
3565 <bf>unset/email</bf> Stop personal msgs being forwarded by email
3566 </tt>
3567
3568 <P>
3569 If any personal messages come in for your callsign then you can use
3570 these commands to control whether they are forwarded onto your email
3571 address. To enable the forwarding do something like:-
3572
3573 <tscreen><verb>
3574   SET/EMAIL mike.tubby@somewhere.com
3575 </verb></tscreen>
3576
3577 You can have more than one email address (each one separated by a space).
3578 Emails are forwarded to all the email addresses you specify.
3579
3580 You can disable forwarding by:-
3581
3582 <tscreen><verb>
3583   UNSET/EMAIL
3584 </verb></tscreen>
3585
3586 <sect1>unset/here
3587
3588 <P>
3589 <tt>
3590 <bf>unset/here</bf> Tell the system you are absent from your terminal
3591 </tt>
3592
3593 <P>
3594 <sect1>unset/logininfo
3595
3596 <P>
3597 <tt>
3598 <bf>unset/logininfo</bf> Inform when a station logs out locally
3599 </tt>
3600
3601 <P>
3602 <sect1>unset/privilege
3603
3604 <P>
3605 <tt>
3606 <bf>unset/privilege</bf> Remove any privilege for this session
3607 </tt>
3608
3609 <P>
3610 You can use this command to 'protect' this session from unauthorised
3611 use. If you want to get your normal privilege back you will need to
3612 either logout and login again (if you are on a console) or use the
3613 SYSOP command.
3614 <sect1>unset/prompt
3615
3616 <P>
3617 <tt>
3618 <bf>unset/prompt</bf> Set your prompt back to default
3619 </tt>
3620
3621 <P>
3622 This command will set your user prompt to exactly the string that you 
3623 say. The point of this command to enable a user to interface to programs
3624 that are looking for a specific prompt (or else you just want a different
3625 fixed prompt).
3626
3627 <tscreen><verb>
3628   SET/PROMPT clx &gt;
3629 </verb></tscreen>
3630
3631 UNSET/PROMPT will undo the SET/PROMPT command and set you prompt back to
3632 normal.
3633 <sect1>unset/talk
3634
3635 <P>
3636 <tt>
3637 <bf>unset/talk</bf> Stop TALK messages coming out on your terminal
3638 </tt>
3639
3640 <P>
3641 <sect1>unset/usstate
3642
3643 <P>
3644 <tt>
3645 <bf>unset/usstate</bf> Stop US State info on the end of DX announcements
3646 </tt>
3647
3648 <P>
3649 If the spotter's or spotted's US State is known it is output on the 
3650 end of a DX announcement (there is just enough room). 
3651
3652 A spotter's state will appear on the RHS of the time (like 
3653 SET/DXGRID) and the spotted's State will appear on the LHS of the
3654 time field. Any information found will override any locator 
3655 information from SET/DXGRID.
3656
3657 Some user programs cannot cope with this. You can use this command 
3658 to reset (or set) this feature.
3659
3660 Conflicts with: SET/DXCQ, SET/DXITU
3661
3662 Do a STAT/USER to see which flags you have set if you are confused.  
3663 <sect1>unset/wcy
3664
3665 <P>
3666 <tt>
3667 <bf>unset/wcy</bf> Stop WCY messages coming out on your terminal
3668 </tt>
3669
3670 <P>
3671 <sect1>unset/wwv
3672
3673 <P>
3674 <tt>
3675 <bf>unset/wwv</bf> Stop WWV messages coming out on your terminal
3676 </tt>
3677
3678 <P>
3679 <sect1>unset/wx
3680
3681 <P>
3682 <tt>
3683 <bf>unset/wx</bf> Stop WX messages coming out on your terminal
3684 </tt>
3685
3686 <P>
3687 <sect1>who
3688
3689 <P>
3690 <tt>
3691 <bf>who</bf> Show who is physically connected
3692 </tt>
3693
3694 <P>
3695 This is a quick listing that shows which callsigns are connected and
3696 what sort of connection they have
3697 <sect1>wx &lt;text&gt;
3698
3699 <P>
3700 <tt>
3701 <bf>wx &lt;text&gt;</bf> Send a weather message to local users
3702 </tt>
3703
3704 <P>
3705 <sect1>wx full &lt;text&gt;
3706
3707 <P>
3708 <tt>
3709 <bf>wx full &lt;text&gt;</bf> Send a weather message to all cluster users
3710 </tt>
3711
3712 <P>
3713 </article>