node_spec — Apollo

NODE_SPEC -- Node Specification Syntax                                85/06/13


  Node  specifications  permit  a node's communications software to locate other
  nodes  in  a  local  ring  or  in  an  internet.    Typically,  you  use  node
  specifications  when Shell commands require them.  LUSR, NETSTAT, LVOLFS are a
  few examples of Shell commands that accept node specifications.  On nodes with
  SR9.0  or  SR9.SATURN  software,  a  node  specification  can  be  one  of the
  following:

     - An internet address

     - A node name

  Internet Addresses

  An internet address has the format:

    [net].node_id

  The  'net'  represents  a  network  number  and  the  'node_id'  represents  a
  hexadecimal node ID.  A network number of 0 refers to the local network.

  If a node is cataloged (in either your local cache or the NS_HELPER database),
  then you can omit the network number when you use an internet address.  If you
  provide  only  the  node  ID,  the  system will obtain the network number from
  either your local cache or the NS_HELPER database.  If you provide a  complete
  internet  address,  the  system  will  attempt  to locate the node only on the
  network you specify.  Thus, if you specify an incorrect  network  number,  the
  system will look for the node on the network that you specify, and then report
  an error; the system will not attempt to locate the node on another network.

  If a node is not cataloged, the system cannot obtain a network number  if  you
  provide  only a node ID.  In this case, the system assumes that the node is on
  the local ring.  Thus, for an uncataloged node on the local network, you  must
  provide  the  node  ID, but the network number is optional.  However, you must
  provide both the network number and node ID  for  an  uncataloged  node  on  a
  remote network.

  Node Names

  You  can use a node name as a node specification only if the node is cataloged
  (in either your local cache or the the NS_HELPER database.)  When  you  use  a
  node  name,  the system obtains the internet address associated with the name.
  If a node is not cataloged, you must use an internet address  to  specify  the
  node.

  Note that both disked and diskless nodes can be cataloged and named.


EXAMPLES

  The  following  examples  illustrate ways you can specify a node with an ID of
  A105, a name of //CASEY, and a network number of 4051237A.    (These  examples
  assume that //CASEY is cataloged in the NS_HELPER database.)

    1. $ LUSR -N 0A105     (Note that hex IDs that start with a letter must
                            be preceded by a '0' for the Shell to parse them
                            correctly.)

    2. $ LUSR -N //CASEY

    3. $ LUSR -N 4051237A.A105

  In  addition,  if  you  are  using  a  node  on ring 4051237A, you can use the
  following internet address to refer to //CASEY:

    $ LUSR -N 0.A105       ('0' indicates the local network.)
Museum
