home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / hamradio / tnet_x1h.zip / USERGUID.X1H < prev   
Text File  |  1992-11-02  |  12KB  |  296 lines
  1.                     USERGUIDE FOR TheNet X-1H
  2.  
  3. This  brief  note  is  intended for users  of  TheNet  X-1H,  and 
  4. explains the basic commands. Configuration and sysop features are 
  5. not covered fully.
  6.  
  7. TheNet X-1H is an extension of TheNet 1, and provides a number of 
  8. new features.
  9.  
  10. The switch provides the following user commands :
  11.  
  12.           Connect
  13.           Info
  14.           Nodes
  15.           Routes
  16.           Users
  17.           Talk
  18.           CQ
  19.           BBS
  20.           Host
  21.           MHeard
  22.           Bye
  23.           DXcluster
  24.           IProute
  25.           ARP
  26.           QUIT
  27.  
  28. Not  all  commands  may be available on  every  node  as  certain 
  29. commands might have been disabled. If a command has been enabled, 
  30. it  will  be displayed when you type an invalid command  such  as 
  31. '?'. In  addition, there are some commands that are available but 
  32. are not displayed. The main ones of interest are :
  33.  
  34.           Links
  35.           Mode
  36.           Parms
  37.           Stats
  38.           IPAddress
  39.           DXCAlias
  40.           BBSAlias
  41.           HostAlias
  42.  
  43. Connect
  44.  
  45.      If  the connect command is given on its own,  then  assuming 
  46.      that  the  sysop  has  set it up  correctly,  you  will  get 
  47.      connected to the local BBS.
  48.  
  49.      If you give another callsign, either of a local station or a 
  50.      node,  the node will attempt to connect you to that  station 
  51.      either by a level 4 connection or by downlinking. If you are 
  52.      downlinking, you may also specify digipeaters.
  53.  
  54.      In  either  case, you get either a connected  message  or  a 
  55.      message telling you of the failure to connect. If you  enter 
  56.      any other command at this stage, the connection attempt will 
  57.      be aborted.
  58.  
  59. Info
  60.  
  61.      This   command  gives  information  about  the  node  as   a 
  62.      combination  of a message stored in the EPROM and a  message 
  63.      entered by the Sysop.
  64.  
  65. Nodes
  66.  
  67.      This command gives information about the distant nodes  that 
  68.      this node thinks it can get to. With no parameter, it  shows 
  69.      the alias and callsign of all the nodes except those staring 
  70.      with a '#' character. If a parameter of '*' is given,  those 
  71.      'hidden' nodes will also be shown.
  72.  
  73.      If a callsign or alias is given that the node does not know, 
  74.      it  gives  an error message. If the callsign or alias  of  a 
  75.      known node is given, the node gives details of the routes it 
  76.      knows about that lead to that destination. The display shows 
  77.      one  option  per line, each of which consists  of  the  path 
  78.      quality,  obsolescence  count  and  port  followed  by   the 
  79.      callsign of the neighbour. If any route is in use, a chevron 
  80.      is shown against the appropriate entry.
  81.  
  82. Routes
  83.  
  84.      This command gives information about the neighbouring  nodes 
  85.      that can be heard. For each neighbour, the display shows the 
  86.      port  number, the callsign, the path quality and the  number 
  87.      of  nodes accessible through this neighbour. If a route  has 
  88.      been  'locked' by the sysop, then a '!'  character is  shown 
  89.      after an  entry. The sysop may have configured the  node  to 
  90.      display nodes as callsign or as alias:callsign.
  91.  
  92. Users
  93.  
  94.      This  shows  who is using the node. It does not  show  other 
  95.      nodes  that are using the node as a level 3 relay, nor  does 
  96.      it  show  those  users who have connected to  the  node  but 
  97.      otherwise have done nothing.
  98.  
  99.      The display shows the through connections, followed by those 
  100.      users  who are connected to the switch and 'idle'.  It  also 
  101.      shows  those  users who are connected  to  the  conferencing 
  102.      facility.  The  latter  stations are shown  connected  to  a 
  103.      destination   called   'Talk',  whilst  in   the   case   of 
  104.      connections,  the two endpoints are shown. For  connections, 
  105.      two symbols are used, '<-->' and '<..>'. The former is  used 
  106.      for  established connections whilst the latter is  used  for 
  107.      connections being established.
  108.  
  109. Talk
  110.  
  111.      The  Talk  command  allows  a  group  of  users  to  hold  a 
  112.      conference call. It also allows a user to send a message  to 
  113.      another user of the node provided that user is connected  to 
  114.      the switch but is not patched through to another station and 
  115.      is not currently tyring to connect to another station.
  116.  
  117.      A  user enters the conference by giving the command  'talk'. 
  118.      He/she  gets a message informing them of this and  reminding 
  119.      them  that  the command to escape from the talk  command  is 
  120.      '/exit'.  Any other users currently in the conference get  a 
  121.      message  from the node telling them of the callsign  of  the 
  122.      user who has joined them. At this point, every line sent  by 
  123.      a user in the conference is copied to all other users in the 
  124.      conference, preceded by their callsign.
  125.  
  126.      To  exit from the conference, the command '/exit'  is  used. 
  127.      This  causes a response message to be sent to the user,  and 
  128.      at  the same time all of those left in the conference get  a 
  129.      message  from the node telling them of the station  who  has 
  130.      left  the conference. If you force a disconnect,  the  other 
  131.      stations are not told of your departure.
  132.  
  133.      A string of text may be entered on the same line as the talk 
  134.      command  when the command is given. If this is done,  before 
  135.      the user is connected to the conference, that string of text 
  136.      is sent to all the other users of the node who appear in the 
  137.      'user'  list  but are not connected to  anything  else.  For 
  138.      example if GxABC were to type :
  139.  
  140.           TALK GyXYZ, Hello fred can I have a chat - type TALK
  141.  
  142.      then  other users of the node ( including  presumably  Fred, 
  143.      would get the message :
  144.  
  145.           GxABC>> GyXYZ. Hello fred can I have a chat - type TALK
  146.  
  147.      on their screens. The only exception to this is that  sysops 
  148.      are not sent the message.
  149.  
  150. CQ
  151.  
  152.      This command is used to broadcast a CQ message. In addition, 
  153.      the  fact that you are calling CQ is indicated in  the  USER 
  154.      list.  The callsign will be your own with a different  SSID, 
  155.      and  anyone  else can connect to you by  connecting  to  the 
  156.      callsign with the appropriate SSID.
  157.  
  158.      The  CQ  remains  'primed' for a while,  and  if  any  other 
  159.      command is given to the node the CQ will be cancelled.
  160.  
  161. BBS
  162.  
  163.      When you issue the BBS command, assuming that the sysop  has 
  164.      configured it, you will be connected to the local BBS.
  165.  
  166.      If  you enter the command 'BBS ?', then the current  setting 
  167.      of the BBS will be displayed.
  168.  
  169. Host
  170.  
  171.      The HOST command operates just like the BBS command. It  may 
  172.      have  been  disabled by the sysop, it may have been  set  to 
  173.      connect to the same station as the BBS, or it may have  been 
  174.      set to connect to another host system.
  175.  
  176.      If  you enter the command 'HOST ?', then the current  setting 
  177.      of the HOST will be displayed.
  178.  
  179. MHeard
  180.  
  181.      If  enabled,  the  heard list shows the  last  few  stations 
  182.      heard. The number of entries is limited and set by the sysop 
  183.      so any stations not heard for a while may get pushed out  of 
  184.      the  list  by others heard. Assuming that a station  is  not 
  185.      pushed  out in this manner, the display shows the number  of 
  186.      packets  heard  from that station since it appeared  in  the 
  187.      list  and  the  time since it was last heard.  The  time  is 
  188.      hours, minutes and seconds. The list also shows the port  on 
  189.      which  the station was heard ( port 0 is the radio  port  ), 
  190.      and if it hears IP frames or Net/Rom frames, it adds a  note 
  191.      to show that the station is a node and/or a TCP/IP station.
  192.  
  193.      If  the list is long enough so that a station is  not  heard 
  194.      for 12 hours, it will get deleted anyway.
  195.  
  196. Links
  197.  
  198.      The LINKS command shows the level 2 connections to the node. 
  199.      This  is  usually  of academic interest, but  I  use  it  in 
  200.      testing. The display shows the links, one per line, with the 
  201.      two  callsigns,  the  link state, the port  number  and  the 
  202.      current number of retries.
  203.  
  204. Mode
  205.  
  206.      The MODE command is a bit like the PARMS command. It shows a 
  207.      number  of  additional parameters. These are as  follows  as 
  208.      shown by example :
  209.  
  210.           MODE
  211.           THENET:G8KBB-5> 0 1800 6 3 2 20 0 600 2 900 1 31 0 1
  212.  
  213.      with the following meanings :
  214.  
  215.      0    Host mode protocol ( 0 = standard, 1 = DCD mode )
  216.      1800 CWID period. Delay in seconds between CWID
  217.      6    CWID speed 10's of msec per dot. 6 equals 20 wpm
  218.      3    Enable / disable nodes broadcasts mask.
  219.      2    RS232 protocol, 0 = crosslink, 1,2 or 3 are KISS
  220.      20   TxDelay in 10's of milliseconds ( Centiseconds ?? )
  221.      0    Full duplex control. 0 equals simplex
  222.      600  RS232 port nodes broadcast interval in seconds
  223.      2    Nodes broadcast algorithm port mask
  224.      900  Beacon period in seconds
  225.      1    'connect' redirector. 0 is to HOST, 1 is to BBS
  226.      31   Each bit controls one of the 'user' help messages
  227.      0    This byte controls the broadcasting of 'hash' nodes
  228.      1    This byte enables / disables the extra alias operation
  229.  
  230.      If you want additional details, ask the sysop for a copy  of 
  231.      the overview guide.
  232.  
  233.  
  234. Parms
  235.  
  236.      This shows the node parameters as per TheNet 1.01 ( I am not 
  237.      going to list them again here. Sorry ).
  238.  
  239. Bye and Quit
  240.  
  241.      These  commands disconnects you from the node,  closing  the 
  242.      link.  It  says goodbye before disconnecting you if  it  has 
  243.      been so configured by the sysop. Quit does just the same  as 
  244.      Bye does.
  245.  
  246. DXcluster
  247.  
  248.      If  there is a local DXcluster, this command may  have  been 
  249.      configured  by the sysop to connect you to it. It  therefore 
  250.      operates in a manner very similar to the BBS command.
  251.  
  252. Stats
  253.  
  254.      The  stats  command  gives  lots  of  data  about  the  node 
  255.      operation.   A  full  description  of  the  information   is 
  256.      contained in the overview document.
  257.  
  258. IProute
  259.  
  260.      This command is used by the sysop to configure the IP  route 
  261.      table. It may also be used to display the router table.
  262.  
  263. Arp
  264.  
  265.      This  command is similar to the IProute command,  but  shows 
  266.      the Arp table. The Arp table provides a translation from  Ip 
  267.      address to callsign.
  268.  
  269. IPaddress
  270.  
  271.      This  command is used to set or display the current node  IP 
  272.      address.
  273.  
  274. BBSAlias
  275. HostAlias
  276. DXCAlias
  277.  
  278.      These  commands are used to set additional aliases  for  the 
  279.      node.  It can be configured by the sysop to  accept  connect 
  280.      requests  ( uplinks ) to the node callsign, the node  alias, 
  281.      or  the  3 aliases shown by these commands.  When  the  node 
  282.      accepts  a  connection  to one of  these  aliases,  it  will 
  283.      immediately  invoke the BBS, DXC or HOST commands  for  you. 
  284.      The  way this would normally be used is as follows.  Suppose 
  285.      your  local  ( for example ) BBS was not accessible  on  the 
  286.      frequency  that the node operates on. The BBS alias  can  be 
  287.      configured to provide easy access across other nodes to  the 
  288.      BBS. Hence in the case of the Ipswich nodes, GB7MXM does not 
  289.      have a port on 144.650, but the node IPS2 on 144.650 can get 
  290.      to it by means of another node and a 9600 baud link. If IPS2 
  291.      is  set to accept the extra aliases, and if BBSAlias is  set 
  292.      to MXMBBS, then anyone who tries to uplink to MXMBBS in  the 
  293.      Ipswich area would be automatically connected to GB7MXM.  It 
  294.      goes  without  saying that if GB7MXM had a port  on  144.650 
  295.      itself, then chaos would ensue.
  296.