DECNET_REGISTER_COMMANDS.HLB  —  SHOW
 Display the current default values for all optional parameters.

     SHOW DEFAULT

 Display information from a node registration in a directory service.

     SHOW [DECNET] NODE node-id
         [ DIRECTORY_SERVICE dir-service ]
         [ display-mode ]
         [ PHASEIV_PREFIX addr-prefix ]
         [ REVERSE_DIRECTORY rev-dir-name ]
         [ SYNONYM_DIRECTORY syn-dir-name ]
         [ NSAP_FORMAT format ]
         [ OUTPUT_FILE out-file-name ]

 The SHOW NODE command reads node registration information from a directory
 service and displays it on the screen or writes it to a file.  If the FULL
 display mode is used, this also verifies that all reverse address mapping
 and synonym links are set up properly for the node.

1  –  DEFAULT

 This specifies that the current default parameter settings are to be
 displayed.

 All defaults are displayed.  This command takes no other parameters.

2  –  NODE

 This specifies the identification of the nodes to be shown.

     NODE node-id

 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:      NODE MailHub
     For DECdns:     NODE MyCo:.Sales.MailHub
     For Phase IV:   NODE MLHUB

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

     NODE MLHUB

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

     For Local:      NODE Mail*
     For DECdns:     NODE MyCo:.Sales.Mail*
     For Phase IV:   NODE 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:  NODE 39:840:0001:AA-00-04-00-05-04:00
   OSI format:  NODE 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
 the PHASEIV_PREFIX parameter, or set using the SET DEFAULT command.

 Examples of a Phase IV address might be:

   NODE 1.5                        !Uses the default Phase IV prefix
   NODE 1.5+39:840                 !Uses an explicit Phase IV prefix
   NODE 1.5 PHASEIV_PREFIX 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  –  DIRECTORY_SERVICE

 This specifies the directory service that contains the node registration.

     DIRECTORY_SERVICE dir-service

 The service must be one of:

     DIRECTORY_SERVICE LOCAL
     DIRECTORY_SERVICE DECDNS
     DIRECTORY_SERVICE PHASEIV

 If not specified, the default service type is used.  This default can be
 displayed or changed using the SHOW or SET DEFAULT commands.

4  –  Display-Mode

 The following display modes are provided, to display the indicated
 information.

   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 mode.
     - 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 mode 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.

 If no mode is specified, the BRIEF mode is assumed.

5  –  PHASEIV_PREFIX

 This specifies the AFI, IDI, and preDSP to use when constructing an
 NET from a Phase IV address.  This is used only when a Phase IV address
 is specified for the node id.

   PHASEIV_PREFIX addr-prefix

 An alternate form is to add the Phase IV prefix to the Phase IV address
 specification.

 For example:

     NODE 1.5 PHASEIV_PREFIX 39:840:800AB738
     NODE 1.5+39:840:800AB738

 would both result in the following NET being used to represent the
 DECnet Phase IV address:

     39:840:800AB738-0001:AA-00-04-00-05-04:00

 If not specified, the default Phase IV prefix is used.  This default can
 be displayed or changed using the SHOW or SET DEFAULT commands.

 See the PHASE_IV_PREFIXES topic for details about Phase IV prefix values.

6  –  REVERSE_DIRECTORY

 This specifies the base directory or name entry to use when checking and
 displaying the reverse address mapping links to the node name (also called
 the back translation links).

     REVERSE_DIRECTORY rev-dir-name

 The links under this directory are used to map NSAP values to their
 respective node names.  These directories are used only for the DECdns
 directory service.

 If not specified, the default reverse directory is used.  This default
 can be displayed or changed using the SHOW or SET DEFAULT commands.

 For more information, please refer to the NAMES_AND_DIRECTORIES topic.

7  –  SYNONYM_DIRECTORY

 This specifies the base directory or name entry to use when checking and
 displaying the synonym mapping link to the node name.

     SYNONYM_DIRECTORY syn-dir-name

 The links under this directory are used to map Phase IV synonyms to
 their respective node names.  These directories are used only for the
 DECdns directory service.

 If not specified, the default synonym directory is used.  This default
 can be displayed or changed using the SHOW or SET DEFAULT commands.

 For more information, please refer to the NAMES_AND_DIRECTORIES topic.

8  –  NSAP_FORMAT

 This specified the format to use when converting NSAP addresses to their
 text representation for display.

     NSAP_FORMAT DNA
     NSAP_FORMAT OSI

 This causes the appropriate format to be used:

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

 If not specified, the default NSAP format is used.  This default can be
 displayed or changed using the SHOW or SET DEFAULT commands.

9  –  OUTPUT_FILE

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

     OUTPUT_FILE out-file-name

 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