DECNET_REGISTER_COMMANDS.HLB  —  MODIFY
 Change a node's registered address tower or Phase IV synonym information.

     MODIFY [DECNET] NODE node-name
         [ DIRECTORY_SERVICE dir-service ]
         [ SYNONYM synonym-name ]
         [ TOWERS {tower-set} ]
         [ PHASEIV_PREFIX addr-prefix ]
         [ REVERSE_DIRECTORY rev-dir-name ]
         [ SYNONYM_DIRECTORY syn-dir-name ]

 This command is used when the registered information for a node needs
 to be changed.

1  –  NODE 

 This specifies the name of the node whose address towers are to be
 modified.

     NODE node-name

 The node name must be the fully specified name for the node in the
 directory service.  For example:

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

2  –  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.

3  –  SYNONYM 

 This specifies a new Phase IV synonym for the node.  This replaces any
 current Phase IV synonym value in the node registration.  Phase IV
 synonyms can be used in place of fully specified node names, particularly
 with applications that do not support full node names.

     SYNONYM synonym-name

 The synonym must be from 1 to 6 letters (A to Z) or digits (0 to 9), with
 at least one letter.  To specify that the node has no Phase IV synonym,
 use two quotation marks ("") for the Phase IV synonym name.  For example:

     SYNONYM MLHUB
     SYNONYM ""

 If the SYNONYM parameter is not specified, the current synonym name for
 the node is not modified.

4  –  TOWERS 

 This specifies the set of one or more address towers for the node
 registration.  This replaces any current tower information in the
 node registration.

     TOWERS {tower, tower, ...}

 Each address tower in the set has the format:

     transport/address

 Fields can be omitted from left to right, and assume a default value.

     Transport can be either TP4, TP4=tsel, or NSP, and defaults to NSP
     if the N-Sel in the address field is "20", and to TP4 otherwise.

     Address can be either an NSAP value or a Phase IV address value.
     If a Phase IV address is specified, an NSAP is constructed using
     the specified address and the Phase IV prefix value.  The N-Sel
     value is always "20".

 Assuming that the Phase IV address prefix value is "49::", some examples
 of address towers are:

   Abbreviation                      Fully Specified
   ------------                      ---------------
   1.5                               NSP/49::01:AA0004000504:20
   1.5+39:840                        NSP/39:840:01:AA0004000504:20
   39:840:01:AA0004000504:20         NSP/39:840:01:AA0004000504:20
   39:840:01:AA0004000504:21         TP4=DEC0/39:840:01:AA0004000504:21
   TP4/39:840:01:AA0004000504:21     TP4=DEC0/39:840:01:AA0004000504:21

 Examples of address towers using normal default values for a DECnet
 Phase IV node and for a DECnet-Plus node might be:

   TOWERS={1.5}
   TOWERS={2.54, 39:840:01:080043A751F4:20, 39:840:01:080043A751F4:21}

 To specify that the node has no towers, supply an empty tower set.  For
 example:

   TOWERS={}

 If the TOWERS parameter is not specified, the current address towers for
 the node are not modified.

 See the ADDRESS_TOWERS topic for details about the address towers.

5  –  PHASEIV_PREFIX 

 This specifies the AFI, IDI, and preDSP to use when constructing an
 NSAP from a Phase IV address.  This is used when a Phase IV address
 is specified in an address tower.

   PHASEIV_PREFIX addr-prefix

 For example:

     TOWERS {1.5} PHASEIV_PREFIX 39:840:800AB738

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

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

 An alternate way of expressing this would be:

     TOWERS {1.5+39:840:800AB738}

 The advantage of using the PHASEIV_PREFIX method is that the address
 prefix is applied to all Phase IV addresses without being specified
 multiple times.

 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 creating
 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 creating
 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.
Close Help