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