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