added mark messages as read or unread
[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 NOREad <msgno>        - mark message as unread
300   MSG REad <msgno>          - mark message as read
301   MSG QUeue                 - queue any outstanding bulletins
302   MSG QUeue 1               - queue any outstanding private messages
303
304 You can look at the status of a message by using:-
305
306   STAT/MSG <msgno>      
307
308 This will display more information on the message than DIR does.
309    
310 === 8^PC <call> <text>^Send text (eg PC Protocol) to <call>
311 Send some arbitrary text to a locally connected callsign. No processing is done on
312 the text. This command allows you to send PC Protocol to unstick things if problems
313 arise (messages get stuck etc). eg:-
314    pc gb7djk PC33^GB7TLH^GB7DJK^400^
315 or 
316    pc G1TLH Try doing that properly!!!
317
318 === 1^PING <node>^Send a ping command to another cluster
319 This command is used to estimate the quality of the link to another cluster. 
320 The time returned is the length of time taken for a PC51 to go to another 
321 cluster and be returned.
322
323 === 0^KILL <msgno> [<msgno> ...]^Remove or erase a message from the system
324 You can get rid of any message to or originating from your callsign using 
325 this command. You can remove more than one message at a time.
326
327 === 5^KILL <from>-<to>^Remove a range of messages from the system
328 === 5^KILL FROM <call>^Remove all messages from a callsign
329 === 5^KILL TO <call>^Remove all messages to a callsign
330 === 5^KILL FULL <msgno> [<msgno]^Remove a message from the entire cluster
331 Remove this message from the entire cluster system as well as your node.
332
333 === 5^KILL^
334 As a sysop you can kill any message on the system.
335
336 === 8^PC <call> <text>^Send arbitrary text to a connected callsign
337 Send any text you like to the callsign requested. This is used mainly to send
338 PC protocol to connected nodes either for testing or to unstick things. 
339
340 You can also use in the same way as a talk command to a connected user but
341 without any processing, added of "from <blah> to <blah" or whatever.
342  
343 === 1^PING <node call>^Find out the delays an a circuit to another node
344 This command will enable sysops to determine the speed of an inter-cluster
345 node. 
346
347 Any visible cluster node can be PINGed.
348
349 === 1^RCMD <node call> <cmd>^Send a command to another DX Cluster
350 This command allows you to send nearly any command to another DX Cluster
351 node that is connected to the system. 
352
353 Whether you get any output is dependant on a) whether the other system knows
354 that the node callsign of this cluster is in fact a node b) whether the
355 other system is allowing RCMDs from this node and c) whether you have
356 permission to send this command at all.
357
358 === 0^READ^Read the next unread personal message addressed to you
359 === 0^READ <msgno>^Read the specified message
360 You can read any messages that are sent as 'non-personal' and also any
361 message either sent by or sent to your callsign.
362
363 === 5^READ-^
364 As a sysop you may read any message on the system
365
366 === 0^REPLY^Reply (privately) to the last message that you have read
367 === 0^REPLY <msgno>^Reply (privately) to the specified message
368 === 0^REPLY B <msgno>^Reply as a Bulletin to the specified message
369 === 0^REPLY NOPrivate <msgno>^Reply as a Bulletin to the specified message
370 === 0^REPLY RR <msgno>^Reply to the specified message with read receipt
371 You can reply to a message and the subject will automatically have
372 "Re:" inserted in front of it, if it isn't already present.
373
374 You can also use all the extra qualifiers such as RR, PRIVATE, 
375 NOPRIVATE, B that you can use with the SEND command (see SEND
376 for further details)
377
378 === 0^SEND <call> [<call> ...]^Send a message to one or more callsigns
379 === 0^SEND RR <call>^Send a message and ask for a read receipt
380 === 0^SEND COPY <msgno> <call>^Send a copy of a  message to someone
381 === 0^SEND PRIVATE <call>^Send a personal message
382 === 0^SEND NOPRIVATE <call>^Send a message to all stations
383 All the SEND commands will create a message which will be sent either to
384 an individual callsign or to one of the 'bulletin' addresses. 
385
386 SEND <call> on its own acts as though you had typed SEND PRIVATE, that is
387 it will mark the message as personal and send it to the cluster node that
388 that callsign is connected to.
389
390 You can have more than one callsign in all of the SEND commands.
391
392 You can have multiple qualifiers so that you can have for example:-
393
394   SEND RR COPY 123 PRIVATE G1TLH G0RDI
395
396 which should send a copy of message 123 to G1TLH and G0RDI and you will
397 receive a read receipt when they have read the message.
398
399 SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
400 SP is an alias for SEND PRIVATE
401
402 === 0^SET/ADDRESS <your address>^Record your postal address
403
404 === 0^SET/ANNOUNCE^Allow announce messages to come out on your terminal
405 === 0^UNSET/ANNOUNCE^Stop announce messages coming out on your terminal
406
407 === 0^SET/BEEP^Add a beep to DX and other messages on your terminal
408 === 0^UNSET/BEEP^Stop beeps for DX and other messages on your terminal
409
410 === 9^SET/DEBUG <name>^Add a debug level to the debug set
411 === 9^UNSET/DEBUG <name>^Remove a debug level from the debug set
412
413 === 0^SET/DX^Allow DX messages to come out on your terminal
414 === 0^UNSET/DX^Stop DX messages coming out on your terminal
415
416 === 0^SET/HERE^Tell the system you are present at your terminal
417 === 0^UNSET/HERE^Tell the system you are absent from your terminal
418
419 === 0^SET/HOMENODE <node> ^Set your normal cluster callsign
420 Tell the cluster system where you normally connect to. Any Messages sent
421 to you will normally find their way there should you not be connected.
422 eg:-
423   SET/HOMENODE gb7djk
424
425 === 9^SET/ISOLATE^Isolate a node from the rest of the network
426 Connect a node to your system in such a way that you are a full protocol
427 member of its network and can see all spots on it, but nothing either leaks
428 out from it nor goes back into from the rest of the nodes connected to you.
429
430 You can potentially connect several nodes in this way.
431  
432 === 9^UNSET/ISOLATE^Stop Isolation of a node from the rest of the network
433 Remove isolation from a node - SET/ISOLATE
434
435 === 0^SET/LANGUAGE <lang>^Set the language you want to use
436 You can select the language that you want the cluster to use. Currently
437 the languages available are en (english) and nl (dutch).
438
439 === 0^SET/LOCATION <lat & long>^Set your latitude and longitude
440 === 9^SET/SYS_LOCATION <lat & long>^Set your cluster latitude and longitude
441 In order to get accurate headings and such like you must tell the system
442 what your latitude and longitude is. If you have not yet done a SET/QRA
443 then this command will set your QRA locator for you. For example:-
444   SET/LOCATION 52 22 N 0 57 E
445
446 === 0^SET/LOGININFO^Inform when a station logs in locally
447 === 0^UNSET/LOGININFO^Inform when a station logs out locally
448
449 === 9^SET/LOCKOUT <call>^Stop a callsign connecting to the cluster
450 === 9^UNSET/LOCKOUT <call>^Allow a callsign to connect to the cluster
451
452 === 0^SET/NAME <your name>^Set your name
453 Tell the system what your name is eg:-
454   SET/NAME Dirk
455
456 === 9^SET/NODE <call> [<call>..]^Make the callsign an AK1A cluster
457 Tell the system that the call(s) are to be treated as AK1A cluster and
458 fed PC Protocol rather normal user commands.
459
460 === 9^SET/OBSCOUNT <count> <nodecall>^Set the 'pump-up' obscelence counter 
461 From 1.35 onwards neighbouring nodes are pinged at regular intervals (see
462 SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up'
463 counter which is decremented on every outgoing ping and then reset to
464 the 'obscount' value on every incoming ping. The default value of this
465 parameter is 2. 
466
467 What this means is that a neighbouring node will be pinged twice at 
468 (default) 300 second intervals and if no reply has been heard just before
469 what would be the third attempt, that node is disconnected.
470
471 If a ping is heard then the obscount is reset to the full value. Using
472 default values, if a node has not responded to a ping within 15 minutes,
473 it is disconnected.
474
475 === 0^SET/PAGE <lines per page>^Set the lines per page
476 Tell the system how many lines you wish on a page when the number of line
477 of output from a command is more than this. The default is 20. Setting it
478 explicitly to 0 will disable paging. 
479   SET/PAGE 30
480   SET/PAGE 0
481
482 === 9^SET/PINGINTERVAL <time> <nodecall>^Set ping time to neighbouring nodes 
483 As from release 1.35 all neighbouring nodes are pinged at regular intervals
484 in order to determine the rolling quality of the link and, in future, to
485 affect routing decisions. The default interval is 300 secs or 5 minutes.
486
487 You can use this command to set a different interval. Please don't. 
488
489 But if you do the value you enter is treated as minutes up 60 and seconds
490 for numbers greater than that.
491
492 This is used also to help determine when a link is down at the far end
493 (as certain cluster software doesn't always notice), see SET/OBSCOUNT
494 for more information.
495
496 === 9^SET/PRIVILEGE <n> <call> [<call..]^Set privilege level on a call
497 Set the privilege level on a callsign. The privilege levels that pertain
498 to commands are as default:-
499   0 - normal user
500   1 - allow remote nodes normal user RCMDs
501   5 - various privileged commands (including shutdown, but not disc-
502       connect), the normal level for another node.
503   8 - more privileged commands (including disconnect)
504   9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
505       LEVEL.
506 If you are a sysop and you come in as a normal user on a remote connection
507 your privilege will automatically be set to 0.
508
509 === 9^SET/PASSWORD <callsign> <string>^Set a users password
510 The password for a user can only be set by a full sysop. The string
511 can contain any characters but any spaces are removed (you can type in
512 spaces - but they won't appear in the password). You can see the
513 result with STAT/USER.
514
515 === 9^SET/SPIDER <call> [<call>..]^Make the callsign an DXSpider node
516 Tell the system that the call(s) are to be treated as DXSpider node and
517 fed new style DX Protocol rather normal user commands.
518
519 === 9^SET/SYS_QRA <locator>^Set your cluster QRA locator
520 === 0^SET/QRA <locator>^Set your QRA locator
521 Tell the system what your QRA (or Maidenhead) locator is. If you have not
522 done a SET/LOCATION then your latitude and longitude will be set roughly
523 correctly (assuming your locator is correct ;-). For example:-
524   SET/QRA JO02LQ
525
526 === 0^SET/QTH <your qth>^Set your QTH
527 Tell the system where you are. For example:-
528   SET/QTH East Dereham, Norfolk
529
530 === 0^SET/TALK^Allow TALK messages to come out on your terminal
531 === 0^UNSET/TALK^Stop TALK messages coming out on your terminal
532
533 === 0^SET/WWV^Allow WWV messages to come out on your terminal
534 === 0^UNSET/WWV^Stop WWV messages coming out on your terminal
535
536 === 0^SET/WX^Allow WX messages to come out on your terminal
537 === 0^UNSET/WX^Stop WX messages coming out on your terminal
538
539 === 0^SHOW/DX^Interrogate the spot database
540 If you just type SHOW/DX you will get the last so many spots
541 (sysop configurable, but usually 10).
542    
543 In addition you can add any number of these commands in very nearly
544 any order to the basic SHOW/DX command, they are:-
545    
546 on <band>       - eg 160m 20m 2m 23cm 6mm
547 on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
548    
549 <number>        - the number of spots you want
550 <from>-<to>     - <from> spot no <to> spot no in the selected list
551    
552 <prefix>        - for a spotted callsign beginning with <prefix>
553 *<suffix>       - for a spotted callsign ending in <suffix>
554 *<string>*      - for a spotted callsign containing <string>
555    
556 day <number>    - starting <number> days ago
557 day <from>-<to> - <from> days <to> days ago
558    
559 info <text>     - any spots containing <text> in the info or remarks
560    
561 by <call>       - any spots spotted by <call> (spotter <call> is the 
562                   same).
563
564 qsl             - this automatically looks for any qsl info on the call
565                   held in the spot database.
566
567 iota [<iota>]   - If the iota island number is missing it will look for
568                   the string iota and anything which looks like an iota
569                   island number. If you specify then it will look for  
570                   that island.
571
572 qra [<locator>] - this will look for the specific locator if you specify
573                   one or else anything that looks like a locator.
574    
575 e.g. 
576    
577    SH/DX 9m0
578    SH/DX on 20m info iota
579    SH/DX 9a on vhf day 30
580    SH/DX rf1p qsl
581    SH/DX iota 
582    SH/DX iota eu-064
583    SH/DX qra jn86
584   
585 === 0^SHOW/DXCC <prefix>^Interrogate the spot database by country
586 This command takes the <prefix> (which can be a full or partial 
587 callsign if desired), looks up which internal country number it is
588 and then displays all the spots as per SH/DX for that country.
589    
590 The options for SHOW/DX also apply to this command.   
591 e.g. 
592    
593    SH/DXCC G
594    SH/DXCC W on 20m info iota
595
596 === 0^SHOW/FILES [<filearea> [<string>]]^List the contents of a filearea
597 SHOW/FILES on its own will show you a list of the various fileareas
598 available on the system. To see the contents of a particular file
599 area type:-
600    SH/FILES <filearea>
601 where <filearea> is the name of the filearea you want to see the 
602 contents of.
603
604 You can also use shell globbing characters like '*' and '?' in a
605 string to see a selection of files in a filearea eg:-
606    SH/FILES bulletins arld*
607
608 See also TYPE - to see the contents of a file.
609
610 === 0^SHOW/MOON [<prefix>|<callsign>]^Show Moon rise and set times
611 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
612 together with the azimuth and elevation of the sun currently at those
613 locations.
614
615 If you don't specify any prefixes or callsigns, it will show the times for
616 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
617 together with the current azimuth and elevation.
618
619 In addition, it will show the gain or loss dB relative to the nominal 
620 distance of 385,000Km due to the ellipsoidal nature of the orbit.
621
622 If all else fails it will show the Moonrise and set times for the node
623 that you are connected to. 
624
625 For example:-
626
627   SH/MOON
628   SH/MOON G1TLH W5UN
629
630 === 0^SHOW/MUF <prefix> [<hours>][long]^Show the likely propagation to a prefix
631 This command allow you to estimate the likelihood of you contacting
632 a station with the prefix you have specified. The output assumes a modest
633 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
634
635 The result predicts the most likely operating frequencies and signal
636 levels for high frequency (shortwave) radio propagation paths on
637 specified days of the year and hours of the day. It is most useful for
638 paths between 250 km and 6000 km, but can be used with reduced accuracy
639 for paths shorter or longer than this.
640
641 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
642 used to predict the MUF given the predicted flux, day of the year,
643 hour of the day and geographic coordinates of the transmitter and
644 receiver. This routine is reasonably accurate for the purposes here,
645 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
646 than the programs used by major shortwave broadcasting organizations,
647 such as the Voice of America.
648
649 The command will display some header information detailing its
650 assumptions, together with the locations, latitude and longitudes and
651 bearings. It will then show UTC (UT), local time at the other end
652 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
653 (Zen) and the likely signal strengths. Then for each frequency for which
654 the system thinks there is a likelihood of a circuit it prints a value.
655
656 The value is currently a likely S meter reading based on the conventional
657 6dB / S point scale. If the value has a '+' appended it means that it is
658 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
659 there is likely to be much fading and by an 's' that the signal is likely
660 to be noisy.  
661
662 By default SHOW/MUF will show the next two hours worth of data. You
663 can specify anything up to 24 hours worth of data by appending the no of
664 hours required after the prefix. For example:-
665
666   SH/MUF W
667
668 produces:
669
670   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
671   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
672   Location                       Lat / Long           Azim
673   East Dereham, Norfolk          52 41 N 0 57 E         47
674   United-States-W                43 0 N 87 54 W        299
675   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
676   18 23 11.5 -35  mS0+ mS2   S3
677   19  0 11.2 -41  mS0+ mS2   S3
678
679 indicating that you will have weak, fading circuits on top band and 
680 80m but usable signals on 40m (about S3).
681
682 inputing:-
683
684   SH/MUF W 24
685
686 will get you the above display, but with the next 24 hours worth of
687 propagation data.
688
689   SH/MUF W L 24
690   SH/MUF W 24 Long
691
692 Gives you an estimate of the long path propagation characterics. It
693 should be noted that the figures will probably not be very useful, nor
694 terrible accurate, but it is included for completeness.
695
696 === 0^SHOW/PREFIX <callsign>^Interrogate the prefix database 
697 This command takes the <callsign> (which can be a full or partial 
698 callsign or a prefix), looks up which internal country number 
699 it is and then displays all the relevant prefixes for that country
700 together with the internal country no, the CQ and ITU regions. 
701
702 See also SHOW/DXCC
703
704 === 5^SHOW/PROGRAM^Show the locations of all the included program modules
705 Show the name and location where every program module was load from. This
706 is useful for checking where you think you have loaded a .pm file from. 
707
708 === 0^SHOW/SUN [<prefix>|<callsign>]^Show sun rise and set times
709 Show the sun rise and set times for a (list of) prefixes or callsigns, 
710 together with the azimuth and elevation of the sun currently at those
711 locations.
712
713 If you don't specify any prefixes or callsigns, it will show the times for
714 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
715 together with the current azimuth and elevation.
716
717 If all else fails it will show the sunrise and set times for the node
718 that you are connected to. 
719
720 For example:-
721
722   SH/SUN
723   SH/SUN G1TLH K9CW ZS
724
725 === 0^SHOW/TIME [<prefix>|<callsign>]^Show the local time 
726 If no prefixes or callsigns are given then this command returns the local
727 time and UTC as the computer has it right now. If you give some prefixes
728 then it will show UTC and UTC + the local offset (not including DST) at
729 the prefixes or callsigns that you specify.
730
731 === 0^SHOW/WWV^Show last 10 WWV broadcasts
732 === 0^SHOW/WWV <n>^Show last <n> WWV broadcasts
733 Display the most recent WWV information that has been received by the system
734
735 === 5^SHUTDOWN^Shutdown the cluster
736 Shutdown the cluster and disconnect all the users 
737
738 === 5^STAT/DB <dbname>^Show the status of a database
739 Show the internal status of a database descriptor.
740
741 Depending on your privilege level you will see more or less information. 
742 This command is unlikely to be of much use to anyone other than a sysop.
743
744 === 5^STAT/CHANNEL [<callsign>]^Show the status of a channel on the cluster
745 Show the internal status of the channel object either for the channel that 
746 you are on or else for the callsign that you asked for.
747
748 Only the fields that are defined (in perl term) will be displayed.
749
750 === 5^STAT/MSG <msgno>^Show the status of a message
751 This command shows the internal status of a message and includes information
752 such as to whom it has been forwarded, its size, origin etc etc.
753
754 === 5^STAT/USER [<callsign>]^Show the full status of a user
755 Shows the full contents of a user record including all the secret flags
756 and stuff.
757
758 Only the fields that are defined (in perl term) will be displayed.
759
760 === 0^SYSOP^Regain your privileges if you login remotely
761 The system automatically reduces your privilege level to that of a
762 normal user if you login in remotely. This command allows you to
763 regain your normal privilege level. It uses the normal system: five
764 numbers are returned that are indexes into the character array that is
765 your assigned password (see SET/PASSWORD). The indexes start from
766 zero.
767
768 You are expected to return a string which contains the characters
769 required in the correct order. You may intersperse those characters
770 with others to obscure your reply for any watchers. For example (and
771 these values are for explanation :-):
772
773   password = 012345678901234567890123456789
774   > sysop
775   22 10 15 17 3
776 you type:-
777  aa2bbbb0ccc5ddd7xxx3n
778  or 2 0 5 7 3
779  or 20573
780
781 They will all match. If there is no password you will still be offered
782 numbers but nothing will happen when you input a string. Any match is
783 case sensitive.
784
785 === 0^TALK <call> <text>^Send a text message to another station
786 === 0^TALK <call> > <node> <text>^Send a text message to another station via a node
787 Send a short message to any other station that is visible on the cluster
788 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
789 command, they don't have to be connected locally.
790
791 The second form of TALK is used when other cluster nodes are connected
792 with restricted information. This usually means that they don't send 
793 the user information usually associated with logging on and off the cluster.
794
795 If you know that G3JNB is likely to be present on GB7TLH, but you can only
796 see GB7TLH in the SH/C list but with no users, then you would use the
797 second form of the talk message.
798
799 === 0^TYPE <filearea>/<name>^Look at the contents of a file in one of the fileareas
800 Type out the contents of a file in a filearea. So, for example, in 
801 filearea 'bulletins' you want to look at file 'arld051' you would 
802 enter:-
803    TYPE bulletins/arld051
804
805 See also SHOW/FILES to see what fileareas are available and a 
806 list of content.
807
808 === 0^WHO^Show who is physically connected
809 This is a quick listing that shows which callsigns are connected and
810 what sort of connection they have
811
812 === 0^WX <text>^Send a weather message to local users
813 === 0^WX FULL <text>^Send a weather message to all cluster users
814 === 5^WX SYSOP <text>^Send a weather message to other clusters only
815 Weather messages can sometimes be useful if you are experiencing an extreme
816 that may indicate enhanced conditions
817