Updated: 24 May 2001

DECnet-Plus for OpenVMS
Network Management

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.

Syntax

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]

Arguments

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.

Syntax

manage [directory_service dir-service ]

Arguments

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.

Syntax

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]

Arguments

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.

Syntax

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]

Arguments

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.

Syntax

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]

Arguments

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

Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal

6499PRO_029.HTML