|
HP OpenVMS Systems Documentation |
|
DECnet-Plus for OpenVMS
|
| Previous | Contents | Index |
The import command uses exported node registration information contained in an export/import file to help maintain a name service. You can create an export/import file using the export command or using a text editor.Using the import command and an existing export/import file, you can:
- Register nodes into a name service.
- Modify the node information contained in a name service.
- Register nodes in a name service if they do not already exist there, or modify them if they do exist.
- Replace a number of node names in one operation.
- Check whether or not the information in a name service matches the listed nodes.
- Deregister nodes from a name service.
import file file-name [function | error_file error-file-name | name_template template-name | directory_service dir-service | phaseiv_prefix addr-prefix | reverse_directory r-dir-name | synonym_directory s-dir-name]
file-name
Names the text file that contains the node information to import.function
Optional. Specifies one of the following import command functions:
register Registers the listed nodes into the specified name service. modify Makes changes to the node information in the name service. This makes it possible to make a large number of synonym or tower changes at one time. update Registers the listed nodes into the name service if they do not already exist, or modifies them if they do exist. This makes it possible to make changes in one name service based on the information from another name service. replace Deregisters any nodes that use the same synonyms or towers as the listed nodes. Then registers the listed nodes in the name service. This makes it possible to make a number of name changes at one time. verify Checks whether or not the information in the name service matches the listed nodes. deregister Deregisters the listed nodes from the name service. If you do not specify import command keyword, the import update function is performed.
error-file-name
Optional. Specifies the name of the file to receive any error reports. 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 with each error followed by the line from the input file that resulted in the error. After correcting each error, you can use the edited error file as an export file. Using this method, only those operations that resulted in an error will be re-tried.
If you do not specify an error file, all errors are sent to the screen.
template-name
Optional. Specifies how the import command is to use the node registration information contained in the export file name field.The node registration information contained in the export file includes each node's terminating name. Generally, a node's terminating name is that part of the node name that is the same regardless of the name service. For example, MailHub is the terminating name for both of the following nodes:
For DECdns: MyCo:.Sales.MailHub For local file: MailHub The name template is a string that illustrates how to construct a fully specified name for a node in a specified name service. To convert a terminating name to a fully specified name for the target name 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:
For DECdns: MyCo:.Sales.* Local: * If not specified, the name template defined in the export file for the target name service is used. If the export file does not contain a valid name template for the target name service, errors result.
dir-service
Optional. Specifies the target name service for the import function.The dir-service must be one of the following:
Name Service Keyword DECdns decdns Local file local Phase IV phaseiv If you do not specify directory_service, the default service specified with the set default command is used.
addr-prefix
Optional. Specifies the AFI, IDI, and preDSP to use when constructing an NSAP from a Phase IV address. The addr-prefix is used only when a Phase IV address is specified in an address tower.If you do not specify a phaseiv_prefix, the Phase IV prefix specified in the export file is used. If the export file does not contain a phaseiv_prefix definition, the default Phase IV prefix specified with the set default command is used.
r-dir-name
Optional. Specifies the base directory or name entry to use when creating reverse address mapping links for the node name. (These links are also called the back translation links.)The links under this directory are used to map NSAP values to their respective node names. Reverse address mapping links are used only by the DECdns name service.
If you do not specify a reverse_directory, the reverse_directory defined in the export file is used. If the export file does not contain a reverse_directory name definition for the target name service, the default reverse_directory specified with the set default command is used.
s-dir-name
Optional. Specifies the base directory or name entry to use when creating the synonym mapping links for the node name. The links under this directory are used to map Phase IV synonyms to their respective node names. Synonym mapping links are used only by the DECdns name service.If you do not specify a synonym_directory, 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 name service, the default synonym_directory specified with the set default command is used.
The manage command executes the directory management procedure for a specified name service. The management procedure invoked by the manage command manages only those aspects of the name service that affect how node names are stored and used. It does not provide for general management of the name service.The management procedure is executed as a child process. Control returns to decnet_register when the execution is complete.
The Phase IV nodes database and the local namespace do not require management for storage and use of names. This command does not apply to these name services.
For the DECdns name service, the decnet_register manage command invokes decnet_register_decdns.com.
manage [directory_service dir-service ]
dir-service
Optional. Specifies the name service that contains the node registration. The name service must be DECdns (specify decdns). If you do not specify a directory_service, the default service specified with the set default command is used. Use the show default command to display the default service type.
The modify command changes a node's registered address tower or Phase IV synonym information.
modify node node-name [directory_service dir-service | synonym synonym-name | towers {t-set} | phaseiv_prefix addr-prefix | reverse_directory r-dir-name | synonym_directory s-dir-name]
node-name
Specifies the full name (including any directories) of the node whose address towers are to be modified in the name service. The node name must be the fully specified name for the node in the name service:
Name Service Node Full Name DECdns MyCo:.Sales.MailHub Local file node MailHub Phase IV node MLHUB dir-service
Optional. Specifies the name service in which the node is to be registered. The dir-service must be one of the following:
Name Service Keyword DECdns decdns Local file local Phase IV phaseiv If you do not specify directory_service, the default service specified with the set default command is used.
synonym-name
Optional. Specifies a new Phase IV synonym for the node. This replaces any current Phase IV synonym value in the node registration.You can use a Phase IV synonym in place of a fully specified node-name, especially with applications that do not support full node names.
The synonym-name must be from one to six letters (A to Z) or digits (0 to 9). The synonym-name must contain at least one letter. To explicitly specify that a node has no Phase IV node name, specify two quotation marks ("") for the Phase IV synonym-name.
Synonym Description MLHUB Specifies the Phase IV synonym MLHUB "" Specifies that the node has no Phase IV synonym. If you omit the synonym parameter, the current synonym-name for the node is not modified.
t-set
Optional. Specifies the set of one or more address towers for the node registration. This replaces any current tower information in the node registration.Separate multiple address towers with commas. Include the set of address towers within braces.
Each address tower in the set has the following format: transport/address
You can omit fields from left to right, and assume a default value as follows:
Table E-3 Field Possible Values Default Value transport TP4, TP4=tsel, or NSP For an N-Sel value of 20, the default is NSP. Otherwise, the default is TP4. address NSAP value or Phase IV address value For a Phase IV address, an NSAP is constructed using the specified address and the Phase IV prefix value. The N-Sel value is always 20. For a Phase IV address prefix value of 49::, example address towers follow:
Table E-4 Abbreviated Address Tower Fully Specified Address Tower 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 TP4=A1/39:840:01:AA0004000504:21 TP4=A1/39:840:01:AA0004000504:21 An example address tower for a DECnet Phase IV node using normal default values follows:
TOWERS={1.5}An example address tower for a DECnet Phase V node using normal default values follows:
TOWERS={2.54, 39:840:01:080043A751F4:20, 39:840:01:080043A751F4:21}addr-prefix
Optional. Specifies the AFI, IDI, and preDSP to use when constructing an NSAP from a Phase IV address. The addr-prefix is used when a Phase IV address is specified in an address tower.If you do not specify a phaseiv_prefix, the default Phase IV prefix specified with the set default command is used.
r-dir-name
Optional. Specifies the base directory or name entry to use when creating the reverse address mapping links to the node name. The links created under this directory are used to map NSAP values to their respective node names. These directories are used only for the DECdns name service.If you do not specify a reverse_directory, the default reverse directory specified with the set default command is used.
s-dir-name
Optional. Specifies the base directory or name entry to use when creating the synonym mapping link to the node name. The links created under this directory are used to map Phase IV synonyms to their respective node names. These directories are used only for the DECdns name service.If you do not specify a synonym_directory, the default synonym directory specified with the set default command is used.
The register command adds a node registration to a name service. When a new node is available on the network, use the register command to add the new node registration to the name service.
register node node-name [directory_service dir-service | synonym synonym-name | towers {t-set} | phaseiv_prefix addr-prefix | reverse_directory r-dir-name | synonym_directory s-dir-name]
node-name
Specifies the full name (including any directories) of the new node to be registered in the name service. The node name must be the fully specified name for the node in the name service:
Name Service Node Full Name DECdns MyCo:.Sales.MailHub Local file node MailHub Phase IV node MLHUB dir-service
Optional. Specifies the name service in which the node is to be registered. The dir-service must be one of the following:
Name Service Keyword DECdns decdns Local file local Phase IV phaseiv If you do not specify service, the default service specified with the set default command is used.
synonym-name
Optional. Specifies the Phase IV synonym for the node. You can use a Phase IV synonym in place of a fully specified node-name, especially with applications that do not support full node names.The synonym-name must be from one to six letters (a to z) or digits (0 to 9). The synonym-name must contain at least one letter. To explicitly specify that a node has no Phase IV node name, specify two quotation marks ("") for the synonym-name.
Synonym Description MLHUB Specifies the Phase IV synonym MLHUB "" Specifies that the node has no Phase IV synonym. If you omit the synonym parameter, a synonym name is not registered for the node.
t-set
Optional. Specifies the set of one or more address towers for the node.Separate multiple address towers with commas. Include the set of address towers within braces.
Each address tower in the set has the following format: transport/address
You can omit fields from left to right, and assume a default value as follows:
Table E-5 Field Possible Values Default Value transport TP4, TP4=tsel, or NSP For an N-Sel value of 20, the default is NSP. Otherwise, the default is TP4. address NSAP value or Phase IV address value For a Phase IV address, an NSAP is constructed using the specified address and the Phase IV prefix value. The N-Sel value is always 20. For a Phase IV address prefix value of 49::, example address towers follow:
Table E-6 Abbreviated Address Tower Fully Specified Address Tower 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 TP4=A1/39:840:01:AA0004000504:21 TP4=A1/39:840:01:AA0004000504:21 An example address tower for a DECnet Phase IV node using normal default values follows:
TOWERS={1.5}An example address tower for a DECnet Phase V node using normal default values follows:
TOWERS={2.54, 39:840:01:080043A751F4:20, 39:840:01:080043A751F4:21}addr-prefix
Optional. Specifies the AFI, IDI, and preDSP to use when constructing an NSAP from a Phase IV address. The addr-prefix is used when a Phase IV address is specified in an address tower.If you do not specify a phaseiv_prefix, the default Phase IV prefix specified with the set default command is used.
r-dir-name
Optional. Specifies the base directory or name entry to use when creating the reverse address mapping links to the node name. The links created under this directory are used to map NSAP values to their respective node names. These directories are used only for the DECdns name service.If you do not specify a reverse_directory, the default reverse directory specified with the set default command is used.
s-dir-name
Optional. Specifies the base directory or name entry to use when creating the synonym mapping link to the node name. The links created under this directory are used to map Phase IV synonyms to their respective node names. These directories are used only for the DECdns name service.If you do not specify a synonym_directory, the default synonym directory specified with the set default command is used.
The remove command removes address towers from a node registration. This command is used when an address tower is no longer available on a node and the addressing information needs to be removed from the node registration in a name service.
remove node node-name towers {t-set} [directory_service dir-service | phaseiv_prefix addr-prefix | reverse_directory r-dir-name | synonym_directory s-dir-name]
node-name
Specifies the full name (including any directories) of the node whose address towers are to be removed from the name service. The node name must be the fully specified name for the node in the name service:
Name Service Node Full Name DECdns MyCo:.Sales.MailHub Local file node MailHub Phase IV node MLHUB dir-service
Optional. Specifies the name service in which the node is to be registered. The dir-service must be one of the following:
Name Service Keyword DECdns decdns Local file local Phase IV phaseiv If you do not specify directory_service, the default service specified with the set default command is used.
t-set
Optional. Specifies the set of one or more address towers for the node registration. This replaces any current tower information in the node registration.Separate multiple address towers with commas. Include the set of address towers within braces.
Each address tower in the set has the following format: transport/address
You can omit fields from left to right, and assume a default value as follows:
Table E-7 Field Possible Values Default Value transport TP4, TP4=tsel, or NSP For an N-Sel value of 20, the default is NSP. Otherwise, the default is TP4. address NSAP value or Phase IV address value For a Phase IV address, an NSAP is constructed using the specified address and the Phase IV prefix value. The N-Sel value is always 20. For a Phase IV address prefix value of 49::, example address towers follow:
Table E-8 Abbreviated Address Tower Fully Specified Address Tower 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 TP4=A1/39:840:01:AA0004000504:21 TP4=A1/39:840:01:AA0004000504:21 An example address tower for a DECnet Phase IV node using normal default values follows:
TOWERS={1.5}An example address tower for a DECnet Phase V node using normal default values follows:
TOWERS={2.54, 39:840:01:080043A751F4:20, 39:840:01:080043A751F4:21}addr-prefix
Optional. Specifies the AFI, IDI, and preDSP to use when constructing an NSAP from a Phase IV address. The addr-prefix is used when a Phase IV address is specified in an address tower.
Previous Next Contents Index