Uses exported node registration information, contained in a text file
created by the EXPORT command or by a text editor, to help maintain
a directory service.
IMPORT FILE data-file-name
[ function ]
[ ERROR_FILE error-file-name ]
[ NAME_TEMPLATE template ]
[ DIRECTORY_SERVICE dir-service ]
[ PHASEIV_PREFIX addr-prefix ]
[ REVERSE_DIRECTORY rev-dir-name ]
[ SYNONYM_DIRECTORY syn-dir-name ]
1 – FILE
This specifies the name of the text file that contains the node
information to import.
FILE data-file-name
See the EXPORT_FILE topic for more information on the contents of
this file.
2 – Functions
The following functions are provided.
IMPORT REGISTER - Register the listed nodes into the specified
directory service.
IMPORT MODIFY - Make bulk changes to the nodes in the directory
service. This provides a way to make a large
number of synonym or tower changes at one time.
IMPORT UPDATE - Register the listed nodes into the directory
service if they do not already exist, or modify
them if they do exist. This provides a way to
make changes in one directory service based on
information in another directory service.
IMPORT REPLACE - Deregister any nodes that use the same synonyms
or towers as the listed nodes, and then register
the listed nodes into the directory service. this
provides a way to make a large number of name
changes at one time.
IMPORT VERIFY - Check whether or not the information in the
directory service matches the listed nodes.
IMPORT DEREGISTER - Deregister the listed nodes from the directory
service.
If no IMPORT function is specified, the IMPORT UPDATE function is assumed.
3 – ERROR_FILE
This specifies the name of the file to receive any error reports.
ERROR_FILE error-file-name
An error file is useful since the IMPORT command is performing bulk
operations that can result in errors scrolling off the screen.
Errors are written into the file as comments, followed by the line from
the input file that caused the error. This allows you to use the error
file as an IMPORT input file, after correcting the errors. Using this
method, only those operations that resulted in an error will be re-tried.
If not specified, all errors are sent to the screen.
4 – NAME_TEMPLATE
This specifies how the "name" field in the export file node registration
information is used.
NAME_TEMPLATE template
The node registration information contained in the export file includes
each node's terminating name. This is generally the part of the name that
is the same regardless of the directory service. For example, "MailHub"
is the terminating name for the following:
Local: MailHub
DECdns: MyCo:.Sales.MailHub
To convert a terminating name to a fully specified name for the target
directory service, it is combined with the name template. The name
template is a string that indicates what the fully specified name is to
look like, with an asterisk (*) where the terminating name goes. For
example:
Local: *
DECdns: MyCo:.Sales.*
If not specified, the name template defined in the export file for the
target directory service is used. If the export file does not contain a
valid name template for the target directory service, errors result.
See the EXPORT_FILE topic for descriptions of the name template control
line and the node registration information lines.
5 – DIRECTORY_SERVICE
This specifies the target directory service for the import function.
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.
6 – 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:
PHASEIV_PREFIX 39:840:800AB738
If not specified, the Phase IV prefix defined in the export file is used.
If the export file does not contain a Phase IV prefix definition, then
the Phase IV prefix set using the SET DEFAULT command is used.
See the PHASE_IV_PREFIXES topic for details about Phase IV prefix values.
See the EXPORT_FILE topic for a description of the Phase IV prefix control
line.
7 – REVERSE_DIRECTORY
This specifies the base directory or name entry to use when creating
reverse address mapping links for a 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 reverse address directory name defined in the
export file is used. If the export file does not contain a reverse
address directory name definition for the target directory service,
then the reverse directory name set using the SET DEFAULT command is
used.
For more information, please refer to the NAMES_AND_DIRECTORIES topic.
See the EXPORT_FILE topic for a description of the reverse address
directory control line.
8 – SYNONYM_DIRECTORY
This specifies the base directory or name entry to use when creating
synonym mapping links for a 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 synonym directory name defined in the export file
is used. If the export file does not contain a synonym directory name
definition for the target directory service, then the synonym directory
name set using the SET DEFAULT command is used.
For more information, please refer to the NAMES_AND_DIRECTORIES topic.
See the EXPORT_FILE topic for a description of the synonym directory
control line.