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