Change the registered name for a node in a directory service.
RENAME [DECNET] NODE old-node-name NEW_NAME new-node-name
[ DIRECTORY_SERVICE dir-service ]
[ SYNONYM new-synonym-name ]
[ REVERSE_DIRECTORY rev-dir-name ]
[ SYNONYM_DIRECTORY syn-dir-name ]
This is used when a node's name has been changed, and that change needs
to be reflected in a directory service. The attribute values stored
under the name remain unchanged.
Nodes can be renamed only within a directory service. They cannot be
renamed from one type of directory service to another.
This function only changes the name in the directory service, and does not
directly affect the name on the node itself. To change the name on the
node, use the node's network configuration utility.
1 – NODE
This specifies the name of the node to be renamed.
NODE old-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 – NEW_NAME
This specifies the new name for the node.
NEW_NAME new-node-name
The new node name must be a 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
3 – DIRECTORY_SERVICE
This specifies the directory service that contains the node to be renamed.
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 – SYNONYM
This specifies the new Phase IV synonym for the node. Phase IV synonyms
can be used in place of fully specified node names, particularly with
applications that do not support full node names.
SYNONYM new-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 explicitly 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 previous synonym name is
retained.
5 – REVERSE_DIRECTORY
This specifies the base directory or name entry to use when redirecting
the reverse address mapping links (also called back translation links)
from the old to the new node name.
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.
6 – SYNONYM_DIRECTORY
This specifies the base directory or name entry to use when redirecting
the synonym mapping link from the old to the new 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.