]> scm.dxcluster.org Git - spider.git/blob - txt/adminmanual.txt
de47e0af844cc43569aa059e35c5fa25e5c5e2ff
[spider.git] / txt / adminmanual.txt
1   The DXSpider Installation and Administration Manual
2   Ian Maude, G0VGS, (ianmaude@btinternet.com)
3   Version 1.33 February 2001
4
5   A reference for SysOps of the DXSpider DXCluster program.
6   ______________________________________________________________________
7
8   Table of Contents
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67   1. Installation (Original version by Iain Phillips, G0RDI)
68
69      1.1 Introduction
70      1.2 Preparation
71      1.3 Installing the software
72      1.4 Setting callsigns etc
73      1.5 Starting up for the first time
74
75   2. The Client program
76
77   3. Configuration
78
79      3.1 Allowing ax25 connects from users
80      3.2 Allowing telnet connects from users
81      3.3 Setting up node connects
82      3.4 Connection scripts
83      3.5 Starting the connection
84      3.6 Telnet echo
85
86   4. Automating things
87
88      4.1 Autostarting the cluster
89      4.2 The crontab file
90
91   5. Hop control
92
93      5.1 Basic hop control
94      5.2 Isolating networks
95
96   6. Filtering (Old Style upto v1.44)
97
98      6.1 Spots
99      6.2 Announcements
100      6.3 WWV
101
102   7. Filtering (New Style v1.45 and later)
103
104      7.1 General filter rules
105      7.2 Types of filter
106      7.3 Filter options
107      7.4 Default filters
108      7.5 Advanced filtering
109
110   8. Other filters
111
112      8.1 Filtering Mail
113      8.2 Filtering DX callouts (Depricated)
114      8.3 Filtering words from text fields in Announce, Talk and DX spots
115
116   9. Mail
117
118      9.1 Personal mail
119      9.2 Bulletin mail
120      9.3 Forward.pl
121      9.4 The msg command
122      9.5 Message status
123      9.6 Filtering mail
124      9.7 Distribution lists
125      9.8 BBS interface
126
127   10. Databases
128
129      10.1 Creating databases
130      10.2 Importing databases
131      10.3 Checking available databases
132      10.4 Looking up databases
133      10.5 Removing databases
134
135   11. Information, files and useful programs
136
137      11.1 MOTD
138      11.2 Downtime message
139      11.3 Other text messages
140      11.4 The Aliases file
141      11.5 Console.pl
142      11.6 Updating kepler data
143      11.7 The QRZ callbook
144
145   12. CVS
146
147   13. The DXSpider command set
148
149      13.1 accept/announce (0)
150      13.2 accept/announce (extended for sysops) (8)
151      13.3 accept/spots (0)
152      13.4 accept/spots (extended for sysops) (8)
153      13.5 accept/wcy (0)
154      13.6 accept/wcy (extended for sysops) (8)
155      13.7 accept/wwv (0)
156      13.8 accept/wwv (extended for sysops) (8)
157      13.9 announce (0)
158      13.10 announce full (0)
159      13.11 announce sysop (5)
160      13.12 apropos (0)
161      13.13 bye (0)
162      13.14 catchup (5)
163      13.15 clear/spots (0)
164      13.16 connect (5)
165      13.17 dbavail (0)
166      13.18 dbcreate (9)
167      13.19 dbimport (9)
168      13.20 dbremove (9)
169      13.21 dbshow (0)
170      13.22 debug (9)
171      13.23 directory (0)
172      13.24 directory (extended for sysops) (5)
173      13.25 disconnect (8)
174      13.26 dx (0)
175      13.27 export (9)
176      13.28 export_users (9)
177      13.29 forward/latlong (8)
178      13.30 forward/opername (1)
179      13.31 help (0)
180      13.32 init (5)
181      13.33 kill (0)
182      13.34 kill (5)
183      13.35 kill full (5)
184      13.36 links (0)
185      13.37 load/aliases (9)
186      13.38 load/baddx (9)
187      13.39 load/badmsg (9)
188      13.40 load/badwords (9)
189      13.41 load/bands (9)
190      13.42 load/cmd_cache (9)
191      13.43 load/forward (9)
192      13.44 load/messages (9)
193      13.45 load/prefixes (9)
194      13.46 merge (5)
195      13.47 msg (9)
196      13.48 pc (8)
197      13.49 ping (1)
198      13.50 rcmd (1)
199      13.51 read (0)
200      13.52 read (extended for sysops) (5)
201      13.53 reject/announce
202      13.54 reject/announce (extended for sysops) (8)
203      13.55 reject/spots (0)
204      13.56 reject/spots (extended for sysops) (8)
205      13.57 reject/wcy (0)
206      13.58 reject/wcy (extended for sysops) (8)
207      13.59 reject/wwv (0)
208      13.60 reject/wwv (extended for sysops) (8)
209      13.61 reply (0)
210      13.62 send (0)
211      13.63 set/address (0)
212      13.64 set/announce (0)
213      13.65 set/arcluster (5)
214      13.66 set/baddx (8)
215      13.67 set/badnode (6)
216      13.68 set/badspotter (8)
217      13.69 set/beep (0)
218      13.70 set/clx (5)
219      13.71 set/debug (9)
220      13.72 set/dx (0)
221      13.73 set/dxgrid (0)
222      13.74 set/dxnet (5)
223      13.75 set/echo (0)
224      13.76 set/here (0)
225      13.77 set/homenode (0)
226      13.78 set/hops (8)
227      13.79 set/isolate (9)
228      13.80 set/language (0)
229      13.81 set/location (0)
230      13.82 set/sys_location (9)
231      13.83 set/logininfo (0)
232      13.84 set/lockout (9)
233      13.85 set/name (0)
234      13.86 set/node (9)
235      13.87 set/obscount (9)
236      13.88 set/page (0)
237      13.89 set/password (9)
238      13.90 set/pinginterval (9)
239      13.91 set/privilege (9)
240      13.92 set/spider (5)
241      13.93 set/sys_qra (9)
242      13.94 set/qra (0)
243      13.95 set/qth (0)
244      13.96 set/talk (0)
245      13.97 set/wcy (0)
246      13.98 set/wwv (0)
247      13.99 set/wx (0)
248      13.100 show/baddx (1)
249      13.101 show/badnode (6)
250      13.102 show/badspotter (1)
251      13.103 show/date (0)
252      13.104 show/dx (0)
253      13.105 show/dxcc (0)
254      13.106 show/files (0)
255      13.107 show/filter (0)
256      13.108 show/filter (extended for sysops) (5)
257      13.109 show/hops (8)
258      13.110 show/isolate (1)
259      13.111 show/lockout (9)
260      13.112 show/log (8)
261      13.113 show/moon (0)
262      13.114 show/muf (0)
263      13.115 show/node (1)
264      13.116 show/prefix (0)
265      13.117 show/program (5)
266      13.118 show/qra (0)
267      13.119 show/qrz (0)
268      13.120 show/route (0)
269      13.121 show/satellite (0)
270      13.122 show/sun (0)
271      13.123 show/time (0)
272      13.124 show/wcy (0)
273      13.125 show/wwv (0)
274      13.126 shutdown (5)
275      13.127 spoof (9)
276      13.128 stat/db (5)
277      13.129 stat/channel (5)
278      13.130 stat/msg (5)
279      13.131 stat/user (5)
280      13.132 sysop (0)
281      13.133 talk (0)
282      13.134 type (0)
283      13.135 who (0)
284      13.136 wx (0)
285      13.137 wx (enhanced for sysops) (5)
286
287
288   ______________________________________________________________________
289
290   1\b1.\b.  I\bIn\bns\bst\bta\bal\bll\bla\bat\bti\bio\bon\bn (\b(O\bOr\bri\big\bgi\bin\bna\bal\bl v\bve\ber\brs\bsi\bio\bon\bn b\bby\by I\bIa\bai\bin\bn P\bPh\bhi\bil\bll\bli\bip\bps\bs,\b, G\bG0\b0R\bRD\bDI\bI)\b)
291
292   1\b1.\b.1\b1.\b.  I\bIn\bnt\btr\bro\bod\bdu\buc\bct\bti\bio\bon\bn
293
294   This section describes the installation of DX Spider v1.35 on a RedHat
295   Linux Distribution.  I do not intend to try and cover the installation
296   of Linux or the setup of the AX25 utilities.  If you need help on this
297   then read Iains original HOWTO on the DXSpider website.
298
299
300   I am assuming a general knowledge of Linux and its commands.  You
301   should know how to use _\bt_\ba_\br and how to edit files using your favourite
302   editor.
303
304
305   The crucial ingredient for all of this is Perl 5.004.  Now I know Perl
306   5.005 is out and this will almost certainly work with it, but RedHat
307   5.1 comes with 5.004.  _\bB_\be _\bW_\ba_\br_\bn_\be_\bd, earlier versions of RedHat d\bdo\bo n\bno\bot\bt
308   come with 5.004 as standard, you need to upgrade
309
310
311   In addition to the standard Red Hat distribution you will require the
312   following CPAN modules: -
313
314
315
316   +\bo  MD5-1.7.tar.gz
317
318   +\bo  Data-Dumper-2.10.tar.gz
319
320   +\bo  FreezeThaw-0.3.tar.gz
321
322   +\bo  MLDBM-2.00.tar.gz
323
324   +\bo  TimeDate-1.08.tar.gz
325
326   +\bo  IO-1.20.tar.gz
327
328   +\bo  Net-Telnet-3.02.tar.gz
329
330
331   +\bo  Curses-1.05.tar.gz
332
333   +\bo  Time-HiRes-01.20.tar.gz
334
335
336
337   _\bD_\bo get the latest versions of these packages and install them but use
338   the above list as the earliest versions usable.
339
340
341   1\b1.\b.2\b2.\b.  P\bPr\bre\bep\bpa\bar\bra\bat\bti\bio\bon\bn
342
343   I will assume that you have already downloaded the latest tarball of
344   the DXSpider software and are ready to install it. I am assuming
345   version 1.35 for this section but of course you would use the latest
346   version.
347
348
349   Login as root and create a user to run the cluster under.  _\bU_\bN_\bD_\bE_\bR _\bN_\bO
350   _\bC_\bI_\bR_\bC_\bU_\bM_\bS_\bT_\bA_\bN_\bC_\bE_\bS _\bU_\bS_\bE _\bR_\bO_\bO_\bT _\bA_\bS _\bT_\bH_\bI_\bS _\bU_\bS_\bE_\bR_\b!.  I am going to use the name
351   _\bs_\by_\bs_\bo_\bp.  You can call it anything you wish.  Depending on your security
352   requirements you may wish to use an existing user, however this is
353   your own choice.
354
355
356
357
358        # adduser -m sysop
359
360
361
362
363
364   Now set a password for the user ...
365
366
367
368        # passwd sysop
369        # New UNIX password:
370        # Retype new UNIX password:
371        passwd: all authentication tokens updated successfully
372
373
374
375
376
377   1\b1.\b.3\b3.\b.  I\bIn\bns\bst\bta\bal\bll\bli\bin\bng\bg t\bth\bhe\be s\bso\bof\bft\btw\bwa\bar\bre\be
378
379   Now to unpack the DX Spider distribution, set symbolic links and group
380   permissions.  Copy the tarball to /home/sysop and do the following.
381
382
383
384        # cd ~sysop
385        # tar xvfz spider-1.35.tar.gz
386        # ln -s ~sysop/spider /spider
387        # groupadd -g 251 spider       (or another number)
388
389
390
391
392   If you do not have the command _\bg_\br_\bo_\bu_\bp_\ba_\bd_\bd available to you simply add a
393   line in /etc/group by hand.
394
395
396
397   # vi /etc/group                (or your favorite editor)
398
399
400
401
402   You also need to add some others to the group, including your own
403   callsign (this will be used as an alias) and root.  The finished line
404   in /etc/group should look something like this
405
406   spider:x:251:sysop,g0vgs,root
407
408
409   The next step is to set the permissions on the Spider directory tree
410   and files ....
411
412
413
414        # chown -R sysop.spider spider
415        # find . -type d -exec chmod 2775 {} \;
416        # find . -type f -exec chmod 775 {} \;
417
418
419
420
421
422   This last step allows various users of the group _\bs_\bp_\bi_\bd_\be_\br to have write
423   access to all the directories.  This is not really needed just yet but
424   will be useful when web interfaces start to appear.
425
426
427   Finally, you need to fix the permissions on the ax25_call and
428   netrom_call programs.  Check where they are with the _\bl_\bo_\bc_\ba_\bt_\be command
429   and alter the permissions with the _\bc_\bh_\bm_\bo_\bd command like this ..
430
431
432
433        # chown root ax25_call netrom_call
434        # chmod 4775 ax25_call netrom_call
435
436
437
438
439
440   1\b1.\b.4\b4.\b.  S\bSe\bet\btt\bti\bin\bng\bg c\bca\bal\bll\bls\bsi\big\bgn\bns\bs e\bet\btc\bc
441
442   Now login to your machine as the user you created earlier.  In my case
443   that user is called _\bs_\by_\bs_\bo_\bp.  Once logged in, issue the following
444   commands ....
445
446
447
448        $ cd /spider
449        $ mkdir local
450        $ mkdir local_cmd
451        $ cp perl/DXVars.pm.issue local/DXVars.pm
452        $ cd local
453        $ vi DXVars.pm (or your favourite editor)
454
455
456
457
458
459   Using the distributed DXVars.pm as a a template, set your cluster
460   callsign, sysop callsign and other user info to suit your own
461   environment. Note that this a perl file which will be parsed and
462   executed as part of the cluster. If you get it wrong then perl will
463   complain when you start the cluster process.  It is important only to
464   alter the text of any section.  Some of the lines look a little odd.
465   Take this line for example ....
466
467   $myemail = "ianmaude\@btinternet.com";
468
469
470   There appears to be an extra slash in there.  However this has to be
471   there for the file to work so leave it in.
472
473
474   P\bPL\bLE\bEA\bAS\bSE\bE U\bUS\bSE\bE C\bCA\bAP\bPI\bIT\bTA\bAL\bL L\bLE\bET\bTT\bTE\bER\bRS\bS F\bFO\bOR\bR C\bCA\bAL\bLL\bLS\bSI\bIG\bGN\bNS\bS
475
476
477   DON'T alter the DXVars.pm (or any other file) in /spider/perl, they
478   are overwritten with every release. Any files or commands you place in
479   /spider/local or /spider/local_cmd will automagically be used in
480   preference to the ones in /spider/perl EVEN while the cluster is
481   running!
482
483
484   Save the new file and change directory to ../perl ....
485
486
487
488        $ cd ../perl
489
490
491
492
493
494   Now type the following command which creates the basic user file with
495   you as the sysop.
496
497
498
499        $ create_sysop.pl
500
501
502
503
504
505   1\b1.\b.5\b5.\b.  S\bSt\bta\bar\brt\bti\bin\bng\bg u\bup\bp f\bfo\bor\br t\bth\bhe\be f\bfi\bir\brs\bst\bt t\bti\bim\bme\be
506
507   We can now bring spider up for the first time and see if all is well
508   or not!  It should look something like this ...
509
510
511
512        $ cluster.pl
513        DXSpider DX Cluster Version 1.35
514        Copyright (c) 1998 Dirk Koopman G1TLH
515        loading prefixes ...
516        loading band data ...
517        loading user file system ...
518        starting listener ...
519        reading existing message headers
520        reading cron jobs
521        orft we jolly well go ...
522
523
524
525
526
527   If all is well then login on another term or console as _\bs_\by_\bs_\bo_\bp and cd
528   to /spider/perl.  Now issue the following command ...
529        $ client.pl
530
531
532
533
534
535   This should log you into the cluster as the sysop under the alias
536   callsign we set earlier.  In this case the callsign is G0VGS.  The
537   cluster callsign is set in the DXVars.pm file in /spider/local.  In
538   this case we will assume that this was set as GB7MBC.  You should
539   therefore see this when you login ....
540
541
542
543        G0VGS de GB7MBC 19-Nov-1999 2150Z >
544
545
546
547
548   If you do, congratulations!  If not, look over the instructions again,
549   you have probably missed something out.  You can shut spider down
550   again with the command ....
551
552
553
554        shutdown
555
556
557
558
559
560   and both the cluster and the client should return to Linux prompts.
561
562
563   2\b2.\b.  T\bTh\bhe\be C\bCl\bli\bie\ben\bnt\bt p\bpr\bro\bog\bgr\bra\bam\bm
564
565   In earlier versions of Spider, all the processes were Perl scripts.
566   This was fine but with a lot of users your computer memory would soon
567   be used up.  To combat this a new client was written in "C".  This
568   client only works for _\bi_\bn_\bc_\bo_\bm_\bi_\bn_\bg connects at the moment.  Before you can
569   use it though it has to be "made".  CD to /spider/src and type _\bm_\ba_\bk_\be.
570   You should see the output on your screen and hopefully now have a
571   small C program called _\bc_\bl_\bi_\be_\bn_\bt.  Leave it in this directory.
572
573
574   3\b3.\b.  C\bCo\bon\bnf\bfi\big\bgu\bur\bra\bat\bti\bio\bon\bn
575
576   3\b3.\b.1\b1.\b.  A\bAl\bll\blo\bow\bwi\bin\bng\bg a\bax\bx2\b25\b5 c\bco\bon\bnn\bne\bec\bct\bts\bs f\bfr\bro\bom\bm u\bus\bse\ber\brs\bs
577
578   As stated previously, the aim of this document is not to tell you how
579   to configure Linux or the ax25 utilities.  However, you do need to add
580   a line in your ax25d.conf to allow connections to DXSpider for your
581   users.  For each interface that you wish to allow connections on, use
582   the following format ...
583
584
585
586        default  * * * * * *  - sysop /spider/src/client client %u ax25
587
588
589
590
591
592
593
594
595   3\b3.\b.2\b2.\b.  A\bAl\bll\blo\bow\bwi\bin\bng\bg t\bte\bel\bln\bne\bet\bt c\bco\bon\bnn\bne\bec\bct\bts\bs f\bfr\bro\bom\bm u\bus\bse\ber\brs\bs
596
597   Allowing telnet connections is quite simple.  Firstly you need to add
598   a line in /etc/services to allow connections to a port number, like
599   this ....
600
601
602
603        spdlogin   8000/tcp     # spider anonymous login port
604
605
606
607
608   Then add a line in /etc/inetd.conf like this ....
609
610
611
612        spdlogin stream tcp nowait root /usr/sbin/tcpd /spider/src/client login telnet
613
614
615
616
617
618   This needs to be added above the standard services such as ftp, telnet
619   etc.  Once this is done, you need to restart inetd like this ....
620
621
622
623        killall -HUP inetd
624
625
626
627
628
629
630   Now login as _\bs_\by_\bs_\bo_\bp and cd spider/perl. You can test that spider is
631   accepting telnet logins by issuing the following command ....
632
633
634
635        client.pl login telnet
636
637
638
639
640   You should get a login prompt and on issuing a callsign, you will be
641   given access to the cluster.  Note, you will not get a password login.
642   There seems no good reason for a password prompt to be given so it is
643   not asked for.
644
645
646   Assuming all is well, then try a telnet from your linux console ....
647
648
649
650        telnet localhost 8000
651
652
653
654
655
656   You should now get the login prompt and be able to login as before.
657
658
659
660
661   3\b3.\b.3\b3.\b.  S\bSe\bet\btt\bti\bin\bng\bg u\bup\bp n\bno\bod\bde\be c\bco\bon\bnn\bne\bec\bct\bts\bs
662
663   In order to allow cluster node connections, spider needs to know that
664   the connecting callsign is a cluster node.  This is the case whether
665   the connect is incoming or outgoing.  In spider this is a simple task
666   and can be done in runtime.
667
668
669   Later versions of Spider can distinguish different software and treat
670   them differently.  For example, the WCY beacon cannot be handles by
671   AK1A type nodes as AK1A does not know what to do with PC73.  There are
672   4 different types of node at present and although they may not have
673   any major differences at the moment, it allows for compatibility.  The
674   4 types are ...
675
676
677
678        set/node        (AK1A type)
679        set/spider
680        set/dxnet
681        set/clx
682
683
684
685
686
687   For now, we will assume that the cluster we are going to connect to is
688   an AK1A type node.
689
690
691   Start up the cluster as you did before and login as the sysop with
692   client.pl.  The cluster node I am wanting to make a connection to is
693   GB7BAA but you would obviously use whatever callsign you required.  At
694   the prompt type ...
695
696
697
698        set/node gb7baa
699
700
701
702
703
704   The case does not matter as long as you have a version of DXSpider
705   later than 1.33.  Earlier versions required the callsign to be in
706   upper case.
707
708
709   That is now set, it is as simple as that.  To prove it, login on yet
710   another console as sysop and issue the command ...
711
712
713
714        client.pl gb7baa (using the callsign you set as a node)
715
716
717
718
719
720   You should get an initialisation string from DXSpider like this ...
721
722
723
724        client.pl gb7baa
725        PC38^GB7MBC^~
726
727   If the callsign you just set up as a cluster node is for an incoming
728   connect, this is all that needs to be done.  If the connection is to
729   be outgoing then a connection script needs to be written.
730
731
732   3\b3.\b.4\b4.\b.  C\bCo\bon\bnn\bne\bec\bct\bti\bio\bon\bn s\bsc\bcr\bri\bip\bpt\bts\bs
733
734   Because DXSpider operates under Linux, connections can be made using
735   just about any protocol;  AX25, NETRom, tcp/ip, ROSE etc are all
736   possible examples.  Connect scripts live in the /spider/connect
737   directory and are simple ascii files.  Writing a script for
738   connections is therefore relatively simple.
739
740
741   The connect scripts consist of lines which start with the following
742   keywords or symbols:-
743
744
745
746   #               All lines starting with a # are ignored, as are completely
747                   blank lines.
748
749   timeout         timeout followed by a number is the number of seconds to wait for a
750                   command to complete. If there is no timeout specified in the script
751                   then the default is 60 seconds.
752
753   abort           abort is a regular expression containing one or more strings to look
754                   for to abort a connection. This is a perl regular expression and is
755                   executed ignoring case.
756
757   connect         connect followed by ax25 or telnet and some type dependent
758                   information. In the case of a telnet connection, there can be up to
759                   two parameters.
760                   The first is the ip address or hostname of the computer you wish to
761                   connect to and the second is the port number you want to use (this
762                   can be left out if it is a normal telnet session).
763                   In the case of an ax25 session then this would normally be a call to
764                   ax25_call or netrom_call as in the example above. It is your
765                   responsibility to get your node and other ax25 parameters to work
766                   before going down this route!
767
768   '               line in a chat type script. The words/phrases normally come in pairs,
769                   either can be empty. Each line reads input from the connection until
770                   it sees the string (or perl regular expression) contained in the
771                   left hand string. If the left hand string is empty then it doesn't
772                   read or wait for anything. The comparison is done ignoring case.
773                   When the left hand string has found what it is looking for (if it is)
774                   then the right hand string is sent to the connection.
775                   This process is repeated for every line of chat script.
776
777   client          client starts the connection, put the arguments you would want here
778                   if you were starting the client program manually. You only need this
779                   if the script has a different name to the callsign you are trying to
780                   connect to (i.e. you have a script called other which actually
781                   connects to GB7DJK-1 [instead of a script called gb7djk-1]).
782
783
784
785
786   There are many possible ways to configure the script but here are two
787   examples, one for a NETRom/AX25 connect and one for tcp/ip.
788
789
790
791
792
793   timeout 60
794   abort (Busy|Sorry|Fail)
795   # don't forget to chmod 4775 netrom_call!
796   connect ax25 /usr/sbin/netrom_call bbs gb7djk g1tlh
797   # you can leave this out if you call the script 'gb7dxm'
798   client gb7dxm ax25
799
800
801
802
803
804
805
806
807        timeout 15
808        connect telnet dirkl.tobit.co.uk
809        # tell GB7DJK-1 that it is connected to GB7DJK
810        # you can leave this out if you call this script 'gb7djk'
811        client gb7djk telnet
812
813
814
815
816
817   Both these examples assume that everything is set up properly at the
818   other end.  You will find other examples in the /spider/examples
819   directory.
820
821
822   3\b3.\b.5\b5.\b.  S\bSt\bta\bar\brt\bti\bin\bng\bg t\bth\bhe\be c\bco\bon\bnn\bne\bec\bct\bti\bio\bon\bn
823
824   You start the connection, from within a sysop enabled cluster login,
825   by typing in the word _\bc_\bo_\bn_\bn_\be_\bc_\bt followed by a script name like this ....
826
827
828
829        G0VGS de GB7MBC 13-Dec-1998 2041Z >connect gb7djk-1
830        connection to GB7DJK-1 started
831        G0VGS de GB7MBC 13-Dec-1998 2043Z >
832
833
834
835
836   This will start a connection using the script called _\bg_\bb_\b7_\bd_\bj_\bk_\b-_\b1.  You
837   can follow the connection by watching the term or console from where
838   you started _\bc_\bl_\bu_\bs_\bt_\be_\br_\b._\bp_\bl.  You should see something like this ...
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859   <- D G1TLH connect gb7djk-1
860   -> D G1TLH connection to GB7DJK-1 started
861   -> D G1TLH G1TLH de GB7DJK 13-Dec-1998 2046Z >
862   timeout set to 15
863   CONNECT sort: telnet command: dirkl.tobit.co.uk
864   CHAT "login" -> "gb7djk"
865   received "
866   Red Hat Linux release 5.1 (Manhattan)
867   Kernel 2.0.35 on an i586
868   "
869   received "login: "
870   sent "gb7djk"
871   CHAT "word" -> "gb7djk"
872   received "gb7djk"
873   received "Password: "
874   sent "gb7djk"
875   Connected to GB7DJK-1, starting normal protocol
876   <- O GB7DJK-1 telnet
877   -> B GB7DJK-1 0
878   GB7DJK-1 channel func  state 0 -> init
879   <- D GB7DJK-1
880   <- D GB7DJK-1 Last login: Sun Dec 13 17:59:56 from dirk1
881   <- D GB7DJK-1 PC38^GB7DJK-1^~
882   <- D GB7DJK-1 PC18^ 1 nodes, 0 local / 1 total users  Max users 0  Uptime
883   0 00:00^5447^~
884       etc
885
886
887
888
889
890   With later versions of Spider there is a set/login command for users.
891   This tells them when a user or node logs in or out.  If you do not add
892   a line to your scripts after the final line (or before the client line
893   which should always be last if needed) then the login/logout
894   information will be sent to users _\bb_\be_\bf_\bo_\br_\be the login actually completes.
895   This means if a node is unreachable, it will continue sending logins
896   and logouts to users even though it is not actually connecting.  To
897   avoid this use the following line ...
898
899
900
901
902
903
904
905
906   In a script, this might look like ...
907
908
909
910        timeout 35
911        abort (Busy|Sorry|Fail)
912        connect telnet mary 3000
913
914
915
916
917
918   3\b3.\b.6\b6.\b.  T\bTe\bel\bln\bne\bet\bt e\bec\bch\bho\bo
919
920   Cluster links in particular suffer greatly from the presence of telnet
921   echo.  This is caused by the telnet negotiation itself and can create
922   at worst severe loops.  At best it creates unnecessary bandwidth and
923   large logfiles!  There are things that can be done to limit this
924   problem but will not always work dependent on the route taken to
925   connect.
926
927
928   Telnet echo itself should only be a problem if the connection is being
929   made to the telnet port (23).  This port uses special rules that
930   include echo negotiation.  If the connection is to a different port,
931   such as 8000, this negotiation does not happen and therefore no echo
932   should be present.
933
934
935   Sometimes it is not possible to make a direct connection to another
936   node and this can cause problems.  There is a way of trying to
937   suppress the telnet echo but this will not always work, unfortunately
938   it is difficult to be more specific.  Here is an example of what I
939   mean ...
940
941
942
943        timeout 35
944        abort (Busy|Sorry|Fail)
945        connect telnet mary.lancs.ac.uk
946
947
948
949
950   So, the first connection is made by Spider.  This is fine as Spider
951   uses the Net_Telnet script from within perl.  This actually uses TCP
952   rather than TELNET so no negotiation will be done on the first
953   connection.  Once connected to mary.lancs.ac.uk, the command is sent
954   to suppress echo.  Now a telnet is made to a cluster node that is
955   accepting connections on port 23.  The problem with this link is that
956   the negotiation is made by the remote machine, therefore you have no
957   control over it.  The chances are that this link will create echo and
958   there will be no way you can stop it.
959
960
961
962   4\b4.\b.  A\bAu\but\bto\bom\bma\bat\bti\bin\bng\bg t\bth\bhi\bin\bng\bgs\bs
963
964   Ok, you should now have DXSpider running nicely and allowing connects
965   by cluster nodes or users.  However, it has to be shutdown and
966   restarted manually and if connection scripts fail they have to be
967   started again manually too, not much use if you are not at the
968   console!  So, in this section we will automate both.  Firstly starting
969   the cluster.
970
971
972   4\b4.\b.1\b1.\b.  A\bAu\but\bto\bos\bst\bta\bar\brt\bti\bin\bng\bg t\bth\bhe\be c\bcl\blu\bus\bst\bte\ber\br
973
974   This is not only a way to start the cluster automatically, it also
975   works as a watchdog, checking the sanity of DXSpider and respawning it
976   should it crash for any reason.  Before doing the following, shutdown
977   the cluster as you did earlier.
978
979
980   Login as root and bring up the /etc/inittab file in your favourite
981   editor.  Add the following lines to the file near the end ...
982
983
984
985        ##Start DXSpider on bootup and respawn it should it crash
986        DX:3:respawn:/bin/su -c "/usr/bin/perl -w /spider/perl/cluster.pl" sysop >/dev/tty7
987
988
989
990
991   This will automatically start DXSpider on tty7 (ALT-F7) on bootup and
992   restart it should it crash for any reason.
993
994
995   As root type the command _\bt_\be_\bl_\bi_\bn_\bi_\bt _\bq.  DXSpider should start up
996   immediately.  You will see the output on tty7 and if you login as
997   _\bs_\by_\bs_\bo_\bp you should find everything running nicely.
998
999
1000   So far so good, now to automate script connections...
1001
1002
1003   4\b4.\b.2\b2.\b.  T\bTh\bhe\be c\bcr\bro\bon\bnt\bta\bab\bb f\bfi\bil\ble\be
1004
1005   Login as _\bs_\by_\bs_\bo_\bp and create a file in /spider/local_cmd called crontab.
1006   Edit it with your favourite editor and add a line like this (I have
1007   included a comment)
1008
1009
1010
1011        # check every 10 minutes to see if gb7xxx is connected and if not
1012        # start a connect job going
1013
1014        0,10,20,30,40,50 * * * * start_connect('gb7xxx') if !connected('gb7xxx')
1015
1016
1017
1018
1019
1020   The callsign involved will be the callsign of the cluster node you are
1021   going to connect to.  This will now check every 10 minutes to see if
1022   gb7xxx is connected, if it is then nothing will be done.  If it is
1023   not, then a connect attempt will be started.
1024
1025
1026   There are probably lots of other things you could use this crontab
1027   file for.  If you want to know more about it, look at the DXSpider
1028   website at the cron page where it is explained more fully.
1029
1030
1031   5\b5.\b.  H\bHo\bop\bp c\bco\bon\bnt\btr\bro\bol\bl
1032
1033   Starting with version 1.13 there is simple hop control available on a
1034   per node basis. Also it is possible to isolate a network completely so
1035   that you get all the benefits of being on that network, but can't pass
1036   on information from it to any other networks you may be connected to
1037   (or vice versa).
1038
1039
1040   5\b5.\b.1\b1.\b.  B\bBa\bas\bsi\bic\bc h\bho\bop\bp c\bco\bon\bnt\btr\bro\bol\bl
1041
1042   In /spider/data you will find a file called hop_table.pl.  This is the
1043   file that controls your hop count settings.  It has a set of default
1044   hops on the various PC frames and also a set for each node you want to
1045   alter the hops for.  You may be happy with the default settings of
1046   course, but this powerful tool can help to protect and improve the
1047   network.  The file will look something like this ...
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057   #
1058   # hop table construction
1059   #
1060
1061   package DXProt;
1062
1063   # default hopcount to use
1064   $def_hopcount = 5;
1065
1066   # some variable hop counts based on message type
1067   %hopcount =
1068   (
1069    11 => 10,
1070    16 => 10,
1071    17 => 10,
1072    19 => 10,
1073    21 => 10,
1074   );
1075
1076
1077   # the per node hop control thingy
1078
1079
1080   %nodehops =
1081
1082    GB7ADX => {            11 => 8,
1083                           12 => 8,
1084                           16 => 8,
1085                           17 => 8,
1086                           19 => 8,
1087                           21 => 8,
1088                      },
1089
1090    GB7UDX => {            11 => 8,
1091                           12 => 8,
1092                           16 => 8,
1093                           17 => 8,
1094                           19 => 8,
1095                           21 => 8,
1096                      },
1097    GB7BAA => {
1098                           11 => 5,
1099                           12 => 8,
1100                           16 => 8,
1101                           17 => 8,
1102                           19 => 8,
1103                           21 => 8,
1104                      },
1105   };
1106
1107
1108
1109
1110
1111   Each set of hops is contained within a pair of curly braces and
1112   contains a series of PC frame types.  PC11 for example is a DX spot.
1113   The figures here are not exhaustive but should give you a good idea of
1114   how the file works.
1115
1116
1117   You can alter this file at any time, including whilst the cluster is
1118   running.  If you alter the file during runtime, the command _\bl_\bo_\ba_\bd_\b/_\bh_\bo_\bp_\bs
1119   will bring your changes into effect.
1120
1121
1122
1123   5\b5.\b.2\b2.\b.  I\bIs\bso\bol\bla\bat\bti\bin\bng\bg n\bne\bet\btw\bwo\bor\brk\bks\bs
1124
1125   It is possible to isolate networks from each other on a "gateway" node
1126   using the _\bs_\be_\bt_\b/_\bi_\bs_\bo_\bl_\ba_\bt_\be _\b<_\bn_\bo_\bd_\be_\b__\bc_\ba_\bl_\bl_\b> command.
1127
1128
1129   The effect of this is to partition an isolated network completely from
1130   another nodes connected to your node. Your node will appear on and
1131   otherwise behave normally on every network to which you are connected,
1132   but data from an isolated network will not cross onto any other
1133   network or vice versa. However all the spot, announce and WWV traffic
1134   and personal messages will still be handled locally (because you are a
1135   real node on all connected networks), that is locally connected users
1136   will appear on all networks and will be able to access and receive
1137   information from all networks transparently.  All routed messages will
1138   be sent as normal, so if a user on one network knows that you are a
1139   gateway for another network, he can still still send a talk/announce
1140   etc message via your node and it will be routed across.
1141
1142
1143   The only limitation currently is that non-private messages cannot be
1144   passed down isolated links regardless of whether they are generated
1145   locally. This will change when the bulletin routing facility is added.
1146
1147
1148   If you use isolate on a node connection you will continue to receive
1149   all information from the isolated partner, however you will not pass
1150   any information back to the isolated node.  There are times when you
1151   would like to forward only spots across a link (maybe during a contest
1152   for example).  To do this, isolate the node in the normal way and put
1153   in a filter in the /spider/filter/spots directory to override the
1154   isolate.  This filter can be very simple and consists of just one line
1155   ....
1156
1157
1158
1159        $in = [
1160                [ 1, 0, 'd', 0, 3]      # The last figure (3) is the hop count
1161        ];
1162
1163
1164
1165
1166
1167   There is a lot more on filtering in the next section.
1168
1169
1170   6\b6.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg (\b(O\bOl\bld\bd S\bSt\bty\byl\ble\be u\bup\bpt\bto\bo v\bv1\b1.\b.4\b44\b4)\b)
1171
1172   Filters can be set for spots, announcements and WWV.  You will find
1173   the directories for these under /spider/filter.  You will find some
1174   examples in the directories with the suffix _\b._\bi_\bs_\bs_\bu_\be.  There are two
1175   types of filter, one for incoming information and one for outgoing
1176   information.  Outgoing filters are in the form _\bC_\bA_\bL_\bL_\bS_\bI_\bG_\bN_\b._\bp_\bl and
1177   incoming filters are in the form _\bi_\bn_\b__\bC_\bA_\bL_\bL_\bS_\bI_\bG_\bN_\b._\bp_\bl.  Filters can be set
1178   for both nodes and users.
1179
1180
1181   All filters work in basically the same way.  There are several
1182   elements delimited by commas.  There can be many lines in the filter
1183   and they are read from the top by the program.  When writing a filter
1184   you need to think carefully about just what you want to achieve.  You
1185   are either going to write a filter to _\ba_\bc_\bc_\be_\bp_\bt or to _\br_\be_\bj_\be_\bc_\bt.  Think of a
1186   filter as having 2 main elements.  For a reject filter, you would have
1187   a line or multiple lines rejecting the things you do not wish to
1188   receive and then a default line accepting everything else that is not
1189   included in the filter.  Likewise, for an accept filter, you would
1190   have a line or multiple lines accepting the things you wish to receive
1191   and a default line rejecting everthing else.
1192
1193
1194   In the example below, a user requires a filter that would only return
1195   SSB spots posted in Europe on the HF bands.  This is achieved by first
1196   rejecting the CW section of each HF band and rejecting all of VHF, UHF
1197   etc based on frequency.  Secondly, a filter rule is set based on CQ
1198   zones to only accept spots posted in Europe.  Lastly, a default filter
1199   rule is set to reject anything outside the filter.
1200
1201
1202
1203        $in = [
1204                [ 0, 0, 'r', # reject all CW spots
1205                        [
1206                        1800.0, 1850.0,
1207                        3500.0, 3600.0,
1208                        7000.0, 7040.0,
1209                        14000.0, 14100.0,
1210                        18068.0, 18110.0,
1211                        21000.0, 21150.0,
1212                        24890.0, 24930.0,
1213                        28000.0, 28180.0,
1214                        30000.0, 49000000000.0,
1215                        ] ,1 ],
1216                [ 1, 11, 'n', [ 14, 15, 16, 20, 33, ], 15 ], #accept EU
1217                [ 0, 0, 'd', 0, 1 ], # 1 = want, 'd' = everything else
1218        ];
1219
1220
1221
1222
1223
1224   The actual elements of each filter are described more fully in the
1225   following sections.
1226
1227
1228   6\b6.\b.1\b1.\b.  S\bSp\bpo\bot\bts\bs
1229
1230   The elements of the Spot filter are ....
1231
1232
1233
1234        [action, field_no, sort, possible_values, hops]
1235
1236
1237
1238
1239
1240   There are 3 elements here to look at.  Firstly, the action element.
1241   This is very simple and only 2 possible states exist, accept (1) or
1242   drop (0).
1243
1244
1245   The second element is the field_no.  There are 13 possiblities to
1246   choose from here ....
1247
1248
1249
1250
1251
1252
1253
1254
1255         0 = frequency
1256         1 = call
1257         2 = date in unix format
1258         3 = comment
1259         4 = spotter
1260         5 = spotted dxcc country
1261         6 = spotter's dxcc country
1262         7 = origin
1263         8 = spotted itu
1264         9 = spotted cq
1265         10 = spotter's itu
1266         11 = spotter's cq
1267         12 = callsign of the channel on which the spot has appeared
1268
1269
1270
1271
1272
1273   The third element tells us what to expect in the fourth element.
1274   There are 4 possibilities ....
1275
1276
1277
1278             n - numeric list of numbers e.g. [ 1,2,3 ]
1279             r - ranges of pairs of numbers e.g. between 2 and 4 or 10 to 17 - [ 2,4, 10,17 ]
1280             a - an alphanumeric regex
1281             d - the default rule
1282
1283
1284
1285
1286
1287   The fifth element is simply the hops to set in this filter.  This
1288   would only be used if the filter was for a node of course and
1289   overrides the hop count in hop_table.pl.
1290
1291
1292   So, let's look at an example spot filter.  It does not matter in the
1293   example who the filter is to be used for.  So, what do we need in the
1294   filter?  We need to filter the spots the user/node requires and also
1295   set a default rule for anything else outside the filter.  Below is a
1296   simple filter that stops spots arriving from outside Europe.
1297
1298
1299
1300        $in = [
1301          [ 0, 4, 'a', '^(K|N|A|W|VE|VA|J)'],  # 0 = drop, 'a' = alphanumeric
1302          [ 1, 0, 'd', 0, 1 ],                 # 1 = want, 'd' = everything else
1303                             ];
1304
1305
1306
1307
1308
1309   So the filter is wrapped in between a pair of square brackets.  This
1310   tells Spider to look in between these limits.  Then each line is
1311   contained within its own square brackets and ends with a comma. Lets
1312   look carefully at the first line.  The first element is 0 (drop).
1313   Therefore anything we put on this line will not be accepted.  The next
1314   element is 4.  This means we are filtering by the spotter.  The third
1315   element is the letter "a" which tells the program to expect an
1316   alphanumeric expression in the fourth element.  The fourth element is
1317   a list of letters separated by the pipe symbol.
1318
1319
1320
1321   What this line does is tell the program to drop any spots posted by
1322   anyone in the USA, Canada or Japan.
1323
1324
1325   The second line is the default rule for anything else.  The "d" tells
1326   us this and the line simply reads... accept anything else.
1327
1328
1329   You can add as many lines as you need to complete the filter but if
1330   there are several lines of the same type it is neater to enclose them
1331   all as one line.  An example of this is where specific bands are set.
1332   We could write this like this ....
1333
1334
1335
1336        [ 0,0,'r',[1800.0, 2000.0], 1],
1337        [ 0,0,'r',[10100.0, 10150.0], 1],
1338        [ 0,0,'r',[14000.0, 14350.0], 1],
1339        [ 0,0,'r',[18000.0, 18200.0], 1],
1340
1341
1342
1343
1344
1345   But the line below achieves the same thing and is more efficient ....
1346
1347
1348
1349          [ 0, 0, 'r',
1350            [
1351              1800.0, 2000.0,         # top band
1352              10100.0, 10150.0,       # WARC
1353              14000.0, 14350.0,       # 20m
1354              18000.0, 18200.0,       # WARC
1355            [ ,1 ],
1356
1357
1358
1359
1360
1361
1362   6\b6.\b.2\b2.\b.  A\bAn\bnn\bno\bou\bun\bnc\bce\bem\bme\ben\bnt\bts\bs
1363
1364
1365
1366
1367        # This is an example announce or filter allowing only West EU announces
1368        #
1369        # The element list is:-
1370        # 0 - callsign of announcer
1371        # 1 - destination * = all, <callsign> = routed to the node
1372        # 2 - text
1373        # 3 - * - sysop, <some text> - special list eg 6MUK, ' ', normal announce
1374        # 4 - origin
1375        # 5 - 0 - announce, 1 - wx
1376        # 6 - channel callsign (the interface from which this spot came)
1377
1378        $in = [
1379                [ 1, 0, 'a', '^(P[ABCDE]|DK0WCY|G|M|2|EI|F|ON)' ],
1380                [ 0, 0, 'd', 0 ]
1381        ];
1382
1383
1384
1385
1386
1387   In this example, only the prefixes listed will be allowed.  It is
1388   possible to be quite specific.  The Dutch prefix "P" is followed by
1389   several secondary identifiers which are allowed.  So, in the example,
1390   "PA" or "PE" would be ok but not "PG".  It is even possible to allow
1391   information from a single callsign.  In the example this is DK0WCY, to
1392   allow the posting of his Aurora Beacon.
1393
1394
1395   6\b6.\b.3\b3.\b.  W\bWW\bWV\bV
1396
1397
1398
1399
1400        # This is an example WWV filter
1401        #
1402        # The element list is:-
1403        # 0 - nominal unix date of spot (ie the day + hour:13)
1404        # 1 - the hour
1405        # 2 - SFI
1406        # 3 - K
1407        # 4 - I
1408        # 5 - text
1409        # 6 - spotter
1410        # 7 - origin
1411        # 8 - incoming interface callsign
1412
1413        # this one doesn't filter, it just sets the hop count to 6 and is
1414        # used mainly just to override any isolation from WWV coming from
1415        # the internet.
1416
1417        $in = [
1418                [ 1, 0, 'd', 0, 6 ]
1419        ];
1420
1421
1422
1423
1424
1425   It should be noted that the filter will start to be used only once a
1426   user/node has logged out and back in again.
1427
1428   I am not going to spend any more time on these filters now as they
1429   will become more "comprehensive" in the near future.
1430
1431
1432   7\b7.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg (\b(N\bNe\bew\bw S\bSt\bty\byl\ble\be v\bv1\b1.\b.4\b45\b5 a\ban\bnd\bd l\bla\bat\bte\ber\br)\b)
1433
1434   7\b7.\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
1435
1436   Upto v1.44 it was not possible for the user to set their own filters.
1437   From v1.45 though that has all changed.  It is now possible to set
1438   filters for just about anything you wish.  If you have just updated
1439   from an older version of DXSpider you will need to update your new
1440   filters.  You do not need to do anything with your old filters, they
1441   will be renamed as you update.
1442
1443
1444   There are 3 basic commands involved in setting and manipulating
1445   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
1446   generally at filtering. There are a number of things you can filter in
1447   the DXSpider system. They all use the same general mechanism.
1448
1449
1450   In general terms you can create a 'reject' or an 'accept' filter which
1451   can have up to 10 lines in it. You do this using, for example ...
1452
1453        accept/spots .....
1454        reject/spots .....
1455
1456
1457
1458
1459   where ..... are the specific commands for that type of filter. There
1460   are filters for spots, wwv, announce, wcy and (for sysops) connects.
1461   See each different accept or reject command reference for more
1462   details.
1463
1464   There is also a command to clear out one or more lines in a filter.
1465   They are ...
1466
1467
1468
1469        clear/spots 1
1470        clear/spots all
1471
1472
1473
1474
1475   There is clear/xxxx command for each type of filter.
1476
1477
1478   and you can check that your filters have worked by the command ...
1479
1480
1481
1482
1483        show/filter
1484
1485
1486
1487
1488
1489   For now we are going to use spots for the examples, but you can apply
1490   the same principles to all types of filter.
1491
1492
1493   7\b7.\b.2\b2.\b.  T\bTy\byp\bpe\bes\bs o\bof\bf f\bfi\bil\blt\bte\ber\br
1494
1495   There are two main types of filter, _\ba_\bc_\bc_\be_\bp_\bt or _\br_\be_\bj_\be_\bc_\bt.  You can use
1496   either to achieve the result you want dependent on your own preference
1497   and which is more simple to do.  It is pointless writing 8 lines of
1498   reject filters when 1 accept filter would do the same thing!  Each
1499   filter has 10 lines (of any length) which are tried in order.  If a
1500   line matches then the action you have specified is taken (ie reject
1501   means ignore it and accept means take it)
1502
1503
1504   If you specify reject filters, then any lines that arrive that match
1505   the filter will be dumped but all else will be accepted.  If you use
1506   an accept filter, then ONLY the lines in the filter will be accepted
1507   and all else will be dumped.  For example if you have a single line
1508   _\ba_\bc_\bc_\be_\bp_\bt filter ...
1509
1510
1511
1512        accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
1513
1514
1515
1516
1517   then you will _\bO_\bN_\bL_\bY get VHF spots _\bf_\br_\bo_\bm or _\bt_\bo CQ zones 14, 15 and 16.
1518
1519   If you set a reject filter like this ...
1520
1521
1522
1523        reject/spots on hf/cw
1524
1525
1526
1527
1528   Then you will get everything _\bE_\bX_\bC_\bE_\bP_\bT HF CW spots.  You could make this
1529   single filter even more flexible.  For example, if you are interested
1530   in IOTA and will work it even on CW even though normally you are not
1531   interested in CW, then you could say ...
1532
1533
1534
1535        reject/spots on hf/cw and not info iota
1536
1537
1538
1539
1540   But in that case you might only be interested in iota and say:-
1541
1542
1543
1544        accept/spots not on hf/cw or info iota
1545
1546
1547
1548
1549   which achieves exactly the same thing. You should choose one or the
1550   other until you are comfortable with the way it works. You can mix
1551   them if you wish (actually you can have an accept AND a reject on the
1552   same line) but don't attempt this until you are sure you know what you
1553   are doing!
1554
1555
1556   You can arrange your filter lines into logical units, either for your
1557   own understanding or simply convenience. Here is an example ...
1558
1559
1560
1561        reject/spots 1 on hf/cw
1562        reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)
1563
1564
1565
1566
1567   What this does is to ignore all HF CW spots and also rejects any spots
1568   on VHF which don't either originate or spot someone in Europe.
1569
1570
1571   This is an example where you would use a line number (1 and 2 in this
1572   case), if you leave the digit out, the system assumes '1'. Digits
1573   '0'-'9' are available.  This make it easier to see just what filters
1574   you have set.  It also makes it more simple to remove individual
1575   filters, during a contest for example.
1576
1577
1578   You will notice in the above example that the second line has
1579   brackets.  Look at the line logically.  You can see there are 2
1580   separate sections to it.  We are saying reject spots that are VHF or
1581   above _\bA_\bP_\bA_\bR_\bT from those in zones 14, 15 and 16 (either spotted there or
1582   originated there).  If you did not have the brackets to separate the 2
1583   sections, then Spider would read it logically from the front and see a
1584   different expression entirely ...
1585        (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16
1586
1587
1588
1589
1590   The simple way to remember this is, if you use OR - use brackets.
1591   Whilst we are here CASE is not important. 'And BY_Zone' is just the
1592   same as 'and by_zone'.
1593
1594   As mentioned earlier, setting several filters can be more flexible
1595   than simply setting one complex one.  Doing it in this way means that
1596   if you want to alter your filter you can just redefine or remove one
1597   or more lines of it or one line. For example ...
1598
1599
1600
1601        reject/spots 1 on hf/ssb
1602
1603
1604
1605
1606   would redefine our earlier example, or
1607
1608
1609
1610        clear/spots 1
1611
1612
1613
1614
1615   To remove all the filter lines in the spot filter ...
1616
1617
1618
1619        clear/spots all
1620
1621
1622
1623
1624
1625   7\b7.\b.3\b3.\b.  F\bFi\bil\blt\bte\ber\br o\bop\bpt\bti\bio\bon\bns\bs
1626
1627   You can filter in several different ways.  The options are listed in
1628   the various helpfiles for accept, reject and filter.
1629
1630
1631   7\b7.\b.4\b4.\b.  D\bDe\bef\bfa\bau\bul\blt\bt f\bfi\bil\blt\bte\ber\brs\bs
1632
1633   Sometimes all that is needed is a general rule for node connects.
1634   This can be done with a node_default filter.  This rule will always be
1635   followed, even if the link is isolated, unless another filter is set
1636   specifically.  Default rules can be set for nodes and users.  They can
1637   be set for spots, announces, WWV and WCY.  They can also be used for
1638   hops.  An example might look like this ...
1639
1640
1641
1642        accept/spot node_default by_zone 14,15,16,20,33
1643        set/hops node_default spot 50
1644
1645
1646
1647
1648   This filter is for spots only, you could set others for announce, WWV
1649   and WCY.  This filter would work for ALL nodes unless a specific
1650   filter is written to override it for a particular node.  You can also
1651   set a user_default should you require.  It is important to note that
1652   default filters should be considered to be "connected".  By this I
1653   mean that should you override the default filter for spots, you need
1654   to add a rule for the hops for spots also.
1655
1656
1657   7\b7.\b.5\b5.\b.  A\bAd\bdv\bva\ban\bnc\bce\bed\bd f\bfi\bil\blt\bte\ber\bri\bin\bng\bg
1658
1659   Once you are happy with the results you get, you may like to
1660   experiment.
1661
1662
1663   The previous example that filters hf/cw spots and accepts vhf/uhf
1664   spots from EU can be written with a mixed filter, for example ...
1665
1666
1667
1668        rej/spot on hf/cw
1669        acc/spot on 0/30000
1670        acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
1671
1672
1673
1674
1675   Note that the first filter has not been specified with a number.  This
1676   will automatically be assumed to be number 1.  In this case, we have
1677   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
1678   _\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
1679   _\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
1680   'reject' slot and an 'accept' slot. The reject slot is executed BEFORE
1681   the accept slot.
1682
1683
1684   It was mentioned earlier that after a reject test that doesn't match,
1685   the default for following tests is 'accept', the reverse is true for
1686   'accept'. In the example what happens is that the reject is executed
1687   first, any non hf/cw spot is passed to the accept line, which lets
1688   through everything else on HF.  The next filter line lets through just
1689   VHF/UHF spots from EU.
1690
1691
1692
1693   8\b8.\b.  O\bOt\bth\bhe\ber\br f\bfi\bil\blt\bte\ber\brs\bs
1694
1695   8\b8.\b.1\b1.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg M\bMa\bai\bil\bl
1696
1697   In the /spider/msg directory you will find a file called
1698   badmsg.pl.issue.  Rename this to badmsg.pl and edit the file.  The
1699   original looks something like this ....
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717   # the list of regexes for messages that we won't store having
1718   # received them (bear in mind that we must receive them fully before
1719   # we can bin them)
1720
1721
1722   # The format of each line is as follows
1723
1724   #     type      source             pattern
1725   #     P/B/F     T/F/O/S            regex
1726
1727   # type: P - private, B - bulletin (msg), F - file (ak1a bull)
1728   # source: T - to field, F - from field,  O - origin, S - subject
1729   # pattern: a perl regex on the field requested
1730
1731   # Currently only type B and P msgs are affected by this code.
1732   #
1733   # The list is read from the top down, the first pattern that matches
1734   # causes the action to be taken.
1735
1736   # The pattern can be undef or 0 in which case it will always be selected
1737   # for the action specified
1738
1739
1740
1741   package DXMsg;
1742
1743   @badmsg = (
1744   );
1745
1746
1747
1748
1749
1750   I think this is fairly self explanatory.  It is simply a list of
1751   subject headers that we do not want to pass on to either the users of
1752   the cluster or the other cluster nodes that we are linked to.  This is
1753   usually because of rules and regulations pertaining to items for sale
1754   etc in a particular country.
1755
1756
1757   8\b8.\b.2\b2.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg D\bDX\bX c\bca\bal\bll\blo\bou\but\bts\bs (\b(D\bDe\bep\bpr\bri\bic\bca\bat\bte\bed\bd)\b)
1758
1759   _\bF_\br_\bo_\bm _\bv_\be_\br_\bs_\bi_\bo_\bn _\b1_\b._\b4_\b7_\b, _\bt_\bh_\bi_\bs _\bm_\be_\bt_\bh_\bo_\bd _\bi_\bs _\br_\be_\bp_\bl_\ba_\bc_\be_\bd _\bb_\by _\bt_\bh_\be _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bs_\be_\bt_\b/_\bb_\ba_\bd_\bd_\bx
1760
1761
1762   In the same way as mail, there are some types of spot we do not wish
1763   to pass on to users or linked cluster nodes.  In the /spider/data
1764   directory you will find a file called baddx.pl.issue.  Rename this to
1765   baddx.pl and edit the file.  The original looks like this ....
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783   # the list of dx spot addresses that we don't store and don't pass on
1784
1785
1786   package DXProt;
1787
1788   @baddx = qw
1789
1790    FROG
1791    SALE
1792    FORSALE
1793    WANTED
1794    P1RATE
1795    PIRATE
1796    TEST
1797    DXTEST
1798    NIL
1799    NOCALL
1800   );
1801
1802
1803
1804
1805
1806   Again, this is simply a list of names we do not want to see in the
1807   spotted field of a DX callout.
1808
1809
1810
1811   8\b8.\b.3\b3.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg w\bwo\bor\brd\bds\bs f\bfr\bro\bom\bm t\bte\bex\bxt\bt f\bfi\bie\bel\bld\bds\bs i\bin\bn A\bAn\bnn\bno\bou\bun\bnc\bce\be,\b, T\bTa\bal\blk\bk a\ban\bnd\bd D\bDX\bX s\bsp\bpo\bot\bts\bs
1812
1813   Create a file in /spider/data called _\bb_\ba_\bd_\bw_\bo_\br_\bd_\bs.  The format is quite
1814   simple.  Lines beginning with # are ignored so comments can be added.
1815   An example file is below ...
1816
1817
1818
1819        # Below is a list of words we do not wish to see on the cluster
1820        grunge grunged grunging
1821        splodge splodger splodging
1822        grince
1823        fluffle
1824
1825
1826
1827
1828   Multiple words can be used on the same line as shown.  Obviously these
1829   are just examples :-)
1830
1831
1832   You can reload the file from the cluster prompt as sysop with
1833   load/badwords.
1834
1835
1836   9\b9.\b.  M\bMa\bai\bil\bl
1837
1838   DXSpider deals seamlessly with standard AK1A type mail.  It supports
1839   both personal and bulletin mail and the sysop has additional commands
1840   to ensure that mail gets to where it is meant.  DXSpider will send
1841   mail almost immediately, assuming that the target is on line.
1842   However, only one mail message is dealt with at any one time.  If a
1843   mail message is already being sent or recieved, then the new message
1844   will be queued until it has finished.
1845
1846   The cluster mail is automatically deleted after 30 days unless the
1847   sysop sets the "keep" flag using the _\bm_\bs_\bg command.
1848
1849   9\b9.\b.1\b1.\b.  P\bPe\ber\brs\bso\bon\bna\bal\bl m\bma\bai\bil\bl
1850
1851   Personal mail is sent using the _\bs_\bp command.  This is actually the
1852   default method of sending mail and so a simple _\bs for send will do.  A
1853   full list of the send commands and options is in the _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bs_\be_\bt
1854   section, so I will not duplicate them here.
1855
1856
1857   9\b9.\b.2\b2.\b.  B\bBu\bul\bll\ble\bet\bti\bin\bn m\bma\bai\bil\bl
1858
1859   Bulletin mail is sent by using the _\bs_\bb command.  This is one of the
1860   most common mistakes users make when sending mail.  They send a
1861   bulletin mail with _\bs or _\bs_\bp instead of _\bs_\bb and of course the message
1862   never leaves the cluster.  This can be rectified by the sysop by using
1863   the _\bm_\bs_\bg command.
1864
1865
1866   Bulletin addresses can be set using the Forward.pl file.
1867
1868
1869   9\b9.\b.3\b3.\b.  F\bFo\bor\brw\bwa\bar\brd\bd.\b.p\bpl\bl
1870
1871   DXSpider receives all and any mail sent to it without any alterations
1872   needed in files.  Because personal and bulletin mail are treated
1873   differently, there is no need for a list of accepted bulletin
1874   addresses.  It is necessary, however, to tell the program which links
1875   accept which bulletins.  For example, it is pointless sending
1876   bulletins addresses to "UK" to any links other than UK ones.  The file
1877   that does this is called forward.pl and lives in /spider/msg.  At
1878   default, like other spider files it is named forward.pl.issue.  Rename
1879   it to forward.pl and edit the file to match your requirements.  The
1880   format is below ...
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915   #
1916   # this is an example message forwarding file for the system
1917   #
1918   # The format of each line is as follows
1919   #
1920   #     type    to/from/at pattern action  destinations
1921   #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
1922   #
1923   # type: P - private, B - bulletin (msg), F - file (ak1a bull)
1924   # to/from/at: T - to field, F - from field, A - home bbs, O - origin
1925   # pattern: a perl regex on the field requested
1926   # action: I - ignore, F - forward
1927   # destinations: a reference to an array containing node callsigns
1928   #
1929   # if it is non-private and isn't in here then it won't get forwarded
1930   #
1931   # Currently only type B msgs are affected by this code.
1932   #
1933   # The list is read from the top down, the first pattern that matches
1934   # causes the action to be taken.
1935   #
1936   # The pattern can be undef or 0 in which case it will always be selected
1937   # for the action specified
1938   #
1939   # If the BBS list is undef or 0 and the action is 'F' (and it matches the
1940   # pattern) then it will always be forwarded to every node that doesn't have
1941   # it (I strongly recommend you don't use this unless you REALLY mean it, if
1942   # you allow a new link with this on EVERY bull will be forwarded immediately
1943   # on first connection)
1944   #
1945
1946   package DXMsg;
1947
1948   @forward = (
1949   );
1950
1951
1952
1953
1954   Simply insert a bulletin address and state in the brackets where you
1955   wish that mail to go.  For example, you can see here that mail sent to
1956   "UK" will only be sent to the UK links and not to PA4AB-14.
1957
1958
1959   To force the cluster to reread the file use load/forward
1960
1961
1962
1963   9\b9.\b.4\b4.\b.  T\bTh\bhe\be m\bms\bsg\bg c\bco\bom\bmm\bma\ban\bnd\bd
1964
1965   The _\bm_\bs_\bg command is a very powerful and flexible tool for the sysop.
1966   It allows the sysop to alter to and from fields and make other changes
1967   to manage the cluster mail.
1968
1969   Here is a full list of the various options ...
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981     MSG TO <msgno> <call>     - change TO callsign to <call>
1982     MSG FRom <msgno> <call>   - change FROM callsign to <call>
1983     MSG PRrivate <msgno>      - set private flag
1984     MSG NOPRrivate <msgno>    - unset private flag
1985     MSG RR <msgno>            - set RR flag
1986     MSG NORR <msgno>          - unset RR flag
1987     MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
1988     MSG NOKEep <msgno>        - unset the keep flag
1989     MSG SUbject <msgno> <new> - change the subject to <new>
1990     MSG WAittime <msgno>      - remove any waiting time for this message
1991     MSG NOREad <msgno>        - mark message as unread
1992     MSG REad <msgno>          - mark message as read
1993     MSG QUeue                 - queue any outstanding bulletins
1994     MSG QUeue 1               - queue any outstanding private messages
1995
1996
1997
1998
1999   These commands are simply typed from within the cluster as the sysop
2000   user.
2001
2002
2003   9\b9.\b.5\b5.\b.  M\bMe\bes\bss\bsa\bag\bge\be s\bst\bta\bat\btu\bus\bs
2004
2005   You can check on a message from within the cluster by using the
2006   command _\bs_\bt_\ba_\bt_\b/_\bm_\bs_\bg.  This will give you additional information on the
2007   message number including which nodes have received it, which node it
2008   was received from and when etc.  Here is an example of the output of
2009   the command ...
2010
2011
2012
2013        G0VGS de GB7MBC 28-Jan-2001 1308Z >
2014        stat/msg 6869
2015                From: GB7DJK
2016            Msg Time: 26-Jan-2001 1302Z
2017               Msgno: 6869
2018              Origin: GB7DJK
2019                Size: 8012
2020             Subject: AMSAT 2line KEPS 01025.AMSAT
2021                  To: UK
2022        Got it Nodes: GB7BAA, GB7ADX
2023             Private: 0
2024        Read Confirm: 0
2025          Times read: 0
2026        G0VGS de GB7MBC 28-Jan-2001 1308Z >
2027
2028
2029
2030
2031
2032   9\b9.\b.6\b6.\b.  F\bFi\bil\blt\bte\ber\bri\bin\bng\bg m\bma\bai\bil\bl
2033
2034   This is described in the section on _\bO_\bt_\bh_\be_\br _\bf_\bi_\bl_\bt_\be_\br_\bs so I will not
2035   duplicate it here.
2036
2037
2038   9\b9.\b.7\b7.\b.  D\bDi\bis\bst\btr\bri\bib\bbu\but\bti\bio\bon\bn l\bli\bis\bst\bts\bs
2039
2040   Distribution lists are simply a list of users to send certain types of
2041   mail to.  An example of this is mail you only wish to send to other
2042   sysops.  In /spider/msg there is a directory called _\bd_\bi_\bs_\bt_\br_\bo.  You put
2043   any distibution lists in here.  For example, here is a file called
2044   SYSOP.pl that caters for the UK sysops.
2045
2046
2047        qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
2048           GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH
2049           GB7DXK GB7DXI GB7DXS)
2050
2051
2052
2053
2054   Any mail sent to "sysop" would only be sent to the callsigns in this
2055   list.
2056
2057
2058   9\b9.\b.8\b8.\b.  B\bBB\bBS\bS i\bin\bnt\bte\ber\brf\bfa\bac\bce\be
2059
2060   Spider provides a simple BBS interface.  No input is required from the
2061   sysop of the cluster at all.  The BBS simply sets the cluster as a BBS
2062   and pushes any required mail to the cluster.  No mail can flow from
2063   Spider to the BBS, the interface is one-way.
2064
2065
2066   Please be careful not to flood the cluster network with unnecessary
2067   mail.  Make sure you only send mail to the clusters that want it by
2068   using the Forward.pl file very carefully.
2069
2070
2071   1\b10\b0.\b.  D\bDa\bat\bta\bab\bba\bas\bse\bes\bs
2072
2073   Spider allows the creation of local or remote databases.  It supports
2074   chained databases, allowing several different databases to be scanned
2075   with one simple command.  Importing of databases is limited at present
2076   to the standard AK1A databases such as OBLAST and the DB0SDX QSL
2077   database but will expand with time.
2078
2079
2080   1\b10\b0.\b.1\b1.\b.  C\bCr\bre\bea\bat\bti\bin\bng\bg d\bda\bat\bta\bab\bba\bas\bse\bes\bs
2081
2082   Creating a database could not be more simple.  All the commands are
2083   sent from the cluster prompt as the _\bs_\by_\bs_\bo_\bp user.
2084
2085   To create a database you use the command _\bd_\bb_\bc_\br_\be_\ba_\bt_\be.  It can be used in
2086   3 different ways like so ..
2087
2088
2089
2090        dbcreate <name>
2091
2092
2093
2094
2095   To simply create a database locally, you just tell the command the
2096   name of the database.  This does not create the actual database, it
2097   simply defines it to say that it exists.
2098
2099
2100
2101        dbcreate <name> chain <name> [<name>...]
2102
2103
2104
2105
2106   This creates a chained database entry.  The first database will be
2107   scanned, then the second, the third etc...
2108
2109
2110
2111        dbcreate <name> remote <name>
2112
2113   This creates a remote entry.  the first name field is the database
2114   name at the remote node, then the remote switch, then the actual
2115   node_call of the remote node, for example...
2116
2117
2118
2119        dbcreate buckmaster remote gb7dxc
2120
2121
2122
2123
2124   Remote databases cannot be chained, however, the last database in a
2125   chain can be a remote database.
2126
2127
2128   1\b10\b0.\b.2\b2.\b.  I\bIm\bmp\bpo\bor\brt\bti\bin\bng\bg d\bda\bat\bta\bab\bba\bas\bse\bes\bs
2129
2130   The only databases that Spider can currently import are the standard
2131   AK1A databases such as OBLAST or the DB0SDX qsl and address database.
2132   This will be added to with time.
2133
2134   To import such a database, first put the file somewhere useful like
2135   /tmp and then issue the following command ...
2136
2137
2138
2139        dbimport oblast /tmp/OBLAST.FUL
2140
2141
2142
2143
2144   This will update the existing local oblast database or create it if it
2145   does not exist.
2146
2147
2148   1\b10\b0.\b.3\b3.\b.  C\bCh\bhe\bec\bck\bki\bin\bng\bg a\bav\bva\bai\bil\bla\bab\bbl\ble\be d\bda\bat\bta\bab\bba\bas\bse\bes\bs
2149
2150   Once a database is created, you will want to check that it has been
2151   added.  To do this use the _\bd_\bb_\ba_\bv_\ba_\bi_\bl command.  This will output the
2152   available databases.  For example ...
2153
2154
2155
2156        dbavail
2157        DB Name          Location   Chain
2158        qsl              Local
2159        buck             GB7ADX
2160        hftest           GB7DXM
2161        G0VGS de GB7MBC  3-Feb-2001 1925Z >
2162
2163
2164
2165
2166
2167   1\b10\b0.\b.4\b4.\b.  L\bLo\boo\bok\bki\bin\bng\bg u\bup\bp d\bda\bat\bta\bab\bba\bas\bse\bes\bs
2168
2169   To look for information in a defined database, simply use the _\bd_\bb_\bs_\bh_\bo_\bw
2170   command, for example ...
2171
2172
2173
2174        dbshow buckmaster G0YLM
2175
2176
2177
2178
2179   will show the information for the callsign G0YLM from the buckmaster
2180   database if it exists.  To make things more standard for the users you
2181   can add an entry in the Aliases file so that it looks like a standard
2182   _\bs_\bh_\bo_\bw command like this ...
2183
2184
2185
2186
2187
2188
2189
2190   Now you can simply use show/buckmaster or an abreviation.
2191
2192
2193   1\b10\b0.\b.5\b5.\b.  R\bRe\bem\bmo\bov\bvi\bin\bng\bg d\bda\bat\bta\bab\bba\bas\bse\bes\bs
2194
2195   To delete an existing database you use the _\bd_\bb_\br_\be_\bm_\bo_\bv_\be command.  For
2196   example ...
2197
2198
2199
2200        dbremove oblast
2201
2202
2203
2204
2205   would remove the oblast database and its associated datafile from the
2206   system.  There are no warnings or recovery possible from this command.
2207   If you remove a database it ceases to exist and would have to be
2208   created from scratch if you still required it.
2209
2210
2211   1\b11\b1.\b.  I\bIn\bnf\bfo\bor\brm\bma\bat\bti\bio\bon\bn,\b, f\bfi\bil\ble\bes\bs a\ban\bnd\bd u\bus\bse\bef\bfu\bul\bl p\bpr\bro\bog\bgr\bra\bam\bms\bs
2212
2213   1\b11\b1.\b.1\b1.\b.  M\bMO\bOT\bTD\bD
2214
2215   One of the more important things a cluster sysop needs to do is to get
2216   information to his users.  The simplest way to do this is to have a
2217   banner that is sent to the user on login.  This is know as a "message
2218   of the day" or "motd".  To set this up, simply create a file in
2219   /spider/data called motd and edit it to say whatever you want.  It is
2220   purely a text file and will be sent automatically to anyone logging in
2221   to the cluster.
2222
2223
2224   1\b11\b1.\b.2\b2.\b.  D\bDo\bow\bwn\bnt\bti\bim\bme\be m\bme\bes\bss\bsa\bag\bge\be
2225
2226   If for any reason the cluster is down, maybe for upgrade or
2227   maintenance but the machine is still running, a message can be sent to
2228   the user advising them of the fact.  This message lives in the
2229   /spider/data directory and is called "offline".  Simply create the
2230   file and edit it to say whatever you wish.  This file will be sent to
2231   a user attempting to log into the cluster when DXSpider is not
2232   actually running.
2233
2234
2235   1\b11\b1.\b.3\b3.\b.  O\bOt\bth\bhe\ber\br t\bte\bex\bxt\bt m\bme\bes\bss\bsa\bag\bge\bes\bs
2236
2237   You can set other text messages to be read by the user if they input
2238   the file name.  This could be for news items or maybe information for
2239   new users.  To set this up, make a directory under /spider called
2240   _\bp_\ba_\bc_\bk_\bc_\bl_\bu_\bs.  Under this directory you can create files called _\bn_\be_\bw_\bs or
2241   _\bn_\be_\bw_\bu_\bs_\be_\br for example.  In fact you can create files with any names you
2242   like.  These can be listed by the user with the command ....
2243
2244
2245        show/files
2246
2247
2248
2249
2250   They can be read by the user by typing the command ....
2251
2252
2253
2254        type news
2255
2256
2257
2258
2259   If the file they want to read is called _\bn_\be_\bw_\bs.  You could also set an
2260   alias for this in the Alias file to allow them just to type _\bn_\be_\bw_\bs
2261
2262
2263   You can also store other information in this directory, either
2264   directly or nested under directories.  One use for this would be to
2265   store DX bulletins such as the OPDX bulletins.  These can be listed
2266   and read by the user.  To keep things tidy, make a directory under
2267   /spider/packclus called _\bb_\bu_\bl_\bl_\be_\bt_\bi_\bn_\bs.  Now copy any OPDX or similar
2268   bulletins into it.  These can be listed by the user in the same way as
2269   above using the _\bs_\bh_\bo_\bw_\b/_\bf_\bi_\bl_\be_\bs command with an extension for the bulletins
2270   directory you have just created, like this ....
2271
2272
2273
2274        show/files bulletins
2275
2276
2277
2278
2279
2280   An example would look like this ....
2281
2282
2283
2284        sh/files
2285        bulletins      DIR 20-Dec-1999 1715Z news          1602 14-Dec-1999 1330Z
2286
2287
2288
2289
2290   You can see that in the files area (basically the packclus directory)
2291   there is a file called _\bn_\be_\bw_\bs and a directory called _\bb_\bu_\bl_\bl_\be_\bt_\bi_\bn_\bs.  You can
2292   also see that dates they were created.  In the case of the file _\bn_\be_\bw_\bs,
2293   you can also see the time it was last modified, a good clue as to
2294   whether the file has been updated since you last read it.  To read the
2295   file called _\bn_\be_\bw_\bs you would simply issue the command ....
2296
2297
2298
2299        type news
2300
2301
2302
2303
2304   To look what is in the bulletins directory you issue the command ....
2305
2306
2307
2308
2309
2310
2311   show/files bulletins
2312   opdx390      21381 29-Nov-1999 1621Z opdx390.1     1670 29-Nov-1999 1621Z
2313   opdx390.2     2193 29-Nov-1999 1621Z opdx391      25045 29-Nov-1999 1621Z
2314   opdx392      35969 29-Nov-1999 1621Z opdx393      15023 29-Nov-1999 1621Z
2315   opdx394      33429 29-Nov-1999 1621Z opdx394.1     3116 29-Nov-1999 1621Z
2316   opdx395      24319 29-Nov-1999 1621Z opdx396      32647 29-Nov-1999 1621Z
2317   opdx396.1     5537 29-Nov-1999 1621Z opdx396.2     6242 29-Nov-1999 1621Z
2318   opdx397      18433 29-Nov-1999 1621Z opdx398      19961 29-Nov-1999 1621Z
2319   opdx399      17719 29-Nov-1999 1621Z opdx400      19600 29-Nov-1999 1621Z
2320   opdx401      27738 29-Nov-1999 1621Z opdx402      18698 29-Nov-1999 1621Z
2321   opdx403      24994 29-Nov-1999 1621Z opdx404      15685 29-Nov-1999 1621Z
2322   opdx405      13984 29-Nov-1999 1621Z opdx405.1     4166 29-Nov-1999 1621Z
2323   opdx406      28934 29-Nov-1999 1621Z opdx407      24153 29-Nov-1999 1621Z
2324   opdx408      15081 29-Nov-1999 1621Z opdx409      23234 29-Nov-1999 1621Z
2325   Press Enter to continue, A to abort (16 lines) >
2326
2327
2328
2329
2330   You can now read any file in this directory using the type command,
2331   like this ....
2332
2333
2334
2335        type bulletins/opdx391
2336        Ohio/Penn DX Bulletin No. 391
2337        The Ohio/Penn Dx PacketCluster
2338        DX Bulletin No. 391
2339        BID: $OPDX.391
2340        January 11, 1999
2341        Editor Tedd Mirgliotta, KB8NW
2342        Provided by BARF-80 BBS Cleveland, Ohio
2343        Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
2344        Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
2345        Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
2346        & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
2347        Press Enter to continue, A to abort (508 lines) >
2348
2349
2350
2351
2352   The page length will of course depend on what you have it set to!
2353
2354
2355   1\b11\b1.\b.4\b4.\b.  T\bTh\bhe\be A\bAl\bli\bia\bas\bse\bes\bs f\bfi\bil\ble\be
2356
2357   You will find a file in /spider/cmd/ called Aliases.  First, copy this
2358   file to /spider/local_cmd/Aliases and edit this file.  You will see
2359   something like this ...
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377   #!/usr/bin/perl
2378
2379   # provide some standard aliases for commands for terminally
2380   # helpless ak1a user (helpless in the sense that they never
2381   # read nor understand help files)
2382
2383   # This file is automagically reloaded if its modification time is
2384   # later than the one stored in CmdAlias.pm
2385
2386   # PLEASE make this file consistant with reality! (the patterns MUST
2387   # match the filenames!)
2388
2389   # Don't alter this file, copy it into the local_cmd tree and modify it.
2390   # This file will be replaced everytime I issue a new release.
2391
2392   # You only need to put aliases in here for commands that don't work as
2393   # you desire naturally, e.g sh/dx on its own just works as you expect
2394   # so you need not add it as an alias.
2395
2396
2397
2398   package CmdAlias;
2399
2400   %alias = (
2401       '?' => [
2402             '^\?', 'apropos', 'apropos',
2403           ],
2404       'a' => [
2405             '^ann.*/full', 'announce full', 'announce',
2406             '^ann.*/sysop', 'announce sysop', 'announce',
2407             '^ann.*/(.*)$', 'announce $1', 'announce',
2408           ],
2409           'b' => [
2410           ],
2411           'c' => [
2412           ],
2413           'd' => [
2414             '^del', 'kill', 'kill',
2415             '^del\w*/fu', 'kill full', 'kill',
2416             '^di\w*/a\w*', 'directory all', 'directory',
2417             '^di\w*/b\w*', 'directory bulletins', 'directory',
2418             '^di\w*/n\w*', 'directory new', 'directory',
2419             '^di\w*/o\w*', 'directory own', 'directory',
2420             '^di\w*/s\w*', 'directory subject', 'directory',
2421             '^di\w*/t\w*', 'directory to', 'directory',
2422             '^di\w*/f\w*', 'directory from', 'directory',
2423             '^di\w*/(\d+)', 'directory $1', 'directory',
2424           ],
2425           'e' => [
2426           ],
2427           'f' => [
2428           ],
2429           'g' => [
2430           ],
2431           'h' => [
2432           ],
2433           'i' => [
2434           ],
2435           'j' => [
2436           ],
2437           'k' => [
2438           ],
2439           'l' => [
2440             '^l$', 'directory', 'directory',
2441             '^ll$', 'directory', 'directory',
2442             '^ll/(\d+)', 'directory $1', 'directory',
2443           ],
2444           'm' => [
2445           ],
2446           'n' => [
2447             '^news', 'type news', 'type',
2448           ],
2449           'o' => [
2450           ],
2451           'p' => [
2452           ],
2453           'q' => [
2454             '^q', 'bye', 'bye',
2455           ],
2456           'r' => [
2457             '^r$', 'read', 'read',
2458             '^rcmd/(\S+)', 'rcmd $1', 'rcmd',
2459           ],
2460           's' => [
2461             '^s/p$', 'send', 'send',
2462             '^sb$', 'send noprivate', 'send',
2463             '^set/home$', 'set/homenode', 'set/homenode',
2464             '^set/nobe', 'unset/beep', 'unset/beep',
2465             '^set/nohe', 'unset/here', 'unset/here',
2466             '^set/noan', 'unset/announce', 'unset/announce',
2467             '^set/nodx', 'unset/dx', 'unset/dx',
2468             '^set/nota', 'unset/talk', 'unset/talk',
2469             '^set/noww', 'unset/wwv', 'unset/wwv',
2470             '^set/nowx', 'unset/wx', 'unset/wx',
2471             '^sh$', 'show', 'show',
2472             '^sh\w*/buck', 'dbshow buck', 'dbshow',
2473             '^sh\w*/bu', 'show/files bulletins', 'show/files',
2474             '^sh\w*/c/n', 'show/configuration nodes', 'show/configuration',
2475             '^sh\w*/c$', 'show/configuration', 'show/configuration',
2476             '^sh\w*/com', 'dbavail', 'dbavail',
2477             '^sh\w*/dx/(\d+)-(\d+)', 'show/dx $1-$2', 'show/dx',
2478             '^sh\w*/dx/(\d+)', 'show/dx $1', 'show/dx',
2479             '^sh\w*/dx/d(\d+)', 'show/dx from $1', 'show/dx',
2480             '^sh\w*/email', 'dbshow email', 'dbshow',
2481             '^sh\w*/hftest', 'dbshow hftest', 'dbshow',
2482             '^sh\w*/vhftest', 'dbshow vhftest', 'dbshow',
2483             '^sh\w*/qsl', 'dbshow qsl', 'dbshow',
2484             '^sh\w*/tnc', 'who', 'who',
2485             '^sh\w*/up', 'show/cluster', 'show/cluster',
2486             '^sh\w*/w\w*/(\d+)-(\d+)', 'show/wwv $1-$2', 'show/wwv',
2487             '^sh\w*/w\w*/(\d+)', 'show/wwv $1', 'show/wwv',
2488             '^sp$', 'send', 'send',
2489
2490       ],
2491           't' => [
2492             '^ta$', 'talk', 'talk',
2493             '^t$', 'talk', 'talk',
2494           ],
2495           'u' => [
2496           ],
2497           'v' => [
2498           ],
2499           'w' => [
2500             '^wx/full', 'wx full', 'wx',
2501             '^wx/sysop', 'wx sysop', 'wx',
2502           ],
2503           'x' => [
2504           ],
2505           'y' => [
2506           ],
2507           'z' => [
2508           ],
2509   )
2510
2511
2512
2513
2514   You can create aliases for commands at will.  Beware though, these may
2515   not always turn out as you think.  Care is needed and you need to test
2516   the results once you have set an alias.
2517
2518
2519   1\b11\b1.\b.5\b5.\b.  C\bCo\bon\bns\bso\bol\ble\be.\b.p\bpl\bl
2520
2521   In later versions of Spider a simple console program is provided for
2522   the sysop.  This has a type ahead buffer with line editing facilities
2523   and colour for spots, announces etc.  To use this program, simply use
2524   console.pl instead of client.pl.
2525
2526
2527   To edit the colours, copy /spider/perl/Console.pl to /spider/local and
2528   edit the file with your favourite editor.
2529
2530
2531   1\b11\b1.\b.6\b6.\b.  U\bUp\bpd\bda\bat\bti\bin\bng\bg k\bke\bep\bpl\ble\ber\br d\bda\bat\bta\ba
2532
2533   Spider has a powerful and flexible show/satellite command.  In order
2534   for this to be accurate, the kepler data has to be updated regularly.
2535   In general, this data is available as an email or via cluster mail.
2536   Updating it is simple.  First you need to export the mail message as a
2537   file.  You do this with the _\be_\bx_\bp_\bo_\br_\bt command from the cluster prompt as
2538   the sysop.  For example ...
2539
2540
2541
2542        export 5467 /spider/perl/keps.in
2543
2544
2545
2546
2547   would export message number 5467 as a file called keps.in in the
2548   /spider/perl directory.
2549
2550   Now login to a VT as sysop and cd /spider/perl.  There is a command in
2551   the perl directory called _\bc_\bo_\bn_\bv_\bk_\be_\bp_\bs_\b._\bp_\bl.  All we need to do now is
2552   convert the file like so ...
2553
2554
2555
2556        ./convkeps.pl keps.in
2557
2558
2559
2560
2561   Now go back to the cluster and issue the command ...
2562
2563
2564
2565        load/keps
2566
2567
2568
2569
2570   That is it!  the kepler data has been updated.
2571
2572
2573
2574
2575   1\b11\b1.\b.7\b7.\b.  T\bTh\bhe\be Q\bQR\bRZ\bZ c\bca\bal\bll\blb\bbo\boo\bok\bk
2576
2577   The command _\bs_\bh_\b/_\bq_\br_\bz will only work once you have followed a few simple
2578   steps.  First you need to get a user ID and password from qrz.com.
2579   Simply go to the site and create one.  Secondly you need to copy the
2580   file /spider/perl/Internet.pm to /spider/local and alter it to match
2581   your user ID and password.  You also at this point need to set
2582   $allow=1 to complete the setup.  Many thanks to Fred Lloyd, the
2583   proprieter of qrz.com for allowing this access.
2584
2585
2586   1\b12\b2.\b.  C\bCV\bVS\bS
2587
2588   CVS stands for "Concurrent Versions System" and the CVS for DXSpider
2589   is held at Sourceforge.  This means that it is possible to update your
2590   DXSpider installation to the latest sources by using a few simple
2591   commands.
2592
2593
2594   THIS IS NOT FOR THE FAINT HEARTED!!!  ONLY DO THIS IF YOU HAVE A TEST
2595   INSTALLATION OR ARE WILLING TO HAVE YOUR CLUSTER CRASH ON YOU!!!  THIS
2596   MUST BE CONSIDERED AT LEAST BETA TESTING AND MAYBE EVEN ALPHA!!  YOU
2597   HAVE BEEN WARNED!!!
2598
2599
2600   DID I MENTION..... ONLY DO THIS IF YOU ARE WILLING TO ACCEPT THE
2601   CONSEQUENCES!!!
2602
2603
2604   I am of course assuming that you have a machine with both DXSpider and
2605   Internet access running.
2606
2607
2608   BEFORE YOU EVEN CONSIDER STARTING WITH THIS MAKE A BACKUP OF YOUR
2609   ENTIRE SPIDER TREE!!
2610
2611
2612   Assuming you are connected to the Internet, you need to login to the
2613   CVS repository and then update your Spider source.  There are several
2614   steps which are listed below ...
2615
2616
2617   First login as the user _\bs_\by_\bs_\bo_\bp.  Next you need to connect to the CVS
2618   repository.  You do this with the command below ...
2619
2620
2621   cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
2622
2623
2624
2625   You will get a password prompt.  Simply hit return here and your
2626   machine should return to a normal linux prompt.
2627
2628
2629   What happens next depends on whether you have an existing installation
2630   that you want to update with the latest and greatest or whether you
2631   just want to see what is there and/or run it on a new machine for
2632   testing.
2633
2634   If you are installing Spider from CVS then change directory to
2635   /home/sysop
2636
2637   If you are wanting to update Spider then cd to /tmp
2638
2639
2640
2641   The next step will create a brand new 'spider' directory in your
2642   current directory.
2643
2644
2645   cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider
2646
2647
2648
2649   This command is all on one line.
2650
2651
2652   Hopefully your screen should show you downloading files.  The -z3
2653   simply compresses the download to improve speed.  When this has
2654   finished, you will have exactly the same as if you had untarred a full
2655   tarball PLUS some extra directories and files that CVS needs to do the
2656   magic that it does.
2657
2658
2659   Now if you are doing a new installation, that's it.  Carry on as if
2660   you have just downloaded and untarred the lastest tarball.
2661
2662
2663   If you want to upgrade your current installation then do this ...
2664
2665
2666
2667        tar cvfz /tmp/s.tgz spider
2668        cd /
2669        tar xvfzp /tmp/s.tgz
2670
2671
2672
2673
2674   This is assuming you downloaded to the /tmp directory of course.
2675
2676
2677   NOTE:  the 'p' on the end of the 'xvfz' is IMPORTANT!   It keeps the
2678   permissions correct.  YOU WERE LOGGED IN AS THE USER SYSOP WEREN'T
2679   YOU?????
2680
2681   Remember to recompile the C client (cd /spider/src; make)
2682
2683
2684   At this point the files have been upgraded.  You can (usually) restart
2685   the cluster in your own time.  However, if you attempt to use any new
2686   commands or features expect it to be fatal!  At least your cluster
2687   will have been restarted then so it will be too late to worry about
2688   it!
2689
2690
2691   Now the magic part!  From now on when you want to update, simply
2692   connect to the Internet and then, as the user _\bs_\by_\bs_\bo_\bp ...
2693
2694
2695
2696        cd /spider
2697        cvs -z3 update -d
2698
2699
2700
2701
2702   and your files will be updated.  As above, remember to recompile the
2703   "C" client if it has been updated (CVS will tell you) and restart if
2704   any of the perl scripts have been altered or added, again, CVS will
2705   tell you.
2706
2707   You will find any changes documented in the /spider/Changes file.
2708
2709
2710   1\b13\b3.\b.  T\bTh\bhe\be D\bDX\bXS\bSp\bpi\bid\bde\ber\br c\bco\bom\bmm\bma\ban\bnd\bd s\bse\bet\bt
2711
2712   Below is a complete list of commands available from the cluster
2713   prompt.  Most maintenance tasks are automatic but there are some
2714   commands that are useful for a sysop.  These are listed below in
2715   alphabetical order.  The number in brackets following the command name
2716   is the permissions level needed to use the command.
2717
2718
2719   1\b13\b3.\b.1\b1.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(0\b0)\b)
2720
2721   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 announce
2722
2723
2724   Create an 'accept this announce' line for a filter.
2725
2726   An accept filter line means that if the announce matches this filter
2727   it is passed onto the user. See HELP FILTERS for more info. Please
2728   read this to understand how filters work - it will save a lot of grief
2729   later on.
2730
2731   You can use any of the following things in this line:-
2732
2733
2734
2735          info <string>            eg: iota or qsl
2736          by <prefixes>            eg: G,M,2
2737          origin <prefixes>
2738          origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
2739          origin_itu <numbers>
2740          origin_zone <numbers>
2741          by_dxcc <numbers>
2742          by_itu <numbers>
2743          by_zone <numbers>
2744          channel <prefixes>
2745          wx 1                     filter WX announces
2746          dest <prefixes>          eg: 6MUK,WDX      (distros)
2747
2748
2749
2750
2751   some examples:-
2752
2753
2754
2755          acc/ann dest 6MUK
2756          acc/ann 2 by_zone 14,15,16
2757          (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
2758
2759
2760
2761
2762   or
2763
2764
2765
2766          acc/ann by G,M,2
2767
2768
2769
2770
2771   This filter would only allow announces that were posted buy UK
2772   stations.  You can use the tag 'all' to accept everything eg:
2773          acc/ann all
2774
2775
2776
2777
2778   but this probably for advanced users...
2779
2780
2781   1\b13\b3.\b.2\b2.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
2782
2783   a\bac\bcc\bce\bep\bpt\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b]<\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Announce filter sysop
2784   version
2785
2786
2787   This version allows a sysop to set a filter for a callsign as well as
2788   the default for nodes and users eg:-
2789
2790
2791
2792          accept/ann by G,M,2
2793          accept/ann input node_default by G,M,2
2794          accept/ann user_default by G,M,2
2795
2796
2797
2798
2799
2800   1\b13\b3.\b.3\b3.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/s\bsp\bpo\bot\bts\bs (\b(0\b0)\b)
2801
2802   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 spots
2803
2804
2805   Create an 'accept this spot' line for a filter.
2806
2807
2808   An accept filter line means that if the spot matches this filter it is
2809   passed onto the user. See HELP FILTERS for more info. Please read this
2810   to understand how filters work - it will save a lot of grief later on.
2811
2812   You can use any of the following things in this line:-
2813
2814
2815
2816          freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
2817          on <range>             same as 'freq'
2818          call <prefixes>        eg: G,PA,HB9
2819          info <string>          eg: iota or qsl
2820          by <prefixes>
2821          call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
2822          call_itu <numbers>
2823          call_zone <numbers>
2824          by_dxcc <numbers>
2825          by_itu <numbers>
2826          by_zone <numbers>
2827          origin <prefixes>
2828          channel <prefixes>
2829
2830
2831
2832
2833
2834   For frequencies, you can use any of the band names defined in
2835   SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
2836   thus: hf/ssb. You can also just have a simple range like: 0/30000 -
2837   this is more efficient than saying simply: freq HF (but don't get too
2838   hung up about that)
2839   some examples:-
2840
2841
2842
2843          acc/spot 1 on hf/cw
2844          acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
2845
2846
2847
2848
2849   You can use the tag 'all' to accept everything, eg:
2850
2851
2852
2853          acc/spot 3 all
2854
2855
2856
2857
2858   but this probably for advanced users...
2859
2860
2861   1\b13\b3.\b.4\b4.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/s\bsp\bpo\bot\bts\bs (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
2862
2863   a\bac\bcc\bce\bep\bpt\bt/\b/s\bsp\bpo\bot\bts\bs <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Spot filter sysop version
2864
2865
2866   This version allows a sysop to set a filter for a callsign as well as
2867   the default for nodes and users eg:-
2868
2869
2870
2871          accept/spot db0sue-7 1 by_zone 14,15,16
2872          accept/spot node_default all
2873          set/hops node_default 10
2874
2875          accept/spot user_default by G,M,2
2876
2877
2878
2879
2880
2881   1\b13\b3.\b.5\b5.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/w\bwc\bcy\by (\b(0\b0)\b)
2882
2883   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
2884
2885
2886   It is unlikely that you will want to do this, but if you do then you
2887   can filter on the following fields:-
2888
2889
2890
2891          by <prefixes>            eg: G,M,2
2892          origin <prefixes>
2893          origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
2894          origin_itu <numbers>
2895          origin_zone <numbers>
2896          by_dxcc <numbers>
2897          by_itu <numbers>
2898          by_zone <numbers>
2899          channel <prefixes>
2900
2901
2902
2903
2904
2905   There are no examples because WCY Broadcasts only come from one place
2906   and you either want them or not (see UNSET/WCY if you don't want
2907   them).
2908
2909   This command is really provided for future use.
2910
2911   See HELP FILTER for information.
2912
2913
2914   1\b13\b3.\b.6\b6.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/w\bwc\bcy\by (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
2915
2916   a\bac\bcc\bce\bep\bpt\bt/\b/w\bwc\bcy\by <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> WCY filter sysop version
2917
2918
2919   This version allows a sysop to set a filter for a callsign as well as
2920   the default for nodes and users eg:-
2921
2922
2923
2924          accept/wcy node_default all
2925          set/hops node_default 10
2926
2927
2928
2929
2930
2931   1\b13\b3.\b.7\b7.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/w\bww\bwv\bv (\b(0\b0)\b)
2932
2933   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
2934
2935
2936   It is unlikely that you will want to do this, but if you do then you
2937   can filter on the following fields:-
2938
2939
2940
2941          by <prefixes>            eg: G,M,2
2942          origin <prefixes>
2943          origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
2944          origin_itu <numbers>
2945          origin_zone <numbers>
2946          by_dxcc <numbers>
2947          by_itu <numbers>
2948          by_zone <numbers>
2949          channel <prefixes>
2950
2951
2952
2953
2954   for example
2955
2956
2957
2958          accept/wwv by_zone 4
2959
2960
2961
2962
2963   is probably the only useful thing to do (which will only show WWV
2964   broadcasts by stations in the US).
2965
2966   See HELP FILTER for information.
2967
2968
2969
2970
2971   1\b13\b3.\b.8\b8.\b.  a\bac\bcc\bce\bep\bpt\bt/\b/w\bww\bwv\bv (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
2972
2973   a\bac\bcc\bce\bep\bpt\bt/\b/w\bww\bwv\bv <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> WWV filter sysop version
2974
2975
2976   This version allows a sysop to set a filter for a callsign as well as
2977   the default for nodes and users eg:-
2978
2979
2980
2981          accept/wwv db0sue-7 1 by_zone 4
2982          accept/wwv node_default all
2983          set/hops node_default 10
2984
2985          accept/wwv user_default by W,K
2986
2987
2988
2989
2990
2991   1\b13\b3.\b.9\b9.\b.  a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(0\b0)\b)
2992
2993   a\ban\bnn\bno\bou\bun\bnc\bce\be <\b<t\bte\bex\bxt\bt>\b> Send an announcement to local users
2994
2995
2996   Send an announcement to LOCAL users only, where <text> is the text of
2997   the announcement you wish to broadcast
2998
2999
3000   1\b13\b3.\b.1\b10\b0.\b.  a\ban\bnn\bno\bou\bun\bnc\bce\be f\bfu\bul\bll\bl (\b(0\b0)\b)
3001
3002   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
3003
3004
3005   This command will send your announcement across the whole cluster
3006   network.
3007
3008
3009
3010   1\b13\b3.\b.1\b11\b1.\b.  a\ban\bnn\bno\bou\bun\bnc\bce\be s\bsy\bys\bso\bop\bp (\b(5\b5)\b)
3011
3012   a\ban\bnn\bno\bou\bun\bnc\bce\be s\bsy\bys\bso\bop\bp <\b<t\bte\bex\bxt\bt>\b>
3013
3014
3015   Send an announcement to Sysops only
3016
3017
3018   1\b13\b3.\b.1\b12\b2.\b.  a\bap\bpr\bro\bop\bpo\bos\bs (\b(0\b0)\b)
3019
3020   a\bap\bpr\bro\bop\bpo\bos\bs <\b<s\bst\btr\bri\bin\bng\bg>\b> Search the help database
3021
3022
3023   Search the help database for <string> (it isn't case sensitive), and
3024   print the names of all the commands that may be relevant.
3025
3026
3027   1\b13\b3.\b.1\b13\b3.\b.  b\bby\bye\be (\b(0\b0)\b)
3028
3029   b\bby\bye\be Exit from the cluster
3030
3031
3032   This will disconnect you from the cluster
3033
3034
3035
3036
3037   1\b13\b3.\b.1\b14\b4.\b.  c\bca\bat\btc\bch\bhu\bup\bp (\b(5\b5)\b)
3038
3039   c\bca\bat\btc\bch\bhu\bup\bp <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> A\bAl\bll\bl|\b|[\b[<\b<m\bms\bsg\bgn\bno\bo>\b> .\b..\b..\b.]\b] Mark a message as sent
3040
3041
3042   When you send messages the fact that you have forwarded it to another
3043   node is remembered so that it isn't sent again. When you have a new
3044   partner node and you add their callsign to your /spider/msg/forward.pl
3045   file, all outstanding non-private messages will be forwarded to them.
3046   This may well be ALL the non-private messages. You can prevent this by
3047   using these commmands:-
3048
3049
3050
3051          catchup GB7DJK all
3052          catchup GB7DJK 300 301 302 303 500-510
3053
3054
3055
3056
3057   and to undo what you have just done:-
3058
3059
3060
3061          uncatchup GB7DJK all
3062          uncatchup GB7DJK 300 301 302 303 500-510
3063
3064
3065
3066
3067   which will arrange for them to be forward candidates again.
3068
3069   Order is not important.
3070
3071
3072   1\b13\b3.\b.1\b15\b5.\b.  c\bcl\ble\bea\bar\br/\b/s\bsp\bpo\bot\bts\bs (\b(0\b0)\b)
3073
3074   c\bcl\ble\bea\bar\br/\b/s\bsp\bpo\bot\bts\bs [\b[1\b1|\b|a\bal\bll\bl]\b] Clear a spot filter line
3075
3076
3077   This command allows you to clear (remove) a line in a spot filter or
3078   to remove the whole filter.
3079
3080   If you have a filter:-
3081
3082
3083
3084          acc/spot 1 on hf/cw
3085          acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
3086
3087
3088
3089
3090   and you say:-
3091
3092
3093
3094          clear/spot 1
3095
3096
3097
3098
3099   you will be left with:-
3100
3101
3102
3103     acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
3104
3105
3106
3107
3108   If you do:
3109
3110
3111
3112          clear/spot all
3113
3114
3115
3116
3117   the filter will be completely removed.
3118
3119
3120
3121   1\b13\b3.\b.1\b16\b6.\b.  c\bco\bon\bnn\bne\bec\bct\bt (\b(5\b5)\b)
3122
3123   c\bco\bon\bnn\bne\bec\bct\bt <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Start a connection to another DX Cluster
3124
3125
3126   Start a connection process that will culminate in a new connection to
3127   the DX cluster <callsign>. This process creates a new 'client' process
3128   which will use the script in /spider/connect/<callsign> to effect the
3129   'chat' exchange necessary to traverse the network(s) to logon to the
3130   cluster <callsign>.
3131
3132
3133   1\b13\b3.\b.1\b17\b7.\b.  d\bdb\bba\bav\bva\bai\bil\bl (\b(0\b0)\b)
3134
3135   d\bdb\bba\bav\bva\bai\bil\bl Show a list of all the databases in the system
3136
3137
3138   The title says it all really, this command lists all the databases
3139   defined in the system. It is also aliased to SHOW/COMMAND.
3140
3141
3142   1\b13\b3.\b.1\b18\b8.\b.  d\bdb\bbc\bcr\bre\bea\bat\bte\be (\b(9\b9)\b)
3143
3144   d\bdb\bbc\bcr\bre\bea\bat\bte\be <\b<n\bna\bam\bme\be>\b> Create a database entry
3145   d\bdb\bbc\bcr\bre\bea\bat\bte\be <\b<n\bna\bam\bme\be>\b> c\bch\bha\bai\bin\bn <\b<n\bna\bam\bme\be>\b> [\b[<\b<n\bna\bam\bme\be>\b>.\b..\b.]\b] Create a chained database
3146   entry
3147   d\bdb\bbc\bcr\bre\bea\bat\bte\be <\b<n\bna\bam\bme\be>\b> r\bre\bem\bmo\bot\bte\be <\b<n\bno\bod\bde\be>\b> Create a remote database entry
3148
3149
3150   DBCREATE allows you to define a database in the system. It doesn't
3151   actually create anything, just defines it.
3152
3153   The databases that are created are simple DB_File hash databases, they
3154   are therefore already 'indexed'.
3155
3156   You can define a local database with the first form of the command eg:
3157
3158   DBCREATE oblast
3159
3160   You can also chain databases with the addition of the 'chain' keyword.
3161   This will search each database one after the other. A typical example
3162   is:
3163
3164   DBCREATE sdx_qsl chain sql_ad
3165
3166   No checking is done to see if the any of the chained databases exist,
3167   in fact it is usually better to do the above statement first then do
3168   each of the chained databases.
3169   Databases can exist offsite. To define a database that lives on
3170   another node do:
3171
3172   DBCREATE buckmaster remote gb7dxc
3173
3174   Remote databases cannot be chained; however, the last database in a a
3175   chain can be a remote database eg:
3176
3177   DBCREATE qsl chain gb7dxc
3178
3179   To see what databases have been defined do:
3180
3181   DBAVAIL (or it will have been aliased to SHOW/COMMAND)
3182
3183   It would be normal for you to add an entry into your local Aliases
3184   file to allow people to use the 'SHOW/<dbname>' style syntax. So you
3185   would need to add a line like:-
3186
3187
3188
3189          's' => [
3190            ..
3191            ..
3192            '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
3193            ..
3194            ..
3195           ],
3196
3197
3198
3199
3200   to allow
3201
3202   SH/BUCK g1tlh
3203
3204   to work as they may be used to.
3205
3206   See DBIMPORT for the importing of existing AK1A format data to
3207   databases.  See DBSHOW for generic database enquiry
3208
3209
3210   1\b13\b3.\b.1\b19\b9.\b.  d\bdb\bbi\bim\bmp\bpo\bor\brt\bt (\b(9\b9)\b)
3211
3212   d\bdb\bbi\bim\bmp\bpo\bor\brt\bt <\b<d\bdb\bbn\bna\bam\bme\be>\b> Import AK1A data into a database
3213
3214
3215   If you want to import or update data in bulk to a database you can use
3216   this command. It will either create or update entries into an existing
3217   database. For example:-
3218
3219   DBIMPORT oblast /tmp/OBLAST.FUL
3220
3221   will import the standard OBLAST database that comes with AK1A into the
3222   oblast database held locally.
3223
3224
3225   1\b13\b3.\b.2\b20\b0.\b.  d\bdb\bbr\bre\bem\bmo\bov\bve\be (\b(9\b9)\b)
3226
3227   d\bdb\bbr\bre\bem\bmo\bov\bve\be <\b<d\bdb\bbn\bna\bam\bme\be>\b> Delete a database
3228
3229
3230   DBREMOVE will completely remove a database entry and also delete any
3231   data file that is associated with it.
3232
3233   There is no warning, no comeback, no safety net.
3234
3235   For example:
3236
3237   DBREMOVE oblast
3238
3239   will remove the oblast database from the system and it will also
3240   remove the associated datafile.
3241
3242   I repeat:
3243
3244   There is no warning, no comeback, no safety net.
3245
3246   You have been warned.
3247
3248
3249   1\b13\b3.\b.2\b21\b1.\b.  d\bdb\bbs\bsh\bho\bow\bw (\b(0\b0)\b)
3250
3251   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
3252
3253
3254   This is the generic user interface to the database to the database
3255   system.  It is expected that the sysop will add an entry to the local
3256   Aliases file so that users can use the more familiar AK1A style of
3257   enquiry such as:
3258
3259
3260
3261          SH/BUCK G1TLH
3262
3263
3264
3265
3266   but if he hasn't and the database really does exist (use DBAVAIL or
3267   SHOW/COMMAND to find out) you can do the same thing with:
3268
3269
3270
3271          DBSHOW buck G1TLH
3272
3273
3274
3275
3276
3277
3278   1\b13\b3.\b.2\b22\b2.\b.  d\bde\beb\bbu\bug\bg (\b(9\b9)\b)
3279
3280   d\bde\beb\bbu\bug\bg Set the cluster program into debug mode
3281
3282
3283   Executing this command will only have an effect if you are running the
3284   cluster in debug mode i.e.
3285
3286
3287
3288                perl -d cluster.pl
3289
3290
3291
3292
3293   It will interrupt the cluster just after the debug command has
3294   finished.
3295
3296
3297   1\b13\b3.\b.2\b23\b3.\b.  d\bdi\bir\bre\bec\bct\bto\bor\bry\by (\b(0\b0)\b)
3298
3299   d\bdi\bir\bre\bec\bct\bto\bor\bry\by List messages
3300   d\bdi\bir\bre\bec\bct\bto\bor\bry\by o\bow\bwn\bn List your own messages
3301   d\bdi\bir\bre\bec\bct\bto\bor\bry\by n\bne\bew\bw List all new messages
3302   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>
3303   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>
3304   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
3305   d\bdi\bir\bre\bec\bct\bto\bor\bry\by <\b<n\bnn\bn>\b> List last <nn> messages
3306   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
3307
3308
3309   List the messages in the messages directory.
3310
3311   If there is a 'p' one space after the message number then it is a
3312   personal message. If there is a '-' between the message number and the
3313
3314   You can use shell escape characters such as '*' and '?' in the <call>
3315   fields.
3316
3317   You can combine some of the various directory commands together eg:-
3318
3319
3320
3321           DIR TO G1TLH 5
3322        or
3323           DIR SUBJECT IOTA 200-250
3324
3325
3326
3327
3328   You can abbreviate all the commands to one letter and use ak1a
3329   syntax:-
3330
3331
3332
3333           DIR/T G1* 10
3334           DIR/S QSL 10-100 5
3335
3336
3337
3338
3339
3340
3341   1\b13\b3.\b.2\b24\b4.\b.  d\bdi\bir\bre\bec\bct\bto\bor\bry\by (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(5\b5)\b)
3342
3343   Works just like the user command except that sysops can see ALL
3344   messages.
3345
3346
3347   1\b13\b3.\b.2\b25\b5.\b.  d\bdi\bis\bsc\bco\bon\bnn\bne\bec\bct\bt (\b(8\b8)\b)
3348
3349   d\bdi\bis\bsc\bco\bon\bnn\bne\bec\bct\bt <\b<c\bca\bal\bll\bl>\b> [\b[<\b<c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Disconnect a user or node
3350
3351
3352   Disconnect any <call> connected locally
3353
3354
3355   1\b13\b3.\b.2\b26\b6.\b.  d\bdx\bx (\b(0\b0)\b)
3356
3357   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
3358
3359
3360   This is how you send a DX Spot to other users. You can, in fact, now
3361   enter the <freq> and the <call> either way round.
3362
3363
3364
3365
3366
3367      DX FR0G 144.600
3368      DX 144.600 FR0G
3369      DX 144600 FR0G
3370
3371
3372
3373
3374   will all give the same result. You can add some remarks to the end of
3375   the command and they will be added to the spot.
3376
3377
3378
3379           DX FR0G 144600 this is a test
3380
3381
3382
3383
3384   You can credit someone else by saying:-
3385
3386
3387
3388           DX by G1TLH FR0G 144.600 he isn't on the cluster
3389
3390
3391
3392
3393   The <freq> is compared against the available bands set up in the
3394   cluster.  See SHOW/BANDS for more information.
3395
3396
3397   1\b13\b3.\b.2\b27\b7.\b.  e\bex\bxp\bpo\bor\brt\bt (\b(9\b9)\b)
3398
3399   e\bex\bxp\bpo\bor\brt\bt <\b<m\bms\bsg\bgn\bno\bo>\b> <\b<f\bfi\bil\ble\ben\bna\bam\bme\be>\b> Export a message to a file
3400
3401
3402   Export a message to a file. This command can only be executed on a
3403   local console with a fully privileged user. The file produced will be
3404   in a form ready to be imported back into the cluster by placing it in
3405   the import directory (/spider/msg/import).
3406
3407   This command cannot overwrite an existing file. This is to provide
3408   some measure of security. Any files written will owned by the same
3409   user as the main cluster, otherwise you can put the new files anywhere
3410   the cluster can access. For example:-
3411
3412   EXPORT 2345 /tmp/a
3413
3414
3415   1\b13\b3.\b.2\b28\b8.\b.  e\bex\bxp\bpo\bor\brt\bt_\b_u\bus\bse\ber\brs\bs (\b(9\b9)\b)
3416
3417   e\bex\bxp\bpo\bor\brt\bt_\b_u\bus\bse\ber\brs\bs [\b[<\b<f\bfi\bil\ble\ben\bna\bam\bme\be>\b>]\b] Export the users database to ascii
3418
3419
3420   Export the users database to a file in ascii format. If no filename is
3421   given then it will export the file to /spider/data/user_asc.
3422
3423   If the file already exists it will be renamed to <filename>.o. In fact
3424   up to 5 generations of the file can be kept each one with an extra 'o'
3425   on the suffix.
3426
3427   BE WARNED: this will write to any file you have write access to. No
3428   check is made on the filename (if any) that you specify.
3429
3430
3431
3432
3433   1\b13\b3.\b.2\b29\b9.\b.  f\bfo\bor\brw\bwa\bar\brd\bd/\b/l\bla\bat\btl\blo\bon\bng\bg (\b(8\b8)\b)
3434
3435   f\bfo\bor\brw\bwa\bar\brd\bd/\b/l\bla\bat\btl\blo\bon\bng\bg <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> Send latitude and longitude information to
3436   another cluster
3437
3438
3439   This command sends all the latitude and longitude information that
3440   your cluster is holding against callsigns.  One advantage of recieving
3441   this information is that more locator information is held by you.
3442   This means that more locators are given on the DX line assuming you
3443   have _\bs_\be_\bt_\b/_\bd_\bx_\bg_\br_\bi_\bd enabled.  This could be a LOT of information though,
3444   so it is not recommended on slow links.
3445
3446
3447   1\b13\b3.\b.3\b30\b0.\b.  f\bfo\bor\brw\bwa\bar\brd\bd/\b/o\bop\bpe\ber\brn\bna\bam\bme\be (\b(1\b1)\b)
3448
3449   f\bfo\bor\brw\bwa\bar\brd\bd/\b/o\bop\bpe\ber\brn\bna\bam\bme\be <\b<c\bca\bal\bll\bl>\b> Send out information on this <call> to all
3450   clusters
3451
3452
3453   This command sends out any information held in the user file which can
3454   be broadcast in PC41 protocol packets. This information is Name, QTH,
3455   Location and Homenode. PC41s are only sent for the information that is
3456   available.
3457
3458
3459   1\b13\b3.\b.3\b31\b1.\b.  h\bhe\bel\blp\bp (\b(0\b0)\b)
3460
3461   h\bhe\bel\blp\bp <\b<c\bcm\bmd\bd>\b> Get help on a command
3462
3463
3464   All commands can be abbreviated, so SHOW/DX can be abbreviated to
3465   SH/DX, ANNOUNCE can be shortened to AN and so on.
3466
3467   Look at the APROPOS <string> command which will search the help
3468   database for the <string> you specify and give you a list of likely
3469   commands to look at with HELP.
3470
3471
3472   1\b13\b3.\b.3\b32\b2.\b.  i\bin\bni\bit\bt (\b(5\b5)\b)
3473
3474   i\bin\bni\bit\bt <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> Re-initialise a link to an AK1A compatible node
3475
3476
3477   This command attempts to re-initialise a link to a (usually) AK1A node
3478   that has got confused, usually by a protocol loop of some kind. It may
3479   work - but you usually will be better off simply disconnecting it (or
3480   better, if it is a real AK1A node, doing an RCMD <node> DISC/F <your
3481   node>).
3482
3483   Best of luck - you will need it.
3484
3485
3486   1\b13\b3.\b.3\b33\b3.\b.  k\bki\bil\bll\bl (\b(0\b0)\b)
3487
3488   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] Delete a message from the local system
3489
3490
3491   Delete a message from the local system. You will only be able to
3492   delete messages that you have originated or been sent (unless you are
3493   the sysop).
3494
3495
3496
3497
3498
3499   1\b13\b3.\b.3\b34\b4.\b.  k\bki\bil\bll\bl (\b(5\b5)\b)
3500
3501   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
3502   k\bki\bil\bll\bl f\bfr\bro\bom\bm <\b<c\bca\bal\bll\bl>\b> Remove all messages from a callsign
3503   k\bki\bil\bll\bl t\bto\bo <\b<c\bca\bal\bll\bl>\b> Remove all messages to a callsign
3504
3505
3506   You can get rid of any message to or originating from your callsign
3507   using this command. You can remove more than one message at a time.
3508
3509   As a sysop you can kill any message on the system.
3510
3511
3512   1\b13\b3.\b.3\b35\b5.\b.  k\bki\bil\bll\bl f\bfu\bul\bll\bl (\b(5\b5)\b)
3513
3514   k\bki\bil\bll\bl f\bfu\bul\bll\bl <\b<m\bms\bsg\bgn\bno\bo>\b> [\b[<\b<m\bms\bsg\bgn\bno\bo>\b>]\b] Delete a message from the whole cluster
3515
3516
3517   Delete a message (usually a 'bulletin') from the whole cluster system.
3518
3519   This uses the subject field, so any messages that have exactly the
3520   same subject will be deleted. Beware!
3521
3522
3523   1\b13\b3.\b.3\b36\b6.\b.  l\bli\bin\bnk\bks\bs (\b(0\b0)\b)
3524
3525   l\bli\bin\bnk\bks\bs Show which nodes are physically connected
3526
3527
3528   This is a quick listing that shows which links are connected and some
3529   information about them. See WHO for a list of all connections.
3530
3531
3532
3533   1\b13\b3.\b.3\b37\b7.\b.  l\blo\boa\bad\bd/\b/a\bal\bli\bia\bas\bse\bes\bs (\b(9\b9)\b)
3534
3535   l\blo\boa\bad\bd/\b/a\bal\bli\bia\bas\bse\bes\bs Reload the command alias table
3536
3537
3538   Reload the /spider/cmd/Aliases file after you have editted it. You
3539   will need to do this if you change this file whilst the cluster is
3540   running in order for the changes to take effect.
3541
3542
3543
3544   1\b13\b3.\b.3\b38\b8.\b.  l\blo\boa\bad\bd/\b/b\bba\bad\bdd\bdx\bx (\b(9\b9)\b)
3545
3546   l\blo\boa\bad\bd/\b/b\bba\bad\bdd\bdx\bx Reload the bad DX table
3547
3548
3549   Reload the /spider/data/baddx.pl file if you have changed it manually
3550   whilst the cluster is running. This table contains the DX Calls that,
3551   if spotted, will not be passed on. FR0G and TEST are classic examples.
3552
3553
3554   1\b13\b3.\b.3\b39\b9.\b.  l\blo\boa\bad\bd/\b/b\bba\bad\bdm\bms\bsg\bg (\b(9\b9)\b)
3555
3556   l\blo\boa\bad\bd/\b/b\bba\bad\bdm\bms\bsg\bg Reload the bad message table
3557
3558
3559   Reload the /spider/msg/badmsg.pl file if you have changed it manually
3560   whilst the cluster is running. This table contains a number of perl
3561   regular expressions which are searched for in the fields targetted of
3562   each message.  If any of them match then that message is immediately
3563   deleted on receipt.
3564
3565   1\b13\b3.\b.4\b40\b0.\b.  l\blo\boa\bad\bd/\b/b\bba\bad\bdw\bwo\bor\brd\bds\bs (\b(9\b9)\b)
3566
3567   l\blo\boa\bad\bd/\b/b\bba\bad\bdw\bwo\bor\brd\bds\bs Reload the badwords file
3568
3569
3570   Reload the /spider/data/badwords file if you have changed it manually
3571   whilst the cluster is running. This file contains a list of words
3572   which, if found on certain text portions of PC protocol, will cause
3573   those protocol frames to be rejected. It will all put out a message if
3574   any of these words are used on the announce, dx and talk commands. The
3575   words can be one or more on a line, lines starting with '#' are
3576   ignored.
3577
3578
3579   1\b13\b3.\b.4\b41\b1.\b.  l\blo\boa\bad\bd/\b/b\bba\ban\bnd\bds\bs (\b(9\b9)\b)
3580
3581   l\blo\boa\bad\bd/\b/b\bba\ban\bnd\bds\bs Reload the band limits table
3582
3583
3584   Reload the /spider/data/bands.pl file if you have changed it manually
3585   whilst the cluster is running.
3586
3587
3588   1\b13\b3.\b.4\b42\b2.\b.  l\blo\boa\bad\bd/\b/c\bcm\bmd\bd_\b_c\bca\bac\bch\bhe\be (\b(9\b9)\b)
3589
3590   l\blo\boa\bad\bd/\b/c\bcm\bmd\bd_\b_c\bca\bac\bch\bhe\be Reload the automatic command cache
3591
3592
3593   Normally, if you change a command file in the cmd or local_cmd tree it
3594   will automatially be picked up by the cluster program. Sometimes it
3595   can get confused if you are doing a lot of moving commands about or
3596   delete a command in the local_cmd tree and want to use the normal one
3597   again. Execute this command to reset everything back to the state it
3598   was just after a cluster restart.
3599
3600
3601   1\b13\b3.\b.4\b43\b3.\b.  l\blo\boa\bad\bd/\b/f\bfo\bor\brw\bwa\bar\brd\bd (\b(9\b9)\b)
3602
3603   l\blo\boa\bad\bd/\b/f\bfo\bor\brw\bwa\bar\brd\bd Reload the msg forwarding routing table
3604
3605   Reload the /spider/msg/forward.pl file if you have changed it manually
3606   whilst the cluster is running.
3607
3608
3609   1\b13\b3.\b.4\b44\b4.\b.  l\blo\boa\bad\bd/\b/m\bme\bes\bss\bsa\bag\bge\bes\bs (\b(9\b9)\b)
3610
3611   l\blo\boa\bad\bd/\b/m\bme\bes\bss\bsa\bag\bge\bes\bs Reload the system messages file
3612
3613
3614   If you change the /spider/perl/Messages file (usually whilst
3615   fiddling/writing ne commands) you can have them take effect during a
3616   cluster session by executing this command. You need to do this if get
3617   something like :-
3618
3619   unknown message 'xxxx' in lang 'en'
3620
3621
3622   1\b13\b3.\b.4\b45\b5.\b.  l\blo\boa\bad\bd/\b/p\bpr\bre\bef\bfi\bix\bxe\bes\bs (\b(9\b9)\b)
3623
3624   l\blo\boa\bad\bd/\b/p\bpr\bre\bef\bfi\bix\bxe\bes\bs Reload the prefix table
3625
3626
3627   Reload the /spider/data/prefix_data.pl file if you have changed it
3628   manually whilst the cluster is running.
3629
3630
3631   1\b13\b3.\b.4\b46\b6.\b.  m\bme\ber\brg\bge\be (\b(5\b5)\b)
3632
3633   m\bme\ber\brg\bge\be <\b<n\bno\bod\bde\be>\b> [\b[<\b<n\bno\bo s\bsp\bpo\bot\bts\bs>\b>/\b/<\b<n\bno\bo w\bww\bwv\bv>\b>]\b] Ask for the latest spots and WWV
3634
3635
3636   MERGE allows you to bring your spot and wwv database up to date. By
3637   default it will request the last 10 spots and 5 WWVs from the node you
3638   select. The node must be connected locally.
3639
3640   You can request any number of spots or wwv and although they will be
3641   appended to your databases they will not duplicate any that have
3642   recently been added (the last 2 days for spots and last month for WWV
3643   data).
3644
3645
3646   1\b13\b3.\b.4\b47\b7.\b.  m\bms\bsg\bg (\b(9\b9)\b)
3647
3648   m\bms\bsg\bg <\b<c\bcm\bmd\bd>\b> <\b<m\bms\bsg\bgn\bno\bo>\b> [\b[d\bda\bat\bta\ba .\b..\b..\b.]\b] Alter various message parameters
3649
3650
3651   Alter message parameters like To, From, Subject, whether private or
3652   bulletin or return receipt (RR) is required or whether to keep this
3653   message from timing out.
3654
3655
3656
3657          MSG TO <msgno> <call>     - change TO callsign to <call>
3658          MSG FRom <msgno> <call>   - change FROM callsign to <call>
3659          MSG PRrivate <msgno>      - set private flag
3660          MSG NOPRrivate <msgno>    - unset private flag
3661          MSG RR <msgno>            - set RR flag
3662          MSG NORR <msgno>          - unset RR flag
3663          MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
3664          MSG NOKEep <msgno>        - unset the keep flag
3665          MSG SUbject <msgno> <new> - change the subject to <new>
3666          MSG WAittime <msgno>      - remove any waitting time for this message
3667          MSG NOREad <msgno>        - mark message as unread
3668          MSG REad <msgno>          - mark message as read
3669          MSG QUeue                 - queue any outstanding bulletins
3670          MSG QUeue 1               - queue any outstanding private messages
3671
3672
3673
3674
3675   You can look at the status of a message by using:-
3676
3677   STAT/MSG <msgno>
3678
3679   This will display more information on the message than DIR does.
3680
3681
3682   1\b13\b3.\b.4\b48\b8.\b.  p\bpc\bc (\b(8\b8)\b)
3683
3684   p\bpc\bc <\b<c\bca\bal\bll\bl>\b> <\b<t\bte\bex\bxt\bt>\b> Send text (eg PC Protocol) to <call>
3685
3686
3687   Send some arbitrary text to a locally connected callsign. No
3688   processing is done on the text. This command allows you to send PC
3689   Protocol to unstick things if problems arise (messages get stuck etc).
3690   eg:-
3691
3692   pc gb7djk PC33^GB7TLH^GB7DJK^400^
3693
3694   You can also use in the same way as a talk command to a connected user
3695   but without any processing, added of "from <blah> to <blah>" or
3696   whatever.
3697   pc G1TLH Try doing that properly!!!
3698
3699
3700   1\b13\b3.\b.4\b49\b9.\b.  p\bpi\bin\bng\bg (\b(1\b1)\b)
3701
3702   p\bpi\bin\bng\bg <\b<n\bno\bod\bde\be>\b> Check the link quality between nodes
3703
3704
3705   his command allows you to send a frame to another cluster node on the
3706   network and get a return frame.  The time it takes to do this is a
3707   good indication of the quality of the link.  The actual time it takes
3708   is output to the console in seconds.  Any visible cluster node can be
3709   PINGed.
3710
3711
3712
3713   1\b13\b3.\b.5\b50\b0.\b.  r\brc\bcm\bmd\bd (\b(1\b1)\b)
3714
3715   r\brc\bcm\bmd\bd <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> <\b<c\bcm\bmd\bd>\b> Send a command to another DX cluster
3716
3717
3718   This command allows you to send nearly any command to another DX
3719   Cluster node that is connected to the system.
3720
3721   Whether you get any output is dependant on a) whether the other system
3722   knows that the node callsign of this cluster is in fact a node b)
3723   whether the other system is allowing RCMDs from this node and c)
3724   whether you have permission to send this command at all.
3725
3726
3727   1\b13\b3.\b.5\b51\b1.\b.  r\bre\bea\bad\bd (\b(0\b0)\b)
3728
3729   r\bre\bea\bad\bd Read the next unread personal message addressed to you
3730   r\bre\bea\bad\bd <\b<m\bms\bsg\bgn\bno\bo>\b> Read the specified message
3731
3732
3733   You can read any messages that are sent as 'non-personal' and also any
3734   message either sent by or sent to your callsign.
3735
3736
3737
3738   1\b13\b3.\b.5\b52\b2.\b.  r\bre\bea\bad\bd (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(5\b5)\b)
3739
3740   r\bre\bea\bad\bd <\b<m\bms\bsg\bgn\bno\bo>\b> Read a message on the system
3741
3742
3743   As a sysop you may read any message on the system
3744
3745
3746   1\b13\b3.\b.5\b53\b3.\b.  r\bre\bej\bje\bec\bct\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be
3747
3748   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 for announce
3749
3750
3751   Create an 'reject this announce' line for a filter.
3752
3753   An reject filter line means that if the announce matches this filter
3754   it is passed onto the user. See HELP FILTERS for more info. Please
3755   read this to understand how filters work - it will save a lot of grief
3756   later on.
3757
3758   You can use any of the following things in this line:-
3759
3760
3761
3762
3763     info <string>            eg: iota or qsl
3764     by <prefixes>            eg: G,M,2
3765     origin <prefixes>
3766     origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
3767     origin_itu <numbers>
3768     origin_zone <numbers>
3769     by_dxcc <numbers>
3770     by_itu <numbers>
3771     by_zone <numbers>
3772     channel <prefixes>
3773     wx 1                     filter WX announces
3774     dest <prefixes>          eg: 6MUK,WDX      (distros)
3775
3776
3777
3778
3779   some examples:-
3780
3781
3782
3783          rej/ann by_zone 14,15,16 and not by G,M,2
3784
3785
3786
3787
3788   You can use the tag 'all' to reject everything eg:
3789
3790
3791
3792          rej/ann all
3793
3794
3795
3796
3797   but this probably for advanced users...
3798
3799
3800   1\b13\b3.\b.5\b54\b4.\b.  r\bre\bej\bje\bec\bct\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
3801
3802   r\bre\bej\bje\bec\bct\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Announce filter sysop
3803   version
3804
3805
3806   This version allows a sysop to set a filter for a callsign as well as
3807   the default for nodes and users eg:-
3808
3809
3810
3811          reject/ann by G,M,2
3812          reject/ann input node_default by G,M,2
3813          reject/ann user_default by G,M,2
3814
3815
3816
3817
3818
3819   1\b13\b3.\b.5\b55\b5.\b.  r\bre\bej\bje\bec\bct\bt/\b/s\bsp\bpo\bot\bts\bs (\b(0\b0)\b)
3820
3821   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
3822
3823
3824   Create a 'reject this spot' line for a filter.
3825
3826   A reject filter line means that if the spot matches this filter it is
3827   dumped (not passed on). See HELP FILTERS for more info. Please read
3828   this to understand how filters work - it will save a lot of grief
3829   later on.
3830
3831   You can use any of the following things in this line:-
3832
3833
3834
3835          freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
3836          on <range>             same as 'freq'
3837          call <prefixes>        eg: G,PA,HB9
3838          info <string>          eg: iota or qsl
3839          by <prefixes>
3840          call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
3841          call_itu <numbers>
3842          call_zone <numbers>
3843          by_dxcc <numbers>
3844          by_itu <numbers>
3845          by_zone <numbers>
3846          origin <prefixes>
3847          channel <prefixes>
3848
3849
3850
3851
3852   For frequencies, you can use any of the band names defined in
3853   SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
3854   thus: hf/ssb. You can also just have a simple range like: 0/30000 -
3855   this is more efficient than saying simply: on HF (but don't get too
3856   hung up about that)
3857
3858   some examples:-
3859
3860
3861
3862          rej/spot 1 on hf
3863          rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
3864
3865
3866
3867
3868   You can use the tag 'all' to reject everything eg:
3869
3870
3871
3872          rej/spot 3 all
3873
3874
3875
3876
3877   but this probably for advanced users...
3878
3879
3880   1\b13\b3.\b.5\b56\b6.\b.  r\bre\bej\bje\bec\bct\bt/\b/s\bsp\bpo\bot\bts\bs (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
3881
3882   r\bre\bej\bje\bec\bct\bt/\b/s\bsp\bpo\bot\bts\bs <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> Reject spot filter sysop
3883   version
3884
3885
3886   This version allows a sysop to set a filter for a callsign as well as
3887   the default for nodes and users eg:-
3888
3889
3890
3891
3892
3893
3894
3895     reject/spot db0sue-7 1 by_zone 14,15,16
3896     reject/spot node_default all
3897     set/hops node_default 10
3898
3899     reject/spot user_default by G,M,2
3900
3901
3902
3903
3904
3905   1\b13\b3.\b.5\b57\b7.\b.  r\bre\bej\bje\bec\bct\bt/\b/w\bwc\bcy\by (\b(0\b0)\b)
3906
3907   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
3908
3909
3910   It is unlikely that you will want to do this, but if you do then you
3911   can filter on the following fields:-
3912
3913
3914
3915          by <prefixes>            eg: G,M,2
3916          origin <prefixes>
3917          origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
3918          origin_itu <numbers>
3919          origin_zone <numbers>
3920          by_dxcc <numbers>
3921          by_itu <numbers>
3922          by_zone <numbers>
3923          channel <prefixes>
3924
3925
3926
3927
3928   There are no examples because WCY Broadcasts only come from one place
3929   and you either want them or not (see UNSET/WCY if you don't want
3930   them).
3931
3932   This command is really provided for future use.
3933
3934   See HELP FILTER for information.
3935
3936
3937   1\b13\b3.\b.5\b58\b8.\b.  r\bre\bej\bje\bec\bct\bt/\b/w\bwc\bcy\by (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
3938
3939   r\bre\bej\bje\bec\bct\bt/\b/w\bwc\bcy\by <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> WCY reject filter sysop
3940   version
3941
3942
3943   This version allows a sysop to set a filter for a callsign as well as
3944   the default for nodes and users eg:-
3945
3946   reject/wcy gb7djk all
3947
3948
3949   1\b13\b3.\b.5\b59\b9.\b.  r\bre\bej\bje\bec\bct\bt/\b/w\bww\bwv\bv (\b(0\b0)\b)
3950
3951   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
3952
3953
3954   It is unlikely that you will want to do this, but if you do then you
3955   can filter on the following fields:-
3956
3957
3958
3959
3960
3961     by <prefixes>            eg: G,M,2
3962     origin <prefixes>
3963     origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
3964     origin_itu <numbers>
3965     origin_zone <numbers>
3966     by_dxcc <numbers>
3967     by_itu <numbers>
3968     by_zone <numbers>
3969     channel <prefixes>
3970
3971
3972
3973
3974   for example
3975
3976
3977
3978          reject/wwv by_zone 14,15,16
3979
3980
3981
3982
3983   is probably the only useful thing to do (which will only show WWV
3984   broadcasts by stations in the US).
3985
3986   See HELP FILTER for information.
3987
3988
3989   1\b13\b3.\b.6\b60\b0.\b.  r\bre\bej\bje\bec\bct\bt/\b/w\bww\bwv\bv (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(8\b8)\b)
3990
3991   r\bre\bej\bje\bec\bct\bt/\b/w\bww\bwv\bv <\b<c\bca\bal\bll\bl>\b> [\b[i\bin\bnp\bpu\but\bt]\b] [\b[0\b0-\b-9\b9]\b] <\b<p\bpa\bat\btt\bte\ber\brn\bn>\b> WWV reject filter sysop
3992   version
3993
3994
3995   This version allows a sysop to set a filter for a callsign as well as
3996   the default for nodes and users eg:-
3997
3998
3999
4000          reject/wwv db0sue-7 1 by_zone 4
4001          reject/wwv node_default all
4002
4003          reject/wwv user_default by W
4004
4005
4006
4007
4008
4009   1\b13\b3.\b.6\b61\b1.\b.  r\bre\bep\bpl\bly\by (\b(0\b0)\b)
4010
4011   r\bre\bep\bpl\bly\by Reply (privately) to the last message that you have read
4012   r\bre\bep\bpl\bly\by <\b<m\bms\bsg\bgn\bno\bo>\b> Reply (privately) to the specified message
4013   r\bre\bep\bpl\bly\by B\bB <\b<m\bms\bsg\bgn\bno\bo>\b> Reply as a Bulletin to the specified message
4014   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
4015   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
4016
4017
4018   You can reply to a message and the subject will automatically have
4019   "Re:" inserted in front of it, if it isn't already present.
4020
4021   You can also use all the extra qualifiers such as RR, PRIVATE,
4022   NOPRIVATE, B that you can use with the SEND command (see SEND for
4023   further details)
4024
4025
4026
4027   1\b13\b3.\b.6\b62\b2.\b.  s\bse\ben\bnd\bd (\b(0\b0)\b)
4028
4029   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
4030   s\bse\ben\bnd\bd R\bRR\bR <\b<c\bca\bal\bll\bl>\b> Send a message and ask for a read receipt
4031   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
4032   s\bse\ben\bnd\bd P\bPR\bRI\bIV\bVA\bAT\bTE\bE <\b<c\bca\bal\bll\bl>\b> Send a personal message
4033   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
4034
4035
4036   All the SEND commands will create a message which will be sent either
4037   to an individual callsign or to one of the 'bulletin' addresses.
4038
4039   SEND <call> on its own acts as though you had typed SEND PRIVATE, that
4040   is it will mark the message as personal and send it to the cluster
4041   node that that callsign is connected to.
4042
4043   You can have more than one callsign in all of the SEND commands.
4044
4045   You can have multiple qualifiers so that you can have for example:-
4046
4047
4048
4049          SEND RR COPY 123 PRIVATE G1TLH G0RDI
4050
4051
4052
4053
4054   which should send a copy of message 123 to G1TLH and G0RDI and you
4055   will receive a read receipt when they have read the message.
4056
4057   SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak) SP
4058   is an alias for SEND PRIVATE
4059
4060
4061   1\b13\b3.\b.6\b63\b3.\b.  s\bse\bet\bt/\b/a\bad\bdd\bdr\bre\bes\bss\bs (\b(0\b0)\b)
4062
4063   s\bse\bet\bt/\b/a\bad\bdd\bdr\bre\bes\bss\bs <\b<y\byo\bou\bur\br_\b_a\bad\bdd\bdr\bre\bes\bss\bs>\b> Record your postal address
4064
4065
4066   Literally, record your address details on the cluster.
4067
4068
4069   1\b13\b3.\b.6\b64\b4.\b.  s\bse\bet\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be (\b(0\b0)\b)
4070
4071   s\bse\bet\bt/\b/a\ban\bnn\bno\bou\bun\bnc\bce\be Allow announce messages
4072
4073
4074   Allow announce messages to arrive at your terminal.
4075
4076
4077   1\b13\b3.\b.6\b65\b5.\b.  s\bse\bet\bt/\b/a\bar\brc\bcl\blu\bus\bst\bte\ber\br (\b(5\b5)\b)
4078
4079   s\bse\bet\bt/\b/a\bar\brc\bcl\blu\bus\bst\bte\ber\br <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the node_call an AR-
4080   Cluster type node
4081
4082
4083   Set the node_call as an AR-Cluster type node
4084
4085
4086   1\b13\b3.\b.6\b66\b6.\b.  s\bse\bet\bt/\b/b\bba\bad\bdd\bdx\bx (\b(8\b8)\b)
4087
4088   s\bse\bet\bt/\b/b\bba\bad\bdd\bdx\bx <\b<c\bca\bal\bll\bl>\b> Stop words we do not wish to see in the callsign
4089   field of a dx spot being propagated
4090
4091
4092
4093   Setting a word as 'baddx' will prevent spots with that word in the
4094   callsign field of a DX spot from going any further. They will not be
4095   displayed and they will not be sent onto other nodes.
4096
4097   The word must be wriiten in full, no wild cards are allowed eg:-
4098
4099
4100
4101          set/baddx FORSALE VIDEO FR0G
4102
4103
4104
4105
4106   To allow a word again, use the following command ...
4107
4108
4109
4110          unset/baddx VIDEO
4111
4112
4113
4114
4115
4116   1\b13\b3.\b.6\b67\b7.\b.  s\bse\bet\bt/\b/b\bba\bad\bdn\bno\bod\bde\be (\b(6\b6)\b)
4117
4118   s\bse\bet\bt/\b/b\bba\bad\bdn\bno\bod\bde\be <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> Stop spots from this node_call being
4119   propagated
4120
4121
4122   Setting a callsign as a 'badnode' will prevent spots from that node
4123   going any further. They will not be displayed and they will not be
4124   sent onto other nodes.
4125
4126   The call can be a full or partial call (or a prefix), eg:-
4127
4128
4129
4130          set/badnode K1TTT
4131
4132
4133
4134
4135   will stop anything from K1TTT (including any SSID's)
4136
4137
4138
4139          unset/badnode K1TTT
4140
4141
4142
4143
4144   will allow spots from him again.
4145
4146   Use with extreme care. This command may well be superceded by
4147   FILTERing.
4148
4149
4150   1\b13\b3.\b.6\b68\b8.\b.  s\bse\bet\bt/\b/b\bba\bad\bds\bsp\bpo\bot\btt\bte\ber\br (\b(8\b8)\b)
4151
4152   s\bse\bet\bt/\b/b\bba\bad\bds\bsp\bpo\bot\btt\bte\ber\br <\b<c\bca\bal\bll\bl>\b> Stop spots from this callsign being propagated
4153
4154
4155   Setting a callsign as a 'badspotter' will prevent spots from this
4156   callsign going any further. They will not be displayed and they will
4157   not be sent onto other nodes.
4158
4159   The call must be written in full, no wild cards are allowed eg:-
4160
4161
4162
4163          set/badspotter VE2STN
4164
4165
4166
4167
4168   will stop anything from VE2STN. If you want SSIDs as well then you
4169   must enter them specifically.
4170
4171
4172
4173          unset/badspotter VE2STN
4174
4175
4176
4177
4178   will allow spots from him again.
4179
4180   Use with extreme care. This command may well be superceded by
4181   FILTERing.
4182
4183
4184   1\b13\b3.\b.6\b69\b9.\b.  s\bse\bet\bt/\b/b\bbe\bee\bep\bp (\b(0\b0)\b)
4185
4186   s\bse\bet\bt/\b/b\bbe\bee\bep\bp Add beeps to terminal messages
4187
4188
4189   Add a beep to DX and other terminal messages.
4190
4191
4192   1\b13\b3.\b.7\b70\b0.\b.  s\bse\bet\bt/\b/c\bcl\blx\bx (\b(5\b5)\b)
4193
4194   s\bse\bet\bt/\b/c\bcl\blx\bx <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the node_call a CLX type
4195   node
4196
4197
4198   Set the node_call as a CLX type node
4199
4200
4201   1\b13\b3.\b.7\b71\b1.\b.  s\bse\bet\bt/\b/d\bde\beb\bbu\bug\bg (\b(9\b9)\b)
4202
4203   s\bse\bet\bt/\b/d\bde\beb\bbu\bug\bg <\b<n\bna\bam\bme\be>\b> Add a debug level to the debug set
4204
4205
4206   You can remove this level with unset/debug <name>
4207
4208
4209   1\b13\b3.\b.7\b72\b2.\b.  s\bse\bet\bt/\b/d\bdx\bx (\b(0\b0)\b)
4210
4211   s\bse\bet\bt/\b/d\bdx\bxAllow DX messages to arrive at your terminal
4212
4213
4214   You can stop DX messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bd_\bx command
4215
4216
4217   1\b13\b3.\b.7\b73\b3.\b.  s\bse\bet\bt/\b/d\bdx\bxg\bgr\bri\bid\bd (\b(0\b0)\b)
4218
4219   s\bse\bet\bt/\b/d\bdx\bxg\bgr\bri\bid\bdAllow grid squares on the end of DX messages
4220
4221
4222   Some logging programs do not like the additional information at the
4223   end of a DX spot.  If this is the case, use the _\bu_\bn_\bs_\be_\bt_\b/_\bd_\bx_\bg_\br_\bi_\bd command
4224   to remove the grid squares.
4225   1\b13\b3.\b.7\b74\b4.\b.  s\bse\bet\bt/\b/d\bdx\bxn\bne\bet\bt (\b(5\b5)\b)
4226
4227   s\bse\bet\bt/\b/d\bdx\bxn\bne\bet\bt <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the node_call a DXNet
4228   type node
4229
4230
4231   Set the node_call as a DXNet type node
4232
4233
4234   1\b13\b3.\b.7\b75\b5.\b.  s\bse\bet\bt/\b/e\bec\bch\bho\bo (\b(0\b0)\b)
4235
4236   s\bse\bet\bt/\b/e\bec\bch\bho\bo Make the cluster echo your input
4237
4238
4239   If you are connected via a telnet session, different implimentations
4240   of telnet handle echo differently depending on whether you are
4241   connected via port 23 or some other port. You can use this command to
4242   change the setting appropriately.
4243
4244   You can remove the echo with the _\bu_\bn_\bs_\be_\bt_\b/_\be_\bc_\bh_\bo command
4245
4246   The setting is stored in your user profile.
4247
4248   YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
4249
4250
4251   1\b13\b3.\b.7\b76\b6.\b.  s\bse\bet\bt/\b/h\bhe\ber\bre\be (\b(0\b0)\b)
4252
4253   s\bse\bet\bt/\b/h\bhe\ber\bre\be Set the here flag
4254
4255
4256   Let others on the cluster know you are here by only displaying your
4257   callsign.  If you are away from your terminal you can use the
4258   _\bu_\bn_\bs_\be_\bt_\b/_\bh_\be_\br_\be command to let people know you are away.  This simply puts
4259   brackets around your callsign to indicate you are not available.
4260
4261
4262   1\b13\b3.\b.7\b77\b7.\b.  s\bse\bet\bt/\b/h\bho\bom\bme\ben\bno\bod\bde\be (\b(0\b0)\b)
4263
4264   s\bse\bet\bt/\b/h\bho\bom\bme\ben\bno\bod\bde\be <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> Set your home cluster
4265
4266
4267   Tell the cluster system where you normally connect to. Any Messages
4268   sent to you will normally find their way there should you not be
4269   connected.  eg:-
4270
4271
4272
4273          SET/HOMENODE gb7djk
4274
4275
4276
4277
4278
4279   1\b13\b3.\b.7\b78\b8.\b.  s\bse\bet\bt/\b/h\bho\bop\bps\bs (\b(8\b8)\b)
4280
4281   s\bse\bet\bt/\b/h\bho\bop\bps\bs <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> a\ban\bnn\bn|\b|s\bsp\bpo\bot\bts\bs|\b|w\bww\bwv\bv|\b|w\bwc\bcy\by <\b<n\bn>\b> Set hop count
4282
4283
4284   Set the hop count for a particular type of broadcast for a node.
4285
4286   This command allows you to set up special hop counts for a node for
4287   currently: announce, spots, wwv and wcy broadcasts.
4288
4289
4290
4291   eg:
4292     set/hops gb7djk ann 10
4293     set/hops gb7mbc spots 20
4294
4295
4296
4297
4298   Set SHOW/HOPS for information on what is already set. This command
4299   creates a filter and works in conjunction with the filter system.
4300
4301
4302   1\b13\b3.\b.7\b79\b9.\b.  s\bse\bet\bt/\b/i\bis\bso\bol\bla\bat\bte\be (\b(9\b9)\b)
4303
4304   s\bse\bet\bt/\b/i\bis\bso\bol\bla\bat\bte\be <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> Isolate a node from the rest of the network
4305
4306
4307   Connect a node to your system in such a way that you are a full
4308   protocol member of its network and can see all spots on it, but
4309   nothing either leaks out from it nor goes back into from the rest of
4310   the nodes connected to you.
4311
4312   You can potentially connect several nodes in this way.
4313
4314   You can see which nodes are isolated with the show/isolate (1)
4315   command.
4316
4317   You can remove the isolation with the command unset/isolate.
4318
4319
4320   1\b13\b3.\b.8\b80\b0.\b.  s\bse\bet\bt/\b/l\bla\ban\bng\bgu\bua\bag\bge\be (\b(0\b0)\b)
4321
4322   s\bse\bet\bt/\b/l\bla\ban\bng\bgu\bua\bag\bge\be <\b<l\bla\ban\bng\bgu\bua\bag\bge\be>\b> Set the language you wish to use
4323
4324
4325   You can select the language that you want the cluster to use.
4326   Currently the languages available are _\be_\bn (English) and _\bn_\bl (Dutch).
4327
4328
4329   1\b13\b3.\b.8\b81\b1.\b.  s\bse\bet\bt/\b/l\blo\boc\bca\bat\bti\bio\bon\bn (\b(0\b0)\b)
4330
4331   s\bse\bet\bt/\b/l\blo\boc\bca\bat\bti\bio\bon\bn <\b<l\bla\bat\bt a\ban\bnd\bd l\blo\bon\bng\bg>\b> Set your latitude and longitude
4332
4333
4334   You can set your latitude and longitude manually or alternatively use
4335   the _\bs_\be_\bt_\b/_\bq_\br_\ba command which will do the conversion for you.
4336
4337
4338
4339          set/location 54 04 N 2 02 E
4340
4341
4342
4343
4344
4345
4346   1\b13\b3.\b.8\b82\b2.\b.  s\bse\bet\bt/\b/s\bsy\bys\bs_\b_l\blo\boc\bca\bat\bti\bio\bon\bn (\b(9\b9)\b)
4347
4348   s\bse\bet\bt/\b/s\bsy\bys\bs_\b_l\blo\boc\bca\bat\bti\bio\bon\bn <\b<l\bla\bat\bt &\b& l\blo\bon\bng\bg>\b> Set your cluster latitude and longitude
4349
4350
4351   In order to get accurate headings and such like you must tell the
4352   system what your latitude and longitude is. If you have not yet done a
4353   SET/QRA then this command will set your QRA locator for you. For
4354   example:-
4355
4356
4357          SET/LOCATION 52 22 N 0 57 E
4358
4359
4360
4361
4362
4363   1\b13\b3.\b.8\b83\b3.\b.  s\bse\bet\bt/\b/l\blo\bog\bgi\bin\bni\bin\bnf\bfo\bo (\b(0\b0)\b)
4364
4365   s\bse\bet\bt/\b/l\blo\bog\bgi\bin\bni\bin\bnf\bfo\bo Show logins and logouts of nodes and users
4366
4367
4368   Show users and nodes when they log in and out of the local cluster.
4369   You can stop these messages by using the _\bu_\bn_\bs_\be_\bt_\b/_\bl_\bo_\bg_\bi_\bn_\bi_\bn_\bf_\bo command.
4370
4371
4372
4373   1\b13\b3.\b.8\b84\b4.\b.  s\bse\bet\bt/\b/l\blo\boc\bck\bko\bou\but\bt (\b(9\b9)\b)
4374
4375   s\bse\bet\bt/\b/l\blo\boc\bck\bko\bou\but\bt <\b<c\bca\bal\bll\bl>\b> Stop a callsign connecting to the cluster
4376
4377
4378   You can show who is locked out with the _\bs_\bh_\bo_\bw_\b/_\bl_\bo_\bc_\bk_\bo_\bu_\bt command.  To
4379   allow the user to connect again, use the _\bu_\bn_\bs_\be_\bt_\b/_\bl_\bo_\bc_\bk_\bo_\bu_\bt command.
4380
4381
4382   1\b13\b3.\b.8\b85\b5.\b.  s\bse\bet\bt/\b/n\bna\bam\bme\be (\b(0\b0)\b)
4383
4384   s\bse\bet\bt/\b/n\bna\bam\bme\be <\b<y\byo\bou\bur\br_\b_n\bna\bam\bme\be>\b> Set your name
4385
4386
4387   Tell the cluster what your name is, eg:-
4388
4389
4390
4391          set/name Dirk
4392
4393
4394
4395
4396
4397   1\b13\b3.\b.8\b86\b6.\b.  s\bse\bet\bt/\b/n\bno\bod\bde\be (\b(9\b9)\b)
4398
4399   s\bse\bet\bt/\b/n\bno\bod\bde\be <\b<c\bca\bal\bll\bl>\b> [\b[<\b<c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the callsign an AK1A cluster
4400
4401
4402   Tell the system that the call(s) are to be treated as AK1A cluster and
4403   fed PC Protocol rather normal user commands.
4404
4405   From version 1.41 you can also set the following types of cluster
4406
4407
4408
4409          set/spider
4410          set/dxnet
4411          set/clx
4412          set/arcluster
4413
4414
4415
4416
4417   To see what your nodes are set to, use the _\bs_\bh_\bo_\bw_\b/_\bn_\bo_\bd_\be_\bs command.
4418
4419
4420
4421
4422
4423   1\b13\b3.\b.8\b87\b7.\b.  s\bse\bet\bt/\b/o\bob\bbs\bsc\bco\bou\bun\bnt\bt (\b(9\b9)\b)
4424
4425   s\bse\bet\bt/\b/o\bob\bbs\bsc\bco\bou\bun\bnt\bt <\b<c\bco\bou\bun\bnt\bt>\b> <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> Set the 'pump-up' obsolescence
4426   counter
4427
4428
4429   From version 1.35 onwards neighbouring nodes are pinged at regular
4430   intervals (see SET/PINGINTERVAL), usually 300 seconds or 5 minutes.
4431   There is a 'pump-up' counter which is decremented on every outgoing
4432   ping and then reset to the 'obscount' value on every incoming ping.
4433   The default value of this parameter is 2.
4434
4435   What this means is that a neighbouring node will be pinged twice at
4436   (default) 300 second intervals and if no reply has been heard just
4437   before what would be the third attempt, that node is disconnected.
4438
4439   If a ping is heard then the obscount is reset to the full value. Using
4440   default values, if a node has not responded to a ping within 15
4441   minutes, it is disconnected.
4442
4443
4444   1\b13\b3.\b.8\b88\b8.\b.  s\bse\bet\bt/\b/p\bpa\bag\bge\be (\b(0\b0)\b)
4445
4446   s\bse\bet\bt/\b/p\bpa\bag\bge\be <\b<n\bn>\b> Set the number of lines per page
4447
4448
4449   Tell the system how many lines you wish on a page when the number of
4450   lines of output from a command is more than this. The default is 20.
4451   Setting it explicitly to 0 will disable paging.
4452
4453
4454
4455          SET/PAGE 30
4456          SET/PAGE 0
4457
4458
4459
4460
4461   The setting is stored in your user profile.
4462
4463
4464
4465   1\b13\b3.\b.8\b89\b9.\b.  s\bse\bet\bt/\b/p\bpa\bas\bss\bsw\bwo\bor\brd\bd (\b(9\b9)\b)
4466
4467   s\bse\bet\bt/\b/p\bpa\bas\bss\bsw\bwo\bor\brd\bd <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> <\b<s\bst\btr\bri\bin\bng\bg>\b> Set a users password
4468
4469
4470   The password for a user can only be set by a full sysop. The string
4471   can contain any characters but any spaces are removed (you can type in
4472   spaces - but they won't appear in the password). You can see the
4473   result with STAT/USER.  The password is the usual 30 character baycom
4474   type password.
4475
4476
4477   1\b13\b3.\b.9\b90\b0.\b.  s\bse\bet\bt/\b/p\bpi\bin\bng\bgi\bin\bnt\bte\ber\brv\bva\bal\bl (\b(9\b9)\b)
4478
4479   s\bse\bet\bt/\b/p\bpi\bin\bng\bgi\bin\bnt\bte\ber\brv\bva\bal\bl <\b<t\bti\bim\bme\be>\b> <\b<n\bno\bod\bde\be c\bca\bal\bll\bl>\b> Set the ping time to neighbouring
4480   nodes
4481
4482
4483   As from version 1.35 all neighbouring nodes are pinged at regular
4484   intervals in order to determine the rolling quality of the link and,
4485   in future, to affect routing decisions. The default interval is 300
4486   secs or 5 minutes.
4487
4488
4489   You can use this command to set a different interval. Please don't.
4490
4491   But if you do the value you enter is treated as minutes up 60 and
4492   seconds for numbers greater than that.
4493
4494   This is used also to help determine when a link is down at the far end
4495   (as certain cluster software doesn't always notice), see SET/OBSCOUNT
4496   for more information.
4497
4498
4499   1\b13\b3.\b.9\b91\b1.\b.  s\bse\bet\bt/\b/p\bpr\bri\biv\bvi\bil\ble\beg\bge\be (\b(9\b9)\b)
4500
4501   s\bse\bet\bt/\b/p\bpr\bri\biv\bvi\bil\ble\beg\bge\be <\b<n\bn>\b> <\b<c\bca\bal\bll\bl>\b> [\b[<\b<c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Set the privilege level on a
4502   call
4503
4504
4505   Set the privilege level on a callsign. The privilege levels that
4506   pertain to commands are as default:-
4507
4508
4509
4510          0 - normal user
4511          1 - allow remote nodes normal user RCMDs
4512          5 - various privileged commands (including shutdown, but not disc-
4513              connect), the normal level for another node.
4514          8 - more privileged commands (including disconnect)
4515          9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
4516              LEVEL.
4517
4518
4519
4520
4521   If you are a sysop and you come in as a normal user on a remote
4522   connection your privilege will automatically be set to 0.
4523
4524
4525   1\b13\b3.\b.9\b92\b2.\b.  s\bse\bet\bt/\b/s\bsp\bpi\bid\bde\ber\br (\b(5\b5)\b)
4526
4527   s\bse\bet\bt/\b/s\bsp\bpi\bid\bde\ber\br <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Make the node_call a DXSpider
4528   type node
4529
4530
4531   Set the node_call as a DXSpider type node
4532
4533
4534   1\b13\b3.\b.9\b93\b3.\b.  s\bse\bet\bt/\b/s\bsy\bys\bs_\b_q\bqr\bra\ba (\b(9\b9)\b)
4535
4536   s\bse\bet\bt/\b/s\bsy\bys\bs_\b_q\bqr\bra\ba <\b<l\blo\boc\bca\bat\bto\bor\br>\b> Set your cluster QRA locator
4537
4538
4539   1\b13\b3.\b.9\b94\b4.\b.  s\bse\bet\bt/\b/q\bqr\bra\ba (\b(0\b0)\b)
4540
4541   s\bse\bet\bt/\b/q\bqr\bra\ba <\b<l\blo\boc\bca\bat\bto\bor\br>\b> Set your QRA locator
4542
4543
4544   Tell the system what your QRA (or Maidenhead) locator is. If you have
4545   not done a SET/LOCATION then your latitude and longitude will be set
4546   roughly correctly (assuming your locator is correct ;-). For example:-
4547
4548
4549
4550          SET/QRA JO02LQ
4551
4552
4553
4554
4555   1\b13\b3.\b.9\b95\b5.\b.  s\bse\bet\bt/\b/q\bqt\bth\bh (\b(0\b0)\b)
4556
4557   s\bse\bet\bt/\b/q\bqt\bth\bh <\b<y\byo\bou\bur\br Q\bQT\bTH\bH>\b> Set your QTH
4558
4559
4560   Tell the system where your are.  For example:-
4561
4562
4563
4564          set/qth East Dereham, Norfolk
4565
4566
4567
4568
4569
4570   1\b13\b3.\b.9\b96\b6.\b.  s\bse\bet\bt/\b/t\bta\bal\blk\bk (\b(0\b0)\b)
4571
4572   s\bse\bet\bt/\b/t\bta\bal\blk\bk Allow talk messages to be seen at your console
4573
4574
4575   Allow talk messages to arrive at your console.  You can switch off
4576   talks with the _\bu_\bn_\bs_\be_\bt_\b/_\bt_\ba_\bl_\bk command.
4577
4578
4579   1\b13\b3.\b.9\b97\b7.\b.  s\bse\bet\bt/\b/w\bwc\bcy\by (\b(0\b0)\b)
4580
4581   s\bse\bet\bt/\b/w\bwc\bcy\by Allow WCY messages to be seen at your console
4582
4583
4584   Allow WCY information to be seen at your console.  You can switch off
4585   WCY messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bw_\bc_\by command.
4586
4587
4588   1\b13\b3.\b.9\b98\b8.\b.  s\bse\bet\bt/\b/w\bww\bwv\bv (\b(0\b0)\b)
4589
4590   s\bse\bet\bt/\b/w\bww\bwv\bv Allow WWV messages to be seen at your console
4591
4592
4593   Allow WWV information to be seen at your console.  You can switch off
4594   WWV messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bw_\bw_\bv command.
4595
4596
4597   1\b13\b3.\b.9\b99\b9.\b.  s\bse\bet\bt/\b/w\bwx\bx (\b(0\b0)\b)
4598
4599   s\bse\bet\bt/\b/w\bwx\bx Allow WX messages to be seen at your console
4600
4601
4602   Allow WX information to be seen at your console.  You can switch off
4603   WX messages with the _\bu_\bn_\bs_\be_\bt_\b/_\bw_\bx command.
4604
4605
4606   1\b13\b3.\b.1\b10\b00\b0.\b.  s\bsh\bho\bow\bw/\b/b\bba\bad\bdd\bdx\bx (\b(1\b1)\b)
4607
4608   s\bsh\bho\bow\bw/\b/b\bba\bad\bdd\bdx\bxShow all the bad dx calls in the system
4609
4610
4611   Display all the bad dx callsigns in the system, see SET/BADDX for more
4612   information.
4613
4614
4615   1\b13\b3.\b.1\b10\b01\b1.\b.  s\bsh\bho\bow\bw/\b/b\bba\bad\bdn\bno\bod\bde\be (\b(6\b6)\b)
4616
4617   s\bsh\bho\bow\bw/\b/b\bba\bad\bdn\bno\bod\bde\be Show all the bad nodes in the system
4618
4619
4620
4621   Display all the bad node callsigns in the system, see SET/BADNODE for
4622   more information.
4623
4624
4625   1\b13\b3.\b.1\b10\b02\b2.\b.  s\bsh\bho\bow\bw/\b/b\bba\bad\bds\bsp\bpo\bot\btt\bte\ber\br (\b(1\b1)\b)
4626
4627   s\bsh\bho\bow\bw/\b/b\bba\bad\bds\bsp\bpo\bot\btt\bte\ber\brShow all the bad spotters in the system
4628
4629
4630   Display all the bad spotter's callsigns in the system, see
4631   SET/BADSPOTTER for more information.
4632
4633
4634   1\b13\b3.\b.1\b10\b03\b3.\b.  s\bsh\bho\bow\bw/\b/d\bda\bat\bte\be (\b(0\b0)\b)
4635
4636   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
4637
4638
4639   This is very nearly the same as SHOW/TIME, the only difference the
4640   format of the date string if no arguments are given.
4641
4642   If no prefixes or callsigns are given then this command returns the
4643   local time and UTC as the computer has it right now. If you give some
4644   prefixes then it will show UTC and UTC + the local offset (not
4645   including DST) at the prefixes or callsigns that you specify.
4646
4647
4648   1\b13\b3.\b.1\b10\b04\b4.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bx (\b(0\b0)\b)
4649
4650   s\bsh\bho\bow\bw/\b/d\bdx\bx [\b[o\bop\bpt\bti\bio\bon\bns\bs]\b] interrogate the spot database
4651
4652
4653   If you just type SHOW/DX you will get the last so many spots (sysop
4654   configurable, but usually 10).
4655
4656   In addition you can add any number of these options in very nearly any
4657   order to the basic SHOW/DX command, they are:-
4658
4659
4660
4661
4662
4663
4664
4665
4666
4667
4668
4669
4670
4671
4672
4673
4674
4675
4676
4677
4678
4679
4680
4681
4682
4683
4684
4685
4686
4687   on <band>       - eg 160m 20m 2m 23cm 6mm
4688   on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
4689
4690   <number>        - the number of spots you want
4691   <from>-<to>     - <from> spot no <to> spot no in
4692                     the selected list
4693
4694   <prefix>        - for a spotted callsign beginning with <prefix>
4695   *<suffix>       - for a spotted callsign ending in <suffix>
4696   *<string>*      - for a spotted callsign containing <string>
4697
4698   day <number>    - starting <number> days ago
4699   day <from>-<to> - <from> days <to> days ago
4700
4701   info <text>     - any spots containing <text> in the info or remarks
4702
4703   by <call>       - any spots spotted by <call> (spotter <call>
4704                           is the same).
4705
4706   qsl             - this automatically looks for any qsl info on the call
4707                     held in the spot database.
4708
4709   iota [<iota>]   - If the iota island number is missing it will
4710                     look for the string iota and anything which looks like
4711                     an iota island number. If you specify then it will look
4712                     for that island.
4713
4714   qra [<locator>] - this will look for the specific locator if
4715                     you specify one or else anything that looks like a locator.
4716
4717
4718
4719
4720   e.g.
4721
4722
4723
4724
4725           SH/DX 9m0
4726           SH/DX on 20m info iota
4727           SH/DX 9a on vhf day 30
4728           SH/DX rf1p qsl
4729           SH/DX iota
4730           SH/DX iota eu-064
4731           SH/DX qra jn86
4732
4733
4734
4735
4736
4737   1\b13\b3.\b.1\b10\b05\b5.\b.  s\bsh\bho\bow\bw/\b/d\bdx\bxc\bcc\bc (\b(0\b0)\b)
4738
4739   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
4740
4741
4742   This command takes the <prefix> (which can be a full or partial
4743   callsign if desired), looks up which internal country number it is and
4744   then displays all the spots as per SH/DX for that country.
4745
4746   The options for SHOW/DX also apply to this command.  e.g.
4747
4748
4749
4750
4751
4752
4753      SH/DXCC G
4754      SH/DXCC W on 20m info iota
4755
4756
4757
4758
4759
4760   1\b13\b3.\b.1\b10\b06\b6.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\ble\bes\bs (\b(0\b0)\b)
4761
4762   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
4763
4764
4765   SHOW/FILES on its own will show you a list of the various fileareas
4766   available on the system. To see the contents of a particular file area
4767   type:-
4768
4769
4770
4771           SH/FILES <filearea>
4772
4773
4774
4775
4776   where <filearea> is the name of the filearea you want to see the
4777   contents of.
4778
4779   You can also use shell globbing characters like '*' and '?' in a
4780   string to see a selection of files in a filearea eg:-
4781
4782
4783
4784           SH/FILES bulletins arld*
4785
4786
4787
4788
4789   See also TYPE - to see the contents of a file.
4790
4791
4792   1\b13\b3.\b.1\b10\b07\b7.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br (\b(0\b0)\b)
4793
4794   s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br Show the filters you have set
4795
4796
4797   Show the contents of all the filters that are set by you. This command
4798   displays all the filters set - for all the various categories.
4799
4800
4801   1\b13\b3.\b.1\b10\b08\b8.\b.  s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br (\b(e\bex\bxt\bte\ben\bnd\bde\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(5\b5)\b)
4802
4803   s\bsh\bho\bow\bw/\b/f\bfi\bil\blt\bte\ber\br <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the filters set by <callsign>
4804
4805
4806   A sysop can look at any filters that have been set.
4807
4808
4809   1\b13\b3.\b.1\b10\b09\b9.\b.  s\bsh\bho\bow\bw/\b/h\bho\bop\bps\bs (\b(8\b8)\b)
4810
4811   s\bsh\bho\bow\bw/\b/h\bho\bop\bps\bs <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[a\ban\bnn\bn|\b|s\bsp\bpo\bot\bts\bs|\b|w\bwc\bcy\by|\b|w\bww\bwv\bv|\b|]\b] Show the hop counts for a
4812   node
4813
4814
4815   This command shows the hop counts set up for a node. You can specify
4816   which category you want to see. If you leave the category out then all
4817   the categories will be listed.
4818
4819   1\b13\b3.\b.1\b11\b10\b0.\b.  s\bsh\bho\bow\bw/\b/i\bis\bso\bol\bla\bat\bte\be (\b(1\b1)\b)
4820
4821   s\bsh\bho\bow\bw/\b/i\bis\bso\bol\bla\bat\bte\be Show a list of isolated nodes
4822
4823
4824   Show which nodes are currently set to be isolated.
4825
4826
4827   1\b13\b3.\b.1\b11\b11\b1.\b.  s\bsh\bho\bow\bw/\b/l\blo\boc\bck\bko\bou\but\bt (\b(9\b9)\b)
4828
4829   s\bsh\bho\bow\bw/\b/l\blo\boc\bck\bko\bou\but\bt Show a list of excluded callsigns
4830
4831
4832   Show a list of callsigns that have been excluded (locked out) of the
4833   cluster locally with the _\bs_\be_\bt_\b/_\bl_\bo_\bc_\bk_\bo_\bu_\bt command
4834
4835
4836   1\b13\b3.\b.1\b11\b12\b2.\b.  s\bsh\bho\bow\bw/\b/l\blo\bog\bg (\b(8\b8)\b)
4837
4838   s\bsh\bho\bow\bw/\b/l\blo\bog\bg [\b[<\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b>]\b] Show excerpts from the system log
4839
4840
4841   This command outputs a short section of the system log.  On its own it
4842   will output a general logfile.  With the optional callsign it will
4843   show output from the log associated with that callsign.
4844
4845
4846   1\b13\b3.\b.1\b11\b13\b3.\b.  s\bsh\bho\bow\bw/\b/m\bmo\boo\bon\bn (\b(0\b0)\b)
4847
4848   s\bsh\bho\bow\bw/\b/m\bmo\boo\bon\bn [\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
4849
4850
4851   Show the Moon rise and set times for a (list of) prefixes or
4852   callsigns, together with the azimuth and elevation of the sun
4853   currently at those locations.
4854
4855   If you don't specify any prefixes or callsigns, it will show the times
4856   for your QTH (assuming you have set it with either SET/LOCATION or
4857   SET/QRA), together with the current azimuth and elevation.
4858
4859   In addition, it will show the gain or loss dB relative to the nominal
4860   distance of 385,000Km due to the ellipsoidal nature of the orbit.
4861
4862   If all else fails it will show the Moonrise and set times for the node
4863   that you are connected to.
4864
4865   For example:-
4866
4867
4868
4869          SH/MOON
4870          SH/MOON G1TLH W5UN
4871
4872
4873
4874
4875
4876   1\b13\b3.\b.1\b11\b14\b4.\b.  s\bsh\bho\bow\bw/\b/m\bmu\buf\bf (\b(0\b0)\b)
4877
4878   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
4879   <prefix>
4880
4881
4882   This command allow you to estimate the likelihood of you contacting a
4883   station with the prefix you have specified. The output assumes a
4884   modest power of 20dBW and receiver sensitivity of -123dBm (about
4885   0.15muV/10dB SINAD)
4886
4887   The result predicts the most likely operating frequencies and signal
4888   levels for high frequency (shortwave) radio propagation paths on
4889   specified days of the year and hours of the day. It is most useful for
4890   paths between 250 km and 6000 km, but can be used with reduced
4891   accuracy for paths shorter or longer than this.
4892
4893   The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
4894   used to predict the MUF given the predicted flux, day of the year,
4895   hour of the day and geographic coordinates of the transmitter and
4896   receiver. This routine is reasonably accurate for the purposes here,
4897   with a claimed RMS error of 3.8 MHz, but much smaller and less complex
4898   than the programs used by major shortwave broadcasting organizations,
4899   such as the Voice of America.
4900
4901   The command will display some header information detailing its
4902   assumptions, together with the locations, latitude and longitudes and
4903   bearings. It will then show UTC (UT), local time at the other end
4904   (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
4905   (Zen) and the likely signal strengths. Then for each frequency for
4906   which the system thinks there is a likelihood of a circuit it prints a
4907   value.
4908
4909   The value is currently a likely S meter reading based on the
4910   conventional 6dB / S point scale. If the value has a '+' appended it
4911   means that it is 1/2 an S point stronger. If the value is preceeded by
4912   an 'm' it means that there is likely to be much fading and by an 's'
4913   that the signal is likely to be noisy.
4914
4915   By default SHOW/MUF will show the next two hours worth of data. You
4916   can specify anything up to 24 hours worth of data by appending the no
4917   of hours required after the prefix. For example:-
4918
4919
4920
4921          SH/MUF W
4922
4923
4924
4925
4926   produces:
4927
4928
4929
4930          RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
4931          Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
4932          Location                       Lat / Long           Azim
4933          East Dereham, Norfolk          52 41 N 0 57 E         47
4934          United-States-W                43 0 N 87 54 W        299
4935          UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
4936          18 23 11.5 -35  mS0+ mS2   S3
4937          19  0 11.2 -41  mS0+ mS2   S3
4938
4939
4940
4941
4942   indicating that you will have weak, fading circuits on top band and
4943   80m but usable signals on 40m (about S3).
4944
4945   inputing:-
4946
4947
4948
4949          SH/MUF W 24
4950
4951   will get you the above display, but with the next 24 hours worth of
4952   propagation data.
4953
4954
4955
4956          SH/MUF W L 24
4957          SH/MUF W 24 Long
4958
4959
4960
4961
4962   Gives you an estimate of the long path propagation characterics. It
4963   should be noted that the figures will probably not be very useful, nor
4964   terrible accurate, but it is included for completeness.
4965
4966
4967   1\b13\b3.\b.1\b11\b15\b5.\b.  s\bsh\bho\bow\bw/\b/n\bno\bod\bde\be (\b(1\b1)\b)
4968
4969   s\bsh\bho\bow\bw/\b/n\bno\bod\bde\be [\b[<\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> .\b..\b..\b.]\b] Show the type and version number of nodes
4970
4971
4972   Show the type and version (if connected) of the nodes specified on the
4973   command line. If no callsigns are specified then a sorted list of all
4974   the non-user callsigns known to the system will be displayed.
4975
4976
4977   1\b13\b3.\b.1\b11\b16\b6.\b.  s\bsh\bho\bow\bw/\b/p\bpr\bre\bef\bfi\bix\bx (\b(0\b0)\b)
4978
4979   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
4980
4981
4982   This command takes the <callsign> (which can be a full or partial
4983   callsign or a prefix), looks up which internal country number it is
4984   and then displays all the relevant prefixes for that country together
4985   with the internal country no, the CQ and ITU regions.
4986
4987   See also SHOW/DXCC
4988
4989
4990
4991   1\b13\b3.\b.1\b11\b17\b7.\b.  s\bsh\bho\bow\bw/\b/p\bpr\bro\bog\bgr\bra\bam\bm (\b(5\b5)\b)
4992
4993   s\bsh\bho\bow\bw/\b/p\bpr\bro\bog\bgr\bra\bam\bm Show the locations of all the included program modules
4994
4995
4996   Show the name and location where every program module was load from.
4997   This is useful for checking where you think you have loaded a .pm file
4998   from.
4999
5000
5001   1\b13\b3.\b.1\b11\b18\b8.\b.  s\bsh\bho\bow\bw/\b/q\bqr\bra\ba (\b(0\b0)\b)
5002
5003   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 the distance between locators
5004   s\bsh\bho\bow\bw/\b/q\bqr\bra\ba <\b<l\bla\bat\bt>\b> <\b<l\blo\bon\bng\bg>\b> Convert latitude and longitude to a locator
5005
5006
5007   This is a multipurpose command that allows you either to calculate the
5008   distance and bearing between two locators or (if only one locator is
5009   given on the command line) the distance and beraing from your station
5010   to the locator. For example:-
5011
5012
5013
5014        SH/QRA IO92QL
5015        SH/QRA JN06 IN73
5016
5017   The first example will show the distance and bearing to the locator
5018   from yourself, the second example will calculate the distance and
5019   bearing from the first locator to the second. You can use 4 or 6
5020   character locators.
5021
5022   It is also possible to convert a latitude and longitude to a locator
5023   by using this command with a latitude and longitude as an argument,
5024   for example:-
5025
5026
5027
5028        SH/QRA 52 41 N 0 58 E
5029
5030
5031
5032
5033
5034   1\b13\b3.\b.1\b11\b19\b9.\b.  s\bsh\bho\bow\bw/\b/q\bqr\brz\bz (\b(0\b0)\b)
5035
5036   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
5037
5038
5039   This command queries the QRZ callbook server on the internet and
5040   returns any information available for that callsign. This service is
5041   provided for users of this software by http://www.qrz.com
5042
5043
5044   1\b13\b3.\b.1\b12\b20\b0.\b.  s\bsh\bho\bow\bw/\b/r\bro\bou\but\bte\be (\b(0\b0)\b)
5045
5046   s\bsh\bho\bow\bw/\b/r\bro\bou\but\bte\be <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the route to <callsign>
5047
5048
5049   This command allows you to see to which node the callsigns specified
5050   are connected. It is a sort of inverse sh/config.
5051
5052
5053
5054          sh/route n2tly
5055
5056
5057
5058
5059
5060   1\b13\b3.\b.1\b12\b21\b1.\b.  s\bsh\bho\bow\bw/\b/s\bsa\bat\bte\bel\bll\bli\bit\bte\be (\b(0\b0)\b)
5061
5062   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 satellite tracking
5063   data
5064
5065
5066   Show the tracking data from your location to the satellite of your
5067   choice from now on for the next few hours.
5068
5069   If you use this command without a satellite name it will display a
5070   list of all the satellites known currently to the system.
5071
5072   If you give a name then you can obtain tracking data of all the passes
5073   that start and finish 5 degrees below the horizon. As default it will
5074   give information for the next three hours for every five minute
5075   period.
5076
5077   You can alter the number of hours and the step size, within certain
5078   limits.
5079
5080   Each pass in a period is separated with a row of '-----' characters
5081
5082
5083   So for example:-
5084
5085
5086
5087        SH/SAT AO-10
5088        SH/SAT FENGYUN1 12 2
5089
5090
5091
5092
5093
5094   1\b13\b3.\b.1\b12\b22\b2.\b.  s\bsh\bho\bow\bw/\b/s\bsu\bun\bn (\b(0\b0)\b)
5095
5096   s\bsh\bho\bow\bw/\b/s\bsu\bun\bn [\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
5097
5098
5099   Show the sun rise and set times for a (list of) prefixes or callsigns,
5100   together with the azimuth and elevation of the sun currently at those
5101   locations.
5102
5103   If you don't specify any prefixes or callsigns, it will show the times
5104   for your QTH (assuming you have set it with either SET/LOCATION or
5105   SET/QRA), together with the current azimuth and elevation.
5106
5107   If all else fails it will show the sunrise and set times for the node
5108   that you are connected to.
5109
5110   For example:-
5111
5112
5113
5114          SH/SUN
5115          SH/SUN G1TLH K9CW ZS
5116
5117
5118
5119
5120
5121   1\b13\b3.\b.1\b12\b23\b3.\b.  s\bsh\bho\bow\bw/\b/t\bti\bim\bme\be (\b(0\b0)\b)
5122
5123   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
5124
5125
5126   If no prefixes or callsigns are given then this command returns the
5127   local time and UTC as the computer has it right now. If you give some
5128   prefixes then it will show UTC and UTC + the local offset (not
5129   including DST) at the prefixes or callsigns that you specify.
5130
5131
5132   1\b13\b3.\b.1\b12\b24\b4.\b.  s\bsh\bho\bow\bw/\b/w\bwc\bcy\by (\b(0\b0)\b)
5133
5134   s\bsh\bho\bow\bw/\b/w\bwc\bcy\by Show the last 10 WCY broadcasts
5135   s\bsh\bho\bow\bw/\b/w\bwc\bcy\by <\b<n\bn>\b> Show the last <n> WCY broadcasts
5136
5137
5138   Display the most recent WCY information that has been received by the
5139   system
5140
5141
5142   1\b13\b3.\b.1\b12\b25\b5.\b.  s\bsh\bho\bow\bw/\b/w\bww\bwv\bv (\b(0\b0)\b)
5143
5144   s\bsh\bho\bow\bw/\b/w\bww\bwv\bv Show the last 10 WWV broadcasts
5145   s\bsh\bho\bow\bw/\b/w\bww\bwv\bv <\b<n\bn>\b> Show the last <n> WWV broadcasts
5146
5147
5148
5149   Display the most recent WWV information that has been received by the
5150   system
5151
5152
5153
5154   1\b13\b3.\b.1\b12\b26\b6.\b.  s\bsh\bhu\but\btd\bdo\bow\bwn\bn (\b(5\b5)\b)
5155
5156   s\bsh\bhu\but\btd\bdo\bow\bwn\bn Shutdown the cluster
5157
5158
5159   Shutdown the cluster and disconnect all the users.  If you have Spider
5160   set to respawn in /etc/inittab it will of course restart.
5161
5162
5163   1\b13\b3.\b.1\b12\b27\b7.\b.  s\bsp\bpo\boo\bof\bf (\b(9\b9)\b)
5164
5165   s\bsp\bpo\boo\bof\bf <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> <\b<c\bco\bom\bmm\bma\ban\bnd\bd>\b> Run commands as another user
5166
5167
5168   This is a very simple yet powerful command for the sysop.  It allows
5169   you to issue commands as if you were a different user.  This is very
5170   useful for the kind of things that users seem to always get wrong..
5171   like home_node for example.
5172
5173
5174   1\b13\b3.\b.1\b12\b28\b8.\b.  s\bst\bta\bat\bt/\b/d\bdb\bb (\b(5\b5)\b)
5175
5176   s\bst\bta\bat\bt/\b/d\bdb\bb <\b<d\bdb\bbn\bna\bam\bme\be>\b> Show the status of a database
5177
5178
5179   Show the internal status of a database descriptor.
5180
5181   Depending on your privilege level you will see more or less
5182   information.  This command is unlikely to be of much use to anyone
5183   other than a sysop.
5184
5185
5186   1\b13\b3.\b.1\b12\b29\b9.\b.  s\bst\bta\bat\bt/\b/c\bch\bha\ban\bnn\bne\bel\bl (\b(5\b5)\b)
5187
5188   s\bst\bta\bat\bt/\b/c\bch\bha\ban\bnn\bne\bel\bl <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the status of a channel on the cluster
5189
5190
5191   Show the internal status of the channel object either for the channel
5192   that you are on or else for the callsign that you asked for.
5193
5194   Only the fields that are defined (in perl term) will be displayed.
5195
5196
5197   1\b13\b3.\b.1\b13\b30\b0.\b.  s\bst\bta\bat\bt/\b/m\bms\bsg\bg (\b(5\b5)\b)
5198
5199   s\bst\bta\bat\bt/\b/m\bms\bsg\bg <\b<m\bms\bsg\bgn\bno\bo>\b> Show the status of a message
5200
5201
5202   This command shows the internal status of a message and includes
5203   information such as to whom it has been forwarded, its size, origin
5204   etc etc.
5205
5206
5207   1\b13\b3.\b.1\b13\b31\b1.\b.  s\bst\bta\bat\bt/\b/u\bus\bse\ber\br (\b(5\b5)\b)
5208
5209   s\bst\bta\bat\bt/\b/u\bus\bse\ber\br <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Show the full status of a user
5210
5211
5212   Shows the full contents of a user record including all the secret
5213   flags and stuff.
5214
5215   Only the fields that are defined (in perl term) will be displayed.
5216
5217
5218   1\b13\b3.\b.1\b13\b32\b2.\b.  s\bsy\bys\bso\bop\bp (\b(0\b0)\b)
5219
5220   s\bsy\bys\bso\bop\bp Regain your privileges if you login remotely
5221
5222
5223   The system automatically reduces your privilege level to that of a
5224   normal user if you login in remotely. This command allows you to
5225   regain your normal privilege level. It uses the normal system: five
5226   numbers are returned that are indexes into the character array that is
5227   your assigned password (see SET/PASSWORD). The indexes start from
5228   zero.
5229
5230   You are expected to return a string which contains the characters
5231   required in the correct order. You may intersperse those characters
5232   with others to obscure your reply for any watchers. For example (and
5233   these values are for explanation :-):
5234
5235
5236
5237          password = 012345678901234567890123456789
5238          > sysop
5239          22 10 15 17 3
5240
5241
5242
5243
5244   you type:-
5245
5246
5247
5248         aa2bbbb0ccc5ddd7xxx3n
5249         or 2 0 5 7 3
5250         or 20573
5251
5252
5253
5254
5255   They will all match. If there is no password you will still be offered
5256   numbers but nothing will happen when you input a string. Any match is
5257   case sensitive.
5258
5259
5260   1\b13\b3.\b.1\b13\b33\b3.\b.  t\bta\bal\blk\bk (\b(0\b0)\b)
5261
5262   t\bta\bal\blk\bk <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> Enter talk mode with <callsign>
5263   t\bta\bal\blk\bk <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> <\b<t\bte\bex\bxt\bt>\b> Send a text message to <callsign>
5264   t\bta\bal\blk\bk <\b<c\bca\bal\bll\bls\bsi\big\bgn\bn>\b> >\b> <\b<n\bno\bod\bde\be_\b_c\bca\bal\bll\bl>\b> [\b[<\b<t\bte\bex\bxt\bt>\b>]\b] Send a text message to
5265   <callsign> via <node_call>
5266
5267
5268   Send a short message to any other station that is visible on the
5269   cluster system. You can send it to anyone you can see with a
5270   SHOW/CONFIGURATION command, they don't have to be connected locally.
5271
5272   The second form of TALK is used when other cluster nodes are connected
5273   with restricted information. This usually means that they don't send
5274   the user information usually associated with logging on and off the
5275   cluster.
5276
5277   If you know that G3JNB is likely to be present on GB7TLH, but you can
5278   only see GB7TLH in the SH/C list but with no users, then you would use
5279   the second form of the talk message.
5280
5281   If you want to have a ragchew with someone you can leave the text
5282   message out and the system will go into 'Talk' mode. What this means
5283   is that a short message is sent to the recipient telling them that you
5284   are in a 'Talking' frame of mind and then you just type - everything
5285   you send will go to the station that you asked for.
5286
5287   All the usual announcements, spots and so on will still come out on
5288   your terminal.
5289
5290   If you want to do something (such as send a spot) you precede the
5291   normal command with a '/' character, eg:-
5292
5293
5294
5295           /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
5296           /HELP talk
5297
5298
5299
5300
5301   To leave talk mode type:
5302
5303
5304
5305           /EX
5306
5307
5308
5309
5310
5311   1\b13\b3.\b.1\b13\b34\b4.\b.  t\bty\byp\bpe\be (\b(0\b0)\b)
5312
5313   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 a file in one of the fileareas
5314
5315
5316   Type out the contents of a file in a filearea. So, for example, in
5317   filearea 'bulletins' you want to look at file 'arld051' you would
5318   enter:-
5319
5320
5321
5322           TYPE bulletins/arld051
5323
5324
5325
5326
5327   See also SHOW/FILES to see what fileareas are available and a list of
5328   content.
5329
5330
5331   1\b13\b3.\b.1\b13\b35\b5.\b.  w\bwh\bho\bo (\b(0\b0)\b)
5332
5333   w\bwh\bho\bo Show who is physically connected locally
5334
5335
5336   This is a quick listing that shows which callsigns are connected and
5337   what sort of connection they have
5338
5339
5340   1\b13\b3.\b.1\b13\b36\b6.\b.  w\bwx\bx (\b(0\b0)\b)
5341
5342   w\bwx\bx <\b<t\bte\bex\bxt\bt>\b> Send a weather message to local users
5343   w\bwx\bx f\bfu\bul\bll\bl <\b<t\bte\bex\bxt\bt>\b>  Send a weather message to all cluster users
5344
5345
5346
5347   Weather messages can sometimes be useful if you are experiencing an
5348   extreme that may indicate enhanced conditions
5349
5350
5351   1\b13\b3.\b.1\b13\b37\b7.\b.  w\bwx\bx (\b(e\ben\bnh\bha\ban\bnc\bce\bed\bd f\bfo\bor\br s\bsy\bys\bso\bop\bps\bs)\b) (\b(5\b5)\b)
5352
5353   w\bwx\bx s\bsy\bys\bso\bop\bp <\b<t\bte\bex\bxt\bt>\b> Send a weather message to other clusters only
5354
5355
5356   Send a weather message only to other cluster nodes and not to general
5357   users.
5358
5359
5360
5361
5362
5363
5364
5365
5366
5367
5368
5369
5370
5371
5372
5373
5374
5375
5376
5377
5378
5379
5380
5381
5382
5383
5384
5385
5386
5387
5388
5389
5390
5391
5392
5393
5394
5395
5396
5397
5398
5399
5400
5401
5402
5403
5404
5405
5406
5407
5408
5409
5410
5411
5412