]> dxcluster.org Git - spider.git/blob - txt/adminmanual_en.txt
move usdb init as per k1xx's bug
[spider.git] / txt / adminmanual_en.txt
1   The DXSpider Administration Manual v1.50
2   Ian Maude, G0VGS, (g0vgs@gb7mbc.net), and Charlie Carroll,
3   K1XX, (k1xx@ptcnh.net)
4   April 2003 revision 0.7
5
6   A reference for SysOps of the DXSpider DXCluster program.
7   ______________________________________________________________________
8
9   Table of Contents
10
11
12
13   1. Routing and Filtering
14      1.1 Introduction
15      1.2 Route Filters
16      1.3 The node_default filter
17      1.4 General route filtering
18      1.5 General filter rules
19      1.6 Types of filter
20      1.7 Filter options
21      1.8 Default filters
22      1.9 Advanced filtering
23      1.10 Basic hop control
24      1.11 Hop Control on Specific Nodes
25      1.12 Isolating networks
26      1.13 A DXSpider Filtering Tutorial
27
28   2. Other filters
29      2.1 Filtering Mail
30      2.2 Filtering words from text fields in Announce, Talk and DX spots
31      2.3 Stopping (possibly bad) DX Spots from Nodes or Spotters
32
33   3. Mail
34      3.1 Personal mail
35      3.2 Bulletin mail
36      3.3 Forward.pl
37      3.4 The msg command
38      3.5 Message status
39      3.6 Filtering mail
40      3.7 Distribution lists
41      3.8 BBS interface
42
43   4. Scripts
44   5. Databases
45      5.1 Creating databases
46      5.2 Importing databases
47      5.3 Checking available databases
48      5.4 Looking up databases
49      5.5 Removing databases
50
51   6. Information, files and useful programs
52      6.1 MOTD
53      6.2 MOTD_NOR
54      6.3 Downtime message
55      6.4 Other text messages
56      6.5 The Aliases file
57      6.6 Console.pl
58      6.7 Updating kepler data
59      6.8 The QRZ callbook
60      6.9 Connecting logging programs
61
62   7. Java Web applet
63   8. Web based statistics
64   9. Security
65      9.1 Registration
66      9.2 Passwords
67
68   10. CVS
69      10.1 CVS from a Linux platform
70      10.2 CVS from a Windows platform
71
72   11. The DXSpider Command Reference
73      11.1 accept (0)
74      11.2 accept/announce <call> [input] [0-9] <pattern> (8)
75      11.3 accept/announce [0-9] <pattern> (0)
76      11.4 accept/route <call> [0-9] <pattern> (8)
77      11.5 accept/spots <call> [input] [0-9] <pattern> (8)
78      11.6 accept/spots [0-9] <pattern> (0)
79      11.7 accept/wcy <call> [input] [0-9] <pattern> (8)
80      11.8 accept/wcy [0-9] <pattern> (0)
81      11.9 accept/wwv <call> [input] [0-9] <pattern> (8)
82      11.10 accept/wwv [0-9] <pattern> (0)
83      11.11 announce <text> (0)
84      11.12 announce full <text> (0)
85      11.13 announce sysop <text> (5)
86      11.14 apropos <string> (0)
87      11.15 blank [<string>] [<nn>] (0)
88      11.16 bye (0)
89      11.17 catchup <node call> all|[<msgno> ...] (5)
90      11.18 chat <group> <text> (0)
91      11.19 clear/announce <callsign> [input] [0-9|all] (8)
92      11.20 clear/announce [1|all] (0)
93      11.21 clear/route <callsign> [input] [0-9|all] (8)
94      11.22 clear/route [1|all] (0)
95      11.23 clear/spots <callsign> [input] [0-9|all] (8)
96      11.24 clear/spots [0-9|all] (0)
97      11.25 clear/wcy <callsign> [input] [0-9|all] (8)
98      11.26 clear/wcy [1|all] (0)
99      11.27 clear/wwv <callsign> [input] [0-9|all] (8)
100      11.28 clear/wwv [1|all] (0)
101      11.29 connect <callsign> (5)
102      11.30 dbavail (0)
103      11.31 dbcreate <name> (9)
104      11.32 dbcreate <name> chain <name> [<name>..] (9)
105      11.33 dbcreate <name> cmd <dxspider command> (9)
106      11.34 dbcreate <name> remote <node> (9)
107      11.35 dbimport <dbname> <filename> (9)
108      11.36 dbremove <dbname> (9)
109      11.37 dbshow <dbname> <key> (0)
110      11.38 debug (9)
111      11.39 delete/usdb <callsign> ... (9)
112      11.40 delete/user <callsign> ... (9)
113      11.41 demonstrate <call> <command> (9)
114      11.42 directory (0)
115      11.43 directory <from>-<to> (0)
116      11.44 directory <nn> (0)
117      11.45 directory all (0)
118      11.46 directory from <call> (0)
119      11.47 directory new (0)
120      11.48 directory own (0)
121      11.49 directory subject <string> (0)
122      11.50 directory to <call> (0)
123      11.51 directory- (5)
124      11.52 disconnect <call> [<call> ...] (8)
125      11.53 dx [by <call>] <freq> <call> <remarks> (0)
126      11.54 echo <line> (0)
127      11.55 export <msgno> <filename> (9)
128      11.56 export_users [<filename>] (9)
129      11.57 filtering... (0)
130      11.58 forward/latlong <node_call> (8)
131      11.59 forward/opernam <call> (1)
132      11.60 help (0)
133      11.61 init <node> (5)
134      11.62 join <group> (0)
135      11.63 kill (5)
136      11.64 kill <from msgno>-<to msgno> (0)
137      11.65 kill <from>-<to> (5)
138      11.66 kill <msgno> [<msgno..] (0)
139      11.67 kill <msgno> [<msgno> ...] (0)
140      11.68 kill expunge <msgno> [<msgno..] (6)
141      11.69 kill from <call> (5)
142      11.70 kill full <msgno> [<msgno..] (5)
143      11.71 kill full <msgno> [<msgno] (5)
144      11.72 kill to <call> (5)
145      11.73 kill from <regex> (0)
146      11.74 kill to <regex> (0)
147      11.75 leave <group> (0)
148      11.76 links (0)
149      11.77 load/aliases (9)
150      11.78 load/badmsg (9)
151      11.79 load/badwords (9)
152      11.80 load/bands (9)
153      11.81 load/cmd_cache (9)
154      11.82 load/forward (9)
155      11.83 load/keps (5)
156      11.84 load/keps [nn] (5)
157      11.85 load/messages (9)
158      11.86 load/prefixes (9)
159      11.87 merge <node> [<no spots>/<no wwv>] (5)
160      11.88 msg <cmd> <msgno> [data ... ] (9)
161      11.89 pc <call> <text> (8)
162      11.90 ping <node call> (1)
163      11.91 rcmd <node call> <cmd> (1)
164      11.92 read (0)
165      11.93 read <msgno> (0)
166      11.94 read- (5)
167      11.95 reject (0)
168      11.96 reject/announce <call> [input] [0-9] <pattern> (8)
169      11.97 reject/announce [0-9] <pattern> (0)
170      11.98 reject/route <call> [0-9] <pattern> (8)
171      11.99 reject/spots <call> [input] [0-9] <pattern> (8)
172      11.100 reject/spots [0-9] <pattern> (0)
173      11.101 reject/wcy <call> [input] [0-9] <pattern> (8)
174      11.102 reject/wcy [0-9] <pattern> (0)
175      11.103 reject/wwv <call> [input] [0-9] <pattern> (8)
176      11.104 reject/wwv [0-9] <pattern> (0)
177      11.105 reply (0)
178      11.106 reply <msgno> (0)
179      11.107 reply b <msgno> (0)
180      11.108 reply noprivate <msgno> (0)
181      11.109 reply rr <msgno> (0)
182      11.110 save [-d -t -a] <filename> "<cmd>" [...] (9)
183      11.111 send <call> [<call> ...] (0)
184      11.112 send copy <msgno> <call> (0)
185      11.113 send noprivate <call> (0)
186      11.114 send private <call> (0)
187      11.115 send rr <call> (0)
188      11.116 set/address <your address> (0)
189      11.117 set/announce (0)
190      11.118 set/anntalk (0)
191      11.119 set/arcluster <call> [<call>..] (5)
192      11.120 set/baddx <call>.. (8)
193      11.121 set/badnode <call>.. (8)
194      11.122 set/badspotter <call>.. (8)
195      11.123 set/badword <word>.. (8)
196      11.124 set/bbs <call> [<call>..] (5)
197      11.125 set/beep (0)
198      11.126 set/clx <call> [<call>..] (5)
199      11.127 set/debug <name> (9)
200      11.128 set/dx (0)
201      11.129 set/dxcq (0)
202      11.130 set/dxgrid (0)
203      11.131 set/dxitu (0)
204      11.132 set/dxnet <call> [<call>..] (5)
205      11.133 set/echo (0)
206      11.134 set/email <email> ... (0)
207      11.135 set/here (0)
208      11.136 set/homenode <node>  (0)
209      11.137 set/hops <call> ann|spots|route|wwv|wcy <n> (8)
210      11.138 set/isolate (9)
211      11.139 set/language <lang> (0)
212      11.140 set/location <lat & long> (0)
213      11.141 set/lockout <call> (9)
214      11.142 set/logininfo (0)
215      11.143 set/name <your name> (0)
216      11.144 set/node <call> [<call>..] (5)
217      11.145 set/obscount <count> <call> (8)
218      11.146 set/page <lines per page> (0)
219      11.147 set/password (0)
220      11.148 set/password <callsign> <string> (9)
221      11.149 set/pinginterval <time> <nodecall> (9)
222      11.150 set/privilege <n> <call> [<call..] (9)
223      11.151 set/prompt <string> (0)
224      11.152 set/qra <locator> (0)
225      11.153 set/qth <your qth> (0)
226      11.154 set/register <call> ... (9)
227      11.155 set/spider <call> [<call>..] (5)
228      11.156 set/sys_location <lat & long> (9)
229      11.157 set/sys_qra <locator> (9)
230      11.158 set/talk (0)
231      11.159 set/usdb <call> <state> <city> (9)
232      11.160 set/usstate (0)
233      11.161 set/wcy (0)
234      11.162 set/wwv (0)
235      11.163 set/wx (0)
236      11.164 show/baddx (1)
237      11.165 show/badnode (1)
238      11.166 show/badspotter (1)
239      11.167 show/badword (1)
240      11.168 show/chat [<group>] [<lines>] (0)
241      11.169 show/configuration [<node>] (0)
242      11.170 show/configuration/node (0)
243      11.171 show/connect (1)
244      11.172 show/contest <year and month> (0)
245      11.173 show/date [<prefix>|<callsign>] (0)
246      11.174 show/db0sdx <callsign> (0)
247      11.175 show/debug (9)
248      11.176 show/dx (0)
249      11.177 show/dxcc <prefix> (0)
250      11.178 show/dxqsl <callsign> (0)
251      11.179 show/dxstats [days] [date] (0)
252      11.180 show/files [<filearea> [<string>]] (0)
253      11.181 show/filter (0)
254      11.182 show/hfstats [days] [date] (0)
255      11.183 show/hftable [days] [date] [prefix ...] (0)
256      11.184 show/hops <call> [ann|spots|route|wcy|wwv] (8)
257      11.185 show/isolate (1)
258      11.186 show/lockout <prefix>|all (9)
259      11.187 show/log [<callsign>] (8)
260      11.188 show/moon [ndays] [<prefix>|<callsign>] (0)
261      11.189 show/muf <prefix> [<hours>][long] (0)
262      11.190 show/newconfiguration [<node>] (0)
263      11.191 show/newconfiguration/node (0)
264      11.192 show/node [<callsign> ...] (1)
265      11.193 show/prefix <callsign> (0)
266      11.194 show/program (5)
267      11.195 show/qra <lat> <long> (0)
268      11.196 show/qra <locator> [<locator>] (0)
269      11.197 show/qrz <callsign> (0)
270      11.198 show/registered [<prefix>] (9)
271      11.199 show/route <callsign> ... (0)
272      11.200 show/satellite <name> [<hours> <interval>] (0)
273      11.201 show/station all [<regex>] (6)
274      11.202 show/station [<callsign> ..] (0)
275      11.203 show/sun [ndays] [<prefix>|<callsign>] (0)
276      11.204 show/time [<prefix>|<callsign>] (0)
277      11.205 show/usdb [call ..] (0)
278      11.206 show/vhfstats [days] [date] (0)
279      11.207 show/vhftable [days] [date] [prefix ...] (0)
280      11.208 show/wcy (0)
281      11.209 show/wcy <n> (0)
282      11.210 show/wm7d <callsign> (0)
283      11.211 show/wwv (0)
284      11.212 show/wwv <n> (0)
285      11.213 shutdown (5)
286      11.214 spoof <call> <command> (9)
287      11.215 stat/channel [<callsign>] (5)
288      11.216 stat/db <dbname> (5)
289      11.217 stat/msg (1)
290      11.218 stat/msg <msgno> (1)
291      11.219 stat/route_node <callsign> (5)
292      11.220 stat/route_node all (5)
293      11.221 stat/route_user <callsign> (5)
294      11.222 stat/route_user all (5)
295      11.223 stat/user [<callsign>] (5)
296      11.224 sysop (0)
297      11.225 talk <call> > <node> [<text>] (0)
298      11.226 talk <call> [<text>] (0)
299      11.227 type <filearea>/<name> (0)
300      11.228 uncatchup <node call> all|[msgno> ...] (5)
301      11.229 unset/announce (0)
302      11.230 unset/anntalk (0)
303      11.231 unset/baddx <call>.. (8)
304      11.232 unset/badnode <call>.. (8)
305      11.233 unset/badspotter <call>.. (8)
306      11.234 unset/badword <word>.. (8)
307      11.235 unset/beep (0)
308      11.236 unset/debug <name> (9)
309      11.237 unset/dx (0)
310      11.238 unset/dxcq (0)
311      11.239 unset/dxgrid (0)
312      11.240 unset/dxitu (0)
313      11.241 unset/echo (0)
314      11.242 unset/email (0)
315      11.243 unset/here (0)
316      11.244 unset/hops <call> ann|spots|route|wwv|wcy (8)
317      11.245 unset/isolate (9)
318      11.246 unset/lockout <call> (9)
319      11.247 unset/logininfo (0)
320      11.248 unset/password <call> ... (9)
321      11.249 unset/privilege (0)
322      11.250 unset/prompt (0)
323      11.251 unset/register <call> ... (9)
324      11.252 unset/talk (0)
325      11.253 unset/usstate (0)
326      11.254 unset/wcy (0)
327      11.255 unset/wwv (0)
328      11.256 unset/wx (0)
329      11.257 who (0)
330      11.258 wx <text> (0)
331      11.259 wx full <text> (0)
332      11.260 wx sysop <text> (5)
333
334
335   ______________________________________________________________________
336
337   \e[1m1.  Routing and Filtering\e[0m
338
339   \e[1m1.1.  Introduction\e[0m
340
341   From DXSpider version 1.48, major changes were introduced to the way
342   node connections are treated.  This is part of an ongoing process to
343   remove problems with loops and to enable talk and other functions to
344   propagate across the whole of the worldwide cluster network.  In fact,
345   in a Spider network, it would be useful, perhaps even necessary to
346   have loops.  This would give real resilience to the network, meaning
347   that if a link dropped, the information flow would simply come in and
348   go out via a different route.  Of course, we do not have a complete
349   network of Spider nodes, there are other programs out there.  Some of
350   these do not have any protection from loops.  Certainly AK1A does not
351   handle loops well at all.  It is therefore necessary to have some form
352   of protection for these nodes.
353
354
355   In fact DXSpider has had a simple system for some time which is called
356   \e[4misolation\e[24m. This is similar to what in other systems such as \e[1mclx\e[22m, is
357   called \e[4mpassive\e[24m \e[4mmode\e[24m. A more detailed explanation of \e[4misolation\e[24m is given
358   further below. This system is still available and, for simple
359   networks, is probably all that you need.
360
361
362   The new functionality introduced in version 1.48 allows filtering the
363   node and user protocol frames on a "per interface" basis. We call this
364   \e[4mroute\e[24m \e[4mfiltering\e[24m. This is used \e[1minstead of \e[4m\e[22misolation\e[24m.
365
366
367   What this really means is that you can control more or less completely
368   which user and node management PC protocol frames pass to each of your
369   partner nodes. You can also limit what comes into your node from your
370   partners. It is even possible to control the settings that your
371   partner node has for the routing information that it sends to you
372   (using the \e[4mrcmd\e[24m command).
373
374
375   \e[1m1.2.  Route Filters\e[0m
376
377   Initially when route filters were being tested we generated a
378   "default" filter.  Unfortunately it quickly became apparent that this
379   might suit the UK cluster network but didn't really fit anybody else.
380   However using a default filter is an appropriate thing to do. How, is
381   explained further on.
382
383
384   The first thing that you must do is determine whether you need to use
385   route filtering \e[1mat all\e[22m. If you are a "normal" node with two or three
386   partners and you arranged in an "official" non-looping tree type
387   network, then \e[1myou do not need to do route filtering \e[22mand you will feel
388   a lot better for not getting involved. If you are successfully using
389   \e[4misolation\e[24m then you also probably don't need to use route filtering.
390
391
392   To put it simply, you should not mix Isolation and Route Filtering.
393   It will work, of sorts, but you will not get the expected results.  If
394   you are using Isolation sucessfully at the moment, do not get involved
395   in Route Filtering unless you have a good supply of aspirin!  Once you
396   have started down the road of Route Filtering, do not use Isolation
397   either.  Use one or the other, not both.
398
399
400   You will only require this functionality if you are "well-connected".
401   What that means is that you are connected to several different parts
402   of (say) the EU cluster and, at the same time, also connected to two
403   or three places in the US which, in turn are connected back to the EU.
404   This is called a "loop" and if you are seriously looped then you need
405   filtering.
406
407
408
409   I should at this stage give a little bit of background on filters.
410   All the filters in Spider work in basically the same way.  You can
411   either accept or reject various options in order to create the filter
412   rules you wish to achieve.  Some filters are user settable, others can
413   only be altered by the sysop.  Route filtering can only be done by the
414   sysop.
415
416
417
418   Anyway, without further discouragement, let me start the process of
419   explanation.
420
421
422   \e[1m1.3.  The node_default filter\e[0m
423
424   All normal systems should have a default routing filter and it should
425   usually be set to send only the normal, unlooped, view of your
426   "national" network.  Here in the UK that means nodes from the UK and
427   Eire, in EU it is more complex as the networks there grew up in a more
428   intertwined way.
429
430
431
432   The generic commands are:-
433
434
435
436        reject/route node_default <filter_option>
437
438        or
439
440        accept/route node_default <filter_option>
441
442
443
444   where filter_option is one of the following ...
445
446
447
448        call <prefixes>
449        call_dxcc <numbers>
450        call_itu <numbers>
451        call_zone <numbers>
452        channel <prefixes>
453        channel_dxcc <numbers>
454        channel_itu <numbers>
455        channel_zone <numbers>
456
457
458
459   Please be careful if you alter this setting, it will affect \e[4mALL\e[24m your
460   links!  Remember, this is a \e[4mdefault\e[24m filter for node connections, not a
461   \e[4mper\e[24m \e[4mlink\e[24m default.
462
463
464   For the default routing filter then you have two real choices: either
465   a "national" view or the "safe" option of only your own callsign.
466   Examples of each (for my node: GB7DJK) are:-
467
468
469
470        acc/route node_default call_dxcc 61,38
471        acc/route node_default call gb7djk
472
473   GB7DJK uses the first of these. The DXCC countries can be obtained
474   from the \e[4mshow/prefix\e[24m command.
475
476
477   The example filters shown control \e[4moutput\e[24m \e[1mTO \e[22mall your partner nodes
478   unless they have a specific filter applied to them (see next section).
479
480
481   It is also possible to control the \e[4mincoming\e[24m routing information that
482   you are prepared to accept \e[1mFROM \e[22myour partner nodes. The reason this is
483   necessary is to make sure that stuff like mail, pings and similar
484   commands a) go down the correct links and b) don't loop around
485   excessively. Again using GB7DJK as an example a typical default input
486   filter would be something like:
487
488
489
490        rej/route node_default input call_dxcc 61,38 and not channel_dxcc 61,38
491
492
493
494   What this does is accept node and user information for our national
495   network from nodes that are in our national network, but rejects such
496   information from anyone else. Although it doesn't explicitly say so,
497   by implication, any other node information (not from the UK and Eire)
498   is accepted.
499
500
501   As I imagine it will take a little while to get one's head around all
502   of this you can study the effect of any rules that you try by watching
503   the debug output after having done:-
504
505
506
507        set/debug filter
508
509
510
511   After you have got tired of that, to put it back the way it was:-
512
513
514
515        unset/debug filter
516
517
518
519   \e[1m1.4.  General route filtering\e[0m
520
521   Exactly the same rules apply for general route filtering.  You would
522   use either an accept filter or a reject filter like this ...
523
524
525
526        reject/route <node_call> <filter_option>
527
528        or
529
530        accept/route <node_call> <filter_option>
531
532
533
534   Here are some examples of route filters ...
535
536
537
538        rej/route gb7djk call_dxcc 61,38 (send everything except UK+EIRE nodes)
539        rej/route all                    (equiv to [very] restricted mode)
540        acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)
541        acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
542
543
544
545   In practice you will either be opening the default filter out for a
546   partner by defining a specific filter for that callsign:-
547
548
549
550        acc/route gb7baa all
551        acc/route gb7baa input all
552
553
554
555   or restricting it quite a lot, in fact making it very nearly like an
556   \e[4misolated\e[24m node, like this:-
557
558
559
560        acc/route pi4ehv-8 call gb7djk
561        rej/route pi4ehv-8 input call_dxcc 61,38
562
563
564
565   This last example takes everything except UK and Eire from PI4EHV-8
566   but only sends him my local configuration (just a PC19 for GB7DJK and
567   PC16s for my local users).
568
569
570   It is possible to write \e[1mmuch \e[22mmore complex rules, there are up to 10
571   accept/reject pairs per callsign per filter. For more information see
572   the next section.
573
574
575
576   \e[1m1.5.  General filter rules\e[0m
577
578   Upto v1.44 it was not possible for the user to set their own filters.
579   From v1.45 though that has all changed.  It is now possible to set
580   filters for just about anything you wish.  If you have just updated
581   from an older version of DXSpider you will need to update your new
582   filters.  You do not need to do anything with your old filters, they
583   will be renamed as you update.
584
585
586   There are 3 basic commands involved in setting and manipulating
587   filters.  These are \e[4maccept\e[24m, \e[4mreject\e[24m and \e[4mclear\e[24m.  First we will look
588   generally at filtering. There are a number of things you can filter in
589   the DXSpider system. They all use the same general mechanism.
590
591
592   In general terms you can create a "reject" or an "accept" filter which
593   can have up to 10 lines in it. You do this using, for example ...
594
595
596
597   accept/spots .....
598   reject/spots .....
599
600
601
602   where ..... are the specific commands for that type of filter. There
603   are filters for spots, wwv, announce, wcy and (for sysops) connects.
604   See each different accept or reject command reference for more
605   details.
606
607   There is also a command to clear out one or more lines in a filter.
608   They are ...
609
610
611
612        clear/spots 1
613        clear/spots all
614
615
616
617   There is clear/xxxx command for each type of filter.
618
619
620   and you can check that your filters have worked by the command ...
621
622
623
624        show/filter
625
626
627
628   For now we are going to use spots for the examples, but you can apply
629   the same principles to all types of filter.
630
631
632   \e[1m1.6.  Types of filter\e[0m
633
634   There are two main types of filter, \e[4maccept\e[24m or \e[4mreject\e[24m.  You can use
635   either to achieve the result you want dependent on your own preference
636   and which is more simple to do.  It is pointless writing 8 lines of
637   reject filters when 1 accept filter would do the same thing!  Each
638   filter has 10 lines (of any length) which are tried in order.  If a
639   line matches then the action you have specified is taken (ie reject
640   means ignore it and accept means take it)
641
642
643   If you specify reject filters, then any lines that arrive that match
644   the filter will be dumped but all else will be accepted.  If you use
645   an accept filter, then ONLY the lines in the filter will be accepted
646   and all else will be dumped.  For example if you have a single line
647   \e[4maccept\e[24m filter ...
648
649
650
651        accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
652
653
654
655   then you will \e[4mONLY\e[24m get VHF spots \e[4mfrom\e[24m or \e[4mto\e[24m CQ zones 14, 15 and 16.
656
657   If you set a reject filter like this ...
658
659
660
661        reject/spots on hf/cw
662
663
664
665   Then you will get everything \e[4mEXCEPT\e[24m HF CW spots.  You could make this
666   single filter even more flexible.  For example, if you are interested
667   in IOTA and will work it even on CW even though normally you are not
668   interested in CW, then you could say ...
669
670
671
672        reject/spots on hf/cw and not info iota
673
674
675
676   But in that case you might only be interested in iota and say:-
677
678
679
680        accept/spots not on hf/cw or info iota
681
682
683
684   which achieves exactly the same thing. You should choose one or the
685   other until you are comfortable with the way it works. You can mix
686   them if you wish (actually you can have an accept AND a reject on the
687   same line) but don't attempt this until you are sure you know what you
688   are doing!
689
690
691   You can arrange your filter lines into logical units, either for your
692   own understanding or simply convenience. Here is an example ...
693
694
695
696        reject/spots 1 on hf/cw
697        reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)
698
699
700
701   What this does is to ignore all HF CW spots and also rejects any spots
702   on VHF which don't either originate or spot someone in Europe.
703
704
705   This is an example where you would use a line number (1 and 2 in this
706   case), if you leave the digit out, the system assumes '1'. Digits
707   '0'-'9' are available.  This make it easier to see just what filters
708   you have set.  It also makes it more simple to remove individual
709   filters, during a contest for example.
710
711
712   You will notice in the above example that the second line has
713   brackets.  Look at the line logically.  You can see there are 2
714   separate sections to it.  We are saying reject spots that are VHF or
715   above \e[4mAPART\e[24m from those in zones 14, 15 and 16 (either spotted there or
716   originated there).  If you did not have the brackets to separate the 2
717   sections, then Spider would read it logically from the front and see a
718   different expression entirely ...
719        (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16
720
721
722
723   The simple way to remember this is, if you use OR - use brackets.
724   Whilst we are here CASE is not important. 'And BY_Zone' is just the
725   same as 'and by_zone'.
726
727   As mentioned earlier, setting several filters can be more flexible
728   than simply setting one complex one.  Doing it in this way means that
729   if you want to alter your filter you can just redefine or remove one
730   or more lines of it or one line. For example ...
731
732
733
734        reject/spots 1 on hf/ssb
735
736
737
738   would redefine our earlier example, or
739
740
741
742        clear/spots 1
743
744
745
746   To remove all the filter lines in the spot filter ...
747
748
749
750        clear/spots all
751
752
753
754   \e[1m1.7.  Filter options\e[0m
755
756   You can filter in several different ways.  The options are listed in
757   the various helpfiles for accept, reject and filter.
758
759
760   \e[1m1.8.  Default filters\e[0m
761
762   Sometimes all that is needed is a general rule for node connects.
763   This can be done with a node_default filter.  This rule will always be
764   followed, even if the link is isolated, unless another filter is set
765   specifically.  Default rules can be set for nodes and users.  They can
766   be set for spots, announces, WWV and WCY.  They can also be used for
767   hops.  An example might look like this ...
768
769
770
771        accept/spot node_default by_zone 14,15,16,20,33
772        set/hops node_default spot 50
773
774
775
776   This filter is for spots only, you could set others for announce, WWV
777   and WCY.  This filter would work for ALL nodes unless a specific
778   filter is written to override it for a particular node.  You can also
779   set a user_default should you require.  It is important to note that
780   default filters should be considered to be "connected".  By this I
781   mean that should you override the default filter for spots, you need
782   to add a rule for the hops for spots also.
783
784
785   \e[1m1.9.  Advanced filtering\e[0m
786
787   Once you are happy with the results you get, you may like to
788   experiment.
789
790
791   The previous example that filters hf/cw spots and accepts vhf/uhf
792   spots from EU can be written with a mixed filter, for example ...
793
794
795
796        rej/spot on hf/cw
797        acc/spot on 0/30000
798        acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
799
800
801
802   Note that the first filter has not been specified with a number.  This
803   will automatically be assumed to be number 1.  In this case, we have
804   said \e[4mreject\e[24m \e[4mall\e[24m \e[4mHF\e[24m \e[4mspots\e[24m \e[4min\e[24m \e[4mthe\e[24m \e[4mCW\e[24m \e[4msection\e[24m \e[4mof\e[24m \e[4mthe\e[24m \e[4mbands\e[24m \e[4mbut\e[24m \e[4maccept\e[24m \e[4mall\e[0m
805   \e[4mothers\e[24m \e[4mat\e[24m \e[4mHF.\e[24m  \e[4mAlso\e[24m \e[4maccept\e[24m \e[4manything\e[24m \e[4min\e[24m \e[4mVHF\e[24m \e[4mand\e[24m \e[4mabove\e[24m \e[4mspotted\e[24m \e[4min\e[24m \e[4mor\e[24m \e[4mby\e[0m
806   \e[4moperators\e[24m \e[4min\e[24m \e[4mthe\e[24m \e[4mzones\e[24m \e[4m14,\e[24m \e[4m15\e[24m \e[4mand\e[24m \e[4m16\e[24m.  Each filter slot actually has a
807   'reject' slot and an 'accept' slot. The reject slot is executed BEFORE
808   the accept slot.
809
810
811   It was mentioned earlier that after a reject test that doesn't match,
812   the default for following tests is 'accept', the reverse is true for
813   'accept'. In the example what happens is that the reject is executed
814   first, any non hf/cw spot is passed to the accept line, which lets
815   through everything else on HF.  The next filter line lets through just
816   VHF/UHF spots from EU.
817
818
819   \e[1m1.10.  Basic hop control\e[0m
820
821   In /spider/data you will find a file called hop_table.pl.  This is the
822   file that controls your hop count settings.  It has a set of default
823   hops on the various PC frames and also a set for each node you want to
824   alter the hops for.  You may be happy with the default settings of
825   course, but this powerful tool can help to protect and improve the
826   network.  The file will look something like this ...
827
828
829
830   #
831   # hop table construction
832   #
833
834   package DXProt;
835
836   # default hopcount to use
837   $def_hopcount = 5;
838
839   # some variable hop counts based on message type
840   %hopcount =
841   (
842    11 => 10,
843    16 => 10,
844    17 => 10,
845    19 => 10,
846    21 => 10,
847   );
848
849
850   # the per node hop control thingy
851
852
853   %nodehops =
854   (
855    GB7ADX => {            11 => 8,
856                           12 => 8,
857                           16 => 8,
858                           17 => 8,
859                           19 => 8,
860                           21 => 8,
861                      },
862
863    GB7UDX => {            11 => 8,
864                           12 => 8,
865                           16 => 8,
866                           17 => 8,
867                           19 => 8,
868                           21 => 8,
869                      },
870    GB7BAA => {
871                           11 => 5,
872                           12 => 8,
873                           16 => 8,
874                           17 => 8,
875                           19 => 8,
876                           21 => 8,
877                      },
878   );
879
880
881
882   Each set of hops is contained within a pair of curly braces and
883   contains a series of PC frame types.  PC11 for example is a DX spot.
884   The figures here are not exhaustive but should give you a good idea of
885   how the file works.
886
887
888   SHould any of the nodecalls include an ssid, it is important to wrap
889   the whole call in single quotes, like this ...
890
891
892
893    'DB0FHF-15' => {
894                           11 => 5,
895                           12 => 8,
896                           16 => 8,
897                           17 => 8,
898                           19 => 8,
899                           21 => 8,
900                      },
901
902
903
904   If you do not do this, you will get errors and the file will not work
905   as expected.
906
907
908   You can alter this file at any time, including whilst the cluster is
909   running.  If you alter the file during runtime, the command \e[4mload/hops\e[0m
910   will bring your changes into effect.
911
912
913   \e[1m1.11.  Hop Control on Specific Nodes\e[0m
914
915   You can set a callsign specific hop count for any of the standard
916   filter options so:-
917
918
919
920        set/hops gb7djk spot 4
921        set/hops node_default route 10
922        set/hops gb7baa wcy 5
923
924
925
926   all work on their specific area of the protocol.
927
928
929   The \e[4mset/hops\e[24m command overrides any hops that you have set otherwise.
930
931
932   You can show what hops have been set using the \e[4mshow/hops\e[24m command.
933
934
935   \e[1m1.12.  Isolating networks\e[0m
936
937   It is possible to isolate networks from each other on a "gateway" node
938   using the \e[4mset/isolate\e[24m \e[4m<node_call>\e[24m command.
939
940
941   The effect of this is to partition an isolated network completely from
942   another node connected to your node. Your node will appear on and
943   otherwise behave normally on every network to which you are connected,
944   but data from an isolated network will not cross onto any other
945   network or vice versa. However all the spot, announce and WWV traffic
946   and personal messages will still be handled locally (because you are a
947   real node on all connected networks), that is locally connected users
948   will appear on all networks and will be able to access and receive
949   information from all networks transparently.  All routed messages will
950   be sent as normal, so if a user on one network knows that you are a
951   gateway for another network, he can still still send a talk/announce
952   etc message via your node and it will be routed across.
953
954
955   If you use isolate on a node connection you will continue to receive
956   all information from the isolated partner, however you will not pass
957   any information back to the isolated node.  There are times when you
958   would like to forward only spots across a link (maybe during a contest
959   for example).  To do this, isolate the node in the normal way and use
960   an \e[4macc/spot\e[24m \e[4m>call<\e[24m \e[4mall\e[24m filter to override the isolate.
961
962
963   \e[1m1.13.  A DXSpider Filtering Tutorial\e[0m
964
965   There is now an excellent primer/tutorial on filtering written by Jim
966   Samuels, W3BG with an introduction by Dave Hawes N3RD that I strongly
967   suggest you read.  You can read it here The DXSpider User Filtering
968   Primer
969
970
971   \e[1m2.  Other filters\e[0m
972
973   \e[1m2.1.  Filtering Mail\e[0m
974
975   In the /spider/msg directory you will find a file called
976   badmsg.pl.issue.  Rename this to badmsg.pl and edit the file.  The
977   original looks something like this ....
978
979
980
981        # the list of regexes for messages that we won't store having
982        # received them (bear in mind that we must receive them fully before
983        # we can bin them)
984
985
986        # The format of each line is as follows
987
988        #     type      source             pattern
989        #     P/B/F     T/F/O/S            regex
990
991        # type: P - private, B - bulletin (msg), F - file (ak1a bull)
992        # source: T - to field, F - from field,  O - origin, S - subject
993        # pattern: a perl regex on the field requested
994
995        # Currently only type B and P msgs are affected by this code.
996        #
997        # The list is read from the top down, the first pattern that matches
998        # causes the action to be taken.
999
1000        # The pattern can be undef or 0 in which case it will always be selected
1001        # for the action specified
1002
1003
1004
1005        package DXMsg;
1006
1007        @badmsg = (
1008        );
1009
1010
1011
1012   I think this is fairly self explanatory.  It is simply a list of
1013   subject headers that we do not want to pass on to either the users of
1014   the cluster or the other cluster nodes that we are linked to.  This is
1015   usually because of rules and regulations pertaining to items for sale
1016   etc in a particular country.
1017
1018
1019
1020   \e[1m2.2.  Filtering words from text fields in Announce, Talk and DX spots\e[0m
1021
1022   From version 1.48 onwards the interface to this has changed. You can
1023   now use the commands \e[4mset/badword\e[24m to add words that you are not
1024   prepared to see on the cluster, \e[4munset/badword\e[24m to allow that word again
1025   and \e[4mshow/badword\e[24m to list the words that you have set.
1026
1027
1028   If you have a previous \e[4m/spider/data/badwords\e[24m, the first time you start
1029   the node, it will read and convert this file to the new commands. The
1030   old style file will then be removed.
1031
1032
1033   \e[1m2.3.  Stopping (possibly bad) DX Spots from Nodes or Spotters\e[0m
1034
1035
1036   There are a number of commands that control whether a spot progresses
1037   any further by regarding it as "bad" in some way.
1038
1039
1040   A DX Spot has a number of fields which can be checked to see whether
1041   they contain "bad" values, they are: the DX callsign itself, the
1042   Spotter and the Originating Node.
1043
1044
1045   There are a set of commands which allow the sysop to control whether a
1046   spot continues:-
1047
1048
1049
1050        set/baddx
1051        set/badspotter
1052        set/badnode
1053
1054
1055
1056   These work in the same as the \e[4mset/badword\e[24m command, you can add any
1057   words or callsigns or whatever to the appropriate database. For
1058   example, to stop a spot from a particular node you do:
1059
1060
1061
1062        set/badnode gb7djk gb7dxc
1063
1064
1065
1066   a bad spotter:
1067
1068
1069
1070        set/badspotter b0mb p1rat nocall
1071
1072
1073
1074   and some bad dx:
1075
1076
1077
1078        set/baddx video wsjt
1079
1080
1081
1082   You can remove a word using the appropriate unset command
1083   (\e[4munset/baddx,\e[24m \e[4munset/badspotter,\e[24m \e[4munset/badnode\e[24m) or list them using one
1084   of \e[4mshow/baddx,\e[24m \e[4mshow/badspotter\e[24m and \e[4mshow/badnode\e[24m.
1085
1086
1087   \e[1m3.  Mail\e[0m
1088
1089   DXSpider deals seamlessly with standard AK1A type mail.  It supports
1090   both personal and bulletin mail and the sysop has additional commands
1091   to ensure that mail gets to where it is meant.  DXSpider will send
1092   mail almost immediately, assuming that the target is on line.
1093   However, only one mail message is dealt with at any one time.  If a
1094   mail message is already being sent or recieved, then the new message
1095   will be queued until it has finished.
1096
1097   The cluster mail is automatically deleted after 30 days unless the
1098   sysop sets the "keep" flag using the \e[4mmsg\e[24m command.
1099
1100
1101   \e[1m3.1.  Personal mail\e[0m
1102
1103   Personal mail is sent using the \e[4msp\e[24m command.  This is actually the
1104   default method of sending mail and so a simple \e[4ms\e[24m for send will do.  A
1105   full list of the send commands and options is in the \e[4mcommand\e[24m \e[4mset\e[0m
1106   section, so I will not duplicate them here.
1107
1108
1109   \e[1m3.2.  Bulletin mail\e[0m
1110
1111   Bulletin mail is sent by using the \e[4msb\e[24m command.  This is one of the
1112   most common mistakes users make when sending mail.  They send a
1113   bulletin mail with \e[4ms\e[24m or \e[4msp\e[24m instead of \e[4msb\e[24m and of course the message
1114   never leaves the cluster.  This can be rectified by the sysop by using
1115   the \e[4mmsg\e[24m command.
1116
1117
1118   Bulletin addresses can be set using the Forward.pl file.
1119
1120
1121   \e[1m3.3.  Forward.pl\e[0m
1122
1123   DXSpider receives all and any mail sent to it without any alterations
1124   needed in files.  Because personal and bulletin mail are treated
1125   differently, there is no need for a list of accepted bulletin
1126   addresses.  It is necessary, however, to tell the program which links
1127   accept which bulletins.  For example, it is pointless sending
1128   bulletins addresses to "UK" to any links other than UK ones.  The file
1129   that does this is called forward.pl and lives in /spider/msg.  At
1130   default, like other spider files it is named forward.pl.issue.  Rename
1131   it to forward.pl and edit the file to match your requirements.  The
1132   format is below ...
1133
1134
1135
1136   #
1137   # this is an example message forwarding file for the system
1138   #
1139   # The format of each line is as follows
1140   #
1141   #     type    to/from/at pattern action  destinations
1142   #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
1143   #
1144   # type: P - private, B - bulletin (msg), F - file (ak1a bull)
1145   # to/from/at: T - to field, F - from field, A - home bbs, O - origin
1146   # pattern: a perl regex on the field requested
1147   # action: I - ignore, F - forward
1148   # destinations: a reference to an array containing node callsigns
1149   #
1150   # if it is non-private and isn't in here then it won't get forwarded
1151   #
1152   # Currently only type B msgs are affected by this code.
1153   #
1154   # The list is read from the top down, the first pattern that matches
1155   # causes the action to be taken.
1156   #
1157   # The pattern can be undef or 0 in which case it will always be selected
1158   # for the action specified
1159   #
1160   # If the BBS list is undef or 0 and the action is 'F' (and it matches the
1161   # pattern) then it will always be forwarded to every node that doesn't have
1162   # it (I strongly recommend you don't use this unless you REALLY mean it, if
1163   # you allow a new link with this on EVERY bull will be forwarded immediately
1164   # on first connection)
1165   #
1166
1167   package DXMsg;
1168
1169   @forward = (
1170   );
1171
1172
1173
1174   Simply insert a bulletin address and state in the brackets where you
1175   wish that mail to go.  For example, you can see here that mail sent to
1176   "UK" will only be sent to the UK links and not to PA4AB-14.
1177
1178
1179   To force the cluster to reread the file use load/forward
1180
1181
1182   NB: If a user tries to send mail to a bulletin address that does not
1183   exist in this file, they will get an error.
1184
1185
1186   \e[1m3.4.  The msg command\e[0m
1187
1188   The \e[4mmsg\e[24m command is a very powerful and flexible tool for the sysop.
1189   It allows the sysop to alter to and from fields and make other changes
1190   to manage the cluster mail.
1191
1192   Here is a full list of the various options ...
1193
1194
1195
1196     MSG TO <msgno> <call>     - change TO callsign to <call>
1197     MSG FRom <msgno> <call>   - change FROM callsign to <call>
1198     MSG PRrivate <msgno>      - set private flag
1199     MSG NOPRrivate <msgno>    - unset private flag
1200     MSG RR <msgno>            - set RR flag
1201     MSG NORR <msgno>          - unset RR flag
1202     MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
1203     MSG NOKEep <msgno>        - unset the keep flag
1204     MSG SUbject <msgno> <new> - change the subject to <new>
1205     MSG WAittime <msgno>      - remove any waiting time for this message
1206     MSG NOREad <msgno>        - mark message as unread
1207     MSG REad <msgno>          - mark message as read
1208     MSG QUeue                 - queue any outstanding bulletins
1209     MSG QUeue 1               - queue any outstanding private messages
1210
1211
1212
1213   These commands are simply typed from within the cluster as the sysop
1214   user.
1215
1216
1217   \e[1m3.5.  Message status\e[0m
1218
1219   You can check on a message from within the cluster by using the
1220   command \e[4mstat/msg\e[24m.  This will give you additional information on the
1221   message number including which nodes have received it, which node it
1222   was received from and when etc.  Here is an example of the output of
1223   the command ...
1224
1225
1226
1227        G0VGS de GB7MBC 28-Jan-2001 1308Z >
1228        stat/msg 6869
1229                From: GB7DJK
1230            Msg Time: 26-Jan-2001 1302Z
1231               Msgno: 6869
1232              Origin: GB7DJK
1233                Size: 8012
1234             Subject: AMSAT 2line KEPS 01025.AMSAT
1235                  To: UK
1236        Got it Nodes: GB7BAA, GB7ADX
1237             Private: 0
1238        Read Confirm: 0
1239          Times read: 0
1240        G0VGS de GB7MBC 28-Jan-2001 1308Z >
1241
1242
1243
1244   \e[1m3.6.  Filtering mail\e[0m
1245
1246   This is described in the section on \e[4mOther\e[24m \e[4mfilters\e[24m so I will not
1247   duplicate it here.
1248
1249
1250   \e[1m3.7.  Distribution lists\e[0m
1251
1252   Distribution lists are simply a list of users to send certain types of
1253   mail to.  An example of this is mail you only wish to send to other
1254   sysops.  In /spider/msg there is a directory called \e[4mdistro\e[24m.  You put
1255   any distibution lists in here.  For example, here is a file called
1256   SYSOP.pl that caters for the UK sysops.
1257
1258
1259        qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
1260           GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH
1261           GB7DXK GB7DXI GB7DXS)
1262
1263
1264
1265   Any mail sent to "sysop" would only be sent to the callsigns in this
1266   list.
1267
1268
1269   \e[1m3.8.  BBS interface\e[0m
1270
1271   Spider provides a simple BBS interface.  No input is required from the
1272   sysop of the cluster at all.  The BBS simply sets the cluster as a BBS
1273   and pushes any required mail to the cluster.  No mail can flow from
1274   Spider to the BBS, the interface is one-way.
1275
1276
1277   Please be careful not to flood the cluster network with unnecessary
1278   mail.  Make sure you only send mail to the clusters that want it by
1279   using the Forward.pl file very carefully.
1280
1281
1282   \e[1m4.  Scripts\e[0m
1283
1284   From 1.48 onwards it will become increasingly possible to control
1285   DXSpider's operation with scripts of various kinds.
1286
1287
1288   The directory /spider/scripts is where it all happens and is used for
1289   several things.  Firstly it contains a file called startup that can be
1290   used to call in any changes to the cluster from the default settings
1291   on startup.  This script is executed immediately after all
1292   initialisation of the node is done but before any connections are
1293   possible.  Examples of this include how many spots it is possible to
1294   get with the sh/dx command, whether you want registration/passwords to
1295   be permanently on etc.  An example file is shown below and is included
1296   in the distribution as startup.issue.
1297
1298
1299
1300        #
1301        # startup script example
1302        #
1303        # set maximum no of spots allowed to 100
1304        # set/var $Spot::maxspots = 100
1305        #
1306        # Set registration on
1307        # set/var $main::reqreg = 1
1308        #
1309        # Set passwords on
1310        # set/var $main::passwdreq = 1
1311        #
1312
1313
1314
1315   As usual, any text behind a # is treated as a comment and not read.
1316   To use this file, simply rename it from startup.issue to startup.  In
1317   our example above there are three options.  The first option is the
1318   amount of spots that a user can request with the \e[4msh/dx\e[24m command.
1319   Normally the default is to give 10 spots unless the user specifies
1320   more.  Without this line enabled, the maximum a user can request is
1321   100 spots.  Depending on your link quality you may wish to enable more
1322   or less by specifying the number.
1323
1324
1325   The other 2 options are dealt with more fully in the security section.
1326
1327
1328   Secondly, it is used to store the login scripts for users and nodes.
1329   Currently this can only be done by the sysop but it is envisaged that
1330   eventually users will be able to set their own.  An example is
1331   included in the distibution but here is a further example.
1332
1333
1334
1335        #
1336        # G0FYD
1337        #
1338        blank +
1339        sh/wwv 3
1340        blank +
1341        sh/dx
1342        blank +
1343        t g0jhc You abt?
1344        blank +
1345
1346
1347
1348   The lines in between commands can simply insert a blank line or a
1349   character such as a + sign to make the output easier to read.  Simply
1350   create this script with your favourite editor and save it with the
1351   callsign of the user as the filename.  Filenames should always be in
1352   lower case.
1353
1354
1355   Commands can be inserted in the same way for nodes.  A node may wish a
1356   series of commands to be issued on login, such as a merge command for
1357   example.
1358
1359
1360   Thirdly, there are 2 default scripts for users and nodes who do not
1361   have a specifically defined script.  These are \e[4muser_default\e[24m and
1362   \e[4mnode_default\e[0m
1363
1364
1365   \e[1m5.  Databases\e[0m
1366
1367   Spider allows the creation of local or remote databases.  It supports
1368   chained databases, allowing several different databases to be scanned
1369   with one simple command.  Importing of databases is limited at present
1370   to the standard AK1A databases such as OBLAST and the DB0SDX QSL
1371   database but will expand with time.
1372
1373
1374   \e[1m5.1.  Creating databases\e[0m
1375
1376   Creating a database could not be more simple.  All the commands are
1377   sent from the cluster prompt as the \e[4msysop\e[24m user.
1378
1379   To create a database you use the command \e[4mdbcreate\e[24m.  It can be used in
1380   3 different ways like so ..
1381
1382
1383
1384        dbcreate <name>
1385
1386
1387   To simply create a database locally, you just tell the command the
1388   name of the database.  This does not create the actual database, it
1389   simply defines it to say that it exists.
1390
1391
1392
1393        dbcreate <name> chain <name> [<name>...]
1394
1395
1396
1397   This creates a chained database entry.  The first database will be
1398   scanned, then the second, the third etc...
1399
1400
1401
1402        dbcreate <name> remote <name>
1403
1404
1405
1406   This creates a remote entry.  the first name field is the database
1407   name at the remote node, then the remote switch, then the actual
1408   node_call of the remote node, for example...
1409
1410
1411
1412        dbcreate buckmaster remote gb7dxc
1413
1414
1415
1416   Remote databases cannot be chained, however, the last database in a
1417   chain can be a remote database.
1418
1419
1420   \e[1m5.2.  Importing databases\e[0m
1421
1422   The only databases that Spider can currently import are the standard
1423   AK1A databases such as OBLAST or the DB0SDX qsl and address database.
1424   This will be added to with time.
1425
1426   To import such a database, first put the file somewhere useful like
1427   /tmp and then issue the following command ...
1428
1429
1430
1431        dbimport oblast /tmp/OBLAST.FUL
1432
1433
1434
1435   This will update the existing local oblast database or create it if it
1436   does not exist.
1437
1438
1439   \e[1m5.3.  Checking available databases\e[0m
1440
1441   Once a database is created, you will want to check that it has been
1442   added.  To do this use the \e[4mdbavail\e[24m command.  This will output the
1443   available databases.  For example ...
1444
1445
1446
1447   dbavail
1448   DB Name          Location   Chain
1449   qsl              Local
1450   buck             GB7ADX
1451   hftest           GB7DXM
1452   G0VGS de GB7MBC  3-Feb-2001 1925Z >
1453
1454
1455
1456   \e[1m5.4.  Looking up databases\e[0m
1457
1458   To look for information in a defined database, simply use the \e[4mdbshow\e[0m
1459   command, for example ...
1460
1461
1462
1463        dbshow buckmaster G0YLM
1464
1465
1466
1467   will show the information for the callsign G0YLM from the buckmaster
1468   database if it exists.  To make things more standard for the users you
1469   can add an entry in the Aliases file so that it looks like a standard
1470   \e[4mshow\e[24m command like this ...
1471
1472
1473
1474   Now you can simply use show/buckmaster or an abreviation.
1475
1476
1477   \e[1m5.5.  Removing databases\e[0m
1478
1479   To delete an existing database you use the \e[4mdbremove\e[24m command.  For
1480   example ...
1481
1482
1483
1484        dbremove oblast
1485
1486
1487
1488   would remove the oblast database and its associated datafile from the
1489   system.  There are no warnings or recovery possible from this command.
1490   If you remove a database it ceases to exist and would have to be
1491   created from scratch if you still required it.
1492
1493
1494   \e[1m6.  Information, files and useful programs\e[0m
1495
1496   \e[1m6.1.  MOTD\e[0m
1497
1498   One of the more important things a cluster sysop needs to do is to get
1499   information to his users.  The simplest way to do this is to have a
1500   banner that is sent to the user on login.  This is know as a "message
1501   of the day" or "motd".  To set this up, simply create a file in
1502   /spider/data called motd and edit it to say whatever you want.  It is
1503   purely a text file and will be sent automatically to anyone logging in
1504   to the cluster.
1505   \e[1m6.2.  MOTD_NOR\e[0m
1506
1507   This message of the day file lives in the same directory as the
1508   standard motd file but is only sent to non-registered users.  Once
1509   registered they will receive the same message as any other user.
1510
1511
1512   \e[1m6.3.  Downtime message\e[0m
1513
1514   If for any reason the cluster is down, maybe for upgrade or
1515   maintenance but the machine is still running, a message can be sent to
1516   the user advising them of the fact.  This message lives in the
1517   /spider/data directory and is called "offline".  Simply create the
1518   file and edit it to say whatever you wish.  This file will be sent to
1519   a user attempting to log into the cluster when DXSpider is not
1520   actually running.
1521
1522
1523   \e[1m6.4.  Other text messages\e[0m
1524
1525   You can set other text messages to be read by the user if they input
1526   the file name.  This could be for news items or maybe information for
1527   new users.  To set this up, make a directory under /spider called
1528   \e[4mpackclus\e[24m.  Under this directory you can create files called \e[4mnews\e[24m or
1529   \e[4mnewuser\e[24m for example.  In fact you can create files with any names you
1530   like.  These can be listed by the user with the command ....
1531
1532
1533
1534        show/files
1535
1536
1537
1538   They can be read by the user by typing the command ....
1539
1540
1541
1542        type news
1543
1544
1545
1546   If the file they want to read is called \e[4mnews\e[24m.  You could also set an
1547   alias for this in the Alias file to allow them just to type \e[4mnews\e[0m
1548
1549
1550   You can also store other information in this directory, either
1551   directly or nested under directories.  One use for this would be to
1552   store DX bulletins such as the OPDX bulletins.  These can be listed
1553   and read by the user.  To keep things tidy, make a directory under
1554   /spider/packclus called \e[4mbulletin\e[24m.  Now copy any OPDX or similar
1555   bulletins into it.  These can be listed by the user in the same way as
1556   above using the \e[4mshow/files\e[24m command with an extension for the bulletin
1557   directory you have just created, like this ....
1558
1559
1560
1561        show/files bulletin
1562
1563
1564
1565   An example would look like this ....
1566
1567        sh/files
1568        bulletin      DIR 20-Dec-1999 1715Z news          1602 14-Dec-1999 1330Z
1569
1570
1571
1572   You can see that in the files area (basically the packclus directory)
1573   there is a file called \e[4mnews\e[24m and a directory called \e[4mbulletin\e[24m.  You can
1574   also see that dates they were created.  In the case of the file \e[4mnews\e[24m,
1575   you can also see the time it was last modified, a good clue as to
1576   whether the file has been updated since you last read it.  To read the
1577   file called \e[4mnews\e[24m you would simply issue the command ....
1578
1579
1580
1581        type news
1582
1583
1584
1585   To look what is in the bulletin directory you issue the command ....
1586
1587
1588
1589        show/files bulletin
1590        opdx390      21381 29-Nov-1999 1621Z opdx390.1     1670 29-Nov-1999 1621Z
1591        opdx390.2     2193 29-Nov-1999 1621Z opdx391      25045 29-Nov-1999 1621Z
1592        opdx392      35969 29-Nov-1999 1621Z opdx393      15023 29-Nov-1999 1621Z
1593        opdx394      33429 29-Nov-1999 1621Z opdx394.1     3116 29-Nov-1999 1621Z
1594        opdx395      24319 29-Nov-1999 1621Z opdx396      32647 29-Nov-1999 1621Z
1595        opdx396.1     5537 29-Nov-1999 1621Z opdx396.2     6242 29-Nov-1999 1621Z
1596        opdx397      18433 29-Nov-1999 1621Z opdx398      19961 29-Nov-1999 1621Z
1597        opdx399      17719 29-Nov-1999 1621Z opdx400      19600 29-Nov-1999 1621Z
1598        opdx401      27738 29-Nov-1999 1621Z opdx402      18698 29-Nov-1999 1621Z
1599        opdx403      24994 29-Nov-1999 1621Z opdx404      15685 29-Nov-1999 1621Z
1600        opdx405      13984 29-Nov-1999 1621Z opdx405.1     4166 29-Nov-1999 1621Z
1601        opdx406      28934 29-Nov-1999 1621Z opdx407      24153 29-Nov-1999 1621Z
1602        opdx408      15081 29-Nov-1999 1621Z opdx409      23234 29-Nov-1999 1621Z
1603        Press Enter to continue, A to abort (16 lines) >
1604
1605
1606
1607   You can now read any file in this directory using the type command,
1608   like this ....
1609
1610
1611
1612        type bulletin/opdx391
1613        Ohio/Penn DX Bulletin No. 391
1614        The Ohio/Penn Dx PacketCluster
1615        DX Bulletin No. 391
1616        BID: $OPDX.391
1617        January 11, 1999
1618        Editor Tedd Mirgliotta, KB8NW
1619        Provided by BARF-80 BBS Cleveland, Ohio
1620        Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
1621        Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
1622        Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
1623        & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
1624        Press Enter to continue, A to abort (508 lines) >
1625
1626
1627
1628   The page length will of course depend on what you have it set to!
1629
1630
1631   \e[1m6.5.  The Aliases file\e[0m
1632
1633   You will find a file in /spider/cmd/ called Aliases.  This is the file
1634   that controls what a user gets when issuing a command.  It is also
1635   possible to create your own aliases for databases and files you create
1636   locally.
1637
1638
1639   You should not alter the original file in /spider/cmd/ but create a
1640   new file with the same name in /spider/local_cmd.  This means that any
1641   new Aliases files that is downloaded will not overwrite your self
1642   created Aliases and also that you do not override any new Aliases with
1643   your copy in /spider/local_cmd/.  You must remember that any files you
1644   store in /spider/local/ or /spider/local_cmd override the originals if
1645   the same lines are used in both files.
1646
1647
1648   The best way of dealing with all this then is to only put your own
1649   locally created Aliases in the copy in /spider/local_cmd.  The example
1650   below is currently in use at GB7MBC.
1651
1652
1653
1654        #
1655        # Local Aliases File
1656        #
1657
1658        package CmdAlias;
1659
1660        %alias = (
1661            'n' => [
1662              '^news$', 'type news', 'type',
1663            ],
1664            's' => [
1665              '^sh\w*/buck$', 'show/qrz', 'show',
1666              '^sh\w*/hftest$', 'dbshow hftest', 'dbshow',
1667              '^sh\w*/qsl$', 'dbshow qsl', 'dbshow',
1668              '^sh\w*/vhf$', 'dbshow vhf', 'dbshow',
1669              '^sh\w*/vhftest$', 'dbshow vhftest', 'dbshow',
1670                ],
1671        )
1672
1673
1674
1675   Each alphabetical section should be preceded by the initial letter and
1676   the section should be wrapped in square brackets as you can see.  The
1677   syntax is straightforward.  The first section on each line is the new
1678   command that will be allowed once the alias is included.  The second
1679   section is the command it is replacing and the last section is the
1680   actual command that is being used.
1681
1682
1683   The eagle-eyed amongst you will have noticed that in the first
1684   section, the new alias command has a '^' at the start and a '$' at the
1685   end.  Basically these force a perfect match on the alias.  The '^'
1686   says match the beginning exactly and the with similar commands.
1687
1688
1689   I have 3 different types of alias in this file.  At the top is an
1690   alias for 'news'.  This is a file I have created in the
1691   /spider/packclus/ directory where I can inform users of new
1692   developments or points of interest.  In it's initial form a user would
1693   have to use the command \e[4mtype\e[24m \e[4mnews\e[24m.  The alias allows them to simply
1694   type \e[4mnews\e[24m to get the info.  Second is an alias for the \e[4mshow/qrz\e[0m
1695   command so that those users used to the original \e[4mshow/buck\e[24m command in
1696   AK1A will not get an error, and the rest of the lines are for locally
1697   created databases so that a user can type \e[4mshow/hftest\e[24m instead of
1698   having to use the command \e[4mdbshow\e[24m \e[4mhftest\e[24m which is not as intuitive.
1699
1700
1701   This file is just an example and you should edit it to your own
1702   requirements.  Once created, simply issue the command \e[4mload/alias\e[24m at
1703   the cluster prompt as the sysop user and the aliases should be
1704   available.
1705
1706
1707
1708   \e[1m6.6.  Console.pl\e[0m
1709
1710   In later versions of Spider a simple console program is provided for
1711   the sysop.  This has a type ahead buffer with line editing facilities
1712   and colour for spots, announces etc.  To use this program, simply use
1713   console.pl instead of client.
1714
1715
1716   To edit the colours, copy /spider/perl/Console.pl to /spider/local and
1717   edit the file with your favourite editor.
1718
1719
1720   \e[1m6.7.  Updating kepler data\e[0m
1721
1722   Spider has a powerful and flexible show/satellite command.  In order
1723   for this to be accurate, the kepler data has to be updated regularly.
1724   In general, this data is available as an email or via cluster mail.
1725   Updating it is simple.  First you need to export the mail message as a
1726   file.  You do this with the \e[4mexport\e[24m command from the cluster prompt as
1727   the sysop.  For example ...
1728
1729
1730
1731        export 5467 /spider/perl/keps.in
1732
1733
1734
1735   would export message number 5467 as a file called keps.in in the
1736   /spider/perl directory.
1737
1738
1739   Now login to a VT as sysop and cd /spider/perl.  There is a command in
1740   the perl directory called \e[4mconvkeps.pl\e[24m.  All we need to do now is
1741   convert the file like so ...
1742
1743
1744
1745        ./convkeps.pl keps.in
1746
1747
1748
1749   Now go back to the cluster and issue the command ...
1750
1751
1752
1753   load/keps
1754
1755
1756
1757   That is it!  the kepler data has been updated.
1758
1759
1760   \e[1m6.8.  The QRZ callbook\e[0m
1761
1762   The command \e[4msh/qrz\e[24m will only work once you have followed a few simple
1763   steps.  First you need to get a user ID and password from qrz.com.
1764   Simply go to the site and create one.  Secondly you need to copy the
1765   file /spider/perl/Internet.pm to /spider/local and alter it to match
1766   your user ID and password.  You also at this point need to set
1767   $allow=1 to complete the setup.  Many thanks to Fred Lloyd, the
1768   proprieter of qrz.com for allowing this access.
1769
1770
1771   \e[1m6.9.  Connecting logging programs\e[0m
1772
1773   There appear to be very few logging programs out there that support
1774   telnet especially the popular ones like LogEQF, Turbolog etc.  This
1775   can make it difficult to connect to your own cluster!  The way to do
1776   it is to make the logging program think it has a TNC attached to a com
1777   port on the logging PC and 'push' a linux login out to it.  This is
1778   achieved very simply by the use of \e[4magetty\e[24m.
1779
1780
1781   All that is required is to add a line in /etc/inittab to have the
1782   client ready for a connection on the com port of your choice.
1783   Remember that in Linux, the com ports start at ttyS0 for com1, ttyS1
1784   for com2 etc.
1785
1786
1787
1788        c4:2345:respawn:/sbin/agetty -L 9600 ttyS1
1789
1790
1791
1792   Add this after the standard runlevel lines in /etc/inittab.  The above
1793   line works on ttyS1 (com2).  Now as root, issue the command \e[4mtelinit\e[24m \e[4mq\e[0m
1794   and it should be ready for connection.  All that is required is a 3
1795   wire serial lead (tx, rx and signal ground).  Tell you logging program
1796   to use 8n1 at 9600 baud and you should see a Linux login prompt.
1797   Login as normal and then telnet from there to the cluster.
1798
1799
1800   \e[1m7.  Java Web applet\e[0m
1801
1802   In the spider tree will be a directory \e[4mspider-web\e[24m.  This is a neat
1803   little java web applet that can be run from a website.  The applet
1804   must run on the same machine as the cluster.  The included README file
1805   is shown below.
1806
1807
1808   I should comment here that the applet is precompiled, that is, ready
1809   to go.  It was compiled using JDK1.3.1.  If your version is earlier
1810   than this then it may not work.  Should that be the case you need to
1811   recompile or update your JDK.  To recompile do the following ...
1812
1813
1814
1815   cd /spider/spider-web
1816   rm *.class
1817   /usr/bin/javac spiderclient.java
1818
1819
1820
1821   I have used /usr/bin/javac as an example, your path to javac may be
1822   different.
1823
1824
1825   Spider-WEB v0.6b
1826
1827   Completely based on a clx web client written in Java by dl6dbh
1828   (ftp://clx.muc.de/pub/clx/clx-java_10130001.tgz)
1829
1830   The webserver has to run on the same machine as your DxSpider software!
1831
1832   It is assumed that you have Java installed.  You need JDK1.3.1 at least.
1833
1834   Installation instructions (Performed as root):
1835
1836   Put all the files in the spider-web directory into a newly created directory
1837   under the DocumentRoot of your websever for instance 'client'. In my case
1838   this is:  /home/httpd/html/client/ although ymmv.  For Suse the correct
1839   path should be /usr/local/httpd/htdocs/client/ for example.
1840
1841   Move spider.cgi to the cgi-bin directory of your webserver, in my case that is
1842   /home/httpd/cgi-bin/ although ymmv.  For Suse the correct path should be
1843   /usr/local/httpd/cgi-bin/ for example.
1844
1845   Change the permissions of the files to ensure they are correct, obviously you
1846   will need to use the correct path the the files according to your system:
1847
1848   chmod 755 /home/httpd/html/cgi-bin/spider.cgi
1849   chmod -R 755 /home/httpd/html/client/
1850
1851   By default the spider.cgi script should pick up your hostname (As long as this
1852   is set correctly).  If it does not or your hostname differs from the name that
1853   you attach to the public address that you are using, then edit spider.cgi :
1854
1855   # Uncomment and set the hostname manually here if the above fails.
1856   # $HOSTNAME = "gb7mbc.spoo.org" ;
1857   $PORT = "8000" ;
1858
1859
1860   telnet (see Listeners.pm)
1861
1862   NOTE: If you can start the console but cannot connect to the cluster from it,
1863   then it is possible that the machine you are on cannot resolve the hostname of
1864   your cluster machine.  If this is the case, you need to set your hostname
1865   manually as above.
1866
1867   You also need to set the $NODECALL variable.  This prints the name of your
1868   choosing (probably your cluster callsign) on the html page.
1869
1870   You now can connect to Spider-Web via http://yourserver/cgi-bin/spider.cgi
1871
1872
1873
1874   \e[1m8.  Web based statistics\e[0m
1875
1876   From version 1.50, you can use the freeware software MRTG to produce
1877   really nice graphical statistics on your web site.  For an example try
1878   http://www.gb7mbc.net/mrtg/stats.html.
1879
1880
1881   The following should help you get it all working.
1882
1883
1884   First you need to download the latest version of MRTG from
1885   http://people.ee.ethz.ch/~oetiker/webtools/mrtg/.  You will also need
1886   the following files..
1887
1888
1889
1890        libpng-1.0.14.tar.gz
1891        zlib-1.1.4.tar.gz
1892        gd-1.8.3.tar.gz
1893
1894
1895
1896   Login to your machine as the root user, put all the downloaded files
1897   in /usr/local/src/ (or wherever you prefer) and untar and compile
1898   them.  All the information to compile and install these sources come
1899   with them.  After compilation and installation,  you will find MRTG in
1900   /usr/local/mrtg-2.
1901
1902
1903   Now copy all the files in /usr/local/src/mrtg-2.9.22/images/ to
1904   /spider/html/mrtg/
1905
1906
1907   You now need to make 2 symbolic links like below...
1908
1909
1910
1911        ln -s /usr/local/mrtg-2/bin/mrtg /usr/bin/mrtg
1912        ln -s /usr/local/mrtg-2/lib/mrtg2 /usr/lib/mrtg2
1913
1914
1915
1916   Now login to the cluster with your sysop callsign and run the command
1917   "mrtg all".
1918
1919
1920   Now you are nearly there!  Login as the sysop user and change to the
1921   /spider/html/mrtg/ directory.  Now run the command \e[4mindexmaker\e[24m as shown
1922   below...
1923
1924
1925
1926        indexmaker --output stats.html --columns=1 --title "MRTG statistics for GB7DJK" ../../mrtg/mrtg.cfg
1927
1928
1929
1930   Changing the callsign for your own cluster callsign of course!
1931
1932
1933   And finally you need to login as the root user and create one last
1934   symbolic link.  Where this points will depend on where your html
1935   documents are kept.  For RedHat systems you use...
1936
1937
1938
1939   ln -s /home/sysop/spider/html/mrtg /home/httpd/html/mrtg
1940
1941
1942
1943   and for SuSE systems...
1944
1945
1946
1947        ln -s /home/sysop/spider/html/mrtg /usr/local/httpd/htdocs/mrtg
1948
1949
1950
1951   If you now point your browser to your website as below it should all
1952   be happening!
1953
1954
1955
1956        http://www.xxx.xxx/mrtg/stats.html
1957
1958
1959
1960   Of course, to get the stats to update, you need to add some
1961   information in the spider crontab file as below...
1962
1963
1964
1965        # Update stats for mrtg on website
1966        00,05,10,15,20,25,30,35,40,45,50,55 * * * * run_cmd('mrtg all')
1967
1968
1969
1970   This will update the site every 5 minutes.
1971
1972
1973   \e[1m9.  Security\e[0m
1974
1975   From version 1.49 DXSpider has some additional security features.
1976   These are not by any means meant to be exhaustive, however they do
1977   afford some security against piracy.  These two new features can be
1978   used independently of each other or in concert to tighten the
1979   security.
1980
1981
1982   \e[1m9.1.  Registration\e[0m
1983
1984   The basic principle of registration is simple.  If a user is not
1985   registered by the sysop, then they have read-only access to the
1986   cluster.  The only thing they can actually send is a talk or a message
1987   to the sysop.  In order for them to be able to spot, send announces or
1988   talks etc the sysop must register them with the \e[4mset/register\e[24m command,
1989   like this ...
1990
1991
1992
1993        set/register g0vgs
1994
1995
1996
1997   The user g0vgs can now fully use the cluster.  In order to enable
1998   registration, you can issue the command ...
1999
2000        set/var $main::reqreg = 1
2001
2002
2003
2004   Any users that are not registered will now see the motd_nor file
2005   rather than the motd file as discussed in the Information, files and
2006   useful programs section.
2007
2008
2009   Entering this line at the prompt will only last for the time the
2010   cluster is running of course and would not be present on a restart.
2011   To make the change permanent, add the above line to
2012   /spider/scripts/startup.  To read more on the startup file, see the
2013   section on Information, files and useful programs.
2014
2015
2016   To unregister a user use \e[4munset/register\e[24m and to show the list of
2017   registered users, use the command \e[4mshow/register\e[24m.
2018
2019
2020   \e[1m9.2.  Passwords\e[0m
2021
2022   At the moment, passwords only affect users who login to a DXSpider
2023   cluster node via telnet.  If a user requires a password, they can
2024   either set it themselves or have the sysop enter it for them by using
2025   the \e[4mset/password\e[24m command.  Any users who already have passwords, such
2026   as remote sysops, will be asked for their passwords automatically by
2027   the cluster.  Using passwords in this way means that the user has a
2028   choice on whether to have a password or not.  To force the use of
2029   passwords at login, issue the command ...
2030
2031
2032
2033        set/var $main::passwdreq = 1
2034
2035
2036
2037   at the cluster prompt.  This can also be added to the
2038   /spider/scripts/startup file as above to make the change permanent.
2039
2040
2041   Of course, if you do this you will have to assign a password for each
2042   of your users.  If you were asking them to register, it is anticipated
2043   that you would ask them to send you a message both to ask to be
2044   registered and to give you the password they wish to use.
2045
2046
2047   Should a user forget their password, it can be reset by the sysop by
2048   first removing the existing password and then setting a new one like
2049   so ...
2050
2051
2052
2053        unset/password g0vgs
2054        set/password g0vgs new_password
2055
2056
2057
2058   \e[1m10.  CVS\e[0m
2059
2060
2061
2062   \e[1m10.1.  CVS from a Linux platform\e[0m
2063
2064   CVS stands for "Concurrent Versions System" and the CVS for DXSpider
2065   is held at Sourceforge.  This means that it is possible to update your
2066   DXSpider installation to the latest sources by using a few simple
2067   commands.  A graphical interface to CVS for Windows is explained in
2068   the next section.
2069
2070
2071   Please be aware that if you update your system using CVS, it is
2072   possible that you could be running code that is very beta and not
2073   fully tested.  There is a possibility that it could be unstable.
2074
2075
2076   I am of course assuming that you have a machine with both DXSpider and
2077   Internet access running.
2078
2079
2080   BEFORE YOU EVEN CONSIDER STARTING WITH THIS MAKE A BACKUP OF YOUR
2081   ENTIRE SPIDER TREE!!
2082
2083
2084   Assuming you are connected to the Internet, you need to login to the
2085   CVS repository and then update your Spider source.  There are several
2086   steps which are listed below ...
2087
2088
2089   First login as the user \e[4msysop\e[24m.  Next you need to connect to the CVS
2090   repository.  You do this with the command below ...
2091
2092
2093   cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
2094
2095
2096
2097   You will get a password prompt.  Simply hit return here and your
2098   machine should return to a normal linux prompt.
2099
2100
2101   What happens next depends on whether you have an existing installation
2102   that you want to update with the latest and greatest or whether you
2103   just want to see what is there and/or run it on a new machine for
2104   testing.
2105
2106   If you are installing Spider from CVS then change directory to
2107   /home/sysop
2108
2109   If you are wanting to update Spider then cd to /tmp
2110
2111
2112   The next step will create a brand new 'spider' directory in your
2113   current directory.
2114
2115
2116   cvs -z3 -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider co spider
2117
2118
2119
2120   This command is all on one line.
2121
2122
2123   Hopefully your screen should show you downloading files.  The -z3
2124   simply compresses the download to improve speed.  When this has
2125   finished, you will have exactly the same as if you had untarred a full
2126   tarball PLUS some extra directories and files that CVS needs to do the
2127   magic that it does.
2128   Now if you are doing a new installation, that's it.  Carry on as if
2129   you have just downloaded and untarred the lastest tarball.
2130
2131
2132   If you want to upgrade your current installation then do this ...
2133
2134
2135
2136        tar cvfz /tmp/s.tgz spider
2137        cd /
2138        tar xvfzp /tmp/s.tgz
2139
2140
2141
2142   This is assuming you downloaded to the /tmp directory of course.
2143
2144
2145   NOTE:  the 'p' on the end of the 'xvfz' is IMPORTANT!   It keeps the
2146   permissions correct.  YOU WERE LOGGED IN AS THE USER SYSOP WEREN'T
2147   YOU?????
2148
2149   Remember to recompile the C client (cd /spider/src; make)
2150
2151
2152   At this point the files have been upgraded.  You can (usually) restart
2153   the cluster in your own time.  However, if you attempt to use any new
2154   commands or features expect it to be fatal!  At least your cluster
2155   will have been restarted then so it will be too late to worry about
2156   it!
2157
2158
2159   Now the magic part!  From now on when you want to update, simply
2160   connect to the Internet and then, as the user \e[4msysop\e[24m ...
2161
2162
2163
2164        cd /spider
2165        cvs -z3 update -d
2166
2167
2168
2169   and your files will be updated.  As above, remember to recompile the
2170   "C" client if it has been updated (CVS will tell you) and restart if
2171   any of the perl scripts have been altered or added, again, CVS will
2172   tell you.
2173
2174
2175   You will find any changes documented in the /spider/Changes file.
2176
2177
2178   \e[1m10.2.  CVS from a Windows platform\e[0m
2179
2180   After the initial setup, an update to your DXSpider software is no
2181   more than a couple of clicks away.  This section is intended to
2182   explain and illustrate the use of the WinCVS application to update
2183   your DXSpider software.  The current stable version of WinCVS is Ver.
2184   1.2.  You can get this software at:
2185
2186   http://prdownloads.sourceforge.net/cvsgui/WinCvs120.zip
2187
2188   Pick your download mirror and then install WinCVS after the download
2189   is complete.
2190
2191
2192   In this next section I have included a series of links to .jpg files
2193   to take advantage of the picture and 1000 words equivalency.  The .jpg
2194   files are in the C:\spider\html directory.  If someone using a Linux
2195   system is reading this section from boredom, the files are in
2196   /home/sysop/spider/html.  One aside, a Linux user can also get a copy
2197   of gcvs and do your updates graphically as opposed to from the command
2198   line.  The following descriptions are almost identical between WinCvs
2199   and gcvs.  The following screen shots have duplicate links, depending
2200   upon whether you are viewing this information under the Windows or
2201   Linux operating system.
2202
2203   When WinCVS is installed, running, and you are connected to the
2204   internet, the initial screen looks like:
2205
2206   initial.jpg
2207
2208   If you want, you can also look at these .jpg files with another viewer
2209   that might provide some better clarity to the image.  On the left is
2210   the directory tree for your hard disk.  Notice that the spider
2211   directory has a gray highlight.
2212
2213   To start configuring WinCVS, click on Admin at the top of the screen
2214   and then Preferences.  This should get you:
2215
2216   pref-gen.jpg
2217
2218   In the top line for CVSROOT, enter:
2219
2220
2221        anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
2222
2223
2224
2225   and select
2226
2227
2228        "passwd" file on the cvs server
2229
2230
2231
2232   for Authentication on the General tab.
2233
2234   Next, move to the right to the Ports tab.
2235
2236   pref-ports.jpg
2237
2238   In here, check the box on the second line down for the "pserver" port.
2239   Enter a port number of 2401.
2240
2241   Finally, go to the WinCvs tab all the way to the right.
2242
2243   pref-wincvs.jpg
2244
2245   Enter Notepad as the viewer to open files.  For the HOME folder, put
2246   "C:\spider" and click OK because the configuration is now complete.
2247
2248   You are now ready to upgrade your copy of DXSpider.  Click on the
2249   greyed Spider folder shown in the directory tree on the left of the
2250   WinCVS display.  Two things should happen.  The Spider folder will be
2251   selected and the greyed-out arrow located just below the word Query in
2252   the top line will turn to solid green.
2253
2254   For anyone using gcvs under Linux, the green arrow is located on the
2255   extreme left of the display, under the word File.  A gcvs screen looks
2256   like:
2257
2258   gcvs.jpg
2259
2260   Click on the now green arrow to start the download process.  An Update
2261   Settings box will be displayed to which you can simply say OK.
2262
2263   update-OK.jpg
2264
2265   For future reference, the Update Settings box is the place where you
2266   can enter information to revert to a prior version of DXSpider.
2267   Information on reverting to a Before Date is contained in the WinCVS
2268   manual.
2269
2270   After a short period of time, a series of file names will scroll by in
2271   the lower pane of the WinCVS window.  Eventually you should see
2272
2273
2274        *****CVS exited normally with code 0*****
2275
2276
2277
2278   appear in the lower pane.  You're done.  The updated files are in
2279   place ready for you to stop and then restart your DXSpider.  After the
2280   restart, you're running with the latest version of DXSpider.
2281
2282   completed.jpg
2283
2284   To paraphrase from the CVS section... Now the magic part!  From now on
2285   when you want to update, simply connect to the Internet and start
2286   WinCVS.
2287
2288
2289        Click on the greyed-out Spider directory in the left screen
2290        Click on the green down arrow
2291        Click OK on the Update Settings dialog box
2292        Restart your Spider software
2293
2294
2295
2296   \e[1m11.  The DXSpider Command Reference\e[0m
2297
2298   \e[1m11.1.  accept (0)\e[0m
2299
2300   \e[1maccept \e[22mSet a filter to accept something
2301
2302   Create a filter to accept somethingThere are 2 types of filter, accept
2303   and reject.  See HELP FILTERING for moreinfo.
2304
2305   \e[1m11.2.  accept/announce <call> [input] [0-9] <pattern> (8)\e[0m
2306
2307   \e[1maccept/announce <call> [input] [0-9] <pattern> \e[22mAnnounce filter sysop
2308   version
2309
2310   This version allows a sysop to set a filter for a callsign as well as
2311   thedefault for nodes and users eg:-
2312
2313
2314          accept/ann by G,M,2  accept/ann input node_default by G,M,2  accept/ann user_default by G,M,2
2315
2316
2317
2318   \e[1m11.3.  accept/announce [0-9] <pattern> (0)\e[0m
2319
2320   \e[1maccept/announce [0-9] <pattern> \e[22mSet an 'accept' filter line for
2321   announce
2322
2323   Create an 'accept this announce' line for a filter. An accept filter
2324   line means that if the announce matches this filter it ispassed onto
2325   the user. See HELP FILTERING for more info. Please read thisto
2326   understand how filters work - it will save a lot of grief later on.You
2327   can use any of the following things in this line:-
2328
2329
2330          info <string>            eg: iota or qsl  by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  origin_state <states>                eg: VA,NH,RI,NH  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  by_state <states>  channel <prefixes>  wx 1                     filter WX announces  dest <prefixes>          eg: 6MUK,WDX      (distros)
2331
2332
2333
2334   some examples:-
2335
2336
2337          acc/ann dest 6MUK  acc/ann 2 by_zone 14,15,16  (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
2338
2339
2340
2341   or
2342
2343
2344          acc/ann by G,M,2
2345
2346
2347
2348   for american states
2349
2350
2351          acc/ann by_state va,nh,ri,nh
2352
2353
2354
2355   You can use the tag 'all' to accept everything eg:
2356
2357
2358          acc/ann all
2359
2360
2361
2362   but this probably for advanced users...
2363
2364   \e[1m11.4.  accept/route <call> [0-9] <pattern> (8)\e[0m
2365
2366   \e[1maccept/route <call> [0-9] <pattern> \e[22mSet an 'accept' filter line for
2367   routing
2368
2369   Create an 'accept this routing PC Protocol' line for a filter. An
2370   accept filter line means that if a PC16/17/19/21/24/41/50 matches this
2371   filter it is passed thru that interface. See HELP FILTERING for more
2372   info. Please read thisto understand how filters work - it will save a
2373   lot of grief later on.You can use any of the following things in this
2374   line:-
2375
2376
2377          call <prefixes>        the callsign of the thingy  call_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  call_itu <prefixes or numbers>     or: G,GM,GW  call_zone <prefixes or numbers>  call_state <states>                eg: VA,NH,RI,NH  origin <prefixes>      really the interface it came in on  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  origin_state <states>                eg: VA,NH,RI,NH
2378
2379
2380
2381   some examples:-
2382
2383
2384     acc/route gb7djk call_dxcc 61,38 (send only UK+EIRE nodes)  acc/route gb7djk call gb7djk     (equiv to SET/ISOLATE)
2385
2386
2387
2388   you can now use 'by' as a synonym for 'call' so:
2389
2390
2391          by = call  by_dxcc = call_dxcc
2392
2393
2394
2395   and so onYou can use the tag 'all' to accept everything eg:
2396
2397
2398          acc/route all
2399
2400
2401
2402   \e[1m11.5.  accept/spots <call> [input] [0-9] <pattern> (8)\e[0m
2403
2404   \e[1maccept/spots <call> [input] [0-9] <pattern> \e[22mSpot filter sysop version
2405
2406   This version allows a sysop to set a filter for a callsign as well as
2407   thedefault for nodes and users eg:-
2408
2409
2410          accept/spot db0sue-7 1 by_zone 14,15,16  accept/spot node_default all  set/hops node_default 10
2411
2412
2413
2414          accept/spot user_default by G,M,2
2415
2416
2417
2418   \e[1m11.6.  accept/spots [0-9] <pattern> (0)\e[0m
2419
2420   \e[1maccept/spots [0-9] <pattern> \e[22mSet an 'accept' filter line for spots
2421
2422   Create an 'accept this spot' line for a filter. An accept filter line
2423   means that if the spot matches this filter it ispassed onto the user.
2424   See HELP FILTERING for more info. Please read thisto understand how
2425   filters work - it will save a lot of grief later on.You can use any of
2426   the following things in this line:-
2427
2428
2429          freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m  on <range>             same as 'freq'  call <prefixes>        eg: G,PA,HB9  info <string>          eg: iota or qsl  by <prefixes>              call_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  call_itu <prefixes or numbers>     or: G,GM,GW  call_zone <prefixes or numbers>  call_state <states>                eg: VA,NH,RI,ME  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  by_state <states>                eg: VA,NH,RI,ME  origin <prefixes>  channel <prefixes>
2430
2431
2432
2433          acc/spot 1 on hf/cw  acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
2434
2435
2436
2437   You can use the tag 'all' to accept everything, eg:
2438
2439
2440          acc/spot 3 all
2441
2442
2443
2444   for US states
2445
2446
2447          acc/spots by_state VA,NH,RI,MA,ME
2448
2449
2450
2451   but this probably for advanced users...
2452
2453   \e[1m11.7.  accept/wcy <call> [input] [0-9] <pattern> (8)\e[0m
2454
2455   \e[1maccept/wcy <call> [input] [0-9] <pattern> \e[22mWCY filter sysop version
2456
2457   This version allows a sysop to set a filter for a callsign as well as
2458   thedefault for nodes and users eg:-
2459
2460
2461          accept/wcy node_default all  set/hops node_default 10
2462
2463
2464
2465   \e[1m11.8.  accept/wcy [0-9] <pattern> (0)\e[0m
2466
2467   \e[1maccept/wcy [0-9] <pattern> \e[22mset an 'accept' WCY filter
2468
2469   It is unlikely that you will want to do this, but if you do then you
2470   canfilter on the following fields:-
2471
2472
2473          by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  channel <prefixes>
2474
2475
2476
2477   There are no examples because WCY Broadcasts only come from one place
2478   andyou either want them or not (see UNSET/WCY if you don't want
2479   them).This command is really provided for future use.See HELP FILTER
2480   for information.
2481
2482   \e[1m11.9.  accept/wwv <call> [input] [0-9] <pattern> (8)\e[0m
2483
2484   \e[1maccept/wwv <call> [input] [0-9] <pattern> \e[22mWWV filter sysop version
2485
2486   This version allows a sysop to set a filter for a callsign as well as
2487   thedefault for nodes and users eg:-
2488
2489
2490          accept/wwv db0sue-7 1 by_zone 4  accept/wwv node_default all  set/hops node_default 10
2491
2492
2493
2494          accept/wwv user_default by W,K
2495
2496
2497
2498   \e[1m11.10.  accept/wwv [0-9] <pattern> (0)\e[0m
2499
2500   \e[1maccept/wwv [0-9] <pattern> \e[22mset an 'accept' WWV filter
2501
2502   It is unlikely that you will want to do this, but if you do then you
2503   canfilter on the following fields:-
2504
2505
2506     by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  channel <prefixes>
2507
2508
2509
2510   for example
2511
2512
2513          accept/wwv by_zone 4
2514
2515
2516
2517   is probably the only useful thing to do (which will only show WWV
2518   broadcastsby stations in the US).See HELP FILTER for information.
2519
2520   \e[1m11.11.  announce <text> (0)\e[0m
2521
2522   \e[1mannounce <text> \e[22mSend an announcement to LOCAL users only
2523
2524   <text> is the text of the announcement you wish to broadcast
2525
2526   \e[1m11.12.  announce full <text> (0)\e[0m
2527
2528   \e[1mannounce full <text> \e[22mSend an announcement cluster wide
2529
2530   This will send your announcement cluster wide
2531
2532   \e[1m11.13.  announce sysop <text> (5)\e[0m
2533
2534   \e[1mannounce sysop <text> \e[22mSend an announcement to Sysops only
2535
2536
2537   \e[1m11.14.  apropos <string> (0)\e[0m
2538
2539   \e[1mapropos <string> \e[22mSearch help database for <string>
2540
2541   Search the help database for <string> (it isn't case sensitive), and
2542   printthe names of all the commands that may be relevant.
2543
2544   \e[1m11.15.  blank [<string>] [<nn>] (0)\e[0m
2545
2546   \e[1mblank [<string>] [<nn>] \e[22mPrint nn (default 1) blank lines (or strings)
2547
2548   In its basic form this command prints one or more blank lines. However
2549   ifyou pass it a string it will replicate the string for the width of
2550   the screen (default 80) and then print that one or more times, so:
2551
2552
2553          blank 2
2554
2555
2556
2557   prints two blank lines
2558
2559
2560          blank -
2561
2562
2563
2564   prints a row of - characters once.
2565
2566
2567          blank abc
2568
2569
2570
2571   prints 'abcabcabcabcabcabc....'This is really only of any use in a
2572   script file and you can print a maximumof 9 lines.
2573
2574   \e[1m11.16.  bye (0)\e[0m
2575
2576   \e[1mbye \e[22mExit from the cluster
2577
2578   This will disconnect you from the cluster
2579
2580   \e[1m11.17.  catchup <node call> all|[<msgno> ...] (5)\e[0m
2581
2582   \e[1mcatchup <node call> all|[<msgno> ...] \e[22mMark a message as sent
2583
2584
2585   \e[1m11.18.  chat <group> <text> (0)\e[0m
2586
2587   \e[1mchat <group> <text> \e[22mChat or Conference to a group
2588
2589   It is now possible to JOIN a group and have network wide conferencing
2590   to thatgroup. DXSpider does not (and probably will not) implement the
2591   AK1A conference mode as this seems very limiting, is hardly used and
2592   doesn't seemto work too well anyway.This system uses the existing ANN
2593   system and is compatible with both otherDXSpider nodes and AK1A
2594   clusters (they use ANN/<group>). You can be a member of as many
2595   "groups" as you want. To join a group type:-
2596
2597
2598          JOIN FOC    (where FOC is the group name)
2599
2600
2601
2602   To leave a group type:-
2603
2604
2605          LEAVE FOC
2606
2607
2608
2609   You can see which groups you are in by typing:-
2610
2611
2612          STAT/USER
2613
2614
2615
2616   and you can see whether your mate is in the group, if he connects to
2617   thesame node as you, by typing:-
2618
2619
2620          STAT/USER g1tlh
2621
2622
2623
2624   To send a message to a group type:-
2625
2626
2627          CHAT FOC hello everyone
2628
2629
2630
2631   or
2632
2633
2634          CH #9000 hello I am back
2635
2636
2637   See also JOIN, LEAVE, SHOW/CHAT
2638
2639   \e[1m11.19.  clear/announce <callsign> [input] [0-9|all] (8)\e[0m
2640
2641   \e[1mclear/announce <callsign> [input] [0-9|all] \e[22mClear a announce filter
2642   line
2643
2644   A sysop can clear an input or normal output filter for a user or
2645   thenode_default or user_default.
2646
2647   \e[1m11.20.  clear/announce [1|all] (0)\e[0m
2648
2649   \e[1mclear/announce [1|all] \e[22mClear a announce filter line
2650
2651   This command allows you to clear (remove) a line in a annouce filter
2652   or to remove the whole filter.see CLEAR/SPOTS for a more detailed
2653   explanation.
2654
2655   \e[1m11.21.  clear/route <callsign> [input] [0-9|all] (8)\e[0m
2656
2657   \e[1mclear/route <callsign> [input] [0-9|all] \e[22mClear a route filter line
2658
2659   A sysop can clear an input or normal output filter for a user or
2660   thenode_default or user_default.
2661
2662   \e[1m11.22.  clear/route [1|all] (0)\e[0m
2663
2664   \e[1mclear/route [1|all] \e[22mClear a route filter line
2665
2666   This command allows you to clear (remove) a line in a route filter or
2667   to remove the whole filter.see CLEAR/SPOTS for a more detailed
2668   explanation.
2669
2670   \e[1m11.23.  clear/spots <callsign> [input] [0-9|all] (8)\e[0m
2671
2672   \e[1mclear/spots <callsign> [input] [0-9|all] \e[22mClear a spot filter line
2673
2674   A sysop can clear an input or normal output filter for a user or
2675   thenode_default or user_default.
2676
2677   \e[1m11.24.  clear/spots [0-9|all] (0)\e[0m
2678
2679   \e[1mclear/spots [0-9|all] \e[22mClear a spot filter line
2680
2681   This command allows you to clear (remove) a line in a spot filter or
2682   to remove the whole filter.If you have a filter:-
2683
2684
2685          acc/spot 1 on hf/cw  acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
2686
2687
2688
2689   and you say:-
2690
2691
2692          clear/spot 1
2693
2694
2695
2696   you will be left with:-
2697
2698
2699          acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
2700
2701
2702
2703   If you do:
2704
2705
2706          clear/spot all
2707
2708
2709
2710   the filter will be completely removed.
2711
2712   \e[1m11.25.  clear/wcy <callsign> [input] [0-9|all] (8)\e[0m
2713
2714   \e[1mclear/wcy <callsign> [input] [0-9|all] \e[22mClear a WCY filter line
2715
2716   A sysop can clear an input or normal output filter for a user or
2717   thenode_default or user_default.
2718
2719   \e[1m11.26.  clear/wcy [1|all] (0)\e[0m
2720
2721   \e[1mclear/wcy [1|all] \e[22mClear a WCY filter line
2722
2723   This command allows you to clear (remove) a line in a WCY filter or to
2724   remove the whole filter.see CLEAR/SPOTS for a more detailed
2725   explanation.
2726
2727   \e[1m11.27.  clear/wwv <callsign> [input] [0-9|all] (8)\e[0m
2728
2729   \e[1mclear/wwv <callsign> [input] [0-9|all] \e[22mClear a WWV filter line
2730
2731   A sysop can clear an input or normal output filter for a user or
2732   thenode_default or user_default.
2733
2734   \e[1m11.28.  clear/wwv [1|all] (0)\e[0m
2735
2736   \e[1mclear/wwv [1|all] \e[22mClear a WWV filter line
2737
2738   This command allows you to clear (remove) a line in a WWV filter or to
2739   remove the whole filter.see CLEAR/SPOTS for a more detailed
2740   explanation.
2741
2742   \e[1m11.29.  connect <callsign> (5)\e[0m
2743
2744   \e[1mconnect <callsign> \e[22mStart a connection to another DX Cluster
2745
2746   Start a connection process that will culminate in a new connection to
2747   theDX cluster <callsign>. This process creates a new 'client' process
2748   which willuse the script in /spider/connect/<callsign> to effect the
2749   'chat' exchangenecessary to traverse the network(s) to logon to the
2750   cluster <callsign>.
2751
2752   \e[1m11.30.  dbavail (0)\e[0m
2753
2754   \e[1mdbavail \e[22mShow a list of all the Databases in the system
2755
2756   Title says it all really, this command lists all the databases
2757   definedin the system. It is also aliased to SHOW/COMMAND.
2758
2759   \e[1m11.31.  dbcreate <name> (9)\e[0m
2760
2761   \e[1mdbcreate <name> \e[22mCreate a database entry
2762
2763
2764   \e[1m11.32.  dbcreate <name> chain <name> [<name>..] (9)\e[0m
2765
2766   \e[1mdbcreate <name> chain <name> [<name>..] \e[22mCreate a chained database
2767   entry
2768
2769   \e[1m11.33.  dbcreate <name> cmd <dxspider command> (9)\e[0m
2770
2771   \e[1mdbcreate <name> cmd <dxspider command> \e[22mmake a local command available
2772   as a DB
2773
2774   DBCREATE allows you to define a database in the system. It doesn't
2775   actuallycreate anything, just defines it.The databases that are
2776   created are simple DB_File hash databases, they are therefore already
2777   'indexed'.You can define a local database with the first form of the
2778   command eg:
2779
2780
2781          DBCREATE oblast
2782
2783
2784
2785   You can also chain databases with the addition of the 'chain' keyword.
2786   This will search each database one after the other. A typical example
2787   is:
2788
2789
2790          DBCREATE sdx_qsl chain sql_ad
2791
2792
2793
2794   No checking is done to see if the any of the chained databases exist,
2795   infact it is usually better to do the above staement first then do
2796   each ofthe chained databases.Databases can exist offsite. To define a
2797   database that lives on another node do:
2798
2799
2800          DBCREATE buckmaster remote gb7dxc
2801
2802
2803
2804   Remote databases cannot be chained; however, the last database in a a
2805   chain can be a remote database eg:
2806
2807
2808          DBCREATE qsl chain gb7dxc
2809
2810
2811
2812   To see what databases have been defined do:
2813
2814
2815          DBAVAIL (or it will have been aliased to SHOW/COMMAND)
2816
2817
2818
2819   It would be normal for you to add an entry into your local Aliases
2820   fileto allow people to use the 'SHOW/<dbname>' style syntax. So you
2821   wouldneed to add a line like:-
2822
2823
2824          's' => [    ..    ..    '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',    ..    ..   ],
2825
2826
2827
2828   to allow
2829
2830
2831          SH/BUCK g1tlh
2832
2833
2834
2835   to work as they may be used to.You can also make local commands avail-
2836   able as 'pseudo' databases. Youcan therefore make spider special com-
2837   mands available as a database. Iimagine that this will be primarily
2838   useful for remote access from legacy nodes. For example:-
2839
2840
2841          DBCREATE dxqsl cmd show/dxqsl
2842
2843
2844
2845   You also use one of these databases in a chain. This may be useful
2846   locally. See DBIMPORT for the importing of existing AK1A format data
2847   to databases.See DBSHOW for generic database enquiry
2848
2849   \e[1m11.34.  dbcreate <name> remote <node> (9)\e[0m
2850
2851   \e[1mdbcreate <name> remote <node> \e[22mCreate a remote database entry
2852
2853
2854   \e[1m11.35.  dbimport <dbname> <filename> (9)\e[0m
2855
2856   \e[1mdbimport <dbname> <filename> \e[22mImport AK1A data into a database
2857
2858   If you want to import or update data in bulk to a database you can
2859   usethis command. It will either create or update entries into an
2860   existingdatabase. For example:-
2861
2862
2863          DBIMPORT oblast /tmp/OBLAST.FUL
2864
2865
2866
2867   will import the standard OBLAST database that comes with AK1A into
2868   theoblast database held locally.
2869
2870   \e[1m11.36.  dbremove <dbname> (9)\e[0m
2871
2872   \e[1mdbremove <dbname> \e[22mDelete a database
2873
2874   DBREMOVE will completely remove a database entry and also delete any
2875   datafile that is associated with it. There is no warning, no comeback,
2876   no safety net. For example:
2877
2878
2879          DBREMOVE oblast
2880
2881
2882
2883   will remove the oblast database from the system and it will also
2884   removethe associated datafile.I repeat:There is no warning, no come-
2885   back, no safety net.You have been warned.
2886
2887   \e[1m11.37.  dbshow <dbname> <key> (0)\e[0m
2888
2889   \e[1mdbshow <dbname> <key> \e[22mDisplay an entry, if it exists, in a database
2890
2891   This is the generic user interface to the database to the database
2892   system.It is expected that the sysop will add an entry to the local
2893   Aliases fileso that users can use the more familiar AK1A style of
2894   enquiry such as:
2895
2896
2897          SH/BUCK G1TLH
2898
2899
2900
2901   but if he hasn't and the database really does exist (use DBAVAIL
2902   orSHOW/COMMAND to find out) you can do the same thing with:
2903
2904
2905          DBSHOW buck G1TLH
2906
2907
2908
2909   \e[1m11.38.  debug (9)\e[0m
2910
2911   \e[1mdebug \e[22mSet the cluster program into debug mode
2912
2913   Executing this command will only have an effect if you are running the
2914   clusterin debug mode i.e.
2915
2916
2917                perl -d cluster.pl
2918
2919
2920
2921   It will interrupt the cluster just after the debug command has fin-
2922   ished.
2923
2924   \e[1m11.39.  delete/usdb <callsign> ... (9)\e[0m
2925
2926   \e[1mdelete/usdb <callsign> ... \e[22mDelete this user from the US State Database
2927
2928   This command will completely remove a one or more callsignsfrom the US
2929   States database.There is NO SECOND CHANCE.It goes without saying that
2930   you should use this command CAREFULLY!Note that these callsign may be
2931   re-instated by any weekly updates from the FCC.
2932
2933   \e[1m11.40.  delete/user <callsign> ... (9)\e[0m
2934
2935   \e[1mdelete/user <callsign> ... \e[22mDelete this user from the User Database
2936
2937   This command will completely remove a one or more users from the
2938   database.There is NO SECOND CHANCE.It goes without saying that you
2939   should use this command CAREFULLY!
2940
2941   \e[1m11.41.  demonstrate <call> <command> (9)\e[0m
2942
2943   \e[1mdemonstrate <call> <command> \e[22mDemonstrate a command to another user
2944
2945   This command is provided so that sysops can demonstrate commands to
2946   other users. It runs a command as though that user had typed it in
2947   andthen sends the output to that user, together with the command that
2948   caused it.
2949
2950
2951          DEMO g7brn sh/dx iota oc209  DEMO g1tlh set/here
2952
2953
2954
2955   Note that this command is similar to SPOOF and will have the same
2956   sideeffects. Commands are run at the privilege of the user which is
2957   beingdemonstrated to.
2958
2959   \e[1m11.42.  directory (0)\e[0m
2960
2961   \e[1mdirectory \e[22mList messages
2962
2963
2964
2965   \e[1m11.43.  directory <from>-<to> (0)\e[0m
2966
2967   \e[1mdirectory <from>-<to> \e[22mList messages <from> message <to> message
2968
2969   List the messages in the messages directory.If there is a 'p' one
2970   space after the message number then it is a personal message. If there
2971   is a '-' between the message number and the'p' then this indicates
2972   that the message has been read.You can use shell escape characters
2973   such as '*' and '?' in the <call>fields.You can combine some of the
2974   various directory commands together eg:-
2975
2976
2977           DIR TO G1TLH 5
2978
2979
2980
2981   or
2982
2983
2984           DIR SUBJECT IOTA 200-250
2985
2986
2987
2988   You can abbreviate all the commands to one letter and use ak1a syn-
2989   tax:-
2990
2991
2992           DIR/T G1* 10   DIR/S QSL 10-100 5
2993
2994
2995
2996   \e[1m11.44.  directory <nn> (0)\e[0m
2997
2998   \e[1mdirectory <nn> \e[22mList last <nn> messages
2999
3000
3001   \e[1m11.45.  directory all (0)\e[0m
3002
3003   \e[1mdirectory all \e[22mList all messages
3004
3005
3006   \e[1m11.46.  directory from <call> (0)\e[0m
3007
3008   \e[1mdirectory from <call> \e[22mList all messages from <call>
3009
3010
3011   \e[1m11.47.  directory new (0)\e[0m
3012
3013   \e[1mdirectory new \e[22mList all new messages
3014
3015
3016   \e[1m11.48.  directory own (0)\e[0m
3017
3018   \e[1mdirectory own \e[22mList your own messages
3019
3020
3021   \e[1m11.49.  directory subject <string> (0)\e[0m
3022
3023   \e[1mdirectory subject <string> \e[22mList all messages with <string> in subject
3024
3025
3026   \e[1m11.50.  directory to <call> (0)\e[0m
3027
3028   \e[1mdirectory to <call> \e[22mList all messages to <call>
3029
3030   \e[1m11.51.  directory- (5)\e[0m
3031
3032   \e[1mdirectory-\e[0m
3033
3034   Sysops can see all users' messages.
3035
3036   \e[1m11.52.  disconnect <call> [<call> ...] (8)\e[0m
3037
3038   \e[1mdisconnect <call> [<call> ...] \e[22mDisconnect a user or cluster
3039
3040   Disconnect any <call> connected locally
3041
3042   \e[1m11.53.  dx [by <call>] <freq> <call> <remarks> (0)\e[0m
3043
3044   \e[1mdx [by <call>] <freq> <call> <remarks> \e[22mSend a DX spot
3045
3046   This is how you send a DX Spot to other users. You can, in fact,
3047   nowenter the <freq> and the <call> either way round.
3048
3049
3050           DX FR0G 144.600   DX 144.600 FR0G   DX 144600 FR0G
3051
3052
3053
3054   will all give the same result. You can add some remarks to the endof
3055   the command and they will be added to the spot.
3056
3057
3058           DX FR0G 144600 this is a test
3059
3060
3061
3062   You can credit someone else by saying:-
3063
3064
3065           DX by G1TLH FR0G 144.600 he isn't on the cluster
3066
3067
3068
3069   The <freq> is compared against the available bands set up in the clus-
3070   ter.  See SHOW/BANDS for more information.
3071
3072   \e[1m11.54.  echo <line> (0)\e[0m
3073
3074   \e[1mecho <line> \e[22mEcho the line to the output
3075
3076   This command is useful in scripts and so forth for printing theline
3077   that you give to the command to the output. You can use thisin
3078   user_default scripts and the SAVE command for titling and so forthThe
3079   script will interpret certain standard "escape" sequences as follows:-
3080
3081
3082          \t - becomes a TAB character (0x09 in ascii)  \a - becomes a BEEP character (0x07 in ascii)  \n - prints a new line
3083
3084
3085
3086   So the following example:-
3087
3088
3089          echo GB7DJK is a dxcluster
3090
3091
3092
3093   produces:-
3094
3095
3096     GB7DJK is a dxcluster
3097
3098
3099
3100   on the output. You don't need a \n on the end of the line you want to
3101   send.A more complex example:-
3102
3103
3104          echo GB7DJK\n\tg1tlh\tDirk\n\tg3xvf\tRichard
3105
3106
3107
3108   produces:-
3109
3110
3111          GB7DJK          g1tlh   Dirk          g3xvf   Richard
3112
3113
3114
3115   on the output.
3116
3117   \e[1m11.55.  export <msgno> <filename> (9)\e[0m
3118
3119   \e[1mexport <msgno> <filename> \e[22mExport a message to a file
3120
3121   Export a message to a file. This command can only be executed on a
3122   localconsole with a fully privileged user. The file produced will be
3123   in a formready to be imported back into the cluster by placing it in
3124   the import directory (/spider/msg/import).This command cannot
3125   overwrite an existing file. This is to provide some measure of
3126   security. Any files written will owned by the same user as the main
3127   cluster, otherwise you can put the new files anywhere the cluster
3128   canaccess. For example:-
3129
3130
3131          EXPORT 2345 /tmp/a
3132
3133
3134
3135   \e[1m11.56.  export_users [<filename>] (9)\e[0m
3136
3137   \e[1mexport_users [<filename>] \e[22mExport the users database to ascii
3138
3139   Export the users database to a file in ascii format. If no filenameis
3140   given then it will export the file to /spider/data/user_asc.If the
3141   file already exists it will be renamed to <filename>.o. In factup to 5
3142   generations of the file can be kept each one with an extra 'o' on
3143   thesuffix. BE WARNED: this will write to any file you have write
3144   access to. No check ismade on the filename (if any) that you specify.
3145
3146   \e[1m11.57.  filtering... (0)\e[0m
3147
3148   \e[1mfiltering... \e[22mFiltering things in DXSpider
3149
3150   There are a number of things you can filter in the DXSpider system.
3151   Theyall use the same general mechanism.In general terms you can create
3152   a 'reject' or an 'accept' filter whichcan have up to 10 lines in it.
3153   You do this using, for example:-
3154
3155
3156          accept/spots .....  reject/spots .....
3157
3158
3159
3160   where ..... are the specific commands for that type of filter. There-
3161   are filters for spots, wwv, announce, wcy and (for sysops)connects.
3162   See each different accept or reject command reference formore
3163   details.There is also a command to clear out one or more lines in a
3164   filter andone to show you what you have set. They are:-
3165
3166
3167          clear/spots 1  clear/spots all
3168
3169
3170
3171   and
3172
3173
3174          show/filter
3175
3176
3177
3178   There is clear/xxxx command for each type of filter.For now we are
3179   going to use spots for the examples, but you can applythe principles
3180   to all types of filter.There are two main types of filter 'accept' or
3181   'reject'; which you usedepends entirely on how you look at the world
3182   and what is leastwriting to achieve what you want. Each filter has 10
3183   lines (of anylength) which are tried in order. If a line matches then
3184   the actionyou have specified is taken (ie reject means ignore it and
3185   acceptmeans gimme it).The important thing to remember is that if you
3186   specify a 'reject'filter (all the lines in it say 'reject/spots' (for
3187   instance)) then ifa spot comes in that doesn't match any of the lines
3188   then you will getit BUT if you specify an 'accept' filter then any
3189   spots that don'tmatch are dumped. For example if I have a one line
3190   accept filter:-
3191
3192
3193          accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
3194
3195
3196
3197   then automatically you will ONLY get VHF spots from or to CQ zones
3198   1415 and 16.  If you set a reject filter like:
3199
3200
3201          reject/spots on hf/cw
3202
3203
3204
3205   Then you will get everything EXCEPT HF CW spots, If you am interested
3206   in IOTAand will work it even on CW then you could say:-
3207
3208
3209          reject/spots on hf/cw and not info iota
3210
3211
3212
3213   But in that case you might only be interested in iota and say:-
3214
3215
3216          accept/spots not on hf/cw or info iota
3217
3218
3219
3220   which is exactly the same. You should choose one or the other untilyou
3221   are confortable with the way it works. Yes, you can mix them(actually
3222   you can have an accept AND a reject on the same line) butdon't try
3223   this at home until you can analyse the results that you getwithout
3224   ringing up the sysop for help.Another useful addition now is filtering
3225   by US state
3226          accept/spots by_state VA,NH,RI,ME
3227
3228
3229
3230   You can arrange your filter lines into logical units, either for
3231   yourown understanding or simply convenience. I have one set fre-
3232   quently:-
3233
3234
3235          reject/spots 1 on hf/cw  reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)
3236
3237
3238
3239   What this does is to ignore all HF CW spots (being a class B I
3240   can'tread any CW and couldn't possibly be interested in HF :-) and
3241   alsorejects any spots on VHF which don't either originate or spot
3242   someonein Europe.This is an exmaple where you would use the line num-
3243   ber (1 and 2 inthis case), if you leave the digit out, the system
3244   assumes '1'. Digits'0'-'9' are available.You can leave the word 'and'
3245   out if you want, it is implied. You canuse any number of brackets to
3246   make the 'expression' as you wantit. There are things called prece-
3247   dence rules working here which meanthat you will NEED brackets in a
3248   situation like line 2 because,without it, will assume:-
3249
3250
3251          (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16
3252
3253
3254
3255   annoying, but that is the way it is. If you use OR - usebrackets.
3256   Whilst we are here CASE is not important. 'And BY_Zone' isjust 'and
3257   by_zone'.If you want to alter your filter you can just redefine one or
3258   morelines of it or clear out one line. For example:-
3259
3260
3261          reject/spots 1 on hf/ssb
3262
3263
3264
3265   or
3266
3267
3268          clear/spots 1
3269
3270
3271
3272   To remove the filter in its entirty:-
3273
3274
3275          clear/spots all
3276
3277
3278
3279   There are similar CLEAR commands for the other filters:-
3280
3281
3282          clear/announce  clear/wcy  clear/wwv
3283
3284
3285
3286   ADVANCED USERS:-Once you are happy with the results you get, you may
3287   like to experiment. my example that filters hf/cw spots and accepts
3288   vhf/uhf spots from EUcan be written with a mixed filter, eg:
3289
3290
3291
3292     rej/spot on hf/cw  acc/spot on 0/30000  acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
3293
3294
3295
3296   each filter slot actually has a 'reject' slot and an 'accept'slot. The
3297   reject slot is executed BEFORE the accept slot.It was mentioned ear-
3298   lier that after a reject test that doesn't match,the default for fol-
3299   lowing tests is 'accept', the reverse is true for'accept'. In the
3300   example what happens is that the reject is executedfirst, any non
3301   hf/cw spot is passed to the accept line, which letsthru everything
3302   else on HF.The next filter line lets through just VHF/UHF spots from
3303   EU.
3304
3305   \e[1m11.58.  forward/latlong <node_call> (8)\e[0m
3306
3307   \e[1mforward/latlong <node_call> \e[22mSend latitude and longitude information to
3308   another cluster
3309
3310   This command sends all the latitude and longitude information that
3311   yourcluster is holding against callsigns.  One advantage of recieving
3312   thisinformation is that more locator information is held by you.
3313   Thismeans that more locators are given on the DX line assuming you
3314   haveSET/DXGRID enabled.  This could be a LOT of information though,
3315   soit is not recommended on slow links.
3316
3317   \e[1m11.59.  forward/opernam <call> (1)\e[0m
3318
3319   \e[1mforward/opernam <call> \e[22mSend out information on this <call> to all
3320   clusters
3321
3322   This command sends out any information held in the user file which can
3323   be broadcast in PC41 protocol packets. This information is Name, QTH,
3324   Locationand Homenode. PC41s are only sent for the information that is
3325   available.
3326
3327   \e[1m11.60.  help (0)\e[0m
3328
3329   \e[1mhelp \e[22mThe HELP Command
3330
3331   HELP is available for a number of commands. The syntax is:-
3332
3333
3334          HELP <cmd>
3335
3336
3337
3338   Where <cmd> is the name of the command you want help on.All commands
3339   can be abbreviated, so SHOW/DX can be abbreviatedto SH/DX, ANNOUNCE
3340   can be shortened to AN and so on.Look at the APROPOS <string> command
3341   which will search the help databasefor the <string> you specify and
3342   give you a list of likely commandsto look at with HELP.
3343
3344   \e[1m11.61.  init <node> (5)\e[0m
3345
3346   \e[1minit <node> \e[22mRe-initialise a link to an AK1A compatible node
3347
3348   This command attempts to re-initialise a link to a (usually) AK1A
3349   nodethat has got confused, usually by a protocol loop of some kind. It
3350   maywork - but you usually will be better off simply disconnecting it
3351   (orbetter, if it is a real AK1A node, doing an RCMD <node> DISC/F
3352   <yournode>).Best of luck - you will need it.
3353
3354   \e[1m11.62.  join <group> (0)\e[0m
3355
3356   \e[1mjoin <group> \e[22mJoin a chat or conference group
3357
3358   JOIN allows you to join a network wide conference group. To join
3359   agroup (called FOC in this case) type:-
3360
3361
3362          JOIN FOC
3363
3364
3365
3366   See also CHAT, LEAVE, SHOW/CHAT
3367
3368   \e[1m11.63.  kill (5)\e[0m
3369
3370   \e[1mkill\e[0m
3371
3372   As a sysop you can kill any message on the system.
3373
3374   \e[1m11.64.  kill <from msgno>-<to msgno> (0)\e[0m
3375
3376   \e[1mkill <from msgno>-<to msgno> \e[22mDelete a range of messages
3377
3378
3379   \e[1m11.65.  kill <from>-<to> (5)\e[0m
3380
3381   \e[1mkill <from>-<to> \e[22mRemove a range of messages from the system
3382
3383
3384   \e[1m11.66.  kill <msgno> [<msgno..] (0)\e[0m
3385
3386   \e[1mkill <msgno> [<msgno..] \e[22mDelete a message from the local system
3387
3388
3389   \e[1m11.67.  kill <msgno> [<msgno> ...] (0)\e[0m
3390
3391   \e[1mkill <msgno> [<msgno> ...] \e[22mRemove or erase a message from the system
3392
3393   You can get rid of any message to or originating from your callsign
3394   using this command. You can remove more than one message at a time.
3395
3396   \e[1m11.68.  kill expunge <msgno> [<msgno..] (6)\e[0m
3397
3398   \e[1mkill expunge <msgno> [<msgno..] \e[22mExpunge a message
3399
3400   Deleting a message using the normal KILL commands only marks that
3401   messagefor deletion. The actual deletion only happens later (usually
3402   two days later).The KILL EXPUNGE command causes the message to be
3403   truly deleted more or lessimmediately.It otherwise is used in the same
3404   way as the KILL command.
3405
3406   \e[1m11.69.  kill from <call> (5)\e[0m
3407
3408   \e[1mkill from <call> \e[22mRemove all messages from a callsign
3409
3410
3411   \e[1m11.70.  kill full <msgno> [<msgno..] (5)\e[0m
3412
3413   \e[1mkill full <msgno> [<msgno..] \e[22mDelete a message from the whole cluster
3414
3415   Delete a message from the local system. You will only be able todelete
3416   messages that you have originated or been sent (unless you arethe
3417   sysop).
3418
3419
3420          KILL 1234-1255
3421
3422
3423
3424   Will delete all the messages that you own between msgnos 1234 and
3425   1255.
3426
3427
3428          KILL from g1tlh
3429
3430
3431
3432   will delete all the messages from g1tlh (if you are g1tlh). Similarly:
3433
3434
3435          KILL to g1tlh
3436
3437
3438
3439   will delete all messages to g1tlh.
3440
3441
3442          KILL FULL 1234
3443
3444
3445
3446   will delete a message (usually a 'bulletin') from the whole cluster
3447   system. This uses the subject field, so any messages that have exactly
3448   thesame subject will be deleted. Beware!
3449
3450   \e[1m11.71.  kill full <msgno> [<msgno] (5)\e[0m
3451
3452   \e[1mkill full <msgno> [<msgno] \e[22mRemove a message from the entire cluster
3453
3454   Remove this message from the entire cluster system as well as your
3455   node.
3456
3457   \e[1m11.72.  kill to <call> (5)\e[0m
3458
3459   \e[1mkill to <call> \e[22mRemove all messages to a callsign
3460
3461
3462   \e[1m11.73.  kill from <regex> (0)\e[0m
3463
3464   \e[1mkill from <regex> \e[22mDelete messages FROM a callsign or pattern
3465
3466
3467   \e[1m11.74.  kill to <regex> (0)\e[0m
3468
3469   \e[1mkill to <regex> \e[22mDelete messages TO a callsign or pattern
3470
3471
3472   \e[1m11.75.  leave <group> (0)\e[0m
3473
3474   \e[1mleave <group> \e[22mLeave a chat or conference group
3475
3476   LEAVE allows you to leave a network wide conference group. To leave
3477   agroup (called FOC in this case) type:-
3478
3479
3480          LEAVE FOC
3481
3482
3483
3484   See also CHAT, JOIN, SHOW/CHAT
3485
3486   \e[1m11.76.  links (0)\e[0m
3487
3488   \e[1mlinks \e[22mShow which nodes is physically connected
3489
3490   This is a quick listing that shows which links are connected andsome
3491   information about them. See WHO for a list of all connections.
3492
3493   \e[1m11.77.  load/aliases (9)\e[0m
3494
3495   \e[1mload/aliases \e[22mReload the command alias table
3496
3497   Reload the /spider/cmd/Aliases file after you have editted it. Youwill
3498   need to do this if you change this file whilst the cluster isrunning
3499   in order for the changes to take effect.
3500
3501   \e[1m11.78.  load/badmsg (9)\e[0m
3502
3503   \e[1mload/badmsg \e[22mReload the bad msg table
3504
3505   Reload the /spider/msg/badmsg.pl file if you have changed it manually
3506   whilstthe cluster is running. This table contains a number of perl
3507   regular expressions which are searched for in the fields targetted of
3508   each message. If any of them match then that message is immediately
3509   deleted on receipt.
3510
3511   \e[1m11.79.  load/badwords (9)\e[0m
3512
3513   \e[1mload/badwords \e[22mReload the bad words table
3514
3515   Reload the /spider/data/badwords file if you have changed it manually
3516   whilstthe cluster is running. This file contains a list of words
3517   which, if foundon certain text portions of PC protocol, will cause
3518   those protocol framesto be rejected. It will all put out a message if
3519   any of these words areused on the announce, dx and talk commands. The
3520   words can be one or more on a line, lines starting with '#' are
3521   ignored.
3522
3523   \e[1m11.80.  load/bands (9)\e[0m
3524
3525   \e[1mload/bands \e[22mReload the band limits table
3526
3527   Reload the /spider/data/bands.pl file if you have changed it manually
3528   whilstthe cluster is running.
3529
3530   \e[1m11.81.  load/cmd_cache (9)\e[0m
3531
3532   \e[1mload/cmd_cache \e[22mReload the automatic command cache
3533
3534   Normally, if you change a command file in the cmd or local_cmd tree
3535   itwill automatially be picked up by the cluster program. Sometimes
3536   itcan get confused if you are doing a lot of moving commands about
3537   ordelete a command in the local_cmd tree and want to use the normal
3538   oneagain. Execute this command to reset everything back to the state
3539   itwas just after a cluster restart.
3540
3541   \e[1m11.82.  load/forward (9)\e[0m
3542
3543   \e[1mload/forward \e[22mReload the msg forwarding routing table
3544
3545   Reload the /spider/msg/forward.pl file if you have changed itmanually
3546   whilst the cluster is running.
3547
3548   \e[1m11.83.  load/keps (5)\e[0m
3549
3550   \e[1mload/keps \e[22mLoad new keps data
3551
3552
3553
3554   \e[1m11.84.  load/keps [nn] (5)\e[0m
3555
3556   \e[1mload/keps [nn] \e[22mLoad new keps data from message
3557
3558   If there is no message number then reload the current Keps data
3559   fromthe Keps.pm data file. You create this file by running
3560
3561
3562         /spider/perl/convkeps.pl <filename>
3563
3564
3565
3566   on a file containing NASA 2 line keps as a message issued by AMSAT. If
3567   there is a message number, then it will take the message, runcon-
3568   vkeps.pl on it and then load the data, all in one step.These messages
3569   are sent to ALL by GB7DJK (and others) from time to time.
3570
3571   \e[1m11.85.  load/messages (9)\e[0m
3572
3573   \e[1mload/messages \e[22mReload the system messages file
3574
3575   If you change the /spider/perl/Messages file (usually
3576   whilstfiddling/writing new commands) you can have them take effect
3577   during acluster session by executing this command. You need to do this
3578   if getsomething like :-unknown message 'xxxx' in lang 'en'
3579
3580   \e[1m11.86.  load/prefixes (9)\e[0m
3581
3582   \e[1mload/prefixes \e[22mReload the prefix table
3583
3584   Reload the /spider/data/prefix_data.pl file if you have changed
3585   itmanually whilst the cluster is running.
3586
3587   \e[1m11.87.  merge <node> [<no spots>/<no wwv>] (5)\e[0m
3588
3589   \e[1mmerge <node> [<no spots>/<no wwv>] \e[22mAsk for the latest spots and WWV
3590
3591   MERGE allows you to bring your spot and wwv database up to date. By
3592   defaultit will request the last 10 spots and 5 WWVs from the node you
3593   select. The node must be connected locally.You can request any number
3594   of spots or wwv and although they will be appendedto your databases
3595   they will not duplicate any that have recently been added (the last 2
3596   days for spots and last month for WWV data).
3597
3598   \e[1m11.88.  msg <cmd> <msgno> [data ... ] (9)\e[0m
3599
3600   \e[1mmsg <cmd> <msgno> [data ... ] \e[22mAlter various message parameters
3601
3602   Alter message parameters like To, From, Subject, whether private or
3603   bulletinor return receipt (RR) is required or whether to keep this
3604   message from timingout.
3605
3606
3607          MSG TO <msgno> <call>     - change TO callsign to <call>  MSG FRom <msgno> <call>   - change FROM callsign to <call>  MSG PRrivate <msgno>      - set private flag  MSG NOPRrivate <msgno>    - unset private flag  MSG RR <msgno>            - set RR flag  MSG NORR <msgno>          - unset RR flag  MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)  MSG NOKEep <msgno>        - unset the keep flag  MSG SUbject <msgno> <new> - change the subject to <new>  MSG WAittime <msgno>      - remove any waitting time for this message  MSG NOREad <msgno>        - mark message as unread  MSG REad <msgno>          - mark message as read  MSG QUeue                 - queue any outstanding bulletins  MSG QUeue 1               - queue any outstanding private messages
3608
3609
3610
3611   You can look at the status of a message by using:-
3612
3613
3614          STAT/MSG <msgno>
3615
3616
3617
3618   This will display more information on the message than DIR does.
3619
3620   \e[1m11.89.  pc <call> <text> (8)\e[0m
3621
3622   \e[1mpc <call> <text> \e[22mSend arbitrary text to a connected callsign
3623
3624   Send some arbitrary text to a locally connected callsign. Noprocessing
3625   is done on the text. This command allows you to send PCProtocol to
3626   unstick things if problems arise (messages get stucketc). eg:-
3627
3628
3629           pc gb7djk PC33^GB7TLH^GB7DJK^400^
3630
3631
3632
3633   or
3634
3635
3636           pc G1TLH Try doing that properly!!!
3637
3638
3639
3640   Send any text you like to the callsign requested. This is used mainly
3641   to sendPC protocol to connected nodes either for testing or to unstick
3642   things. You can also use in the same way as a talk command to a con-
3643   nected user butwithout any processing, added of "from <blah> to <blah"
3644   or whatever.
3645
3646   \e[1m11.90.  ping <node call> (1)\e[0m
3647
3648   \e[1mping <node call> \e[22mCheck the link quality between nodes
3649
3650   This command allows you to send a frame to another cluster node onthe
3651   network and get a return frame.  The time it takes to do thisis a good
3652   indication of the quality of the link.  The actual timeit takes is
3653   output to the console in seconds.Any visible cluster node can be
3654   PINGed.
3655
3656   \e[1m11.91.  rcmd <node call> <cmd> (1)\e[0m
3657
3658   \e[1mrcmd <node call> <cmd> \e[22mSend a command to another DX Cluster
3659
3660   This command allows you to send nearly any command to another DX
3661   Clusternode that is connected to the system. Whether you get any
3662   output is dependant on a) whether the other system knowsthat the node
3663   callsign of this cluster is in fact a node b) whether theother system
3664   is allowing RCMDs from this node and c) whether you havepermission to
3665   send this command at all.
3666
3667   \e[1m11.92.  read (0)\e[0m
3668
3669   \e[1mread \e[22mRead the next unread personal message addressed to you
3670
3671
3672   \e[1m11.93.  read <msgno> (0)\e[0m
3673
3674   \e[1mread <msgno> \e[22mRead the specified message
3675
3676   You can read any messages that are sent as 'non-personal' and also
3677   anymessage either sent by or sent to your callsign.
3678
3679   \e[1m11.94.  read- (5)\e[0m
3680
3681   \e[1mread-\e[0m
3682
3683   As a sysop you may read any message on the system
3684
3685
3686   \e[1m11.95.  reject (0)\e[0m
3687
3688   \e[1mreject \e[22mSet a filter to reject something
3689
3690   Create a filter to reject somethingThere are 2 types of filter, accept
3691   and reject.  See HELP FILTERING for moreinfo.
3692
3693   \e[1m11.96.  reject/announce <call> [input] [0-9] <pattern> (8)\e[0m
3694
3695   \e[1mreject/announce <call> [input] [0-9] <pattern> \e[22mAnnounce filter sysop
3696   version
3697
3698   This version allows a sysop to set a filter for a callsign as well as
3699   thedefault for nodes and users eg:-
3700
3701
3702          reject/ann by G,M,2  reject/ann input node_default by G,M,2  reject/ann user_default by G,M,2
3703
3704
3705
3706   \e[1m11.97.  reject/announce [0-9] <pattern> (0)\e[0m
3707
3708   \e[1mreject/announce [0-9] <pattern> \e[22mSet a 'reject' filter line for
3709   announce
3710
3711   Create an 'reject this announce' line for a filter. A reject filter
3712   line means that if the announce matches this filter it ispassed onto
3713   the user. See HELP FILTERING for more info. Please read thisto
3714   understand how filters work - it will save a lot of grief later on.You
3715   can use any of the following things in this line:-
3716
3717
3718          info <string>            eg: iota or qsl  by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  origin_state <states>                eg: VA,NH,RI,ME  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  by_state <states>                eg: VA,NH,RI,ME  channel <prefixes>  wx 1                     filter WX announces  dest <prefixes>          eg: 6MUK,WDX      (distros)
3719
3720
3721
3722   some examples:-
3723
3724
3725          rej/ann by_zone 14,15,16 and not by G,M,2
3726
3727
3728
3729   You can use the tag 'all' to reject everything eg:
3730
3731
3732          rej/ann all
3733
3734
3735
3736   but this probably for advanced users...
3737
3738   \e[1m11.98.  reject/route <call> [0-9] <pattern> (8)\e[0m
3739
3740   \e[1mreject/route <call> [0-9] <pattern> \e[22mSet an 'reject' filter line for
3741   routing
3742
3743   Create an 'reject this routing PC Protocol' line for a filter. An
3744   reject filter line means that if a PC16/17/19/21/24/41/50 matches this
3745   filter it is NOT passed thru that interface. See HELP FILTERING for
3746   more info. Please read this to understand how filters work - it will
3747   save a lot of grief later on.You can use any of the following things
3748   in this line:-
3749
3750
3751     call <prefixes>        the callsign of the thingy  call_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  call_itu <prefixes or numbers>     or: G,GM,GW  call_zone <prefixes or numbers>  call_state <states>                eg: VA,NH,RI,ME  origin <prefixes>      really the interface it came in on  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  origin_state <states>                eg: VA,NH,RI,ME
3752
3753
3754
3755   some examples:-
3756
3757
3758          rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
3759
3760
3761
3762   You can use the tag 'all' to reject everything eg:
3763
3764
3765          rej/route all     (equiv to [very] restricted mode)
3766
3767
3768
3769   as with ACCEPT/ROUTE 'by' is now a synonym for 'call'.
3770
3771   \e[1m11.99.  reject/spots <call> [input] [0-9] <pattern> (8)\e[0m
3772
3773   \e[1mreject/spots <call> [input] [0-9] <pattern> \e[22mSpot filter sysop version
3774
3775   This version allows a sysop to set a filter for a callsign as well as
3776   thedefault for nodes and users eg:-
3777
3778
3779          reject/spot db0sue-7 1 by_zone 14,15,16  reject/spot node_default all  set/hops node_default 10
3780
3781
3782
3783          reject/spot user_default by G,M,2
3784
3785
3786
3787   \e[1m11.100.  reject/spots [0-9] <pattern> (0)\e[0m
3788
3789   \e[1mreject/spots [0-9] <pattern> \e[22mSet a 'reject' filter line for spots
3790
3791   Create a 'reject this spot' line for a filter. A reject filter line
3792   means that if the spot matches this filter it isdumped (not passed
3793   on). See HELP FILTERING for more info. Please read thisto understand
3794   how filters work - it will save a lot of grief later on.You can use
3795   any of the following things in this line:-
3796
3797
3798          freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m  on <range>             same as 'freq'  call <prefixes>        eg: G,PA,HB9  info <string>          eg: iota or qsl  by <prefixes>              call_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  call_itu <prefixes or numbers>     or: G,GM,GW  call_zone <prefixes or numbers>  call_state <states>                eg: VA,NH,RI,ME  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  by_state <states>                eg: VA,NH,RI,ME  origin <prefixes>  channel <prefixes>
3799
3800
3801
3802          rej/spot 1 on hf  rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
3803
3804
3805
3806   You can use the tag 'all' to reject everything eg:
3807
3808
3809          rej/spot 3 all
3810
3811
3812   but this probably for advanced users...
3813
3814   \e[1m11.101.  reject/wcy <call> [input] [0-9] <pattern> (8)\e[0m
3815
3816   \e[1mreject/wcy <call> [input] [0-9] <pattern> \e[22mWCY filter sysop version
3817
3818   This version allows a sysop to set a filter for a callsign as well as
3819   thedefault for nodes and users eg:-
3820
3821
3822          reject/wcy gb7djk all
3823
3824
3825
3826   \e[1m11.102.  reject/wcy [0-9] <pattern> (0)\e[0m
3827
3828   \e[1mreject/wcy [0-9] <pattern> \e[22mset a 'reject' WCY filter
3829
3830   It is unlikely that you will want to do this, but if you do then you
3831   canfilter on the following fields:-
3832
3833
3834          by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  channel <prefixes>
3835
3836
3837
3838   There are no examples because WCY Broadcasts only come from one place
3839   andyou either want them or not (see UNSET/WCY if you don't want
3840   them).This command is really provided for future use.See HELP FILTER
3841   for information.
3842
3843   \e[1m11.103.  reject/wwv <call> [input] [0-9] <pattern> (8)\e[0m
3844
3845   \e[1mreject/wwv <call> [input] [0-9] <pattern> \e[22mWWV filter sysop version
3846
3847   This version allows a sysop to set a filter for a callsign as well as
3848   thedefault for nodes and users eg:-
3849
3850
3851          reject/wwv db0sue-7 1 by_zone 4  reject/wwv node_default all
3852
3853
3854
3855          reject/wwv user_default by W
3856
3857
3858
3859   \e[1m11.104.  reject/wwv [0-9] <pattern> (0)\e[0m
3860
3861   \e[1mreject/wwv [0-9] <pattern> \e[22mset a 'reject' WWV filter
3862
3863   It is unlikely that you will want to do this, but if you do then you
3864   canfilter on the following fields:-
3865
3866
3867          by <prefixes>            eg: G,M,2           origin <prefixes>  origin_dxcc <prefixes or numbers>    eg: 61,62 (from eg: sh/pre G)  origin_itu <prefixes or numbers>     or: G,GM,GW  origin_zone <prefixes or numbers>  by_dxcc <prefixes or numbers>  by_itu <prefixes or numbers>  by_zone <prefixes or numbers>  channel <prefixes>
3868
3869
3870
3871   for example
3872
3873
3874     reject/wwv by_zone 14,15,16
3875
3876
3877
3878   is probably the only useful thing to do (which will only show WWV
3879   broadcastsby stations in the US).See HELP FILTER for information.
3880
3881   \e[1m11.105.  reply (0)\e[0m
3882
3883   \e[1mreply \e[22mReply (privately) to the last message that you have read
3884
3885
3886   \e[1m11.106.  reply <msgno> (0)\e[0m
3887
3888   \e[1mreply <msgno> \e[22mReply (privately) to the specified message
3889
3890
3891   \e[1m11.107.  reply b <msgno> (0)\e[0m
3892
3893   \e[1mreply b <msgno> \e[22mReply as a Bulletin to the specified message
3894
3895
3896   \e[1m11.108.  reply noprivate <msgno> (0)\e[0m
3897
3898   \e[1mreply noprivate <msgno> \e[22mReply as a Bulletin to the specified message
3899
3900
3901   \e[1m11.109.  reply rr <msgno> (0)\e[0m
3902
3903   \e[1mreply rr <msgno> \e[22mReply to the specified message with read receipt
3904
3905   You can reply to a message and the subject will automatically
3906   have"Re:" inserted in front of it, if it isn't already present.You can
3907   also use all the extra qualifiers such as RR, PRIVATE, NOPRIVATE, B
3908   that you can use with the SEND command (see SENDfor further details)
3909
3910   \e[1m11.110.  save [-d -t -a] <filename> "<cmd>" [...] (9)\e[0m
3911
3912   \e[1msave [-d -t -a] <filename> "<cmd>" [...] \e[22mSave command output to a file
3913
3914   This sysop only cammand allows you to save the output of one or
3915   morecommands to a file. For example:-
3916
3917
3918          save /spider/packclus/dxstats show/dxstat
3919
3920
3921
3922   will save the output of the normal command "show/dxstat" to the
3923   file"dxstats" in the files area.You can have some extra flags to the
3924   save which will either date stamp or time stamp or both the filename
3925   so:-
3926
3927
3928          save -d /tmp/a <cmd> creates /tmp/a_6-Jan-2002  save -t /tmp/a <cmd> creates /tmp/a_2301Z  save -d -t /tmp/a <cmd> creates /tmp/a_6-Jan-2002_2301Z
3929
3930
3931
3932   The -a flag means append to the file instead of overwriting it.You can
3933   have more than one command on the line, to do this you MUSTenclose
3934   each command in double quotes (") eg:-
3935
3936
3937          save /tmp/a "sh/hfstats" "blank +" "sh/vhfstats"
3938
3939
3940   or
3941
3942
3943          save /tmp/a "sh/hfstats","blank +","sh/vhfstats"
3944
3945
3946
3947   You can only write into places that the cluster has permission for
3948   (whichis that of the "sysop" user [which had BETTER NOT BE "root"]),
3949   you will need to create any directories you want to put stuff in
3950   beforehand as well.It is likely that you will want to run these com-
3951   mands in a crontab type situation. You would do that something like:-
3952
3953
3954          0 0 * * * run_cmd('save /tmp/dxstats "echo DXStat Table", "sh/dxstats"')
3955
3956
3957
3958   Note that you still enclose each command with (") characters but you
3959   mustenclose the entire save command in (') characters. Now in fact,
3960   this can be varied if you know what you are doing. See theadmin manual
3961   for more details.
3962
3963   \e[1m11.111.  send <call> [<call> ...] (0)\e[0m
3964
3965   \e[1msend <call> [<call> ...] \e[22mSend a message to one or more callsigns
3966
3967
3968   \e[1m11.112.  send copy <msgno> <call> (0)\e[0m
3969
3970   \e[1msend copy <msgno> <call> \e[22mSend a copy of a  message to someone
3971
3972
3973   \e[1m11.113.  send noprivate <call> (0)\e[0m
3974
3975   \e[1msend noprivate <call> \e[22mSend a message to all stations
3976
3977   All the SEND commands will create a message which will be sent either
3978   toan individual callsign or to one of the 'bulletin' addresses. SEND
3979   <call> on its own acts as though you had typed SEND PRIVATE, that isit
3980   will mark the message as personal and send it to the cluster node
3981   thatthat callsign is connected to. If the <call> you have specified is
3982   in facta known bulletin category on your node (eg: ALL) then the
3983   message shouldautomatically become a bulletin.You can have more than
3984   one callsign in all of the SEND commands.You can have multiple
3985   qualifiers so that you can have for example:-
3986
3987
3988          SEND RR COPY 123 PRIVATE G1TLH G0RDI
3989
3990
3991
3992   which should send a copy of message 123 to G1TLH and G0RDI and you
3993   willreceive a read receipt when they have read the message.SB is an
3994   alias for SEND NOPRIVATE (or send a bulletin in BBS speak)SP is an
3995   alias for SEND PRIVATEThe system will ask you for a subject. Conven-
3996   tionally this should be no longer than 29 characters for compatibil-
3997   ity. Most modern clustersoftware should accept more.You will now be
3998   prompted to start entering your text. You finish the message by enter-
3999   ing '/EX' on a new line. For instance:
4000
4001
4002          ...  bye then Jim  73 Dirk  /ex
4003
4004
4005
4006   If you have started a message and you don't want to keep it then you-
4007   can abandon the message with '/ABORT' on a new line, like:-
4008
4009
4010          line 1  line 2  oh I just can't be bothered with this  /abort
4011
4012
4013
4014   If you abort the message it will NOT be sent.When you are entering the
4015   text of your message, most normal output (suchas DX announcements and
4016   so on are suppressed and stored for latter display(upto 20 such lines
4017   are stored, as new ones come along, so the oldestlines are
4018   dropped).Also, you can enter normal commands commands (and get the
4019   output immediately) whilst in the middle of a message. You do this by
4020   typingthe command preceeded by a '/' character on a new line, so:-
4021
4022
4023          /dx g1tlh 144010 strong signal
4024
4025
4026
4027   Will issue a dx annoucement to the rest of the cluster. Also, you can
4028   add the output of a command to your message by preceeding the command
4029   with '//', thus :-
4030
4031
4032          //sh/vhftable
4033
4034
4035
4036   This will show YOU the output from SH/VHFTABLE and also store it in
4037   themessage. You can carry on with the message until you are ready to
4038   send it.
4039
4040   \e[1m11.114.  send private <call> (0)\e[0m
4041
4042   \e[1msend private <call> \e[22mSend a personal message
4043
4044
4045   \e[1m11.115.  send rr <call> (0)\e[0m
4046
4047   \e[1msend rr <call> \e[22mSend a message and ask for a read receipt
4048
4049
4050   \e[1m11.116.  set/address <your address> (0)\e[0m
4051
4052   \e[1mset/address <your address> \e[22mRecord your postal address
4053
4054
4055   \e[1m11.117.  set/announce (0)\e[0m
4056
4057   \e[1mset/announce \e[22mAllow announce messages to come out on your terminal
4058
4059
4060   \e[1m11.118.  set/anntalk (0)\e[0m
4061
4062   \e[1mset/anntalk \e[22mAllow talk like announce messages on your terminal
4063
4064
4065   \e[1m11.119.  set/arcluster <call> [<call>..] (5)\e[0m
4066
4067   \e[1mset/arcluster <call> [<call>..] \e[22mMake the callsign an AR-Cluster node
4068
4069
4070
4071   \e[1m11.120.  set/baddx <call>.. (8)\e[0m
4072
4073   \e[1mset/baddx <call>.. \e[22mStop callsigns in a dx spot being propagated
4074
4075
4076   \e[1m11.121.  set/badnode <call>.. (8)\e[0m
4077
4078   \e[1mset/badnode <call>.. \e[22mStop spots from this node being propagated
4079
4080
4081   \e[1m11.122.  set/badspotter <call>.. (8)\e[0m
4082
4083   \e[1mset/badspotter <call>.. \e[22mStop spots from this callsign being propagated
4084
4085
4086   \e[1m11.123.  set/badword <word>.. (8)\e[0m
4087
4088   \e[1mset/badword <word>.. \e[22mStop things with this word being propagated
4089
4090
4091   \e[1m11.124.  set/bbs <call> [<call>..] (5)\e[0m
4092
4093   \e[1mset/bbs <call> [<call>..] \e[22mMake the callsign a BBS
4094
4095
4096   \e[1m11.125.  set/beep (0)\e[0m
4097
4098   \e[1mset/beep \e[22mAdd a beep to DX and other messages on your terminal
4099
4100
4101   \e[1m11.126.  set/clx <call> [<call>..] (5)\e[0m
4102
4103   \e[1mset/clx <call> [<call>..] \e[22mMake the callsign an CLX node
4104
4105
4106   \e[1m11.127.  set/debug <name> (9)\e[0m
4107
4108   \e[1mset/debug <name> \e[22mAdd a debug level to the debug set
4109
4110
4111   \e[1m11.128.  set/dx (0)\e[0m
4112
4113   \e[1mset/dx \e[22mAllow DX messages to come out on your terminal
4114
4115
4116   \e[1m11.129.  set/dxcq (0)\e[0m
4117
4118   \e[1mset/dxcq \e[22mShow CQ Zones on the end of DX announcements
4119
4120
4121   \e[1m11.130.  set/dxgrid (0)\e[0m
4122
4123   \e[1mset/dxgrid \e[22mAllow QRA Grid Squares on the end of DX announcements
4124
4125
4126   \e[1m11.131.  set/dxitu (0)\e[0m
4127
4128   \e[1mset/dxitu \e[22mShow ITU Zones on the end of DX announcements
4129
4130
4131   \e[1m11.132.  set/dxnet <call> [<call>..] (5)\e[0m
4132
4133   \e[1mset/dxnet <call> [<call>..] \e[22mMake the callsign an DXNet node
4134
4135
4136
4137   \e[1m11.133.  set/echo (0)\e[0m
4138
4139   \e[1mset/echo \e[22mMake the cluster echo your input
4140
4141
4142   \e[1m11.134.  set/email <email> ... (0)\e[0m
4143
4144   \e[1mset/email <email> ... \e[22mSet email address(es) and forward your personals
4145
4146
4147   \e[1m11.135.  set/here (0)\e[0m
4148
4149   \e[1mset/here \e[22mTell the system you are present at your terminal
4150
4151
4152   \e[1m11.136.  set/homenode <node>  (0)\e[0m
4153
4154   \e[1mset/homenode <node>  \e[22mSet your normal cluster callsign
4155
4156   Tell the cluster system where you normally connect to. Any Messages
4157   sentto you will normally find their way there should you not be
4158   connected.eg:-
4159
4160
4161          SET/HOMENODE gb7djk
4162
4163
4164
4165   \e[1m11.137.  set/hops <call> ann|spots|route|wwv|wcy <n> (8)\e[0m
4166
4167   \e[1mset/hops <call> ann|spots|route|wwv|wcy <n> \e[22mSet hop count
4168
4169
4170   \e[1m11.138.  set/isolate (9)\e[0m
4171
4172   \e[1mset/isolate \e[22mIsolate a node from the rest of the network
4173
4174   Connect a node to your system in such a way that you are a full
4175   protocolmember of its network and can see all spots on it, but nothing
4176   either leaksout from it nor goes back into from the rest of the nodes
4177   connected to you.You can potentially connect several nodes in this
4178   way.
4179
4180   \e[1m11.139.  set/language <lang> (0)\e[0m
4181
4182   \e[1mset/language <lang> \e[22mSet the language you want to use
4183
4184   You can select the language that you want the cluster to use.
4185   Currentlythe languages available are en (English), de (German), es
4186   (Spanish),Czech (cz), French (fr), Portuguese (pt), Italian (it) and
4187   nl (Dutch).
4188
4189   \e[1m11.140.  set/location <lat & long> (0)\e[0m
4190
4191   \e[1mset/location <lat & long> \e[22mSet your latitude and longitude
4192
4193
4194   \e[1m11.141.  set/lockout <call> (9)\e[0m
4195
4196   \e[1mset/lockout <call> \e[22mStop a callsign connecting to the cluster
4197
4198
4199
4200   \e[1m11.142.  set/logininfo (0)\e[0m
4201
4202   \e[1mset/logininfo \e[22mInform when a station logs in locally
4203
4204
4205   \e[1m11.143.  set/name <your name> (0)\e[0m
4206
4207   \e[1mset/name <your name> \e[22mSet your name
4208
4209   Tell the system what your name is eg:-
4210
4211
4212          SET/NAME Dirk
4213
4214
4215
4216   \e[1m11.144.  set/node <call> [<call>..] (5)\e[0m
4217
4218   \e[1mset/node <call> [<call>..] \e[22mMake the callsign an AK1A cluster
4219
4220   Tell the system that the call(s) are to be treated as AK1A cluster
4221   andfed PC Protocol rather normal user commands.
4222
4223   \e[1m11.145.  set/obscount <count> <call> (8)\e[0m
4224
4225   \e[1mset/obscount <count> <call> \e[22mSet the 'pump-up' obscelence PING counter
4226
4227   From 1.35 onwards neighbouring nodes are pinged at regular intervals
4228   (seeSET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a
4229   'pump-up'counter which is decremented on every outgoing ping and then
4230   reset tothe 'obscount' value on every incoming ping. The default value
4231   of thisparameter is 2. What this means is that a neighbouring node
4232   will be pinged twice at (default) 300 second intervals and if no reply
4233   has been heard just beforewhat would be the third attempt, that node
4234   is disconnected.If a ping is heard then the obscount is reset to the
4235   full value. Usingdefault values, if a node has not responded to a ping
4236   within 15 minutes,it is disconnected.You can set this parameter
4237   between 1 and 9.It is STRONGLY recommended that you don't change the
4238   default.
4239
4240   \e[1m11.146.  set/page <lines per page> (0)\e[0m
4241
4242   \e[1mset/page <lines per page> \e[22mSet the lines per page
4243
4244   Tell the system how many lines you wish on a page when the number of
4245   lineof output from a command is more than this. The default is 20.
4246   Setting itexplicitly to 0 will disable paging.
4247
4248
4249          SET/PAGE 30  SET/PAGE 0
4250
4251
4252
4253   The setting is stored in your user profile.
4254
4255   \e[1m11.147.  set/password (0)\e[0m
4256
4257   \e[1mset/password \e[22mSet your own password
4258
4259   This command only works for a 'telnet' user (currently). It willonly
4260   work if you have a password already set. This initial passwordcan only
4261   be set by the sysop.When you execute this command it will ask you for
4262   your old password,then ask you to type in your new password twice (to
4263   make sure youget it right). You may or may not see the data echoed on
4264   the screenas you type, depending on the type of telnet client you
4265   have.
4266
4267   \e[1m11.148.  set/password <callsign> <string> (9)\e[0m
4268
4269   \e[1mset/password <callsign> <string> \e[22mSet a users password
4270
4271   The password for a user can only be set by a full sysop. The stringcan
4272   contain any characters. The way this field is used depends on context.
4273   If it is being used inthe SYSOP command context then you are offered 5
4274   random numbers and youhave to supply the corresponding letters. This
4275   is now mainly for ax25connections.If it is being used on incoming
4276   telnet connections then, if a passwordis set or the:
4277
4278
4279          set/var $main::passwdreq = 1
4280
4281
4282
4283   command is executed in the startup script, then a password prompt
4284   isgiven after the normal 'login: ' prompt.
4285
4286   \e[1m11.149.  set/pinginterval <time> <nodecall> (9)\e[0m
4287
4288   \e[1mset/pinginterval <time> <nodecall> \e[22mSet ping time to neighbouring nodes
4289
4290   As from release 1.35 all neighbouring nodes are pinged at regular
4291   intervalsin order to determine the rolling quality of the link and, in
4292   future, toaffect routing decisions. The default interval is 300 secs
4293   or 5 minutes.You can use this command to set a different interval.
4294   Please don't. But if you do the value you enter is treated as minutes
4295   up 30 and secondsfor numbers greater than that.This is used also to
4296   help determine when a link is down at the far end(as certain cluster
4297   software doesn't always notice), see SET/OBSCOUNTfor more
4298   information.If you must change it (and it may be useful for internet
4299   connected nodeson dynamic IP addresses that go away after a set time
4300   of usage) the timecan be specified as:-
4301
4302
4303          5      which if less than 30 is converted to minutes otherwise is          taken as the no of seconds between pings.   120s   120 seconds  5m     5 minutes  1h     1 hour
4304
4305
4306
4307   Please be aware that this causes traffic to occur on the link, setting
4308   this value too low may annoy your neighbours beyond the point of
4309   endurance!You can switch this off by setting it to 0.
4310
4311   \e[1m11.150.  set/privilege <n> <call> [<call..] (9)\e[0m
4312
4313   \e[1mset/privilege <n> <call> [<call..] \e[22mSet privilege level on a call
4314
4315   Set the privilege level on a callsign. The privilege levels that
4316   pertainto commands are as default:-
4317
4318
4319          0 - normal user  1 - allow remote nodes normal user RCMDs  5 - various privileged commands (including shutdown, but not disc-      connect), the normal level for another node.  8 - more privileged commands (including disconnect)  9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS      LEVEL.
4320
4321
4322
4323   If you are a sysop and you come in as a normal user on a remote con-
4324   nectionyour privilege will automatically be set to 0.
4325
4326   \e[1m11.151.  set/prompt <string> (0)\e[0m
4327
4328   \e[1mset/prompt <string> \e[22mSet your prompt to <string>
4329
4330
4331   \e[1m11.152.  set/qra <locator> (0)\e[0m
4332
4333   \e[1mset/qra <locator> \e[22mSet your QRA Grid locator
4334
4335   Tell the system what your QRA (or Maidenhead) locator is. If you have
4336   notdone a SET/LOCATION then your latitude and longitude will be set
4337   roughlycorrectly (assuming your locator is correct ;-). For example:-
4338
4339
4340          SET/QRA JO02LQ
4341
4342
4343
4344   \e[1m11.153.  set/qth <your qth> (0)\e[0m
4345
4346   \e[1mset/qth <your qth> \e[22mSet your QTH
4347
4348   Tell the system where you are. For example:-
4349
4350
4351          SET/QTH East Dereham, Norfolk
4352
4353
4354
4355   \e[1m11.154.  set/register <call> ... (9)\e[0m
4356
4357   \e[1mset/register <call> ... \e[22mMark a user as registered
4358
4359
4360   \e[1m11.155.  set/spider <call> [<call>..] (5)\e[0m
4361
4362   \e[1mset/spider <call> [<call>..] \e[22mMake the callsign an DXSpider node
4363
4364   Tell the system that the call(s) are to be treated as DXSpider node
4365   andfed new style DX Protocol rather normal user commands.
4366
4367   \e[1m11.156.  set/sys_location <lat & long> (9)\e[0m
4368
4369   \e[1mset/sys_location <lat & long> \e[22mSet your cluster latitude and longitude
4370
4371   In order to get accurate headings and such like you must tell the
4372   systemwhat your latitude and longitude is. If you have not yet done a
4373   SET/QRAthen this command will set your QRA locator for you. For
4374   example:-
4375
4376
4377          SET/LOCATION 52 22 N 0 57 E
4378
4379
4380
4381   \e[1m11.157.  set/sys_qra <locator> (9)\e[0m
4382
4383   \e[1mset/sys_qra <locator> \e[22mSet your cluster QRA Grid locator
4384
4385
4386   \e[1m11.158.  set/talk (0)\e[0m
4387
4388   \e[1mset/talk \e[22mAllow TALK messages to come out on your terminal
4389
4390
4391
4392   \e[1m11.159.  set/usdb <call> <state> <city> (9)\e[0m
4393
4394   \e[1mset/usdb <call> <state> <city> \e[22madd/update a US DB callsign
4395
4396   This command allows you to add or alter a callsign in the US
4397   statedatabase. Use with extreme caution. Anything you do here will
4398   beoverwritten by any weekly updates that affect this callsign
4399
4400
4401          set/usdb g1tlh nh downtown rindge
4402
4403
4404
4405   see also DELETE/USDB
4406
4407   \e[1m11.160.  set/usstate (0)\e[0m
4408
4409   \e[1mset/usstate \e[22mAllow US State info on the end of DX announcements
4410
4411
4412   \e[1m11.161.  set/wcy (0)\e[0m
4413
4414   \e[1mset/wcy \e[22mAllow WCY messages to come out on your terminal
4415
4416
4417   \e[1m11.162.  set/wwv (0)\e[0m
4418
4419   \e[1mset/wwv \e[22mAllow WWV messages to come out on your terminal
4420
4421
4422   \e[1m11.163.  set/wx (0)\e[0m
4423
4424   \e[1mset/wx \e[22mAllow WX messages to come out on your terminal
4425
4426
4427   \e[1m11.164.  show/baddx (1)\e[0m
4428
4429   \e[1mshow/baddx \e[22mShow all the bad dx calls in the system
4430
4431   Display all the bad dx callsigns in the system, see SET/BADDXfor more
4432   information.
4433
4434   \e[1m11.165.  show/badnode (1)\e[0m
4435
4436   \e[1mshow/badnode \e[22mShow all the bad nodes in the system
4437
4438   Display all the bad node callsigns in the system, see SET/BADNODEfor
4439   more information.
4440
4441   \e[1m11.166.  show/badspotter (1)\e[0m
4442
4443   \e[1mshow/badspotter \e[22mShow all the bad spotters in the system
4444
4445   Display all the bad spotter's callsigns in the system, see
4446   SET/BADSPOTTERfor more information.
4447
4448   \e[1m11.167.  show/badword (1)\e[0m
4449
4450   \e[1mshow/badword \e[22mShow all the bad words in the system
4451
4452   Display all the bad words in the system, see SET/BADWORDfor more
4453   information.
4454
4455
4456
4457   \e[1m11.168.  show/chat [<group>] [<lines>] (0)\e[0m
4458
4459   \e[1mshow/chat [<group>] [<lines>] \e[22mShow any chat or conferencing
4460
4461   This command allows you to see any chat or conferencing that has
4462   occurred whilst you were away. SHOW/CHAT on its own will show data
4463   forall groups. If you use a group name then it will show only chat
4464   forthat group.
4465
4466   \e[1m11.169.  show/configuration [<node>] (0)\e[0m
4467
4468   \e[1mshow/configuration [<node>] \e[22mShow all the nodes and users visible
4469
4470   This command allows you to see all the users that can be seenand the
4471   nodes to which they are connected.This command is normally abbreviated
4472   to: sh/cNormally, the list returned will be just for the nodes from
4473   your country (because the list otherwise will be very long).
4474
4475
4476          SH/C ALL
4477
4478
4479
4480   will produce a complete list of all nodes. BE WARNED: the list that is
4481   returned can be VERY longIt is possible to supply a node or part of a
4482   prefix and you will get a list of the users for that node or list of
4483   nodes starting withthat prefix.
4484
4485
4486          SH/C GB7DJK
4487
4488
4489
4490          SH/C SK
4491
4492
4493
4494   \e[1m11.170.  show/configuration/node (0)\e[0m
4495
4496   \e[1mshow/configuration/node \e[22mShow all the nodes connected locally
4497
4498   Show all the nodes connected to this node.
4499
4500   \e[1m11.171.  show/connect (1)\e[0m
4501
4502   \e[1mshow/connect \e[22mShow all the active connections
4503
4504   This command shows information on all the active connections known
4505   tothe node. This command gives slightly more information than WHO.
4506
4507   \e[1m11.172.  show/contest <year and month> (0)\e[0m
4508
4509   \e[1mshow/contest <year and month> \e[22mShow all the contests for a month
4510
4511   Show all known contests which are maintained at
4512   http://www.sk3bg.se/contest/for a particular month or year. The format
4513   is reasonably flexible.For example:-
4514
4515
4516          SH/CONTEST sep2003  SH/CONTEST 03 march
4517
4518
4519
4520   \e[1m11.173.  show/date [<prefix>|<callsign>] (0)\e[0m
4521
4522   \e[1mshow/date [<prefix>|<callsign>] \e[22mShow the local time
4523
4524   This is very nearly the same as SHOW/TIME, the only difference the
4525   formatof the date string if no arguments are given.If no prefixes or
4526   callsigns are given then this command returns the localtime and UTC as
4527   the computer has it right now. If you give some prefixesthen it will
4528   show UTC and UTC + the local offset (not including DST) atthe prefixes
4529   or callsigns that you specify.
4530
4531   \e[1m11.174.  show/db0sdx <callsign> (0)\e[0m
4532
4533   \e[1mshow/db0sdx <callsign> \e[22mShow QSL infomation from DB0SDX database
4534
4535   This command queries the DB0SDX QSL server on the internetand returns
4536   any information available for that callsign. This serviceis provided
4537   for users of this software by http://www.qslinfo.de.See also SHOW/QRZ,
4538   SHOW/WM7D.
4539
4540   \e[1m11.175.  show/debug (9)\e[0m
4541
4542   \e[1mshow/debug \e[22mShow what levels of debug information you are logging
4543
4544
4545   \e[1m11.176.  show/dx (0)\e[0m
4546
4547   \e[1mshow/dx \e[22mInterrogate the spot database
4548
4549   If you just type SHOW/DX you will get the last so many spots(sysop
4550   configurable, but usually 10).In addition you can add any number of
4551   these commands in very nearlyany order to the basic SHOW/DX command,
4552   they are:-
4553
4554
4555         on <band>       - eg 160m 20m 2m 23cm 6mm on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS) on <from>/<to>  - eg 1000/4000 14000-30000  (in Khz)    <from>-<to>
4556
4557
4558
4559         <number>        - the number of spots you want <from>-<to>     - <from> spot no <to> spot no in the selected list <from>/<to>
4560
4561
4562
4563         <prefix>        - for a spotted callsign beginning with <prefix> *<suffix>       - for a spotted callsign ending in <suffix> *<string>*      - for a spotted callsign containing <string>
4564
4565
4566
4567         day <number>    - starting <number> days ago day <from>-<to> - <from> days <to> days ago     <from>/<to>
4568
4569
4570
4571         info <text>     - any spots containing <text> in the info or remarks
4572
4573
4574
4575    by <call>       - any spots spotted by <call> (spotter <call> is the                    same).
4576
4577
4578
4579         qsl             - this automatically looks for any qsl info on the call                   held in the spot database.
4580
4581
4582
4583         iota [<iota>]   - If the iota island number is missing it will look for                  the string iota and anything which looks like an iota                  island number. If you specify then it will look for                    that island.
4584
4585
4586
4587         qra [<locator>] - this will look for the specific locator if you specify                   one or else anything that looks like a locator.
4588
4589
4590
4591         dxcc            - treat the prefix as a 'country' and look for spots                   from that country regardless of actual prefix.                   eg dxcc oq2
4592
4593
4594
4595                           You can also use this with the 'by' keyword so                    eg by W dxcc
4596
4597
4598
4599         e.g.
4600
4601
4602
4603           SH/DX 9m0   SH/DX on 20m info iota   SH/DX 9a on vhf day 30   SH/DX rf1p qsl   SH/DX iota    SH/DX iota eu-064   SH/DX qra jn86   SH/DX dxcc oq2   SH/DX dxcc oq2 by w dxcc
4604
4605
4606
4607   \e[1m11.177.  show/dxcc <prefix> (0)\e[0m
4608
4609   \e[1mshow/dxcc <prefix> \e[22mInterrogate the spot database by country
4610
4611   This command takes the <prefix> (which can be a full or partial
4612   callsign if desired), looks up which internal country number it isand
4613   then displays all the spots as per SH/DX for that country.This is now
4614   an alias for 'SHOW/DX DXCC' The options for SHOW/DX also apply to this
4615   command.   e.g.
4616
4617
4618           SH/DXCC G   SH/DXCC W on 20m iota
4619
4620
4621
4622   This can be done with the SHOW/DX command like this:-
4623
4624
4625
4626      SH/DX dxcc g   SH/DX dxcc w on 20m iota
4627
4628
4629
4630   \e[1m11.178.  show/dxqsl <callsign> (0)\e[0m
4631
4632   \e[1mshow/dxqsl <callsign> \e[22mShow any QSL info gathered from spots
4633
4634   The node collects information from the comment fields in spots
4635   (thingslike 'VIA EA7WA' or 'QSL-G1TLH') and stores these in a
4636   database.This command allows you to interrogate that database and if
4637   the callsignis found will display the manager(s) that people have
4638   spotted. This information is NOT reliable, but it is normally
4639   reasonably accurate ifit is spotted enough times.For example:-
4640
4641
4642          sh/dxqsl 4k9w
4643
4644
4645
4646   You can check the raw input spots yourself with:-
4647
4648
4649          sh/dx 4k9w qsl
4650
4651
4652
4653   This gives you more background information.
4654
4655   \e[1m11.179.  show/dxstats [days] [date] (0)\e[0m
4656
4657   \e[1mshow/dxstats [days] [date] \e[22mShow the DX Statistics
4658
4659   Show the total DX spots for the last <days> no of days (default is
4660   31), starting from a <date> (default: today).
4661
4662   \e[1m11.180.  show/files [<filearea> [<string>]] (0)\e[0m
4663
4664   \e[1mshow/files [<filearea> [<string>]] \e[22mList the contents of a filearea
4665
4666   SHOW/FILES on its own will show you a list of the various
4667   fileareasavailable on the system. To see the contents of a particular
4668   filearea type:-
4669
4670
4671           SH/FILES <filearea>
4672
4673
4674
4675   where <filearea> is the name of the filearea you want to see the con-
4676   tents of.You can also use shell globbing characters like '*' and '?'
4677   in astring to see a selection of files in a filearea eg:-
4678
4679
4680           SH/FILES bulletins arld*
4681
4682
4683
4684   See also TYPE - to see the contents of a file.
4685
4686   \e[1m11.181.  show/filter (0)\e[0m
4687
4688   \e[1mshow/filter \e[22mShow the contents of all the filters you have set
4689
4690
4691   Show the contents of all the filters that are set. This command
4692   displaysall the filters set - for all the various categories.
4693
4694   \e[1m11.182.  show/hfstats [days] [date] (0)\e[0m
4695
4696   \e[1mshow/hfstats [days] [date] \e[22mShow the HF DX Statistics
4697
4698   Show the HF DX spots breakdown by band for the last <days> no of days
4699   (default is 31), starting from a <date> (default: today).
4700
4701   \e[1m11.183.  show/hftable [days] [date] [prefix ...] (0)\e[0m
4702
4703   \e[1mshow/hftable [days] [date] [prefix ...] \e[22mShow the HF DX Spotter Table
4704
4705   Show the HF DX Spotter table for the list of prefixes for the last
4706   <days> no of days (default is 31), starting from a <date> (default:
4707   today).If there are no prefixes then it will show the table for your
4708   country.Remember that some countries have more than one "DXCC country"
4709   in them(eg G :-), to show them (assuming you are not in G already
4710   which isspecially treated in the code) you must list all the relevant
4711   prefixes
4712
4713
4714          sh/hftable g gm gd gi gj gw gu
4715
4716
4717
4718   Note that the prefixes are converted into country codes so you don't
4719   haveto list all possible prefixes for each country.If you want more or
4720   less days than the default simply include thenumber you require:-
4721
4722
4723          sh/hftable 20 pa
4724
4725
4726
4727   If you want to start at a different day, simply add the date in some
4728   recognizable form:-
4729
4730
4731          sh/hftable 2 25nov02  sh/hftable 2 25-nov-02   sh/hftable 2 021125   sh/hftable 2 25/11/02
4732
4733
4734
4735   This will show the stats for your DXCC for that CQWW contest weekend.
4736   You can specify either prefixes or full callsigns (so you can see how
4737   youdid against all your mates). You can also say 'all' which will then
4738   printthe worldwide statistics.
4739
4740
4741          sh/hftable all
4742
4743
4744
4745   \e[1m11.184.  show/hops <call> [ann|spots|route|wcy|wwv] (8)\e[0m
4746
4747   \e[1mshow/hops <call> [ann|spots|route|wcy|wwv] \e[22mShow the hop counts for a
4748   node
4749
4750   This command shows the hop counts set up for a node. You can
4751   specifywhich category you want to see. If you leave the category out
4752   then all the categories will be listed.
4753
4754
4755
4756   \e[1m11.185.  show/isolate (1)\e[0m
4757
4758   \e[1mshow/isolate \e[22mShow list of ISOLATED nodes
4759
4760
4761   \e[1m11.186.  show/lockout <prefix>|all (9)\e[0m
4762
4763   \e[1mshow/lockout <prefix>|all \e[22mShow the list of locked out or excluded
4764   callsigns
4765
4766
4767   \e[1m11.187.  show/log [<callsign>] (8)\e[0m
4768
4769   \e[1mshow/log [<callsign>] \e[22mShow excerpts from the system log
4770
4771   This command outputs a short section of the system log.  On its ownit
4772   will output a general logfile.  With the optional callsign it willshow
4773   output from the log associated with that callsign.
4774
4775   \e[1m11.188.  show/moon [ndays] [<prefix>|<callsign>] (0)\e[0m
4776
4777   \e[1mshow/moon [ndays] [<prefix>|<callsign>] \e[22mShow Moon rise and set times
4778
4779   Show the Moon rise and set times for a (list of) prefixes or
4780   callsigns, together with the azimuth and elevation of the sun
4781   currently at thoselocations.If you don't specify any prefixes or
4782   callsigns, it will show the times foryour QTH (assuming you have set
4783   it with either SET/LOCATION or SET/QRA),together with the current
4784   azimuth and elevation.In addition, it will show the illuminated
4785   fraction of the moons disk.If all else fails it will show the Moonrise
4786   and set times for the nodethat you are connected to. For example:-
4787
4788
4789          SH/MOON  SH/MOON G1TLH W5UN
4790
4791
4792
4793   You can also use this command to see into the past or the future, soif
4794   you want to see yesterday's times then do:-
4795
4796
4797          SH/MOON -1
4798
4799
4800
4801   or in three days time:-
4802
4803
4804          SH/MOON +3 W9
4805
4806
4807
4808   Upto 366 days can be checked both in the past and in the future.Please
4809   note that the rise and set times are given as the UT times of rise and
4810   set on the requested UT day.
4811
4812   \e[1m11.189.  show/muf <prefix> [<hours>][long] (0)\e[0m
4813
4814   \e[1mshow/muf <prefix> [<hours>][long] \e[22mShow the likely propagation to a
4815   prefix
4816
4817   This command allow you to estimate the likelihood of you contactinga
4818   station with the prefix you have specified. The output assumes a
4819   modestpower of 20dBW and receiver sensitivity of -123dBm (about
4820   0.15muV/10dB SINAD)The result predicts the most likely operating
4821   frequencies and signallevels for high frequency (shortwave) radio
4822   propagation paths onspecified days of the year and hours of the day.
4823   It is most useful forpaths between 250 km and 6000 km, but can be used
4824   with reduced accuracyfor paths shorter or longer than this.The command
4825   uses a routine MINIMUF 3.5 developed by the U.S. Navy andused to
4826   predict the MUF given the predicted flux, day of the year,hour of the
4827   day and geographic coordinates of the transmitter andreceiver. This
4828   routine is reasonably accurate for the purposes here,with a claimed
4829   RMS error of 3.8 MHz, but much smaller and less complexthan the
4830   programs used by major shortwave broadcasting organizations,such as
4831   the Voice of America.The command will display some header information
4832   detailing itsassumptions, together with the locations, latitude and
4833   longitudes andbearings. It will then show UTC (UT), local time at the
4834   other end(LT), calculate the MUFs, Sun zenith angle at the midpoint of
4835   the path(Zen) and the likely signal strengths. Then for each frequency
4836   for whichthe system thinks there is a likelihood of a circuit it
4837   prints a value.The value is currently a likely S meter reading based
4838   on the conventional6dB / S point scale. If the value has a '+'
4839   appended it means that it is1/2 an S point stronger. If the value is
4840   preceeded by an 'm' it means thatthere is likely to be much fading and
4841   by an 's' that the signal is likelyto be noisy.  By default SHOW/MUF
4842   will show the next two hours worth of data. Youcan specify anything up
4843   to 24 hours worth of data by appending the no ofhours required after
4844   the prefix. For example:-
4845
4846
4847          SH/MUF W
4848
4849
4850
4851   produces:
4852
4853
4854          RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21  Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms  Location                       Lat / Long           Azim  East Dereham, Norfolk          52 41 N 0 57 E         47  United-States-W                43 0 N 87 54 W        299  UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0  18 23 11.5 -35  mS0+ mS2   S3  19  0 11.2 -41  mS0+ mS2   S3
4855
4856
4857
4858   indicating that you will have weak, fading circuits on top band and
4859   80m but usable signals on 40m (about S3).inputing:-
4860
4861
4862          SH/MUF W 24
4863
4864
4865
4866   will get you the above display, but with the next 24 hours worth
4867   ofpropagation data.
4868
4869
4870          SH/MUF W L 24  SH/MUF W 24 Long
4871
4872
4873
4874   Gives you an estimate of the long path propagation characterics.
4875   Itshould be noted that the figures will probably not be very useful,
4876   norterrible accurate, but it is included for completeness.
4877
4878   \e[1m11.190.  show/newconfiguration [<node>] (0)\e[0m
4879
4880   \e[1mshow/newconfiguration [<node>] \e[22mShow all the nodes and users visible
4881
4882   This command allows you to see all the users that can be seenand the
4883   nodes to which they are connected. This command produces essentially
4884   the same information as SHOW/CONFIGURATION except that it shows all
4885   the duplication ofany routes that might be present It also uses a
4886   different formatwhich may not take up quite as much space if you don't
4887   have anyloops.BE WARNED: the list that is returned can be VERY long
4888   \e[1m11.191.  show/newconfiguration/node (0)\e[0m
4889
4890   \e[1mshow/newconfiguration/node \e[22mShow all the nodes connected locally
4891
4892   Show all the nodes connected to this node in the new format.
4893
4894   \e[1m11.192.  show/node [<callsign> ...] (1)\e[0m
4895
4896   \e[1mshow/node [<callsign> ...] \e[22mShow the type and version number of nodes
4897
4898   Show the type and version (if connected) of the nodes specified on
4899   thecommand line. If no callsigns are specified then a sorted list of
4900   allthe non-user callsigns known to the system will be displayed.
4901
4902   \e[1m11.193.  show/prefix <callsign> (0)\e[0m
4903
4904   \e[1mshow/prefix <callsign> \e[22mInterrogate the prefix database
4905
4906   This command takes the <callsign> (which can be a full or partial
4907   callsign or a prefix), looks up which internal country number it is
4908   and then displays all the relevant prefixes for that countrytogether
4909   with the internal country no, the CQ and ITU regions. See also
4910   SHOW/DXCC
4911
4912   \e[1m11.194.  show/program (5)\e[0m
4913
4914   \e[1mshow/program \e[22mShow the locations of all the included program modules
4915
4916   Show the name and location where every program module was load from.
4917   Thisis useful for checking where you think you have loaded a .pm file
4918   from.
4919
4920   \e[1m11.195.  show/qra <lat> <long> (0)\e[0m
4921
4922   \e[1mshow/qra <lat> <long> \e[22mConvert lat/long to a QRA Grid locator
4923
4924   This is a multipurpose command that allows you either to calculate
4925   thedistance and bearing between two locators or (if only one locator
4926   isgiven on the command line) the distance and beraing from your
4927   stationto the locator. For example:-
4928
4929
4930         SH/QRA IO92QL  SH/QRA JN06 IN73
4931
4932
4933
4934   The first example will show the distance and bearing to the locator
4935   fromyourself, the second example will calculate the distance and bear-
4936   ing fromthe first locator to the second. You can use 4 or 6 character
4937   locators.It is also possible to convert a latitude and longitude to a
4938   locator by using this command with a latitude and longitude as an
4939   argument, forexample:-
4940
4941
4942         SH/QRA 52 41 N 0 58 E
4943
4944
4945
4946   \e[1m11.196.  show/qra <locator> [<locator>] (0)\e[0m
4947
4948   \e[1mshow/qra <locator> [<locator>] \e[22mShow distance between QRA Grid locators
4949
4950
4951
4952   \e[1m11.197.  show/qrz <callsign> (0)\e[0m
4953
4954   \e[1mshow/qrz <callsign> \e[22mShow any callbook details on a callsign
4955
4956   This command queries the QRZ callbook server on the internetand
4957   returns any information available for that callsign. This serviceis
4958   provided for users of this software by http://www.qrz.com See also
4959   SHOW/WM7D for an alternative.
4960
4961   \e[1m11.198.  show/registered [<prefix>] (9)\e[0m
4962
4963   \e[1mshow/registered [<prefix>] \e[22mShow the registered users
4964
4965
4966   \e[1m11.199.  show/route <callsign> ... (0)\e[0m
4967
4968   \e[1mshow/route <callsign> ... \e[22mShow the route to the callsign
4969
4970   This command allows you to see to which node the callsigns specified
4971   areconnected. It is a sort of inverse sh/config.
4972
4973
4974         sh/route n2tly
4975
4976
4977
4978   \e[1m11.200.  show/satellite <name> [<hours> <interval>] (0)\e[0m
4979
4980   \e[1mshow/satellite <name> [<hours> <interval>] \e[22mShow tracking data
4981
4982   Show the tracking data from your location to the satellite of your
4983   choicefrom now on for the next few hours.If you use this command
4984   without a satellite name it will display a listof all the satellites
4985   known currently to the system. If you give a name then you can obtain
4986   tracking data of all the passesthat start and finish 5 degrees below
4987   the horizon. As default it willgive information for the next three
4988   hours for every five minute period.You can alter the number of hours
4989   and the step size, within certain limits. Each pass in a period is
4990   separated with a row of '-----' charactersSo for example:-
4991
4992
4993         SH/SAT AO-10  SH/SAT FENGYUN1 12 2
4994
4995
4996
4997   \e[1m11.201.  show/station all [<regex>] (6)\e[0m
4998
4999   \e[1mshow/station all [<regex>] \e[22mShow list of users in the system
5000
5001
5002   \e[1m11.202.  show/station [<callsign> ..] (0)\e[0m
5003
5004   \e[1mshow/station [<callsign> ..] \e[22mShow information about a callsign
5005
5006   Show the information known about a callsign and whether (and
5007   where)that callsign is connected to the cluster.
5008
5009
5010          SH/ST G1TLH
5011
5012
5013
5014   If no callsign is given then show the information for yourself.
5015
5016   \e[1m11.203.  show/sun [ndays] [<prefix>|<callsign>] (0)\e[0m
5017
5018   \e[1mshow/sun [ndays] [<prefix>|<callsign>] \e[22mShow sun rise and set times
5019
5020   Show the sun rise and set times for a (list of) prefixes or callsigns,
5021   together with the azimuth and elevation of the sun currently at
5022   thoselocations.If you don't specify any prefixes or callsigns, it will
5023   show the times foryour QTH (assuming you have set it with either
5024   SET/LOCATION or SET/QRA),together with the current azimuth and
5025   elevation.If all else fails it will show the sunrise and set times for
5026   the nodethat you are connected to. For example:-
5027
5028
5029          SH/SUN  SH/SUN G1TLH K9CW ZS
5030
5031
5032
5033   You can also use this command to see into the past or the future, soif
5034   you want to see yesterday's times then do:-
5035
5036
5037          SH/SUN -1
5038
5039
5040
5041   or in three days time:-
5042
5043
5044          SH/SUN +3 W9
5045
5046
5047
5048   Upto 366 days can be checked both in the past and in the future.Please
5049   note that the rise and set times are given as the UT times of rise and
5050   set on the requested UT day.
5051
5052   \e[1m11.204.  show/time [<prefix>|<callsign>] (0)\e[0m
5053
5054   \e[1mshow/time [<prefix>|<callsign>] \e[22mShow the local time
5055
5056   If no prefixes or callsigns are given then this command returns the
5057   localtime and UTC as the computer has it right now. If you give some
5058   prefixesthen it will show UTC and UTC + the local offset (not
5059   including DST) atthe prefixes or callsigns that you specify.
5060
5061   \e[1m11.205.  show/usdb [call ..] (0)\e[0m
5062
5063   \e[1mshow/usdb [call ..] \e[22mShow information held on the FCC Call database
5064
5065   Show the City and State of a Callsign held on the FCC database ifhis
5066   is being run on this system, eg:-
5067
5068
5069          sh/usdb k1xx
5070
5071
5072
5073   \e[1m11.206.  show/vhfstats [days] [date] (0)\e[0m
5074
5075   \e[1mshow/vhfstats [days] [date] \e[22mShow the VHF DX Statistics
5076
5077   Show the VHF DX spots breakdown by band for the last <days> no of days
5078   (default is 31), starting from a date (default: today).
5079
5080
5081   \e[1m11.207.  show/vhftable [days] [date] [prefix ...] (0)\e[0m
5082
5083   \e[1mshow/vhftable [days] [date] [prefix ...] \e[22mShow the VHF DX Spotter Table
5084
5085   Show the VHF DX Spotter table for the list of prefixes for the last
5086   <days> no of days (default is 31), starting from a date (default:
5087   today).If there are no prefixes then it will show the table for your
5088   country.Remember that some countries have more than one "DXCC country"
5089   in them(eg G :-), to show them (assuming you are not in G already
5090   which isspecially treated in the code) you must list all the relevant
5091   prefixes
5092
5093
5094          sh/vhftable g gm gd gi gj gw gu
5095
5096
5097
5098   Note that the prefixes are converted into country codes so you don't
5099   haveto list all possible prefixes for each country.If you want more or
5100   less days than the default simply include thenumber you require:-
5101
5102
5103          sh/vhftable 20 pa
5104
5105
5106
5107   If you want to start at a different day, simply add the date in some
5108   recognizable form:-
5109
5110
5111          sh/vhftable 2 25nov02  sh/vhftable 2 25-nov-02   sh/vhftable 2 021125   sh/vhftable 2 25/11/02
5112
5113
5114
5115   This will show the stats for your DXCC for that CQWW contest weekend.
5116   You can specify either prefixes or full callsigns (so you can see how
5117   youdid against all your mates). You can also say 'all' which will then
5118   printthe worldwide statistics.
5119
5120
5121          sh/vhftable all
5122
5123
5124
5125   \e[1m11.208.  show/wcy (0)\e[0m
5126
5127   \e[1mshow/wcy \e[22mShow last 10 WCY broadcasts
5128
5129
5130   \e[1m11.209.  show/wcy <n> (0)\e[0m
5131
5132   \e[1mshow/wcy <n> \e[22mShow last <n> WCY broadcasts
5133
5134   Display the most recent WCY information that has been received by the
5135   system
5136
5137   \e[1m11.210.  show/wm7d <callsign> (0)\e[0m
5138
5139   \e[1mshow/wm7d <callsign> \e[22mShow callbook details on a US callsigns
5140
5141   This command queries the WM7D callbook server on the internetand
5142   returns any information available for that US callsign. This serviceis
5143   provided for users of this software by http://www.wm7d.net.See also
5144   SHOW/QRZ.
5145
5146   \e[1m11.211.  show/wwv (0)\e[0m
5147
5148   \e[1mshow/wwv \e[22mShow last 10 WWV broadcasts
5149
5150
5151   \e[1m11.212.  show/wwv <n> (0)\e[0m
5152
5153   \e[1mshow/wwv <n> \e[22mShow last <n> WWV broadcasts
5154
5155   Display the most recent WWV information that has been received by the
5156   system
5157
5158   \e[1m11.213.  shutdown (5)\e[0m
5159
5160   \e[1mshutdown \e[22mShutdown the cluster
5161
5162   Shutdown the cluster and disconnect all the users
5163
5164   \e[1m11.214.  spoof <call> <command> (9)\e[0m
5165
5166   \e[1mspoof <call> <command> \e[22mDo a command as though you are another user
5167
5168   This command is provided so that sysops can set a user's parameters
5169   withoutme having to write a special 'sysop' version for every user
5170   command. Itallows you to pretend that you are doing the command as the
5171   user you specify.eg:-
5172
5173
5174           SPOOF G1TLH set/name Dirk   SPOOF G1TLH set/qra JO02LQ
5175
5176
5177
5178   \e[1m11.215.  stat/channel [<callsign>] (5)\e[0m
5179
5180   \e[1mstat/channel [<callsign>] \e[22mShow the status of a channel on the cluster
5181
5182   Show the internal status of the channel object either for the channel
5183   that you are on or else for the callsign that you asked for.Only the
5184   fields that are defined (in perl term) will be displayed.
5185
5186   \e[1m11.216.  stat/db <dbname> (5)\e[0m
5187
5188   \e[1mstat/db <dbname> \e[22mShow the status of a database
5189
5190   Show the internal status of a database descriptor.Depending on your
5191   privilege level you will see more or less information. This command is
5192   unlikely to be of much use to anyone other than a sysop.
5193
5194   \e[1m11.217.  stat/msg (1)\e[0m
5195
5196   \e[1mstat/msg \e[22mShow the status of the message system
5197
5198
5199   \e[1m11.218.  stat/msg <msgno> (1)\e[0m
5200
5201   \e[1mstat/msg <msgno> \e[22mShow the status of a message
5202
5203   This command shows the internal status of a message and includes
5204   informationsuch as to whom it has been forwarded, its size, origin etc
5205   etc.If no message number is given then the status of the message
5206   system is displayed.
5207
5208
5209
5210   \e[1m11.219.  stat/route_node <callsign> (5)\e[0m
5211
5212   \e[1mstat/route_node <callsign> \e[22mShow the data in a Route::Node object
5213
5214
5215   \e[1m11.220.  stat/route_node all (5)\e[0m
5216
5217   \e[1mstat/route_node all \e[22mShow list of all Route::Node objects
5218
5219
5220   \e[1m11.221.  stat/route_user <callsign> (5)\e[0m
5221
5222   \e[1mstat/route_user <callsign> \e[22mShow the data in a Route::User object
5223
5224
5225   \e[1m11.222.  stat/route_user all (5)\e[0m
5226
5227   \e[1mstat/route_user all \e[22mShow list of all Route::User objects
5228
5229
5230   \e[1m11.223.  stat/user [<callsign>] (5)\e[0m
5231
5232   \e[1mstat/user [<callsign>] \e[22mShow the full status of a user
5233
5234   Shows the full contents of a user record including all the secret
5235   flagsand stuff.Only the fields that are defined (in perl term) will be
5236   displayed.
5237
5238   \e[1m11.224.  sysop (0)\e[0m
5239
5240   \e[1msysop \e[22mRegain your privileges if you login remotely
5241
5242   The system automatically reduces your privilege level to that of
5243   anormal user if you login in remotely. This command allows you
5244   toregain your normal privilege level. It uses the normal system:
5245   fivenumbers are returned that are indexes into the character array
5246   that isyour assigned password (see SET/PASSWORD). The indexes start
5247   fromzero.You are expected to return a string which contains the
5248   charactersrequired in the correct order. You may intersperse those
5249   characterswith others to obscure your reply for any watchers. For
5250   example (andthese values are for explanation :-):
5251
5252
5253          password = 012345678901234567890123456789  > sysop  22 10 15 17 3
5254
5255
5256
5257   you type:-
5258
5259
5260         aa2bbbb0ccc5ddd7xxx3n or 2 0 5 7 3 or 20573
5261
5262
5263
5264   They will all match. If there is no password you will still be
5265   offerednumbers but nothing will happen when you input a string. Any
5266   match iscase sensitive.
5267
5268   \e[1m11.225.  talk <call> > <node> [<text>] (0)\e[0m
5269
5270   \e[1mtalk <call> > <node> [<text>] \e[22mSend a text message to another station
5271   via a node
5272
5273   Send a short message to any other station that is visible on the
5274   clustersystem. You can send it to anyone you can see with a
5275   SHOW/CONFIGURATION command, they don't have to be connected
5276   locally.The second form of TALK is used when other cluster nodes are
5277   connectedwith restricted information. This usually means that they
5278   don't send the user information usually associated with logging on and
5279   off the cluster.If you know that G3JNB is likely to be present on
5280   GB7TLH, but you can onlysee GB7TLH in the SH/C list but with no users,
5281   then you would use thesecond form of the talk message.If you want to
5282   have a ragchew with someone you can leave the text messageout and the
5283   system will go into 'Talk' mode. What this means is that ashort
5284   message is sent to the recipient telling them that you are in
5285   a'Talking' frame of mind and then you just type - everything you send
5286   willgo to the station that you asked for. All the usual announcements,
5287   spots and so on will still come out on yourterminal.If you want to do
5288   something (such as send a spot) you preceed the normal command with a
5289   '/' character, eg:-
5290
5291
5292           /DX 14001 G1TLH What's a B class licensee doing on 20m CW?   /HELP talk
5293
5294
5295
5296   To leave talk mode type:
5297
5298
5299           /EX
5300
5301
5302
5303   If you are in 'Talk' mode, there is an extention to the '/' command
5304   whichallows you to send the output to all the people you are talking
5305   to. You do with the '//' command. For example:-
5306
5307
5308          //sh/hftable
5309
5310
5311
5312   will send the hftable as you have it to all the people you are cur-
5313   rently talking to.
5314
5315   \e[1m11.226.  talk <call> [<text>] (0)\e[0m
5316
5317   \e[1mtalk <call> [<text>] \e[22mSend a text message to another station
5318
5319
5320   \e[1m11.227.  type <filearea>/<name> (0)\e[0m
5321
5322   \e[1mtype <filearea>/<name> \e[22mLook at the contents of a file in one of the
5323   fileareas
5324
5325   Type out the contents of a file in a filearea. So, for example, in
5326   filearea 'bulletins' you want to look at file 'arld051' you would
5327   enter:-
5328
5329
5330           TYPE bulletins/arld051
5331
5332
5333
5334   See also SHOW/FILES to see what fileareas are available and a list of
5335   content.
5336
5337   \e[1m11.228.  uncatchup <node call> all|[msgno> ...] (5)\e[0m
5338
5339   \e[1muncatchup <node call> all|[msgno> ...] \e[22mUnmark a message as sent
5340
5341
5342   When you send messages the fact that you have forwarded it to another
5343   node is remembered so that it isn't sent again. When you have a new
5344   partnernode and you add their callsign to your /spider/msg/forward.pl
5345   file, alloutstanding non-private messages will be forwarded to them.
5346   This may wellbe ALL the non-private messages. You can prevent this by
5347   using these commmands:-
5348
5349
5350          catchup GB7DJK all  catchup GB7DJK 300 301 302 303 500-510
5351
5352
5353
5354   and to undo what you have just done:-
5355
5356
5357          uncatchup GB7DJK all  uncatchup GB7DJK 300 301 302 303 500-510
5358
5359
5360
5361   which will arrange for them to be forward candidates again.Order is
5362   not important.
5363
5364   \e[1m11.229.  unset/announce (0)\e[0m
5365
5366   \e[1munset/announce \e[22mStop announce messages coming out on your terminal
5367
5368
5369   \e[1m11.230.  unset/anntalk (0)\e[0m
5370
5371   \e[1munset/anntalk \e[22mStop talk like announce messages on your terminal
5372
5373   The announce system on legacy cluster nodes is used as a talk
5374   substitute because the network is so poorly connected. If you:
5375
5376
5377          unset/anntalk
5378
5379
5380
5381   you will suppress several of these announces, you may miss the odd
5382   useful one as well, but you would probably miss them anyway in thewel-
5383   ter of useless ones.
5384
5385
5386          set/anntalk
5387
5388
5389
5390   allows you to see them again. This is the default.
5391
5392   \e[1m11.231.  unset/baddx <call>.. (8)\e[0m
5393
5394   \e[1munset/baddx <call>.. \e[22mPropagate a dx spot with this callsign again
5395
5396   Setting a word as 'baddx' will prevent spots with that word in
5397   the'spotted' field (as in: DX 14001.1 FR0G)of a DX spot from going
5398   anyfurther. They will not be displayed and they will not be sent
5399   ontoother nodes.The word must be written in full, no wild cards are
5400   allowed eg:-
5401
5402
5403          set/baddx FORSALE VIDEO FR0G
5404
5405
5406
5407   To allow a word again, use the following command ...
5408
5409
5410          unset/baddx VIDEO
5411
5412
5413
5414   \e[1m11.232.  unset/badnode <call>.. (8)\e[0m
5415
5416   \e[1munset/badnode <call>.. \e[22mAllow spots from this node again
5417
5418   Setting a callsign as a 'badnode' will prevent spots from that node
5419   going any further. They will not be displayed and they will not be
5420   sent onto other nodes.The call must be a full eg:-
5421
5422
5423          set/badnode K1TTT
5424
5425
5426
5427   will stop anything from K1TTT. If you want SSIDs as well then you mus-
5428   tenter them specifically.
5429
5430
5431          unset/badnode K1TTT
5432
5433
5434
5435   will allow spots from him again.Use with extreme care. This command
5436   may well be superceeded by FILTERing.
5437
5438   \e[1m11.233.  unset/badspotter <call>.. (8)\e[0m
5439
5440   \e[1munset/badspotter <call>.. \e[22mAllow spots from this callsign again
5441
5442   Setting a callsign as a 'badspotter' will prevent spots from this
5443   callsign going any further. They will not be displayed and they will
5444   not be sent onto other nodes.The call must be written in full, no wild
5445   cards are allowed eg:-
5446
5447
5448          set/badspotter VE2STN
5449
5450
5451
5452   will stop anything from VE2STN. This command will automaticallystop
5453   spots from this user, regardless of whether or which SSID he uses. DO
5454   NOT USE SSIDs in the callsign, just use the callsignas above or below.
5455
5456
5457          unset/badspotter VE2STN
5458
5459
5460
5461   will allow spots from him again.Use with extreme care. This command
5462   may well be superceded by FILTERing.
5463
5464   \e[1m11.234.  unset/badword <word>.. (8)\e[0m
5465
5466   \e[1munset/badword <word>.. \e[22mPropagate things with this word again
5467
5468   Setting a word as a 'badword' will prevent things like spots,announces
5469   or talks with this word in the the text part from going anyfurther.
5470   They will not be displayed and they will not be sent ontoother
5471   nodes.The word must be written in full, no wild cards are allowed eg:-
5472          set/badword annihilate annihilated annihilation
5473
5474
5475
5476   will stop anything with these words in the text.
5477
5478
5479          unset/badword annihilated
5480
5481
5482
5483   will allow text with this word again.
5484
5485   \e[1m11.235.  unset/beep (0)\e[0m
5486
5487   \e[1munset/beep \e[22mStop beeps for DX and other messages on your terminal
5488
5489
5490   \e[1m11.236.  unset/debug <name> (9)\e[0m
5491
5492   \e[1munset/debug <name> \e[22mRemove a debug level from the debug set
5493
5494   You can choose to log several different levels.  The levels are
5495
5496
5497         chan state msg cron connect
5498
5499
5500
5501   You can show what levels you are logging with SHOW/DEBUG
5502
5503   \e[1m11.237.  unset/dx (0)\e[0m
5504
5505   \e[1munset/dx \e[22mStop DX messages coming out on your terminal
5506
5507
5508   \e[1m11.238.  unset/dxcq (0)\e[0m
5509
5510   \e[1munset/dxcq \e[22mStop CQ Zones on the end of DX announcements
5511
5512   Display both the Spotter's and the Spotted's CQ Zone on the endof a DX
5513   announcement (there is just enough room). Some user programscannot
5514   cope with this. The Spotter's CQ is on the RHS of the time, the
5515   Spotted's CQ is on the LHS.Conflicts with: SET/DXGRID, SET/DXITU,
5516   SHOW/USSTATEDo a STAT/USER to see which flags you have set if you are
5517   confused.
5518
5519   \e[1m11.239.  unset/dxgrid (0)\e[0m
5520
5521   \e[1munset/dxgrid \e[22mStop QRA Grid Squares on the end of DX announcements
5522
5523   A standard feature which is enabled in version 1.43 and above is that
5524   if the spotter's grid square is known it is output on the endof a DX
5525   announcement (there is just enough room). Some user programscannot
5526   cope with this. You can use this command to reset (or set)this
5527   feature.Conflicts with: SET/DXCQ, SET/DXITUDo a STAT/USER to see which
5528   flags you have set if you are confused.
5529
5530   \e[1m11.240.  unset/dxitu (0)\e[0m
5531
5532   \e[1munset/dxitu \e[22mStop ITU Zones on the end of DX announcements
5533
5534   Display both the Spotter's and the Spotted's ITU Zone on the endof a
5535   DX announcement (there is just enough room). Some user programscannot
5536   cope with this. The Spotter's ITU is on the RHS of the time, the
5537   Spotted's ITU is on the LHS.Conflicts with: SET/DXGRID, SET/DXCQ,
5538   SHOW/USSTATEDo a STAT/USER to see which flags you have set if you are
5539   confused.
5540
5541   \e[1m11.241.  unset/echo (0)\e[0m
5542
5543   \e[1munset/echo \e[22mStop the cluster echoing your input
5544
5545   If you are connected via a telnet session, different implimentationsof
5546   telnet handle echo differently depending on whether you are connected
5547   via port 23 or some other port. You can use this commandto change the
5548   setting appropriately. The setting is stored in your user profile.YOU
5549   DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
5550
5551   \e[1m11.242.  unset/email (0)\e[0m
5552
5553   \e[1munset/email \e[22mStop personal msgs being forwarded by email
5554
5555   If any personal messages come in for your callsign then you can
5556   usethese commands to control whether they are forwarded onto your
5557   emailaddress. To enable the forwarding do something like:-
5558
5559
5560          SET/EMAIL mike.tubby@somewhere.com
5561
5562
5563
5564   You can have more than one email address (each one separated by a
5565   space).Emails are forwarded to all the email addresses you specify.You
5566   can disable forwarding by:-
5567
5568
5569          UNSET/EMAIL
5570
5571
5572
5573   \e[1m11.243.  unset/here (0)\e[0m
5574
5575   \e[1munset/here \e[22mTell the system you are absent from your terminal
5576
5577
5578   \e[1m11.244.  unset/hops <call> ann|spots|route|wwv|wcy (8)\e[0m
5579
5580   \e[1munset/hops <call> ann|spots|route|wwv|wcy \e[22mUnset hop count
5581
5582   Set the hop count for a particular type of broadcast for a node.This
5583   command allows you to set up special hop counts for a node for
5584   currently: announce, spots, wwv and wcy broadcasts.eg:
5585
5586
5587          set/hops gb7djk ann 10  set/hops gb7mbc spots 20
5588
5589
5590
5591   Set SHOW/HOPS for information on what is already set. This commandcre-
5592   ates a filter and works in conjunction with the filter system. You can
5593   unset the hops with command UNSET/HOPS. For example:-
5594
5595
5596          unset/hops gb7djk ann  unset/hops gb7mbc spots
5597
5598
5599
5600   \e[1m11.245.  unset/isolate (9)\e[0m
5601
5602   \e[1munset/isolate \e[22mStop Isolation of a node from the rest of the network
5603
5604   Remove isolation from a node - SET/ISOLATE
5605
5606   \e[1m11.246.  unset/lockout <call> (9)\e[0m
5607
5608   \e[1munset/lockout <call> \e[22mAllow a callsign to connect to the cluster
5609
5610
5611   \e[1m11.247.  unset/logininfo (0)\e[0m
5612
5613   \e[1munset/logininfo \e[22mInform when a station logs out locally
5614
5615
5616   \e[1m11.248.  unset/password <call> ... (9)\e[0m
5617
5618   \e[1munset/password <call> ... \e[22mDelete (remove) a user's password
5619
5620   This command allows the sysop to completely delete and remove a
5621   password for a user.
5622
5623   \e[1m11.249.  unset/privilege (0)\e[0m
5624
5625   \e[1munset/privilege \e[22mRemove any privilege for this session
5626
5627   You can use this command to 'protect' this session from
5628   unauthoriseduse. If you want to get your normal privilege back you
5629   will need toeither logout and login again (if you are on a console) or
5630   use theSYSOP command.
5631
5632   \e[1m11.250.  unset/prompt (0)\e[0m
5633
5634   \e[1munset/prompt \e[22mSet your prompt back to default
5635
5636   This command will set your user prompt to exactly the string that you
5637   say. The point of this command to enable a user to interface to
5638   programsthat are looking for a specific prompt (or else you just want
5639   a differentfixed prompt).
5640
5641
5642          SET/PROMPT clx >
5643
5644
5645
5646   UNSET/PROMPT will undo the SET/PROMPT command and set you prompt back
5647   tonormal.
5648
5649   \e[1m11.251.  unset/register <call> ... (9)\e[0m
5650
5651   \e[1munset/register <call> ... \e[22mMark a user as not registered
5652
5653   Registration is a concept that you can switch on by executing the
5654
5655
5656          set/var $main::regreq = 1
5657
5658
5659
5660   command (usually in your startup file)If a user is NOT registered
5661   then, firstly, instead of the normalmotd file (/spider/data/motd)
5662   being sent to the user at startup, theuser is sent the motd_nor file
5663   instead. Secondly, the non registereduser only has READ-ONLY access to
5664   the node. The non-registered usercannot use DX, ANN etc. The only
5665   exception to this is that a non-registered user can TALK orSEND
5666   messages to the sysop.
5667
5668   \e[1m11.252.  unset/talk (0)\e[0m
5669
5670   \e[1munset/talk \e[22mStop TALK messages coming out on your terminal
5671
5672
5673   \e[1m11.253.  unset/usstate (0)\e[0m
5674
5675   \e[1munset/usstate \e[22mStop US State info on the end of DX announcements
5676
5677   If the spotter's or spotted's US State is known it is output on the
5678   end of a DX announcement (there is just enough room). A spotter's
5679   state will appear on the RHS of the time (like SET/DXGRID) and the
5680   spotted's State will appear on the LHS of thetime field. Any
5681   information found will override any locator information from
5682   SET/DXGRID.Some user programs cannot cope with this. You can use this
5683   command to reset (or set) this feature.Conflicts with: SET/DXCQ,
5684   SET/DXITUDo a STAT/USER to see which flags you have set if you are
5685   confused.
5686
5687   \e[1m11.254.  unset/wcy (0)\e[0m
5688
5689   \e[1munset/wcy \e[22mStop WCY messages coming out on your terminal
5690
5691
5692   \e[1m11.255.  unset/wwv (0)\e[0m
5693
5694   \e[1munset/wwv \e[22mStop WWV messages coming out on your terminal
5695
5696
5697   \e[1m11.256.  unset/wx (0)\e[0m
5698
5699   \e[1munset/wx \e[22mStop WX messages coming out on your terminal
5700
5701
5702   \e[1m11.257.  who (0)\e[0m
5703
5704   \e[1mwho \e[22mShow who is physically connected
5705
5706   This is a quick listing that shows which callsigns are connected
5707   andwhat sort of connection they have
5708
5709   \e[1m11.258.  wx <text> (0)\e[0m
5710
5711   \e[1mwx <text> \e[22mSend a weather message to local users
5712
5713
5714   \e[1m11.259.  wx full <text> (0)\e[0m
5715
5716   \e[1mwx full <text> \e[22mSend a weather message to all cluster users
5717
5718
5719   \e[1m11.260.  wx sysop <text> (5)\e[0m
5720
5721   \e[1mwx sysop <text> \e[22mSend a weather message to other clusters only
5722
5723   Weather messages can sometimes be useful if you are experiencing an
5724   extremethat may indicate enhanced conditions
5725
5726
5727