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.