make some documentation changes and fix unset/register
[spider.git] / txt / adminmanual.txt
index 5887f5fc60f71bfefbccd830798bb06d78febae0..d8078515dd125c5efae856265fa768b1e498f5d3 100644 (file)
 
 
 
+
   You can create aliases for commands at will.  Beware though, these may
   not always turn out as you think.  Care is needed and you need to test
   the results once you have set an alias.
 
 
 
+
   would export message number 5467 as a file called keps.in in the
   /spider/perl directory.
 
+
   Now login to a VT as sysop and cd /spider/perl.  There is a command in
   the perl directory called convkeps.pl.  All we need to do now is
   convert the file like so ...
 
 
 
+
   Now go back to the cluster and issue the command ...
 
 
 
 
 
-  That is it!  the kepler data has been updated.
-
 
+  That is it!  the kepler data has been updated.
 
 
   6.8.  The QRZ callbook
   registered users, use the command show/register.
 
 
+
   7.2.  Passwords
 
   At the moment, passwords only affect users who login to a DXSpider
   CVS repository and then update your Spider source.  There are several
   steps which are listed below ...
 
-
   First login as the user sysop.  Next you need to connect to the CVS
   repository.  You do this with the command below ...
 
+
   cvs -d:pserver:anonymous@cvs.DXSpider.sourceforge.net:/cvsroot/dxspider login
 
 
          dest <prefixes>          eg: 6MUK,WDX      (distros)
 
 
+  some examples:-
 
 
-  some examples:-
 
          acc/ann dest 6MUK
          acc/ann 2 by_zone 14,15,16
   more info. Please read this to understand how filters work - it will
   save a lot of grief later on.
 
-
   You can use any of the following things in this line:-
 
 
+
          call <prefixes>        the callsign of the thingy
          call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
          call_itu <numbers>
 
 
 
-         freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
-         on <range>             same as 'freq'
-         call <prefixes>        eg: G,PA,HB9
-         info <string>          eg: iota or qsl
-         by <prefixes>
-         call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-         call_itu <numbers>
-         call_zone <numbers>
-         by_dxcc <numbers>
-         by_itu <numbers>
-         by_zone <numbers>
-         origin <prefixes>
-         channel <prefixes>
+
+
+
+
+
+
+
+
+
+
+
+
+    freq <range>           eg: 0/30000 or hf or hf/cw or 6m,4m,2m
+    on <range>             same as 'freq'
+    call <prefixes>        eg: G,PA,HB9
+    info <string>          eg: iota or qsl
+    by <prefixes>
+    call_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
+    call_itu <numbers>
+    call_zone <numbers>
+    by_dxcc <numbers>
+    by_itu <numbers>
+    by_zone <numbers>
+    origin <prefixes>
+    channel <prefixes>
+
+
 
 
 
 
 
 
-
-
-
-
-
-
-
-
-    by <prefixes>            eg: G,M,2
-    origin <prefixes>
-    origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-    origin_itu <numbers>
-    origin_zone <numbers>
-    by_dxcc <numbers>
-    by_itu <numbers>
-    by_zone <numbers>
-    channel <prefixes>
+         by <prefixes>            eg: G,M,2
+         origin <prefixes>
+         origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
+         origin_itu <numbers>
+         origin_zone <numbers>
+         by_dxcc <numbers>
+         by_itu <numbers>
+         by_zone <numbers>
+         channel <prefixes>
 
 
 
 
 
 
-         by <prefixes>            eg: G,M,2
-         origin <prefixes>
-         origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
-         origin_itu <numbers>
-         origin_zone <numbers>
-         by_dxcc <numbers>
-         by_itu <numbers>
-         by_zone <numbers>
-         channel <prefixes>
+
+
+
+
+
+
+    by <prefixes>            eg: G,M,2
+    origin <prefixes>
+    origin_dxcc <numbers>    eg: 61,62 (from eg: sh/pre G)
+    origin_itu <numbers>
+    origin_zone <numbers>
+    by_dxcc <numbers>
+    by_itu <numbers>
+    by_zone <numbers>
+    channel <prefixes>
 
 
 
   for example
 
 
+
          accept/wwv by_zone 4
 
 
 
   This command will send your announcement across the whole cluster
   network.
-
-
-
   9.12.  announce sysop (5)
 
   announce sysop <text>
   apropos <string> Search the help database
 
 
-
   Search the help database for <string> (it isn't case sensitive), and
   print the names of all the commands that may be relevant.
 
   This command allows you to clear (remove) a line in a route filter or
   to remove the whole filter.
 
-
   see CLEAR/SPOTS for a more detailed explanation.
 
   A sysop can clear an input or normal output filter for a user or the
   node_default or user_default.
 
 
-
-
-
   9.20.  clear/wcy (0)
 
   clear/wcy [1|all] Clear a WCY filter line
 
   to allow
 
+
   SH/BUCK g1tlh
 
   to work as they may be used to.
   databases.  See DBSHOW for generic database enquiry
 
 
-
-
   9.27.  dbimport (9)
 
   dbimport <dbname> Import AK1A data into a database
 
   but if he hasn't and the database really does exist (use DBAVAIL or
   SHOW/COMMAND to find out) you can do the same thing with:
+         DBSHOW buck G1TLH
 
 
 
-         DBSHOW buck G1TLH
-
 
 
 
 
 
 
-          DIR TO G1TLH 5
-       or
-          DIR SUBJECT IOTA 200-250
+
+
+     DIR TO G1TLH 5
+  or
+     DIR SUBJECT IOTA 200-250
 
 
 
 
   You can abbreviate all the commands to one letter and use ak1a
   syntax:-
+
+
+
           DIR/T G1* 10
           DIR/S QSL 10-100 5
 
 
 
 
-          DX by G1TLH FR0G 144.600 he isn't on the cluster
+
+     DX by G1TLH FR0G 144.600 he isn't on the cluster
 
 
 
 
   export <msgno> <filename> Export a message to a file
 
+
   Export a message to a file. This command can only be executed on a
   local console with a fully privileged user. The file produced will be
   in a form ready to be imported back into the cluster by placing it in
 
   clear/spots 1
 
-
   To remove the filter in its entirty:-
 
   clear/spots all
   same subject will be deleted. Beware!
 
 
+
+
   9.46.  kill/expunge (6)
 
   kill/expunge <msgno> [<msgno>..]Expunge a message
   It otherwise is used in the same way as the KILL command.
 
 
+
   9.47.  links (0)
 
   links Show which nodes are physically connected
 
   load/bands Reload the band limits table
 
-
   Reload the /spider/data/bands.pl file if you have changed it manually
   whilst the cluster is running.
 
   delete a command in the local_cmd tree and want to use the normal one
   again. Execute this command to reset everything back to the state it
   was just after a cluster restart.
+
+
   9.53.  load/forward (9)
 
   load/forward Reload the msg forwarding routing table
 
   msg <cmd> <msgno> [data ...] Alter various message parameters
 
-
   Alter message parameters like To, From, Subject, whether private or
   bulletin or return receipt (RR) is required or whether to keep this
   message from timing out.
 
 
 
-
-
-
-
-
-
-
-
-
-
-    MSG TO <msgno> <call>     - change TO callsign to <call>
-    MSG FRom <msgno> <call>   - change FROM callsign to <call>
-    MSG PRrivate <msgno>      - set private flag
-    MSG NOPRrivate <msgno>    - unset private flag
-    MSG RR <msgno>            - set RR flag
-    MSG NORR <msgno>          - unset RR flag
-    MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
-    MSG NOKEep <msgno>        - unset the keep flag
-    MSG SUbject <msgno> <new> - change the subject to <new>
-    MSG WAittime <msgno>      - remove any waitting time for this message
-    MSG NOREad <msgno>        - mark message as unread
-    MSG REad <msgno>          - mark message as read
-    MSG QUeue                 - queue any outstanding bulletins
-    MSG QUeue 1               - queue any outstanding private messages
+         MSG TO <msgno> <call>     - change TO callsign to <call>
+         MSG FRom <msgno> <call>   - change FROM callsign to <call>
+         MSG PRrivate <msgno>      - set private flag
+         MSG NOPRrivate <msgno>    - unset private flag
+         MSG RR <msgno>            - set RR flag
+         MSG NORR <msgno>          - unset RR flag
+         MSG KEep <msgno>          - set the keep flag (message won't be deleted ever)
+         MSG NOKEep <msgno>        - unset the keep flag
+         MSG SUbject <msgno> <new> - change the subject to <new>
+         MSG WAittime <msgno>      - remove any waitting time for this message
+         MSG NOREad <msgno>        - mark message as unread
+         MSG REad <msgno>          - mark message as read
+         MSG QUeue                 - queue any outstanding bulletins
+         MSG QUeue 1               - queue any outstanding private messages
 
 
 
 
 
 
+
+
+
   9.60.  rcmd (1)
 
   rcmd <node call> <cmd> Send a command to another DX cluster
   This command allows you to send nearly any command to another DX
   Cluster node that is connected to the system.
 
-
   Whether you get any output is dependant on a) whether the other system
   knows that the node callsign of this cluster is in fact a node b)
   whether the other system is allowing RCMDs from this node and c)
 
 
 
+
   some examples:-
 
 
          origin_itu <numbers>
          origin_zone <numbers>
 
-
-
-
-
   some examples:-
 
 
 
-
-    rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
+         rej/route gb7djk call_dxcc 61,38 (everything except  UK+EIRE nodes)
 
 
 
          rej/spot 1 on hf
          rej/spot 2 on vhf and not (by_zone 14,15,16 or call_zone 14,15,16)
 
-
-
-
-
   You can use the tag 'all' to reject everything eg: