1 REGISTER
!
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.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!
2 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.
!
!