Library /sys$common/syshlp/DECNET_MIGRATE.HLB  —  SHOW_PATH
 Display the possible paths that node-to-node communication may take
 through the network.  This allows you to determine what effect the
 transition from Phase IV to DECnet-Plus has had on the network's
 communication paths.

       SHOW PATH -
         [FROM = {node-name | osi-net | osi-area | ph4-addr | ph4-area }] -
         [TO   = {node-name | osi-net | osi-area | ph4-addr | ph4-area }] -
         [FORMAT = { BRIEF | FULL }] -
         [OUTPUT_FILE = output-file-name]

 The command will dynamically determine what nodes might be traversed
 when a packet is sent from a source node to a destination node, based
 on information obtained from the starting node and from the routers in
 the path.  It will then display the resulting lists of nodes.  More
 than one possible path may be displayed.

 All nodes in the path must be able to respond to either NICE or DNA CMIP
 network management requests.

 Example:  SHOW PATH TO .FR.CANNES FORMAT=FULL

1  –  FROM

 This optional parameter allows you to specify the node to start at when
 determining a set of communication paths.

 You may enter either:

     FROM = node-name
     FROM = osi-net
     FROM = osi-area
     FROM = ph4-addr
     FROM = ph4-area

 where:

     node-name   identifies the starting node using either the node's full
                 DECdns name or its Phase IV synonym name.

                 For example ".USA.Boston" or "BOSTON".

     osi-net     identifies the starting node using one of the node's network
                 entity titles (NETs).  This may be entered in the format:

                     afi:idi:predsp-locarea:nodeid:sel

                 For example "43:15084745192:00-0C:aa-00-04-00-50-30:00".

     osi-area    identifies the starting node using one of the node's
                 network areas.  In this case, the first node found in
                 the area becomes the starting node.  This may be entered
                 in the format:

                     afi:idi:predsp-locarea

                 For example "43:15084745192:00-0C".

     ph4-addr    identifies the starting node using the node's Phase IV
                 network address.  This may be entered in the format:

                     area.nodeid

                 For example "12.102".

     ph4-area    identifies the starting node using the node's Phase IV
                 network area.  In this case, the first node found in the
                 area becomes the starting node.  This may be entered in
                 the format:

                     area.*

                 For example "12.*".

 If FROM is not specified, the starting node is assumed to be the local
 node.  If TO is not specified, the terminating node is assumed to be
 the local node.  You must specify at least one of these (they cannot
 both be defaulted).

 Example:  SHOW PATH FROM .USA.BOSTON TO .FR.CANNES
           SHOW PATH FROM 43:15084745192:00-0C:AA-00-04-00-50-30:00

2  –  TO

 This optional parameter allows you to specify the node to stop at when
 determining a set of communication paths.

 You may enter either:

     TO = node-name
     TO = osi-net
     TO = osi-area
     TO = ph4-addr
     TO = ph4-area

 where:

     node-name   identifies the terminating node using either the node's
                 full DECdns name or its Phase IV synonym name.

                 For example ".USA.Boston" or "BOSTON".

     osi-net     identifies the terminating node using one of the node's
                 network entity titles (NETs).  This may be entered in
                 the format:

                     afi:idi:predsp-locarea:nodeid:sel

                 For example "43:15084745192:00-0C:aa-00-04-00-50-30:00".

     osi-area    identifies the terminating node using one of the node's
                 network areas.  In this case, the first node found in
                 the area becomes the terminating node.  This may be
                 entered in the format:

                     afi:idi:predsp-locarea

                 For example "43:15084745192:00-0C".

     ph4-addr    identifies the terminating node using the node's Phase IV
                 network address.  This may be entered in the format:

                     area.nodeid

                 For example "12.102".

     ph4-area    identifies the terminating node using the node's Phase IV
                 network area.  In this case, the first node found in the
                 area becomes the terminating node.  This may be entered in
                 the format:

                     area.*

                 For example "12.*".

 If TO is not specified, the terminating node is assumed to be the local
 node.  If FROM is not specified, the starting node is assumed to be the
 local node.  You must specify at least one of these (they cannot both be
 defaulted).

 Example:  SHOW PATH FROM .USA.BOSTON TO .FR.CANNES
           SHOW PATH TO 43:15084745192:00-0C:AA-00-04-00-50-30:00

3  –  FORMAT

 This optional parameter allows you to specify the output format.  Formats
 are:

     FORMAT = BRIEF  Display only the names of the nodes in the path.

     FORMAT = FULL   Display the node type and the NETs for each node
                     in the path.

 If this parameter is not specified, the default is "BRIEF".

 Example:  SHOW PATH FROM .USA.BOSTON TO .FR.CANNES FORMAT=FULL

4  –  OUTPUT_FILE

 This optional parameter allows you to specify an output file.  If used,
 the path information will be written to the output file rather than to
 the terminal.

 Example:  SHOW PATH FROM .USA.BOSTON TO .FR.CANNES OUTPUT=FRANCE.PATH
Close Help