minor changes to the admin manual
authorg0vgs <g0vgs>
Sat, 8 Dec 2001 15:41:59 +0000 (15:41 +0000)
committerg0vgs <g0vgs>
Sat, 8 Dec 2001 15:41:59 +0000 (15:41 +0000)
html/adminmanual-1.html
sgml/adminmanual.sgml
txt/adminmanual.txt

index b3881f67277a1d5df7c0afb67fd77b70a7ed635e..9bcb2d0602dff3ec16637c9dfb838ae7157ab78e 100644 (file)
@@ -515,6 +515,24 @@ $def_hopcount = 5;
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 <P>
+<P>SHould any of the nodecalls include an ssid, it is important to wrap the
+whole call in single quotes, like this ...
+<P>
+<BLOCKQUOTE><CODE>
+<PRE>
+ 'DB0FHF-15' => {
+                        11 => 5,
+                        12 => 8,
+                        16 => 8,
+                        17 => 8,
+                        19 => 8,
+                        21 => 8,
+                   },
+</PRE>
+</CODE></BLOCKQUOTE>
+<P>If you do not do this, you will get errors and the file will not work as
+expected.
+<P>
 <P>You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <EM>load/hops</EM> will 
 bring your changes into effect.
index 92831277ca7a166bca4f7817d120ea6a70af8279..16d03127a2347ad14c32f4475bc7606bbb7983de 100644 (file)
@@ -514,6 +514,24 @@ Each set of hops is contained within a pair of curly braces and contains a
 series of PC frame types.  PC11 for example is a DX spot. The figures here 
 are not exhaustive but should give you a good idea of how the file works.
 
+<P>
+SHould any of the nodecalls include an ssid, it is important to wrap the
+whole call in single quotes, like this ...
+
+<tscreen><verb>
+ 'DB0FHF-15' => {
+                        11 => 5,
+                        12 => 8,
+                        16 => 8,
+                        17 => 8,
+                        19 => 8,
+                        21 => 8,
+                   },
+</verb></tscreen>
+
+If you do not do this, you will get errors and the file will not work as
+expected.
+
 <P>
 You can alter this file at any time, including whilst the cluster is running.  
 If you alter the file during runtime, the command <em>load/hops</em> will 
index ba88f983dde6d795e6bbece5e23e118e2531386a..d0136c57f1823fcbd1273f4a8a2aacbf62ff232a 100644 (file)
   how the file works.
 
 
+  SHould any of the nodecalls include an ssid, it is important to wrap
+  the whole call in single quotes, like this ...
+
+
+
+
+   'DB0FHF-15' => {
+                          11 => 5,
+                          12 => 8,
+                          16 => 8,
+                          17 => 8,
+                          19 => 8,
+                          21 => 8,
+                     },
+
+
+
+
+  If you do not do this, you will get errors and the file will not work
+  as expected.
+
+
   You can alter this file at any time, including whilst the cluster is
   running.  If you alter the file during runtime, the command load/hops
   will bring your changes into effect.
 
 
-
   1.11.  Hop Control on Specific Nodes
 
   You can set a callsign specific hop count for any of the standard
 
 
 
+       # the list of regexes for messages that we won't store having
+       # received them (bear in mind that we must receive them fully before
+       # we can bin them)
 
 
+       # The format of each line is as follows
 
+       #     type      source             pattern
+       #     P/B/F     T/F/O/S            regex
 
-  # the list of regexes for messages that we won't store having
-  # received them (bear in mind that we must receive them fully before
-  # we can bin them)
-
-
-  # The format of each line is as follows
-
-  #     type      source             pattern
-  #     P/B/F     T/F/O/S            regex
-
-  # type: P - private, B - bulletin (msg), F - file (ak1a bull)
-  # source: T - to field, F - from field,  O - origin, S - subject
-  # pattern: a perl regex on the field requested
+       # type: P - private, B - bulletin (msg), F - file (ak1a bull)
+       # source: T - to field, F - from field,  O - origin, S - subject
+       # pattern: a perl regex on the field requested
 
-  # Currently only type B and P msgs are affected by this code.
-  #
-  # The list is read from the top down, the first pattern that matches
-  # causes the action to be taken.
+       # Currently only type B and P msgs are affected by this code.
+       #
+       # The list is read from the top down, the first pattern that matches
+       # causes the action to be taken.
 
-  # The pattern can be undef or 0 in which case it will always be selected
-  # for the action specified
+       # The pattern can be undef or 0 in which case it will always be selected
+       # for the action specified
 
 
 
-  package DXMsg;
+       package DXMsg;
 
-  @badmsg = (
-  );
+       @badmsg = (
+       );
 
 
 
   of show/baddx, show/badspotter and show/badnode.
 
 
+
+
+
   3.  Mail
 
   DXSpider deals seamlessly with standard AK1A type mail.  It supports
   default method of sending mail and so a simple s for send will do.  A
   full list of the send commands and options is in the command set
   section, so I will not duplicate them here.
+
+
   3.2.  Bulletin mail
 
   Bulletin mail is sent by using the sb command.  This is one of the
 
 
 
-       #
-       # this is an example message forwarding file for the system
-       #
-       # The format of each line is as follows
-       #
-       #     type    to/from/at pattern action  destinations
-       #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
-       #
-       # type: P - private, B - bulletin (msg), F - file (ak1a bull)
-       # to/from/at: T - to field, F - from field, A - home bbs, O - origin
-       # pattern: a perl regex on the field requested
-       # action: I - ignore, F - forward
-       # destinations: a reference to an array containing node callsigns
-       #
-       # if it is non-private and isn't in here then it won't get forwarded
-       #
-       # Currently only type B msgs are affected by this code.
-       #
-       # The list is read from the top down, the first pattern that matches
-       # causes the action to be taken.
-       #
-       # The pattern can be undef or 0 in which case it will always be selected
-       # for the action specified
-       #
-       # If the BBS list is undef or 0 and the action is 'F' (and it matches the
-       # pattern) then it will always be forwarded to every node that doesn't have
-       # it (I strongly recommend you don't use this unless you REALLY mean it, if
-       # you allow a new link with this on EVERY bull will be forwarded immediately
-       # on first connection)
-       #
 
-       package DXMsg;
 
-       @forward = (
-       );
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+  #
+  # this is an example message forwarding file for the system
+  #
+  # The format of each line is as follows
+  #
+  #     type    to/from/at pattern action  destinations
+  #     P/B/F     T/F/A     regex   I/F    [ call [, call ...] ]
+  #
+  # type: P - private, B - bulletin (msg), F - file (ak1a bull)
+  # to/from/at: T - to field, F - from field, A - home bbs, O - origin
+  # pattern: a perl regex on the field requested
+  # action: I - ignore, F - forward
+  # destinations: a reference to an array containing node callsigns
+  #
+  # if it is non-private and isn't in here then it won't get forwarded
+  #
+  # Currently only type B msgs are affected by this code.
+  #
+  # The list is read from the top down, the first pattern that matches
+  # causes the action to be taken.
+  #
+  # The pattern can be undef or 0 in which case it will always be selected
+  # for the action specified
+  #
+  # If the BBS list is undef or 0 and the action is 'F' (and it matches the
+  # pattern) then it will always be forwarded to every node that doesn't have
+  # it (I strongly recommend you don't use this unless you REALLY mean it, if
+  # you allow a new link with this on EVERY bull will be forwarded immediately
+  # on first connection)
+  #
+
+  package DXMsg;
+
+  @forward = (
+  );
 
 
 
 
 
 
-         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 waiting 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 waiting 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
 
 
 
          Times read: 0
        G0VGS de GB7MBC 28-Jan-2001 1308Z >
 
+
+
+
+
   3.6.  Filtering mail
 
   This is described in the section on Other filters so I will not
   SYSOP.pl that caters for the UK sysops.
 
 
-
        qw(GB7TLH GB7DJK GB7DXM GB7CDX GB7BPQ GB7DXN GB7MBC GB7MBC-6 GB7MDX
           GB7NDX GB7SDX GB7TDX GB7UDX GB7YDX GB7ADX GB7BAA GB7DXA GB7DXH
           GB7DXK GB7DXI GB7DXS)
 
 
 
-
-
-
-
-
-
-
-
-  #
-  # startup script example
-  #
-  # set maximum no of spots allowed to 100
-  # set/var $Spot::maxspots = 1
-  #
-  # Set registration on
-  # set/var $main::reqreg = 1
-  #
-  # Set passwords on
-  # set/var $main::passwdreq = 1
-  #
+       #
+       # startup script example
+       #
+       # set maximum no of spots allowed to 100
+       # set/var $Spot::maxspots = 1
+       #
+       # Set registration on
+       # set/var $main::reqreg = 1
+       #
+       # Set passwords on
+       # set/var $main::passwdreq = 1
+       #
 
 
 
   eventually users will be able to set their own.  An example is
   included in the distibution but here is a further example.
 
-
-
        #
        # G0FYD
        #
 
 
 
+
   This will update the existing local oblast database or create it if it
   does not exist.
 
 
 
 
+
+
   5.4.  Looking up databases
 
   To look for information in a defined database, simply use the dbshow
   If you remove a database it ceases to exist and would have to be
   created from scratch if you still required it.
 
+
   6.  Information, files and useful programs
 
   6.1.  MOTD
   registered they will receive the same message as any other user.
 
 
+
+
   6.3.  Downtime message
 
   If for any reason the cluster is down, maybe for upgrade or
 
 
 
-
   You can see that in the files area (basically the packclus directory)
   there is a file called news and a directory called bulletin.  You can
   also see that dates they were created.  In the case of the file news,
 
 
 
-
-
-
-  type bulletin/opdx391
-  Ohio/Penn DX Bulletin No. 391
-  The Ohio/Penn Dx PacketCluster
-  DX Bulletin No. 391
-  BID: $OPDX.391
-  January 11, 1999
-  Editor Tedd Mirgliotta, KB8NW
-  Provided by BARF-80 BBS Cleveland, Ohio
-  Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
-  Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
-  Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
-  & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
-  Press Enter to continue, A to abort (508 lines) >
+       type bulletin/opdx391
+       Ohio/Penn DX Bulletin No. 391
+       The Ohio/Penn Dx PacketCluster
+       DX Bulletin No. 391
+       BID: $OPDX.391
+       January 11, 1999
+       Editor Tedd Mirgliotta, KB8NW
+       Provided by BARF-80 BBS Cleveland, Ohio
+       Online at 440-237-8208 28.8k-1200 Baud 8/N/1 (New Area Code!)
+       Thanks to the Northern Ohio Amateur Radio Society, Northern Ohio DX
+       Association, Ohio/Penn PacketCluster Network, K1XN & Golist, WB2RAJ/WB2YQH
+       & The 59(9) DXReport, W3UR & The Daily DX, K3TEJ, KN4UG, W4DC, NC6J, N6HR,
+       Press Enter to continue, A to abort (508 lines) >
 
 
 
 
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+