/sys$common/syshlp/DECNET_MIGRATE.HLB  —  COLLECT
 Collect information on the current configuration of the network.  This
 will store the information in a configuration data file which may be used
 as input for a subsequent REPORT command.

       COLLECT collection-file-name -
         [ROUTING_TYPE = { ALL | ROUTERS | L1_ROUTERS | L2_ROUTERS }] -
         [AREAS = { ALL | LOCAL | NODE:node-name }] -
         [NODES = node-list-file-name] -
         [STATUS = status-report-count] -
         [RETRY = connection-retry-count]

       COLLECT collection-file-name RECOVER

 The command will dynamically determine what nodes are accessible in the
 network, using both DECnet-Plus and DECnet Phase IV network management.
 It will then query each node for the specified information, and write
 that information to the specified data file.

 It will also create an "address polling list" file.  This file is used by
 the function to hold the addresses of the nodes to be polled, and is
 deleted when it is no longer needed.  The file name is created by
 appending "_SEA" to the collection file name extension.

 Example:  COLLECT CONFIG_01_23_90.DAT

1  –  ROUTING_TYPE 

 This optional parameter allows you to specify the routing types of the
 nodes from which to collect information.

     ROUTING_TYPE = ALL             Routers and end systems
     ROUTING_TYPE = ROUTERS         Only Level 1 and Level 2 routers
     ROUTING_TYPE = L1_ROUTERS      Only Level 1 routers
     ROUTING_TYPE = L2_ROUTERS      Only Level 2 routers

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

 Example:  COLLECT CONFIG_01_23_90.DAT ROUTING_TYPE=L2

2  –  AREAS 

 This optional parameter allows you to specify the network area from which
 to collect information.

     AREAS = ALL                 All areas
     AREAS = LOCAL               The local node's area
     AREAS = NODE:node-name      The area containing the specified node

 If the AREAS=NODE option is used, the full name or the Phase IV synonym
 for the node must be supplied.

 The AREAS parameter is mutually exclusive with the NODES parameter.  Only
 one of these may be used.

 If neither the AREAS nor the NODES parameter is specified, the default
 is "AREAS=ALL".

 Example:  COLLECT CONFIG_01_23_90.DAT AREA=LOCAL
           COLLECT CONFIG_01_23_90.DAT AREA=NODE:Paris.Hub_Node

3  –  NODES 

 This optional parameter allows you to specify a file containing a list of
 specific nodes from which to collect information.

     NODES = node-list-file-name

 If the NODE option is used, the specified file must contain a list of nodes,
 one node per line in the file.  Each node may be specified using either the
 node's full name, its Phase IV synonym, its network entity title (NET), or
 its Phase IV address.

 The disk and directory for the node list file default to the disk and
 directory specified for the collection file.  The file extension defaults
 to "INP".

 The NODES parameter is mutually exclusive with the AREAS parameter.  Only
 one of these may be used.

 If neither the NODES nor the AREAS parameter is specified, the default
 is "AREAS=ALL".

 Example:  COLLECT CONFIG_01_23_90.DAT NODES=DECNET_VAX_NODES.INP

4  –  STATUS 

 This optional parameter causes a polling status message to be displayed
 after the specified number of nodes have been polled.  This allows
 you to monitor the progress of the information collection operation.

 The status message indicates:

   o The number of nodes polled up to this time.  Nodes are polled based
     on a list of node addresses obtained from one or more network routers.

   o The number of addresses in the node address list that have been
     skipped over, because they are equivalent to addresses that have
     already been polled (DECnet-Plus allows any node to have more than
     one node address).

 If not specified, the default is to report the polling status after
 each node is polled (STATUS=1).  If a polling status report is not
 desired, specify "STATUS=NONE".

 Example:  COLLECT CONFIG_01_23_90.DAT STATUS=5
           COLLECT CONFIG_01_23_90.DAT STATUS=NO

5  –  RETRY 

 This optional parameter causes network connect attempts for any node to
 continue for the specified number of times, waiting one minute between
 attempts.  If a connection cannot be made within this many attempts,
 the utility will assume that it cannot connect to the node.  This is
 most useful when nodes might have network resource constraints.

 A node connection will be retried only for errors that could be transient
 in nature (such as resource errors).  Other errors will result in an
 immediate connect failure, and this count will be ignored.

 If not specified, the default is to try two connects to a node before
 going on to the the next node.  If only one connect attempt should be
 made per node to speed up processing, use "RETRY=NONE".

 Example:  collect config_01_23_90.dat retry=5
           collect config_01_23_90.dat retry=no

6  –  RECOVER 

 This optional parameter allows the user to specify that the collection
 operation should pick up from where it was last stopped.   The recovery
 will work only if the collection data file was not left in a corrupted
 state (this can be detected by the utility).

 The operation may have stopped due to a system reboot, due to the
 process being stopped, or due to the user pressing CTRL/C or CTRL/Y.

 This parameter may not be used in conjunction with any other parameter.
 Any parameters that were in effect from the original COLLECT command will
 remain in effect.

 Example:  COLLECT CONFIG_01_23_90.DAT RECOVER
Close Help