added ssid handling
[spider.git] / cmd / Commands_en.hlp
1 #
2 # please put your help in in alphabetical order
3 #
4 # a string search is done in the command field (case is ignored)
5 # and all commands matching the asked for command are printed out
6 #
7 # the order of the fields in each header is 
8 #   privilege, command, Description 
9 # if the command ends in a - then that line isn't printed, but any
10 # subsequent lines are
11 #
12 # Comment lines are indented before printing
13 #
14 === 0^ANNOUNCE <text>^Send an announcement to LOCAL users only
15 <text> is the text of the announcement you wish to broadcast 
16
17 === 0^ANNOUNCE FULL <text>^Send an announcement cluster wide
18 This will send your announcement cluster wide
19
20 === 5^ANNOUNCE SYSOP <text>^Send an announcement to Sysops only
21
22 === 0^APROPOS <string>^Search help database for <string>
23 Search the help database for <string> (it isn't case sensitive), and print
24 the names of all the commands that may be relevant.
25
26 === 0^BYE^Exit from the cluster
27 This will disconnect you from the cluster
28
29 === 5^CONNECT <callsign>^Start a connection to another DX Cluster
30 Start a connection process that will culminate in a new connection to the
31 DX cluster <callsign>. This process creates a new 'client' process which will
32 use the script in /spider/connect/<callsign> to effect the 'chat' exchange
33 necessary to traverse the network(s) to logon to the cluster <callsign>.
34
35 === 9^CATCH <node call> All|[<msgno> ...]^Mark a message as sent
36 === 9^UNCATCH <node call> All|[msgno> ...]^Unmark a message as sent
37 When you send messages the fact that you have forwarded it to another node 
38 is remembered so that it isn't sent again. When you have a new partner
39 node and you add their callsign to your /spider/msg/forward.pl file, all
40 outstanding non-private messages will be forwarded to them. This may well
41 be ALL the non-private messages. You can prevent this by using these 
42 commmands:-
43
44   catch GB7DJK all
45   catch GB7DJK 300 301 302 303
46         
47 and to undo what you have just done:-
48   
49   uncatch GB7DJK all
50   uncatch GB7DJK 300 301 302 303
51
52 which will arrange for them to be forward candidates again.
53
54 === 0^DBAVAIL^Show a list of all the Databases in the system
55 Title says it all really, this command lists all the databases defined
56 in the system. It is also aliased to SHOW/COMMAND.
57
58 === 9^DBCREATE <name>^Create a database entry
59 === 9^DBCREATE <name> chain <name> [<name>..]^Create a chained database entry
60 === 9^DBCREATE <name> remote <node>^Create a remote database entry
61 DBCREATE allows you to define a database in the system. It doesn't actually
62 create anything, just defines it.
63
64 The databases that are created are simple DB_File hash databases, they are 
65 therefore already 'indexed'.
66
67 You can define a local database with the first form of the command eg:
68
69   DBCREATE oblast
70
71 You can also chain databases with the addition of the 'chain' keyword. 
72 This will search each database one after the other. A typical example 
73 is:
74
75   DBCREATE sdx_qsl chain sql_ad
76
77 No checking is done to see if the any of the chained databases exist, in
78 fact it is usually better to do the above staement first then do each of
79 the chained databases.
80
81 Databases can exist offsite. To define a database that lives on another 
82 node do:
83
84   DBCREATE buckmaster remote gb7dxc
85
86 Remote databases cannot be chained; however, the last database in a 
87 a chain can be a remote database eg:
88
89   DBCREATE qsl chain gb7dxc
90
91 To see what databases have been defined do:
92
93   DBAVAIL (or it will have been aliased to SHOW/COMMAND)
94
95 It would be normal for you to add an entry into your local Aliases file
96 to allow people to use the 'SHOW/<dbname>' style syntax. So you would
97 need to add a line like:-
98
99   's' => [
100     ..
101     ..
102     '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
103     ..
104     ..
105    ],
106
107 to allow 
108  
109   SH/BUCK g1tlh
110
111 to work as they may be used to.
112
113 See DBIMPORT for the importing of existing AK1A format data to databases.
114 See DBSHOW for generic database enquiry
115  
116 === 9^DBIMPORT <dbname> <filename>^Import AK1A data into a database
117 If you want to import or update data in bulk to a database you can use
118 this command. It will either create or update entries into an existing
119 database. For example:-
120
121   DBIMPORT oblast /tmp/OBLAST.FUL
122
123 will import the standard OBLAST database that comes with AK1A into the
124 oblast database held locally.
125
126 === 9^DBREMOVE <dbname>^Delete a database
127 DBREMOVE will completely remove a database entry and also delete any data
128 file that is associated with it. 
129
130 There is no warning, no comeback, no safety net. 
131
132 For example:
133
134   DBREMOVE oblast 
135
136 will remove the oblast database from the system and it will also remove
137 the associated datafile.
138
139 I repeat:
140
141 There is no warning, no comeback, no safety net.
142  
143 You have been warned.
144
145 === 0^DBSHOW <dbname> <key>^Display an entry, if it exists, in a database
146 This is the generic user interface to the database to the database system.
147 It is expected that the sysop will add an entry to the local Aliases file
148 so that users can use the more familiar AK1A style of enquiry such as:
149
150   SH/BUCK G1TLH
151
152 but if he hasn't and the database really does exist (use DBAVAIL or
153 SHOW/COMMAND to find out) you can do the same thing with:
154
155   DBSHOW buck G1TLH
156
157 === 9^DEBUG^Set the cluster program into debug mode
158 Executing this command will only have an effect if you are running the cluster
159 in debug mode i.e.
160
161         perl -d cluster.pl
162
163 It will interrupt the cluster just after the debug command has finished.
164 === 0^DIRECTORY^List messages 
165 === 0^DIRECTORY ALL^List all messages
166 === 0^DIRECTORY OWN^List your own messages
167 === 0^DIRECTORY NEW^List all new messages
168 === 0^DIRECTORY TO <call>^List all messages to <call>
169 === 0^DIRECTORY FROM <call>^List all messages from <call>
170 === 0^DIRECTORY SUBJECT <string>^List all messages with <string> in subject
171 === 0^DIRECTORY <nn>^List last <nn> messages
172 === 0^DIRECTORY <from>-<to>^List messages <from> message <to> message 
173 List the messages in the messages directory.
174
175 If there is a 'p' one space after the message number then it is a 
176 personal message. If there is a '-' between the message number and the
177 'p' then this indicates that the message has been read.
178
179 You can use shell escape characters such as '*' and '?' in the <call>
180 fields.
181
182 You can combine some of the various directory commands together eg:-
183
184    DIR TO G1TLH 5
185 or 
186    DIR SUBJECT IOTA 200-250
187
188 You can abbreviate all the commands to one letter and use ak1a syntax:-
189
190    DIR/T G1* 10
191    DIR/S QSL 10-100 5
192
193 === 5^DIRECTORY-^
194 Sysops can see all users' messages.
195
196 === 8^DISCONNECT <call> [<call> ...]^Disconnect a user or cluster
197 Disconnect any <call> connected locally
198
199 === 0^DX [BY <call>] <freq> <call> <remarks>^Send a DX spot
200 This is how you send a DX Spot to other users. You can, in fact, now
201 enter the <freq> and the <call> either way round. 
202
203    DX FR0G 144.600
204    DX 144.600 FR0G
205    DX 144600 FR0G 
206
207 will all give the same result. You can add some remarks to the end
208 of the command and they will be added to the spot.
209
210    DX FR0G 144600 this is a test
211
212 You can credit someone else by saying:-
213
214    DX by G1TLH FR0G 144.600 he isn't on the cluster
215
216 The <freq> is compared against the available bands set up in the 
217 cluster.  See SHOW/BANDS for more information.
218
219 === 1^FORWARD/OPERNAME <call>^Send out information on this <call> to all clusters
220 This command sends out any information held in the user file which can 
221 be broadcast in PC41 protocol packets. This information is Name, QTH, Location
222 and Homenode. PC41s are only sent for the information that is available.
223  
224 === 0^HELP^The HELP Command
225 HELP is available for a number of commands. The syntax is:-
226
227   HELP <cmd>
228   
229 Where <cmd> is the name of the command you want help on.
230
231 All commands can be abbreviated, so SHOW/DX can be abbreviated
232 to SH/DX, ANNOUNCE can be shortened to AN and so on.
233
234 Look at the APROPOS <string> command which will search the help database
235 for the <string> you specify and give you a list of likely commands
236 to look at with HELP.
237
238 === 0^KILL <msgno> [<msgno..]^Delete a message from the local system
239 Delete a message from the local system. You will only be able to delete messages
240 that you have originated or been sent (unless you are the sysop).
241
242 === 5^KILL FULL <msgno> [<msgno..]^Delete a message from the whole cluster
243 Delete a message (usually a 'bulletin') from the whole cluster system. 
244
245 This uses the subject field, so any messages that have exactly the same subject
246 will be deleted. Beware!
247
248 === 9^LOAD/ALIASES^Reload the command alias table
249 Reload the /spider/cmd/Aliases file after you have editted it. You will need to
250 do this if you change this file whilst the cluster is running in order for the
251 changes to take effect.
252
253 === 9^LOAD/BANDS^Reload the band limits table
254 Reload the /spider/data/bands.pl file if you have changed it manually whilst
255 the cluster is running. 
256
257 === 9^LOAD/CMD_CACHE^Reload the automatic command cache
258 Normally, if you change a command file in the cmd or local_cmd tree it will
259 automatially be picked up by the cluster program. Sometimes it can get confused
260 if you are doing a lot of moving commands about or delete a command in the 
261 local_cmd tree and want to use the normal one again. Execute this command to
262 reset everything back to the state it was just after a cluster restart.
263
264 === 9^LOAD/MESSAGES^Reload the system messages file
265 If you change the /spider/perl/Messages file (usually whilst fiddling/writing new
266 commands) you can have them take effect during a cluster session by executing this
267 command. You need to do this if get something like :-
268
269 unknown message 'xxxx' in lang 'en'
270
271 === 9^LOAD/PREFIXES^Reload the prefix table
272 Reload the /spider/data/prefix_data.pl file if you have changed it manually whilst
273 the cluster is running. 
274
275 === 5^MERGE <node> [<no spots>/<no wwv>]^Ask for the latest spots and WWV 
276 MERGE allows you to bring your spot and wwv database up to date. By default
277 it will request the last 10 spots and 5 WWVs from the node you select. The 
278 node must be connected locally.
279
280 You can request any number of spots or wwv and although they will be appended
281 to your databases they will not duplicate any that have recently been added 
282 (the last 2 days for spots and last month for WWV data).
283
284 === 9^MSG <cmd> <msgno> [data ... ]^Alter various message parameters
285 Alter message parameters like To, From, Subject, whether private or bulletin
286 or return receipt (RR) is required or whether to keep this message from timing
287 out.
288
289   MSG TO <msgno> <call>     - change TO callsign to <call>
290   MSG FRom <msgno> <call>   - change FROM callsign to <call>
291   MSG PRrivate <msgno>      - set private flag
292   MSG NOPRrivate <msgno>    - unset private flag
293   MSG RR <msgno>            - set RR flag
294   MSG NORR <msgno>          - unset RR flag
295   MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
296   MSG NOKEep <msgno>        - unset the keep flag
297   MSG SUbject <msgno> <new> - change the subject to <new>
298   MSG WAittime <msgno>      - remove any waitting time for this message
299   MSG QUeue                 - queue any outstanding bulletins
300   MSG QUeue 1               - queue any outstanding private messages
301
302 You can look at the status of a message by using:-
303
304   STAT/MSG <msgno>      
305
306 This will display more information on the message than DIR does.
307    
308 === 8^PC <call> <text>^Send text (eg PC Protocol) to <call>
309 Send some arbitrary text to a locally connected callsign. No processing is done on
310 the text. This command allows you to send PC Protocol to unstick things if problems
311 arise (messages get stuck etc). eg:-
312    pc gb7djk PC33^GB7TLH^GB7DJK^400^
313 or 
314    pc G1TLH Try doing that properly!!!
315
316 === 1^PING <node>^Send a ping command to another cluster
317 This command is used to estimate the quality of the link to another cluster. 
318 The time returned is the length of time taken for a PC51 to go to another 
319 cluster and be returned.
320
321 === 0^KILL <msgno> [<msgno> ...]^Remove or erase a message from the system
322 You can get rid of any message to or originating from your callsign using 
323 this command. You can remove more than one message at a time.
324
325 === 5^KILL <from>-<to>^Remove a range of messages from the system
326 === 5^KILL FROM <call>^Remove all messages from a callsign
327 === 5^KILL TO <call>^Remove all messages to a callsign
328 === 5^KILL FULL <msgno> [<msgno]^Remove a message from the entire cluster
329 Remove this message from the entire cluster system as well as your node.
330
331 === 5^KILL^
332 As a sysop you can kill any message on the system.
333
334 === 8^PC <call> <text>^Send arbitrary text to a connected callsign
335 Send any text you like to the callsign requested. This is used mainly to send
336 PC protocol to connected nodes either for testing or to unstick things. 
337
338 You can also use in the same way as a talk command to a connected user but
339 without any processing, added of "from <blah> to <blah" or whatever.
340  
341 === 1^PING <node call>^Find out the delays an a circuit to another node
342 This command will enable sysops to determine the speed of an inter-cluster
343 node. 
344
345 Any visible cluster node can be PINGed.
346
347 === 1^RCMD <node call> <cmd>^Send a command to another DX Cluster
348 This command allows you to send nearly any command to another DX Cluster
349 node that is connected to the system. 
350
351 Whether you get any output is dependant on a) whether the other system knows
352 that the node callsign of this cluster is in fact a node b) whether the
353 other system is allowing RCMDs from this node and c) whether you have
354 permission to send this command at all.
355
356 === 0^READ^Read the next unread personal message addressed to you
357 === 0^READ <msgno>^Read the specified message
358 You can read any messages that are sent as 'non-personal' and also any
359 message either sent by or sent to your callsign.
360
361 === 5^READ-^
362 As a sysop you may read any message on the system
363
364 === 0^REPLY^Reply (privately) to the last message that you have read
365 === 0^REPLY <msgno>^Reply (privately) to the specified message
366 === 0^REPLY B <msgno>^Reply as a Bulletin to the specified message
367 === 0^REPLY NOPrivate <msgno>^Reply as a Bulletin to the specified message
368 === 0^REPLY RR <msgno>^Reply to the specified message with read receipt
369 You can reply to a message and the subject will automatically have
370 "Re:" inserted in front of it, if it isn't already present.
371
372 You can also use all the extra qualifiers such as RR, PRIVATE, 
373 NOPRIVATE, B that you can use with the SEND command (see SEND
374 for further details)
375
376 === 0^SEND <call> [<call> ...]^Send a message to one or more callsigns
377 === 0^SEND RR <call>^Send a message and ask for a read receipt
378 === 0^SEND COPY <msgno> <call>^Send a copy of a  message to someone
379 === 0^SEND PRIVATE <call>^Send a personal message
380 === 0^SEND NOPRIVATE <call>^Send a message to all stations
381 All the SEND commands will create a message which will be sent either to
382 an individual callsign or to one of the 'bulletin' addresses. 
383
384 SEND <call> on its own acts as though you had typed SEND PRIVATE, that is
385 it will mark the message as personal and send it to the cluster node that
386 that callsign is connected to.
387
388 You can have more than one callsign in all of the SEND commands.
389
390 You can have multiple qualifiers so that you can have for example:-
391
392   SEND RR COPY 123 PRIVATE G1TLH G0RDI
393
394 which should send a copy of message 123 to G1TLH and G0RDI and you will
395 receive a read receipt when they have read the message.
396
397 SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
398 SP is an alias for SEND PRIVATE
399
400 === 0^SET/ADDRESS <your address>^Record your postal address
401
402 === 0^SET/ANNOUNCE^Allow announce messages to come out on your terminal
403 === 0^UNSET/ANNOUNCE^Stop announce messages coming out on your terminal
404
405 === 0^SET/BEEP^Add a beep to DX and other messages on your terminal
406 === 0^UNSET/BEEP^Stop beeps for DX and other messages on your terminal
407
408 === 9^SET/DEBUG <name>^Add a debug level to the debug set
409 === 9^UNSET/DEBUG <name>^Remove a debug level from the debug set
410
411 === 0^SET/DX^Allow DX messages to come out on your terminal
412 === 0^UNSET/DX^Stop DX messages coming out on your terminal
413
414 === 0^SET/HERE^Tell the system you are present at your terminal
415 === 0^UNSET/HERE^Tell the system you are absent from your terminal
416
417 === 0^SET/HOMENODE <node> ^Set your normal cluster callsign
418 Tell the cluster system where you normally connect to. Any Messages sent
419 to you will normally find their way there should you not be connected.
420 eg:-
421   SET/HOMENODE gb7djk
422
423 === 9^SET/ISOLATE^Isolate a node from the rest of the network
424 Connect a node to your system in such a way that you are a full protocol
425 member of its network and can see all spots on it, but nothing either leaks
426 out from it nor goes back into from the rest of the nodes connected to you.
427
428 You can potentially connect several nodes in this way.
429  
430 === 9^UNSET/ISOLATE^Stop Isolation of a node from the rest of the network
431 Remove isolation from a node - SET/ISOLATE
432
433 === 0^SET/LANGUAGE <lang>^Set the language you want to use
434 You can select the language that you want the cluster to use. Currently
435 the languages available are en (english) and nl (dutch).
436
437 === 0^SET/LOCATION <lat & long>^Set your latitude and longitude
438 === 9^SET/SYS_LOCATION <lat & long>^Set your cluster latitude and longitude
439 In order to get accurate headings and such like you must tell the system
440 what your latitude and longitude is. If you have not yet done a SET/QRA
441 then this command will set your QRA locator for you. For example:-
442   SET/LOCATION 52 22 N 0 57 E
443
444 === 9^SET/LOCKOUT <call>^Stop a callsign connecting to the cluster
445 === 9^UNSET/LOCKOUT <call>^Allow a callsign to connect to the cluster
446
447 === 0^SET/NAME <your name>^Set your name
448 Tell the system what your name is eg:-
449   SET/NAME Dirk
450
451 === 9^SET/NODE <call> [<call>..]^Make the callsign an AK1A cluster
452 Tell the system that the call(s) are to be treated as AK1A cluster and
453 fed PC Protocol rather normal user commands.
454
455 === 9^SET/OBSCOUNT <count> <nodecall>^Set the 'pump-up' obscelence counter 
456 From 1.35 onwards neighbouring nodes are pinged at regular intervals (see
457 SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up'
458 counter which is decremented on every outgoing ping and then reset to
459 the 'obscount' value on every incoming ping. The default value of this
460 parameter is 2. 
461
462 What this means is that a neighbouring node will be pinged twice at 
463 (default) 300 second intervals and if no reply has been heard just before
464 what would be the third attempt, that node is disconnected.
465
466 If a ping is heard then the obscount is reset to the full value. Using
467 default values, if a node has not responded to a ping within 15 minutes,
468 it is disconnected.
469
470 === 0^SET/PAGE <lines per page>^Set the lines per page
471 Tell the system how many lines you wish on a page when the number of line
472 of output from a command is more than this. The default is 20. Setting it
473 explicitly to 0 will disable paging. 
474   SET/PAGE 30
475   SET/PAGE 0
476
477 === 9^SET/PINGINTERVAL <time> <nodecall>^Set ping time to neighbouring nodes 
478 As from release 1.35 all neighbouring nodes are pinged at regular intervals
479 in order to determine the rolling quality of the link and, in future, to
480 affect routing decisions. The default interval is 300 secs or 5 minutes.
481
482 You can use this command to set a different interval. Please don't. 
483
484 But if you do the value you enter is treated as minutes up 60 and seconds
485 for numbers greater than that.
486
487 This is used also to help determine when a link is down at the far end
488 (as certain cluster software doesn't always notice), see SET/OBSCOUNT
489 for more information.
490
491 === 9^SET/PRIVILEGE <n> <call> [<call..]^Set privilege level on a call
492 Set the privilege level on a callsign. The privilege levels that pertain
493 to commands are as default:-
494   0 - normal user
495   1 - allow remote nodes normal user RCMDs
496   5 - various privileged commands (including shutdown, but not disc-
497       connect), the normal level for another node.
498   8 - more privileged commands (including disconnect)
499   9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
500       LEVEL.
501 If you are a sysop and you come in as a normal user on a remote connection
502 your privilege will automatically be set to 0.
503
504 === 9^SET/PASSWORD <callsign> <string>^Set a users password
505 The password for a user can only be set by a full sysop. The string
506 can contain any characters but any spaces are removed (you can type in
507 spaces - but they won't appear in the password). You can see the
508 result with STAT/USER.
509
510 === 9^SET/SPIDER <call> [<call>..]^Make the callsign an DXSpider node
511 Tell the system that the call(s) are to be treated as DXSpider node and
512 fed new style DX Protocol rather normal user commands.
513
514 === 9^SET/SYS_QRA <locator>^Set your cluster QRA locator
515 === 0^SET/QRA <locator>^Set your QRA locator
516 Tell the system what your QRA (or Maidenhead) locator is. If you have not
517 done a SET/LOCATION then your latitude and longitude will be set roughly
518 correctly (assuming your locator is correct ;-). For example:-
519   SET/QRA JO02LQ
520
521 === 0^SET/QTH <your qth>^Set your QTH
522 Tell the system where you are. For example:-
523   SET/QTH East Dereham, Norfolk
524
525 === 0^SET/TALK^Allow TALK messages to come out on your terminal
526 === 0^UNSET/TALK^Stop TALK messages coming out on your terminal
527
528 === 0^SET/WWV^Allow WWV messages to come out on your terminal
529 === 0^UNSET/WWV^Stop WWV messages coming out on your terminal
530
531 === 0^SET/WX^Allow WX messages to come out on your terminal
532 === 0^UNSET/WX^Stop WX messages coming out on your terminal
533
534 === 0^SHOW/DX^Interrogate the spot database
535 If you just type SHOW/DX you will get the last so many spots
536 (sysop configurable, but usually 10).
537    
538 In addition you can add any number of these commands in very nearly
539 any order to the basic SHOW/DX command, they are:-
540    
541 on <band>       - eg 160m 20m 2m 23cm 6mm
542 on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
543    
544 <number>        - the number of spots you want
545 <from>-<to>     - <from> spot no <to> spot no in the selected list
546    
547 <prefix>        - for a spotted callsign beginning with <prefix>
548 *<suffix>       - for a spotted callsign ending in <suffix>
549 *<string>*      - for a spotted callsign containing <string>
550    
551 day <number>    - starting <number> days ago
552 day <from>-<to> - <from> days <to> days ago
553    
554 info <text>     - any spots containing <text> in the info or remarks
555    
556 by <call>       - any spots spotted by <call> (spotter <call> is the 
557                   same).
558
559 qsl             - this automatically looks for any qsl info on the call
560                   held in the spot database.
561
562 iota [<iota>]   - If the iota island number is missing it will look for
563                   the string iota and anything which looks like an iota
564                   island number. If you specify then it will look for  
565                   that island.
566
567 qra [<locator>] - this will look for the specific locator if you specify
568                   one or else anything that looks like a locator.
569    
570 e.g. 
571    
572    SH/DX 9m0
573    SH/DX on 20m info iota
574    SH/DX 9a on vhf day 30
575    SH/DX rf1p qsl
576    SH/DX iota 
577    SH/DX iota eu-064
578    SH/DX qra jn86
579   
580 === 0^SHOW/DXCC <prefix>^Interrogate the spot database by country
581 This command takes the <prefix> (which can be a full or partial 
582 callsign if desired), looks up which internal country number it is
583 and then displays all the spots as per SH/DX for that country.
584    
585 The options for SHOW/DX also apply to this command.   
586 e.g. 
587    
588    SH/DXCC G
589    SH/DXCC W on 20m info iota
590
591 === 0^SHOW/FILES [<filearea> [<string>]]^List the contents of a filearea
592 SHOW/FILES on its own will show you a list of the various fileareas
593 available on the system. To see the contents of a particular file
594 area type:-
595    SH/FILES <filearea>
596 where <filearea> is the name of the filearea you want to see the 
597 contents of.
598
599 You can also use shell globbing characters like '*' and '?' in a
600 string to see a selection of files in a filearea eg:-
601    SH/FILES bulletins arld*
602
603 See also TYPE - to see the contents of a file.
604
605 === 0^SHOW/MOON [<prefix>|<callsign>]^Show Moon rise and set times
606 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
607 together with the azimuth and elevation of the sun currently at those
608 locations.
609
610 If you don't specify any prefixes or callsigns, it will show the times for
611 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
612 together with the current azimuth and elevation.
613
614 In addition, it will show the gain or loss dB relative to the nominal 
615 distance of 385,000Km due to the ellipsoidal nature of the orbit.
616
617 If all else fails it will show the Moonrise and set times for the node
618 that you are connected to. 
619
620 For example:-
621
622   SH/MOON
623   SH/MOON G1TLH W5UN
624
625 === 0^SHOW/MUF <prefix> [<hours>][long]^Show the likely propagation to a prefix
626 This command allow you to estimate the likelihood of you contacting
627 a station with the prefix you have specified. The output assumes a modest
628 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
629
630 The result predicts the most likely operating frequencies and signal
631 levels for high frequency (shortwave) radio propagation paths on
632 specified days of the year and hours of the day. It is most useful for
633 paths between 250 km and 6000 km, but can be used with reduced accuracy
634 for paths shorter or longer than this.
635
636 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
637 used to predict the MUF given the predicted flux, day of the year,
638 hour of the day and geographic coordinates of the transmitter and
639 receiver. This routine is reasonably accurate for the purposes here,
640 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
641 than the programs used by major shortwave broadcasting organizations,
642 such as the Voice of America.
643
644 The command will display some header information detailing its
645 assumptions, together with the locations, latitude and longitudes and
646 bearings. It will then show UTC (UT), local time at the other end
647 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
648 (Zen) and the likely signal strengths. Then for each frequency for which
649 the system thinks there is a likelihood of a circuit it prints a value.
650
651 The value is currently a likely S meter reading based on the conventional
652 6dB / S point scale. If the value has a '+' appended it means that it is
653 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
654 there is likely to be much fading and by an 's' that the signal is likely
655 to be noisy.  
656
657 By default SHOW/MUF will show the next two hours worth of data. You
658 can specify anything up to 24 hours worth of data by appending the no of
659 hours required after the prefix. For example:-
660
661   SH/MUF W
662
663 produces:
664
665   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
666   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
667   Location                       Lat / Long           Azim
668   East Dereham, Norfolk          52 41 N 0 57 E         47
669   United-States-W                43 0 N 87 54 W        299
670   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
671   18 23 11.5 -35  mS0+ mS2   S3
672   19  0 11.2 -41  mS0+ mS2   S3
673
674 indicating that you will have weak, fading circuits on top band and 
675 80m but usable signals on 40m (about S3).
676
677 inputing:-
678
679   SH/MUF W 24
680
681 will get you the above display, but with the next 24 hours worth of
682 propagation data.
683
684   SH/MUF W L 24
685   SH/MUF W 24 Long
686
687 Gives you an estimate of the long path propagation characterics. It
688 should be noted that the figures will probably not be very useful, nor
689 terrible accurate, but it is included for completeness.
690
691 === 0^SHOW/PREFIX <callsign>^Interrogate the prefix database 
692 This command takes the <callsign> (which can be a full or partial 
693 callsign or a prefix), looks up which internal country number 
694 it is and then displays all the relevant prefixes for that country
695 together with the internal country no, the CQ and ITU regions. 
696
697 See also SHOW/DXCC
698
699 === 5^SHOW/PROGRAM^Show the locations of all the included program modules
700 Show the name and location where every program module was load from. This
701 is useful for checking where you think you have loaded a .pm file from. 
702
703 === 0^SHOW/SUN [<prefix>|<callsign>]^Show sun rise and set times
704 Show the sun rise and set times for a (list of) prefixes or callsigns, 
705 together with the azimuth and elevation of the sun currently at those
706 locations.
707
708 If you don't specify any prefixes or callsigns, it will show the times for
709 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
710 together with the current azimuth and elevation.
711
712 If all else fails it will show the sunrise and set times for the node
713 that you are connected to. 
714
715 For example:-
716
717   SH/SUN
718   SH/SUN G1TLH K9CW ZS
719
720 === 0^SHOW/TIME [<prefix>|<callsign>]^Show the local time 
721 If no prefixes or callsigns are given then this command returns the local
722 time and UTC as the computer has it right now. If you give some prefixes
723 then it will show UTC and UTC + the local offset (not including DST) at
724 the prefixes or callsigns that you specify.
725
726 === 0^SHOW/WWV^Show last 10 WWV broadcasts
727 === 0^SHOW/WWV <n>^Show last <n> WWV broadcasts
728 Display the most recent WWV information that has been received by the system
729
730 === 5^SHUTDOWN^Shutdown the cluster
731 Shutdown the cluster and disconnect all the users 
732
733 === 5^STAT/DB <dbname>^Show the status of a database
734 Show the internal status of a database descriptor.
735
736 Depending on your privilege level you will see more or less information. 
737 This command is unlikely to be of much use to anyone other than a sysop.
738
739 === 5^STAT/CHANNEL [<callsign>]^Show the status of a channel on the cluster
740 Show the internal status of the channel object either for the channel that 
741 you are on or else for the callsign that you asked for.
742
743 Only the fields that are defined (in perl term) will be displayed.
744
745 === 5^STAT/MSG <msgno>^Show the status of a message
746 This command shows the internal status of a message and includes information
747 such as to whom it has been forwarded, its size, origin etc etc.
748
749 === 5^STAT/USER [<callsign>]^Show the full status of a user
750 Shows the full contents of a user record including all the secret flags
751 and stuff.
752
753 Only the fields that are defined (in perl term) will be displayed.
754
755 === 0^SYSOP^Regain your privileges if you login remotely
756 The system automatically reduces your privilege level to that of a
757 normal user if you login in remotely. This command allows you to
758 regain your normal privilege level. It uses the normal system: five
759 numbers are returned that are indexes into the character array that is
760 your assigned password (see SET/PASSWORD). The indexes start from
761 zero.
762
763 You are expected to return a string which contains the characters
764 required in the correct order. You may intersperse those characters
765 with others to obscure your reply for any watchers. For example (and
766 these values are for explanation :-):
767
768   password = 012345678901234567890123456789
769   > sysop
770   22 10 15 17 3
771 you type:-
772  aa2bbbb0ccc5ddd7xxx3n
773  or 2 0 5 7 3
774  or 20573
775
776 They will all match. If there is no password you will still be offered
777 numbers but nothing will happen when you input a string. Any match is
778 case sensitive.
779
780 === 0^TALK <call> <text>^Send a text message to another station
781 === 0^TALK <call> > <node> <text>^Send a text message to another station via a node
782 Send a short message to any other station that is visible on the cluster
783 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
784 command, they don't have to be connected locally.
785
786 The second form of TALK is used when other cluster nodes are connected
787 with restricted information. This usually means that they don't send 
788 the user information usually associated with logging on and off the cluster.
789
790 If you know that G3JNB is likely to be present on GB7TLH, but you can only
791 see GB7TLH in the SH/C list but with no users, then you would use the
792 second form of the talk message.
793
794 === 0^TYPE <filearea>/<name>^Look at the contents of a file in one of the fileareas
795 Type out the contents of a file in a filearea. So, for example, in 
796 filearea 'bulletins' you want to look at file 'arld051' you would 
797 enter:-
798    TYPE bulletins/arld051
799
800 See also SHOW/FILES to see what fileareas are available and a 
801 list of content.
802
803 === 0^WHO^Show who is physically connected
804 This is a quick listing that shows which callsigns are connected and
805 what sort of connection they have
806
807 === 0^WX <text>^Send a weather message to local users
808 === 0^WX FULL <text>^Send a weather message to all cluster users
809 === 5^WX SYSOP <text>^Send a weather message to other clusters only
810 Weather messages can sometimes be useful if you are experiencing an extreme
811 that may indicate enhanced conditions
812