1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
4 <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9">
5 <TITLE>The DXSpider Installation and Administration Manual : Sysop commands</TITLE>
6 <LINK HREF="adminmanual-6.html" REL=previous>
7 <LINK HREF="adminmanual.html#toc7" REL=contents>
11 <A HREF="adminmanual-6.html">Previous</A>
12 <A HREF="adminmanual.html#toc7">Contents</A>
14 <H2><A NAME="s7">7. Sysop commands</A></H2>
16 <P>Most maintenance tasks are automatic but there are some commands that are useful for a sysop. These are listed below in alphabetical order. The number in brackets following the command name is the permissions level needed to use the command.
18 <H2><A NAME="ss7.1">7.1 announce sysop (5)</A>
21 <P><CODE><B>announce sysop <text></B></CODE>
23 <P>Send an announcement to Sysops only
25 <H2><A NAME="ss7.2">7.2 connect (5) </A>
28 <P><CODE><B>connect <callsign></B> Start a connection to another DX Cluster</CODE>
30 <P>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>.
36 <H2><A NAME="ss7.3">7.3 catch (9) </A>
39 <P><CODE><B><node_call> All [<msgno> ...]</B> Mark a message as sent</CODE>
41 <P>When you send messages the fact that you have forwarded it to another node
42 is remembered so that it isn't sent again. When you have a new partner
43 node and you add their callsign to your /spider/msg/forward.pl file, all
44 outstanding non-private messages will be forwarded to them. This may well
45 be ALL the non-private messages. You can prevent this by using these
48 catch GB7DJK 300 301 302 303
49 <P>and to undo what you have just done:-
51 uncatch GB7DJK 300 301 302 303
52 <P>which will arrange for them to be forward candidates again.
54 <H2><A NAME="ss7.4">7.4 dbcreate (9)</A>
57 <P><CODE><B>dbcreate <name></B> Create a database entry<BR>
58 <B>dbcreate <name> chain <name> [<name>..]</B> Create a chained database entry<BR>
59 <B>dbcreate <name> remote <node></B> Create a remote database entry<BR></CODE>
61 <P>DBCREATE allows you to define a database in the system. It doesn't actually
62 create anything, just defines it.
63 <P>The databases that are created are simple DB_File hash databases, they are
64 therefore already 'indexed'.
65 <P>You can define a local database with the first form of the command eg:
67 <P>You can also chain databases with the addition of the 'chain' keyword.
68 This will search each database one after the other. A typical example
70 <P>DBCREATE sdx_qsl chain sql_ad
71 <P>No checking is done to see if the any of the chained databases exist, in
72 fact it is usually better to do the above statement first then do each of
73 the chained databases.
74 <P>Databases can exist offsite. To define a database that lives on another
76 <P>DBCREATE buckmaster remote gb7dxc
77 <P>Remote databases cannot be chained; however, the last database in a
78 a chain can be a remote database eg:
79 <P>DBCREATE qsl chain gb7dxc
80 <P>To see what databases have been defined do:
81 <P>DBAVAIL (or it will have been aliased to SHOW/COMMAND)
82 <P>It would be normal for you to add an entry into your local Aliases file
83 to allow people to use the 'SHOW/<dbname>' style syntax. So you would
84 need to add a line like:-
91 '^sh\w*/buc', 'dbshow buckmaster', 'dbshow',
99 <P>to work as they may be used to.
100 <P>See DBIMPORT for the importing of existing AK1A format data to databases.
101 See DBSHOW for generic database enquiry
103 <H2><A NAME="ss7.5">7.5 dbimport (9)</A>
106 <P><CODE><B>dbimport <dbname></B> Import AK1A data into a database</CODE>
108 <P>If you want to import or update data in bulk to a database you can use
109 this command. It will either create or update entries into an existing
110 database. For example:-
111 <P>DBIMPORT oblast /tmp/OBLAST.FUL
112 <P>will import the standard OBLAST database that comes with AK1A into the
113 oblast database held locally.
115 <H2><A NAME="ss7.6">7.6 dbremove (9)</A>
118 <P><CODE><B>dbremove <dbname></B> Delete a database</CODE>
120 <P>DBREMOVE will completely remove a database entry and also delete any data
121 file that is associated with it.
122 <P>There is no warning, no comeback, no safety net.
125 <P>will remove the oblast database from the system and it will also remove
126 the associated datafile.
128 <P>There is no warning, no comeback, no safety net.
129 <P>You have been warned.
131 <H2><A NAME="ss7.7">7.7 debug (9)</A>
134 <P><CODE><B>debug</B> Set the cluster program into debug mode</CODE>
136 <P>Executing this command will only have an effect if you are running the cluster
144 <P>It will interrupt the cluster just after the debug command has finished.
146 <H2><A NAME="ss7.8">7.8 directory (5)</A>
149 <P>Works just like the user command except that sysops can see ALL messages.
151 <H2><A NAME="ss7.9">7.9 disconnect (8)</A>
154 <P><CODE><B>disconnect <call> [<call> ...]</B> Disconnect a user or node</CODE>
156 <P>Disconnect any <call> connected locally
158 <H2><A NAME="ss7.10">7.10 export (9)</A>
161 <P><CODE><B>export <msgno> <filename></B> Export a message to a file</CODE>
163 <P>Export a message to a file. This command can only be executed on a local
164 console with a fully privileged user. The file produced will be in a form
165 ready to be imported back into the cluster by placing it in the import
166 directory (/spider/msg/import).
167 <P>This command cannot overwrite an existing file. This is to provide some
168 measure of security. Any files written will owned by the same user as the
169 main cluster, otherwise you can put the new files anywhere the cluster can
170 access. For example:-
171 <P>EXPORT 2345 /tmp/a
173 <H2><A NAME="ss7.11">7.11 forward/opername (1)</A>
176 <P><CODE><B>forward/opername <call></B> Send out information on this <call> to all clusters</CODE>
178 <P>This command sends out any information held in the user file which can
179 be broadcast in PC41 protocol packets. This information is Name, QTH, Location
180 and Homenode. PC41s are only sent for the information that is available.
182 <H2><A NAME="ss7.12">7.12 init (5)</A>
185 <P><CODE><B>init <node call></B> Re-initialise a link to an AK1A compatible node</CODE>
187 <P>This command attempts to re-initialise a link to a (usually) AK1A node
188 that has got confused, usually by a protocol loop of some kind. It may
189 work - but you usually will be better off simply disconnecting it (or
190 better, if it is a real AK1A node, doing an RCMD <node> DISC/F <your
192 <P>Best of luck - you will need it.
194 <H2><A NAME="ss7.13">7.13 kill (5)</A>
197 <P><CODE><B>kill <msgno> [<msgno> ...]</B> Remove or erase a message from the system<BR>
198 <B>kill from <call></B> Remove all messages from a callsign<BR>
199 <B>kill to <call></B> Remove all messages to a callsign<BR></CODE>
201 <P>You can get rid of any message to or originating from your callsign using
202 this command. You can remove more than one message at a time.
203 <P>As a sysop you can kill any message on the system.
205 <H2><A NAME="ss7.14">7.14 kill full (5)</A>
206 <CODE><B>kill full <msgno> [<msgno>]</B> Delete a message from the whole cluster</CODE></H2>
208 <P>Delete a message (usually a 'bulletin') from the whole cluster system.
209 <P>This uses the subject field, so any messages that have exactly the same subject
210 will be deleted. Beware!
212 <H2><A NAME="ss7.15">7.15 load/aliases (9)</A>
215 <P><CODE><B>load/aliases</B> Reload the command alias table</CODE>
217 <P>Reload the /spider/cmd/Aliases file after you have editted it. You will need to
218 do this if you change this file whilst the cluster is running in order for the
219 changes to take effect.
221 <H2><A NAME="ss7.16">7.16 load/bands (9)</A>
224 <P><CODE><B>load/bands</B> Reload the band limits table</CODE>
226 <P>Reload the /spider/data/bands.pl file if you have changed it manually whilst
227 the cluster is running.
229 <H2><A NAME="ss7.17">7.17 load/cmd_cache (9)</A>
232 <P><CODE><B>load/cmd_cache</B> Reload the automatic command cache</CODE>
234 <P>Normally, if you change a command file in the cmd or local_cmd tree it will
235 automatially be picked up by the cluster program. Sometimes it can get confused
236 if you are doing a lot of moving commands about or delete a command in the
237 local_cmd tree and want to use the normal one again. Execute this command to
238 reset everything back to the state it was just after a cluster restart.
240 <H2><A NAME="ss7.18">7.18 load/messages (9)</A>
243 <P><CODE><B>load/messages</B> Reload the system messages file</CODE>
245 <P>If you change the /spider/perl/Messages file (usually whilst fiddling/writing ne
246 commands) you can have them take effect during a cluster session by executing this
247 command. You need to do this if get something like :-
248 <P>unknown message 'xxxx' in lang 'en'
250 <H2><A NAME="ss7.19">7.19 load/prefixes (9)</A>
253 <P><CODE><B>load/prefixes</B> Reload the prefix table</CODE>
255 <P>Reload the /spider/data/prefix_data.pl file if you have changed it manually whilst
256 the cluster is running.
258 <H2><A NAME="ss7.20">7.20 merge (5)</A>
261 <P><CODE><B>merge <node> [<no spots>/<no wwv>]</B> Ask for the latest spots and WWV</CODE>
263 <P>MERGE allows you to bring your spot and wwv database up to date. By default
264 it will request the last 10 spots and 5 WWVs from the node you select. The
265 node must be connected locally.
266 <P>You can request any number of spots or wwv and although they will be appended
267 to your databases they will not duplicate any that have recently been added
268 (the last 2 days for spots and last month for WWV data).
270 <H2><A NAME="ss7.21">7.21 msg (9)</A>
273 <P><CODE><B>msg <cmd> <msgno> [data ...]</B> Alter various message parameters</CODE>
275 <P>Alter message parameters like To, From, Subject, whether private or bulletin
276 or return receipt (RR) is required or whether to keep this message from timing
281 MSG TO <msgno> <call> - change TO callsign to <call>
282 MSG FRom <msgno> <call> - change FROM callsign to <call>
283 MSG PRrivate <msgno> - set private flag
284 MSG NOPRrivate <msgno> - unset private flag
285 MSG RR <msgno> - set RR flag
286 MSG NORR <msgno> - unset RR flag
287 MSG KEep <msgno> - set the keep flag (message won't be deleted ever)
288 MSG NOKEep <msgno> - unset the keep flag
289 MSG SUbject <msgno> <new> - change the subject to <new>
290 MSG WAittime <msgno> - remove any waitting time for this message
291 MSG NOREad <msgno> - mark message as unread
292 MSG REad <msgno> - mark message as read
293 MSG QUeue - queue any outstanding bulletins
294 MSG QUeue 1 - queue any outstanding private messages
297 <P>You can look at the status of a message by using:-
298 <P>STAT/MSG <msgno>
299 <P>This will display more information on the message than DIR does.
301 <H2><A NAME="ss7.22">7.22 pc (8)</A>
304 <P><CODE><B>pc <call> <text></B> Send text (eg PC Protocol) to <call></CODE>
306 <P>Send some arbitrary text to a locally connected callsign. No processing is done on
307 the text. This command allows you to send PC Protocol to unstick things if problems
308 arise (messages get stuck etc). eg:-
309 <P>pc gb7djk PC33^GB7TLH^GB7DJK^400^
310 <P>You can also use in the same way as a talk command to a connected user but
311 without any processing, added of "from <blah> to <blah>" or whatever.
312 <P>pc G1TLH Try doing that properly!!!
314 <H2><A NAME="ss7.23">7.23 ping (1)</A>
317 <P><CODE><B>ping <node></B> Send a ping command to another cluster node</CODE>
319 <P>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 <P>Any visible cluster node can be PINGed.
324 <H2><A NAME="ss7.24">7.24 rcmd (1)</A>
327 <P><CODE><B>rcmd <node call> <cmd></B> Send a command to another DX cluster</CODE>
329 <P>This command allows you to send nearly any command to another DX Cluster
330 node that is connected to the system.
331 <P>Whether you get any output is dependant on a) whether the other system knows
332 that the node callsign of this cluster is in fact a node b) whether the
333 other system is allowing RCMDs from this node and c) whether you have
334 permission to send this command at all.
336 <H2><A NAME="ss7.25">7.25 read (5)</A>
339 <P><CODE><B>read <msgno></B> Read a message on the system</CODE>
341 <P>As a sysop you may read any message on the system
343 <H2><A NAME="ss7.26">7.26 set/debug (9)</A>
346 <P><CODE><B>set/debug <name></B> Add a debug level to the debug set</CODE>
348 <P>You can remove this level with unset/debug <name>
350 <H2><A NAME="ss7.27">7.27 set/isolate (9)</A>
353 <P><CODE><B>set/isolate <node call></B> Isolate a node from the rest of the network</CODE>
355 <P>Connect a node to your system in such a way that you are a full protocol
356 member of its network and can see all spots on it, but nothing either leaks
357 out from it nor goes back into from the rest of the nodes connected to you.
358 <P>You can potentially connect several nodes in this way.
359 <P>You can see which nodes are isolated with the show/isolate (1) command.
360 <P>You can remove the isolation with the command unset/isolate.
362 <H2><A NAME="ss7.28">7.28 set/sys_location (9)</A>
365 <P><CODE><B>set/sys_location <lat & long></B> Set your cluster latitude and longitude</CODE>
367 <P>In order to get accurate headings and such like you must tell the system
368 what your latitude and longitude is. If you have not yet done a SET/QRA
369 then this command will set your QRA locator for you. For example:-
370 <P>SET/LOCATION 52 22 N 0 57 E
372 <H2><A NAME="ss7.29">7.29 set/lockout (9)</A>
375 <P><CODE><B>set/lockout <call></B> Stop a callsign connecting to the cluster</CODE>
377 <P>You can show who is locked out with the show/lockout (9) command.
378 <P>To allow the user to connect again, use the command unset/lockout
380 <H2><A NAME="ss7.30">7.30 set/node (9)</A>
383 <P><CODE><B>set/node <call> [<call> ...]</B> Make the callsign an AK1A cluster</CODE>
385 <P>Tell the system that the call(s) are to be treated as AK1A cluster and
386 fed PC Protocol rather normal user commands.
387 <P>From version 1.41 you can also set the following types of cluster
395 <P>To see what your nodes are set to, use the show/nodes command.
397 <H2><A NAME="ss7.31">7.31 set/obscount (9)</A>
400 <P><CODE><B>set/obscount <count> <node call></B> Set the 'pump-up' obscelence counter</CODE>
402 <P>From version 1.35 onwards neighbouring nodes are pinged at regular intervals (see
403 SET/PINGINTERVAL), usually 300 seconds or 5 minutes. There is a 'pump-up'
404 counter which is decremented on every outgoing ping and then reset to
405 the 'obscount' value on every incoming ping. The default value of this
407 <P>What this means is that a neighbouring node will be pinged twice at
408 (default) 300 second intervals and if no reply has been heard just before
409 what would be the third attempt, that node is disconnected.
410 <P>If a ping is heard then the obscount is reset to the full value. Using
411 default values, if a node has not responded to a ping within 15 minutes,
414 <H2><A NAME="ss7.32">7.32 set/pinginterval (9)</A>
417 <P><CODE><B>set/pinginterval <time> <node call></B> Set the ping time to neighbouring nodes</CODE>
419 <P>As from version 1.35 all neighbouring nodes are pinged at regular intervals
420 in order to determine the rolling quality of the link and, in future, to
421 affect routing decisions. The default interval is 300 secs or 5 minutes.
422 <P>You can use this command to set a different interval. Please don't.
423 <P>But if you do the value you enter is treated as minutes up 60 and seconds
424 for numbers greater than that.
425 <P>This is used also to help determine when a link is down at the far end
426 (as certain cluster software doesn't always notice), see SET/OBSCOUNT
427 for more information.
429 <H2><A NAME="ss7.33">7.33 set/privilege (9)</A>
432 <P><CODE><B>set/privilege <n> <call> [<call> ...]</B> Set the privilege level on a call</CODE>
434 <P>Set the privilege level on a callsign. The privilege levels that pertain
435 to commands are as default:-
440 1 - allow remote nodes normal user RCMDs
441 5 - various privileged commands (including shutdown, but not disc-
442 connect), the normal level for another node.
443 8 - more privileged commands (including disconnect)
444 9 - local sysop privilege. DO NOT SET ANY REMOTE USER OR NODE TO THIS
448 <P>If you are a sysop and you come in as a normal user on a remote connection
449 your privilege will automatically be set to 0.
451 <H2><A NAME="ss7.34">7.34 set/password (9)</A>
454 <P><CODE><B>set/password <callsign> <string></B> Set a users password</CODE>
456 <P>The password for a user can only be set by a full sysop. The string
457 can contain any characters but any spaces are removed (you can type in
458 spaces - but they won't appear in the password). You can see the
459 result with STAT/USER. The password is the usual 30 character baycom
462 <H2><A NAME="ss7.35">7.35 set/sys_qra (9)</A>
465 <P><CODE><B>set/sys_qra <locator></B> Set your cluster QRA locator</CODE>
467 <H2><A NAME="ss7.36">7.36 show program (5)</A>
470 <P><CODE><B>show/program</B> Show the locations of all the included program modules</CODE>
472 <P>Show the name and location where every program module was load from. This
473 is useful for checking where you think you have loaded a .pm file from.
475 <H2><A NAME="ss7.37">7.37 shutdown (5)</A>
478 <P><CODE><B>shutdown</B> Shutdown the cluster</CODE>
480 <P>Shutdown the cluster and disconnect all the users. If you have Spider
481 set to respawn in /etc/inittab it will of course restart.
483 <H2><A NAME="ss7.38">7.38 spoof (9)</A>
486 <P><CODE><B>spoof <callsign> <command></B> Run commands as another user</CODE>
488 <P>This is a very simple yet powerful command for the sysop. It allows you to
489 issue commands as if you were a different user. This is very useful for the
490 kind of things that users seem to always get wrong.. like home_node for
493 <H2><A NAME="ss7.39">7.39 stat/db (5)</A>
496 <P><CODE><B>stat/db <dbname></B> Show the status of a database</CODE>
498 <P>Show the internal status of a database descriptor.
499 <P>Depending on your privilege level you will see more or less information.
500 This command is unlikely to be of much use to anyone other than a sysop.
502 <H2><A NAME="ss7.40">7.40 stat/channel (5)</A>
505 <P><CODE><B>stat/channel <callsign></B> Show the status of a channel on the cluster</CODE>
507 <P>Show the internal status of the channel object either for the channel that
508 you are on or else for the callsign that you asked for.
509 <P>Only the fields that are defined (in perl term) will be displayed.
511 <H2><A NAME="ss7.41">7.41 stat/msg (5)</A>
514 <P><CODE><B>stat/msg <msgno></B> Show the status of a message</CODE>
516 <P>This command shows the internal status of a message and includes information
517 such as to whom it has been forwarded, its size, origin etc etc.
519 <H2><A NAME="ss7.42">7.42 stat/user (5)</A>
522 <P><CODE><B>stat/user <callsign></B> Show the full status of a user</CODE>
524 <P>Shows the full contents of a user record including all the secret flags
526 <P>Only the fields that are defined (in perl term) will be displayed.
532 <A HREF="adminmanual-6.html">Previous</A>
533 <A HREF="adminmanual.html#toc7">Contents</A>