Add a node registration to a directory service.
REGISTER [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 is used when a new node is made available in the network, and the
node registration needs to be added to a directory service to allow
lookup by other nodes.
1 – NODE
This specifies the name of the new node to be registered.
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 the node is to be registered in.
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 the 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 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, a synonym name is not
registered for the node.
4 – TOWERS
This specifies the set of one or more address towers for the node.
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 explicitly specify that the node has no towers, supply an empty tower
set. For example:
TOWERS={}
If the TOWERS parameter is not specified, no towers are registered for
the node.
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.