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