]> dxcluster.org Git - spider.git/blob - html/adminmanual-13.html
Minor typos corrected
[spider.git] / html / adminmanual-13.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5  <TITLE>The DXSpider Installation and Administration Manual : The DXSpider command set</TITLE>
6  <LINK HREF="adminmanual-12.html" REL=previous>
7  <LINK HREF="adminmanual.html#toc13" REL=contents>
8 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
9 </HEAD>
10 <BODY>
11 Next
12 <A HREF="adminmanual-12.html">Previous</A>
13 <A HREF="adminmanual.html#toc13">Contents</A>
14 <HR>
15 <H2><A NAME="s13">13. The DXSpider command set</A></H2>
16
17 <P>Below is a complete list of commands available from the cluster prompt.
18 Most maintenance tasks are automatic but there are some commands that are useful 
19 for a sysop.  These are listed below in alphabetical order.  The number in 
20 brackets following the command name is the permissions level needed to use 
21 the command.
22 <P>
23 <H2><A NAME="ss13.1">13.1 accept/announce (0)</A>
24 </H2>
25
26 <P><CODE><B>accept/announce [0-9] &lt;pattern&gt;</B> Set an accept filter
27 line for announce</CODE>
28 <P>
29 <P>Create an 'accept this announce' line for a filter. 
30 <P>An accept filter line means that if the announce matches this filter it is
31 passed onto the user. See HELP FILTERS for more info. Please read this
32 to understand how filters work - it will save a lot of grief later on.
33 <P>You can use any of the following things in this line:-
34 <P>
35 <BLOCKQUOTE><CODE>
36 <PRE>
37   info &lt;string>            eg: iota or qsl
38   by &lt;prefixes>            eg: G,M,2         
39   origin &lt;prefixes>
40   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
41   origin_itu &lt;numbers>
42   origin_zone &lt;numbers>
43   by_dxcc &lt;numbers>
44   by_itu &lt;numbers>
45   by_zone &lt;numbers>
46   channel &lt;prefixes>
47   wx 1                     filter WX announces
48   dest &lt;prefixes>          eg: 6MUK,WDX      (distros)
49 </PRE>
50 </CODE></BLOCKQUOTE>
51 <P>some examples:-
52 <P>
53 <BLOCKQUOTE><CODE>
54 <PRE>
55   acc/ann dest 6MUK
56   acc/ann 2 by_zone 14,15,16
57   (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
58 </PRE>
59 </CODE></BLOCKQUOTE>
60 <P>or
61 <P>
62 <BLOCKQUOTE><CODE>
63 <PRE>
64   acc/ann by G,M,2 
65 </PRE>
66 </CODE></BLOCKQUOTE>
67 <P>This filter would only allow announces that were posted buy UK stations.  
68 You can use the tag 'all' to accept everything eg:
69 <P>
70 <BLOCKQUOTE><CODE>
71 <PRE>
72   acc/ann all
73 </PRE>
74 </CODE></BLOCKQUOTE>
75 <P>but this probably for advanced users...
76 <P>
77 <H2><A NAME="ss13.2">13.2 accept/announce (extended for sysops) (8)</A>
78 </H2>
79
80 <P><CODE><B>accept/announce &lt;call&gt; [input] [0-9]&lt;pattern&gt;</B> Announce filter sysop version</CODE>
81 <P>
82 <P>This version allows a sysop to set a filter for a callsign as well as the
83 default for nodes and users eg:-
84 <P>
85 <BLOCKQUOTE><CODE>
86 <PRE>
87   accept/ann by G,M,2
88   accept/ann input node_default by G,M,2
89   accept/ann user_default by G,M,2
90 </PRE>
91 </CODE></BLOCKQUOTE>
92 <P>
93 <H2><A NAME="ss13.3">13.3 accept/spots (0)</A>
94 </H2>
95
96 <P><CODE><B>accept/announce [0-9] &lt;pattern&gt;</B> Set an accept filter line for spots</CODE>
97 <P>
98 <P>Create an 'accept this spot' line for a filter.
99 <P>
100 <P>An accept filter line means that if the spot matches this filter it is
101 passed onto the user. See HELP FILTERS for more info. Please read this
102 to understand how filters work - it will save a lot of grief later on.
103 <P>You can use any of the following things in this line:-
104 <P>
105 <BLOCKQUOTE><CODE>
106 <PRE>
107   freq &lt;range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
108   on &lt;range>             same as 'freq'
109   call &lt;prefixes>        eg: G,PA,HB9
110   info &lt;string>          eg: iota or qsl
111   by &lt;prefixes>            
112   call_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
113   call_itu &lt;numbers>
114   call_zone &lt;numbers>
115   by_dxcc &lt;numbers>
116   by_itu &lt;numbers>
117   by_zone &lt;numbers>
118   origin &lt;prefixes>
119   channel &lt;prefixes>
120 </PRE>
121 </CODE></BLOCKQUOTE>
122 <P>
123 <P>For frequencies, you can use any of the band names defined in
124 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
125 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
126 this is more efficient than saying simply: freq HF (but don't get
127 too hung up about that)
128 <P>some examples:-
129 <P>
130 <BLOCKQUOTE><CODE>
131 <PRE>
132   acc/spot 1 on hf/cw
133   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
134 </PRE>
135 </CODE></BLOCKQUOTE>
136 <P>You can use the tag 'all' to accept everything, eg:
137 <P>
138 <BLOCKQUOTE><CODE>
139 <PRE>
140   acc/spot 3 all
141 </PRE>
142 </CODE></BLOCKQUOTE>
143 <P>but this probably for advanced users...
144 <P>
145 <H2><A NAME="ss13.4">13.4 accept/spots (extended for sysops) (8)</A>
146 </H2>
147
148 <P><CODE><B>accept/spots &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B> Spot filter sysop version</CODE>
149 <P>
150 <P>This version allows a sysop to set a filter for a callsign as well as the
151 default for nodes and users eg:-
152 <P>
153 <BLOCKQUOTE><CODE>
154 <PRE>
155   accept/spot db0sue-7 1 by_zone 14,15,16
156   accept/spot node_default all
157   set/hops node_default 10
158
159   accept/spot user_default by G,M,2
160 </PRE>
161 </CODE></BLOCKQUOTE>
162 <P>
163 <H2><A NAME="ss13.5">13.5 accept/wcy (0)</A>
164 </H2>
165
166 <P><CODE><B>accept/wcy [0-9] &lt;pattern&gt;</B> set an accept WCY filter</CODE>
167 <P>
168 <P>It is unlikely that you will want to do this, but if you do then you can
169 filter on the following fields:-
170 <P>
171 <BLOCKQUOTE><CODE>
172 <PRE>
173   by &lt;prefixes>            eg: G,M,2         
174   origin &lt;prefixes>
175   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
176   origin_itu &lt;numbers>
177   origin_zone &lt;numbers>
178   by_dxcc &lt;numbers>
179   by_itu &lt;numbers>
180   by_zone &lt;numbers>
181   channel &lt;prefixes>
182 </PRE>
183 </CODE></BLOCKQUOTE>
184 <P>
185 <P>There are no examples because WCY Broadcasts only come from one place and
186 you either want them or not (see UNSET/WCY if you don't want them).
187 <P>This command is really provided for future use.
188 <P>See HELP FILTER for information.
189 <P>
190 <H2><A NAME="ss13.6">13.6 accept/wcy (extended for sysops) (8)</A>
191 </H2>
192
193 <P><CODE><B>accept/wcy &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B>
194 WCY filter sysop version</CODE>
195 <P>
196 <P>This version allows a sysop to set a filter for a callsign as well as the
197 default for nodes and users eg:-
198 <P>
199 <BLOCKQUOTE><CODE>
200 <PRE>
201   accept/wcy node_default all
202   set/hops node_default 10
203 </PRE>
204 </CODE></BLOCKQUOTE>
205 <P>
206 <H2><A NAME="ss13.7">13.7 accept/wwv (0)</A>
207 </H2>
208
209 <P><CODE><B>accept/wwv [0-9] &lt;pattern&gt;</B> Set an accept WWV filter</CODE>
210 <P>
211 <P>It is unlikely that you will want to do this, but if you do then you can
212 filter on the following fields:-
213 <P>
214 <BLOCKQUOTE><CODE>
215 <PRE>
216   by &lt;prefixes>            eg: G,M,2         
217   origin &lt;prefixes>
218   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
219   origin_itu &lt;numbers>
220   origin_zone &lt;numbers>
221   by_dxcc &lt;numbers>
222   by_itu &lt;numbers>
223   by_zone &lt;numbers>
224   channel &lt;prefixes>
225 </PRE>
226 </CODE></BLOCKQUOTE>
227 <P>for example 
228 <P>
229 <BLOCKQUOTE><CODE>
230 <PRE>
231   accept/wwv by_zone 4
232 </PRE>
233 </CODE></BLOCKQUOTE>
234 <P>is probably the only useful thing to do (which will only show WWV broadcasts
235 by stations in the US).
236 <P>See HELP FILTER for information.
237 <P>
238 <H2><A NAME="ss13.8">13.8 accept/wwv (extended for sysops) (8)</A>
239 </H2>
240
241 <P><CODE><B>accept/wwv &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B>
242 WWV filter sysop version</CODE>
243 <P>
244 <P>This version allows a sysop to set a filter for a callsign as well as the
245 default for nodes and users eg:-
246 <P>
247 <BLOCKQUOTE><CODE>
248 <PRE>
249   accept/wwv db0sue-7 1 by_zone 4
250   accept/wwv node_default all
251   set/hops node_default 10
252
253   accept/wwv user_default by W,K
254 </PRE>
255 </CODE></BLOCKQUOTE>
256 <P>
257 <H2><A NAME="ss13.9">13.9 announce (0)</A>
258 </H2>
259
260 <P><CODE><B>announce &lt;text&gt;</B> Send an announcement to local users</CODE>
261 <P>
262 <P>Send an announcement to LOCAL users only, where &lt;text&gt; is the text 
263 of the announcement you wish to broadcast
264 <P>
265 <H2><A NAME="ss13.10">13.10 announce full (0)</A>
266 </H2>
267
268 <P><CODE><B>announce full &lt;text&gt;</B> Send an announcement cluster wide</CODE>
269 <P>
270 <P>This command will send your announcement across the whole cluster
271 network.
272 <P>
273 <P>
274 <H2><A NAME="ss13.11">13.11 announce sysop (5)</A>
275 </H2>
276
277 <P><CODE><B>announce sysop &lt;text&gt;</B></CODE>
278 <P>
279 <P>Send an announcement to Sysops only
280 <P>
281 <H2><A NAME="ss13.12">13.12 apropos (0)</A>
282 </H2>
283
284 <P><CODE><B>apropos &lt;string&gt;</B> Search the help database</CODE>
285 <P>
286 <P>Search the help database for &lt;string&gt; (it isn't case sensitive), 
287 and print the names of all the commands that may be relevant.
288 <P>
289 <H2><A NAME="ss13.13">13.13 bye (0)</A>
290 </H2>
291
292 <P><CODE><B>bye</B> Exit from the cluster</CODE>
293 <P>
294 <P>This will disconnect you from the cluster
295 <P>
296 <H2><A NAME="ss13.14">13.14 catchup (5)</A>
297 </H2>
298
299 <P><CODE><B>catchup &lt;node_call&gt; All|[&lt;msgno&gt; ...]</B> Mark a message as sent</CODE>
300 <P>
301 <P>When you send messages the fact that you have forwarded it to another node 
302 is remembered so that it isn't sent again. When you have a new partner
303 node and you add their callsign to your /spider/msg/forward.pl file, all
304 outstanding non-private messages will be forwarded to them. This may well
305 be ALL the non-private messages. You can prevent this by using these 
306 commmands:-
307 <P>
308 <BLOCKQUOTE><CODE>
309 <PRE>
310   catchup GB7DJK all
311   catchup GB7DJK 300 301 302 303 500-510
312 </PRE>
313 </CODE></BLOCKQUOTE>
314 <P>and to undo what you have just done:-
315 <P>
316 <BLOCKQUOTE><CODE>
317 <PRE>
318   uncatchup GB7DJK all
319   uncatchup GB7DJK 300 301 302 303 500-510
320 </PRE>
321 </CODE></BLOCKQUOTE>
322 <P>which will arrange for them to be forward candidates again.
323 <P>Order is not important.
324 <P>
325 <H2><A NAME="ss13.15">13.15 clear/spots (0)</A>
326 </H2>
327
328 <P><CODE><B>clear/spots [1|all]</B> Clear a spot filter line</CODE>
329 <P>
330 <P>This command allows you to clear (remove) a line in a spot filter or to 
331 remove the whole filter.
332 <P>If you have a filter:-
333 <P>
334 <BLOCKQUOTE><CODE>
335 <PRE>
336   acc/spot 1 on hf/cw
337   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
338 </PRE>
339 </CODE></BLOCKQUOTE>
340 <P>and you say:-
341 <P>
342 <BLOCKQUOTE><CODE>
343 <PRE>
344   clear/spot 1
345 </PRE>
346 </CODE></BLOCKQUOTE>
347 <P>you will be left with:-
348 <P>
349 <BLOCKQUOTE><CODE>
350 <PRE>
351   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
352 </PRE>
353 </CODE></BLOCKQUOTE>
354 <P>If you do:
355 <P>
356 <BLOCKQUOTE><CODE>
357 <PRE>
358   clear/spot all
359 </PRE>
360 </CODE></BLOCKQUOTE>
361 <P>the filter will be completely removed.
362 <P>
363 <P>
364 <H2><A NAME="ss13.16">13.16 connect (5) </A>
365 </H2>
366
367 <P><CODE><B>connect &lt;callsign&gt;</B> Start a connection to another DX Cluster</CODE>
368 <P>
369 <P>Start a connection process that will culminate in a new connection to the
370 DX cluster &lt;callsign&gt;. This process creates a new 'client' process which will
371 use the script in /spider/connect/&lt;callsign&gt; to effect the 'chat' exchange
372 necessary to traverse the network(s) to logon to the cluster &lt;callsign&gt;.
373 <P>
374 <H2><A NAME="ss13.17">13.17 dbavail (0)</A>
375 </H2>
376
377 <P><CODE><B>dbavail</B> Show a list of all the databases in the system</CODE>
378 <P>
379 <P>The title says it all really, this command lists all the databases defined
380 in the system. It is also aliased to SHOW/COMMAND.
381 <P>
382 <H2><A NAME="ss13.18">13.18 dbcreate (9)</A>
383 </H2>
384
385 <P><CODE><B>dbcreate &lt;name&gt;</B> Create a database entry<BR>
386 <B>dbcreate &lt;name&gt; chain &lt;name&gt; [&lt;name&gt;..]</B> Create a chained database entry<BR>
387 <B>dbcreate &lt;name&gt; remote &lt;node&gt;</B> Create a remote database
388 entry<BR></CODE>
389 <P>
390 <P>DBCREATE allows you to define a database in the system. It doesn't actually
391 create anything, just defines it.
392 <P>The databases that are created are simple DB_File hash databases, they are 
393 therefore already 'indexed'.
394 <P>You can define a local database with the first form of the command eg:
395 <P>DBCREATE oblast
396 <P>You can also chain databases with the addition of the 'chain' keyword. 
397 This will search each database one after the other. A typical example 
398 is:
399 <P>DBCREATE sdx_qsl chain sql_ad
400 <P>No checking is done to see if the any of the chained databases exist, in
401 fact it is usually better to do the above statement first then do each of
402 the chained databases.
403 <P>Databases can exist offsite. To define a database that lives on another 
404 node do:
405 <P>DBCREATE buckmaster remote gb7dxc
406 <P>Remote databases cannot be chained; however, the last database in a 
407 a chain can be a remote database eg:
408 <P>DBCREATE qsl chain gb7dxc
409 <P>To see what databases have been defined do:
410 <P>DBAVAIL (or it will have been aliased to SHOW/COMMAND)
411 <P>It would be normal for you to add an entry into your local Aliases file
412 to allow people to use the 'SHOW/&lt;dbname&gt;' style syntax. So you would
413 need to add a line like:-
414 <P>
415 <BLOCKQUOTE><CODE>
416 <PRE>
417   's' => [
418     ..
419     ..
420     '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
421     ..
422     ..
423    ],
424 </PRE>
425 </CODE></BLOCKQUOTE>
426 <P>to allow 
427 <P>SH/BUCK g1tlh
428 <P>to work as they may be used to.
429 <P>See DBIMPORT for the importing of existing AK1A format data to databases.
430 See DBSHOW for generic database enquiry
431 <P>
432 <H2><A NAME="ss13.19">13.19 dbimport (9)</A>
433 </H2>
434
435 <P><CODE><B>dbimport &lt;dbname&gt;</B> Import AK1A data into a database</CODE>
436 <P>
437 <P>If you want to import or update data in bulk to a database you can use
438 this command. It will either create or update entries into an existing
439 database. For example:-
440 <P>DBIMPORT oblast /tmp/OBLAST.FUL
441 <P>will import the standard OBLAST database that comes with AK1A into the
442 oblast database held locally.
443 <P>
444 <H2><A NAME="ss13.20">13.20 dbremove (9)</A>
445 </H2>
446
447 <P><CODE><B>dbremove &lt;dbname&gt;</B> Delete a database</CODE>
448 <P>
449 <P>DBREMOVE will completely remove a database entry and also delete any data
450 file that is associated with it. 
451 <P>There is no warning, no comeback, no safety net. 
452 <P>For example:
453 <P>DBREMOVE oblast 
454 <P>will remove the oblast database from the system and it will also remove
455 the associated datafile.
456 <P>I repeat:
457 <P>There is no warning, no comeback, no safety net.
458 <P>You have been warned.
459 <P>
460 <H2><A NAME="ss13.21">13.21 dbshow (0)</A>
461 </H2>
462
463 <P><CODE><B>dbshow &lt;dbname&gt; &lt;key&gt;</B> Display an entry, if it exists, in a database</CODE>
464 <P>
465 <P>This is the generic user interface to the database to the database system.
466 It is expected that the sysop will add an entry to the local Aliases file
467 so that users can use the more familiar AK1A style of enquiry such as:
468 <P>
469 <BLOCKQUOTE><CODE>
470 <PRE>
471   SH/BUCK G1TLH
472 </PRE>
473 </CODE></BLOCKQUOTE>
474 <P>but if he hasn't and the database really does exist (use DBAVAIL or
475 SHOW/COMMAND to find out) you can do the same thing with:
476 <P>
477 <BLOCKQUOTE><CODE>
478 <PRE>
479   DBSHOW buck G1TLH
480 </PRE>
481 </CODE></BLOCKQUOTE>
482 <P>
483 <P>
484 <H2><A NAME="ss13.22">13.22 debug (9)</A>
485 </H2>
486
487 <P><CODE><B>debug</B> Set the cluster program into debug mode</CODE>
488 <P>
489 <P>Executing this command will only have an effect if you are running the cluster
490 in debug mode i.e.
491 <P>
492 <BLOCKQUOTE><CODE>
493 <PRE>
494         perl -d cluster.pl
495 </PRE>
496 </CODE></BLOCKQUOTE>
497 <P>It will interrupt the cluster just after the debug command has finished.
498 <P>
499 <H2><A NAME="ss13.23">13.23 directory (0)</A>
500 </H2>
501
502 <P><CODE><B>directory</B> List messages<BR> <B>directory all</B> List all messages<BR>
503 <B>directory own</B> List your own messages<BR>
504 <B>directory new</B> List all new messages<BR>
505 <B>directory to &lt;call&gt;</B> List all messages to &lt;call&gt;<BR>
506 <B>directory from &lt;call&gt;</B> List all messages from &lt;call&gt;<BR>
507 <B>directory subject &lt;string&gt;</B> List all messages with &lt;string&gt; in subject<BR>
508 <B>directory &lt;nn&gt;</B> List last &lt;nn&gt; messages<BR>
509 <B>directory &lt;from&gt;-&lt;to&gt;</B> List messages &lt;from&gt; message &lt;to&gt; message <BR></CODE>
510 <P>
511 <P>List the messages in the messages directory.
512 <P>If there is a 'p' one space after the message number then it is a 
513 personal message. If there is a '-' between the message number and the
514 'p' then this indicates that the message has been read.
515 <P>You can use shell escape characters such as '*' and '?' in the &lt;call&gt;
516 fields.
517 <P>You can combine some of the various directory commands together eg:-
518 <P>
519 <BLOCKQUOTE><CODE>
520 <PRE>
521    DIR TO G1TLH 5
522 or 
523    DIR SUBJECT IOTA 200-250
524 </PRE>
525 </CODE></BLOCKQUOTE>
526 <P>You can abbreviate all the commands to one letter and use ak1a syntax:-
527 <P>
528 <BLOCKQUOTE><CODE>
529 <PRE>
530    DIR/T G1* 10
531    DIR/S QSL 10-100 5
532 </PRE>
533 </CODE></BLOCKQUOTE>
534 <P>
535 <P>
536 <H2><A NAME="ss13.24">13.24 directory (extended for sysops) (5)</A>
537 </H2>
538
539 <P>Works just like the user command except that sysops can see ALL messages.
540 <P>
541 <H2><A NAME="ss13.25">13.25 disconnect (8)</A>
542 </H2>
543
544 <P><CODE><B>disconnect &lt;call&gt; [&lt;call&gt; ...]</B> Disconnect a user or node</CODE>
545 <P>
546 <P>Disconnect any &lt;call&gt; connected locally
547 <P>
548 <H2><A NAME="ss13.26">13.26 dx (0)</A>
549 </H2>
550
551 <P><CODE><B>dx [by &lt;call&gt;] &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</B> Send a DX spot</CODE>
552 <P>
553 <P>This is how you send a DX Spot to other users. You can, in fact, now
554 enter the &lt;freq&gt; and the &lt;call&gt; either way round. 
555 <P>
556 <BLOCKQUOTE><CODE>
557 <PRE>
558    DX FR0G 144.600
559    DX 144.600 FR0G
560    DX 144600 FR0G 
561 </PRE>
562 </CODE></BLOCKQUOTE>
563 <P>will all give the same result. You can add some remarks to the end
564 of the command and they will be added to the spot.
565 <P>
566 <BLOCKQUOTE><CODE>
567 <PRE>
568    DX FR0G 144600 this is a test
569 </PRE>
570 </CODE></BLOCKQUOTE>
571 <P>You can credit someone else by saying:-
572 <P>
573 <BLOCKQUOTE><CODE>
574 <PRE>
575    DX by G1TLH FR0G 144.600 he isn't on the cluster
576 </PRE>
577 </CODE></BLOCKQUOTE>
578 <P>The &lt;freq&gt; is compared against the available bands set up in the 
579 cluster.  See SHOW/BANDS for more information.
580 <P>
581 <H2><A NAME="ss13.27">13.27 export (9)</A>
582 </H2>
583
584 <P><CODE><B>export &lt;msgno&gt; &lt;filename&gt;</B> Export a message to a file</CODE>
585 <P>
586 <P>Export a message to a file. This command can only be executed on a local
587 console with a fully privileged user. The file produced will be in a form
588 ready to be imported back into the cluster by placing it in the import 
589 directory (/spider/msg/import).
590 <P>This command cannot overwrite an existing file. This is to provide some 
591 measure of security. Any files written will owned by the same user as the 
592 main cluster, otherwise you can put the new files anywhere the cluster can
593 access. For example:-
594 <P>EXPORT 2345 /tmp/a
595 <P>
596 <H2><A NAME="ss13.28">13.28 export_users (9)</A>
597 </H2>
598
599 <P><CODE><B>export_users [&lt;filename&gt;]</B> Export the users database to ascii</CODE>
600 <P>
601 <P>Export the users database to a file in ascii format. If no filename
602 is given then it will export the file to /spider/data/user_asc.
603 <P>If the file already exists it will be renamed to &lt;filename&gt;.o. In fact
604 up to 5 generations of the file can be kept each one with an extra 'o' on the
605 suffix. 
606 <P>BE WARNED: this will write to any file you have write access to. No check is
607 made on the filename (if any) that you specify.
608 <P>
609 <H2><A NAME="ss13.29">13.29 forward/latlong (8)</A>
610 </H2>
611
612 <P><CODE><B>forward/latlong &lt;node_call&gt;</B> Send latitude and longitude information to another cluster</CODE>
613 <P>
614 <P>This command sends all the latitude and longitude information that your
615 cluster is holding against callsigns.  One advantage of recieving this
616 information is that more locator information is held by you.  This
617 means that more locators are given on the DX line assuming you have
618 <EM>set/dxgrid</EM> enabled.  This could be a LOT of information though, so
619 it is not recommended on slow links.
620 <P>
621 <H2><A NAME="ss13.30">13.30 forward/opername (1)</A>
622 </H2>
623
624 <P><CODE><B>forward/opername &lt;call&gt;</B> Send out information on this &lt;call&gt; to all clusters</CODE>
625 <P>
626 <P>This command sends out any information held in the user file which can 
627 be broadcast in PC41 protocol packets. This information is Name, QTH, Location
628 and Homenode. PC41s are only sent for the information that is available.
629 <P>
630 <H2><A NAME="ss13.31">13.31 help (0)</A>
631 </H2>
632
633 <P><CODE><B>help &lt;cmd&gt;</B> Get help on a command</CODE>
634 <P>
635 <P>All commands can be abbreviated, so SHOW/DX can be abbreviated
636 to SH/DX, ANNOUNCE can be shortened to AN and so on.
637 <P>Look at the APROPOS &lt;string&gt; command which will search the help database
638 for the &lt;string&gt; you specify and give you a list of likely commands
639 to look at with HELP.
640 <P>
641 <H2><A NAME="ss13.32">13.32 init (5)</A>
642 </H2>
643
644 <P><CODE><B>init &lt;node call&gt;</B> Re-initialise a link to an AK1A compatible node</CODE>
645 <P>
646 <P>This command attempts to re-initialise a link to a (usually) AK1A node
647 that has got confused, usually by a protocol loop of some kind. It may
648 work - but you usually will be better off simply disconnecting it (or
649 better, if it is a real AK1A node, doing an RCMD &lt;node&gt; DISC/F &lt;your
650 node&gt;).
651 <P>Best of luck - you will need it.
652 <P>
653 <H2><A NAME="ss13.33">13.33 kill (0)</A>
654 </H2>
655
656 <P><CODE><B>kill &lt;msgno&gt; [&lt;msgno&gt; ..]</B> Delete a message from the local system</CODE>
657 <P>
658 <P>Delete a message from the local system. You will only be able to
659 delete messages that you have originated or been sent (unless you are
660 the sysop).
661 <P>
662 <H2><A NAME="ss13.34">13.34 kill (5)</A>
663 </H2>
664
665 <P><CODE><B>kill &lt;msgno&gt; [&lt;msgno&gt; ...]</B> Remove or erase a message from the system<BR>
666 <B>kill from &lt;call&gt;</B> Remove all messages from a callsign<BR>
667 <B>kill to &lt;call&gt;</B> Remove all messages to a callsign<BR></CODE>
668 <P>
669 <P>You can get rid of any message to or originating from your callsign using 
670 this command. You can remove more than one message at a time.
671 <P>As a sysop you can kill any message on the system.
672 <P>
673 <H2><A NAME="ss13.35">13.35 kill full (5)</A>
674 </H2>
675
676 <P><CODE><B>kill full &lt;msgno&gt; [&lt;msgno&gt;]</B> Delete a message from the whole cluster</CODE>
677 <P>
678 <P>Delete a message (usually a 'bulletin') from the whole cluster system. 
679 <P>This uses the subject field, so any messages that have exactly the same subject
680 will be deleted. Beware!
681 <P>
682 <H2><A NAME="ss13.36">13.36 links (0)</A>
683 </H2>
684
685 <P><CODE><B>links</B> Show which nodes are physically connected</CODE>
686 <P>
687 <P>This is a quick listing that shows which links are connected and
688 some information about them. See WHO for a list of all connections.
689 <P>
690 <P>
691 <H2><A NAME="ss13.37">13.37 load/aliases (9)</A>
692 </H2>
693
694 <P><CODE><B>load/aliases</B> Reload the command alias table</CODE>
695 <P>
696 <P>Reload the /spider/cmd/Aliases file after you have editted it. You will need to
697 do this if you change this file whilst the cluster is running in order for the
698 changes to take effect.
699 <P>
700 <P>
701 <H2><A NAME="ss13.38">13.38 load/baddx (9)</A>
702 </H2>
703
704 <P><CODE><B>load/baddx</B> Reload the bad DX table</CODE>
705 <P>
706 <P>Reload the /spider/data/baddx.pl file if you have changed it manually whilst
707 the cluster is running. This table contains the DX Calls that, if spotted, 
708 will not be passed on. FR0G and TEST are classic examples.
709 <P>
710 <H2><A NAME="ss13.39">13.39 load/badmsg (9)</A>
711 </H2>
712
713 <P><CODE><B>load/badmsg</B> Reload the bad message table</CODE>
714 <P>
715 <P>Reload the /spider/msg/badmsg.pl file if you have changed it manually whilst
716 the cluster is running. This table contains a number of perl regular 
717 expressions which are searched for in the fields targetted of each message. 
718 If any of them match then that message is immediately deleted on receipt. 
719 <P>
720 <H2><A NAME="ss13.40">13.40 load/badwords (9)</A>
721 </H2>
722
723 <P><CODE><B>load/badwords</B> Reload the badwords file</CODE>
724 <P>
725 <P>Reload the /spider/data/badwords file if you have changed it manually whilst
726 the cluster is running. This file contains a list of words which, if found
727 on certain text portions of PC protocol, will cause those protocol frames
728 to be rejected. It will all put out a message if any of these words are
729 used on the announce, dx and talk commands. The words can be one or 
730 more on a line, lines starting with '#' are ignored.
731 <P>
732 <H2><A NAME="ss13.41">13.41 load/bands (9)</A>
733 </H2>
734
735 <P><CODE><B>load/bands</B> Reload the band limits table</CODE>
736 <P>
737 <P>Reload the /spider/data/bands.pl file if you have changed it manually whilst
738 the cluster is running. 
739 <P>
740 <H2><A NAME="ss13.42">13.42 load/cmd_cache (9)</A>
741 </H2>
742
743 <P><CODE><B>load/cmd_cache</B> Reload the automatic command cache</CODE>
744 <P>
745 <P>Normally, if you change a command file in the cmd or local_cmd tree it will
746 automatially be picked up by the cluster program. Sometimes it can get confused
747 if you are doing a lot of moving commands about or delete a command in the 
748 local_cmd tree and want to use the normal one again. Execute this command to
749 reset everything back to the state it was just after a cluster restart.
750 <P>
751 <H2><A NAME="ss13.43">13.43 load/forward (9)</A>
752 </H2>
753
754 <P><CODE><B>load/forward</B> Reload the msg forwarding routing table</CODE>
755 <P>Reload the /spider/msg/forward.pl file if you have changed it
756 manually whilst the cluster is running.
757 <P>
758 <H2><A NAME="ss13.44">13.44 load/messages (9)</A>
759 </H2>
760
761 <P><CODE><B>load/messages</B> Reload the system messages file</CODE>
762 <P>
763 <P>If you change the /spider/perl/Messages file (usually whilst fiddling/writing ne
764 commands) you can have them take effect during a cluster session by executing this
765 command. You need to do this if get something like :-
766 <P>unknown message 'xxxx' in lang 'en'
767 <P>
768 <H2><A NAME="ss13.45">13.45 load/prefixes (9)</A>
769 </H2>
770
771 <P><CODE><B>load/prefixes</B> Reload the prefix table</CODE>
772 <P>
773 <P>Reload the /spider/data/prefix_data.pl file if you have changed it manually 
774 whilst the cluster is running. 
775 <P>
776 <H2><A NAME="ss13.46">13.46 merge (5)</A>
777 </H2>
778
779 <P><CODE><B>merge &lt;node&gt; [&lt;no spots&gt;/&lt;no wwv&gt;]</B> Ask for the latest spots and WWV</CODE>
780 <P>
781 <P>MERGE allows you to bring your spot and wwv database up to date. By default
782 it will request the last 10 spots and 5 WWVs from the node you select. The 
783 node must be connected locally.
784 <P>You can request any number of spots or wwv and although they will be appended
785 to your databases they will not duplicate any that have recently been added 
786 (the last 2 days for spots and last month for WWV data).
787 <P>
788 <H2><A NAME="ss13.47">13.47 msg (9)</A>
789 </H2>
790
791 <P><CODE><B>msg &lt;cmd&gt; &lt;msgno&gt; [data ...]</B> Alter various message parameters</CODE>
792 <P>
793 <P>Alter message parameters like To, From, Subject, whether private or bulletin
794 or return receipt (RR) is required or whether to keep this message from timing
795 out.
796 <P>
797 <BLOCKQUOTE><CODE>
798 <PRE>
799   MSG TO &lt;msgno> &lt;call>     - change TO callsign to &lt;call>
800   MSG FRom &lt;msgno> &lt;call>   - change FROM callsign to &lt;call>
801   MSG PRrivate &lt;msgno>      - set private flag
802   MSG NOPRrivate &lt;msgno>    - unset private flag
803   MSG RR &lt;msgno>            - set RR flag
804   MSG NORR &lt;msgno>          - unset RR flag
805   MSG KEep &lt;msgno>          - set the keep flag (message won't be deleted ever)
806   MSG NOKEep &lt;msgno>        - unset the keep flag
807   MSG SUbject &lt;msgno> &lt;new> - change the subject to &lt;new>
808   MSG WAittime &lt;msgno>      - remove any waitting time for this message
809   MSG NOREad &lt;msgno>        - mark message as unread
810   MSG REad &lt;msgno>          - mark message as read
811   MSG QUeue                 - queue any outstanding bulletins
812   MSG QUeue 1               - queue any outstanding private messages
813 </PRE>
814 </CODE></BLOCKQUOTE>
815 <P>You can look at the status of a message by using:-
816 <P>STAT/MSG &lt;msgno&gt;      
817 <P>This will display more information on the message than DIR does.
818 <P>
819 <H2><A NAME="ss13.48">13.48 pc (8)</A>
820 </H2>
821
822 <P><CODE><B>pc &lt;call&gt; &lt;text&gt;</B> Send text (eg PC Protocol) to &lt;call&gt;</CODE>
823 <P>
824 <P>Send some arbitrary text to a locally connected callsign. No processing is done on
825 the text. This command allows you to send PC Protocol to unstick things if problems
826 arise (messages get stuck etc). eg:-
827 <P>pc gb7djk PC33^GB7TLH^GB7DJK^400^
828 <P>You can also use in the same way as a talk command to a connected user but
829 without any processing, added of "from &lt;blah&gt; to &lt;blah&gt;" or whatever.
830 <P>pc G1TLH Try doing that properly!!!
831 <P>
832 <H2><A NAME="ss13.49">13.49 ping (1)</A>
833 </H2>
834
835 <P><CODE><B>ping &lt;node&gt;</B> Check the link quality between nodes</CODE>
836 <P>
837 <P>his command allows you to send a frame to another cluster node on
838 the network and get a return frame.  The time it takes to do this
839 is a good indication of the quality of the link.  The actual time
840 it takes is output to the console in seconds.
841 Any visible cluster node can be PINGed.
842 <P>
843 <P>
844 <H2><A NAME="ss13.50">13.50 rcmd (1)</A>
845 </H2>
846
847 <P><CODE><B>rcmd &lt;node call&gt; &lt;cmd&gt;</B> Send a command to another DX cluster</CODE>
848 <P>
849 <P>This command allows you to send nearly any command to another DX Cluster
850 node that is connected to the system. 
851 <P>Whether you get any output is dependant on a) whether the other system knows
852 that the node callsign of this cluster is in fact a node b) whether the
853 other system is allowing RCMDs from this node and c) whether you have
854 permission to send this command at all.
855 <P>
856 <H2><A NAME="ss13.51">13.51 read (0)</A>
857 </H2>
858
859 <P><CODE><B>read</B> Read the next unread personal message addressed to you<BR>
860 <B>read &lt;msgno&gt;</B> Read the specified message<BR></CODE>
861 <P>
862 <P>You can read any messages that are sent as 'non-personal' and also any
863 message either sent by or sent to your callsign.
864 <P>
865 <P>
866 <H2><A NAME="ss13.52">13.52 read (extended for sysops) (5) </A>
867 </H2>
868
869 <P><CODE><B>read &lt;msgno&gt;</B> Read a message on the system</CODE>
870 <P>
871 <P>As a sysop you may read any message on the system
872 <P>
873 <H2><A NAME="ss13.53">13.53 reject/announce</A>
874 </H2>
875
876 <P><CODE><B>reject/announce [0-9] &lt;pattern&gt;</B> Set a reject filter
877 for announce</CODE>
878 <P>
879 <P>Create an 'reject this announce' line for a filter. 
880 <P>An reject filter line means that if the announce matches this filter it is
881 passed onto the user. See HELP FILTERS for more info. Please read this
882 to understand how filters work - it will save a lot of grief later on.
883 <P>You can use any of the following things in this line:-
884 <P>
885 <BLOCKQUOTE><CODE>
886 <PRE>
887   info &lt;string>            eg: iota or qsl
888   by &lt;prefixes>            eg: G,M,2         
889   origin &lt;prefixes>
890   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
891   origin_itu &lt;numbers>
892   origin_zone &lt;numbers>
893   by_dxcc &lt;numbers>
894   by_itu &lt;numbers>
895   by_zone &lt;numbers>
896   channel &lt;prefixes>
897   wx 1                     filter WX announces
898   dest &lt;prefixes>          eg: 6MUK,WDX      (distros)
899 </PRE>
900 </CODE></BLOCKQUOTE>
901 <P>some examples:-
902 <P>
903 <BLOCKQUOTE><CODE>
904 <PRE>
905   rej/ann by_zone 14,15,16 and not by G,M,2
906 </PRE>
907 </CODE></BLOCKQUOTE>
908 <P>You can use the tag 'all' to reject everything eg:
909 <P>
910 <BLOCKQUOTE><CODE>
911 <PRE>
912   rej/ann all
913 </PRE>
914 </CODE></BLOCKQUOTE>
915 <P>but this probably for advanced users...
916 <P>
917 <H2><A NAME="ss13.54">13.54 reject/announce (extended for sysops) (8)</A>
918 </H2>
919
920 <P><CODE><B>reject/announce &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B> Announce filter sysop version</CODE>
921 <P>
922 <P>This version allows a sysop to set a filter for a callsign as well as the
923 default for nodes and users eg:-
924 <P>
925 <BLOCKQUOTE><CODE>
926 <PRE>
927   reject/ann by G,M,2
928   reject/ann input node_default by G,M,2
929   reject/ann user_default by G,M,2
930 </PRE>
931 </CODE></BLOCKQUOTE>
932 <P>
933 <H2><A NAME="ss13.55">13.55 reject/spots (0)</A>
934 </H2>
935
936 <P><CODE><B>reject/spots [0-9] &lt;pattern&gt;</B> Set a reject filter line for spots</CODE>
937 <P>
938 <P>Create a 'reject this spot' line for a filter. 
939 <P>A reject filter line means that if the spot matches this filter it is
940 dumped (not passed on). See HELP FILTERS for more info. Please read this
941 to understand how filters work - it will save a lot of grief later on.
942 <P>You can use any of the following things in this line:-
943 <P>
944 <BLOCKQUOTE><CODE>
945 <PRE>
946   freq &lt;range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
947   on &lt;range>             same as 'freq'
948   call &lt;prefixes>        eg: G,PA,HB9
949   info &lt;string>          eg: iota or qsl
950   by &lt;prefixes>            
951   call_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
952   call_itu &lt;numbers>
953   call_zone &lt;numbers>
954   by_dxcc &lt;numbers>
955   by_itu &lt;numbers>
956   by_zone &lt;numbers>
957   origin &lt;prefixes>
958   channel &lt;prefixes>
959 </PRE>
960 </CODE></BLOCKQUOTE>
961 <P>For frequencies, you can use any of the band names defined in
962 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
963 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
964 this is more efficient than saying simply: on HF (but don't get
965 too hung up about that)
966 <P>some examples:-
967 <P>
968 <BLOCKQUOTE><CODE>
969 <PRE>
970   rej/spot 1 on hf
971   rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
972 </PRE>
973 </CODE></BLOCKQUOTE>
974 <P>You can use the tag 'all' to reject everything eg:
975 <P>
976 <BLOCKQUOTE><CODE>
977 <PRE>
978   rej/spot 3 all
979 </PRE>
980 </CODE></BLOCKQUOTE>
981 <P>but this probably for advanced users...
982 <P>
983 <H2><A NAME="ss13.56">13.56 reject/spots (extended for sysops) (8)</A>
984 </H2>
985
986 <P><CODE><B>reject/spots &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B>
987 Reject spot filter sysop version </CODE>
988 <P>
989 <P>This version allows a sysop to set a filter for a callsign as well as the
990 default for nodes and users eg:-
991 <P>
992 <BLOCKQUOTE><CODE>
993 <PRE>
994   reject/spot db0sue-7 1 by_zone 14,15,16
995   reject/spot node_default all
996   set/hops node_default 10
997
998   reject/spot user_default by G,M,2
999 </PRE>
1000 </CODE></BLOCKQUOTE>
1001 <P>
1002 <H2><A NAME="ss13.57">13.57 reject/wcy (0)</A>
1003 </H2>
1004
1005 <P><CODE><B>reject/wcy [0-9] &lt;pattern&gt;</B> Set a reject WCY filter</CODE>
1006 <P>
1007 <P>It is unlikely that you will want to do this, but if you do then you can
1008 filter on the following fields:-
1009 <P>
1010 <BLOCKQUOTE><CODE>
1011 <PRE>
1012   by &lt;prefixes>            eg: G,M,2         
1013   origin &lt;prefixes>
1014   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
1015   origin_itu &lt;numbers>
1016   origin_zone &lt;numbers>
1017   by_dxcc &lt;numbers>
1018   by_itu &lt;numbers>
1019   by_zone &lt;numbers>
1020   channel &lt;prefixes>
1021 </PRE>
1022 </CODE></BLOCKQUOTE>
1023 <P>There are no examples because WCY Broadcasts only come from one place and
1024 you either want them or not (see UNSET/WCY if you don't want them).
1025 <P>This command is really provided for future use.
1026 <P>See HELP FILTER for information.
1027 <P>
1028 <H2><A NAME="ss13.58">13.58 reject/wcy (extended for sysops) (8)</A>
1029 </H2>
1030
1031 <P><CODE><B>reject/wcy &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B>
1032 WCY reject filter sysop version</CODE>
1033 <P>
1034 <P>This version allows a sysop to set a filter for a callsign as well as the
1035 default for nodes and users eg:-
1036 <P>reject/wcy gb7djk all
1037 <P>
1038 <H2><A NAME="ss13.59">13.59 reject/wwv (0)</A>
1039 </H2>
1040
1041 <P><CODE><B>reject/wwv [0-9] &lt;pattern&gt;</B> Set a reject WWV filter</CODE>
1042 <P>
1043 <P>It is unlikely that you will want to do this, but if you do then you can
1044 filter on the following fields:-
1045 <P>
1046 <BLOCKQUOTE><CODE>
1047 <PRE>
1048   by &lt;prefixes>            eg: G,M,2         
1049   origin &lt;prefixes>
1050   origin_dxcc &lt;numbers>    eg: 61,62 (from eg: sh/pre G)
1051   origin_itu &lt;numbers>
1052   origin_zone &lt;numbers>
1053   by_dxcc &lt;numbers>
1054   by_itu &lt;numbers>
1055   by_zone &lt;numbers>
1056   channel &lt;prefixes>
1057 </PRE>
1058 </CODE></BLOCKQUOTE>
1059 <P>for example 
1060 <P>
1061 <BLOCKQUOTE><CODE>
1062 <PRE>
1063   reject/wwv by_zone 14,15,16
1064 </PRE>
1065 </CODE></BLOCKQUOTE>
1066 <P>is probably the only useful thing to do (which will only show WWV broadcasts
1067 by stations in the US).
1068 <P>See HELP FILTER for information.
1069 <P>
1070 <H2><A NAME="ss13.60">13.60 reject/wwv (extended for sysops) (8)</A>
1071 </H2>
1072
1073 <P><CODE><B>reject/wwv &lt;call&gt; [input] [0-9] &lt;pattern&gt;</B>
1074 WWV reject filter sysop version</CODE>
1075 <P>
1076 <P>This version allows a sysop to set a filter for a callsign as well as the
1077 default for nodes and users eg:-
1078 <P>
1079 <BLOCKQUOTE><CODE>
1080 <PRE>
1081   reject/wwv db0sue-7 1 by_zone 4
1082   reject/wwv node_default all
1083
1084   reject/wwv user_default by W
1085 </PRE>
1086 </CODE></BLOCKQUOTE>
1087 <P>
1088 <H2><A NAME="ss13.61">13.61 reply (0)</A>
1089 </H2>
1090
1091 <P><CODE><B>reply</B> Reply (privately) to the last message that you have read<BR>
1092 <B>reply &lt;msgno&gt;</B> Reply (privately) to the specified message<BR>
1093 <B>reply B &lt;msgno&gt;</B> Reply as a Bulletin to the specified message<BR>
1094 <B>reply NOPrivate &lt;msgno&gt;</B> Reply as a Bulletin to the specified
1095 message<BR>
1096 <B>reply RR &lt;msgno&gt;</B> Reply to the specified message with read receipt<BR></CODE>
1097 <P>
1098 <P>You can reply to a message and the subject will automatically have
1099 "Re:" inserted in front of it, if it isn't already present.
1100 <P>You can also use all the extra qualifiers such as RR, PRIVATE, 
1101 NOPRIVATE, B that you can use with the SEND command (see SEND
1102 for further details)
1103 <P>
1104 <H2><A NAME="ss13.62">13.62 send (0)</A>
1105 </H2>
1106
1107 <P><CODE><B>send &lt;call&gt; [&lt;call&gt; ...]</B> Send a message to one or more callsigns<BR>
1108 <B>send RR &lt;call&gt;</B> Send a message and ask for a read receipt<BR>
1109 <B>send COPY &lt;msgno&gt; &lt;call&gt;</B> Send a copy of a  message to someone<BR>
1110 <B>send PRIVATE &lt;call&gt;</B> Send a personal message<BR>
1111 <B>send NOPRIVATE &lt;call&gt;</B> Send a message to all stations<BR></CODE>
1112 <P>
1113 <P>All the SEND commands will create a message which will be sent either to
1114 an individual callsign or to one of the 'bulletin' addresses. 
1115 <P>SEND &lt;call&gt; on its own acts as though you had typed SEND PRIVATE, that is
1116 it will mark the message as personal and send it to the cluster node that
1117 that callsign is connected to.
1118 <P>You can have more than one callsign in all of the SEND commands.
1119 <P>You can have multiple qualifiers so that you can have for example:-
1120 <P>
1121 <BLOCKQUOTE><CODE>
1122 <PRE>
1123   SEND RR COPY 123 PRIVATE G1TLH G0RDI
1124 </PRE>
1125 </CODE></BLOCKQUOTE>
1126 <P>which should send a copy of message 123 to G1TLH and G0RDI and you will
1127 receive a read receipt when they have read the message.
1128 <P>SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
1129 SP is an alias for SEND PRIVATE
1130 <P>
1131 <H2><A NAME="ss13.63">13.63 set/address (0)</A>
1132 </H2>
1133
1134 <P><CODE><B>set/address &lt;your_address&gt;</B> Record your postal address</CODE>
1135 <P>
1136 <P>Literally, record your address details on the cluster.
1137 <P>
1138 <H2><A NAME="ss13.64">13.64 set/announce (0)</A>
1139 </H2>
1140
1141 <P><CODE><B>set/announce</B> Allow announce messages</CODE>
1142 <P>
1143 <P>Allow announce messages to arrive at your terminal.
1144 <P>
1145 <H2><A NAME="ss13.65">13.65 set/arcluster (5)</A>
1146 </H2>
1147
1148 <P><CODE><B>set/arcluster &lt;node_call&gt; [&lt;node_call&gt; ...]</B> Make
1149 the node_call an AR-Cluster type node</CODE>
1150 <P>
1151 <P>Set the node_call as an AR-Cluster type node
1152 <P>
1153 <H2><A NAME="ss13.66">13.66 set/baddx (8)</A>
1154 </H2>
1155
1156 <P><CODE><B>set/baddx &lt;call&gt;</B> Stop words we do not wish to see in the callsign field
1157 of a dx spot being propagated</CODE>
1158 <P>
1159 <P>Setting a word as 'baddx' will prevent spots with that word in the callsign 
1160 field of a DX spot from going any further. They will not be displayed and they 
1161 will not be sent onto other nodes.
1162 <P>The word must be wriiten in full, no wild cards are allowed eg:-
1163 <P>
1164 <BLOCKQUOTE><CODE>
1165 <PRE>
1166   set/baddx FORSALE VIDEO FR0G 
1167 </PRE>
1168 </CODE></BLOCKQUOTE>
1169 <P>To allow a word again, use the following command ...
1170 <P>
1171 <BLOCKQUOTE><CODE>
1172 <PRE>
1173   unset/baddx VIDEO
1174 </PRE>
1175 </CODE></BLOCKQUOTE>
1176 <P>
1177 <H2><A NAME="ss13.67">13.67 set/badnode (6)</A>
1178 </H2>
1179
1180 <P><CODE><B>set/badnode &lt;node_call&gt;</B> Stop spots from this node_call
1181 being propagated</CODE>
1182 <P>
1183 <P>Setting a callsign as a 'badnode' will prevent spots from that node 
1184 going any further. They will not be displayed and they will not be 
1185 sent onto other nodes.
1186 <P>The call can be a full or partial call (or a prefix), eg:-
1187 <P>
1188 <BLOCKQUOTE><CODE>
1189 <PRE>
1190   set/badnode K1TTT 
1191 </PRE>
1192 </CODE></BLOCKQUOTE>
1193 <P>will stop anything from K1TTT (including any SSID's)
1194 <P>
1195 <BLOCKQUOTE><CODE>
1196 <PRE>
1197   unset/badnode K1TTT
1198 </PRE>
1199 </CODE></BLOCKQUOTE>
1200 <P>will allow spots from him again.
1201 <P>Use with extreme care. This command may well be superceded by FILTERing.
1202 <P>
1203 <H2><A NAME="ss13.68">13.68 set/badspotter (8)</A>
1204 </H2>
1205
1206 <P><CODE><B>set/badspotter &lt;call&gt;</B> Stop spots from this callsign being propagated</CODE>
1207 <P>
1208 <P>Setting a callsign as a 'badspotter' will prevent spots from this callsign 
1209 going any further. They will not be displayed and they will not be 
1210 sent onto other nodes.
1211 <P>The call must be written in full, no wild cards are allowed eg:-
1212 <P>
1213 <BLOCKQUOTE><CODE>
1214 <PRE>
1215   set/badspotter VE2STN 
1216 </PRE>
1217 </CODE></BLOCKQUOTE>
1218 <P>will stop anything from VE2STN. If you want SSIDs as well then you must
1219 enter them specifically.
1220 <P>
1221 <BLOCKQUOTE><CODE>
1222 <PRE>
1223   unset/badspotter VE2STN
1224 </PRE>
1225 </CODE></BLOCKQUOTE>
1226 <P>will allow spots from him again.
1227 <P>Use with extreme care. This command may well be superceded by FILTERing.
1228 <P>
1229 <H2><A NAME="ss13.69">13.69 set/beep (0)</A>
1230 </H2>
1231
1232 <P><CODE><B>set/beep</B> Add beeps to terminal messages</CODE>
1233 <P>
1234 <P>Add a beep to DX and other terminal messages.
1235 <P>
1236 <H2><A NAME="ss13.70">13.70 set/clx (5)</A>
1237 </H2>
1238
1239 <P><CODE><B>set/clx &lt;node_call&gt; [&lt;node_call&gt; ...]</B> Make
1240 the node_call a CLX type node</CODE>
1241 <P>
1242 <P>Set the node_call as a CLX type node
1243 <P>
1244 <H2><A NAME="ss13.71">13.71 set/debug (9)</A>
1245 </H2>
1246
1247 <P><CODE><B>set/debug &lt;name&gt;</B> Add a debug level to the debug set</CODE>
1248 <P>
1249 <P>You can choose to log several different levels.  The levels are
1250 <P>chan
1251 state
1252 msg
1253 cron
1254 connect
1255 <P>You can show what levels you are logging with the <EM>show/debug</EM>
1256 command.
1257 <P>You can remove a debug level with unset/debug &lt;name&gt;
1258 <P>
1259 <H2><A NAME="ss13.72">13.72 set/dx (0)</A>
1260 </H2>
1261
1262 <P><CODE><B>set/dx</B>Allow DX messages to arrive at your terminal</CODE>
1263 <P>
1264 <P>You can stop DX messages with the <EM>unset/dx</EM> command
1265 <P>
1266 <H2><A NAME="ss13.73">13.73 set/dxgrid (0)</A>
1267 </H2>
1268
1269 <P><CODE><B>set/dxgrid</B>Allow grid squares on the end of DX messages</CODE>
1270 <P>
1271 <P>Some logging programs do not like the additional information at
1272 the end of a DX spot.  If this is the case, use the <EM>unset/dxgrid</EM>
1273 command to remove the grid squares.
1274 <P>
1275 <H2><A NAME="ss13.74">13.74 set/dxnet (5)</A>
1276 </H2>
1277
1278 <P><CODE><B>set/dxnet &lt;node_call&gt; [&lt;node_call&gt; ...]</B> Make
1279 the node_call a DXNet type node</CODE>
1280 <P>
1281 <P>Set the node_call as a DXNet type node
1282 <P>
1283 <H2><A NAME="ss13.75">13.75 set/echo (0)</A>
1284 </H2>
1285
1286 <P><CODE><B>set/echo</B> Make the cluster echo your input</CODE>
1287 <P>
1288 <P>If you are connected via a telnet session, different implimentations
1289 of telnet handle echo differently depending on whether you are 
1290 connected via port 23 or some other port. You can use this command
1291 to change the setting appropriately. 
1292 <P>You can remove the echo with the <EM>unset/echo</EM> command
1293 <P>The setting is stored in your user profile.
1294 <P>YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
1295 <P>
1296 <H2><A NAME="ss13.76">13.76 set/here (0)</A>
1297 </H2>
1298
1299 <P><CODE><B>set/here</B> Set the here flag</CODE>
1300 <P>
1301 <P>Let others on the cluster know you are here by only displaying your
1302 callsign.  If you are away from your terminal you can use the <EM>unset/here</EM>
1303 command to let people know you are away.  This simply puts brackets
1304 around your callsign to indicate you are not available.
1305 <P>
1306 <H2><A NAME="ss13.77">13.77 set/homenode (0)</A>
1307 </H2>
1308
1309 <P><CODE><B>set/homenode &lt;node_call&gt;</B> Set your home cluster</CODE>
1310 <P>
1311 <P>Tell the cluster system where you normally connect to. Any Messages sent
1312 to you will normally find their way there should you not be connected.
1313 eg:-
1314 <P>
1315 <BLOCKQUOTE><CODE>
1316 <PRE>
1317   SET/HOMENODE gb7djk
1318 </PRE>
1319 </CODE></BLOCKQUOTE>
1320 <P>
1321 <H2><A NAME="ss13.78">13.78 set/hops (8)</A>
1322 </H2>
1323
1324 <P><CODE><B>set/hops &lt;node_call&gt; ann|spots|wwv|wcy &lt;n&gt;</B>
1325 Set hop count</CODE>
1326 <P>
1327 <P>Set the hop count for a particular type of broadcast for a node.
1328 <P>This command allows you to set up special hop counts for a node 
1329 for currently: announce, spots, wwv and wcy broadcasts.
1330 <P>
1331 <BLOCKQUOTE><CODE>
1332 <PRE>
1333 eg:
1334   set/hops gb7djk ann 10
1335   set/hops gb7mbc spots 20
1336 </PRE>
1337 </CODE></BLOCKQUOTE>
1338 <P>Set SHOW/HOPS for information on what is already set. This command
1339 creates a filter and works in conjunction with the filter system. 
1340 <P>
1341 <H2><A NAME="ss13.79">13.79 set/isolate (9)</A>
1342 </H2>
1343
1344 <P><CODE><B>set/isolate &lt;node call&gt;</B> Isolate a node from the rest of the network</CODE>
1345 <P>
1346 <P>Connect a node to your system in such a way that you are a full protocol
1347 member of its network and can see all spots on it, but nothing either leaks
1348 out from it nor goes back into from the rest of the nodes connected to you.
1349 <P>You can potentially connect several nodes in this way.
1350 <P>You can see which nodes are isolated with the show/isolate (1) command.
1351 <P>You can remove the isolation with the command unset/isolate.
1352 <P>
1353 <H2><A NAME="ss13.80">13.80 set/language (0)</A>
1354 </H2>
1355
1356 <P><CODE><B>set/language &lt;language&gt;</B> Set the language you wish to use</CODE>
1357 <P>
1358 <P>You can select the language that you want the cluster to use. Currently
1359 the languages available are <EM>en</EM> (English) and <EM>nl</EM> (Dutch).
1360 <P>
1361 <H2><A NAME="ss13.81">13.81 set/location (0)</A>
1362 </H2>
1363
1364 <P><CODE><B>set/location &lt;lat and long&gt;</B> Set your latitude and longitude</CODE>
1365 <P>
1366 <P>You can set your latitude and longitude manually or alternatively use the
1367 <EM>set/qra</EM> command which will do the conversion for you.
1368 <P>
1369 <BLOCKQUOTE><CODE>
1370 <PRE>
1371   set/location 54 04 N 2 02 E
1372 </PRE>
1373 </CODE></BLOCKQUOTE>
1374 <P>
1375 <P>
1376 <H2><A NAME="ss13.82">13.82 set/sys_location (9)</A>
1377 </H2>
1378
1379 <P><CODE><B>set/sys_location &lt;lat &amp; long&gt;</B> Set your cluster latitude and longitude</CODE>
1380 <P>
1381 <P>In order to get accurate headings and such like you must tell the system
1382 what your latitude and longitude is. If you have not yet done a SET/QRA
1383 then this command will set your QRA locator for you. For example:-
1384 <P>
1385 <BLOCKQUOTE><CODE>
1386 <PRE>
1387   SET/LOCATION 52 22 N 0 57 E
1388 </PRE>
1389 </CODE></BLOCKQUOTE>
1390 <P>
1391 <H2><A NAME="ss13.83">13.83 set/logininfo (0)</A>
1392 </H2>
1393
1394 <P><CODE><B>set/logininfo</B> Show logins and logouts of nodes and users</CODE>
1395 <P>
1396 <P>Show users and nodes when they log in and out of the local cluster.  You
1397 can stop these messages by using the <EM>unset/logininfo</EM> command.
1398 <P>
1399 <P>
1400 <H2><A NAME="ss13.84">13.84 set/lockout (9)</A>
1401 </H2>
1402
1403 <P><CODE><B>set/lockout &lt;call&gt;</B> Stop a callsign connecting to the cluster</CODE>
1404 <P>
1405 <P>You can show who is locked out with the <EM>show/lockout</EM> command.
1406 To allow the user to connect again, use the <EM>unset/lockout</EM> command.
1407 <P>
1408 <H2><A NAME="ss13.85">13.85 set/name (0)</A>
1409 </H2>
1410
1411 <P><CODE><B>set/name &lt;your_name&gt;</B> Set your name</CODE>
1412 <P>
1413 <P>Tell the cluster what your name is, eg:-
1414 <P>
1415 <BLOCKQUOTE><CODE>
1416 <PRE>
1417   set/name Dirk
1418 </PRE>
1419 </CODE></BLOCKQUOTE>
1420 <P>
1421 <H2><A NAME="ss13.86">13.86 set/node (9)</A>
1422 </H2>
1423
1424 <P><CODE><B>set/node &lt;call&gt; [&lt;call&gt; ...]</B> Make the callsign an AK1A cluster</CODE>
1425 <P>
1426 <P>Tell the system that the call(s) are to be treated as AK1A cluster and
1427 fed PC Protocol rather normal user commands.
1428 <P>From version 1.41 you can also set the following types of cluster
1429 <P>
1430 <BLOCKQUOTE><CODE>
1431 <PRE>
1432   set/spider
1433   set/dxnet
1434   set/clx
1435   set/arcluster
1436 </PRE>
1437 </CODE></BLOCKQUOTE>
1438 <P>To see what your nodes are set to, use the <EM>show/nodes</EM> command.
1439 <P>
1440 <H2><A NAME="ss13.87">13.87 set/obscount (9)</A>
1441 </H2>
1442
1443 <P><CODE><B>set/obscount &lt;count&gt; &lt;node call&gt;</B> Set the 'pump-up' obsolescence counter</CODE>
1444 <P>
1445 <P>From version 1.35 onwards neighbouring nodes are pinged at regular intervals (see
1446 SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up'
1447 counter which is decremented on every outgoing ping and then reset to
1448 the 'obscount' value on every incoming ping. The default value of this
1449 parameter is 2. 
1450 <P>What this means is that a neighbouring node will be pinged twice at 
1451 (default) 300 second intervals and if no reply has been heard just before
1452 what would be the third attempt, that node is disconnected.
1453 <P>If a ping is heard then the obscount is reset to the full value. Using
1454 default values, if a node has not responded to a ping within 15 minutes,
1455 it is disconnected.
1456 <P>
1457 <H2><A NAME="ss13.88">13.88 set/page (0)</A>
1458 </H2>
1459
1460 <P><CODE><B>set/page &lt;n&gt;</B> Set the number of lines per page</CODE>
1461 <P>
1462 <P>Tell the system how many lines you wish on a page when the number of lines
1463 of output from a command is more than this. The default is 20. Setting it
1464 explicitly to 0 will disable paging. 
1465 <P>
1466 <BLOCKQUOTE><CODE>
1467 <PRE>
1468   SET/PAGE 30
1469   SET/PAGE 0
1470 </PRE>
1471 </CODE></BLOCKQUOTE>
1472 <P>The setting is stored in your user profile.
1473 <P>
1474 <P>
1475 <H2><A NAME="ss13.89">13.89 set/password (9)</A>
1476 </H2>
1477
1478 <P><CODE><B>set/password &lt;callsign&gt; &lt;string&gt;</B> Set a users password</CODE>
1479 <P>
1480 <P>The password for a user can only be set by a full sysop. The string
1481 can contain any characters but any spaces are removed (you can type in
1482 spaces - but they won't appear in the password). You can see the
1483 result with STAT/USER.  The password is the usual 30 character baycom
1484 type password.
1485 <P>
1486 <H2><A NAME="ss13.90">13.90 set/pinginterval (9)</A>
1487 </H2>
1488
1489 <P><CODE><B>set/pinginterval &lt;time&gt; &lt;node call&gt;</B> Set the ping time to neighbouring nodes</CODE>
1490 <P>
1491 <P>As from version 1.35 all neighbouring nodes are pinged at regular intervals
1492 in order to determine the rolling quality of the link and, in future, to
1493 affect routing decisions. The default interval is 300 secs or 5 minutes.
1494 <P>You can use this command to set a different interval. Please don't. 
1495 <P>But if you do the value you enter is treated as minutes up 60 and seconds
1496 for numbers greater than that.
1497 <P>This is used also to help determine when a link is down at the far end
1498 (as certain cluster software doesn't always notice), see SET/OBSCOUNT
1499 for more information.
1500 <P>
1501 <H2><A NAME="ss13.91">13.91 set/privilege (9)</A>
1502 </H2>
1503
1504 <P><CODE><B>set/privilege &lt;n&gt; &lt;call&gt; [&lt;call&gt; ...]</B> Set the privilege level on a call</CODE>
1505 <P>
1506 <P>Set the privilege level on a callsign. The privilege levels that pertain
1507 to commands are as default:-
1508 <P>
1509 <BLOCKQUOTE><CODE>
1510 <PRE>
1511   0 - normal user
1512   1 - allow remote nodes normal user RCMDs
1513   5 - various privileged commands (including shutdown, but not disc-
1514       connect), the normal level for another node.
1515   8 - more privileged commands (including disconnect)
1516   9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
1517       LEVEL.
1518 </PRE>
1519 </CODE></BLOCKQUOTE>
1520 <P>If you are a sysop and you come in as a normal user on a remote connection
1521 your privilege will automatically be set to 0.
1522 <P>
1523 <H2><A NAME="ss13.92">13.92 set/spider (5)</A>
1524 </H2>
1525
1526 <P><CODE><B>set/spider &lt;node_call&gt; [&lt;node_call&gt; ...]</B> Make
1527 the node_call a DXSpider type node</CODE>
1528 <P>
1529 <P>Set the node_call as a DXSpider type node
1530 <P>
1531 <H2><A NAME="ss13.93">13.93 set/sys_qra (9)</A>
1532 </H2>
1533
1534 <P><CODE><B>set/sys_qra &lt;locator&gt;</B> Set your cluster QRA locator</CODE>
1535 <P>
1536 <H2><A NAME="ss13.94">13.94 set/qra (0)</A>
1537 </H2>
1538
1539 <P><CODE><B>set/qra &lt;locator&gt;</B> Set your QRA locator</CODE>
1540 <P>
1541 <P>Tell the system what your QRA (or Maidenhead) locator is. If you have not
1542 done a SET/LOCATION then your latitude and longitude will be set roughly
1543 correctly (assuming your locator is correct ;-). For example:-
1544 <P>
1545 <BLOCKQUOTE><CODE>
1546 <PRE>
1547   SET/QRA JO02LQ
1548 </PRE>
1549 </CODE></BLOCKQUOTE>
1550 <P>
1551 <H2><A NAME="ss13.95">13.95 set/qth (0)</A>
1552 </H2>
1553
1554 <P><CODE><B>set/qth &lt;your QTH&gt;</B> Set your QTH</CODE>
1555 <P>
1556 <P>Tell the system where your are.  For example:-
1557 <P>
1558 <BLOCKQUOTE><CODE>
1559 <PRE>
1560   set/qth East Dereham, Norfolk
1561 </PRE>
1562 </CODE></BLOCKQUOTE>
1563 <P>
1564 <H2><A NAME="ss13.96">13.96 set/talk (0)</A>
1565 </H2>
1566
1567 <P><CODE><B>set/talk</B> Allow talk messages to be seen at your console</CODE>
1568 <P>
1569 <P>Allow talk messages to arrive at your console.  You can switch off
1570 talks with the <EM>unset/talk</EM> command.
1571 <P>
1572 <H2><A NAME="ss13.97">13.97 set/wcy (0)</A>
1573 </H2>
1574
1575 <P><CODE><B>set/wcy</B> Allow WCY messages to be seen at your console</CODE>
1576 <P>
1577 <P>Allow WCY information to be seen at your console.  You can switch off
1578 WCY messages with the <EM>unset/wcy</EM> command.
1579 <P>
1580 <H2><A NAME="ss13.98">13.98 set/wwv (0)</A>
1581 </H2>
1582
1583 <P><CODE><B>set/wwv</B> Allow WWV messages to be seen at your console</CODE>
1584 <P>
1585 <P>Allow WWV information to be seen at your console.  You can switch off
1586 WWV messages with the <EM>unset/wwv</EM> command.
1587 <P>
1588 <H2><A NAME="ss13.99">13.99 set/wx (0)</A>
1589 </H2>
1590
1591 <P><CODE><B>set/wx</B> Allow WX messages to be seen at your console</CODE>
1592 <P>
1593 <P>Allow WX information to be seen at your console.  You can switch off
1594 WX messages with the <EM>unset/wx</EM> command.
1595 <P>
1596 <H2><A NAME="ss13.100">13.100 show/baddx (1)</A>
1597 </H2>
1598
1599 <P><CODE><B>show/baddx</B>Show all the bad dx calls in the system</CODE>
1600 <P>
1601 <P>Display all the bad dx callsigns in the system, see SET/BADDX
1602 for more information.
1603 <P>
1604 <H2><A NAME="ss13.101">13.101 show/badnode (6)</A>
1605 </H2>
1606
1607 <P><CODE><B>show/badnode</B> Show all the bad nodes in the system</CODE>
1608 <P>
1609 <P>Display all the bad node callsigns in the system, see SET/BADNODE
1610 for more information.
1611 <P>
1612 <H2><A NAME="ss13.102">13.102 show/badspotter (1)</A>
1613 </H2>
1614
1615 <P><CODE><B>show/badspotter</B> Show all the bad spotters in the system</CODE>
1616 <P>
1617 <P>Display all the bad spotter's callsigns in the system, see SET/BADSPOTTER
1618 for more information.
1619 <P>
1620 <H2><A NAME="ss13.103">13.103 show/date (0)</A>
1621 </H2>
1622
1623 <P><CODE><B>show/date [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show
1624 the local time</CODE>
1625 <P>
1626 <P>This is very nearly the same as SHOW/TIME, the only difference the format
1627 of the date string if no arguments are given.
1628 <P>If no prefixes or callsigns are given then this command returns the local
1629 time and UTC as the computer has it right now. If you give some prefixes
1630 then it will show UTC and UTC + the local offset (not including DST) at
1631 the prefixes or callsigns that you specify.
1632 <P>
1633 <H2><A NAME="ss13.104">13.104 show/debug (9)</A>
1634 </H2>
1635
1636 <P><CODE><B>show/debug</B> Show what levels of debug you are logging</CODE>
1637 <P>
1638 <P>The levels can be set with <EM>set/debug</EM>
1639 <P>
1640 <H2><A NAME="ss13.105">13.105 show/dx (0)</A>
1641 </H2>
1642
1643 <P><CODE><B>show/dx [options]</B> interrogate the spot database</CODE>
1644 <P>
1645 <P>If you just type SHOW/DX you will get the last so many spots
1646 (sysop configurable, but usually 10).
1647 <P>In addition you can add any number of these options in very nearly
1648 any order to the basic SHOW/DX command, they are:-
1649 <P>
1650 <BLOCKQUOTE><CODE>
1651 <PRE>
1652    
1653 on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
1654 on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
1655    
1656 &lt;number&gt;        - the number of spots you want
1657 &lt;from&gt;-&lt;to&gt;     - &lt;from&gt; spot no &lt;to&gt; spot no in 
1658                   the selected list
1659    
1660 &lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
1661 *&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
1662 *&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
1663    
1664 day &lt;number&gt;    - starting &lt;number&gt; days ago
1665 day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
1666    
1667 info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
1668    
1669 by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; 
1670                         is the same).
1671
1672 qsl             - this automatically looks for any qsl info on the call
1673                   held in the spot database.
1674
1675 iota [&lt;iota&gt;]   - If the iota island number is missing it will 
1676                   look for the string iota and anything which looks like 
1677                   an iota island number. If you specify then it will look 
1678                   for that island.
1679
1680 qra [&lt;locator&gt;] - this will look for the specific locator if 
1681                   you specify one or else anything that looks like a locator.
1682 </PRE>
1683 </CODE></BLOCKQUOTE>
1684 <P>e.g. 
1685 <P>
1686 <BLOCKQUOTE><CODE>
1687 <PRE>
1688    
1689    SH/DX 9m0
1690    SH/DX on 20m info iota
1691    SH/DX 9a on vhf day 30
1692    SH/DX rf1p qsl
1693    SH/DX iota 
1694    SH/DX iota eu-064
1695    SH/DX qra jn86
1696 </PRE>
1697 </CODE></BLOCKQUOTE>
1698 <P>
1699 <H2><A NAME="ss13.106">13.106 show/dxcc (0)</A>
1700 </H2>
1701
1702 <P><CODE><B>show/dxcc &lt;prefix&gt;</B> Interrogate the spot database by country</CODE>
1703 <P>
1704 <P>This command takes the &lt;prefix&gt; (which can be a full or partial 
1705 callsign if desired), looks up which internal country number it is
1706 and then displays all the spots as per SH/DX for that country.
1707 <P>The options for SHOW/DX also apply to this command.   
1708 e.g. 
1709 <P>
1710 <BLOCKQUOTE><CODE>
1711 <PRE>
1712    
1713    SH/DXCC G
1714    SH/DXCC W on 20m info iota
1715 </PRE>
1716 </CODE></BLOCKQUOTE>
1717 <P>
1718 <H2><A NAME="ss13.107">13.107 show/files (0)</A>
1719 </H2>
1720
1721 <P><CODE><B>show/files [&lt;filearea&gt; [&lt;string&gt;]]</B> List
1722 the contents of a filearea</CODE>
1723 <P>
1724 <P>SHOW/FILES on its own will show you a list of the various fileareas
1725 available on the system. To see the contents of a particular file
1726 area type:-
1727 <P>
1728 <BLOCKQUOTE><CODE>
1729 <PRE>
1730    SH/FILES &lt;filearea&gt;
1731 </PRE>
1732 </CODE></BLOCKQUOTE>
1733 <P>where &lt;filearea&gt; is the name of the filearea you want to see the 
1734 contents of.
1735 <P>You can also use shell globbing characters like '*' and '?' in a
1736 string to see a selection of files in a filearea eg:-
1737 <P>
1738 <BLOCKQUOTE><CODE>
1739 <PRE>
1740    SH/FILES bulletins arld*
1741 </PRE>
1742 </CODE></BLOCKQUOTE>
1743 <P>See also TYPE - to see the contents of a file.
1744 <P>
1745 <H2><A NAME="ss13.108">13.108 show/filter (0)</A>
1746 </H2>
1747
1748 <P><CODE><B>show/filter</B> Show the filters you have set</CODE>
1749 <P>
1750 <P>Show the contents of all the filters that are set by you. This command 
1751 displays all the filters set - for all the various categories.
1752 <P>
1753 <H2><A NAME="ss13.109">13.109 show/filter (extended for sysops) (5)</A>
1754 </H2>
1755
1756 <P><CODE><B>show/filter &lt;callsign&gt;</B> Show the filters set by &lt;callsign&gt;</CODE>
1757 <P>
1758 <P>A sysop can look at any filters that have been set.
1759 <P>
1760 <H2><A NAME="ss13.110">13.110 show/hops (8)</A>
1761 </H2>
1762
1763 <P><CODE><B>show/hops &lt;node_call&gt; [ann|spots|wcy|wwv|]</B> Show the hop counts for a node</CODE>
1764 <P>
1765 <P>This command shows the hop counts set up for a node. You can specify
1766 which category you want to see. If you leave the category out then 
1767 all the categories will be listed.
1768 <P>
1769 <H2><A NAME="ss13.111">13.111 show/isolate (1)</A>
1770 </H2>
1771
1772 <P><CODE><B>show/isolate</B> Show a list of isolated nodes</CODE>
1773 <P>
1774 <P>Show which nodes are currently set to be isolated.
1775 <P>
1776 <H2><A NAME="ss13.112">13.112 show/lockout (9)</A>
1777 </H2>
1778
1779 <P><CODE><B>show/lockout</B> Show a list of excluded callsigns</CODE>
1780 <P>
1781 <P>Show a list of callsigns that have been excluded (locked out) of the
1782 cluster locally with the <EM>set/lockout</EM> command
1783 <P>
1784 <H2><A NAME="ss13.113">13.113 show/log (8)</A>
1785 </H2>
1786
1787 <P><CODE><B>show/log [&lt;callsign&gt;]</B> Show excerpts from the system log</CODE>
1788 <P>
1789 <P>This command outputs a short section of the system log.  On its own
1790 it will output a general logfile.  With the optional callsign it will
1791 show output from the log associated with that callsign.
1792 <P>
1793 <H2><A NAME="ss13.114">13.114 show/moon (0)</A>
1794 </H2>
1795
1796 <P><CODE><B>show/moon [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show moon
1797 rise and set times</CODE>
1798 <P>
1799 <P>Show the Moon rise and set times for a (list of) prefixes or callsigns, 
1800 together with the azimuth and elevation of the sun currently at those
1801 locations.
1802 <P>If you don't specify any prefixes or callsigns, it will show the times for
1803 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
1804 together with the current azimuth and elevation.
1805 <P>In addition, it will show the gain or loss dB relative to the nominal 
1806 distance of 385,000Km due to the ellipsoidal nature of the orbit.
1807 <P>If all else fails it will show the Moonrise and set times for the node
1808 that you are connected to. 
1809 <P>For example:-
1810 <P>
1811 <BLOCKQUOTE><CODE>
1812 <PRE>
1813   SH/MOON
1814   SH/MOON G1TLH W5UN
1815 </PRE>
1816 </CODE></BLOCKQUOTE>
1817 <P>
1818 <H2><A NAME="ss13.115">13.115 show/muf (0)</A>
1819 </H2>
1820
1821 <P><CODE><B>show/muf &lt;prefix&gt; [&lt;hours&gt;][long]</B> Show
1822 the likely propagation to &lt;prefix&gt;</CODE>
1823 <P>
1824 <P>This command allow you to estimate the likelihood of you contacting
1825 a station with the prefix you have specified. The output assumes a modest
1826 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
1827 <P>The result predicts the most likely operating frequencies and signal
1828 levels for high frequency (shortwave) radio propagation paths on
1829 specified days of the year and hours of the day. It is most useful for
1830 paths between 250 km and 6000 km, but can be used with reduced accuracy
1831 for paths shorter or longer than this.
1832 <P>The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
1833 used to predict the MUF given the predicted flux, day of the year,
1834 hour of the day and geographic coordinates of the transmitter and
1835 receiver. This routine is reasonably accurate for the purposes here,
1836 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
1837 than the programs used by major shortwave broadcasting organizations,
1838 such as the Voice of America.
1839 <P>The command will display some header information detailing its
1840 assumptions, together with the locations, latitude and longitudes and
1841 bearings. It will then show UTC (UT), local time at the other end
1842 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
1843 (Zen) and the likely signal strengths. Then for each frequency for which
1844 the system thinks there is a likelihood of a circuit it prints a value.
1845 <P>The value is currently a likely S meter reading based on the conventional
1846 6dB / S point scale. If the value has a '+' appended it means that it is
1847 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
1848 there is likely to be much fading and by an 's' that the signal is likely
1849 to be noisy.  
1850 <P>By default SHOW/MUF will show the next two hours worth of data. You
1851 can specify anything up to 24 hours worth of data by appending the no of
1852 hours required after the prefix. For example:-
1853 <P>
1854 <BLOCKQUOTE><CODE>
1855 <PRE>
1856   SH/MUF W
1857 </PRE>
1858 </CODE></BLOCKQUOTE>
1859 <P>produces:
1860 <P>
1861 <BLOCKQUOTE><CODE>
1862 <PRE>
1863   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
1864   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
1865   Location                       Lat / Long           Azim
1866   East Dereham, Norfolk          52 41 N 0 57 E         47
1867   United-States-W                43 0 N 87 54 W        299
1868   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
1869   18 23 11.5 -35  mS0+ mS2   S3
1870   19  0 11.2 -41  mS0+ mS2   S3
1871 </PRE>
1872 </CODE></BLOCKQUOTE>
1873 <P>indicating that you will have weak, fading circuits on top band and 
1874 80m but usable signals on 40m (about S3).
1875 <P>inputing:-
1876 <P>
1877 <BLOCKQUOTE><CODE>
1878 <PRE>
1879   SH/MUF W 24
1880 </PRE>
1881 </CODE></BLOCKQUOTE>
1882 <P>will get you the above display, but with the next 24 hours worth of
1883 propagation data.
1884 <P>
1885 <BLOCKQUOTE><CODE>
1886 <PRE>
1887   SH/MUF W L 24
1888   SH/MUF W 24 Long
1889 </PRE>
1890 </CODE></BLOCKQUOTE>
1891 <P>Gives you an estimate of the long path propagation characterics. It
1892 should be noted that the figures will probably not be very useful, nor
1893 terrible accurate, but it is included for completeness.
1894 <P>
1895 <H2><A NAME="ss13.116">13.116 show/node (1)</A>
1896 </H2>
1897
1898 <P><CODE><B>show/node [&lt;node_call&gt; ...]</B> Show the type and version
1899 number of nodes</CODE>
1900 <P>
1901 <P>Show the type and version (if connected) of the nodes specified on the
1902 command line. If no callsigns are specified then a sorted list of all
1903 the non-user callsigns known to the system will be displayed.
1904 <P>
1905 <H2><A NAME="ss13.117">13.117 show/prefix (0)</A>
1906 </H2>
1907
1908 <P><CODE><B>show/prefix &lt;callsign&gt;</B> Interrogate the prefix database</CODE>
1909 <P>
1910 <P>This command takes the &lt;callsign&gt; (which can be a full or partial 
1911 callsign or a prefix), looks up which internal country number 
1912 it is and then displays all the relevant prefixes for that country
1913 together with the internal country no, the CQ and ITU regions. 
1914 <P>See also SHOW/DXCC
1915 <P>
1916 <P>
1917 <H2><A NAME="ss13.118">13.118 show/program (5)</A>
1918 </H2>
1919
1920 <P><CODE><B>show/program</B> Show the locations of all the included program modules</CODE>
1921 <P>
1922 <P>Show the name and location where every program module was load from. This
1923 is useful for checking where you think you have loaded a .pm file from.
1924 <P>
1925 <H2><A NAME="ss13.119">13.119 show/qra (0)</A>
1926 </H2>
1927
1928 <P><CODE><B>show/qra &lt;locator&gt; [&lt;locator&gt;]</B> Show the distance
1929 between locators<BR>
1930 <B>show/qra &lt;lat&gt; &lt;long&gt;</B> Convert latitude and longitude to a locator</CODE>
1931 <P>
1932 <P>This is a multipurpose command that allows you either to calculate the
1933 distance and bearing between two locators or (if only one locator is
1934 given on the command line) the distance and beraing from your station
1935 to the locator. For example:-
1936 <P>
1937 <BLOCKQUOTE><CODE>
1938 <PRE>
1939 SH/QRA IO92QL 
1940 SH/QRA JN06 IN73
1941 </PRE>
1942 </CODE></BLOCKQUOTE>
1943 <P>The first example will show the distance and bearing to the locator from
1944 yourself, the second example will calculate the distance and bearing from
1945 the first locator to the second. You can use 4 or 6 character locators.
1946 <P>It is also possible to convert a latitude and longitude to a locator by 
1947 using this command with a latitude and longitude as an argument, for
1948 example:-
1949 <P>
1950 <BLOCKQUOTE><CODE>
1951 <PRE>
1952 SH/QRA 52 41 N 0 58 E
1953 </PRE>
1954 </CODE></BLOCKQUOTE>
1955 <P>
1956 <H2><A NAME="ss13.120">13.120 show/qrz (0)</A>
1957 </H2>
1958
1959 <P><CODE><B>show/qrz &lt;callsign&gt;</B> Show any callbook details on a callsign</CODE>
1960 <P>
1961 <P>This command queries the QRZ callbook server on the internet
1962 and returns any information available for that callsign. This service
1963 is provided for users of this software by http://www.qrz.com 
1964 <P>
1965 <H2><A NAME="ss13.121">13.121 show/route (0)</A>
1966 </H2>
1967
1968 <P><CODE><B>show/route &lt;callsign&gt;</B> Show the route to &lt;callsign&gt;</CODE>
1969 <P>
1970 <P>This command allows you to see to which node the callsigns specified are
1971 connected. It is a sort of inverse sh/config.
1972 <P>
1973 <BLOCKQUOTE><CODE>
1974 <PRE>
1975   sh/route n2tly
1976 </PRE>
1977 </CODE></BLOCKQUOTE>
1978 <P>
1979 <H2><A NAME="ss13.122">13.122 show/satellite (0)</A>
1980 </H2>
1981
1982 <P><CODE><B>show/satellite &lt;name&gt; [&lt;hours&gt; &lt;interval&gt;]</B>
1983 Show satellite tracking data</CODE>
1984 <P>
1985 <P>Show the tracking data from your location to the satellite of your choice
1986 from now on for the next few hours.
1987 <P>If you use this command without a satellite name it will display a list
1988 of all the satellites known currently to the system. 
1989 <P>If you give a name then you can obtain tracking data of all the passes
1990 that start and finish 5 degrees below the horizon. As default it will
1991 give information for the next three hours for every five minute period.
1992 <P>You can alter the number of hours and the step size, within certain 
1993 limits. 
1994 <P>Each pass in a period is separated with a row of '-----' characters
1995 <P>So for example:-
1996 <P>
1997 <BLOCKQUOTE><CODE>
1998 <PRE>
1999 SH/SAT AO-10 
2000 SH/SAT FENGYUN1 12 2
2001 </PRE>
2002 </CODE></BLOCKQUOTE>
2003 <P>
2004 <H2><A NAME="ss13.123">13.123 show/sun (0)</A>
2005 </H2>
2006
2007 <P><CODE><B>show/sun [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show
2008 sun rise and set times</CODE>
2009 <P>
2010 <P>Show the sun rise and set times for a (list of) prefixes or callsigns, 
2011 together with the azimuth and elevation of the sun currently at those
2012 locations.
2013 <P>If you don't specify any prefixes or callsigns, it will show the times for
2014 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2015 together with the current azimuth and elevation.
2016 <P>If all else fails it will show the sunrise and set times for the node
2017 that you are connected to. 
2018 <P>For example:-
2019 <P>
2020 <BLOCKQUOTE><CODE>
2021 <PRE>
2022   SH/SUN
2023   SH/SUN G1TLH K9CW ZS
2024 </PRE>
2025 </CODE></BLOCKQUOTE>
2026 <P>
2027 <H2><A NAME="ss13.124">13.124 show/time (0)</A>
2028 </H2>
2029
2030 <P><CODE><B>show/time [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show
2031 the local time</CODE>
2032 <P>
2033 <P>If no prefixes or callsigns are given then this command returns the local
2034 time and UTC as the computer has it right now. If you give some prefixes
2035 then it will show UTC and UTC + the local offset (not including DST) at
2036 the prefixes or callsigns that you specify.
2037 <P>
2038 <H2><A NAME="ss13.125">13.125 show/wcy (0)</A>
2039 </H2>
2040
2041 <P><CODE><B>show/wcy</B> Show the last 10 WCY broadcasts<BR>
2042 <B>show/wcy &lt;n&gt;</B> Show the last &lt;n&gt; WCY broadcasts</CODE>
2043 <P>
2044 <P>Display the most recent WCY information that has been received by the system
2045 <P>
2046 <H2><A NAME="ss13.126">13.126 show/wwv (0)</A>
2047 </H2>
2048
2049 <P><CODE><B>show/wwv</B> Show the last 10 WWV broadcasts<BR>
2050 <B>show/wwv &lt;n&gt;</B> Show the last &lt;n&gt; WWV broadcasts</CODE>
2051 <P>
2052 <P>Display the most recent WWV information that has been received by the system
2053 <P>
2054 <P>
2055 <H2><A NAME="ss13.127">13.127 shutdown (5)</A>
2056 </H2>
2057
2058 <P><CODE><B>shutdown</B> Shutdown the cluster</CODE>
2059 <P>
2060 <P>Shutdown the cluster and disconnect all the users.  If you have Spider
2061 set to respawn in /etc/inittab it will of course restart.
2062 <P>
2063 <H2><A NAME="ss13.128">13.128 spoof (9)</A>
2064 </H2>
2065
2066 <P><CODE><B>spoof &lt;callsign&gt; &lt;command&gt;</B> Run commands as another user</CODE>
2067 <P>
2068 <P>This is a very simple yet powerful command for the sysop.  It allows you to
2069 issue commands as if you were a different user.  This is very useful for the
2070 kind of things that users seem to always get wrong.. like home_node for
2071 example.
2072 <P>
2073 <H2><A NAME="ss13.129">13.129 stat/db (5)</A>
2074 </H2>
2075
2076 <P><CODE><B>stat/db &lt;dbname&gt;</B> Show the status of a database</CODE>
2077 <P>
2078 <P>Show the internal status of a database descriptor.
2079 <P>Depending on your privilege level you will see more or less information. 
2080 This command is unlikely to be of much use to anyone other than a sysop.
2081 <P>
2082 <H2><A NAME="ss13.130">13.130 stat/channel (5)</A>
2083 </H2>
2084
2085 <P><CODE><B>stat/channel &lt;callsign&gt;</B> Show the status of a channel on the cluster</CODE>
2086 <P>
2087 <P>Show the internal status of the channel object either for the channel that 
2088 you are on or else for the callsign that you asked for.
2089 <P>Only the fields that are defined (in perl term) will be displayed.
2090 <P>
2091 <H2><A NAME="ss13.131">13.131 stat/msg (5)</A>
2092 </H2>
2093
2094 <P><CODE><B>stat/msg &lt;msgno&gt;</B> Show the status of a message</CODE>
2095 <P>
2096 <P>This command shows the internal status of a message and includes information
2097 such as to whom it has been forwarded, its size, origin etc etc.
2098 <P>
2099 <H2><A NAME="ss13.132">13.132 stat/user (5)</A>
2100 </H2>
2101
2102 <P><CODE><B>stat/user &lt;callsign&gt;</B> Show the full status of a user</CODE>
2103 <P>
2104 <P>Shows the full contents of a user record including all the secret flags
2105 and stuff.
2106 <P>Only the fields that are defined (in perl term) will be displayed.
2107 <P>
2108 <H2><A NAME="ss13.133">13.133 sysop (0)</A>
2109 </H2>
2110
2111 <P><CODE><B>sysop</B> Regain your privileges if you login remotely</CODE>
2112 <P>
2113 <P>The system automatically reduces your privilege level to that of a
2114 normal user if you login in remotely. This command allows you to
2115 regain your normal privilege level. It uses the normal system: five
2116 numbers are returned that are indexes into the character array that is
2117 your assigned password (see SET/PASSWORD). The indexes start from
2118 zero.
2119 <P>You are expected to return a string which contains the characters
2120 required in the correct order. You may intersperse those characters
2121 with others to obscure your reply for any watchers. For example (and
2122 these values are for explanation :-):
2123 <P>
2124 <BLOCKQUOTE><CODE>
2125 <PRE>
2126   password = 012345678901234567890123456789
2127   > sysop
2128   22 10 15 17 3
2129 </PRE>
2130 </CODE></BLOCKQUOTE>
2131 <P>you type:-
2132 <P>
2133 <BLOCKQUOTE><CODE>
2134 <PRE>
2135  aa2bbbb0ccc5ddd7xxx3n
2136  or 2 0 5 7 3
2137  or 20573
2138 </PRE>
2139 </CODE></BLOCKQUOTE>
2140 <P>They will all match. If there is no password you will still be offered
2141 numbers but nothing will happen when you input a string. Any match is
2142 case sensitive.
2143 <P>
2144 <H2><A NAME="ss13.134">13.134 talk (0)</A>
2145 </H2>
2146
2147 <P><CODE><B>talk &lt;callsign&gt;</B> Enter talk mode with &lt;callsign&gt;<BR>
2148 <B>talk &lt;callsign&gt; &lt;text&gt;</B> Send a text message to &lt;callsign&gt;<BR>
2149 <B>talk &lt;callsign&gt; &gt; &lt;node_call&gt; [&lt;text&gt;]</B>
2150 Send a text message to &lt;callsign&gt; via &lt;node_call&gt;</CODE>
2151 <P>
2152 <P>Send a short message to any other station that is visible on the cluster
2153 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
2154 command, they don't have to be connected locally.
2155 <P>The second form of TALK is used when other cluster nodes are connected
2156 with restricted information. This usually means that they don't send 
2157 the user information usually associated with logging on and off the cluster.
2158 <P>If you know that G3JNB is likely to be present on GB7TLH, but you can only
2159 see GB7TLH in the SH/C list but with no users, then you would use the
2160 second form of the talk message.
2161 <P>If you want to have a ragchew with someone you can leave the text message
2162 out and the system will go into 'Talk' mode. What this means is that a
2163 short message is sent to the recipient telling them that you are in a 'Talking' 
2164 frame of mind and then you just type - everything you send will go to the 
2165 station that you asked for. 
2166 <P>All the usual announcements, spots and so on will still come out on your
2167 terminal.
2168 <P>If you want to do something (such as send a spot) you precede the normal 
2169 command with a '/' character, eg:-
2170 <P>
2171 <BLOCKQUOTE><CODE>
2172 <PRE>
2173    /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
2174    /HELP talk
2175 </PRE>
2176 </CODE></BLOCKQUOTE>
2177 <P>To leave talk mode type:
2178 <P>
2179 <BLOCKQUOTE><CODE>
2180 <PRE>
2181    /EX
2182 </PRE>
2183 </CODE></BLOCKQUOTE>
2184 <P>
2185 <H2><A NAME="ss13.135">13.135 type (0)</A>
2186 </H2>
2187
2188 <P><CODE><B>type &lt;filearea&gt;/&lt;name&gt;</B> Look at a file in one of the fileareas</CODE>
2189 <P>
2190 <P>Type out the contents of a file in a filearea. So, for example, in 
2191 filearea 'bulletins' you want to look at file 'arld051' you would 
2192 enter:-
2193 <P>
2194 <BLOCKQUOTE><CODE>
2195 <PRE>
2196    TYPE bulletins/arld051
2197 </PRE>
2198 </CODE></BLOCKQUOTE>
2199 <P>See also SHOW/FILES to see what fileareas are available and a 
2200 list of content.
2201 <P>
2202 <H2><A NAME="ss13.136">13.136 who (0)</A>
2203 </H2>
2204
2205 <P><CODE><B>who</B> Show who is physically connected locally</CODE>
2206 <P>
2207 <P>This is a quick listing that shows which callsigns are connected and
2208 what sort of connection they have
2209 <P>
2210 <H2><A NAME="ss13.137">13.137 wx (0)</A>
2211 </H2>
2212
2213 <P><CODE><B>wx &lt;text&gt;</B> Send a weather message to local users<BR>
2214 <B>wx full &lt;text&gt; </B> Send a weather message to all cluster users</CODE>
2215 <P>
2216 <P>Weather messages can sometimes be useful if you are experiencing an extreme
2217 that may indicate enhanced conditions
2218 <P>
2219 <H2><A NAME="ss13.138">13.138 wx (enhanced for sysops) (5)</A>
2220 </H2>
2221
2222 <P><CODE><B>wx sysop &lt;text&gt;</B> Send a weather message to other clusters only</CODE>
2223 <P>
2224 <P>Send a weather message only to other cluster nodes and not to general users.
2225 <P>
2226 <P>
2227 <P>
2228 <HR>
2229 Next
2230 <A HREF="adminmanual-12.html">Previous</A>
2231 <A HREF="adminmanual.html#toc13">Contents</A>
2232 </BODY>
2233 </HTML>