home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / bpq403a / commands.doc < prev    next >
Encoding:
Text File  |  1989-12-09  |  9.8 KB  |  268 lines
  1.         G8BPQ NODE COMMANDS
  2.  
  3.  
  4. This document explains the commands available within the Node section
  5. of the G8BPQ switch, and an explanation of the responses. 
  6.  
  7. First the result of inputting an invalid command:
  8.  
  9. NOTTS:G8BPQ-2} Invalid command - Enter ? for command list
  10.  
  11. Entering ? produces the following:
  12.  
  13. NOTTS:G8BPQ-2} BBS CONNECT BYE INFO NODES PORTS ROUTES USERS
  14.  
  15. Note that BBS is only present if the BBS support is enabled (BBS=1 in 
  16. th config file). If you have defined your own applications, they will also
  17. be listed.
  18.  
  19.  
  20. The BBS (and your other application names) must be entered in full - all other
  21. commands can be abbreviated to the first character of the command.
  22.  
  23.  
  24. Entering BBS (or your own application name) will connect you to the first
  25. free BBS (etc) port, or give an error message if none are available.
  26.  
  27.  
  28. The CONNECT command is used to connect you to another node, or to a normal
  29. AX.25 user. To connect to another node, enter C NODECALL or C NODEALIAS.
  30. The system will select the 'best' radio port and neighbour to to use to
  31. reach the required node using its ROUTES and NODES lists.
  32.  
  33. The format used to connect to another normal user depends on whether you
  34. have more than one radio port. The formats are:
  35.  
  36. (stuff in [] being optional)
  37.  
  38. C CALL [via digi1 [digi2...]]        If you only have one port
  39.  
  40.  
  41. C P CALL [via digi1 [digi2...]]         Where P is the port number,
  42.                     if you have more than 1.
  43.  
  44.  
  45. (You can use C 1 CALL if you only have 1 port - its just a waste of typing!)
  46.  
  47.  
  48. If you miss out the port number where it is needed, you will get an error
  49. message, listing the available ports.
  50.  
  51. Normally you cannot override the automatic route selection when you connect
  52. to another node, but you can fool the system into thinking a node is a
  53. normal station by connecting to the alias, and adding an SSID. For example,
  54. if you want to connect to NOTTS:G8BPQ-2, you can force a Level 2 connect
  55. on a secified port by entering C P NOTTS-1
  56.  
  57.  
  58.  
  59. The BYE commnad disconnects you from the switch.
  60.  
  61.  
  62.  
  63. The INFO command sends your INFO text from the config file:
  64.  
  65. NOTTS:G8BPQ-2} G8BPQ Packet Switch, Mapperley, Nottingham. IO92KX
  66. Commands are basically the same as NET/ROM, but to connect to another
  67. normal station (not another node), you must specify a port number before
  68. the callsign. Use PORTS command to list available ports. The BBS command
  69. connects you to the associated Mailbox.
  70.  
  71.  
  72.  
  73. The PORTS command lists available ports. The descriptions come directly
  74. from the configuration file, and should give at least the frequency and
  75. baud rate used.
  76.  
  77. NOTTS:G8BPQ-2} Ports:
  78.   1 144.650 MHz 1200 Baud (PC120)
  79.   2 432.675 MHz 1200 Baud (DRSI)
  80.   3 Experimental NET/ROM Link
  81.  
  82.  
  83.  
  84. The NODES command lists all the other NETROM/THENET/BPQ Nodes known to
  85. your node:
  86.  
  87. NOTTS:G8BPQ-2} Nodes:
  88. BBSTST:G8BPQ-1     DV7:G4RFG-1        LRG7:G0GDR-1       G4RFG-2
  89. LRGBBS:GB7LRG      AAABBS:GB7AAA      #LNX2:G4GOU-1      BM1:G7AXC-1
  90. BM2:G7AXC-2        BM7:G7AXC-7        DV2:G4RFG          DV6:G4RFG-3
  91. BOB432:G8HBE-3     NEC21:G8VPQ-2      FPV7:G4FPV-7       SY4:G3UQH-4
  92. WP4:G0KNR-4        LRG2:G0GDR-2       NEC22:G8VPQ-3      MM2:GB7MM-2
  93. TFONET:G8TFO-8     NEC90:G8VPQ-9      NH:G0HWC           RP2:GB3RP-2
  94. ADH2:G8ADH-2       SY7:GB7SY-7        HX2:GB7HX-2        WORC7:G8TIC-7
  95. WV2:G1RLI-2        TEWKS3:G6CMG-3     WB7:G4DVM-7        BOB650:G8HBE-2
  96. LED:GB7LED         SY8:G3UQH-8        VPQNET:G8VPQ-8     GH2:GB7GH-2
  97. SY2:G3UQH-2        FPV:G4FPV-2        AP2:GB7AP-2        LX2:GB7LX-2
  98. LX4:G6TNZ-1        LX7:GB7LX-7        RAYNET:GB7NRC      SF2:G8POT-2
  99. #NICK:GB7LRG-7     NEC72:G8VPQ-7      WORC2:G8TIC-2      PQ2:GB3PQ
  100. TEWKS4:G6CMG-4     BOB675:G8HBE-4     FPV71:G4FPV-8      TEWKS9:G6CMG-9
  101. TICNET:G8TIC-8     BRX:G4AKZ          SC4:G4AJJ-4        CD2:G6ANN-1
  102. TEWKS7:G6CMG-7     TCPIP:G4GOU        CHELT2:G4MEM-2     DROIT7:G8TFO-7
  103. DROIT2:G8TFO-2     MK6:G4WIM          MV2:G2AFD-2        SERVER:GB7AAA-9
  104. ERA24:G0DXX        WP1:GB7WP-1        WP2:GB7WP-2        WP7:GB7WP-7
  105. MK2:G4WIM-2        MK23:G4WIM-7       LNXBBS:GB7LNX-2    TVB:G6TVB
  106. #GATE0:G6CMG-5     #GATE1:G6CMG-6     WORC22:G8TIC-1     VPQ90:G8VPQ-10
  107. VPQ91:G8VPQ-11
  108.  
  109.  
  110. By entering N NODECALL (or N NODEALIAS), you can list the routes that
  111. the system will use to access that node:
  112.  
  113. n rp2
  114.  
  115. NOTTS:G8BPQ-2} Routes to: RP2:GB3RP-2
  116.   100 4 GB3RP-2
  117.   23 4 G0GDR-1
  118.   19 4 G0GDR-2
  119.  
  120.  
  121. The numbers displayed are the 'quality' - the relative desirability of
  122. using this route rather than another, and the Obsolesance Count, an
  123. indication of how long it is since the system was last told about (
  124. or successfully used) this route. The number starts at a value set in
  125. the config file (typically 5) and is decremented each time a 'NODES'
  126. broadcast is sent (typically evey hour).
  127.  
  128.  
  129.  
  130.  
  131. The ROUTES command lists the stations which this node can hear. 
  132.  
  133. NOTTS:G8BPQ-2} Routes:
  134. 2 G4RFG-1 0 0!
  135. 1 G4RFG 0 0!
  136. 1 GB7LX-2 0 0!
  137. 2 GB7LX-7 20 0!
  138. 2 G0GDR-1 120 62!
  139. 1 G0GDR-2 100 49!
  140. 2 G7AXC-7 50 41!
  141. 1 GB3RP-2 100 17!
  142. 1 G1EUP-8 50 0!
  143. 1 GB7LED 50 1!
  144. 1 G4XMH-1 50 0!
  145. 2 GB7LRG-7 10 0
  146.  
  147. The first number is the port. The second is the quality. This may be
  148. derived from the 'default quality' parameter in the PORTS section of the
  149. config file, or may be specified explicitly in the ROUTES section.
  150. A value of zero will prevent the route from being used, and is normally
  151. used when you have a one-way or marginal path. The third number is the
  152. number of NODES list entries which refer to this route. This isn't used
  153. by the software - it is just information for the user. The '!' indicates
  154. a 'locked route' - one entered in the CONFIG file. Other entries come and
  155. go as this node hears NODES broadcasts.
  156.  
  157.  
  158.  
  159. The USERS command lists the stations currently using the node.
  160.  
  161.  
  162. NOTTS:G8BPQ-2} G8BPQ Network System V3.21 (95)
  163. Host6(NOTTS:G8BPQ-2)
  164. Host3(NOTTS:G8BPQ-2)              <-->  Circuit(LRG7:G0GDR-1 G8BPQ-1)
  165. Uplink(G9XXX)                     <~~>  Downlink(G9YYY)        
  166.  
  167.  
  168. Host is an internal (Normally BBS Port)
  169. Circuit is a link from/to another node.
  170. Uplink is a connection from a normal Ax.25 station.
  171. Downlink is a connection to a normal user.
  172.  
  173. The <--> indicates an active session. <~~> indicates a session being set up.
  174.  
  175. The Number on the end of the header line is the number of free buffers.
  176.  
  177.  
  178.  
  179. There are a few commands not given in the menu. These are primarily of 
  180. interest to the sysop, (or for me to experiment with). They are LINKS,
  181. STATS, L4T1, and PACLEN.
  182.  
  183.  
  184. The LINKS command lists the currently active AX.25 Sessions (Both user
  185. access and node-node links)
  186.  
  187. NOTTS:G8BPQ-2} Links:
  188. G0GDR-1 G8BPQ-2 S=5 P=2 T=3 V=2
  189.  
  190. S is the link state (see AX25 protocol spec, but the main ones are 
  191.   2 (connecting) 4 (disconnecting) 5 (connected)).
  192. P is the port.
  193. T is the link type. 1=Uplink, 2=Downlink, 3=Node-Node link.
  194. V is the AX.25 Version (1 or 2).
  195.  
  196.  
  197.  
  198.  
  199. The STATS command displays a number of counters.
  200.  
  201. NOTTS:G8BPQ-2}
  202. Time active (mins)        77
  203. Timer Overruns             1
  204. Buffer pool empty          0
  205. Minimum free buffs        73
  206. Current free buffs        95
  207. L4 Frames Sent            11
  208. L4 Frames Received        31
  209. L4 Frames Resent           0
  210. L4 Connects Sent           4
  211. L4 Connects RXed           0
  212. L3 Frames Relayed          0
  213. L2 Frames Digi-ed          0        0        0
  214. L2 Frames Heard         2082     3539        0
  215. L2 Frames Received        36       53        0
  216. L2 Frames Sent            72       72       15
  217. L2 Timeouts               14        4        0
  218. TX Underruns               0        0        0
  219. RX Overruns                0        0        0
  220. FRMRs Sent                 0        0        0
  221. FRMRs Received             0        0        0
  222. Frames abandoned           0        1        0             
  223. Link Active %          0  73    2  26    0  00
  224.  
  225. Most are fairly obvious, but a few need a bit of explanation. There is one
  226. set of level 2 counters for each port.
  227.  
  228.  
  229. Time Active is the time since the system was loaded.
  230.  
  231. Timer Overruns count the number of times the main code (which is initiated
  232. by the timer interrupt) is still running when the next timer interrupt
  233. occured. If it increments very rapidly (several times a minute), it 
  234. indicates that the PC is too slow for the amount of data being processed.
  235. It is normal for an XT class machine running a couple of BBS ports to get
  236. about one overrun per minute. My 10MHz AT clone very rarely shows any.
  237.  
  238. RX Overruns indicate characters lost because the software didn't process 
  239. the interrupts fast enough. If you are running KISS ports, and you get
  240. a lot (ie a significant percentage of L2 frames heard), try reducing the
  241. speed of the link from the PC to the TNC. If you are using an HDLC card
  242. (DRSI or PC120), particularly at high speed, then there isnt much you 
  243. can do except buy a faster machine. (But I would like to hear from anyone
  244. having problems running at 9600 baud or above - I may be able to speed up
  245. the routines a bit).
  246.  
  247. TX Underuns indicate a similar problem in responding to TX interrupts,
  248. but only apply to HDLC cards (you cant get a TX underrun on an async port).
  249.  
  250. Frames abandoned counts the number of frames discarded because they have
  251. been waiting to be sent (for DCD to clear) for more than 60 secs. If a
  252. lot occur, then either your squelch is a bit dodgy, or the channel is 
  253. VERY busy. Only used for HDLC cards.
  254.  
  255. Link Active shows two values for each port. The first is the % of time
  256. in the last minute that your station was transmitting, and the second
  257. the % the channel was active (sum of Transmitting and DCD active). Only
  258. maintained for HDLC ports.
  259.  
  260.  
  261.  
  262. The L4T1 command displays or sets the Level 4 timeout used for the current
  263. session. It is primarily for me to experiment with.
  264.  
  265.  
  266. PACLEN sets or displays the PACLEN value used for messages generated by
  267. the node (eg command responses). Again it is mainly for me to play with.
  268.