9.5;rtsvc (routing_service), revision 9.5, 86/06/17
RTSVC (ROUTING_SERVICE) -- Set or display internet routing service.
usage:  RTSVC [-DEVICE dev-name [dev-number] [-ROUTE|-NOROUTE|-OFF]
                                        [-NET net_id] [-USER nn]]


FORMAT

  RTSVC [-DEVICE dev-name [dev-number] [options]]


  RTSVC  displays or alters the characteristics of a network port.  RTSVC is for
  use in a DOMAIN/BRIDGE internet.  You must be logged onto the node you wish to
  control in order to use RTSVC.

  For complete information on RTSVC, see Managing DOMAIN Internets.


OPTIONS

  If  no  options  are  specified,  RTSVC  displays the characteristics of every
  active network.  If you specify any other options, you must specify  the  type
  of network controller using a -DEVICE command line option.

  You may use only one -DEVICE option on any command line:

  -DEV[ICE] dev-name [dev-number]
                     Specify the network device type: RING, IIC,  or  USER  (for
                     EtherBridge  routers).  The  device  number applies only to
                     USER devices. You may use the name ETHERBRIDGE in place  of
                     USER  if  you prefer. The dev-number option applies only to
                     USER networks, and is required. Find the device  number  by
                     using  RTSVC  without command line options (as shown in the
                     examples).

  Earlier versions of the RTSVC command used a different command line syntax for
  specifying  network  devices. The old command lines still work, but you should
  start using the new -DEVICE command lines as soon as possible. Future versions
  of RTSVC will not accept the older command lines.

  This option changes the network ID of any network port:

  -NET net_id        Assign the port a hexadecimal network ID number.

                     Caution: If you use this option to change the network ID of
                     a port on an active router, other nodes on the network  can
                     stop  communicating  with each other.  Use this option only
                     as directed in  "Managing  the  Domain  Environment  in  an
                     Internet".

  Only one of the following options may be specified at a time.

  -ROUTE             Allow routing service to or from the port.

  -NOROUTE           Allow normal AEGIS requests but no routing service.

  -OFF               No AEGIS requests or routing service allowed.

  -USER nn           Set an EtherBridge network.  The value is not changed until
                     the routing node is rebooted  or  the  routing  process  is
                     stopped and restarted.


EXAMPLES

  $ rtsvc -device iic -net 007302ED -route    Assign a network ID to the
                                              Interphase controller and
                                              allow internet routing at
                                              that port.

  $ rtsvc -dev ring -noroute                  Stop internet routing through
                                              the ring port, but allow normal
                                              AEGIS requests for paging, file
                                              service, etc. Do not change the
                                              node's network ID.

  $ rtsvc                                     Display the networks attached
                                              to this node.

      Controller        Net ID     Service offered
  ==================   ========   ====================
  RING                     76A0   Own traffic only
  USER            46       768C   Port not open


  The  node  in  the  last  example  touches  two  network: a Domain ring and an
  Ethernet, via the Etherbridge product. You need the device number  information
  ("46")  from  this  display  in  order  to  turn on routing at the EtherBridge
  network. Use the device number as shown here:

  $ rtsvc -dev user 46 -route                 "46" is the device number.


RELATED TOPICS

  More information is available.  Type:

  - HELP NETSVC
   for information about controlling a node's network access.