Google
 

Trailing-Edge - PDP-10 Archives - BB-BT99T-BB_1990 - 10,7/networ/networ.hlp
There are 8 other files named networ.hlp in the archive. Click here to see a list.
NETWORK Command

Function

     The NETWORK command prints information  about  the  nodes  in  an
     ANF-10  and/or DECnet-10 network environment.  Your terminal must
     be attached to one of the  nodes  in  the  network  to  use  this
     command.   You  can use the NETWORK command to obtain information
     about the other nodes in either type of network,  and  about  the
     device configuration of each node in the ANF-10 network.

     You can specify  the  node-name  or  node-number  in  the  ANF-10
     network, or just node-name in the DECnet-10 network, to limit the
     output to specific nodes.  You can use  switches  to  change  the
     output format.

     NETWORK reads your SWITCH.INI file and accepts indirect commands.
     The indirect command files should be formatted as follows:

     node-list/switch/switch...

     For more  information  about  indirect  command  files,  see  the
     COMPILE-class commands help file COMCMD.

Formats

     NETWORK node-list/switch

     Where:    node-list is the node-names or  node-numbers  (ANF-10),
               or  just node-names (DECnet-10), of nodes for which you
               want information.  If you do not specify the node-list,
               information  is  output  for every node in the network.
               The  node-names  or  node-numbers  (ANF-10),  or   just
               node-names (DECnet-10) are separated by commas.

     You can use the wildcard construction in the command string.  The
     node  name, or any part of the node name, can be replaced by * or
     ?  to represent groups of  nodes.   For  more  information  about
     wildcards, see the help file WLDCRD.

     The switches to NETWORK allow you to specify:

      o  The format of the output.

      o  The configurations that you want to examine.


                                 NOTE

        You use switches to select a node with  or  without  a
        specific  attribute.  Use the proper switch, or prefix
        the switch with NO.  If you do not use the switch, the
        selection   of  a  node  does  not  depend  upon  that
        attribute.  If you do not specify a node, the  default
        output is /BRIEF.

        The command line takes the format specified below:

        NETWORK node-name,
        node-number,.../switch/switch...

        You can repeat node names, but not switches.


     The switches to the NETWORK command follow.

     Output Control Switches

       Switch                            Function

     /ANF10         Forces output of ANF-10 information.

     /BRIEF         Suppresses the output of a  list  of  devices  for
                    each  node.   This  is  the  default if you do not
                    specify a node-list in the command string.

     /COST          Controls the listing of the physical  link  "cost"
                    associated with the /TOPOLOGY switch.

     /DECNET        Forces output of DECnet-10 information.

     /ERROR         Prints all error messages.  This is the default.

     /FAST          Prints only the name and number of the nodes.   If
                    you   also  specify  /NOBRIEF,  the  configuration
                    information is printed.

     /HEADER        Prints header information.  This  is  the  default
                    action.

     /HELP          Prints a description of the NETWORK command.

     /LAT           Prints LAT terminal server information.

     /NOANF10       Suppresses output of ANF-10 information.

     /NOBRIEF       Prints a list of the devices on each  node.   This
                    is the default if you specify a node-list.

     /NOCOST        Suppresses the listing of the physical link "cost"
                    associated with the /TOPOLOGY switch.

     /NODECNET      Suppresses output of DECnet-10 information.

     /NOERROR       Suppresses the output of error messages.

     /NOFAST        Suppresses printing the name  and  number  of  the
                    nodes.    If   you   also  specify  /NOBRIEF,  the
                    configuration information is suppressed.

     /NOHEADER      Suppresses output of header information.

     /NOLAT         Suppresses LAT terminal server information.

     /NOSILENCE     Prints all information.  This is the default.

     /NOSORT        Suppresses sorting of the nodes according to  node
                    number.

     /NOTOPOLOGY    Suppresses  printing  of  the  topology   of   the
                    network.

     /SILENCE       Prints only error messages.

     /SORT          Sorts the nodes according to node number.

     /TOPOLOGY      Prints the topology of the network as a node  name
                    and  number  followed  by  its neighbors' numbers.
                    Each neighbor has a physical link "cost" following
                    it  in  parentheses  unless  you  also include the
                    /NOCOST switch.


     ANF-10 Node Selection Switches

       Switch                            Function

     /CDP           Prints only nodes that have card-punch devices.

     /CDR           Prints only nodes that have card readers.

     /DTA           Prints only nodes that have DECtape units.

     /LPT           Prints only nodes that have line printers.

     /MCR           Prints only nodes that have  command  interpreters
                    (monitors).  MCR signifies that the node is a host
                    system.

     /MTA           Prints only nodes that have magnetic tape units.

     /NOCDP         Prints only nodes  that  do  not  have  card-punch
                    devices.

     /NOCDR         Prints only nodes that do not have card readers.

     /NODTA         Prints only nodes that do not have DECtape units.

     /NOLPT         Prints only nodes that do not have line printers.

     /NOMCR         Prints  only  nodes  that  do  not  have   command
                    interpreters.

     /NOMTA         Prints only nodes that do not have  magnetic  tape
                    units.

     /NOPLT         Prints only nodes that do not have plotters.

     /NOPTP         Prints only nodes that  do  not  have  paper  tape
                    punch units.

     /NOPTR         Prints only nodes that  do  not  have  paper  tape
                    readers.

     /NORDA         Prints only nodes that do not  have  RDX  devices.
                    RDX  devices  control  lines from high-speed input
                    (block-mode) terminals.

     /NOTSK         Prints only nodes that do not have TSK:  devices.

     /NOTTY         Prints only nodes that do not support terminals.

     /TYPE:DNxxx    Prints only nodes of  the  specified  type.   This
                    does  not  output host nodes.  However, if you use
                    /TYPE:  with no value, the host nodes are printed.

     /PLT           Prints only nodes that have plotters.

     /PTP           Prints only  nodes  that  have  paper  tape  punch
                    units.

     /PTR           Prints only nodes that have paper-tape readers.

     /RDA           Prints only nodes  that  have  RDX  devices.   RDX
                    devices   control   lines  from  high-speed  input
                    (block-mode) terminals.

     /TSK           Prints only nodes that have TSK:  devices.

     /TTY           Prints only nodes that support terminals.


     DECnet-10 Node Selection Switches

         Switch                          Function

     /LINKS         Prints only nodes  that  have  one  or  more  open
                    logical links.

     /NOLINKS       Prints only nodes that do not  have  one  or  more
                    open logical links.

     /NOUNREACHABLE Suppresses listing of all known DECnet nodes.

     /UNREACHABLE   Lists all known DECnet nodes.


     Network Topology

     The topology of a network is determined by the interconnection of
     nodes  in  a  network.   Nodes  can  be  adjacent  to  each other
     connected by a physical link.  They can also  be  connected  with
     intermediate  nodes.   These  connections, with associated costs,
     determine the routes (paths) a message takes  from  one  node  to
     another.   The  costs are arbitrary values given to each physical
     connection of  the  network.   The  cost  of  a  given  route  is
     determined  by  the  sum of the costs of the physical connections
     along that route.  In cases where multiple routes  exist  between
     nodes,  the  route  with the lowest cost is taken.  In the ANF-10
     network, this information is available when you use the /TOPOLOGY
     switch.

     In  the  DECnet  network,  the  /TOPOLOGY  switch  displays   the
     information  available  for DECnet nodes.  The first two items of
     information are the node name  and  number,  followed  by  DECnet
     routing  information  for that node.  If the node is unreachable,
     then  this  information   is   placed   in   the   output   line:
     "Unreachable."  The  remaining information columns are left blank
     to indicate that information is not available.  If  the  node  is
     reachable, then the column shows the circuit name for the initial
     routing of a message to that node.

     The following columns show cost and number of hops, analogous  to
     the  ANF-10 network topology.  The cost for DECnet is set through
     network management functions on a per physical-connection  basis.
     If  you  ever  form  a  logical  link  between  your node and the
     destination node, information is available for the count of  open
     logical  links  and  the  round-trip delay time in milli-seconds.
     Otherwise, this information is not available, and the information
     fields  are  left blank.  Example 4 shows the output from the use
     of the /TOPOLOGY switch for both  ANF-10  and  DECnet-10  network
     environments.

Associated Messages

     The output from the NETWORK command is in one  of  the  following
     formats.

     When you do not specify a node-list:

     For ANF-10:
       node-name (node-number) system-name system-generation-date
     For DECnet-10:
       Node list (node-name)


     When you specify a node-list:

     For ANF-10:
       node-name (node-number)  system-name system-generation-date
     device[number-of-devices] device[number-of-devices]
     device[number-of-devices]...
     For DECnet-10:
       same as when you don't specify node names.

Characteristics

     Runs the NETWORK program.

     Does not require that you be logged in.

Examples

     1.  The following example shows the NETWORK  command  and  output
         when  you  omit  the  node-list.   There  are 17 nodes in the
         ANF-10 network; five are shown in this  example.   There  are
         183  reachable  nodes  in the DECnet network; 14 are shown in
         this example.

         .NETWORK<RET>

         [ANF10  network:   connected  to  SPIRIT  (30),  located   at
         KL1026(26), 17 nodes]
         Node CTCH22  (22)    DN82 V23(174)        dd-mmm-yy
         Node KL1026  (26)    RC117B KL #1026/1042 dd-mmm-yy
         Node NEXT    (27)    DN87 V23(173)        dd-mmm-yy
         Node SPIRIT  (30)    DN87 V23(174)        dd-mmm-yy
         Node NOVA    (31)    DN87S V23(174)       dd-mmm-yy

         [DECnet network: local node KL1026, 183 reachable nodes in
         area 7]
         ABLE    ADAM    AJAX    ALGOL   ALIEN   ALPHA   ALPINE
         BLUE    CACHE   CADVAX  CAR     CASTOR  CDR     CHAOS

     2.  The following example shows  the  NETWORK  command  when  the
         node-list  is specified.  Node-number 33 is valid; node 76 is
         invalid.

         .NETWORK 33,76<RET>
         [ANF10 network: connected to NOVA(31), located at KL1026(26),
         15 nodes]
         Node    DWARF    (33)   DN87S V23(174)  28-Sep-82
                 TSK[2] TTY[64]

         %NWKNNN Node 76 not in Network

         .

     3.  The following example shows  the  use  of  NETWORK  with  the
         /NOTSK switch.

         .NETWORK/NOTSK<RET>

         [ANF10 network: connected to NOVA(31), located at KL1026(26),
         15 nodes]
         Node    SOFDCP  (75)    DN82 V22E/52A
         Node    WOBBLE  (143)   DN81 V22E/52A

         [DECnet network: local node KL1026, 182 reachable nodes in
         area 7]
         ABACUS  ABLE    ADAM    AJAX    ALGOL   ALIEN   ALPHA   ALPINE
         ANIMAL  ARK     BAXTER  BERGIL  BISON   BLUE    CACHE   CADVAX
         CAR     CASTOR  CDR     CHAOS

     4.  The following example shows the use of  the  NETWORK  command
         with   the  /TOPOLOGY  switch  for  both  ANF-10  and  DECnet
         networks.  The connected node (the node running your job)  is
         KL1026.   KL1026  has  a direct line to node ENCORE(32), node
         NOVA(31), node JINX(34), node DWARF(33), and  node  NEXT(27).
         Each  of  these  lines costs 10.  Therefore, they are equally
         acceptable links.  Note that node NEXT(27) has a direct  line
         to  node KL1026(26), but this line costs 62, and is therefore
         less acceptable than the line which connects node  KL1026  to
         node NEXT.

         .NETWORK/TOPOLOGY<RET>
         [ANF10 network: local node KL1026(26), 17 nodes]

         Node    KL1026  (26)    32(10)  34(10)  33(10) 27(10)
         Node    CTCH22  (22)    76(8)
         Node    KS4101  (76)    22(10)  27(10)
         Node    SOFDCP  (75)    71(8)   6(8)
         Node    TWINKY  (71)    75(10)  123(10)
         Node    WIZARD  (123)   71(8)   27(8)
         Node    NEXT    (27)    26(62)  123(16) 76(16)
         Node    DWARF   (33)    26(62)
         Node    ENCORE  (32)    26(62)
         Node    JINX    (34)    26(62)
         Node    NOVA    (31)    26(62)  20(8)

         The DECnet network /TOPOLOGY switch displays cost and  number
         of hops between nodes.

         [Decnet network: local node KL1026, 183 reachable nodes in
         area 7]
         Name    Number    Line          Cost   Hops L.Links Delay
         LARRY   (7.221)   DTE-0-3       7      3
         LYRA    (7.236)   ETH-0         1      1

         .

     5.  The following example shows the use of  the  NETWORK  command
         for  a DECnet Ethernet endnode.  An Ethernet endnode does not
         know DECnet topology information,  so  the  system  prints  a
         summary line containing DECnet information.

         .NETWORK/DECNET<RET>
         [DECnet network:local node KL1026,
         running as an Ethernet endnode]