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