Changes to manual namings to standardise. Added script from M0AZM to
[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>September 2002 revision 0.1</date>
10
11 <abstract>
12 A complete reference for users of the DXSpider DXCluster program.
13 </abstract>
14
15 <!-- Table of contents -->
16 <toc>
17
18 <!-- Begin the document -->
19
20 <sect>Introduction
21
22 <sect1>What is a DX Cluster?
23
24 <p>
25 A DX Cluster is a packet node where DX chasers on any band or mode can
26 post rare or interesting stations that they have worked or heard.  Of 
27 course other people are doing the same thing too, so you can find new 
28 DX as well as telling others about the stations you have worked.  
29 Clusters tend to be linked to each other so that the amount of people 
30 using them is increased, thereby increasing the amount of posted DX.  
31 Other information can be found on clusters such as on-line call books, 
32 mail etc.  You can talk to other stations connected to the cluster 
33 network too, in real time, whether at the node you are logged into or 
34 on another node connected to the network.  You can also use converse 
35 mode, where several stations can talk to each other in the same way.  
36 Of course, the DX is still posted to you all the while!
37  
38 <sect1>So what is DXSpider?
39
40 <p>
41 PacketCluster nodes have been around since roughly 1985. The original 
42 PacketCluster idea came from Dick Newell, AK1A, and ran under DOS.
43 In about 1992 Dick stopped the development of the PacketCluster 
44 software for amateur radio. Many systems are still using this 
45 relatively old DOS software today.
46
47 There are several new compatible cluster programs around now, 
48 including DXSpider.  DXSpider is a clone of PacketCluster software that runs 
49 under several operating systems including Linux and Windows.  Linux is fast 
50 becoming the choice for amateur radio stations because of it's flexibility, 
51 reliability and the lack of the memory limitations of DOS.  Linux supports 
52 multitasking and is also multiuser. It has support for AX25, ROSE, 
53 NetROM and TCPIP built in, making it the ideal choice for amateur
54 radio.  It is also totally free!
55
56 DXSpider was conceived and begun in 1998 by Dirk Koopman, G1TLH as an
57 exercise in perl programming.  It has developed rapidly and today is a
58 very powerful cluster program.  It was designed to be totally compatible
59 with the AK1A program, although several commands have been extended to
60 improve functionality.
61
62 This manual is designed to help you become familiar with the commands
63 that DXSpider supports and to help you get the best from the program so 
64 you can enjoy working that rare DX!  As DXSpider is being improved all the 
65 time, commands will be added as time goes by, so make sure you have 
66 the most upto date version of this manual.  The latest version will
67 always be included with the cluster program so if you are unsure, simply
68 ask your sysop.  The manual will also be available on the wesite.
69
70
71 <sect>Logins and logouts.
72
73 <p>
74 You might not think that there is a lot of point of including a 
75 section on how to log in and out of DXSpider.  However, you would be 
76 suprised at the difficulties some people have in simply getting in 
77 and out of the cluster!
78
79 There are several ways a login might be achieved, dependant on how 
80 the sysop has DXSpider configured.  It is impossible for me to cover all 
81 variations but here are the basic ones.
82
83 <sect1>AX25 logins.
84
85 <p>
86 Simplicity itself.  The usual <bf>CONNECT</bf> command will log you straight
87 into the cluster and you will not have to do anything else.  
88 Obviously, you will have to connect to the correct callsign.  Some 
89 nodes use an SSID with their call so you would have to add that.
90
91 <bf>Examples:</bf>
92
93 <tscreen><verb>
94 connect GB7MBC
95 connect GB7MBC-1
96 </verb></tscreen>
97
98 <sect1>Netrom logins.
99
100 <p>
101 There are several possibilities here, dependant on how the sysop has
102 configured his system.  If you are connecting via netrom then you are
103 most probably connecting from another station.  Listing the nodes in
104 that station with the <bf>NODES</bf> command will tell you what callsign 
105 or netrom alias to connect to. Then just issue the connect command 
106 from there.  It is possible that the netrom alias may connect you to 
107 a node with an alias for the cluster, such as DXC.  Just type this 
108 and you will be connected.
109
110 <bf>Example:</bf>
111 <tscreen><verb>
112 connect MBCDX
113 </verb></tscreen>
114
115 <sect1>Telnet logins.
116
117 <p>
118 With telnet connections, the source callsign is not seen by DXSpider, so 
119 you will be asked to login with your callsign.  
120 To telnet to DXSpider, you would connect to a specific port.  There is no 
121 standard at the moment for a cluster telnet port but ask the sysop if 
122 you are unsure.
123
124 <bf>Example:</bf>
125
126 <tscreen><verb>
127 telnet gb7mbc 8000
128 </verb></tscreen>
129
130 All the above are possible ways of connecting to a DXSpider cluster.  You
131 may have some or all of these available to you.  There may be one or 
132 two additional ways to connect dependant on the network local to you.
133 However I am sure you get the idea.
134
135 <sect1>Logouts.
136
137 <p>
138 Logging out can be done by simply issuing the standard <bf>BYE</bf>
139 command.
140
141 You could also send a disconnect if you are using AX25, or a <bf>CLOSE</bf>
142 command if you are connected via telnet.
143 If you do not log out gracefully using one of the above commands, 
144 you may find you are unable to get a full connect next time.  This
145 may also happen if a netrom connection drops.  You may get connected, 
146 but nothing else will happen because the program thinks you are still 
147 connected and will not let you connect twice under the same call.  
148 However you could reconnect by adding a number to the end of your call,
149 for example G0YLM-2.  
150 This can be done by either altering your MYCALL setting in the TNC or 
151 by altering your program configuration.  
152
153
154 <sect>Setting your personal details.
155
156 <p>
157 Once logged in to the cluster, you should set your details so that 
158 anybody who wishes to contact you can find out who and where you are.
159 There are four items to set, your name, qth, location and home node.  
160 Setting these details also allows the use of the SHOW/HEADING and
161 SHOW/SUN commands from within the cluster.  Unless you set your QTH
162 and location, these commands cannot function.
163 Once you have set your name, DXSpider will greet you with it next time 
164 you login.  Your QTH setting is where you live and it is a good idea 
165 to add your locator to this as the location setting is converted to 
166 latitude and longitude once inputted.  You can actually set your location 
167 in latitude/longitude or as a locator.  Setting your home node will 
168 tell the program where you wish mail to be sent to you.
169
170 <bf>Examples:</bf>
171
172 <tscreen><verb>
173 set/name Ian
174 set/qth Morecambe, Lancashire IO84NB
175 set/location 48 34 n 12 12 e
176 set/qra IO84NB
177 set/home gb7mbc
178 </verb></tscreen>
179
180 <sect>Getting and posting DX.
181
182 <p>
183 When all is said and done, this is the main function of a DX cluster.
184 In its simplest form you can just connect to the node and you will 
185 start to receive DX spots almost immediately!  You can check on 
186 recent postings in either a general manner or on a particular band or
187 mode.  You can even check DX by callsign or a fragment of a callsign.
188 Of course, once you get the hang of things, it is expected that you 
189 start posting some yourself!  After all, there would be no clusters 
190 if people did not post DX and you get the added thrill of the hunt!
191
192 <sect1>Receiving DX.
193
194 <p>
195 As we have already said, it is possible just to connect to the 
196 cluster and you will receive spots automatically.  However, you may 
197 wish to check on spots just posted.  Maybe you wish to see if a 
198 particular band is open or if a certain callsign is active, perhaps a
199 DXpedition.  The command to do this is <bf>SHOW/DX</bf>.  Without any 
200 other arguments, this command will output the last 10 spots 
201 posted.  It is possible to look at more than this, for example the 
202 last 20 or 50 spots, by adding the number to the command.  You can 
203 make it even more specific by adding a band in either wavelength or 
204 frequency, and/or any additional information such as QSL details.
205
206 <bf>Examples:</bf>
207
208 <tscreen><verb>
209 show/dx
210 show/dx 5
211 show/dx 20
212 </verb></tscreen>
213
214 will show the last 10, 5 and 20 spots received by the cluster 
215 respectively.
216
217 <bf>Examples</bf>
218
219 <tscreen><verb>
220 show/dx on 20m
221 show/dx 10 on 20m
222 show/dx 20 on 20m
223 </verb></tscreen>
224
225 will show the last 5, 10 or 20 spots on 20 metres only.
226
227 It is also possible to check for certain callsigns, or fragments of 
228 callsigns in the same way.
229
230 <bf>Examples:</bf>
231
232 <tscreen><verb>
233 show/dx g0vgs
234 show/dx 10 g0vgs
235 </verb></tscreen>
236
237 would show the last 5 or 10 dx spots containing the callsign g0vgs.
238
239 <p>
240 You can check for DX by offset and also by specifying a comment to 
241 search for.
242
243 <bf>Examples:</bf>
244
245 <tscreen><verb>
246 show/dx 30-40
247 show/dx 14000-14033
248 show/dx iota
249 </verb></tscreen>
250
251 would show the spots that arrived between 30 and 40 spots ago and any 
252 spots with the word <em>iota</em> in the comment field.  The case of 
253 the comment is not important.
254  
255 Checking DX posted on a certain day is possible too.  All you have
256 to do here is to specify how many days ago it was like this ...
257
258 <bf>Example:</bf>
259
260 <tscreen><verb>
261 show/dx day 30 
262 </verb></tscreen>
263
264 It is of course possible to specify multiple arguments.
265
266 <bf>Example:</bf>
267
268 <tscreen><verb>
269 show/dx 20 prefix 9a on vhf day 30
270 </verb></tscreen>
271
272 This would show the last 20 spots posted by or about calls with the prefix
273 9a on vhf 30 days ago.
274
275 As you can see the <bf>SHOW/DX</bf> command is very flexible, so if you are
276 not sure whether something will work or not, try it and see!  More
277 information can be found in the Command Set section.
278
279 <sect1>Posting DX.
280
281 <p>
282 To post DX you use the <bf>DX</bf> command.  The syntax is shown below. 
283
284 <bf>Example:</bf>
285
286 <tscreen><verb>
287 dx (frequency) (callsign) (remarks)
288 </verb></tscreen>
289
290 Where frequency is in kilohertz and the callsign is the callsign of
291 the station you have worked or heard, (ie not your own callsign!).  
292 The remarks section allows you to add information like the operators 
293 name or perhaps a location.  Actually DXSpider will allow the frequency
294 and callsign fields to be entered in any order.
295
296 <bf>Example:</bf>
297
298 <tscreen><verb>
299 dx 14004 pa3ezl OP Aurelio 599
300 </verb></tscreen>
301
302 In fact, all the following will give the same result...
303
304 <tscreen><verb>
305 dx 14004 pa3ezl OP Aurelio 599
306 dx pa3ezl 14004 OP Aurelio 599
307 dx pa3ezl 14.004 OP Aurelio 599
308 </verb></tscreen>
309
310 This posting, or callout as it is known, will be forwarded to all 
311 other connected stations both at the cluster you are connected to and
312 other active clusters in the network.  The callout will also be sent 
313 to you as proof of receipt. 
314  
315 <sect>Headings and propagation
316
317 <p>
318 There are three commands in DXSpider to help you get the best DX possible.
319 These are <bf>SHOW/SUN</bf>, <bf>SHOW/MOON</bf> and
320 <bf>SHOW/HEADING</bf>.  These commands will only work for you if you
321 have entered your personal details.  They use your entered location as
322 a reference, so if you have not entered it or have entered it incorrectly
323 they will not return the correct information.
324
325 <sect1>Sun
326
327 <p>
328 The <bf>SHOW/SUN</bf> command can be used in three different ways.  It
329 can be used to show sunrise and sunset times for your own station, a 
330 particular callsign or a prefix.  
331
332 <bf>Example:</bf>
333
334 <tscreen><verb>
335 show/sun
336 </verb></tscreen>
337
338 The output from this would look something like this ..
339
340 <tscreen><verb>
341 sh/sun
342 Location                              Rise   Set      Azim   Elev
343 G0VGS  Morecambe, Lancashire          07:08Z 17:39Z  205.3   24.1
344 </verb></tscreen>
345
346 <tscreen><verb>
347 sh/sun 5b4
348 </verb></tscreen>
349
350 would look like this ...
351
352 <tscreen><verb>
353 sh/sun 5b4
354 Location                              Rise   Set      Azim   Elev
355 5B     Cyprus-5B                      04:23Z 15:40Z  244.0   18.8  
356 </verb></tscreen>
357
358 You can also specify multiple arguments like this ...
359
360 <tscreen><verb>
361 sh/sun gw4veq 5b4ab zs
362 </verb></tscreen>
363
364 and then the output would look like this ...
365
366 <tscreen><verb>
367 sh/sun gw4veq 5b4ab zs
368 Location                              Rise   Set      Azim   Elev
369 GW4VEQ Brungwran, Isle of Anglesey IO 07:14Z 17:48Z  204.9   24.9
370 5B     Cyprus-5B                      04:23Z 15:40Z  244.5   18.3
371 ZS     So-Africa-ZS1-ZS               04:31Z 17:28Z  289.9   41.3
372 ZS     So-Africa-ZS5-ZS               03:44Z 16:34Z  278.5   32.0
373 ZS     So-Africa-ZS6-ZS               03:59Z 16:42Z  277.6   35.0 
374 </verb></tscreen>
375
376 <sect1>Moon
377
378 <p>
379 The <bf>SHOW/MOON</bf> command works in the same way as the 
380 <bf>SHOW/SUN</bf> command.  This program however, calculates the
381 rise and set times of the moon for a prefix or callsign, together
382 with the current azimuth and elevation of the sun at these
383 locations.
384
385 <bf>Example:</bf>
386
387 <tscreen><verb>
388 show/moon ea
389 </verb></tscreen>
390
391 The output from this command would look like this ..
392
393 <tscreen><verb>
394 sh/moon ea
395 Location                              Rise   Set      Azim   Elev  RGain dB
396 EA     Spain-EA                       08:15Z 20:09Z  257.2    9.5      -0.6  
397 </verb></tscreen>
398  
399 You can see that the output is similar to the <bf>SHOW/SUN</bf>
400 command, with slightly different fields.
401
402 <sect1>Heading
403
404 <p>
405 The <bf>SHOW/HEADING</bf> command works in the same way as the 
406 <bf>SHOW/SUN</bf> and <bf>SHOW/MOON</bf> commands but outputs beam 
407 headings for a specified callsign or prefix.  Reciprocal beam headings 
408 are also calculated.
409
410 <bf>Example</bf>
411
412 <tscreen><verb>
413 show/heading zl
414 </verb></tscreen>
415
416 The output from this command would look like this ..
417
418 <tscreen><verb>
419 sh/heading zl
420 ZL New-Zealand-ZL1-ZL: 7 degs - dist: 11238 mi, 18087 km Reciprocal heading: 355 degs
421 ZL New-Zealand-ZL2-ZL: 9 degs - dist: 11540 mi, 18574 km Reciprocal heading: 353 degs
422 ZL New-Zealand-ZL3-ZL: 19 degs - dist: 11634 mi, 18724 km Reciprocal heading: 345 degs
423 ZL New-Zealand-ZL4-ZL: 34 degs - dist: 11783 mi, 18963 km Reciprocal heading: 332 degs
424 </verb></tscreen>
425
426 <sect>Announcements.
427
428 <sect1>Making announcements.
429
430 <p>
431 Occasionally, you may wish to post something that does not fall into 
432 the normal parameters for a DX callout.  You may wish to tell 
433 everybody connected that 10 FM is open for example, or ask if anyone 
434 knows the QSL manager for a certain callsign etc.  You can do this 
435 using the <bf>ANNOUNCE</bf> command.
436
437 <bf>Example:</bf>
438
439 <tscreen><verb>
440 announce 10 FM is open in IO84NB to europe.
441 </verb></tscreen>
442
443 That would let everyone know locally that this was the case, however
444 it would not be forwarded to other nodes connected.  To send
445 announcements to other connected nodes as well, you would use the
446 <bf>FULL</bf> extension.
447
448 <bf>Example:</bf>
449
450 <tscreen><verb>
451 announce full Anyone seen EA7WA today?
452 </verb></tscreen>
453
454 Be cautious in your use of announce full.  There are many other tools
455 available to get the information you require and the judicious use of
456 this command is frowned upon as it creates a great deal of traffic
457 across the network.
458
459 <sect1>Listing announcements.
460
461 <p>
462 You can list previous announcements in the standard format with the 
463 <bf>SHOW</bf> command.  As before you can list just the last 5 or as 
464 many as you wish.
465
466 <bf>Example:</bf>
467
468 <tscreen><verb>
469 show/announcements
470 show/announcements 10
471 </verb></tscreen>
472
473 <sect>Nodes and users.
474
475 <p>
476 You can check which nodes are connected in the network, who is 
477 logged on locally, who is logged on at all the nodes or even 
478 just one node in particular. This is handy if you wish to see whether
479 a friend is connected at the node they use.  To see who is connected 
480 to the nodes, the <bf>SHOW/CONFIGURATION</bf> command is used.
481
482 <bf>Example:</bf>
483
484 <tscreen><verb>
485 show/configuration
486 show/configuration/nodes
487 show/configuration (node_call)
488 show/configuration (prefix)
489 </verb></tscreen>
490
491 The first of our three examples would output something like this,
492
493 <tscreen><verb>
494 sh/c
495 Node         Callsigns
496 EI5TCR       (7 users)
497 GB7ADX
498 GB7BAA       G4FPV        G8TIC
499 GB7BIG       (GD0TEP)     GD3UMW
500 GB7BPQ       (G0INA)      G0RCI        G3AKU        G3OCA
501 (GB7CDX)     G3JNB        G4ALR
502 GB7DJK       G0FYD        G0REK        G1TLH        G4PEL        G4SOZ
503              G4TVR        G7SQW        K8AZ         M0CTQ-1      MM1CXE-10
504              ON7WP
505 GB7DXA       G0RDI        G8SJP
506 GB7DXC       (G0HDB)      G0WFK        (G1FYC)      G3KWK        G3LME
507              G3OIL        G4BGW        G4FUJ        (G4PDQ)      GW7SMV
508 GB7DXE       G1NNB
509 (GB7DXG)     GU6EFB       GU7DHI
510 GB7DXK       G1NTW        G3IBI        G3NSM        G3XAQ        G4CUS
511              G4XQY        G7GAN
512 GB7DXM       G1EUC        G3GAF        G3LAS        G4ZTR        G8WXU
513              M0BCT        M1EMF
514 </verb></tscreen>
515
516 You will notice that EI5TCR is showing only that it has 7 users and not
517 giving the actual callsigns.  This means that this node is on a limited
518 protocol of some kind, probably because of a contest situation where
519 slow radio links can block up and fail if too much information is sent
520 between nodes.
521
522 The second example would just show the nodes connected in the
523 network, like this,
524
525 <tscreen><verb>
526 sh/c/n
527 Node         Callsigns
528 GB7BAA       GB7BAA       GB7BPQ       (GB7CDX)     GB7DJK       GB7DXA      
529              GB7DXC       GB7DXE       (GB7DXG)     GB7DXK       GB7DXL      
530              GB7DXM       GB7DXS       GB7IPT       GB7MRS       GB7UJS      
531              GB7YDX       KL7G         N2TLY        (ON0DXK)                 
532 GB7BIG       EI5TCR       GB7ADX       GB7BIG       GB7UDX                   
533 GB7MBC                                                                       
534 PA4AB-14     PA4AB-14                                                        
535 PI4TUE-8     PI4TUE-8    
536 </verb></tscreen>
537
538 If we insert the node_call pi4tue-8 into the third example, then
539 this would be the output,
540
541 <tscreen><verb>
542 Node         Callsigns
543 PI4TUE-8     9A1CMA-6     DF6PW        DL4FAY       DL4KAK       DL4WF-2     
544              F5NOD-2      F5PAC        IZ0CSR       N6CR         OH2BLD      
545              ON1LVL-13    ON4CBT       ON4CJP       ON5DXL-14    ON7NQ       
546              PA0RCT       PA3DYS       PA3FDO       PA5KW-4      PI4TUE-9    
547              YT1XX        
548 </verb></tscreen>
549
550 As you can see, only the users of the requested node are shown.
551
552 You can also use a prefix to show only a group of nodes.  For example
553 you may only wish to see who is connected to the nodes in the UK.  To
554 do this simply use a prefix like this ...
555
556 <verb>
557 show/configuration gb7
558 </verb>
559
560 To show the locally connected users, the <bf>SHOW/USERS</bf> command is
561 used
562
563 <bf>Example:</bf>
564
565 <tscreen><verb>
566 show/users
567 </verb></tscreen>
568
569 The output of this command would look like this,
570
571 <tscreen><verb>
572 Callsigns connected to GB7MBC
573 G0JHC        G0NEI        G0VGS        G0VGS-2      G0YLM                    
574 G3JAG        G3OWO        G3UEU
575 </verb></tscreen>
576
577 <sect>Talk mode.
578
579 <p>
580 You can send a single comment or start a dedicated talk session to 
581 another user by using the <bf>TALK</bf> command. 
582
583 <p>
584 Talk mode is used to send a one line comment or greeting to a 
585 specific user connected either at your node or another in the 
586 network.  You can also enter into a dedicated talk session with 
587 another user.  Talks will be automatically forwarded to other nodes 
588 if the station you are talking to is not connected locally. 
589 You can find out who is connected by using the 
590 <bf>SHOW/CONFIGURATION</bf> command, (described earlier).
591
592 <bf>Examples:</bf>
593
594 <tscreen><verb> 
595 talk g0rdi Having a good day Iain?
596 </verb></tscreen>
597
598 This example would send the line "Having a good day Iain?" to the
599 user g0rdi but would leave you in normal mode.  
600
601 <tscreen><verb>
602 talk g0rdi
603 Entering Talkmode, /EX to end, /<cmd> to run a command
604 Talk (G0RDI)>
605 </verb></tscreen>
606
607 As you can see, you can still run commands whilst in talk mode.
608 Simply prefix the command with a / like /sh/dx and you will get
609 the expected output.
610 If the user is connected to another node, you may have to use a 
611 slightly extended version of the <bf>TALK</bf> command.
612
613 <tscreen><verb>
614 talk g0rdi > gb7djk
615 </verb></tscreen>
616
617 To exit talk mode, you issue the command <bf>/ex</bf>. 
618
619 Whilst in talk mode you will still receive DX spots.  This means that
620 you can chat to a friend whilst working DX.  
621
622 <sect>Mail.
623
624 <p>
625 You can send and receive both personal mail and bulletins with DXSpider 
626 quite easily.
627
628 <sect1>The "directory" command.
629
630 <p>
631 To list mail you would use the <bf>DIRECTORY</bf> command.  On its 
632 own, this command will output the last ten messages received by the 
633 node, either to or from yourself or bulletins such as "DX" and "ALL".
634 As with other commands you can display more by specifying a number 
635 with the command.  You should be aware that Spider will accept
636 these commands by separating with either a slash or a space, so
637 <em>dir new</em> and <em>dir/new</em> work in the same way.
638
639 <bf>Example:</bf>
640
641 <tscreen><verb>
642 directory
643 directory/20
644 directory 20
645 </verb></tscreen>
646
647 Of course most of the time you will only want to list new mail sent 
648 to you personally since your last login.  However you might also like 
649 to check for general mail received by the node.  In fact if there is 
650 new mail for you, the cluster will tell you when you login. You will 
651 also be informed if new mail arrives for you during the time you are 
652 logged in.
653 Mail is not only sent to callsigns though.  Mail can also be sent to 
654 subjects like "all" or "local" or "dx" etc.  You can treat these 
655 bulletins in the same way as personal mail with the directory 
656 command.
657
658 <bf>Examples:</bf>
659
660 <tscreen><verb>
661 directory/new
662 directory/own
663 directory/own/10
664 directory/all
665 directory/from <call>
666 </verb></tscreen>  
667
668 The last option will only show mail from a callsign if it was sent to
669 you personally or was sent as a bulletin.  There are some additional
670 commands and these can be found in the DXSpider Command Reference section.
671
672 <sect1>Reading mail.
673
674 <p>
675 The output of the <bf>DIRECTORY</bf> command could be something like 
676 this.
677
678 <tscreen><verb>
679 dir
680  20735      2      ALL   GW7SMV 21-Feb 1204Z REC 9E1S QSL TDY 50Mhz....    
681  20823    308       UK    G0HDB 22-Feb 2334Z Help - which district code?   
682  20824    105      ALL     W9AE 23-Feb 0349Z S0NY QSL address?             
683  20825      2       UK    G0LRJ 23-Feb 0806Z QSL REC LZ2CJ/1.CARD NO-750.  
684  20858      2      ALL   GW7SMV 24-Feb 0905Z REC S92DX QSL CARD TDY 50Mhz  
685  20921    200      ALL   GM4FDM 27-Feb 2203Z Trip to VP8                   
686  20949    375      ALL     K0MN 27-Feb 0428Z ST0P cards are gd @ ARRL      
687  20950      2       UK    G0LRJ 28-Feb 0835Z QSL REC SV9/IZ0CKJ/P EU-187.  
688  20987    569      ALL   GD0TEP  1-Mar 1733Z Portable contests             
689  21076      2      ALL    G4AFJ  3-Mar 1743Z kh6nd/kh5 qsl received
690  21184-p  599   GW4HAT    G0VGS  4-Mar 1518Z Re: Time 
691 </verb></tscreen>
692
693 The first column is the actual message number.  If the message is a
694 personal one to you, you will see a letter 'p' after this number.  If
695 the message has been read, there will be a '-' between the message
696 number and the 'p'.  This only works for personal messages.  The next
697 column shows the file size of the message.  The third column shows the
698 address the message was sent to and the next column shows who sent it.
699 The rest is fairly self-explanatory.
700
701 Reading a message is as simple as typing read, followed by the 
702 message number that you wish to read.
703
704 <bf>Example:</bf>
705
706 <tscreen><verb>
707 read 25
708 </verb></tscreen>
709
710 will read message number 25.  However the mail will be displayed in it's
711 entirety unless you specify a page length. You can set your page length
712 to any number you like and when the message reaches that number of lines
713 you will get a prompt giving you options.
714
715 <bf>Example:</bf>
716
717 <tscreen><verb>
718 set/page 20
719 </verb></tscreen>
720
721
722 <sect1>Sending mail.
723
724 <p>
725 Sending mail is done in the time honoured way.  First you specify
726 a recipient for the message, then you will be prompted for a subject.
727 Once you have done this you will be asked to type your message.
728 Please remember that there is no automatic word wrap, so unless you
729 are using a client that wraps lines automatically, remember to hit
730 return at the end of each line.
731
732 <bf>Example:</bf>
733
734 <tscreen><verb>
735 send m0azm
736 Enter Subject (30 characters):
737 See you Thursday
738 Enter Message /EX to send or /ABORT to exit
739 Hi Ian,            
740 Just a quick note to say that I can make Thursday after all.  The
741 appointment I had has cancelled so we are go!
742 Cheers
743 Ian
744 </verb></tscreen>
745
746 At this point you can either hit return and enter /ex to send the
747 message or use /abort at any time to abort it.  You can now display
748 the message in the normal way.  There are several send options and 
749 these are listed in the Command Set section.  These include sending
750 mail to several recipients and asking for a return receipt.
751
752
753 <sect1>Replying to mail.
754
755 <p>
756 If mail is addressed to you or to a bulletin address, you can use the
757 <bf>REPLY</bf> command to reply to it.  Using this command, the 
758 subject will be automatically set for you as "Re: subject", whatever 
759 the subject was. 
760  
761 <bf>Example:</bf>
762
763 <tscreen><verb>
764 reply 2500
765 </verb></tscreen>
766
767 <sect1>Deleting mail
768
769 <P>
770 To delete a message, you use the <em>delete</em> command.
771 You can only delete messages sent to or received by yourself.  
772 Bulletins are dealt with automatically or by the sysop.
773
774 <sect>Filtering (From version 1.45)
775
776 <sect1>General filter rules
777
778 <P>
779 Upto v1.44 it was not possible for the user to set their own filters.  From 
780 v1.45 though that has all changed.  It is now possible to set filters for just 
781 about anything you wish.  If you have just updated from an older version of 
782 DXSpider you will need to update your new filters.  You do not need to do 
783 anything with your old filters, they will be renamed as you update.
784
785 <P>
786 There are 3 basic commands involved in setting and manipulating filters.  These 
787 are <em>accept</em>, <em>reject</em> and <em>clear</em>.  First we will look
788 generally at filtering. There are a number of things you can filter in the 
789 DXSpider system. They all use the same general mechanism.
790
791 <P>
792 In general terms you can create a 'reject' or an 'accept' filter which can have 
793 up to 10 lines in it. You do this using, for example ... 
794
795 <tscreen><verb> 
796 accept/spots .....
797 reject/spots .....
798 </verb></tscreen>
799
800 where ..... are the specific commands for that type of filter. There are
801 filters for spots, wwv, announce, wcy and (for sysops) connects. See each 
802 different accept or reject command reference for more details.
803
804 There is also a command to clear out one or more lines in a filter. They are ...
805
806 <tscreen><verb>
807 clear/spots 1
808 clear/spots all
809 </verb></tscreen>
810
811 There is clear/xxxx command for each type of filter.
812
813 <P>
814 and you can check that your filters have worked by the command ... 
815
816 <tscreen><verb>  
817 show/filter
818 </verb></tscreen>
819
820 <P>
821 For now we are going to use spots for the examples, but you can apply the same
822 principles to all types of filter.
823
824 <sect1>Types of filter
825
826 <P>
827 There are two main types of filter, <em>accept</em> or <em>reject</em>.  You 
828 can use either to achieve the result you want dependent on your own preference 
829 and which is more simple to do.  It is pointless writing 8 lines of reject 
830 filters when 1 accept filter would do the same thing!  Each filter has 10 
831 lines (of any length) which are tried in order.  If a line matches then the 
832 action you have specified is taken (ie reject means ignore it and accept 
833 means take it)
834
835 <P>
836 If you specify reject filters, then any lines that arrive that match the filter 
837 will be dumped but all else will be accepted.  If you use an accept filter, 
838 then ONLY the lines in the filter will be accepted and all else will be dumped.
839 For example if you have a single line <em>accept</em> filter ...
840
841 <tscreen><verb>
842 accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
843 </verb></tscreen>
844
845 then you will <em>ONLY</em> get VHF spots <em>from</em> or <em>to</em> CQ zones 
846 14, 15 and 16.
847
848 <P>
849 If you set a reject filter like this ...
850
851 <tscreen><verb>
852 reject/spots on hf/cw
853 </verb></tscreen>
854
855 Then you will get everything <em>EXCEPT</em> HF CW spots.  You could make this 
856 single filter even more flexible.  For example, if you are interested in IOTA 
857 and will work it even on CW even though normally you are not interested in 
858 CW, then you could say ...
859
860 <tscreen><verb>
861 reject/spots on hf/cw and not info iota
862 </verb></tscreen>
863
864 But in that case you might only be interested in iota and say:-
865
866 <tscreen><verb>
867 accept/spots not on hf/cw or info iota
868 </verb></tscreen>
869
870 which achieves exactly the same thing. You should choose one or the other 
871 until you are comfortable with the way it works. You can mix them if you 
872 wish (actually you can have an accept AND a reject on the same line) but 
873 don't attempt this until you are sure you know what you are doing!
874
875 <P>
876 You can arrange your filter lines into logical units, either for your own
877 understanding or simply convenience. Here is an example ...
878
879 <tscreen><verb>
880 reject/spots 1 on hf/cw
881 reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
882 </verb></tscreen>
883
884 What this does is to ignore all HF CW spots and also rejects any spots on VHF 
885 which don't either originate or spot someone in Europe. 
886
887 <P>
888 This is an example where you would use a line number (1 and 2 in this case), if 
889 you leave the digit out, the system assumes '1'. Digits '0'-'9' are available.  
890 This make it easier to see just what filters you have set.  It also makes it 
891 more simple to remove individual filters, during a contest for example.
892
893 <P>
894 You will notice in the above example that the second line has brackets.  Look 
895 at the line logically.  You can see there are 2 separate sections to it.  We 
896 are saying reject spots that are VHF or above <em>APART</em> from those in 
897 zones 14, 15 and 16 (either spotted there or originated there).  If you did 
898 not have the brackets to separate the 2 sections, then Spider would read it 
899 logically from the front and see a different expression entirely ...
900
901 <tscreen><verb>
902 (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
903 </verb></tscreen>
904
905 The simple way to remember this is, if you use OR - use brackets. Whilst we are 
906 here CASE is not important. 'And BY_Zone' is just the same as 'and by_zone'.
907
908 As mentioned earlier, setting several filters can be more flexible than 
909 simply setting one complex one.  Doing it in this way means that if you want 
910 to alter your filter you can just redefine or remove one or more lines of it or 
911 one line. For example ...
912
913 <tscreen><verb>
914 reject/spots 1 on hf/ssb
915 </verb></tscreen>
916
917 would redefine our earlier example, or 
918
919 <tscreen><verb>
920 clear/spots 1
921 </verb></tscreen>
922
923 To remove all the filter lines in the spot filter ...
924
925 <tscreen><verb>
926 clear/spots all
927 </verb></tscreen>
928
929 <sect1>Filter options
930
931 <P>
932 You can filter in several different ways.  The options are listed in the
933 various helpfiles for accept, reject and filter.
934
935 <sect1>Advanced filtering
936
937 <P>
938 Once you are happy with the results you get, you may like to experiment. 
939
940 <P>
941 The previous example that filters hf/cw spots and accepts vhf/uhf spots from EU 
942 can be written with a mixed filter, for example ... 
943
944 <tscreen><verb>
945 rej/spot on hf/cw
946 acc/spot on 0/30000
947 acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
948 </verb></tscreen>
949
950 Note that the first filter has not been specified with a number.  This 
951 will automatically be assumed to be number 1.  In this case, we have 
952 said <em>reject all HF spots in the CW section of the bands but accept 
953 all others at HF.  Also accept anything in VHF and above spotted in or 
954 by operators in the zones 14, 15 and 16</em>.  Each filter slot actually 
955 has a 'reject' slot and an 'accept' slot. The reject slot is executed 
956 BEFORE the accept slot.
957
958 <P>
959 It was mentioned earlier that after a reject test that doesn't match, the 
960 default for following tests is 'accept', the reverse is true for 'accept'. 
961 In the example what happens is that the reject is executed first, any non 
962 hf/cw spot is passed to the accept line, which lets through everything 
963 else on HF.  The next filter line lets through just VHF/UHF spots from EU.
964
965
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/dxgrid
2218
2219 <P>
2220 <tt>
2221 <bf>set/dxgrid</bf> Allow QRA Grid Squares on the end of DX announcements
2222 </tt>
2223
2224 <P>
2225 <sect1>set/echo
2226
2227 <P>
2228 <tt>
2229 <bf>set/echo</bf> Make the cluster echo your input
2230 </tt>
2231
2232 <P>
2233 <sect1>set/email &lt;email&gt; ...
2234
2235 <P>
2236 <tt>
2237 <bf>set/email &lt;email&gt; ...</bf> Set email address(es) and forward your personals
2238 </tt>
2239
2240 <P>
2241 <sect1>set/here
2242
2243 <P>
2244 <tt>
2245 <bf>set/here</bf> Tell the system you are present at your terminal
2246 </tt>
2247
2248 <P>
2249 <sect1>set/homenode &lt;node&gt; 
2250
2251 <P>
2252 <tt>
2253 <bf>set/homenode &lt;node&gt; </bf> Set your normal cluster callsign
2254 </tt>
2255
2256 <P>
2257 Tell the cluster system where you normally connect to. Any Messages sent
2258 to you will normally find their way there should you not be connected.
2259 eg:-
2260 <tscreen><verb>
2261   SET/HOMENODE gb7djk
2262 </verb></tscreen>
2263
2264 <sect1>set/language &lt;lang&gt;
2265
2266 <P>
2267 <tt>
2268 <bf>set/language &lt;lang&gt;</bf> Set the language you want to use
2269 </tt>
2270
2271 <P>
2272 You can select the language that you want the cluster to use. Currently
2273 the languages available are en (English), de (German), es (Spanish) 
2274 and nl (Dutch).
2275 <sect1>set/location &lt;lat & long&gt;
2276
2277 <P>
2278 <tt>
2279 <bf>set/location &lt;lat & long&gt;</bf> Set your latitude and longitude
2280 </tt>
2281
2282 <P>
2283 <sect1>set/logininfo
2284
2285 <P>
2286 <tt>
2287 <bf>set/logininfo</bf> Inform when a station logs in locally
2288 </tt>
2289
2290 <P>
2291 <sect1>set/name &lt;your name&gt;
2292
2293 <P>
2294 <tt>
2295 <bf>set/name &lt;your name&gt;</bf> Set your name
2296 </tt>
2297
2298 <P>
2299 Tell the system what your name is eg:-
2300 <tscreen><verb>
2301   SET/NAME Dirk
2302 </verb></tscreen>
2303
2304 <sect1>set/page &lt;lines per page&gt;
2305
2306 <P>
2307 <tt>
2308 <bf>set/page &lt;lines per page&gt;</bf> Set the lines per page
2309 </tt>
2310
2311 <P>
2312 Tell the system how many lines you wish on a page when the number of line
2313 of output from a command is more than this. The default is 20. Setting it
2314 explicitly to 0 will disable paging. 
2315 <tscreen><verb>
2316   SET/PAGE 30
2317   SET/PAGE 0
2318 </verb></tscreen>
2319
2320 The setting is stored in your user profile.
2321 <sect1>set/password
2322
2323 <P>
2324 <tt>
2325 <bf>set/password</bf> Set your own password
2326 </tt>
2327
2328 <P>
2329 This command only works for a 'telnet' user (currently). It will
2330 only work if you have a password already set. This initial password
2331 can only be set by the sysop.
2332
2333 When you execute this command it will ask you for your old password,
2334 then ask you to type in your new password twice (to make sure you
2335 get it right). You may or may not see the data echoed on the screen
2336 as you type, depending on the type of telnet client you have.
2337 <sect1>set/prompt &lt;string&gt;
2338
2339 <P>
2340 <tt>
2341 <bf>set/prompt &lt;string&gt;</bf> Set your prompt to &lt;string&gt;
2342 </tt>
2343
2344 <P>
2345 <sect1>set/qra &lt;locator&gt;
2346
2347 <P>
2348 <tt>
2349 <bf>set/qra &lt;locator&gt;</bf> Set your QRA Grid locator
2350 </tt>
2351
2352 <P>
2353 Tell the system what your QRA (or Maidenhead) locator is. If you have not
2354 done a SET/LOCATION then your latitude and longitude will be set roughly
2355 correctly (assuming your locator is correct ;-). For example:-
2356 <tscreen><verb>
2357   SET/QRA JO02LQ
2358 </verb></tscreen>
2359
2360 <sect1>set/qth &lt;your qth&gt;
2361
2362 <P>
2363 <tt>
2364 <bf>set/qth &lt;your qth&gt;</bf> Set your QTH
2365 </tt>
2366
2367 <P>
2368 Tell the system where you are. For example:-
2369 <tscreen><verb>
2370   SET/QTH East Dereham, Norfolk
2371 </verb></tscreen>
2372
2373 <sect1>set/talk
2374
2375 <P>
2376 <tt>
2377 <bf>set/talk</bf> Allow TALK messages to come out on your terminal
2378 </tt>
2379
2380 <P>
2381 <sect1>set/wcy
2382
2383 <P>
2384 <tt>
2385 <bf>set/wcy</bf> Allow WCY messages to come out on your terminal
2386 </tt>
2387
2388 <P>
2389 <sect1>set/wwv
2390
2391 <P>
2392 <tt>
2393 <bf>set/wwv</bf> Allow WWV messages to come out on your terminal
2394 </tt>
2395
2396 <P>
2397 <sect1>set/wx
2398
2399 <P>
2400 <tt>
2401 <bf>set/wx</bf> Allow WX messages to come out on your terminal
2402 </tt>
2403
2404 <P>
2405 <sect1>show/configuration &lsqb;&lt;node&gt;&rsqb;
2406
2407 <P>
2408 <tt>
2409 <bf>show/configuration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
2410 </tt>
2411
2412 <P>
2413 This command allows you to see all the users that can be seen
2414 and the nodes to which they are connected.
2415
2416 This command is normally abbreviated to: sh/c
2417
2418 Normally, the list returned will be just for the nodes from your 
2419 country (because the list otherwise will be very long).
2420
2421 <tscreen><verb>
2422   SH/C ALL 
2423 </verb></tscreen>
2424
2425 will produce a complete list of all nodes. 
2426
2427 BE WARNED: the list that is returned can be VERY long
2428
2429 It is possible to supply a node or part of a prefix and you will get 
2430 a list of the users for that node or list of nodes starting with
2431 that prefix.
2432
2433 <tscreen><verb>
2434   SH/C GB7DJK
2435 </verb></tscreen>
2436
2437 <tscreen><verb>
2438   SH/C SK
2439 </verb></tscreen>
2440
2441 <sect1>show/configuration/node
2442
2443 <P>
2444 <tt>
2445 <bf>show/configuration/node</bf> Show all the nodes connected locally
2446 </tt>
2447
2448 <P>
2449 Show all the nodes connected to this node.
2450 <sect1>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2451
2452 <P>
2453 <tt>
2454 <bf>show/date &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
2455 </tt>
2456
2457 <P>
2458 This is very nearly the same as SHOW/TIME, the only difference the format
2459 of the date string if no arguments are given.
2460
2461 If no prefixes or callsigns are given then this command returns the local
2462 time and UTC as the computer has it right now. If you give some prefixes
2463 then it will show UTC and UTC + the local offset (not including DST) at
2464 the prefixes or callsigns that you specify.
2465 <sect1>show/dx
2466
2467 <P>
2468 <tt>
2469 <bf>show/dx</bf> Interrogate the spot database
2470 </tt>
2471
2472 <P>
2473 If you just type SHOW/DX you will get the last so many spots
2474 (sysop configurable, but usually 10).
2475    
2476 In addition you can add any number of these commands in very nearly
2477 any order to the basic SHOW/DX command, they are:-
2478    
2479 <tscreen><verb>
2480  on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
2481  on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
2482  on &lt;from&gt;/&lt;to&gt;  - eg 1000/4000 14000-30000  (in Khz)
2483     &lt;from&gt;-&lt;to&gt;
2484 </verb></tscreen>
2485    
2486 <tscreen><verb>
2487  &lt;number&gt;        - the number of spots you want
2488  &lt;from&gt;-&lt;to&gt;     - &lt;from&gt; spot no &lt;to&gt; spot no in the selected list
2489  &lt;from&gt;/&lt;to&gt;
2490 </verb></tscreen>
2491    
2492 <tscreen><verb>
2493  &lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
2494  *&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
2495  *&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
2496 </verb></tscreen>
2497    
2498 <tscreen><verb>
2499  day &lt;number&gt;    - starting &lt;number&gt; days ago
2500  day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
2501      &lt;from&gt;/&lt;to&gt;   
2502 </verb></tscreen>
2503
2504 <tscreen><verb>
2505  info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
2506 </verb></tscreen>
2507     
2508 <tscreen><verb>
2509  by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; is the 
2510                    same).
2511 </verb></tscreen>
2512
2513 <tscreen><verb>
2514  qsl             - this automatically looks for any qsl info on the call
2515                    held in the spot database.
2516 </verb></tscreen>
2517
2518 <tscreen><verb>
2519  iota [&lt;iota&gt;]   - If the iota island number is missing it will look for
2520                   the string iota and anything which looks like an iota
2521                   island number. If you specify then it will look for  
2522                   that island.
2523 </verb></tscreen>
2524
2525 <tscreen><verb>
2526  qra [&lt;locator&gt;] - this will look for the specific locator if you specify
2527                    one or else anything that looks like a locator.
2528 </verb></tscreen>
2529
2530 <tscreen><verb>
2531  dxcc            - treat the prefix as a 'country' and look for spots
2532                    from that country regardless of actual prefix.
2533                    eg dxcc oq2 
2534 </verb></tscreen>
2535                   
2536 <tscreen><verb>
2537                    You can also use this with the 'by' keyword so 
2538                    eg by W dxcc  
2539 </verb></tscreen>
2540    
2541 <tscreen><verb>
2542  e.g. 
2543 </verb></tscreen>
2544    
2545 <tscreen><verb>
2546    SH/DX 9m0
2547    SH/DX on 20m info iota
2548    SH/DX 9a on vhf day 30
2549    SH/DX rf1p qsl
2550    SH/DX iota 
2551    SH/DX iota eu-064
2552    SH/DX qra jn86
2553    SH/DX dxcc oq2
2554    SH/DX dxcc oq2 by w dxcc
2555 </verb></tscreen>
2556   
2557 <sect1>show/dxcc &lt;prefix&gt;
2558
2559 <P>
2560 <tt>
2561 <bf>show/dxcc &lt;prefix&gt;</bf> Interrogate the spot database by country
2562 </tt>
2563
2564 <P>
2565 This command takes the &lt;prefix&gt; (which can be a full or partial 
2566 callsign if desired), looks up which internal country number it is
2567 and then displays all the spots as per SH/DX for that country.
2568
2569 This is now an alias for 'SHOW/DX DXCC' 
2570    
2571 The options for SHOW/DX also apply to this command.   
2572 e.g. 
2573    
2574 <tscreen><verb>
2575    SH/DXCC G
2576    SH/DXCC W on 20m iota
2577 </verb></tscreen>
2578
2579 This can be done with the SHOW/DX command like this:-
2580
2581 <tscreen><verb>
2582    SH/DX dxcc g
2583    SH/DX dxcc w on 20m iota
2584 </verb></tscreen>
2585
2586 <sect1>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2587
2588 <P>
2589 <tt>
2590 <bf>show/dxstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the DX Statistics
2591 </tt>
2592
2593 <P>
2594 Show the total DX spots for the last &lt;days&gt; no of days (default is 31), 
2595 starting from a &lt;date&gt; (default: today).
2596 <sect1>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;
2597
2598 <P>
2599 <tt>
2600 <bf>show/files &lsqb;&lt;filearea&gt; &lsqb;&lt;string&gt;&rsqb;&rsqb;</bf> List the contents of a filearea
2601 </tt>
2602
2603 <P>
2604 SHOW/FILES on its own will show you a list of the various fileareas
2605 available on the system. To see the contents of a particular file
2606 area type:-
2607 <tscreen><verb>
2608    SH/FILES &lt;filearea&gt;
2609 </verb></tscreen>
2610 where &lt;filearea&gt; is the name of the filearea you want to see the 
2611 contents of.
2612
2613 You can also use shell globbing characters like '*' and '?' in a
2614 string to see a selection of files in a filearea eg:-
2615 <tscreen><verb>
2616    SH/FILES bulletins arld*
2617 </verb></tscreen>
2618
2619 See also TYPE - to see the contents of a file.
2620 <sect1>show/filter
2621
2622 <P>
2623 <tt>
2624 <bf>show/filter</bf> Show the contents of all the filters you have set
2625 </tt>
2626
2627 <P>
2628 Show the contents of all the filters that are set. This command displays
2629 all the filters set - for all the various categories.
2630 <sect1>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
2631
2632 <P>
2633 <tt>
2634 <bf>show/hfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the HF DX Statistics 
2635 </tt>
2636
2637 <P>
2638 Show the HF DX spots breakdown by band for the last &lt;days&gt; no of days 
2639 (default is 31), starting from a &lt;date&gt; (default: today).
2640 <sect1>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
2641
2642 <P>
2643 <tt>
2644 <bf>show/hftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the HF DX Spotter Table
2645 </tt>
2646
2647 <P>
2648 Show the HF DX Spotter table for the list of prefixes for the last 
2649 &lt;days&gt; no of days (default is 31), starting from a &lt;date&gt; (default: today).
2650
2651 If there are no prefixes then it will show the table for your country.
2652
2653 Remember that some countries have more than one "DXCC country" in them
2654 (eg G :-), to show them (assuming you are not in G already which is
2655 specially treated in the code) you must list all the relevant prefixes
2656
2657 <tscreen><verb>
2658   sh/hftable g gm gd gi gj gw gu 
2659 </verb></tscreen>
2660
2661 Note that the prefixes are converted into country codes so you don't have
2662 to list all possible prefixes for each country.
2663
2664 If you want more or less days than the default simply include the
2665 number you require:-
2666
2667 <tscreen><verb>
2668   sh/hftable 20 pa
2669 </verb></tscreen>
2670
2671 If you want to start at a different day, simply add the date in some 
2672 recognizable form:-
2673
2674 <tscreen><verb>
2675   sh/hftable 2 25nov02
2676   sh/hftable 2 25-nov-02 
2677   sh/hftable 2 021125 
2678   sh/hftable 2 25/11/02
2679 </verb></tscreen>
2680
2681 This will show the stats for your DXCC for that CQWW contest weekend. 
2682
2683 You can specify either prefixes or full callsigns (so you can see how you
2684 did against all your mates). You can also say 'all' which will then print
2685 the worldwide statistics.
2686
2687 <tscreen><verb>
2688   sh/hftable all 
2689 </verb></tscreen>
2690
2691 <sect1>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2692
2693 <P>
2694 <tt>
2695 <bf>show/moon &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show Moon rise and set times
2696 </tt>
2697
2698 <P>
2699 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
2700 together with the azimuth and elevation of the sun currently at those
2701 locations.
2702
2703 If you don't specify any prefixes or callsigns, it will show the times for
2704 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2705 together with the current azimuth and elevation.
2706
2707 In addition, it will show the illuminated fraction of the moons disk.
2708
2709 If all else fails it will show the Moonrise and set times for the node
2710 that you are connected to. 
2711
2712 For example:-
2713
2714 <tscreen><verb>
2715   SH/MOON
2716   SH/MOON G1TLH W5UN
2717 </verb></tscreen>
2718
2719 You can also use this command to see into the past or the future, so
2720 if you want to see yesterday's times then do:-
2721
2722 <tscreen><verb>
2723   SH/MOON -1 
2724 </verb></tscreen>
2725
2726 or in three days time:-
2727
2728 <tscreen><verb>
2729   SH/MOON +3 W9
2730 </verb></tscreen>
2731
2732 Upto 366 days can be checked both in the past and in the future.
2733
2734 Please note that the rise and set times are given as the UT times of rise and 
2735 set on the requested UT day.
2736 <sect1>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;
2737
2738 <P>
2739 <tt>
2740 <bf>show/muf &lt;prefix&gt; &lsqb;&lt;hours&gt;&rsqb;&lsqb;long&rsqb;</bf> Show the likely propagation to a prefix
2741 </tt>
2742
2743 <P>
2744 This command allow you to estimate the likelihood of you contacting
2745 a station with the prefix you have specified. The output assumes a modest
2746 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
2747
2748 The result predicts the most likely operating frequencies and signal
2749 levels for high frequency (shortwave) radio propagation paths on
2750 specified days of the year and hours of the day. It is most useful for
2751 paths between 250 km and 6000 km, but can be used with reduced accuracy
2752 for paths shorter or longer than this.
2753
2754 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
2755 used to predict the MUF given the predicted flux, day of the year,
2756 hour of the day and geographic coordinates of the transmitter and
2757 receiver. This routine is reasonably accurate for the purposes here,
2758 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
2759 than the programs used by major shortwave broadcasting organizations,
2760 such as the Voice of America.
2761
2762 The command will display some header information detailing its
2763 assumptions, together with the locations, latitude and longitudes and
2764 bearings. It will then show UTC (UT), local time at the other end
2765 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
2766 (Zen) and the likely signal strengths. Then for each frequency for which
2767 the system thinks there is a likelihood of a circuit it prints a value.
2768
2769 The value is currently a likely S meter reading based on the conventional
2770 6dB / S point scale. If the value has a '+' appended it means that it is
2771 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
2772 there is likely to be much fading and by an 's' that the signal is likely
2773 to be noisy.  
2774
2775 By default SHOW/MUF will show the next two hours worth of data. You
2776 can specify anything up to 24 hours worth of data by appending the no of
2777 hours required after the prefix. For example:-
2778
2779 <tscreen><verb>
2780   SH/MUF W
2781 </verb></tscreen>
2782
2783 produces:
2784
2785 <tscreen><verb>
2786   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
2787   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
2788   Location                       Lat / Long           Azim
2789   East Dereham, Norfolk          52 41 N 0 57 E         47
2790   United-States-W                43 0 N 87 54 W        299
2791   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
2792   18 23 11.5 -35  mS0+ mS2   S3
2793   19  0 11.2 -41  mS0+ mS2   S3
2794 </verb></tscreen>
2795
2796 indicating that you will have weak, fading circuits on top band and 
2797 80m but usable signals on 40m (about S3).
2798
2799 inputing:-
2800
2801 <tscreen><verb>
2802   SH/MUF W 24
2803 </verb></tscreen>
2804
2805 will get you the above display, but with the next 24 hours worth of
2806 propagation data.
2807
2808 <tscreen><verb>
2809   SH/MUF W L 24
2810   SH/MUF W 24 Long
2811 </verb></tscreen>
2812
2813 Gives you an estimate of the long path propagation characterics. It
2814 should be noted that the figures will probably not be very useful, nor
2815 terrible accurate, but it is included for completeness.
2816 <sect1>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;
2817
2818 <P>
2819 <tt>
2820 <bf>show/newconfiguration &lsqb;&lt;node&gt;&rsqb;</bf> Show all the nodes and users visible
2821 </tt>
2822
2823 <P>
2824 This command allows you to see all the users that can be seen
2825 and the nodes to which they are connected. 
2826
2827 This command produces essentially the same information as 
2828 SHOW/CONFIGURATION except that it shows all the duplication of
2829 any routes that might be present It also uses a different format
2830 which may not take up quite as much space if you don't have any
2831 loops.
2832
2833 BE WARNED: the list that is returned can be VERY long
2834 <sect1>show/newconfiguration/node
2835
2836 <P>
2837 <tt>
2838 <bf>show/newconfiguration/node</bf> Show all the nodes connected locally
2839 </tt>
2840
2841 <P>
2842 Show all the nodes connected to this node in the new format.
2843 <sect1>show/prefix &lt;callsign&gt;
2844
2845 <P>
2846 <tt>
2847 <bf>show/prefix &lt;callsign&gt;</bf> Interrogate the prefix database 
2848 </tt>
2849
2850 <P>
2851 This command takes the &lt;callsign&gt; (which can be a full or partial 
2852 callsign or a prefix), looks up which internal country number 
2853 it is and then displays all the relevant prefixes for that country
2854 together with the internal country no, the CQ and ITU regions. 
2855
2856 See also SHOW/DXCC
2857 <sect1>show/qra &lt;lat&gt; &lt;long&gt;
2858
2859 <P>
2860 <tt>
2861 <bf>show/qra &lt;lat&gt; &lt;long&gt;</bf> Convert lat/long to a QRA Grid locator
2862 </tt>
2863
2864 <P>
2865 This is a multipurpose command that allows you either to calculate the
2866 distance and bearing between two locators or (if only one locator is
2867 given on the command line) the distance and beraing from your station
2868 to the locator. For example:-
2869
2870 <tscreen><verb>
2871  SH/QRA IO92QL 
2872  SH/QRA JN06 IN73
2873 </verb></tscreen>
2874
2875 The first example will show the distance and bearing to the locator from
2876 yourself, the second example will calculate the distance and bearing from
2877 the first locator to the second. You can use 4 or 6 character locators.
2878
2879 It is also possible to convert a latitude and longitude to a locator by 
2880 using this command with a latitude and longitude as an argument, for
2881 example:-
2882
2883 <tscreen><verb>
2884  SH/QRA 52 41 N 0 58 E
2885 </verb></tscreen>
2886
2887 <sect1>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;
2888
2889 <P>
2890 <tt>
2891 <bf>show/qra &lt;locator&gt; &lsqb;&lt;locator&gt;&rsqb;</bf> Show distance between QRA Grid locators
2892 </tt>
2893
2894 <P>
2895 <sect1>show/qrz &lt;callsign&gt;
2896
2897 <P>
2898 <tt>
2899 <bf>show/qrz &lt;callsign&gt;</bf> Show any callbook details on a callsign
2900 </tt>
2901
2902 <P>
2903 This command queries the QRZ callbook server on the internet
2904 and returns any information available for that callsign. This service
2905 is provided for users of this software by http://www.qrz.com 
2906 <sect1>show/route &lt;callsign&gt; ...
2907
2908 <P>
2909 <tt>
2910 <bf>show/route &lt;callsign&gt; ...</bf> Show the route to the callsign
2911 </tt>
2912
2913 <P>
2914 This command allows you to see to which node the callsigns specified are
2915 connected. It is a sort of inverse sh/config.
2916
2917 <tscreen><verb>
2918  sh/route n2tly
2919 </verb></tscreen>
2920
2921 <sect1>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;
2922
2923 <P>
2924 <tt>
2925 <bf>show/satellite &lt;name&gt; &lsqb;&lt;hours&gt; &lt;interval&gt;&rsqb;</bf> Show tracking data
2926 </tt>
2927
2928 <P>
2929 Show the tracking data from your location to the satellite of your choice
2930 from now on for the next few hours.
2931
2932 If you use this command without a satellite name it will display a list
2933 of all the satellites known currently to the system. 
2934
2935 If you give a name then you can obtain tracking data of all the passes
2936 that start and finish 5 degrees below the horizon. As default it will
2937 give information for the next three hours for every five minute period.
2938
2939 You can alter the number of hours and the step size, within certain 
2940 limits. 
2941
2942 Each pass in a period is separated with a row of '-----' characters
2943
2944 So for example:-
2945
2946 <tscreen><verb>
2947  SH/SAT AO-10 
2948  SH/SAT FENGYUN1 12 2
2949 </verb></tscreen>
2950
2951 <sect1>show/station &lsqb;&lt;callsign&gt; ..&rsqb;
2952
2953 <P>
2954 <tt>
2955 <bf>show/station &lsqb;&lt;callsign&gt; ..&rsqb;</bf> Show information about a callsign
2956 </tt>
2957
2958 <P>
2959 Show the information known about a callsign and whether (and where)
2960 that callsign is connected to the cluster.
2961
2962 <tscreen><verb>
2963   SH/ST G1TLH
2964 </verb></tscreen>
2965
2966 If no callsign is given then show the information for yourself.
2967 <sect1>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
2968
2969 <P>
2970 <tt>
2971 <bf>show/sun &lsqb;ndays&rsqb; &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show sun rise and set times
2972 </tt>
2973
2974 <P>
2975 Show the sun rise and set times for a (list of) prefixes or callsigns, 
2976 together with the azimuth and elevation of the sun currently at those
2977 locations.
2978
2979 If you don't specify any prefixes or callsigns, it will show the times for
2980 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2981 together with the current azimuth and elevation.
2982
2983 If all else fails it will show the sunrise and set times for the node
2984 that you are connected to. 
2985
2986 For example:-
2987
2988 <tscreen><verb>
2989   SH/SUN
2990   SH/SUN G1TLH K9CW ZS
2991 </verb></tscreen>
2992
2993 You can also use this command to see into the past or the future, so
2994 if you want to see yesterday's times then do:-
2995
2996 <tscreen><verb>
2997   SH/SUN -1 
2998 </verb></tscreen>
2999
3000 or in three days time:-
3001
3002 <tscreen><verb>
3003   SH/SUN +3 W9
3004 </verb></tscreen>
3005
3006 Upto 366 days can be checked both in the past and in the future.
3007
3008 Please note that the rise and set times are given as the UT times of rise 
3009 and set on the requested UT day.
3010 <sect1>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;
3011
3012 <P>
3013 <tt>
3014 <bf>show/time &lsqb;&lt;prefix&gt;|&lt;callsign&gt;&rsqb;</bf> Show the local time 
3015 </tt>
3016
3017 <P>
3018 If no prefixes or callsigns are given then this command returns the local
3019 time and UTC as the computer has it right now. If you give some prefixes
3020 then it will show UTC and UTC + the local offset (not including DST) at
3021 the prefixes or callsigns that you specify.
3022 <sect1>show/usdb &lsqb;call ..&rsqb;
3023
3024 <P>
3025 <tt>
3026 <bf>show/usdb &lsqb;call ..&rsqb;</bf> Show information held on the FCC Call database
3027 </tt>
3028
3029 <P>
3030 Show the City and State of a Callsign held on the FCC database if
3031 his is being run on this system, eg:-
3032
3033 <tscreen><verb>
3034   sh/usdb k1xx
3035 </verb></tscreen>
3036
3037 <sect1>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;
3038
3039 <P>
3040 <tt>
3041 <bf>show/vhfstats &lsqb;days&rsqb; &lsqb;date&rsqb;</bf> Show the VHF DX Statistics
3042 </tt>
3043
3044 <P>
3045 Show the VHF DX spots breakdown by band for the last 
3046 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3047 <sect1>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;
3048
3049 <P>
3050 <tt>
3051 <bf>show/vhftable &lsqb;days&rsqb; &lsqb;date&rsqb; &lsqb;prefix ...&rsqb;</bf> Show the VHF DX Spotter Table
3052 </tt>
3053
3054 <P>
3055 Show the VHF DX Spotter table for the list of prefixes for the last 
3056 &lt;days&gt; no of days (default is 31), starting from a date (default: today).
3057
3058 If there are no prefixes then it will show the table for your country.
3059
3060 Remember that some countries have more than one "DXCC country" in them
3061 (eg G :-), to show them (assuming you are not in G already which is
3062 specially treated in the code) you must list all the relevant prefixes
3063
3064 <tscreen><verb>
3065   sh/vhftable g gm gd gi gj gw gu 
3066 </verb></tscreen>
3067
3068 Note that the prefixes are converted into country codes so you don't have
3069 to list all possible prefixes for each country.
3070
3071 If you want more or less days than the default simply include the
3072 number you require:-
3073
3074 <tscreen><verb>
3075   sh/vhftable 20 pa
3076 </verb></tscreen>
3077
3078 If you want to start at a different day, simply add the date in some 
3079 recognizable form:-
3080
3081 <tscreen><verb>
3082   sh/vhftable 2 25nov02
3083   sh/vhftable 2 25-nov-02 
3084   sh/vhftable 2 021125 
3085   sh/vhftable 2 25/11/02
3086 </verb></tscreen>
3087
3088 This will show the stats for your DXCC for that CQWW contest weekend. 
3089
3090 You can specify either prefixes or full callsigns (so you can see how you
3091 did against all your mates). You can also say 'all' which will then print
3092 the worldwide statistics.
3093
3094 <tscreen><verb>
3095   sh/vhftable all 
3096 </verb></tscreen>
3097
3098 <sect1>show/wcy
3099
3100 <P>
3101 <tt>
3102 <bf>show/wcy</bf> Show last 10 WCY broadcasts
3103 </tt>
3104
3105 <P>
3106 <sect1>show/wcy &lt;n&gt;
3107
3108 <P>
3109 <tt>
3110 <bf>show/wcy &lt;n&gt;</bf> Show last &lt;n&gt; WCY broadcasts
3111 </tt>
3112
3113 <P>
3114 Display the most recent WCY information that has been received by the system
3115 <sect1>show/wwv
3116
3117 <P>
3118 <tt>
3119 <bf>show/wwv</bf> Show last 10 WWV broadcasts
3120 </tt>
3121
3122 <P>
3123 <sect1>show/wwv &lt;n&gt;
3124
3125 <P>
3126 <tt>
3127 <bf>show/wwv &lt;n&gt;</bf> Show last &lt;n&gt; WWV broadcasts
3128 </tt>
3129
3130 <P>
3131 Display the most recent WWV information that has been received by the system
3132 <sect1>sysop
3133
3134 <P>
3135 <tt>
3136 <bf>sysop</bf> Regain your privileges if you login remotely
3137 </tt>
3138
3139 <P>
3140 The system automatically reduces your privilege level to that of a
3141 normal user if you login in remotely. This command allows you to
3142 regain your normal privilege level. It uses the normal system: five
3143 numbers are returned that are indexes into the character array that is
3144 your assigned password (see SET/PASSWORD). The indexes start from
3145 zero.
3146
3147 You are expected to return a string which contains the characters
3148 required in the correct order. You may intersperse those characters
3149 with others to obscure your reply for any watchers. For example (and
3150 these values are for explanation :-):
3151
3152 <tscreen><verb>
3153   password = 012345678901234567890123456789
3154   &gt; sysop
3155   22 10 15 17 3
3156 </verb></tscreen>
3157 you type:-
3158 <tscreen><verb>
3159  aa2bbbb0ccc5ddd7xxx3n
3160  or 2 0 5 7 3
3161  or 20573
3162 </verb></tscreen>
3163
3164 They will all match. If there is no password you will still be offered
3165 numbers but nothing will happen when you input a string. Any match is
3166 case sensitive.
3167 <sect1>talk &lt;call&gt; &gt; &lt;node&gt; &lsqb;&lt;text&gt;&rsqb;
3168
3169 <P>
3170 <tt>
3171 <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
3172 </tt>
3173
3174 <P>
3175 Send a short message to any other station that is visible on the cluster
3176 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
3177 command, they don't have to be connected locally.
3178
3179 The second form of TALK is used when other cluster nodes are connected
3180 with restricted information. This usually means that they don't send 
3181 the user information usually associated with logging on and off the cluster.
3182
3183 If you know that G3JNB is likely to be present on GB7TLH, but you can only
3184 see GB7TLH in the SH/C list but with no users, then you would use the
3185 second form of the talk message.
3186
3187 If you want to have a ragchew with someone you can leave the text message
3188 out and the system will go into 'Talk' mode. What this means is that a
3189 short message is sent to the recipient telling them that you are in a
3190 'Talking' frame of mind and then you just type - everything you send will
3191 go to the station that you asked for. 
3192
3193 All the usual announcements, spots and so on will still come out on your
3194 terminal.
3195
3196 If you want to do something (such as send a spot) you preceed the normal 
3197 command with a '/' character, eg:-
3198
3199 <tscreen><verb>
3200    /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
3201    /HELP talk
3202 </verb></tscreen>
3203
3204 To leave talk mode type:
3205    
3206 <tscreen><verb>
3207    /EX
3208 </verb></tscreen>
3209
3210 If you are in 'Talk' mode, there is an extention to the '/' command which
3211 allows you to send the output to all the people you are talking to. You do 
3212 with the '//' command. For example:-
3213
3214 <tscreen><verb>
3215   //sh/hftable
3216 </verb></tscreen>
3217
3218 will send the hftable as you have it to all the people you are currently 
3219 talking to.
3220 <sect1>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;
3221
3222 <P>
3223 <tt>
3224 <bf>talk &lt;call&gt; &lsqb;&lt;text&gt;&rsqb;</bf> Send a text message to another station
3225 </tt>
3226
3227 <P>
3228 <sect1>type &lt;filearea&gt;/&lt;name&gt;
3229
3230 <P>
3231 <tt>
3232 <bf>type &lt;filearea&gt;/&lt;name&gt;</bf> Look at the contents of a file in one of the fileareas
3233 </tt>
3234
3235 <P>
3236 Type out the contents of a file in a filearea. So, for example, in 
3237 filearea 'bulletins' you want to look at file 'arld051' you would 
3238 enter:-
3239 <tscreen><verb>
3240    TYPE bulletins/arld051
3241 </verb></tscreen>
3242
3243 See also SHOW/FILES to see what fileareas are available and a 
3244 list of content.
3245 <sect1>unset/announce
3246
3247 <P>
3248 <tt>
3249 <bf>unset/announce</bf> Stop announce messages coming out on your terminal
3250 </tt>
3251
3252 <P>
3253 <sect1>unset/anntalk
3254
3255 <P>
3256 <tt>
3257 <bf>unset/anntalk</bf> Stop talk like announce messages on your terminal
3258 </tt>
3259
3260 <P>
3261 The announce system on legacy cluster nodes is used as a talk 
3262 substitute because the network is so poorly connected. If you:
3263
3264 <tscreen><verb>
3265   unset/anntalk
3266 </verb></tscreen>
3267
3268 you will suppress several of these announces, you may miss the odd 
3269 useful one as well, but you would probably miss them anyway in the
3270 welter of useless ones.
3271
3272 <tscreen><verb>
3273   set/anntalk 
3274 </verb></tscreen>
3275
3276 allows you to see them again. This is the default.
3277 <sect1>unset/beep
3278
3279 <P>
3280 <tt>
3281 <bf>unset/beep</bf> Stop beeps for DX and other messages on your terminal
3282 </tt>
3283
3284 <P>
3285 <sect1>unset/dx
3286
3287 <P>
3288 <tt>
3289 <bf>unset/dx</bf> Stop DX messages coming out on your terminal
3290 </tt>
3291
3292 <P>
3293 <sect1>unset/dxgrid
3294
3295 <P>
3296 <tt>
3297 <bf>unset/dxgrid</bf> Stop QRA Grid Squares on the end of DX announcements
3298 </tt>
3299
3300 <P>
3301 A standard feature which is enabled in version 1.43 and above is 
3302 that if the spotter's grid square is known it is output on the end
3303 of a DX announcement (there is just enough room). Some user programs
3304 cannot cope with this. You can use this command to reset (or set)
3305 this feature.
3306 <sect1>unset/echo
3307
3308 <P>
3309 <tt>
3310 <bf>unset/echo</bf> Stop the cluster echoing your input
3311 </tt>
3312
3313 <P>
3314 If you are connected via a telnet session, different implimentations
3315 of telnet handle echo differently depending on whether you are 
3316 connected via port 23 or some other port. You can use this command
3317 to change the setting appropriately. 
3318
3319 The setting is stored in your user profile.
3320
3321 YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
3322 <sect1>unset/email
3323
3324 <P>
3325 <tt>
3326 <bf>unset/email</bf> Stop personal msgs being forwarded by email
3327 </tt>
3328
3329 <P>
3330 If any personal messages come in for your callsign then you can use
3331 these commands to control whether they are forwarded onto your email
3332 address. To enable the forwarding do something like:-
3333
3334 <tscreen><verb>
3335   SET/EMAIL mike.tubby@somewhere.com
3336 </verb></tscreen>
3337
3338 You can have more than one email address (each one separated by a space).
3339 Emails are forwarded to all the email addresses you specify.
3340
3341 You can disable forwarding by:-
3342
3343 <tscreen><verb>
3344   UNSET/EMAIL
3345 </verb></tscreen>
3346
3347 <sect1>unset/here
3348
3349 <P>
3350 <tt>
3351 <bf>unset/here</bf> Tell the system you are absent from your terminal
3352 </tt>
3353
3354 <P>
3355 <sect1>unset/logininfo
3356
3357 <P>
3358 <tt>
3359 <bf>unset/logininfo</bf> Inform when a station logs out locally
3360 </tt>
3361
3362 <P>
3363 <sect1>unset/privilege
3364
3365 <P>
3366 <tt>
3367 <bf>unset/privilege</bf> Remove any privilege for this session
3368 </tt>
3369
3370 <P>
3371 You can use this command to 'protect' this session from unauthorised
3372 use. If you want to get your normal privilege back you will need to
3373 either logout and login again (if you are on a console) or use the
3374 SYSOP command.
3375 <sect1>unset/prompt
3376
3377 <P>
3378 <tt>
3379 <bf>unset/prompt</bf> Set your prompt back to default
3380 </tt>
3381
3382 <P>
3383 This command will set your user prompt to exactly the string that you 
3384 say. The point of this command to enable a user to interface to programs
3385 that are looking for a specific prompt (or else you just want a different
3386 fixed prompt).
3387
3388 <tscreen><verb>
3389   SET/PROMPT clx &gt;
3390 </verb></tscreen>
3391
3392 UNSET/PROMPT will undo the SET/PROMPT command and set you prompt back to
3393 normal.
3394 <sect1>unset/talk
3395
3396 <P>
3397 <tt>
3398 <bf>unset/talk</bf> Stop TALK messages coming out on your terminal
3399 </tt>
3400
3401 <P>
3402 <sect1>unset/wcy
3403
3404 <P>
3405 <tt>
3406 <bf>unset/wcy</bf> Stop WCY messages coming out on your terminal
3407 </tt>
3408
3409 <P>
3410 <sect1>unset/wwv
3411
3412 <P>
3413 <tt>
3414 <bf>unset/wwv</bf> Stop WWV messages coming out on your terminal
3415 </tt>
3416
3417 <P>
3418 <sect1>unset/wx
3419
3420 <P>
3421 <tt>
3422 <bf>unset/wx</bf> Stop WX messages coming out on your terminal
3423 </tt>
3424
3425 <P>
3426 <sect1>who
3427
3428 <P>
3429 <tt>
3430 <bf>who</bf> Show who is physically connected
3431 </tt>
3432
3433 <P>
3434 This is a quick listing that shows which callsigns are connected and
3435 what sort of connection they have
3436 <sect1>wx &lt;text&gt;
3437
3438 <P>
3439 <tt>
3440 <bf>wx &lt;text&gt;</bf> Send a weather message to local users
3441 </tt>
3442
3443 <P>
3444 <sect1>wx full &lt;text&gt;
3445
3446 <P>
3447 <tt>
3448 <bf>wx full &lt;text&gt;</bf> Send a weather message to all cluster users
3449 </tt>
3450
3451 <P>
3452 </article>