Update manuals for CVS and new commands
[spider.git] / html / usermanual_en-12.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
2 <HTML>
3 <HEAD>
4  <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.20">
5  <TITLE>The DXSpider User Manual v1.51: The DXSpider Command Reference</TITLE>
6  <LINK HREF="usermanual_en-11.html" REL=previous>
7  <LINK HREF="usermanual_en.html#toc12" REL=contents>
8 <link rel=stylesheet href="style.css" type="text/css" title="default stylesheet">
9 </HEAD>
10 <BODY>
11 Next
12 <A HREF="usermanual_en-11.html">Previous</A>
13 <A HREF="usermanual_en.html#toc12">Contents</A>
14 <HR>
15 <H2><A NAME="s12">12.</A> <A HREF="usermanual_en.html#toc12">The DXSpider Command Reference</A></H2>
16
17 <H2><A NAME="ss12.1">12.1</A> <A HREF="usermanual_en.html#toc12.1">accept</A>
18 </H2>
19
20 <P><CODE><B>accept</B> Set a filter to accept something</CODE></P>
21
22 <P>Create a filter to accept something</P>
23 <P>There are 2 types of filter, accept and reject.  See HELP FILTERING for more
24 info.</P>
25 <H2><A NAME="ss12.2">12.2</A> <A HREF="usermanual_en.html#toc12.2">accept/announce [0-9] &lt;pattern&gt;</A>
26 </H2>
27
28 <P><CODE><B>accept/announce [0-9] &lt;pattern&gt;</B> Set an 'accept' filter line for announce</CODE></P>
29
30 <P>Create an 'accept this announce' line for a filter. </P>
31 <P>An accept filter line means that if the announce matches this filter it is
32 passed onto the user. See HELP FILTERING for more info. Please read this
33 to understand how filters work - it will save a lot of grief later on.</P>
34 <P>You can use any of the following things in this line:-</P>
35 <P>
36 <BLOCKQUOTE><CODE>
37 <PRE>
38   info &lt;string&gt;            eg: iota or qsl
39   by &lt;prefixes&gt;            eg: G,M,2         
40   origin &lt;prefixes&gt;
41   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
42   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
43   origin_zone &lt;prefixes or numbers&gt;
44   origin_state &lt;states&gt;                eg: VA,NH,RI,NH
45   by_dxcc &lt;prefixes or numbers&gt;
46   by_itu &lt;prefixes or numbers&gt;
47   by_zone &lt;prefixes or numbers&gt;
48   by_state &lt;states&gt;
49   channel &lt;prefixes&gt;
50   wx 1                     filter WX announces
51   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
52 </PRE>
53 </CODE></BLOCKQUOTE>
54 </P>
55 <P>some examples:-</P>
56 <P>
57 <BLOCKQUOTE><CODE>
58 <PRE>
59   acc/ann dest 6MUK
60   acc/ann 2 by_zone 14,15,16
61   (this could be all on one line: acc/ann dest 6MUK or by_zone 14,15,16)
62 </PRE>
63 </CODE></BLOCKQUOTE>
64
65 or
66 <BLOCKQUOTE><CODE>
67 <PRE>
68   acc/ann by G,M,2 
69 </PRE>
70 </CODE></BLOCKQUOTE>
71 </P>
72 <P>for american states</P>
73 <P>
74 <BLOCKQUOTE><CODE>
75 <PRE>
76   acc/ann by_state va,nh,ri,nh
77 </PRE>
78 </CODE></BLOCKQUOTE>
79 </P>
80 <P>You can use the tag 'all' to accept everything eg:</P>
81 <P>
82 <BLOCKQUOTE><CODE>
83 <PRE>
84   acc/ann all
85 </PRE>
86 </CODE></BLOCKQUOTE>
87 </P>
88 <P>but this probably for advanced users...</P>
89 <H2><A NAME="ss12.3">12.3</A> <A HREF="usermanual_en.html#toc12.3">accept/spots [0-9] &lt;pattern&gt;</A>
90 </H2>
91
92 <P><CODE><B>accept/spots [0-9] &lt;pattern&gt;</B> Set an 'accept' filter line for spots</CODE></P>
93
94 <P>Create an 'accept this spot' line for a filter. </P>
95 <P>An accept filter line means that if the spot matches this filter it is
96 passed onto the user. See HELP FILTERING for more info. Please read this
97 to understand how filters work - it will save a lot of grief later on.</P>
98 <P>You can use any of the following things in this line:-</P>
99 <P>
100 <BLOCKQUOTE><CODE>
101 <PRE>
102   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
103   on &lt;range&gt;             same as 'freq'
104   call &lt;prefixes&gt;        eg: G,PA,HB9
105   info &lt;string&gt;          eg: iota or qsl
106   by &lt;prefixes&gt;            
107   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
108   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
109   call_zone &lt;prefixes or numbers&gt;
110   call_state &lt;states&gt;                eg: VA,NH,RI,ME
111   by_dxcc &lt;prefixes or numbers&gt;
112   by_itu &lt;prefixes or numbers&gt;
113   by_zone &lt;prefixes or numbers&gt;
114   by_state &lt;states&gt;                eg: VA,NH,RI,ME
115   origin &lt;prefixes&gt;
116   channel &lt;prefixes&gt;
117 </PRE>
118 </CODE></BLOCKQUOTE>
119 </P>
120 <P>'call' means the callsign that has spotted 'by' whoever.</P>
121 <P>For frequencies, you can use any of the band names defined in
122 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
123 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
124 this is more efficient than saying simply: freq HF (but don't get
125 too hung up about that)</P>
126 <P>some examples:-</P>
127 <P>
128 <BLOCKQUOTE><CODE>
129 <PRE>
130   acc/spot 1 on hf/cw
131   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
132 </PRE>
133 </CODE></BLOCKQUOTE>
134 </P>
135 <P>You can use the tag 'all' to accept everything, eg:</P>
136 <P>
137 <BLOCKQUOTE><CODE>
138 <PRE>
139   acc/spot 3 all
140 </PRE>
141 </CODE></BLOCKQUOTE>
142 </P>
143 <P>for US states </P>
144 <P>
145 <BLOCKQUOTE><CODE>
146 <PRE>
147   acc/spots by_state VA,NH,RI,MA,ME
148 </PRE>
149 </CODE></BLOCKQUOTE>
150 </P>
151 <P>but this probably for advanced users...</P>
152 <H2><A NAME="ss12.4">12.4</A> <A HREF="usermanual_en.html#toc12.4">accept/wcy [0-9] &lt;pattern&gt;</A>
153 </H2>
154
155 <P><CODE><B>accept/wcy [0-9] &lt;pattern&gt;</B> set an 'accept' WCY filter</CODE></P>
156
157 <P>It is unlikely that you will want to do this, but if you do then you can
158 filter on the following fields:-</P>
159 <P>
160 <BLOCKQUOTE><CODE>
161 <PRE>
162   by &lt;prefixes&gt;            eg: G,M,2         
163   origin &lt;prefixes&gt;
164   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
165   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
166   origin_zone &lt;prefixes or numbers&gt;
167   by_dxcc &lt;prefixes or numbers&gt;
168   by_itu &lt;prefixes or numbers&gt;
169   by_zone &lt;prefixes or numbers&gt;
170   channel &lt;prefixes&gt;
171 </PRE>
172 </CODE></BLOCKQUOTE>
173 </P>
174 <P>There are no examples because WCY Broadcasts only come from one place and
175 you either want them or not (see UNSET/WCY if you don't want them).</P>
176 <P>This command is really provided for future use.</P>
177 <P>See HELP FILTER for information.</P>
178 <H2><A NAME="ss12.5">12.5</A> <A HREF="usermanual_en.html#toc12.5">accept/wwv [0-9] &lt;pattern&gt;</A>
179 </H2>
180
181 <P><CODE><B>accept/wwv [0-9] &lt;pattern&gt;</B> set an 'accept' WWV filter</CODE></P>
182
183 <P>It is unlikely that you will want to do this, but if you do then you can
184 filter on the following fields:-</P>
185 <P>
186 <BLOCKQUOTE><CODE>
187 <PRE>
188   by &lt;prefixes&gt;            eg: G,M,2         
189   origin &lt;prefixes&gt;
190   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
191   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
192   origin_zone &lt;prefixes or numbers&gt;
193   by_dxcc &lt;prefixes or numbers&gt;
194   by_itu &lt;prefixes or numbers&gt;
195   by_zone &lt;prefixes or numbers&gt;
196   channel &lt;prefixes&gt;
197 </PRE>
198 </CODE></BLOCKQUOTE>
199 </P>
200 <P>for example </P>
201 <P>
202 <BLOCKQUOTE><CODE>
203 <PRE>
204   accept/wwv by_zone 4
205 </PRE>
206 </CODE></BLOCKQUOTE>
207 </P>
208 <P>is probably the only useful thing to do (which will only show WWV broadcasts
209 by stations in the US).</P>
210 <P>See HELP FILTER for information.</P>
211 <H2><A NAME="ss12.6">12.6</A> <A HREF="usermanual_en.html#toc12.6">announce &lt;text&gt;</A>
212 </H2>
213
214 <P><CODE><B>announce &lt;text&gt;</B> Send an announcement to LOCAL users only</CODE></P>
215
216 <P>&lt;text&gt; is the text of the announcement you wish to broadcast </P>
217 <H2><A NAME="ss12.7">12.7</A> <A HREF="usermanual_en.html#toc12.7">announce full &lt;text&gt;</A>
218 </H2>
219
220 <P><CODE><B>announce full &lt;text&gt;</B> Send an announcement cluster wide</CODE></P>
221
222 <P>This will send your announcement cluster wide</P>
223 <H2><A NAME="ss12.8">12.8</A> <A HREF="usermanual_en.html#toc12.8">apropos &lt;string&gt;</A>
224 </H2>
225
226 <P><CODE><B>apropos &lt;string&gt;</B> Search help database for &lt;string&gt;</CODE></P>
227
228 <P>Search the help database for &lt;string&gt; (it isn't case sensitive), and print
229 the names of all the commands that may be relevant.</P>
230 <H2><A NAME="ss12.9">12.9</A> <A HREF="usermanual_en.html#toc12.9">blank [&lt;string&gt;] [&lt;nn&gt;]</A>
231 </H2>
232
233 <P><CODE><B>blank [&lt;string&gt;] [&lt;nn&gt;]</B> Print nn (default 1) blank lines (or strings)</CODE></P>
234
235 <P>In its basic form this command prints one or more blank lines. However if
236 you pass it a string it will replicate the string for the width of the 
237 screen (default 80) and then print that one or more times, so:</P>
238 <P>
239 <BLOCKQUOTE><CODE>
240 <PRE>
241   blank 2
242 </PRE>
243 </CODE></BLOCKQUOTE>
244 </P>
245 <P>prints two blank lines</P>
246 <P>
247 <BLOCKQUOTE><CODE>
248 <PRE>
249   blank - 
250 </PRE>
251 </CODE></BLOCKQUOTE>
252 </P>
253 <P>prints a row of - characters once.</P>
254 <P>
255 <BLOCKQUOTE><CODE>
256 <PRE>
257   blank abc
258 </PRE>
259 </CODE></BLOCKQUOTE>
260 </P>
261 <P>prints 'abcabcabcabcabcabc....'</P>
262 <P>This is really only of any use in a script file and you can print a maximum
263 of 9 lines.</P>
264 <H2><A NAME="ss12.10">12.10</A> <A HREF="usermanual_en.html#toc12.10">bye</A>
265 </H2>
266
267 <P><CODE><B>bye</B> Exit from the cluster</CODE></P>
268
269 <P>This will disconnect you from the cluster</P>
270 <H2><A NAME="ss12.11">12.11</A> <A HREF="usermanual_en.html#toc12.11">chat &lt;group&gt; &lt;text&gt;</A>
271 </H2>
272
273 <P><CODE><B>chat &lt;group&gt; &lt;text&gt;</B> Chat or Conference to a group</CODE></P>
274
275 <P>It is now possible to JOIN a group and have network wide conferencing to that
276 group. DXSpider does not (and probably will not) implement the AK1A 
277 conference mode as this seems very limiting, is hardly used and doesn't seem
278 to work too well anyway.</P>
279 <P>This system uses the existing ANN system and is compatible with both other
280 DXSpider nodes and AK1A clusters (they use ANN/&lt;group&gt;). </P>
281 <P>You can be a member of as many "groups" as you want. To join a group type:-</P>
282 <P>
283 <BLOCKQUOTE><CODE>
284 <PRE>
285   JOIN FOC    (where FOC is the group name)
286 </PRE>
287 </CODE></BLOCKQUOTE>
288 </P>
289 <P>To leave a group type:-</P>
290 <P>
291 <BLOCKQUOTE><CODE>
292 <PRE>
293   LEAVE FOC
294 </PRE>
295 </CODE></BLOCKQUOTE>
296 </P>
297 <P>You can see which groups you are in by typing:-</P>
298 <P>
299 <BLOCKQUOTE><CODE>
300 <PRE>
301   STAT/USER
302 </PRE>
303 </CODE></BLOCKQUOTE>
304 </P>
305 <P>and you can see whether your mate is in the group, if he connects to the
306 same node as you, by typing:-</P>
307 <P>
308 <BLOCKQUOTE><CODE>
309 <PRE>
310   STAT/USER g1tlh
311 </PRE>
312 </CODE></BLOCKQUOTE>
313 </P>
314 <P>To send a message to a group type:-</P>
315 <P>
316 <BLOCKQUOTE><CODE>
317 <PRE>
318   CHAT FOC hello everyone
319 </PRE>
320 </CODE></BLOCKQUOTE>
321 </P>
322 <P>or</P>
323 <P>
324 <BLOCKQUOTE><CODE>
325 <PRE>
326   CH #9000 hello I am back
327 </PRE>
328 </CODE></BLOCKQUOTE>
329 </P>
330 <P>See also JOIN, LEAVE, SHOW/CHAT</P>
331 <H2><A NAME="ss12.12">12.12</A> <A HREF="usermanual_en.html#toc12.12">clear/announce [1|all]</A>
332 </H2>
333
334 <P><CODE><B>clear/announce [1|all]</B> Clear a announce filter line</CODE></P>
335
336 <P>This command allows you to clear (remove) a line in a annouce filter or to 
337 remove the whole filter.</P>
338 <P>see CLEAR/SPOTS for a more detailed explanation.</P>
339 <H2><A NAME="ss12.13">12.13</A> <A HREF="usermanual_en.html#toc12.13">clear/route [1|all]</A>
340 </H2>
341
342 <P><CODE><B>clear/route [1|all]</B> Clear a route filter line</CODE></P>
343
344 <P>This command allows you to clear (remove) a line in a route filter or to 
345 remove the whole filter.</P>
346 <P>see CLEAR/SPOTS for a more detailed explanation.</P>
347 <H2><A NAME="ss12.14">12.14</A> <A HREF="usermanual_en.html#toc12.14">clear/spots [0-9|all]</A>
348 </H2>
349
350 <P><CODE><B>clear/spots [0-9|all]</B> Clear a spot filter line</CODE></P>
351
352 <P>This command allows you to clear (remove) a line in a spot filter or to 
353 remove the whole filter.</P>
354 <P>If you have a filter:-</P>
355 <P>
356 <BLOCKQUOTE><CODE>
357 <PRE>
358   acc/spot 1 on hf/cw
359   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
360 </PRE>
361 </CODE></BLOCKQUOTE>
362 </P>
363 <P>and you say:-</P>
364 <P>
365 <BLOCKQUOTE><CODE>
366 <PRE>
367   clear/spot 1
368 </PRE>
369 </CODE></BLOCKQUOTE>
370 </P>
371 <P>you will be left with:-</P>
372 <P>
373 <BLOCKQUOTE><CODE>
374 <PRE>
375   acc/spot 2 on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
376 </PRE>
377 </CODE></BLOCKQUOTE>
378 </P>
379 <P>If you do:</P>
380 <P>
381 <BLOCKQUOTE><CODE>
382 <PRE>
383   clear/spot all
384 </PRE>
385 </CODE></BLOCKQUOTE>
386 </P>
387 <P>the filter will be completely removed.</P>
388 <H2><A NAME="ss12.15">12.15</A> <A HREF="usermanual_en.html#toc12.15">clear/wcy [1|all]</A>
389 </H2>
390
391 <P><CODE><B>clear/wcy [1|all]</B> Clear a WCY filter line</CODE></P>
392
393 <P>This command allows you to clear (remove) a line in a WCY filter or to 
394 remove the whole filter.</P>
395 <P>see CLEAR/SPOTS for a more detailed explanation.</P>
396 <H2><A NAME="ss12.16">12.16</A> <A HREF="usermanual_en.html#toc12.16">clear/wwv [1|all]</A>
397 </H2>
398
399 <P><CODE><B>clear/wwv [1|all]</B> Clear a WWV filter line</CODE></P>
400
401 <P>This command allows you to clear (remove) a line in a WWV filter or to 
402 remove the whole filter.</P>
403 <P>see CLEAR/SPOTS for a more detailed explanation.</P>
404 <H2><A NAME="ss12.17">12.17</A> <A HREF="usermanual_en.html#toc12.17">dbavail</A>
405 </H2>
406
407 <P><CODE><B>dbavail</B> Show a list of all the Databases in the system</CODE></P>
408
409 <P>Title says it all really, this command lists all the databases defined
410 in the system. It is also aliased to SHOW/COMMAND.</P>
411 <H2><A NAME="ss12.18">12.18</A> <A HREF="usermanual_en.html#toc12.18">dbshow &lt;dbname&gt; &lt;key&gt;</A>
412 </H2>
413
414 <P><CODE><B>dbshow &lt;dbname&gt; &lt;key&gt;</B> Display an entry, if it exists, in a database</CODE></P>
415
416 <P>This is the generic user interface to the database to the database system.
417 It is expected that the sysop will add an entry to the local Aliases file
418 so that users can use the more familiar AK1A style of enquiry such as:</P>
419 <P>
420 <BLOCKQUOTE><CODE>
421 <PRE>
422   SH/BUCK G1TLH
423 </PRE>
424 </CODE></BLOCKQUOTE>
425 </P>
426 <P>but if he hasn't and the database really does exist (use DBAVAIL or
427 SHOW/COMMAND to find out) you can do the same thing with:</P>
428 <P>
429 <BLOCKQUOTE><CODE>
430 <PRE>
431   DBSHOW buck G1TLH
432 </PRE>
433 </CODE></BLOCKQUOTE>
434 </P>
435
436 <H2><A NAME="ss12.19">12.19</A> <A HREF="usermanual_en.html#toc12.19">directory</A>
437 </H2>
438
439 <P><CODE><B>directory</B> List messages </CODE></P>
440
441
442 <H2><A NAME="ss12.20">12.20</A> <A HREF="usermanual_en.html#toc12.20">directory &lt;from&gt;-&lt;to&gt;</A>
443 </H2>
444
445 <P><CODE><B>directory &lt;from&gt;-&lt;to&gt;</B> List messages &lt;from&gt; message &lt;to&gt; message </CODE></P>
446
447 <P>List the messages in the messages directory.</P>
448 <P>If there is a 'p' one space after the message number then it is a 
449 personal message. If there is a '-' between the message number and the
450 'p' then this indicates that the message has been read.</P>
451 <P>You can use shell escape characters such as '*' and '?' in the &lt;call&gt;
452 fields.</P>
453 <P>You can combine some of the various directory commands together eg:-</P>
454 <P>
455 <BLOCKQUOTE><CODE>
456 <PRE>
457    DIR TO G1TLH 5
458 </PRE>
459 </CODE></BLOCKQUOTE>
460
461 or 
462 <BLOCKQUOTE><CODE>
463 <PRE>
464    DIR SUBJECT IOTA 200-250
465 </PRE>
466 </CODE></BLOCKQUOTE>
467 </P>
468 <P>You can abbreviate all the commands to one letter and use ak1a syntax:-</P>
469 <P>
470 <BLOCKQUOTE><CODE>
471 <PRE>
472    DIR/T G1* 10
473    DIR/S QSL 10-100 5
474 </PRE>
475 </CODE></BLOCKQUOTE>
476 </P>
477
478 <H2><A NAME="ss12.21">12.21</A> <A HREF="usermanual_en.html#toc12.21">directory &lt;nn&gt;</A>
479 </H2>
480
481 <P><CODE><B>directory &lt;nn&gt;</B> List last &lt;nn&gt; messages</CODE></P>
482
483
484 <H2><A NAME="ss12.22">12.22</A> <A HREF="usermanual_en.html#toc12.22">directory all</A>
485 </H2>
486
487 <P><CODE><B>directory all</B> List all messages</CODE></P>
488
489
490 <H2><A NAME="ss12.23">12.23</A> <A HREF="usermanual_en.html#toc12.23">directory from &lt;call&gt;</A>
491 </H2>
492
493 <P><CODE><B>directory from &lt;call&gt;</B> List all messages from &lt;call&gt;</CODE></P>
494
495
496 <H2><A NAME="ss12.24">12.24</A> <A HREF="usermanual_en.html#toc12.24">directory new</A>
497 </H2>
498
499 <P><CODE><B>directory new</B> List all new messages</CODE></P>
500
501
502 <H2><A NAME="ss12.25">12.25</A> <A HREF="usermanual_en.html#toc12.25">directory own</A>
503 </H2>
504
505 <P><CODE><B>directory own</B> List your own messages</CODE></P>
506
507
508 <H2><A NAME="ss12.26">12.26</A> <A HREF="usermanual_en.html#toc12.26">directory subject &lt;string&gt;</A>
509 </H2>
510
511 <P><CODE><B>directory subject &lt;string&gt;</B> List all messages with &lt;string&gt; in subject</CODE></P>
512
513
514 <H2><A NAME="ss12.27">12.27</A> <A HREF="usermanual_en.html#toc12.27">directory to &lt;call&gt;</A>
515 </H2>
516
517 <P><CODE><B>directory to &lt;call&gt;</B> List all messages to &lt;call&gt;</CODE></P>
518
519
520 <H2><A NAME="ss12.28">12.28</A> <A HREF="usermanual_en.html#toc12.28">dx [by &lt;call&gt;] &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</A>
521 </H2>
522
523 <P><CODE><B>dx [by &lt;call&gt;] &lt;freq&gt; &lt;call&gt; &lt;remarks&gt;</B> Send a DX spot</CODE></P>
524
525 <P>This is how you send a DX Spot to other users. You can, in fact, now
526 enter the &lt;freq&gt; and the &lt;call&gt; either way round. </P>
527 <P>
528 <BLOCKQUOTE><CODE>
529 <PRE>
530    DX FR0G 144.600
531    DX 144.600 FR0G
532    DX 144600 FR0G 
533 </PRE>
534 </CODE></BLOCKQUOTE>
535 </P>
536 <P>will all give the same result. You can add some remarks to the end
537 of the command and they will be added to the spot.</P>
538 <P>
539 <BLOCKQUOTE><CODE>
540 <PRE>
541    DX FR0G 144600 this is a test
542 </PRE>
543 </CODE></BLOCKQUOTE>
544 </P>
545 <P>You can credit someone else by saying:-</P>
546 <P>
547 <BLOCKQUOTE><CODE>
548 <PRE>
549    DX by G1TLH FR0G 144.600 he isn't on the cluster
550 </PRE>
551 </CODE></BLOCKQUOTE>
552 </P>
553 <P>The &lt;freq&gt; is compared against the available bands set up in the 
554 cluster.  See SHOW/BANDS for more information.</P>
555 <H2><A NAME="ss12.29">12.29</A> <A HREF="usermanual_en.html#toc12.29">echo &lt;line&gt;</A>
556 </H2>
557
558 <P><CODE><B>echo &lt;line&gt;</B> Echo the line to the output</CODE></P>
559
560 <P>This command is useful in scripts and so forth for printing the
561 line that you give to the command to the output. You can use this
562 in user_default scripts and the SAVE command for titling and so forth</P>
563 <P>The script will interpret certain standard "escape" sequences as follows:-</P>
564 <P>
565 <BLOCKQUOTE><CODE>
566 <PRE>
567   \t - becomes a TAB character (0x09 in ascii)
568   \a - becomes a BEEP character (0x07 in ascii)
569   \n - prints a new line
570 </PRE>
571 </CODE></BLOCKQUOTE>
572 </P>
573 <P>So the following example:-</P>
574 <P>
575 <BLOCKQUOTE><CODE>
576 <PRE>
577   echo GB7DJK is a dxcluster
578 </PRE>
579 </CODE></BLOCKQUOTE>
580 </P>
581 <P>produces:-</P>
582 <P>
583 <BLOCKQUOTE><CODE>
584 <PRE>
585   GB7DJK is a dxcluster
586 </PRE>
587 </CODE></BLOCKQUOTE>
588 </P>
589 <P>on the output. You don't need a \n on the end of the line you want to send.</P>
590 <P>A more complex example:-</P>
591 <P>
592 <BLOCKQUOTE><CODE>
593 <PRE>
594   echo GB7DJK\n\tg1tlh\tDirk\n\tg3xvf\tRichard
595 </PRE>
596 </CODE></BLOCKQUOTE>
597 </P>
598 <P>produces:-</P>
599 <P>
600 <BLOCKQUOTE><CODE>
601 <PRE>
602   GB7DJK
603           g1tlh   Dirk
604           g3xvf   Richard
605 </PRE>
606 </CODE></BLOCKQUOTE>
607 </P>
608 <P>on the output.</P>
609
610 <H2><A NAME="ss12.30">12.30</A> <A HREF="usermanual_en.html#toc12.30">filtering...</A>
611 </H2>
612
613 <P><CODE><B>filtering...</B> Filtering things in DXSpider</CODE></P>
614
615 <P>There are a number of things you can filter in the DXSpider system. They
616 all use the same general mechanism.</P>
617 <P>In general terms you can create a 'reject' or an 'accept' filter which
618 can have up to 10 lines in it. You do this using, for example:-</P>
619 <P>
620 <BLOCKQUOTE><CODE>
621 <PRE>
622   accept/spots .....
623   reject/spots .....
624 </PRE>
625 </CODE></BLOCKQUOTE>
626 </P>
627 <P>where ..... are the specific commands for that type of filter. There
628 are filters for spots, wwv, announce, wcy and (for sysops)
629 connects. See each different accept or reject command reference for
630 more details.</P>
631 <P>There is also a command to clear out one or more lines in a filter and
632 one to show you what you have set. They are:-</P>
633 <P>
634 <BLOCKQUOTE><CODE>
635 <PRE>
636   clear/spots 1
637   clear/spots all
638 </PRE>
639 </CODE></BLOCKQUOTE>
640 </P>
641 <P>and </P>
642 <P>
643 <BLOCKQUOTE><CODE>
644 <PRE>
645   show/filter
646 </PRE>
647 </CODE></BLOCKQUOTE>
648 </P>
649 <P>There is clear/xxxx command for each type of filter.</P>
650 <P>For now we are going to use spots for the examples, but you can apply
651 the principles to all types of filter.</P>
652 <P>There are two main types of filter 'accept' or 'reject'; which you use
653 depends entirely on how you look at the world and what is least
654 writing to achieve what you want. Each filter has 10 lines (of any
655 length) which are tried in order. If a line matches then the action
656 you have specified is taken (ie reject means ignore it and accept
657 means gimme it).</P>
658 <P>The important thing to remember is that if you specify a 'reject'
659 filter (all the lines in it say 'reject/spots' (for instance)) then if
660 a spot comes in that doesn't match any of the lines then you will get
661 it BUT if you specify an 'accept' filter then any spots that don't
662 match are dumped. For example if I have a one line accept filter:-</P>
663 <P>
664 <BLOCKQUOTE><CODE>
665 <PRE>
666   accept/spots on vhf and (by_zone 14,15,16 or call_zone 14,15,16)
667 </PRE>
668 </CODE></BLOCKQUOTE>
669 </P>
670 <P>then automatically you will ONLY get VHF spots from or to CQ zones 14
671 15 and 16.  If you set a reject filter like:</P>
672 <P>
673 <BLOCKQUOTE><CODE>
674 <PRE>
675   reject/spots on hf/cw
676 </PRE>
677 </CODE></BLOCKQUOTE>
678 </P>
679 <P>Then you will get everything EXCEPT HF CW spots, If you am interested in IOTA
680 and will work it even on CW then you could say:-</P>
681 <P>
682 <BLOCKQUOTE><CODE>
683 <PRE>
684   reject/spots on hf/cw and not info iota
685 </PRE>
686 </CODE></BLOCKQUOTE>
687 </P>
688 <P>But in that case you might only be interested in iota and say:-</P>
689 <P>
690 <BLOCKQUOTE><CODE>
691 <PRE>
692   accept/spots not on hf/cw or info iota
693 </PRE>
694 </CODE></BLOCKQUOTE>
695 </P>
696 <P>which is exactly the same. You should choose one or the other until
697 you are confortable with the way it works. Yes, you can mix them
698 (actually you can have an accept AND a reject on the same line) but
699 don't try this at home until you can analyse the results that you get
700 without ringing up the sysop for help.</P>
701 <P>Another useful addition now is filtering by US state</P>
702 <P>
703 <BLOCKQUOTE><CODE>
704 <PRE>
705   accept/spots by_state VA,NH,RI,ME
706 </PRE>
707 </CODE></BLOCKQUOTE>
708 </P>
709 <P>You can arrange your filter lines into logical units, either for your
710 own understanding or simply convenience. I have one set frequently:-</P>
711 <P>
712 <BLOCKQUOTE><CODE>
713 <PRE>
714   reject/spots 1 on hf/cw
715   reject/spots 2 on 50000/1400000 not (by_zone 14,15,16 or call_zone 14,15,16)  
716 </PRE>
717 </CODE></BLOCKQUOTE>
718 </P>
719 <P>What this does is to ignore all HF CW spots (being a class B I can't
720 read any CW and couldn't possibly be interested in HF :-) and also
721 rejects any spots on VHF which don't either originate or spot someone
722 in Europe.</P>
723 <P>This is an exmaple where you would use the line number (1 and 2 in
724 this case), if you leave the digit out, the system assumes '1'. Digits
725 '0'-'9' are available.</P>
726 <P>You can leave the word 'and' out if you want, it is implied. You can
727 use any number of brackets to make the 'expression' as you want
728 it. There are things called precedence rules working here which mean
729 that you will NEED brackets in a situation like line 2 because,
730 without it, will assume:-</P>
731 <P>
732 <BLOCKQUOTE><CODE>
733 <PRE>
734   (on 50000/1400000 and by_zone 14,15,16) or call_zone 14,15,16 
735 </PRE>
736 </CODE></BLOCKQUOTE>
737 </P>
738 <P>annoying, but that is the way it is. If you use OR - use
739 brackets. Whilst we are here CASE is not important. 'And BY_Zone' is
740 just 'and by_zone'.</P>
741 <P>If you want to alter your filter you can just redefine one or more
742 lines of it or clear out one line. For example:-</P>
743 <P>
744 <BLOCKQUOTE><CODE>
745 <PRE>
746   reject/spots 1 on hf/ssb
747 </PRE>
748 </CODE></BLOCKQUOTE>
749 </P>
750 <P>or </P>
751 <P>
752 <BLOCKQUOTE><CODE>
753 <PRE>
754   clear/spots 1
755 </PRE>
756 </CODE></BLOCKQUOTE>
757 </P>
758 <P>To remove the filter in its entirty:-</P>
759 <P>
760 <BLOCKQUOTE><CODE>
761 <PRE>
762   clear/spots all
763 </PRE>
764 </CODE></BLOCKQUOTE>
765 </P>
766 <P>There are similar CLEAR commands for the other filters:-</P>
767 <P>
768 <BLOCKQUOTE><CODE>
769 <PRE>
770   clear/announce
771   clear/wcy
772   clear/wwv
773 </PRE>
774 </CODE></BLOCKQUOTE>
775 </P>
776 <P>ADVANCED USERS:-</P>
777 <P>Once you are happy with the results you get, you may like to experiment. </P>
778 <P>my example that filters hf/cw spots and accepts vhf/uhf spots from EU
779 can be written with a mixed filter, eg:</P>
780 <P>
781 <BLOCKQUOTE><CODE>
782 <PRE>
783   rej/spot on hf/cw
784   acc/spot on 0/30000
785   acc/spot 2 on 50000/1400000 and (by_zone 14,15,16 or call_zone 14,15,16)
786 </PRE>
787 </CODE></BLOCKQUOTE>
788 </P>
789 <P>each filter slot actually has a 'reject' slot and an 'accept'
790 slot. The reject slot is executed BEFORE the accept slot.</P>
791 <P>It was mentioned earlier that after a reject test that doesn't match,
792 the default for following tests is 'accept', the reverse is true for
793 'accept'. In the example what happens is that the reject is executed
794 first, any non hf/cw spot is passed to the accept line, which lets
795 thru everything else on HF.</P>
796 <P>The next filter line lets through just VHF/UHF spots from EU.</P>
797 <H2><A NAME="ss12.31">12.31</A> <A HREF="usermanual_en.html#toc12.31">help</A>
798 </H2>
799
800 <P><CODE><B>help</B> The HELP Command</CODE></P>
801
802 <P>HELP is available for a number of commands. The syntax is:-</P>
803 <P>
804 <BLOCKQUOTE><CODE>
805 <PRE>
806   HELP &lt;cmd&gt;
807 </PRE>
808 </CODE></BLOCKQUOTE>
809 </P>
810 <P>Where &lt;cmd&gt; is the name of the command you want help on.</P>
811 <P>All commands can be abbreviated, so SHOW/DX can be abbreviated
812 to SH/DX, ANNOUNCE can be shortened to AN and so on.</P>
813 <P>Look at the APROPOS &lt;string&gt; command which will search the help database
814 for the &lt;string&gt; you specify and give you a list of likely commands
815 to look at with HELP.</P>
816 <H2><A NAME="ss12.32">12.32</A> <A HREF="usermanual_en.html#toc12.32">join &lt;group&gt;</A>
817 </H2>
818
819 <P><CODE><B>join &lt;group&gt;</B> Join a chat or conference group</CODE></P>
820
821 <P>JOIN allows you to join a network wide conference group. To join a
822 group (called FOC in this case) type:-</P>
823 <P>
824 <BLOCKQUOTE><CODE>
825 <PRE>
826   JOIN FOC
827 </PRE>
828 </CODE></BLOCKQUOTE>
829 </P>
830 <P>See also CHAT, LEAVE, SHOW/CHAT</P>
831 <H2><A NAME="ss12.33">12.33</A> <A HREF="usermanual_en.html#toc12.33">kill &lt;from msgno&gt;-&lt;to msgno&gt;</A>
832 </H2>
833
834 <P><CODE><B>kill &lt;from msgno&gt;-&lt;to msgno&gt;</B> Delete a range of messages</CODE></P>
835
836
837 <H2><A NAME="ss12.34">12.34</A> <A HREF="usermanual_en.html#toc12.34">kill &lt;msgno&gt; [&lt;msgno..]</A>
838 </H2>
839
840 <P><CODE><B>kill &lt;msgno&gt; [&lt;msgno..]</B> Delete a message from the local system</CODE></P>
841
842
843 <H2><A NAME="ss12.35">12.35</A> <A HREF="usermanual_en.html#toc12.35">kill &lt;msgno&gt; [&lt;msgno&gt; ...]</A>
844 </H2>
845
846 <P><CODE><B>kill &lt;msgno&gt; [&lt;msgno&gt; ...]</B> Remove or erase a message from the system</CODE></P>
847
848 <P>You can get rid of any message to or originating from your callsign using 
849 this command. You can remove more than one message at a time.</P>
850 <H2><A NAME="ss12.36">12.36</A> <A HREF="usermanual_en.html#toc12.36">kill from &lt;regex&gt;</A>
851 </H2>
852
853 <P><CODE><B>kill from &lt;regex&gt;</B> Delete messages FROM a callsign or pattern</CODE></P>
854
855
856 <H2><A NAME="ss12.37">12.37</A> <A HREF="usermanual_en.html#toc12.37">kill to &lt;regex&gt;</A>
857 </H2>
858
859 <P><CODE><B>kill to &lt;regex&gt;</B> Delete messages TO a callsign or pattern</CODE></P>
860
861
862 <H2><A NAME="ss12.38">12.38</A> <A HREF="usermanual_en.html#toc12.38">leave &lt;group&gt;</A>
863 </H2>
864
865 <P><CODE><B>leave &lt;group&gt;</B> Leave a chat or conference group</CODE></P>
866
867 <P>LEAVE allows you to leave a network wide conference group. To leave a
868 group (called FOC in this case) type:-</P>
869 <P>
870 <BLOCKQUOTE><CODE>
871 <PRE>
872   LEAVE FOC
873 </PRE>
874 </CODE></BLOCKQUOTE>
875 </P>
876 <P>See also CHAT, JOIN, SHOW/CHAT</P>
877 <H2><A NAME="ss12.39">12.39</A> <A HREF="usermanual_en.html#toc12.39">links</A>
878 </H2>
879
880 <P><CODE><B>links</B> Show which nodes is physically connected</CODE></P>
881
882 <P>This is a quick listing that shows which links are connected and
883 some information about them. See WHO for a list of all connections.</P>
884 <H2><A NAME="ss12.40">12.40</A> <A HREF="usermanual_en.html#toc12.40">read</A>
885 </H2>
886
887 <P><CODE><B>read</B> Read the next unread personal message addressed to you</CODE></P>
888
889
890 <H2><A NAME="ss12.41">12.41</A> <A HREF="usermanual_en.html#toc12.41">read &lt;msgno&gt;</A>
891 </H2>
892
893 <P><CODE><B>read &lt;msgno&gt;</B> Read the specified message</CODE></P>
894
895 <P>You can read any messages that are sent as 'non-personal' and also any
896 message either sent by or sent to your callsign.</P>
897 <H2><A NAME="ss12.42">12.42</A> <A HREF="usermanual_en.html#toc12.42">reject</A>
898 </H2>
899
900 <P><CODE><B>reject</B> Set a filter to reject something</CODE></P>
901
902 <P>Create a filter to reject something</P>
903 <P>There are 2 types of filter, accept and reject.  See HELP FILTERING for more
904 info.</P>
905 <H2><A NAME="ss12.43">12.43</A> <A HREF="usermanual_en.html#toc12.43">reject/announce [0-9] &lt;pattern&gt;</A>
906 </H2>
907
908 <P><CODE><B>reject/announce [0-9] &lt;pattern&gt;</B> Set a 'reject' filter line for announce</CODE></P>
909
910 <P>Create an 'reject this announce' line for a filter. </P>
911 <P>A reject filter line means that if the announce matches this filter it is
912 passed onto the user. See HELP FILTERING for more info. Please read this
913 to understand how filters work - it will save a lot of grief later on.</P>
914 <P>You can use any of the following things in this line:-</P>
915 <P>
916 <BLOCKQUOTE><CODE>
917 <PRE>
918   info &lt;string&gt;            eg: iota or qsl
919   by &lt;prefixes&gt;            eg: G,M,2         
920   origin &lt;prefixes&gt;
921   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
922   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
923   origin_zone &lt;prefixes or numbers&gt;
924   origin_state &lt;states&gt;                eg: VA,NH,RI,ME
925   by_dxcc &lt;prefixes or numbers&gt;
926   by_itu &lt;prefixes or numbers&gt;
927   by_zone &lt;prefixes or numbers&gt;
928   by_state &lt;states&gt;                eg: VA,NH,RI,ME
929   channel &lt;prefixes&gt;
930   wx 1                     filter WX announces
931   dest &lt;prefixes&gt;          eg: 6MUK,WDX      (distros)
932 </PRE>
933 </CODE></BLOCKQUOTE>
934 </P>
935 <P>some examples:-</P>
936 <P>
937 <BLOCKQUOTE><CODE>
938 <PRE>
939   rej/ann by_zone 14,15,16 and not by G,M,2
940 </PRE>
941 </CODE></BLOCKQUOTE>
942 </P>
943 <P>You can use the tag 'all' to reject everything eg:</P>
944 <P>
945 <BLOCKQUOTE><CODE>
946 <PRE>
947   rej/ann all
948 </PRE>
949 </CODE></BLOCKQUOTE>
950 </P>
951 <P>but this probably for advanced users...</P>
952 <H2><A NAME="ss12.44">12.44</A> <A HREF="usermanual_en.html#toc12.44">reject/spots [0-9] &lt;pattern&gt;</A>
953 </H2>
954
955 <P><CODE><B>reject/spots [0-9] &lt;pattern&gt;</B> Set a 'reject' filter line for spots</CODE></P>
956
957 <P>Create a 'reject this spot' line for a filter. </P>
958 <P>A reject filter line means that if the spot matches this filter it is
959 dumped (not passed on). See HELP FILTERING for more info. Please read this
960 to understand how filters work - it will save a lot of grief later on.</P>
961 <P>You can use any of the following things in this line:-</P>
962 <P>
963 <BLOCKQUOTE><CODE>
964 <PRE>
965   freq &lt;range&gt;           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
966   on &lt;range&gt;             same as 'freq'
967   call &lt;prefixes&gt;        eg: G,PA,HB9
968   info &lt;string&gt;          eg: iota or qsl
969   by &lt;prefixes&gt;            
970   call_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
971   call_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
972   call_zone &lt;prefixes or numbers&gt;
973   call_state &lt;states&gt;                eg: VA,NH,RI,ME
974   by_dxcc &lt;prefixes or numbers&gt;
975   by_itu &lt;prefixes or numbers&gt;
976   by_zone &lt;prefixes or numbers&gt;
977   by_state &lt;states&gt;                eg: VA,NH,RI,ME
978   origin &lt;prefixes&gt;
979   channel &lt;prefixes&gt;
980 </PRE>
981 </CODE></BLOCKQUOTE>
982 </P>
983 <P>'call' means the callsign that has spotted 'by' whoever.</P>
984 <P>For frequencies, you can use any of the band names defined in
985 SHOW/BANDS and you can use a subband name like: cw, rtty, data, ssb -
986 thus: hf/ssb. You can also just have a simple range like: 0/30000 -
987 this is more efficient than saying simply: on HF (but don't get
988 too hung up about that)</P>
989 <P>some examples:-</P>
990 <P>
991 <BLOCKQUOTE><CODE>
992 <PRE>
993   rej/spot 1 on hf
994   rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
995 </PRE>
996 </CODE></BLOCKQUOTE>
997 </P>
998 <P>You can use the tag 'all' to reject everything eg:</P>
999 <P>
1000 <BLOCKQUOTE><CODE>
1001 <PRE>
1002   rej/spot 3 all
1003 </PRE>
1004 </CODE></BLOCKQUOTE>
1005 </P>
1006 <P>but this probably for advanced users...</P>
1007 <H2><A NAME="ss12.45">12.45</A> <A HREF="usermanual_en.html#toc12.45">reject/wcy [0-9] &lt;pattern&gt;</A>
1008 </H2>
1009
1010 <P><CODE><B>reject/wcy [0-9] &lt;pattern&gt;</B> set a 'reject' WCY filter</CODE></P>
1011
1012 <P>It is unlikely that you will want to do this, but if you do then you can
1013 filter on the following fields:-</P>
1014 <P>
1015 <BLOCKQUOTE><CODE>
1016 <PRE>
1017   by &lt;prefixes&gt;            eg: G,M,2         
1018   origin &lt;prefixes&gt;
1019   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1020   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1021   origin_zone &lt;prefixes or numbers&gt;
1022   by_dxcc &lt;prefixes or numbers&gt;
1023   by_itu &lt;prefixes or numbers&gt;
1024   by_zone &lt;prefixes or numbers&gt;
1025   channel &lt;prefixes&gt;
1026 </PRE>
1027 </CODE></BLOCKQUOTE>
1028 </P>
1029 <P>There are no examples because WCY Broadcasts only come from one place and
1030 you either want them or not (see UNSET/WCY if you don't want them).</P>
1031 <P>This command is really provided for future use.</P>
1032 <P>See HELP FILTER for information.</P>
1033 <H2><A NAME="ss12.46">12.46</A> <A HREF="usermanual_en.html#toc12.46">reject/wwv [0-9] &lt;pattern&gt;</A>
1034 </H2>
1035
1036 <P><CODE><B>reject/wwv [0-9] &lt;pattern&gt;</B> set a 'reject' WWV filter</CODE></P>
1037
1038 <P>It is unlikely that you will want to do this, but if you do then you can
1039 filter on the following fields:-</P>
1040 <P>
1041 <BLOCKQUOTE><CODE>
1042 <PRE>
1043   by &lt;prefixes&gt;            eg: G,M,2         
1044   origin &lt;prefixes&gt;
1045   origin_dxcc &lt;prefixes or numbers&gt;    eg: 61,62 (from eg: sh/pre G)
1046   origin_itu &lt;prefixes or numbers&gt;     or: G,GM,GW
1047   origin_zone &lt;prefixes or numbers&gt;
1048   by_dxcc &lt;prefixes or numbers&gt;
1049   by_itu &lt;prefixes or numbers&gt;
1050   by_zone &lt;prefixes or numbers&gt;
1051   channel &lt;prefixes&gt;
1052 </PRE>
1053 </CODE></BLOCKQUOTE>
1054 </P>
1055 <P>for example </P>
1056 <P>
1057 <BLOCKQUOTE><CODE>
1058 <PRE>
1059   reject/wwv by_zone 14,15,16
1060 </PRE>
1061 </CODE></BLOCKQUOTE>
1062 </P>
1063 <P>is probably the only useful thing to do (which will only show WWV broadcasts
1064 by stations in the US).</P>
1065 <P>See HELP FILTER for information.</P>
1066 <H2><A NAME="ss12.47">12.47</A> <A HREF="usermanual_en.html#toc12.47">reply</A>
1067 </H2>
1068
1069 <P><CODE><B>reply</B> Reply (privately) to the last message that you have read</CODE></P>
1070
1071
1072 <H2><A NAME="ss12.48">12.48</A> <A HREF="usermanual_en.html#toc12.48">reply &lt;msgno&gt;</A>
1073 </H2>
1074
1075 <P><CODE><B>reply &lt;msgno&gt;</B> Reply (privately) to the specified message</CODE></P>
1076
1077
1078 <H2><A NAME="ss12.49">12.49</A> <A HREF="usermanual_en.html#toc12.49">reply b &lt;msgno&gt;</A>
1079 </H2>
1080
1081 <P><CODE><B>reply b &lt;msgno&gt;</B> Reply as a Bulletin to the specified message</CODE></P>
1082
1083
1084 <H2><A NAME="ss12.50">12.50</A> <A HREF="usermanual_en.html#toc12.50">reply noprivate &lt;msgno&gt;</A>
1085 </H2>
1086
1087 <P><CODE><B>reply noprivate &lt;msgno&gt;</B> Reply as a Bulletin to the specified message</CODE></P>
1088
1089
1090 <H2><A NAME="ss12.51">12.51</A> <A HREF="usermanual_en.html#toc12.51">reply rr &lt;msgno&gt;</A>
1091 </H2>
1092
1093 <P><CODE><B>reply rr &lt;msgno&gt;</B> Reply to the specified message with read receipt</CODE></P>
1094
1095 <P>You can reply to a message and the subject will automatically have
1096 "Re:" inserted in front of it, if it isn't already present.</P>
1097 <P>You can also use all the extra qualifiers such as RR, PRIVATE, 
1098 NOPRIVATE, B that you can use with the SEND command (see SEND
1099 for further details)</P>
1100 <H2><A NAME="ss12.52">12.52</A> <A HREF="usermanual_en.html#toc12.52">send &lt;call&gt; [&lt;call&gt; ...]</A>
1101 </H2>
1102
1103 <P><CODE><B>send &lt;call&gt; [&lt;call&gt; ...]</B> Send a message to one or more callsigns</CODE></P>
1104
1105
1106 <H2><A NAME="ss12.53">12.53</A> <A HREF="usermanual_en.html#toc12.53">send copy &lt;msgno&gt; &lt;call&gt;</A>
1107 </H2>
1108
1109 <P><CODE><B>send copy &lt;msgno&gt; &lt;call&gt;</B> Send a copy of a  message to someone</CODE></P>
1110
1111
1112 <H2><A NAME="ss12.54">12.54</A> <A HREF="usermanual_en.html#toc12.54">send noprivate &lt;call&gt;</A>
1113 </H2>
1114
1115 <P><CODE><B>send noprivate &lt;call&gt;</B> Send a message to all stations</CODE></P>
1116
1117 <P>All the SEND commands will create a message which will be sent either to
1118 an individual callsign or to one of the 'bulletin' addresses. </P>
1119 <P>SEND &lt;call&gt; on its own acts as though you had typed SEND PRIVATE, that is
1120 it will mark the message as personal and send it to the cluster node that
1121 that callsign is connected to. If the &lt;call&gt; you have specified is in fact
1122 a known bulletin category on your node (eg: ALL) then the message should
1123 automatically become a bulletin.</P>
1124 <P>You can have more than one callsign in all of the SEND commands.</P>
1125 <P>You can have multiple qualifiers so that you can have for example:-</P>
1126 <P>
1127 <BLOCKQUOTE><CODE>
1128 <PRE>
1129   SEND RR COPY 123 PRIVATE G1TLH G0RDI
1130 </PRE>
1131 </CODE></BLOCKQUOTE>
1132 </P>
1133 <P>which should send a copy of message 123 to G1TLH and G0RDI and you will
1134 receive a read receipt when they have read the message.</P>
1135 <P>SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
1136 SP is an alias for SEND PRIVATE</P>
1137 <P>The system will ask you for a subject. Conventionally this should be 
1138 no longer than 29 characters for compatibility. Most modern cluster
1139 software should accept more.</P>
1140 <P>You will now be prompted to start entering your text. </P>
1141 <P>You finish the message by entering '/EX' on a new line. For instance:</P>
1142 <P>
1143 <BLOCKQUOTE><CODE>
1144 <PRE>
1145   ...
1146   bye then Jim
1147   73 Dirk
1148   /ex
1149 </PRE>
1150 </CODE></BLOCKQUOTE>
1151 </P>
1152 <P>If you have started a message and you don't want to keep it then you
1153 can abandon the message with '/ABORT' on a new line, like:-</P>
1154 <P>
1155 <BLOCKQUOTE><CODE>
1156 <PRE>
1157   line 1
1158   line 2
1159   oh I just can't be bothered with this
1160   /abort
1161 </PRE>
1162 </CODE></BLOCKQUOTE>
1163 </P>
1164 <P>If you abort the message it will NOT be sent.</P>
1165 <P>When you are entering the text of your message, most normal output (such
1166 as DX announcements and so on are suppressed and stored for latter display
1167 (upto 20 such lines are stored, as new ones come along, so the oldest
1168 lines are dropped).</P>
1169 <P>Also, you can enter normal commands commands (and get the output 
1170 immediately) whilst in the middle of a message. You do this by typing
1171 the command preceeded by a '/' character on a new line, so:-</P>
1172 <P>
1173 <BLOCKQUOTE><CODE>
1174 <PRE>
1175   /dx g1tlh 144010 strong signal
1176 </PRE>
1177 </CODE></BLOCKQUOTE>
1178 </P>
1179 <P>Will issue a dx annoucement to the rest of the cluster. </P>
1180 <P>Also, you can add the output of a command to your message by preceeding 
1181 the command with '//', thus :-</P>
1182 <P>
1183 <BLOCKQUOTE><CODE>
1184 <PRE>
1185   //sh/vhftable
1186 </PRE>
1187 </CODE></BLOCKQUOTE>
1188 </P>
1189 <P>This will show YOU the output from SH/VHFTABLE and also store it in the
1190 message. </P>
1191 <P>You can carry on with the message until you are ready to send it. </P>
1192 <H2><A NAME="ss12.55">12.55</A> <A HREF="usermanual_en.html#toc12.55">send private &lt;call&gt;</A>
1193 </H2>
1194
1195 <P><CODE><B>send private &lt;call&gt;</B> Send a personal message</CODE></P>
1196
1197
1198 <H2><A NAME="ss12.56">12.56</A> <A HREF="usermanual_en.html#toc12.56">send rr &lt;call&gt;</A>
1199 </H2>
1200
1201 <P><CODE><B>send rr &lt;call&gt;</B> Send a message and ask for a read receipt</CODE></P>
1202
1203
1204 <H2><A NAME="ss12.57">12.57</A> <A HREF="usermanual_en.html#toc12.57">set/address &lt;your address&gt;</A>
1205 </H2>
1206
1207 <P><CODE><B>set/address &lt;your address&gt;</B> Record your postal address</CODE></P>
1208
1209
1210 <H2><A NAME="ss12.58">12.58</A> <A HREF="usermanual_en.html#toc12.58">set/announce</A>
1211 </H2>
1212
1213 <P><CODE><B>set/announce</B> Allow announce messages to come out on your terminal</CODE></P>
1214
1215
1216 <H2><A NAME="ss12.59">12.59</A> <A HREF="usermanual_en.html#toc12.59">set/anntalk</A>
1217 </H2>
1218
1219 <P><CODE><B>set/anntalk</B> Allow talk like announce messages on your terminal</CODE></P>
1220
1221
1222 <H2><A NAME="ss12.60">12.60</A> <A HREF="usermanual_en.html#toc12.60">set/beep</A>
1223 </H2>
1224
1225 <P><CODE><B>set/beep</B> Add a beep to DX and other messages on your terminal</CODE></P>
1226
1227
1228 <H2><A NAME="ss12.61">12.61</A> <A HREF="usermanual_en.html#toc12.61">set/dx</A>
1229 </H2>
1230
1231 <P><CODE><B>set/dx</B> Allow DX messages to come out on your terminal</CODE></P>
1232
1233
1234 <H2><A NAME="ss12.62">12.62</A> <A HREF="usermanual_en.html#toc12.62">set/dxcq</A>
1235 </H2>
1236
1237 <P><CODE><B>set/dxcq</B> Show CQ Zones on the end of DX announcements</CODE></P>
1238
1239
1240 <H2><A NAME="ss12.63">12.63</A> <A HREF="usermanual_en.html#toc12.63">set/dxgrid</A>
1241 </H2>
1242
1243 <P><CODE><B>set/dxgrid</B> Allow QRA Grid Squares on the end of DX announcements</CODE></P>
1244
1245
1246 <H2><A NAME="ss12.64">12.64</A> <A HREF="usermanual_en.html#toc12.64">set/dxitu</A>
1247 </H2>
1248
1249 <P><CODE><B>set/dxitu</B> Show ITU Zones on the end of DX announcements</CODE></P>
1250
1251
1252 <H2><A NAME="ss12.65">12.65</A> <A HREF="usermanual_en.html#toc12.65">set/echo</A>
1253 </H2>
1254
1255 <P><CODE><B>set/echo</B> Make the cluster echo your input</CODE></P>
1256
1257
1258 <H2><A NAME="ss12.66">12.66</A> <A HREF="usermanual_en.html#toc12.66">set/email &lt;email&gt; ...</A>
1259 </H2>
1260
1261 <P><CODE><B>set/email &lt;email&gt; ...</B> Set email address(es) and forward your personals</CODE></P>
1262
1263
1264 <H2><A NAME="ss12.67">12.67</A> <A HREF="usermanual_en.html#toc12.67">set/here</A>
1265 </H2>
1266
1267 <P><CODE><B>set/here</B> Tell the system you are present at your terminal</CODE></P>
1268
1269
1270 <H2><A NAME="ss12.68">12.68</A> <A HREF="usermanual_en.html#toc12.68">set/homenode &lt;node&gt; </A>
1271 </H2>
1272
1273 <P><CODE><B>set/homenode &lt;node&gt; </B> Set your normal cluster callsign</CODE></P>
1274
1275 <P>Tell the cluster system where you normally connect to. Any Messages sent
1276 to you will normally find their way there should you not be connected.
1277 eg:-
1278 <BLOCKQUOTE><CODE>
1279 <PRE>
1280   SET/HOMENODE gb7djk
1281 </PRE>
1282 </CODE></BLOCKQUOTE>
1283 </P>
1284
1285 <H2><A NAME="ss12.69">12.69</A> <A HREF="usermanual_en.html#toc12.69">set/language &lt;lang&gt;</A>
1286 </H2>
1287
1288 <P><CODE><B>set/language &lt;lang&gt;</B> Set the language you want to use</CODE></P>
1289
1290 <P>You can select the language that you want the cluster to use. Currently
1291 the languages available are en (English), de (German), es (Spanish),
1292 Czech (cz), French (fr), Portuguese (pt), Italian (it) and nl (Dutch).</P>
1293 <H2><A NAME="ss12.70">12.70</A> <A HREF="usermanual_en.html#toc12.70">set/location &lt;lat &amp; long&gt;</A>
1294 </H2>
1295
1296 <P><CODE><B>set/location &lt;lat &amp; long&gt;</B> Set your latitude and longitude</CODE></P>
1297
1298
1299 <H2><A NAME="ss12.71">12.71</A> <A HREF="usermanual_en.html#toc12.71">set/logininfo</A>
1300 </H2>
1301
1302 <P><CODE><B>set/logininfo</B> Inform when a station logs in locally</CODE></P>
1303
1304
1305 <H2><A NAME="ss12.72">12.72</A> <A HREF="usermanual_en.html#toc12.72">set/name &lt;your name&gt;</A>
1306 </H2>
1307
1308 <P><CODE><B>set/name &lt;your name&gt;</B> Set your name</CODE></P>
1309
1310 <P>Tell the system what your name is eg:-
1311 <BLOCKQUOTE><CODE>
1312 <PRE>
1313   SET/NAME Dirk
1314 </PRE>
1315 </CODE></BLOCKQUOTE>
1316 </P>
1317
1318 <H2><A NAME="ss12.73">12.73</A> <A HREF="usermanual_en.html#toc12.73">set/page &lt;lines per page&gt;</A>
1319 </H2>
1320
1321 <P><CODE><B>set/page &lt;lines per page&gt;</B> Set the lines per page</CODE></P>
1322
1323 <P>Tell the system how many lines you wish on a page when the number of line
1324 of output from a command is more than this. The default is 20. Setting it
1325 explicitly to 0 will disable paging. 
1326 <BLOCKQUOTE><CODE>
1327 <PRE>
1328   SET/PAGE 30
1329   SET/PAGE 0
1330 </PRE>
1331 </CODE></BLOCKQUOTE>
1332 </P>
1333 <P>The setting is stored in your user profile.</P>
1334 <H2><A NAME="ss12.74">12.74</A> <A HREF="usermanual_en.html#toc12.74">set/password</A>
1335 </H2>
1336
1337 <P><CODE><B>set/password</B> Set your own password</CODE></P>
1338
1339 <P>This command only works for a 'telnet' user (currently). It will
1340 only work if you have a password already set. This initial password
1341 can only be set by the sysop.</P>
1342 <P>When you execute this command it will ask you for your old password,
1343 then ask you to type in your new password twice (to make sure you
1344 get it right). You may or may not see the data echoed on the screen
1345 as you type, depending on the type of telnet client you have.</P>
1346 <H2><A NAME="ss12.75">12.75</A> <A HREF="usermanual_en.html#toc12.75">set/prompt &lt;string&gt;</A>
1347 </H2>
1348
1349 <P><CODE><B>set/prompt &lt;string&gt;</B> Set your prompt to &lt;string&gt;</CODE></P>
1350
1351
1352 <H2><A NAME="ss12.76">12.76</A> <A HREF="usermanual_en.html#toc12.76">set/qra &lt;locator&gt;</A>
1353 </H2>
1354
1355 <P><CODE><B>set/qra &lt;locator&gt;</B> Set your QRA Grid locator</CODE></P>
1356
1357 <P>Tell the system what your QRA (or Maidenhead) locator is. If you have not
1358 done a SET/LOCATION then your latitude and longitude will be set roughly
1359 correctly (assuming your locator is correct ;-). For example:-
1360 <BLOCKQUOTE><CODE>
1361 <PRE>
1362   SET/QRA JO02LQ
1363 </PRE>
1364 </CODE></BLOCKQUOTE>
1365 </P>
1366
1367 <H2><A NAME="ss12.77">12.77</A> <A HREF="usermanual_en.html#toc12.77">set/qth &lt;your qth&gt;</A>
1368 </H2>
1369
1370 <P><CODE><B>set/qth &lt;your qth&gt;</B> Set your QTH</CODE></P>
1371
1372 <P>Tell the system where you are. For example:-
1373 <BLOCKQUOTE><CODE>
1374 <PRE>
1375   SET/QTH East Dereham, Norfolk
1376 </PRE>
1377 </CODE></BLOCKQUOTE>
1378 </P>
1379
1380 <H2><A NAME="ss12.78">12.78</A> <A HREF="usermanual_en.html#toc12.78">set/talk</A>
1381 </H2>
1382
1383 <P><CODE><B>set/talk</B> Allow TALK messages to come out on your terminal</CODE></P>
1384
1385
1386 <H2><A NAME="ss12.79">12.79</A> <A HREF="usermanual_en.html#toc12.79">set/usstate</A>
1387 </H2>
1388
1389 <P><CODE><B>set/usstate</B> Allow US State info on the end of DX announcements</CODE></P>
1390
1391
1392 <H2><A NAME="ss12.80">12.80</A> <A HREF="usermanual_en.html#toc12.80">set/wcy</A>
1393 </H2>
1394
1395 <P><CODE><B>set/wcy</B> Allow WCY messages to come out on your terminal</CODE></P>
1396
1397
1398 <H2><A NAME="ss12.81">12.81</A> <A HREF="usermanual_en.html#toc12.81">set/wwv</A>
1399 </H2>
1400
1401 <P><CODE><B>set/wwv</B> Allow WWV messages to come out on your terminal</CODE></P>
1402
1403
1404 <H2><A NAME="ss12.82">12.82</A> <A HREF="usermanual_en.html#toc12.82">set/wx</A>
1405 </H2>
1406
1407 <P><CODE><B>set/wx</B> Allow WX messages to come out on your terminal</CODE></P>
1408
1409
1410 <H2><A NAME="ss12.83">12.83</A> <A HREF="usermanual_en.html#toc12.83">show/chat [&lt;group&gt;] [&lt;lines&gt;]</A>
1411 </H2>
1412
1413 <P><CODE><B>show/chat [&lt;group&gt;] [&lt;lines&gt;]</B> Show any chat or conferencing </CODE></P>
1414
1415 <P>This command allows you to see any chat or conferencing that has  
1416 occurred whilst you were away. SHOW/CHAT on its own will show data for
1417 all groups. If you use a group name then it will show only chat for
1418 that group.</P>
1419 <H2><A NAME="ss12.84">12.84</A> <A HREF="usermanual_en.html#toc12.84">show/configuration [&lt;node&gt;]</A>
1420 </H2>
1421
1422 <P><CODE><B>show/configuration [&lt;node&gt;]</B> Show all the nodes and users visible</CODE></P>
1423
1424 <P>This command allows you to see all the users that can be seen
1425 and the nodes to which they are connected.</P>
1426 <P>This command is normally abbreviated to: sh/c</P>
1427 <P>Normally, the list returned will be just for the nodes from your 
1428 country (because the list otherwise will be very long).</P>
1429 <P>
1430 <BLOCKQUOTE><CODE>
1431 <PRE>
1432   SH/C ALL 
1433 </PRE>
1434 </CODE></BLOCKQUOTE>
1435 </P>
1436 <P>will produce a complete list of all nodes. </P>
1437 <P>BE WARNED: the list that is returned can be VERY long</P>
1438 <P>It is possible to supply a node or part of a prefix and you will get 
1439 a list of the users for that node or list of nodes starting with
1440 that prefix.</P>
1441 <P>
1442 <BLOCKQUOTE><CODE>
1443 <PRE>
1444   SH/C GB7DJK
1445 </PRE>
1446 </CODE></BLOCKQUOTE>
1447 </P>
1448 <P>
1449 <BLOCKQUOTE><CODE>
1450 <PRE>
1451   SH/C SK
1452 </PRE>
1453 </CODE></BLOCKQUOTE>
1454 </P>
1455
1456 <H2><A NAME="ss12.85">12.85</A> <A HREF="usermanual_en.html#toc12.85">show/configuration/node</A>
1457 </H2>
1458
1459 <P><CODE><B>show/configuration/node</B> Show all the nodes connected locally</CODE></P>
1460
1461 <P>Show all the nodes connected to this node.</P>
1462 <H2><A NAME="ss12.86">12.86</A> <A HREF="usermanual_en.html#toc12.86">show/contest &lt;year and month&gt;</A>
1463 </H2>
1464
1465 <P><CODE><B>show/contest &lt;year and month&gt;</B> Show all the contests for a month</CODE></P>
1466
1467 <P>Show all known contests which are maintained at http://www.sk3bg.se/contest/
1468 for a particular month or year. The format is reasonably flexible.
1469 For example:-</P>
1470 <P>
1471 <BLOCKQUOTE><CODE>
1472 <PRE>
1473   SH/CONTEST sep2003
1474   SH/CONTEST 03 march
1475 </PRE>
1476 </CODE></BLOCKQUOTE>
1477 </P>
1478
1479 <H2><A NAME="ss12.87">12.87</A> <A HREF="usermanual_en.html#toc12.87">show/date [&lt;prefix&gt;|&lt;callsign&gt;]</A>
1480 </H2>
1481
1482 <P><CODE><B>show/date [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show the local time </CODE></P>
1483
1484 <P>This is very nearly the same as SHOW/TIME, the only difference the format
1485 of the date string if no arguments are given.</P>
1486 <P>If no prefixes or callsigns are given then this command returns the local
1487 time and UTC as the computer has it right now. If you give some prefixes
1488 then it will show UTC and UTC + the local offset (not including DST) at
1489 the prefixes or callsigns that you specify.</P>
1490 <H2><A NAME="ss12.88">12.88</A> <A HREF="usermanual_en.html#toc12.88">show/db0sdx &lt;callsign&gt;</A>
1491 </H2>
1492
1493 <P><CODE><B>show/db0sdx &lt;callsign&gt;</B> Show QSL infomation from DB0SDX database</CODE></P>
1494
1495 <P>This command queries the DB0SDX QSL server on the internet
1496 and returns any information available for that callsign. This service
1497 is provided for users of this software by http://www.qslinfo.de.</P>
1498 <P>See also SHOW/QRZ, SHOW/WM7D.</P>
1499 <H2><A NAME="ss12.89">12.89</A> <A HREF="usermanual_en.html#toc12.89">show/dx</A>
1500 </H2>
1501
1502 <P><CODE><B>show/dx</B> Interrogate the spot database</CODE></P>
1503
1504 <P>If you just type SHOW/DX you will get the last so many spots
1505 (sysop configurable, but usually 10).</P>
1506 <P>In addition you can add any number of these commands in very nearly
1507 any order to the basic SHOW/DX command, they are:-</P>
1508 <P>
1509 <BLOCKQUOTE><CODE>
1510 <PRE>
1511  on &lt;band&gt;       - eg 160m 20m 2m 23cm 6mm
1512  on &lt;region&gt;     - eg hf vhf uhf shf      (see SHOW/BANDS)
1513  on &lt;from&gt;/&lt;to&gt;  - eg 1000/4000 14000-30000  (in Khz)
1514     &lt;from&gt;-&lt;to&gt;
1515 </PRE>
1516 </CODE></BLOCKQUOTE>
1517 </P>
1518 <P>
1519 <BLOCKQUOTE><CODE>
1520 <PRE>
1521  &lt;number&gt;        - the number of spots you want
1522  &lt;from&gt;-&lt;to&gt;     - &lt;from&gt; spot no &lt;to&gt; spot no in the selected list
1523  &lt;from&gt;/&lt;to&gt;
1524 </PRE>
1525 </CODE></BLOCKQUOTE>
1526 </P>
1527 <P>
1528 <BLOCKQUOTE><CODE>
1529 <PRE>
1530  &lt;prefix&gt;        - for a spotted callsign beginning with &lt;prefix&gt;
1531  *&lt;suffix&gt;       - for a spotted callsign ending in &lt;suffix&gt;
1532  *&lt;string&gt;*      - for a spotted callsign containing &lt;string&gt;
1533 </PRE>
1534 </CODE></BLOCKQUOTE>
1535 </P>
1536 <P>
1537 <BLOCKQUOTE><CODE>
1538 <PRE>
1539  day &lt;number&gt;    - starting &lt;number&gt; days ago
1540  day &lt;from&gt;-&lt;to&gt; - &lt;from&gt; days &lt;to&gt; days ago
1541      &lt;from&gt;/&lt;to&gt;   
1542 </PRE>
1543 </CODE></BLOCKQUOTE>
1544 </P>
1545 <P>
1546 <BLOCKQUOTE><CODE>
1547 <PRE>
1548  info &lt;text&gt;     - any spots containing &lt;text&gt; in the info or remarks
1549 </PRE>
1550 </CODE></BLOCKQUOTE>
1551 </P>
1552 <P>
1553 <BLOCKQUOTE><CODE>
1554 <PRE>
1555  by &lt;call&gt;       - any spots spotted by &lt;call&gt; (spotter &lt;call&gt; is the 
1556                    same).
1557 </PRE>
1558 </CODE></BLOCKQUOTE>
1559 </P>
1560 <P>
1561 <BLOCKQUOTE><CODE>
1562 <PRE>
1563  qsl             - this automatically looks for any qsl info on the call
1564                    held in the spot database.
1565 </PRE>
1566 </CODE></BLOCKQUOTE>
1567 </P>
1568 <P>
1569 <BLOCKQUOTE><CODE>
1570 <PRE>
1571  iota [&lt;iota&gt;]   - If the iota island number is missing it will look for
1572                   the string iota and anything which looks like an iota
1573                   island number. If you specify then it will look for  
1574                   that island.
1575 </PRE>
1576 </CODE></BLOCKQUOTE>
1577 </P>
1578 <P>
1579 <BLOCKQUOTE><CODE>
1580 <PRE>
1581  qra [&lt;locator&gt;] - this will look for the specific locator if you specify
1582                    one or else anything that looks like a locator.
1583 </PRE>
1584 </CODE></BLOCKQUOTE>
1585 </P>
1586 <P>
1587 <BLOCKQUOTE><CODE>
1588 <PRE>
1589  dxcc            - treat the prefix as a 'country' and look for spots
1590                    from that country regardless of actual prefix.
1591                    eg dxcc oq2 
1592 </PRE>
1593 </CODE></BLOCKQUOTE>
1594 </P>
1595 <P>
1596 <BLOCKQUOTE><CODE>
1597 <PRE>
1598                    You can also use this with the 'by' keyword so 
1599                    eg by W dxcc  
1600 </PRE>
1601 </CODE></BLOCKQUOTE>
1602 </P>
1603 <P>
1604 <BLOCKQUOTE><CODE>
1605 <PRE>
1606  real or rt      - Format the output the same as for real time spots. The
1607                    formats are deliberately different (so you can tell
1608                    one sort from the other). This is useful for some 
1609                    logging programs that can't cope with normal sh/dx 
1610                    output. An alias of SHOW/FDX is available.
1611 </PRE>
1612 </CODE></BLOCKQUOTE>
1613 </P>
1614 <P>
1615 <BLOCKQUOTE><CODE>
1616 <PRE>
1617  filter          - Filter the spots, before output, with the user's 
1618                    spot filter. An alias of SHOW/MYDX is available.
1619 </PRE>
1620 </CODE></BLOCKQUOTE>
1621 </P>
1622 <P>
1623 <BLOCKQUOTE><CODE>
1624 <PRE>
1625  zone &lt;zones&gt;    - look for spots in the cq zone (or zones) specified.
1626                    zones are numbers separated by commas.
1627 </PRE>
1628 </CODE></BLOCKQUOTE>
1629 </P>
1630 <P>
1631 <BLOCKQUOTE><CODE>
1632 <PRE>
1633  by_zone &lt;zones&gt; - look for spots spotted by people in the cq zone
1634                    specified.
1635 </PRE>
1636 </CODE></BLOCKQUOTE>
1637 </P>
1638 <P>
1639 <BLOCKQUOTE><CODE>
1640 <PRE>
1641  itu &lt;itus&gt;      - look for spots in the itu zone (or zones) specified
1642                    itu zones are numbers separated by commas.
1643 </PRE>
1644 </CODE></BLOCKQUOTE>
1645 </P>
1646 <P>
1647 <BLOCKQUOTE><CODE>
1648 <PRE>
1649  by_itu &lt;itus&gt;   - look for spots spotted by people in the itu zone
1650                    specified.
1651 </PRE>
1652 </CODE></BLOCKQUOTE>
1653 </P>
1654 <P>
1655 <BLOCKQUOTE><CODE>
1656 <PRE>
1657  state &lt;list&gt;    - look for spots in the US state (or states) specified
1658                    The list is two letter state codes separated by commas.
1659 </PRE>
1660 </CODE></BLOCKQUOTE>
1661 </P>
1662 <P>
1663 <BLOCKQUOTE><CODE>
1664 <PRE>
1665  by_state &lt;list&gt; - look for spots spotted by people in the US state
1666                    specified.
1667 </PRE>
1668 </CODE></BLOCKQUOTE>
1669 </P>
1670 <P>
1671 <BLOCKQUOTE><CODE>
1672 <PRE>
1673  e.g. 
1674 </PRE>
1675 </CODE></BLOCKQUOTE>
1676 </P>
1677 <P>
1678 <BLOCKQUOTE><CODE>
1679 <PRE>
1680    SH/DX 9m0
1681    SH/DX on 20m info iota
1682    SH/DX 9a on vhf day 30
1683    SH/DX rf1p qsl
1684    SH/DX iota 
1685    SH/DX iota eu-064
1686    SH/DX qra jn86
1687    SH/DX dxcc oq2
1688    SH/DX dxcc oq2 by w dxcc
1689    SH/DX zone 4,5,6
1690    SH/DX by_zone 4,5,6
1691    SH/DX state in,oh
1692    SH/DX by_state in,oh
1693 </PRE>
1694 </CODE></BLOCKQUOTE>
1695 </P>
1696
1697 <H2><A NAME="ss12.90">12.90</A> <A HREF="usermanual_en.html#toc12.90">show/dxcc &lt;prefix&gt;</A>
1698 </H2>
1699
1700 <P><CODE><B>show/dxcc &lt;prefix&gt;</B> Interrogate the spot database by country</CODE></P>
1701
1702 <P>This command takes the &lt;prefix&gt; (which can be a full or partial 
1703 callsign if desired), looks up which internal country number it is
1704 and then displays all the spots as per SH/DX for that country.</P>
1705 <P>This is now an alias for 'SHOW/DX DXCC' </P>
1706 <P>The options for SHOW/DX also apply to this command.   
1707 e.g. </P>
1708 <P>
1709 <BLOCKQUOTE><CODE>
1710 <PRE>
1711    SH/DXCC G
1712    SH/DXCC W on 20m iota
1713 </PRE>
1714 </CODE></BLOCKQUOTE>
1715 </P>
1716 <P>This can be done with the SHOW/DX command like this:-</P>
1717 <P>
1718 <BLOCKQUOTE><CODE>
1719 <PRE>
1720    SH/DX dxcc g
1721    SH/DX dxcc w on 20m iota
1722 </PRE>
1723 </CODE></BLOCKQUOTE>
1724 </P>
1725 <P>This is an alias for: SH/DX dxcc</P>
1726 <H2><A NAME="ss12.91">12.91</A> <A HREF="usermanual_en.html#toc12.91">show/dxqsl &lt;callsign&gt;</A>
1727 </H2>
1728
1729 <P><CODE><B>show/dxqsl &lt;callsign&gt;</B> Show any QSL info gathered from spots</CODE></P>
1730
1731 <P>The node collects information from the comment fields in spots (things
1732 like 'VIA EA7WA' or 'QSL-G1TLH') and stores these in a database.</P>
1733 <P>This command allows you to interrogate that database and if the callsign
1734 is found will display the manager(s) that people have spotted. This 
1735 information is NOT reliable, but it is normally reasonably accurate if
1736 it is spotted enough times.</P>
1737 <P>For example:-</P>
1738 <P>
1739 <BLOCKQUOTE><CODE>
1740 <PRE>
1741   sh/dxqsl 4k9w
1742 </PRE>
1743 </CODE></BLOCKQUOTE>
1744 </P>
1745 <P>You can check the raw input spots yourself with:-</P>
1746 <P>
1747 <BLOCKQUOTE><CODE>
1748 <PRE>
1749   sh/dx 4k9w qsl
1750 </PRE>
1751 </CODE></BLOCKQUOTE>
1752 </P>
1753 <P>This gives you more background information.</P>
1754 <H2><A NAME="ss12.92">12.92</A> <A HREF="usermanual_en.html#toc12.92">show/dxstats [days] [date]</A>
1755 </H2>
1756
1757 <P><CODE><B>show/dxstats [days] [date]</B> Show the DX Statistics</CODE></P>
1758
1759 <P>Show the total DX spots for the last &lt;days&gt; no of days (default is 31), 
1760 starting from a &lt;date&gt; (default: today).</P>
1761 <H2><A NAME="ss12.93">12.93</A> <A HREF="usermanual_en.html#toc12.93">show/fdx</A>
1762 </H2>
1763
1764 <P><CODE><B>show/fdx</B> Show the DX data in realtime format.</CODE></P>
1765
1766 <P>Normally SHOW/DX outputs spot data in a different format to the
1767 realtime data. This is a deliberate policy (so you can tell the 
1768 difference between the two). Some logging programs cannot handle
1769 this so SHOW/FDX outputs historical data in real time format.</P>
1770 <P>This is an alias for: SHOW/DX real</P>
1771 <H2><A NAME="ss12.94">12.94</A> <A HREF="usermanual_en.html#toc12.94">show/files [&lt;filearea&gt; [&lt;string&gt;]]</A>
1772 </H2>
1773
1774 <P><CODE><B>show/files [&lt;filearea&gt; [&lt;string&gt;]]</B> List the contents of a filearea</CODE></P>
1775
1776 <P>SHOW/FILES on its own will show you a list of the various fileareas
1777 available on the system. To see the contents of a particular file
1778 area type:-
1779 <BLOCKQUOTE><CODE>
1780 <PRE>
1781    SH/FILES &lt;filearea&gt;
1782 </PRE>
1783 </CODE></BLOCKQUOTE>
1784
1785 where &lt;filearea&gt; is the name of the filearea you want to see the 
1786 contents of.</P>
1787 <P>You can also use shell globbing characters like '*' and '?' in a
1788 string to see a selection of files in a filearea eg:-
1789 <BLOCKQUOTE><CODE>
1790 <PRE>
1791    SH/FILES bulletins arld*
1792 </PRE>
1793 </CODE></BLOCKQUOTE>
1794 </P>
1795 <P>See also TYPE - to see the contents of a file.</P>
1796 <H2><A NAME="ss12.95">12.95</A> <A HREF="usermanual_en.html#toc12.95">show/filter</A>
1797 </H2>
1798
1799 <P><CODE><B>show/filter</B> Show the contents of all the filters you have set</CODE></P>
1800
1801 <P>Show the contents of all the filters that are set. This command displays
1802 all the filters set - for all the various categories.</P>
1803 <H2><A NAME="ss12.96">12.96</A> <A HREF="usermanual_en.html#toc12.96">show/hfstats [days] [date]</A>
1804 </H2>
1805
1806 <P><CODE><B>show/hfstats [days] [date]</B> Show the HF DX Statistics </CODE></P>
1807
1808 <P>Show the HF DX spots breakdown by band for the last &lt;days&gt; no of days 
1809 (default is 31), starting from a &lt;date&gt; (default: today).</P>
1810 <H2><A NAME="ss12.97">12.97</A> <A HREF="usermanual_en.html#toc12.97">show/hftable [days] [date] [prefix ...]</A>
1811 </H2>
1812
1813 <P><CODE><B>show/hftable [days] [date] [prefix ...]</B> Show the HF DX Spotter Table</CODE></P>
1814
1815 <P>Show the HF DX Spotter table for the list of prefixes for the last 
1816 &lt;days&gt; no of days (default is 31), starting from a &lt;date&gt; (default: today).</P>
1817 <P>If there are no prefixes then it will show the table for your country.</P>
1818 <P>Remember that some countries have more than one "DXCC country" in them
1819 (eg G :-), to show them (assuming you are not in G already which is
1820 specially treated in the code) you must list all the relevant prefixes</P>
1821 <P>
1822 <BLOCKQUOTE><CODE>
1823 <PRE>
1824   sh/hftable g gm gd gi gj gw gu 
1825 </PRE>
1826 </CODE></BLOCKQUOTE>
1827 </P>
1828 <P>Note that the prefixes are converted into country codes so you don't have
1829 to list all possible prefixes for each country.</P>
1830 <P>If you want more or less days than the default simply include the
1831 number you require:-</P>
1832 <P>
1833 <BLOCKQUOTE><CODE>
1834 <PRE>
1835   sh/hftable 20 pa
1836 </PRE>
1837 </CODE></BLOCKQUOTE>
1838 </P>
1839 <P>If you want to start at a different day, simply add the date in some 
1840 recognizable form:-</P>
1841 <P>
1842 <BLOCKQUOTE><CODE>
1843 <PRE>
1844   sh/hftable 2 25nov02
1845   sh/hftable 2 25-nov-02 
1846   sh/hftable 2 021125 
1847   sh/hftable 2 25/11/02
1848 </PRE>
1849 </CODE></BLOCKQUOTE>
1850 </P>
1851 <P>This will show the stats for your DXCC for that CQWW contest weekend. </P>
1852 <P>You can specify either prefixes or full callsigns (so you can see how you
1853 did against all your mates). You can also say 'all' which will then print
1854 the worldwide statistics.</P>
1855 <P>
1856 <BLOCKQUOTE><CODE>
1857 <PRE>
1858   sh/hftable all 
1859 </PRE>
1860 </CODE></BLOCKQUOTE>
1861 </P>
1862
1863 <H2><A NAME="ss12.98">12.98</A> <A HREF="usermanual_en.html#toc12.98">show/moon [ndays] [&lt;prefix&gt;|&lt;callsign&gt;]</A>
1864 </H2>
1865
1866 <P><CODE><B>show/moon [ndays] [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show Moon rise and set times</CODE></P>
1867
1868 <P>Show the Moon rise and set times for a (list of) prefixes or callsigns, 
1869 together with the azimuth and elevation of the sun currently at those
1870 locations.</P>
1871 <P>If you don't specify any prefixes or callsigns, it will show the times for
1872 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
1873 together with the current azimuth and elevation.</P>
1874 <P>In addition, it will show the illuminated fraction of the moons disk.</P>
1875 <P>If all else fails it will show the Moonrise and set times for the node
1876 that you are connected to. </P>
1877 <P>For example:-</P>
1878 <P>
1879 <BLOCKQUOTE><CODE>
1880 <PRE>
1881   SH/MOON
1882   SH/MOON G1TLH W5UN
1883 </PRE>
1884 </CODE></BLOCKQUOTE>
1885 </P>
1886 <P>You can also use this command to see into the past or the future, so
1887 if you want to see yesterday's times then do:-</P>
1888 <P>
1889 <BLOCKQUOTE><CODE>
1890 <PRE>
1891   SH/MOON -1 
1892 </PRE>
1893 </CODE></BLOCKQUOTE>
1894 </P>
1895 <P>or in three days time:-</P>
1896 <P>
1897 <BLOCKQUOTE><CODE>
1898 <PRE>
1899   SH/MOON +3 W9
1900 </PRE>
1901 </CODE></BLOCKQUOTE>
1902 </P>
1903 <P>Upto 366 days can be checked both in the past and in the future.</P>
1904 <P>Please note that the rise and set times are given as the UT times of rise and 
1905 set on the requested UT day.</P>
1906 <H2><A NAME="ss12.99">12.99</A> <A HREF="usermanual_en.html#toc12.99">show/muf &lt;prefix&gt; [&lt;hours&gt;][long]</A>
1907 </H2>
1908
1909 <P><CODE><B>show/muf &lt;prefix&gt; [&lt;hours&gt;][long]</B> Show the likely propagation to a prefix</CODE></P>
1910
1911 <P>This command allow you to estimate the likelihood of you contacting
1912 a station with the prefix you have specified. The output assumes a modest
1913 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)</P>
1914 <P>The result predicts the most likely operating frequencies and signal
1915 levels for high frequency (shortwave) radio propagation paths on
1916 specified days of the year and hours of the day. It is most useful for
1917 paths between 250 km and 6000 km, but can be used with reduced accuracy
1918 for paths shorter or longer than this.</P>
1919 <P>The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
1920 used to predict the MUF given the predicted flux, day of the year,
1921 hour of the day and geographic coordinates of the transmitter and
1922 receiver. This routine is reasonably accurate for the purposes here,
1923 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
1924 than the programs used by major shortwave broadcasting organizations,
1925 such as the Voice of America.</P>
1926 <P>The command will display some header information detailing its
1927 assumptions, together with the locations, latitude and longitudes and
1928 bearings. It will then show UTC (UT), local time at the other end
1929 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
1930 (Zen) and the likely signal strengths. Then for each frequency for which
1931 the system thinks there is a likelihood of a circuit it prints a value.</P>
1932 <P>The value is currently a likely S meter reading based on the conventional
1933 6dB / S point scale. If the value has a '+' appended it means that it is
1934 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
1935 there is likely to be much fading and by an 's' that the signal is likely
1936 to be noisy.  </P>
1937 <P>By default SHOW/MUF will show the next two hours worth of data. You
1938 can specify anything up to 24 hours worth of data by appending the no of
1939 hours required after the prefix. For example:-</P>
1940 <P>
1941 <BLOCKQUOTE><CODE>
1942 <PRE>
1943   SH/MUF W
1944 </PRE>
1945 </CODE></BLOCKQUOTE>
1946 </P>
1947 <P>produces:</P>
1948 <P>
1949 <BLOCKQUOTE><CODE>
1950 <PRE>
1951   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
1952   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
1953   Location                       Lat / Long           Azim
1954   East Dereham, Norfolk          52 41 N 0 57 E         47
1955   United-States-W                43 0 N 87 54 W        299
1956   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
1957   18 23 11.5 -35  mS0+ mS2   S3
1958   19  0 11.2 -41  mS0+ mS2   S3
1959 </PRE>
1960 </CODE></BLOCKQUOTE>
1961 </P>
1962 <P>indicating that you will have weak, fading circuits on top band and 
1963 80m but usable signals on 40m (about S3).</P>
1964 <P>inputing:-</P>
1965 <P>
1966 <BLOCKQUOTE><CODE>
1967 <PRE>
1968   SH/MUF W 24
1969 </PRE>
1970 </CODE></BLOCKQUOTE>
1971 </P>
1972 <P>will get you the above display, but with the next 24 hours worth of
1973 propagation data.</P>
1974 <P>
1975 <BLOCKQUOTE><CODE>
1976 <PRE>
1977   SH/MUF W L 24
1978   SH/MUF W 24 Long
1979 </PRE>
1980 </CODE></BLOCKQUOTE>
1981 </P>
1982 <P>Gives you an estimate of the long path propagation characterics. It
1983 should be noted that the figures will probably not be very useful, nor
1984 terrible accurate, but it is included for completeness.</P>
1985 <H2><A NAME="ss12.100">12.100</A> <A HREF="usermanual_en.html#toc12.100">show/mydx</A>
1986 </H2>
1987
1988 <P><CODE><B>show/mydx</B> Show the DX data filtered with your spot filter.</CODE></P>
1989
1990 <P>SHOW/DX potentially shows all the spots available in the system. Using
1991 SHOW/MYDX will, instead, filter the availble spots using any spot filter 
1992 that you have set, first. </P>
1993 <P>This command, together with ACCEPT/SPOT or REJECT/SPOT, will allow
1994 you to customise the spots that you receive.</P>
1995 <P>So if you have said: ACC/SPOT on hf</P>
1996 <P>Doing a SHOW/MYDX will now only, ever, show HF spots. All the other 
1997 options on SH/DX can still be used.</P>
1998 <H2><A NAME="ss12.101">12.101</A> <A HREF="usermanual_en.html#toc12.101">show/newconfiguration [&lt;node&gt;]</A>
1999 </H2>
2000
2001 <P><CODE><B>show/newconfiguration [&lt;node&gt;]</B> Show all the nodes and users visible</CODE></P>
2002
2003 <P>This command allows you to see all the users that can be seen
2004 and the nodes to which they are connected. </P>
2005 <P>This command produces essentially the same information as 
2006 SHOW/CONFIGURATION except that it shows all the duplication of
2007 any routes that might be present It also uses a different format
2008 which may not take up quite as much space if you don't have any
2009 loops.</P>
2010 <P>BE WARNED: the list that is returned can be VERY long</P>
2011 <H2><A NAME="ss12.102">12.102</A> <A HREF="usermanual_en.html#toc12.102">show/newconfiguration/node</A>
2012 </H2>
2013
2014 <P><CODE><B>show/newconfiguration/node</B> Show all the nodes connected locally</CODE></P>
2015
2016 <P>Show all the nodes connected to this node in the new format.</P>
2017 <H2><A NAME="ss12.103">12.103</A> <A HREF="usermanual_en.html#toc12.103">show/prefix &lt;callsign&gt;</A>
2018 </H2>
2019
2020 <P><CODE><B>show/prefix &lt;callsign&gt;</B> Interrogate the prefix database </CODE></P>
2021
2022 <P>This command takes the &lt;callsign&gt; (which can be a full or partial 
2023 callsign or a prefix), looks up which internal country number 
2024 it is and then displays all the relevant prefixes for that country
2025 together with the internal country no, the CQ and ITU regions. </P>
2026 <P>See also SHOW/DXCC</P>
2027 <H2><A NAME="ss12.104">12.104</A> <A HREF="usermanual_en.html#toc12.104">show/qra &lt;lat&gt; &lt;long&gt;</A>
2028 </H2>
2029
2030 <P><CODE><B>show/qra &lt;lat&gt; &lt;long&gt;</B> Convert lat/long to a QRA Grid locator</CODE></P>
2031
2032 <P>This is a multipurpose command that allows you either to calculate the
2033 distance and bearing between two locators or (if only one locator is
2034 given on the command line) the distance and beraing from your station
2035 to the locator. For example:-</P>
2036 <P>
2037 <BLOCKQUOTE><CODE>
2038 <PRE>
2039  SH/QRA IO92QL 
2040  SH/QRA JN06 IN73
2041 </PRE>
2042 </CODE></BLOCKQUOTE>
2043 </P>
2044 <P>The first example will show the distance and bearing to the locator from
2045 yourself, the second example will calculate the distance and bearing from
2046 the first locator to the second. You can use 4 or 6 character locators.</P>
2047 <P>It is also possible to convert a latitude and longitude to a locator by 
2048 using this command with a latitude and longitude as an argument, for
2049 example:-</P>
2050 <P>
2051 <BLOCKQUOTE><CODE>
2052 <PRE>
2053  SH/QRA 52 41 N 0 58 E
2054 </PRE>
2055 </CODE></BLOCKQUOTE>
2056 </P>
2057
2058 <H2><A NAME="ss12.105">12.105</A> <A HREF="usermanual_en.html#toc12.105">show/qra &lt;locator&gt; [&lt;locator&gt;]</A>
2059 </H2>
2060
2061 <P><CODE><B>show/qra &lt;locator&gt; [&lt;locator&gt;]</B> Show distance between QRA Grid locators</CODE></P>
2062
2063
2064 <H2><A NAME="ss12.106">12.106</A> <A HREF="usermanual_en.html#toc12.106">show/qrz &lt;callsign&gt;</A>
2065 </H2>
2066
2067 <P><CODE><B>show/qrz &lt;callsign&gt;</B> Show any callbook details on a callsign</CODE></P>
2068
2069 <P>This command queries the QRZ callbook server on the internet
2070 and returns any information available for that callsign. This service
2071 is provided for users of this software by http://www.qrz.com </P>
2072 <P>See also SHOW/WM7D for an alternative.</P>
2073 <H2><A NAME="ss12.107">12.107</A> <A HREF="usermanual_en.html#toc12.107">show/route &lt;callsign&gt; ...</A>
2074 </H2>
2075
2076 <P><CODE><B>show/route &lt;callsign&gt; ...</B> Show the route to the callsign</CODE></P>
2077
2078 <P>This command allows you to see to which node the callsigns specified are
2079 connected. It is a sort of inverse sh/config.</P>
2080 <P>
2081 <BLOCKQUOTE><CODE>
2082 <PRE>
2083  sh/route n2tly
2084 </PRE>
2085 </CODE></BLOCKQUOTE>
2086 </P>
2087
2088 <H2><A NAME="ss12.108">12.108</A> <A HREF="usermanual_en.html#toc12.108">show/satellite &lt;name&gt; [&lt;hours&gt; &lt;interval&gt;]</A>
2089 </H2>
2090
2091 <P><CODE><B>show/satellite &lt;name&gt; [&lt;hours&gt; &lt;interval&gt;]</B> Show tracking data</CODE></P>
2092
2093 <P>Show the tracking data from your location to the satellite of your choice
2094 from now on for the next few hours.</P>
2095 <P>If you use this command without a satellite name it will display a list
2096 of all the satellites known currently to the system. </P>
2097 <P>If you give a name then you can obtain tracking data of all the passes
2098 that start and finish 5 degrees below the horizon. As default it will
2099 give information for the next three hours for every five minute period.</P>
2100 <P>You can alter the number of hours and the step size, within certain 
2101 limits. </P>
2102 <P>Each pass in a period is separated with a row of '-----' characters</P>
2103 <P>So for example:-</P>
2104 <P>
2105 <BLOCKQUOTE><CODE>
2106 <PRE>
2107  SH/SAT AO-10 
2108  SH/SAT FENGYUN1 12 2
2109 </PRE>
2110 </CODE></BLOCKQUOTE>
2111 </P>
2112
2113 <H2><A NAME="ss12.109">12.109</A> <A HREF="usermanual_en.html#toc12.109">show/station [&lt;callsign&gt; ..]</A>
2114 </H2>
2115
2116 <P><CODE><B>show/station [&lt;callsign&gt; ..]</B> Show information about a callsign</CODE></P>
2117
2118 <P>Show the information known about a callsign and whether (and where)
2119 that callsign is connected to the cluster.</P>
2120 <P>
2121 <BLOCKQUOTE><CODE>
2122 <PRE>
2123   SH/ST G1TLH
2124 </PRE>
2125 </CODE></BLOCKQUOTE>
2126 </P>
2127 <P>If no callsign is given then show the information for yourself.</P>
2128 <H2><A NAME="ss12.110">12.110</A> <A HREF="usermanual_en.html#toc12.110">show/sun [ndays] [&lt;prefix&gt;|&lt;callsign&gt;]</A>
2129 </H2>
2130
2131 <P><CODE><B>show/sun [ndays] [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show sun rise and set times</CODE></P>
2132
2133 <P>Show the sun rise and set times for a (list of) prefixes or callsigns, 
2134 together with the azimuth and elevation of the sun currently at those
2135 locations.</P>
2136 <P>If you don't specify any prefixes or callsigns, it will show the times for
2137 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
2138 together with the current azimuth and elevation.</P>
2139 <P>If all else fails it will show the sunrise and set times for the node
2140 that you are connected to. </P>
2141 <P>For example:-</P>
2142 <P>
2143 <BLOCKQUOTE><CODE>
2144 <PRE>
2145   SH/SUN
2146   SH/SUN G1TLH K9CW ZS
2147 </PRE>
2148 </CODE></BLOCKQUOTE>
2149 </P>
2150 <P>You can also use this command to see into the past or the future, so
2151 if you want to see yesterday's times then do:-</P>
2152 <P>
2153 <BLOCKQUOTE><CODE>
2154 <PRE>
2155   SH/SUN -1 
2156 </PRE>
2157 </CODE></BLOCKQUOTE>
2158 </P>
2159 <P>or in three days time:-</P>
2160 <P>
2161 <BLOCKQUOTE><CODE>
2162 <PRE>
2163   SH/SUN +3 W9
2164 </PRE>
2165 </CODE></BLOCKQUOTE>
2166 </P>
2167 <P>Upto 366 days can be checked both in the past and in the future.</P>
2168 <P>Please note that the rise and set times are given as the UT times of rise 
2169 and set on the requested UT day.</P>
2170 <H2><A NAME="ss12.111">12.111</A> <A HREF="usermanual_en.html#toc12.111">show/time [&lt;prefix&gt;|&lt;callsign&gt;]</A>
2171 </H2>
2172
2173 <P><CODE><B>show/time [&lt;prefix&gt;|&lt;callsign&gt;]</B> Show the local time </CODE></P>
2174
2175 <P>If no prefixes or callsigns are given then this command returns the local
2176 time and UTC as the computer has it right now. If you give some prefixes
2177 then it will show UTC and UTC + the local offset (not including DST) at
2178 the prefixes or callsigns that you specify.</P>
2179 <H2><A NAME="ss12.112">12.112</A> <A HREF="usermanual_en.html#toc12.112">show/usdb [call ..]</A>
2180 </H2>
2181
2182 <P><CODE><B>show/usdb [call ..]</B> Show information held on the FCC Call database</CODE></P>
2183
2184 <P>Show the City and State of a Callsign held on the FCC database if
2185 his is being run on this system, eg:-</P>
2186 <P>
2187 <BLOCKQUOTE><CODE>
2188 <PRE>
2189   sh/usdb k1xx
2190 </PRE>
2191 </CODE></BLOCKQUOTE>
2192 </P>
2193
2194 <H2><A NAME="ss12.113">12.113</A> <A HREF="usermanual_en.html#toc12.113">show/vhfstats [days] [date]</A>
2195 </H2>
2196
2197 <P><CODE><B>show/vhfstats [days] [date]</B> Show the VHF DX Statistics</CODE></P>
2198
2199 <P>Show the VHF DX spots breakdown by band for the last 
2200 &lt;days&gt; no of days (default is 31), starting from a date (default: today).</P>
2201 <H2><A NAME="ss12.114">12.114</A> <A HREF="usermanual_en.html#toc12.114">show/vhftable [days] [date] [prefix ...]</A>
2202 </H2>
2203
2204 <P><CODE><B>show/vhftable [days] [date] [prefix ...]</B> Show the VHF DX Spotter Table</CODE></P>
2205
2206 <P>Show the VHF DX Spotter table for the list of prefixes for the last 
2207 &lt;days&gt; no of days (default is 31), starting from a date (default: today).</P>
2208 <P>If there are no prefixes then it will show the table for your country.</P>
2209 <P>Remember that some countries have more than one "DXCC country" in them
2210 (eg G :-), to show them (assuming you are not in G already which is
2211 specially treated in the code) you must list all the relevant prefixes</P>
2212 <P>
2213 <BLOCKQUOTE><CODE>
2214 <PRE>
2215   sh/vhftable g gm gd gi gj gw gu 
2216 </PRE>
2217 </CODE></BLOCKQUOTE>
2218 </P>
2219 <P>Note that the prefixes are converted into country codes so you don't have
2220 to list all possible prefixes for each country.</P>
2221 <P>If you want more or less days than the default simply include the
2222 number you require:-</P>
2223 <P>
2224 <BLOCKQUOTE><CODE>
2225 <PRE>
2226   sh/vhftable 20 pa
2227 </PRE>
2228 </CODE></BLOCKQUOTE>
2229 </P>
2230 <P>If you want to start at a different day, simply add the date in some 
2231 recognizable form:-</P>
2232 <P>
2233 <BLOCKQUOTE><CODE>
2234 <PRE>
2235   sh/vhftable 2 25nov02
2236   sh/vhftable 2 25-nov-02 
2237   sh/vhftable 2 021125 
2238   sh/vhftable 2 25/11/02
2239 </PRE>
2240 </CODE></BLOCKQUOTE>
2241 </P>
2242 <P>This will show the stats for your DXCC for that CQWW contest weekend. </P>
2243 <P>You can specify either prefixes or full callsigns (so you can see how you
2244 did against all your mates). You can also say 'all' which will then print
2245 the worldwide statistics.</P>
2246 <P>
2247 <BLOCKQUOTE><CODE>
2248 <PRE>
2249   sh/vhftable all 
2250 </PRE>
2251 </CODE></BLOCKQUOTE>
2252 </P>
2253
2254 <H2><A NAME="ss12.115">12.115</A> <A HREF="usermanual_en.html#toc12.115">show/wcy</A>
2255 </H2>
2256
2257 <P><CODE><B>show/wcy</B> Show last 10 WCY broadcasts</CODE></P>
2258
2259
2260 <H2><A NAME="ss12.116">12.116</A> <A HREF="usermanual_en.html#toc12.116">show/wcy &lt;n&gt;</A>
2261 </H2>
2262
2263 <P><CODE><B>show/wcy &lt;n&gt;</B> Show last &lt;n&gt; WCY broadcasts</CODE></P>
2264
2265 <P>Display the most recent WCY information that has been received by the system</P>
2266
2267 <H2><A NAME="ss12.117">12.117</A> <A HREF="usermanual_en.html#toc12.117">show/wm7d &lt;callsign&gt;</A>
2268 </H2>
2269
2270 <P><CODE><B>show/wm7d &lt;callsign&gt;</B> Show callbook details on a US callsigns</CODE></P>
2271
2272 <P>This command queries the WM7D callbook server on the internet
2273 and returns any information available for that US callsign. This service
2274 is provided for users of this software by http://www.wm7d.net.</P>
2275 <P>See also SHOW/QRZ. </P>
2276 <H2><A NAME="ss12.118">12.118</A> <A HREF="usermanual_en.html#toc12.118">show/wwv</A>
2277 </H2>
2278
2279 <P><CODE><B>show/wwv</B> Show last 10 WWV broadcasts</CODE></P>
2280
2281
2282 <H2><A NAME="ss12.119">12.119</A> <A HREF="usermanual_en.html#toc12.119">show/wwv &lt;n&gt;</A>
2283 </H2>
2284
2285 <P><CODE><B>show/wwv &lt;n&gt;</B> Show last &lt;n&gt; WWV broadcasts</CODE></P>
2286
2287 <P>Display the most recent WWV information that has been received by the system</P>
2288 <H2><A NAME="ss12.120">12.120</A> <A HREF="usermanual_en.html#toc12.120">sysop</A>
2289 </H2>
2290
2291 <P><CODE><B>sysop</B> Regain your privileges if you login remotely</CODE></P>
2292
2293 <P>The system automatically reduces your privilege level to that of a
2294 normal user if you login in remotely. This command allows you to
2295 regain your normal privilege level. It uses the normal system: five
2296 numbers are returned that are indexes into the character array that is
2297 your assigned password (see SET/PASSWORD). The indexes start from
2298 zero.</P>
2299 <P>You are expected to return a string which contains the characters
2300 required in the correct order. You may intersperse those characters
2301 with others to obscure your reply for any watchers. For example (and
2302 these values are for explanation :-):</P>
2303 <P>
2304 <BLOCKQUOTE><CODE>
2305 <PRE>
2306   password = 012345678901234567890123456789
2307   &gt; sysop
2308   22 10 15 17 3
2309 </PRE>
2310 </CODE></BLOCKQUOTE>
2311
2312 you type:-
2313 <BLOCKQUOTE><CODE>
2314 <PRE>
2315  aa2bbbb0ccc5ddd7xxx3n
2316  or 2 0 5 7 3
2317  or 20573
2318 </PRE>
2319 </CODE></BLOCKQUOTE>
2320 </P>
2321 <P>They will all match. If there is no password you will still be offered
2322 numbers but nothing will happen when you input a string. Any match is
2323 case sensitive.</P>
2324 <H2><A NAME="ss12.121">12.121</A> <A HREF="usermanual_en.html#toc12.121">talk &lt;call&gt; &gt; &lt;node&gt; [&lt;text&gt;]</A>
2325 </H2>
2326
2327 <P><CODE><B>talk &lt;call&gt; &gt; &lt;node&gt; [&lt;text&gt;]</B> Send a text message to another station via a node</CODE></P>
2328
2329 <P>Send a short message to any other station that is visible on the cluster
2330 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
2331 command, they don't have to be connected locally.</P>
2332 <P>The second form of TALK is used when other cluster nodes are connected
2333 with restricted information. This usually means that they don't send 
2334 the user information usually associated with logging on and off the cluster.</P>
2335 <P>If you know that G3JNB is likely to be present on GB7TLH, but you can only
2336 see GB7TLH in the SH/C list but with no users, then you would use the
2337 second form of the talk message.</P>
2338 <P>If you want to have a ragchew with someone you can leave the text message
2339 out and the system will go into 'Talk' mode. What this means is that a
2340 short message is sent to the recipient telling them that you are in a
2341 'Talking' frame of mind and then you just type - everything you send will
2342 go to the station that you asked for. </P>
2343 <P>All the usual announcements, spots and so on will still come out on your
2344 terminal.</P>
2345 <P>If you want to do something (such as send a spot) you preceed the normal 
2346 command with a '/' character, eg:-</P>
2347 <P>
2348 <BLOCKQUOTE><CODE>
2349 <PRE>
2350    /DX 14001 G1TLH What's a B class licensee doing on 20m CW?
2351    /HELP talk
2352 </PRE>
2353 </CODE></BLOCKQUOTE>
2354 </P>
2355 <P>To leave talk mode type:</P>
2356 <P>
2357 <BLOCKQUOTE><CODE>
2358 <PRE>
2359    /EX
2360 </PRE>
2361 </CODE></BLOCKQUOTE>
2362 </P>
2363 <P>If you are in 'Talk' mode, there is an extention to the '/' command which
2364 allows you to send the output to all the people you are talking to. You do 
2365 with the '//' command. For example:-</P>
2366 <P>
2367 <BLOCKQUOTE><CODE>
2368 <PRE>
2369   //sh/hftable
2370 </PRE>
2371 </CODE></BLOCKQUOTE>
2372 </P>
2373 <P>will send the hftable as you have it to all the people you are currently 
2374 talking to.</P>
2375 <H2><A NAME="ss12.122">12.122</A> <A HREF="usermanual_en.html#toc12.122">talk &lt;call&gt; [&lt;text&gt;]</A>
2376 </H2>
2377
2378 <P><CODE><B>talk &lt;call&gt; [&lt;text&gt;]</B> Send a text message to another station</CODE></P>
2379
2380
2381 <H2><A NAME="ss12.123">12.123</A> <A HREF="usermanual_en.html#toc12.123">type &lt;filearea&gt;/&lt;name&gt;</A>
2382 </H2>
2383
2384 <P><CODE><B>type &lt;filearea&gt;/&lt;name&gt;</B> Look at the contents of a file in one of the fileareas</CODE></P>
2385
2386 <P>Type out the contents of a file in a filearea. So, for example, in 
2387 filearea 'bulletins' you want to look at file 'arld051' you would 
2388 enter:-
2389 <BLOCKQUOTE><CODE>
2390 <PRE>
2391    TYPE bulletins/arld051
2392 </PRE>
2393 </CODE></BLOCKQUOTE>
2394 </P>
2395 <P>See also SHOW/FILES to see what fileareas are available and a 
2396 list of content.</P>
2397 <H2><A NAME="ss12.124">12.124</A> <A HREF="usermanual_en.html#toc12.124">unset/announce</A>
2398 </H2>
2399
2400 <P><CODE><B>unset/announce</B> Stop announce messages coming out on your terminal</CODE></P>
2401
2402
2403 <H2><A NAME="ss12.125">12.125</A> <A HREF="usermanual_en.html#toc12.125">unset/anntalk</A>
2404 </H2>
2405
2406 <P><CODE><B>unset/anntalk</B> Stop talk like announce messages on your terminal</CODE></P>
2407
2408 <P>The announce system on legacy cluster nodes is used as a talk 
2409 substitute because the network is so poorly connected. If you:</P>
2410 <P>
2411 <BLOCKQUOTE><CODE>
2412 <PRE>
2413   unset/anntalk
2414 </PRE>
2415 </CODE></BLOCKQUOTE>
2416 </P>
2417 <P>you will suppress several of these announces, you may miss the odd 
2418 useful one as well, but you would probably miss them anyway in the
2419 welter of useless ones.</P>
2420 <P>
2421 <BLOCKQUOTE><CODE>
2422 <PRE>
2423   set/anntalk 
2424 </PRE>
2425 </CODE></BLOCKQUOTE>
2426 </P>
2427 <P>allows you to see them again. This is the default.</P>
2428 <H2><A NAME="ss12.126">12.126</A> <A HREF="usermanual_en.html#toc12.126">unset/beep</A>
2429 </H2>
2430
2431 <P><CODE><B>unset/beep</B> Stop beeps for DX and other messages on your terminal</CODE></P>
2432
2433
2434 <H2><A NAME="ss12.127">12.127</A> <A HREF="usermanual_en.html#toc12.127">unset/dx</A>
2435 </H2>
2436
2437 <P><CODE><B>unset/dx</B> Stop DX messages coming out on your terminal</CODE></P>
2438
2439
2440 <H2><A NAME="ss12.128">12.128</A> <A HREF="usermanual_en.html#toc12.128">unset/dxcq</A>
2441 </H2>
2442
2443 <P><CODE><B>unset/dxcq</B> Stop CQ Zones on the end of DX announcements</CODE></P>
2444
2445 <P>Display both the Spotter's and the Spotted's CQ Zone on the end
2446 of a DX announcement (there is just enough room). Some user programs
2447 cannot cope with this. The Spotter's CQ is on the RHS of the 
2448 time, the Spotted's CQ is on the LHS.</P>
2449 <P>Conflicts with: SET/DXGRID, SET/DXITU, SHOW/USSTATE</P>
2450 <P>Do a STAT/USER to see which flags you have set if you are confused.  </P>
2451 <H2><A NAME="ss12.129">12.129</A> <A HREF="usermanual_en.html#toc12.129">unset/dxgrid</A>
2452 </H2>
2453
2454 <P><CODE><B>unset/dxgrid</B> Stop QRA Grid Squares on the end of DX announcements</CODE></P>
2455
2456 <P>A standard feature which is enabled in version 1.43 and above is 
2457 that if the spotter's grid square is known it is output on the end
2458 of a DX announcement (there is just enough room). Some user programs
2459 cannot cope with this. You can use this command to reset (or set)
2460 this feature.</P>
2461 <P>Conflicts with: SET/DXCQ, SET/DXITU</P>
2462 <P>Do a STAT/USER to see which flags you have set if you are confused.  </P>
2463 <H2><A NAME="ss12.130">12.130</A> <A HREF="usermanual_en.html#toc12.130">unset/dxitu</A>
2464 </H2>
2465
2466 <P><CODE><B>unset/dxitu</B> Stop ITU Zones on the end of DX announcements</CODE></P>
2467
2468 <P>Display both the Spotter's and the Spotted's ITU Zone on the end
2469 of a DX announcement (there is just enough room). Some user programs
2470 cannot cope with this. The Spotter's ITU is on the RHS of the 
2471 time, the Spotted's ITU is on the LHS.</P>
2472 <P>Conflicts with: SET/DXGRID, SET/DXCQ, SHOW/USSTATE</P>
2473 <P>Do a STAT/USER to see which flags you have set if you are confused.  </P>
2474 <H2><A NAME="ss12.131">12.131</A> <A HREF="usermanual_en.html#toc12.131">unset/echo</A>
2475 </H2>
2476
2477 <P><CODE><B>unset/echo</B> Stop the cluster echoing your input</CODE></P>
2478
2479 <P>If you are connected via a telnet session, different implimentations
2480 of telnet handle echo differently depending on whether you are 
2481 connected via port 23 or some other port. You can use this command
2482 to change the setting appropriately. </P>
2483 <P>The setting is stored in your user profile.</P>
2484 <P>YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.</P>
2485 <H2><A NAME="ss12.132">12.132</A> <A HREF="usermanual_en.html#toc12.132">unset/email</A>
2486 </H2>
2487
2488 <P><CODE><B>unset/email</B> Stop personal msgs being forwarded by email</CODE></P>
2489
2490 <P>If any personal messages come in for your callsign then you can use
2491 these commands to control whether they are forwarded onto your email
2492 address. To enable the forwarding do something like:-</P>
2493 <P>
2494 <BLOCKQUOTE><CODE>
2495 <PRE>
2496   SET/EMAIL mike.tubby@somewhere.com
2497 </PRE>
2498 </CODE></BLOCKQUOTE>
2499 </P>
2500 <P>You can have more than one email address (each one separated by a space).
2501 Emails are forwarded to all the email addresses you specify.</P>
2502 <P>You can disable forwarding by:-</P>
2503 <P>
2504 <BLOCKQUOTE><CODE>
2505 <PRE>
2506   UNSET/EMAIL
2507 </PRE>
2508 </CODE></BLOCKQUOTE>
2509 </P>
2510
2511 <H2><A NAME="ss12.133">12.133</A> <A HREF="usermanual_en.html#toc12.133">unset/here</A>
2512 </H2>
2513
2514 <P><CODE><B>unset/here</B> Tell the system you are absent from your terminal</CODE></P>
2515
2516
2517 <H2><A NAME="ss12.134">12.134</A> <A HREF="usermanual_en.html#toc12.134">unset/logininfo</A>
2518 </H2>
2519
2520 <P><CODE><B>unset/logininfo</B> Inform when a station logs out locally</CODE></P>
2521
2522
2523 <H2><A NAME="ss12.135">12.135</A> <A HREF="usermanual_en.html#toc12.135">unset/privilege</A>
2524 </H2>
2525
2526 <P><CODE><B>unset/privilege</B> Remove any privilege for this session</CODE></P>
2527
2528 <P>You can use this command to 'protect' this session from unauthorised
2529 use. If you want to get your normal privilege back you will need to
2530 either logout and login again (if you are on a console) or use the
2531 SYSOP command.</P>
2532 <H2><A NAME="ss12.136">12.136</A> <A HREF="usermanual_en.html#toc12.136">unset/prompt</A>
2533 </H2>
2534
2535 <P><CODE><B>unset/prompt</B> Set your prompt back to default</CODE></P>
2536
2537 <P>This command will set your user prompt to exactly the string that you 
2538 say. The point of this command to enable a user to interface to programs
2539 that are looking for a specific prompt (or else you just want a different
2540 fixed prompt).</P>
2541 <P>
2542 <BLOCKQUOTE><CODE>
2543 <PRE>
2544   SET/PROMPT clx &gt;
2545 </PRE>
2546 </CODE></BLOCKQUOTE>
2547 </P>
2548 <P>UNSET/PROMPT will undo the SET/PROMPT command and set you prompt back to
2549 normal.</P>
2550 <H2><A NAME="ss12.137">12.137</A> <A HREF="usermanual_en.html#toc12.137">unset/talk</A>
2551 </H2>
2552
2553 <P><CODE><B>unset/talk</B> Stop TALK messages coming out on your terminal</CODE></P>
2554
2555
2556 <H2><A NAME="ss12.138">12.138</A> <A HREF="usermanual_en.html#toc12.138">unset/usstate</A>
2557 </H2>
2558
2559 <P><CODE><B>unset/usstate</B> Stop US State info on the end of DX announcements</CODE></P>
2560
2561 <P>If the spotter's or spotted's US State is known it is output on the 
2562 end of a DX announcement (there is just enough room). </P>
2563 <P>A spotter's state will appear on the RHS of the time (like 
2564 SET/DXGRID) and the spotted's State will appear on the LHS of the
2565 time field. Any information found will override any locator 
2566 information from SET/DXGRID.</P>
2567 <P>Some user programs cannot cope with this. You can use this command 
2568 to reset (or set) this feature.</P>
2569 <P>Conflicts with: SET/DXCQ, SET/DXITU</P>
2570 <P>Do a STAT/USER to see which flags you have set if you are confused.  </P>
2571 <H2><A NAME="ss12.139">12.139</A> <A HREF="usermanual_en.html#toc12.139">unset/wcy</A>
2572 </H2>
2573
2574 <P><CODE><B>unset/wcy</B> Stop WCY messages coming out on your terminal</CODE></P>
2575
2576
2577 <H2><A NAME="ss12.140">12.140</A> <A HREF="usermanual_en.html#toc12.140">unset/wwv</A>
2578 </H2>
2579
2580 <P><CODE><B>unset/wwv</B> Stop WWV messages coming out on your terminal</CODE></P>
2581
2582
2583 <H2><A NAME="ss12.141">12.141</A> <A HREF="usermanual_en.html#toc12.141">unset/wx</A>
2584 </H2>
2585
2586 <P><CODE><B>unset/wx</B> Stop WX messages coming out on your terminal</CODE></P>
2587
2588
2589 <H2><A NAME="ss12.142">12.142</A> <A HREF="usermanual_en.html#toc12.142">who</A>
2590 </H2>
2591
2592 <P><CODE><B>who</B> Show who is physically connected</CODE></P>
2593
2594 <P>This is a quick listing that shows which callsigns are connected and
2595 what sort of connection they have</P>
2596 <H2><A NAME="ss12.143">12.143</A> <A HREF="usermanual_en.html#toc12.143">wx &lt;text&gt;</A>
2597 </H2>
2598
2599 <P><CODE><B>wx &lt;text&gt;</B> Send a weather message to local users</CODE></P>
2600
2601
2602 <H2><A NAME="ss12.144">12.144</A> <A HREF="usermanual_en.html#toc12.144">wx full &lt;text&gt;</A>
2603 </H2>
2604
2605 <P><CODE><B>wx full &lt;text&gt;</B> Send a weather message to all cluster users</CODE></P>
2606
2607
2608 <HR>
2609 Next
2610 <A HREF="usermanual_en-11.html">Previous</A>
2611 <A HREF="usermanual_en.html#toc12">Contents</A>
2612 </BODY>
2613 </HTML>