]> scm.dxcluster.org Git - spider.git/blob - cmd/Commands_en.hlp
489308c3c3ef1f3679327ca90244442dd82e6e3c
[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 === 9^EXPORT <msgno> <filename>^Export a message to a file
220 Export a message to a file. This command can only be executed on a local
221 console with a fully privileged user. The file produced will be in a form
222 ready to be imported back into the cluster by placing it in the import 
223 directory (/spider/msg/import).
224
225 This command cannot overwrite an existing file. This is to provide some 
226 measure of security. Any files written will owned by the same user as the 
227 main cluster, otherwise you can put the new files anywhere the cluster can
228 access. For example:-
229
230   EXPORT 2345 /tmp/a
231
232
233 === 1^FORWARD/OPERNAME <call>^Send out information on this <call> to all clusters
234 This command sends out any information held in the user file which can 
235 be broadcast in PC41 protocol packets. This information is Name, QTH, Location
236 and Homenode. PC41s are only sent for the information that is available.
237  
238 === 0^HELP^The HELP Command
239 HELP is available for a number of commands. The syntax is:-
240
241   HELP <cmd>
242   
243 Where <cmd> is the name of the command you want help on.
244
245 All commands can be abbreviated, so SHOW/DX can be abbreviated
246 to SH/DX, ANNOUNCE can be shortened to AN and so on.
247
248 Look at the APROPOS <string> command which will search the help database
249 for the <string> you specify and give you a list of likely commands
250 to look at with HELP.
251
252 === 5^INIT <node>^Re-initialise a link to an AK1A compatible node
253 This command attempts to re-initialise a link to a (usually) AK1A node
254 that has got confused, usually by a protocol loop of some kind. It may
255 work - but you usually will be better off simply disconnecting it (or
256 better, if it is a real AK1A node, doing an RCMD <node> DISC/F <your
257 node>).
258
259 Best of luck - you will need it.
260   
261 === 0^KILL <msgno> [<msgno..]^Delete a message from the local system
262 Delete a message from the local system. You will only be able to
263 delete messages that you have originated or been sent (unless you are
264 the sysop).
265
266 === 5^KILL FULL <msgno> [<msgno..]^Delete a message from the whole cluster
267 Delete a message (usually a 'bulletin') from the whole cluster system. 
268
269 This uses the subject field, so any messages that have exactly the
270 same subject will be deleted. Beware!
271
272 === 0^LINKS^Show which nodes is physically connected
273 This is a quick listing that shows which links are connected and
274 some information about them. See WHO for a list of all connections.
275
276 === 9^LOAD/ALIASES^Reload the command alias table
277 Reload the /spider/cmd/Aliases file after you have editted it. You
278 will need to do this if you change this file whilst the cluster is
279 running in order for the changes to take effect.
280
281 === 9^LOAD/BANDS^Reload the band limits table
282 Reload the /spider/data/bands.pl file if you have changed it manually whilst
283 the cluster is running. 
284
285 === 9^LOAD/CMD_CACHE^Reload the automatic command cache
286 Normally, if you change a command file in the cmd or local_cmd tree it
287 will automatially be picked up by the cluster program. Sometimes it
288 can get confused if you are doing a lot of moving commands about or
289 delete a command in the local_cmd tree and want to use the normal one
290 again. Execute this command to reset everything back to the state it
291 was just after a cluster restart.
292
293 === 9^LOAD/MESSAGES^Reload the system messages file
294 If you change the /spider/perl/Messages file (usually whilst
295 fiddling/writing new commands) you can have them take effect during a
296 cluster session by executing this command. You need to do this if get
297 something like :-
298
299 unknown message 'xxxx' in lang 'en'
300
301 === 9^LOAD/PREFIXES^Reload the prefix table
302 Reload the /spider/data/prefix_data.pl file if you have changed it
303 manually whilst the cluster is running.
304
305 === 5^MERGE <node> [<no spots>/<no wwv>]^Ask for the latest spots and WWV 
306 MERGE allows you to bring your spot and wwv database up to date. By default
307 it will request the last 10 spots and 5 WWVs from the node you select. The 
308 node must be connected locally.
309
310 You can request any number of spots or wwv and although they will be appended
311 to your databases they will not duplicate any that have recently been added 
312 (the last 2 days for spots and last month for WWV data).
313
314 === 9^MSG <cmd> <msgno> [data ... ]^Alter various message parameters
315 Alter message parameters like To, From, Subject, whether private or bulletin
316 or return receipt (RR) is required or whether to keep this message from timing
317 out.
318
319   MSG TO <msgno> <call>     - change TO callsign to <call>
320   MSG FRom <msgno> <call>   - change FROM callsign to <call>
321   MSG PRrivate <msgno>      - set private flag
322   MSG NOPRrivate <msgno>    - unset private flag
323   MSG RR <msgno>            - set RR flag
324   MSG NORR <msgno>          - unset RR flag
325   MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
326   MSG NOKEep <msgno>        - unset the keep flag
327   MSG SUbject <msgno> <new> - change the subject to <new>
328   MSG WAittime <msgno>      - remove any waitting time for this message
329   MSG NOREad <msgno>        - mark message as unread
330   MSG REad <msgno>          - mark message as read
331   MSG QUeue                 - queue any outstanding bulletins
332   MSG QUeue 1               - queue any outstanding private messages
333
334 You can look at the status of a message by using:-
335
336   STAT/MSG <msgno>      
337
338 This will display more information on the message than DIR does.
339    
340 === 8^PC <call> <text>^Send text (eg PC Protocol) to <call>
341 Send some arbitrary text to a locally connected callsign. No
342 processing is done on the text. This command allows you to send PC
343 Protocol to unstick things if problems arise (messages get stuck
344 etc). eg:-
345
346    pc gb7djk PC33^GB7TLH^GB7DJK^400^
347 or 
348    pc G1TLH Try doing that properly!!!
349
350 === 1^PING <node>^Send a ping command to another cluster
351 This command is used to estimate the quality of the link to another cluster. 
352 The time returned is the length of time taken for a PC51 to go to another 
353 cluster and be returned.
354
355 === 0^KILL <msgno> [<msgno> ...]^Remove or erase a message from the system
356 You can get rid of any message to or originating from your callsign using 
357 this command. You can remove more than one message at a time.
358
359 === 5^KILL <from>-<to>^Remove a range of messages from the system
360 === 5^KILL FROM <call>^Remove all messages from a callsign
361 === 5^KILL TO <call>^Remove all messages to a callsign
362 === 5^KILL FULL <msgno> [<msgno]^Remove a message from the entire cluster
363 Remove this message from the entire cluster system as well as your node.
364
365 === 5^KILL^
366 As a sysop you can kill any message on the system.
367
368 === 8^PC <call> <text>^Send arbitrary text to a connected callsign
369 Send any text you like to the callsign requested. This is used mainly to send
370 PC protocol to connected nodes either for testing or to unstick things. 
371
372 You can also use in the same way as a talk command to a connected user but
373 without any processing, added of "from <blah> to <blah" or whatever.
374  
375 === 1^PING <node call>^Find out the delays an a circuit to another node
376 This command will enable sysops to determine the speed of an inter-cluster
377 node. 
378
379 Any visible cluster node can be PINGed.
380
381 === 1^RCMD <node call> <cmd>^Send a command to another DX Cluster
382 This command allows you to send nearly any command to another DX Cluster
383 node that is connected to the system. 
384
385 Whether you get any output is dependant on a) whether the other system knows
386 that the node callsign of this cluster is in fact a node b) whether the
387 other system is allowing RCMDs from this node and c) whether you have
388 permission to send this command at all.
389
390 === 0^READ^Read the next unread personal message addressed to you
391 === 0^READ <msgno>^Read the specified message
392 You can read any messages that are sent as 'non-personal' and also any
393 message either sent by or sent to your callsign.
394
395 === 5^READ-^
396 As a sysop you may read any message on the system
397
398 === 0^REPLY^Reply (privately) to the last message that you have read
399 === 0^REPLY <msgno>^Reply (privately) to the specified message
400 === 0^REPLY B <msgno>^Reply as a Bulletin to the specified message
401 === 0^REPLY NOPrivate <msgno>^Reply as a Bulletin to the specified message
402 === 0^REPLY RR <msgno>^Reply to the specified message with read receipt
403 You can reply to a message and the subject will automatically have
404 "Re:" inserted in front of it, if it isn't already present.
405
406 You can also use all the extra qualifiers such as RR, PRIVATE, 
407 NOPRIVATE, B that you can use with the SEND command (see SEND
408 for further details)
409
410 === 0^SEND <call> [<call> ...]^Send a message to one or more callsigns
411 === 0^SEND RR <call>^Send a message and ask for a read receipt
412 === 0^SEND COPY <msgno> <call>^Send a copy of a  message to someone
413 === 0^SEND PRIVATE <call>^Send a personal message
414 === 0^SEND NOPRIVATE <call>^Send a message to all stations
415 All the SEND commands will create a message which will be sent either to
416 an individual callsign or to one of the 'bulletin' addresses. 
417
418 SEND <call> on its own acts as though you had typed SEND PRIVATE, that is
419 it will mark the message as personal and send it to the cluster node that
420 that callsign is connected to.
421
422 You can have more than one callsign in all of the SEND commands.
423
424 You can have multiple qualifiers so that you can have for example:-
425
426   SEND RR COPY 123 PRIVATE G1TLH G0RDI
427
428 which should send a copy of message 123 to G1TLH and G0RDI and you will
429 receive a read receipt when they have read the message.
430
431 SB is an alias for SEND NOPRIVATE (or send a bulletin in BBS speak)
432 SP is an alias for SEND PRIVATE
433
434 === 0^SET/ADDRESS <your address>^Record your postal address
435
436 === 0^SET/ANNOUNCE^Allow announce messages to come out on your terminal
437 === 0^UNSET/ANNOUNCE^Stop announce messages coming out on your terminal
438
439 === 0^SET/BEEP^Add a beep to DX and other messages on your terminal
440 === 0^UNSET/BEEP^Stop beeps for DX and other messages on your terminal
441
442 === 9^SET/DEBUG <name>^Add a debug level to the debug set
443 === 9^UNSET/DEBUG <name>^Remove a debug level from the debug set
444
445 === 0^SET/DX^Allow DX messages to come out on your terminal
446 === 0^UNSET/DX^Stop DX messages coming out on your terminal
447
448 === 0^SET/ECHO^Make the cluster echo your input
449 === 0^UNSET/ECHO^Stop the cluster echoing your input
450 If you are connected via a telnet session, different implimentations
451 of telnet handle echo differently depending on whether you are 
452 connected via port 23 or some other port. You can use this command
453 to change the setting appropriately. 
454
455 The setting is stored in your user profile.
456
457 YOU DO NOT NEED TO USE THIS COMMAND IF YOU ARE CONNECTED VIA AX25.
458
459 === 0^SET/HERE^Tell the system you are present at your terminal
460 === 0^UNSET/HERE^Tell the system you are absent from your terminal
461
462 === 0^SET/HOMENODE <node> ^Set your normal cluster callsign
463 Tell the cluster system where you normally connect to. Any Messages sent
464 to you will normally find their way there should you not be connected.
465 eg:-
466   SET/HOMENODE gb7djk
467
468 === 9^SET/ISOLATE^Isolate a node from the rest of the network
469 Connect a node to your system in such a way that you are a full protocol
470 member of its network and can see all spots on it, but nothing either leaks
471 out from it nor goes back into from the rest of the nodes connected to you.
472
473 You can potentially connect several nodes in this way.
474  
475 === 9^UNSET/ISOLATE^Stop Isolation of a node from the rest of the network
476 Remove isolation from a node - SET/ISOLATE
477
478 === 0^SET/LANGUAGE <lang>^Set the language you want to use
479 You can select the language that you want the cluster to use. Currently
480 the languages available are en (english) and nl (dutch).
481
482 === 0^SET/LOCATION <lat & long>^Set your latitude and longitude
483 === 9^SET/SYS_LOCATION <lat & long>^Set your cluster latitude and longitude
484 In order to get accurate headings and such like you must tell the system
485 what your latitude and longitude is. If you have not yet done a SET/QRA
486 then this command will set your QRA locator for you. For example:-
487   SET/LOCATION 52 22 N 0 57 E
488
489 === 0^SET/LOGININFO^Inform when a station logs in locally
490 === 0^UNSET/LOGININFO^Inform when a station logs out locally
491
492 === 9^SET/LOCKOUT <call>^Stop a callsign connecting to the cluster
493 === 9^UNSET/LOCKOUT <call>^Allow a callsign to connect to the cluster
494
495 === 0^SET/NAME <your name>^Set your name
496 Tell the system what your name is eg:-
497   SET/NAME Dirk
498
499 === 9^SET/NODE <call> [<call>..]^Make the callsign an AK1A cluster
500 Tell the system that the call(s) are to be treated as AK1A cluster and
501 fed PC Protocol rather normal user commands.
502
503 === 9^SET/OBSCOUNT <count> <nodecall>^Set the 'pump-up' obscelence counter 
504 From 1.35 onwards neighbouring nodes are pinged at regular intervals (see
505 SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up'
506 counter which is decremented on every outgoing ping and then reset to
507 the 'obscount' value on every incoming ping. The default value of this
508 parameter is 2. 
509
510 What this means is that a neighbouring node will be pinged twice at 
511 (default) 300 second intervals and if no reply has been heard just before
512 what would be the third attempt, that node is disconnected.
513
514 If a ping is heard then the obscount is reset to the full value. Using
515 default values, if a node has not responded to a ping within 15 minutes,
516 it is disconnected.
517
518 === 0^SET/PAGE <lines per page>^Set the lines per page
519 Tell the system how many lines you wish on a page when the number of line
520 of output from a command is more than this. The default is 20. Setting it
521 explicitly to 0 will disable paging. 
522   SET/PAGE 30
523   SET/PAGE 0
524
525 The setting is stored in your user profile.
526
527 === 9^SET/PINGINTERVAL <time> <nodecall>^Set ping time to neighbouring nodes 
528 As from release 1.35 all neighbouring nodes are pinged at regular intervals
529 in order to determine the rolling quality of the link and, in future, to
530 affect routing decisions. The default interval is 300 secs or 5 minutes.
531
532 You can use this command to set a different interval. Please don't. 
533
534 But if you do the value you enter is treated as minutes up 60 and seconds
535 for numbers greater than that.
536
537 This is used also to help determine when a link is down at the far end
538 (as certain cluster software doesn't always notice), see SET/OBSCOUNT
539 for more information.
540
541 === 9^SET/PRIVILEGE <n> <call> [<call..]^Set privilege level on a call
542 Set the privilege level on a callsign. The privilege levels that pertain
543 to commands are as default:-
544   0 - normal user
545   1 - allow remote nodes normal user RCMDs
546   5 - various privileged commands (including shutdown, but not disc-
547       connect), the normal level for another node.
548   8 - more privileged commands (including disconnect)
549   9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
550       LEVEL.
551 If you are a sysop and you come in as a normal user on a remote connection
552 your privilege will automatically be set to 0.
553
554 === 9^SET/PASSWORD <callsign> <string>^Set a users password
555 The password for a user can only be set by a full sysop. The string
556 can contain any characters but any spaces are removed (you can type in
557 spaces - but they won't appear in the password). You can see the
558 result with STAT/USER.
559
560 === 9^SET/SPIDER <call> [<call>..]^Make the callsign an DXSpider node
561 Tell the system that the call(s) are to be treated as DXSpider node and
562 fed new style DX Protocol rather normal user commands.
563
564 === 9^SET/SYS_QRA <locator>^Set your cluster QRA locator
565 === 0^SET/QRA <locator>^Set your QRA locator
566 Tell the system what your QRA (or Maidenhead) locator is. If you have not
567 done a SET/LOCATION then your latitude and longitude will be set roughly
568 correctly (assuming your locator is correct ;-). For example:-
569   SET/QRA JO02LQ
570
571 === 0^SET/QTH <your qth>^Set your QTH
572 Tell the system where you are. For example:-
573   SET/QTH East Dereham, Norfolk
574
575 === 0^SET/TALK^Allow TALK messages to come out on your terminal
576 === 0^UNSET/TALK^Stop TALK messages coming out on your terminal
577
578 === 0^SET/WCY^Allow WCY messages to come out on your terminal
579 === 0^UNSET/WCY^Stop WCY messages coming out on your terminal
580
581 === 0^SET/WWV^Allow WWV messages to come out on your terminal
582 === 0^UNSET/WWV^Stop WWV messages coming out on your terminal
583
584 === 0^SET/WX^Allow WX messages to come out on your terminal
585 === 0^UNSET/WX^Stop WX messages coming out on your terminal
586
587 === 0^SHOW/DATE [<prefix>|<callsign>]^Show the local time 
588 This is very nearly the same as SHOW/TIME, the only difference the format
589 of the date string if no arguments are given.
590
591 If no prefixes or callsigns are given then this command returns the local
592 time and UTC as the computer has it right now. If you give some prefixes
593 then it will show UTC and UTC + the local offset (not including DST) at
594 the prefixes or callsigns that you specify.
595
596 === 0^SHOW/DX^Interrogate the spot database
597 If you just type SHOW/DX you will get the last so many spots
598 (sysop configurable, but usually 10).
599    
600 In addition you can add any number of these commands in very nearly
601 any order to the basic SHOW/DX command, they are:-
602    
603 on <band>       - eg 160m 20m 2m 23cm 6mm
604 on <region>     - eg hf vhf uhf shf      (see SHOW/BANDS)
605    
606 <number>        - the number of spots you want
607 <from>-<to>     - <from> spot no <to> spot no in the selected list
608    
609 <prefix>        - for a spotted callsign beginning with <prefix>
610 *<suffix>       - for a spotted callsign ending in <suffix>
611 *<string>*      - for a spotted callsign containing <string>
612    
613 day <number>    - starting <number> days ago
614 day <from>-<to> - <from> days <to> days ago
615    
616 info <text>     - any spots containing <text> in the info or remarks
617    
618 by <call>       - any spots spotted by <call> (spotter <call> is the 
619                   same).
620
621 qsl             - this automatically looks for any qsl info on the call
622                   held in the spot database.
623
624 iota [<iota>]   - If the iota island number is missing it will look for
625                   the string iota and anything which looks like an iota
626                   island number. If you specify then it will look for  
627                   that island.
628
629 qra [<locator>] - this will look for the specific locator if you specify
630                   one or else anything that looks like a locator.
631    
632 e.g. 
633    
634    SH/DX 9m0
635    SH/DX on 20m info iota
636    SH/DX 9a on vhf day 30
637    SH/DX rf1p qsl
638    SH/DX iota 
639    SH/DX iota eu-064
640    SH/DX qra jn86
641   
642 === 0^SHOW/DXCC <prefix>^Interrogate the spot database by country
643 This command takes the <prefix> (which can be a full or partial 
644 callsign if desired), looks up which internal country number it is
645 and then displays all the spots as per SH/DX for that country.
646    
647 The options for SHOW/DX also apply to this command.   
648 e.g. 
649    
650    SH/DXCC G
651    SH/DXCC W on 20m info iota
652
653 === 0^SHOW/FILES [<filearea> [<string>]]^List the contents of a filearea
654 SHOW/FILES on its own will show you a list of the various fileareas
655 available on the system. To see the contents of a particular file
656 area type:-
657    SH/FILES <filearea>
658 where <filearea> is the name of the filearea you want to see the 
659 contents of.
660
661 You can also use shell globbing characters like '*' and '?' in a
662 string to see a selection of files in a filearea eg:-
663    SH/FILES bulletins arld*
664
665 See also TYPE - to see the contents of a file.
666
667 === 1^SHOW/ISOLATE^Show list of ISOLATED nodes
668
669 === 9^SHOW/LOCKOUT^Show the list of locked out or excluded callsigns
670
671 === 0^SHOW/MOON [<prefix>|<callsign>]^Show Moon rise and set times
672 Show the Moon rise and set times for a (list of) prefixes or callsigns, 
673 together with the azimuth and elevation of the sun currently at those
674 locations.
675
676 If you don't specify any prefixes or callsigns, it will show the times for
677 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
678 together with the current azimuth and elevation.
679
680 In addition, it will show the gain or loss dB relative to the nominal 
681 distance of 385,000Km due to the ellipsoidal nature of the orbit.
682
683 If all else fails it will show the Moonrise and set times for the node
684 that you are connected to. 
685
686 For example:-
687
688   SH/MOON
689   SH/MOON G1TLH W5UN
690
691 === 0^SHOW/MUF <prefix> [<hours>][long]^Show the likely propagation to a prefix
692 This command allow you to estimate the likelihood of you contacting
693 a station with the prefix you have specified. The output assumes a modest
694 power of 20dBW and receiver sensitivity of -123dBm (about 0.15muV/10dB SINAD)
695
696 The result predicts the most likely operating frequencies and signal
697 levels for high frequency (shortwave) radio propagation paths on
698 specified days of the year and hours of the day. It is most useful for
699 paths between 250 km and 6000 km, but can be used with reduced accuracy
700 for paths shorter or longer than this.
701
702 The command uses a routine MINIMUF 3.5 developed by the U.S. Navy and
703 used to predict the MUF given the predicted flux, day of the year,
704 hour of the day and geographic coordinates of the transmitter and
705 receiver. This routine is reasonably accurate for the purposes here,
706 with a claimed RMS error of 3.8 MHz, but much smaller and less complex
707 than the programs used by major shortwave broadcasting organizations,
708 such as the Voice of America.
709
710 The command will display some header information detailing its
711 assumptions, together with the locations, latitude and longitudes and
712 bearings. It will then show UTC (UT), local time at the other end
713 (LT), calculate the MUFs, Sun zenith angle at the midpoint of the path
714 (Zen) and the likely signal strengths. Then for each frequency for which
715 the system thinks there is a likelihood of a circuit it prints a value.
716
717 The value is currently a likely S meter reading based on the conventional
718 6dB / S point scale. If the value has a '+' appended it means that it is
719 1/2 an S point stronger. If the value is preceeded by an 'm' it means that
720 there is likely to be much fading and by an 's' that the signal is likely
721 to be noisy.  
722
723 By default SHOW/MUF will show the next two hours worth of data. You
724 can specify anything up to 24 hours worth of data by appending the no of
725 hours required after the prefix. For example:-
726
727   SH/MUF W
728
729 produces:
730
731   RxSens: -123 dBM SFI: 159   R: 193   Month: 10   Day: 21
732   Power :   20 dBW    Distance:  6283 km    Delay: 22.4 ms
733   Location                       Lat / Long           Azim
734   East Dereham, Norfolk          52 41 N 0 57 E         47
735   United-States-W                43 0 N 87 54 W        299
736   UT LT  MUF Zen  1.8  3.5  7.0 10.1 14.0 18.1 21.0 24.9 28.0 50.0
737   18 23 11.5 -35  mS0+ mS2   S3
738   19  0 11.2 -41  mS0+ mS2   S3
739
740 indicating that you will have weak, fading circuits on top band and 
741 80m but usable signals on 40m (about S3).
742
743 inputing:-
744
745   SH/MUF W 24
746
747 will get you the above display, but with the next 24 hours worth of
748 propagation data.
749
750   SH/MUF W L 24
751   SH/MUF W 24 Long
752
753 Gives you an estimate of the long path propagation characterics. It
754 should be noted that the figures will probably not be very useful, nor
755 terrible accurate, but it is included for completeness.
756
757 === 1^SHOW/NODE [<callsign> ...]^Show the type and version number of nodes
758 Show the type and version (if connected) of the nodes specified on the
759 command line. If no callsigns are specified then a sorted list of all
760 the non-user callsigns known to the system will be displayed.
761
762 === 0^SHOW/PREFIX <callsign>^Interrogate the prefix database 
763 This command takes the <callsign> (which can be a full or partial 
764 callsign or a prefix), looks up which internal country number 
765 it is and then displays all the relevant prefixes for that country
766 together with the internal country no, the CQ and ITU regions. 
767
768 See also SHOW/DXCC
769
770 === 5^SHOW/PROGRAM^Show the locations of all the included program modules
771 Show the name and location where every program module was load from. This
772 is useful for checking where you think you have loaded a .pm file from. 
773
774 === 0^SHOW/QRA <locator> [<locator>]^Show distance between locators
775 === 0^SHOW/QRA <lat> <long>^Convert latitude and longitude to a locator
776 This is a multipurpose command that allows you either to calculate the
777 distance and bearing between two locators or (if only one locator is
778 given on the command line) the distance and beraing from your station
779 to the locator. For example:-
780
781 SH/QRA IO92QL 
782 SH/QRA JN06 IN73
783
784 The first example will show the distance and bearing to the locator from
785 yourself, the second example will calculate the distance and bearing from
786 the first locator to the second. You can use 4 or 6 character locators.
787
788 It is also possible to convert a latitude and longitude to a locator by 
789 using this command with a latitude and longitude as an argument, for
790 example:-
791
792 SH/QRA 52 41 N 0 58 E
793
794 === 0^SHOW/SATELLITE <name> [<hours> <interval>]^Show tracking data
795 Show the tracking data from your location to the satellite of your choice
796 from now on for the next few hours.
797
798 If you use this command without a satellite name it will display a list
799 of all the satellites known currently to the system. 
800
801 If you give a name then you can obtain tracking data of all the passes
802 that start and finish 5 degrees below the horizon. As default it will
803 give information for the next three hours for every five minute period.
804
805 You can alter the number of hours and the step size, within certain 
806 limits. 
807
808 Each pass in a period is separated with a row of '-----' characters
809
810 So for example:-
811
812 SH/SAT AO-10 
813 SH/SAT FENGYUN1 12 2
814
815 === 0^SHOW/SUN [<prefix>|<callsign>]^Show sun rise and set times
816 Show the sun rise and set times for a (list of) prefixes or callsigns, 
817 together with the azimuth and elevation of the sun currently at those
818 locations.
819
820 If you don't specify any prefixes or callsigns, it will show the times for
821 your QTH (assuming you have set it with either SET/LOCATION or SET/QRA),
822 together with the current azimuth and elevation.
823
824 If all else fails it will show the sunrise and set times for the node
825 that you are connected to. 
826
827 For example:-
828
829   SH/SUN
830   SH/SUN G1TLH K9CW ZS
831
832 === 0^SHOW/TIME [<prefix>|<callsign>]^Show the local time 
833 If no prefixes or callsigns are given then this command returns the local
834 time and UTC as the computer has it right now. If you give some prefixes
835 then it will show UTC and UTC + the local offset (not including DST) at
836 the prefixes or callsigns that you specify.
837
838 === 0^SHOW/WCY^Show last 10 WCY broadcasts
839 === 0^SHOW/WCY <n>^Show last <n> WCY broadcasts
840 Display the most recent WCY information that has been received by the system
841
842 === 0^SHOW/WWV^Show last 10 WWV broadcasts
843 === 0^SHOW/WWV <n>^Show last <n> WWV broadcasts
844 Display the most recent WWV information that has been received by the system
845
846 === 5^SHUTDOWN^Shutdown the cluster
847 Shutdown the cluster and disconnect all the users 
848
849 === 5^STAT/DB <dbname>^Show the status of a database
850 Show the internal status of a database descriptor.
851
852 Depending on your privilege level you will see more or less information. 
853 This command is unlikely to be of much use to anyone other than a sysop.
854
855 === 5^STAT/CHANNEL [<callsign>]^Show the status of a channel on the cluster
856 Show the internal status of the channel object either for the channel that 
857 you are on or else for the callsign that you asked for.
858
859 Only the fields that are defined (in perl term) will be displayed.
860
861 === 5^STAT/MSG <msgno>^Show the status of a message
862 This command shows the internal status of a message and includes information
863 such as to whom it has been forwarded, its size, origin etc etc.
864
865 === 5^STAT/USER [<callsign>]^Show the full status of a user
866 Shows the full contents of a user record including all the secret flags
867 and stuff.
868
869 Only the fields that are defined (in perl term) will be displayed.
870
871 === 0^SYSOP^Regain your privileges if you login remotely
872 The system automatically reduces your privilege level to that of a
873 normal user if you login in remotely. This command allows you to
874 regain your normal privilege level. It uses the normal system: five
875 numbers are returned that are indexes into the character array that is
876 your assigned password (see SET/PASSWORD). The indexes start from
877 zero.
878
879 You are expected to return a string which contains the characters
880 required in the correct order. You may intersperse those characters
881 with others to obscure your reply for any watchers. For example (and
882 these values are for explanation :-):
883
884   password = 012345678901234567890123456789
885   > sysop
886   22 10 15 17 3
887 you type:-
888  aa2bbbb0ccc5ddd7xxx3n
889  or 2 0 5 7 3
890  or 20573
891
892 They will all match. If there is no password you will still be offered
893 numbers but nothing will happen when you input a string. Any match is
894 case sensitive.
895
896 === 0^TALK <call> <text>^Send a text message to another station
897 === 0^TALK <call> > <node> <text>^Send a text message to another station via a node
898 Send a short message to any other station that is visible on the cluster
899 system. You can send it to anyone you can see with a SHOW/CONFIGURATION 
900 command, they don't have to be connected locally.
901
902 The second form of TALK is used when other cluster nodes are connected
903 with restricted information. This usually means that they don't send 
904 the user information usually associated with logging on and off the cluster.
905
906 If you know that G3JNB is likely to be present on GB7TLH, but you can only
907 see GB7TLH in the SH/C list but with no users, then you would use the
908 second form of the talk message.
909
910 === 0^TYPE <filearea>/<name>^Look at the contents of a file in one of the fileareas
911 Type out the contents of a file in a filearea. So, for example, in 
912 filearea 'bulletins' you want to look at file 'arld051' you would 
913 enter:-
914    TYPE bulletins/arld051
915
916 See also SHOW/FILES to see what fileareas are available and a 
917 list of content.
918
919 === 0^WHO^Show who is physically connected
920 This is a quick listing that shows which callsigns are connected and
921 what sort of connection they have
922
923 === 0^WX <text>^Send a weather message to local users
924 === 0^WX FULL <text>^Send a weather message to all cluster users
925 === 5^WX SYSOP <text>^Send a weather message to other clusters only
926 Weather messages can sometimes be useful if you are experiencing an extreme
927 that may indicate enhanced conditions
928