1 IMPORT ! 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 ] ! 2 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. ! 2 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. ! 2 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. ! 2 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. ! 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: 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. ! 2 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. ! 2 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. ! !