DECNET_REGISTER_FORMS.HLB  —  SHOW_NODE_INFORMATION
 This function displays information about a node registration in a
 directory service.

1  –  Directory Service 

 This field specifies the directory service that contains the node
 registration to be shown.  The service must be one of:

     LOCAL
     DECDNS
     PHASEIV

 The service type can be abbreviated, as long as the abbreviation is
 unique.

2  –  Node Name or Address 

 This field specifies the identification of the nodes to be shown.
 The node identification can be one of:

     The fully specified name for the node in the directory service.
     The Phase IV synonym for the node.
     One of the NET or NSAP addresses for the node.
     The Phase IV address (and optional Phase IV prefix) for the node.

 Wildcards are allowed in names and addresses.

2.1  –  Names 

 The node to be shown can be specified using its full name or its
 Phase IV synonym.

 The syntax of a fully specified name depends on the directory service
 being used.  Examples of fully specified names might be:

     For Local:      MailHub
     For DECdns:     MyCo:.Sales.MailHub
     For Phase IV:   MLHUB

 An example of a Phase IV synonym for any of the above might be:

     MLHUB

 Wildcards are allowed in the node name using an asterisk (*).  For
 example:

     For Local:      Mail*
     For DECdns:     MyCo:.Sales.Mail*
     For Phase IV:   ML*

 The wildcard character can come anywhere in the last part of the name.
 Only a single wildcard character is allowed.

2.2  –  Addresses 

 The node to be shown can be specified using one of its NETs (or NSAPs),
 or its Phase IV address.

 An NET is an NSAP address value with an N-Sel value of "00" (indicating
 that it is independent of the type of transport service in use on the
 node).  If you specify an NSAP instead of an NET, it is converted to an
 NET before it is used.

   DNA format:  <afi>:<idi>:<predsp>-<locarea>:<nodeid>:00
   OSI format:  <afi><idi>+<predsp><locarea><nodeid>00

 Examples of NETs might be:

   DNA format:  39:840:0001:AA-00-04-00-05-04:00
   OSI format:  39840+0001AA000400050400

 If the node has a Phase IV address, that can be used instead of an NET.

   Format:      <area>.<nodeid>
                <area>.<nodeid>+<prefix>

 This is internally converted to an NET, using the Phase IV prefix value.
 The Phase IV prefix value can be specified with the Phase IV address,
 or set as a default using the preferences form.

 Examples of a Phase IV address might be:

   1.5                                Uses the default Phase IV prefix
   1.5+39:840                         Uses an explicit Phase IV prefix

 Wildcards are allowed in the NET or Phase IV address using an asterisk.
 The wildcard character must replace either the node id, or the local
 area and the node id.  For an NET containing a wildcard, do not specify
 an N-Sel value.

   39:840:0001:*   (or 39840+0001*)   Wildcard the node id
   39:840:*        (or 39840+*)       Wildcard the local area and node id

   1.*                                Wildcard the node id
   *.*                                Wildcard the area and node id

3  –  Display Format 

 The following display formats are provided, to display the indicated
 information.  The format names can be abbreviated, as long as the
 abbreviation is unique.

   NAMES
     - The fully specified name, as defined in the directory service.

   BRIEF
     - The fully specified name, as defined in the directory service.
     - The name of the link (if any) used to access the node information.
     - The Phase IV synonym name registered for the node.
     - The NSAP addresses registered for the node.

   FULL
     - Same information as the BRIEF format.
     - The address tower information registered for the node.
     - The link name used to map the synonym to the node name (if any).
     - The link names used to map NSAP addresses to the node name (if any).

 The FULL display format also provides consistency checking, and prints
 messages describing any inconsistencies it finds, such as a missing
 synonym or NSAP address link, or a link that points at an incorrect name.

4  –  Output File 

 This specifies the name of the file to receive the display output.

 This is useful if a lot of display output is to be generated for later
 examination.  If the specified file does not exist, it is created.  If
 it already exists, the new information is appended to the current
 contents.

 If not specified, all display output is sent to the screen.
Close Help