Extract node registration information for some set of nodes and write it
to a text file.
EXPORT [DECNET] NODE node-id FILE data-file-name
[ DIRECTORY_SERVICE dir-service ]
[ PHASEIV_PREFIX addr-prefix ]
[ REVERSE_DIRECTORY rev-dir-name ]
[ SYNONYM_DIRECTORY syn-dir-name ]
[ NSAP_FORMAT addr-format ]
Once the information has been exported, it can be:
- Used for reporting or database maintenance purposes.
- Used to make network-wide changes, such as modifying the NSAP IDP
value, by editing the text file and using the MODIFY feature of the
IMPORT command.
- Used to move node information from one directory service to another,
using the REGISTER, UPDATE, or REPLACE features of the IMPORT command.
- Used to verify that the addressing information in one directory
service is the same as in another directory service, using the VERIFY
feature of the IMPORT command.
- Used to remove node information from a directory service, using the
DEREGISTER feature of the IMPORT command.
1 – NODE
This specifies the identification of the nodes to be exported.
NODE node-id
The node identification can be one of:
The fully specified name for the node in the directory service.
The Phase IV synonym for the node.
One of the NET or NSAP addresses for the node.
The Phase IV address (and optional Phase IV prefix) for the node.
Wildcards are allowed in names and addresses.
1.1 – Names
The node to be exported can be specified using its full name or its
Phase IV synonym.
The syntax of a fully specified name depends on the directory service
being used. Examples of fully specified names might be:
For Local: NODE MailHub
For DECdns: NODE MyCo:.Sales.MailHub
For Phase IV: NODE MLHUB
An example of a Phase IV synonym for any of the above might be:
NODE MLHUB
Wildcards are allowed in the node name using an asterisk (*). For
example:
For Local: NODE Mail*
For DECdns: NODE MyCo:.Sales.Mail*
For Phase IV: NODE ML*
The wildcard character can come anywhere in the last part of the name.
Only a single wildcard character is allowed.
1.2 – Addresses
The node to be exported can be specified using one of its NETs (or
NSAPs), or its Phase IV address.
An NET is an NSAP address value with an N-Sel value of "00" (indicating
that it is independent of the type of transport service in use on the
node). If you specify an NSAP instead of an NET, it is converted to an
NET before it is used.
DNA format: <afi>:<idi>:<predsp>-<locarea>:<nodeid>:00
OSI format: <afi><idi>+<predsp><locarea><nodeid>00
Examples of NETs might be:
DNA format: NODE 39:840:0001:AA-00-04-00-05-04:00
OSI format: NODE 39840+0001AA000400050400
If the node has a Phase IV address, that can be used instead of an NET.
Format: <area>.<nodeid>
<area>.<nodeid>+<prefix>
This is internally converted to an NET, using the Phase IV prefix value.
The Phase IV prefix value can be specified with the Phase IV address or
the PHASEIV_PREFIX parameter, or set using the SET DEFAULT command.
Examples of a Phase IV address might be:
NODE 1.5 !Uses the default Phase IV prefix
NODE 1.5+39:840 !Uses an explicit Phase IV prefix
NODE 1.5 PHASEIV_PREFIX 39:840 !Uses an explicit Phase IV prefix
Wildcards are allowed in the NET or Phase IV address using an asterisk.
The wildcard character must replace either the node id, or the local
area and the node id. For an NET containing a wildcard, do not specify
an N-Sel value.
39:840:0001:* (or 39840+0001*) Wildcard the node id
39:840:* (or 39840+*) Wildcard the local area and node id
1.* Wildcard the node id
*.* Wildcard the area and node id
2 – FILE
This specifies the name of the text file to contain the exported
information.
FILE data-file-name
See the EXPORT_FILE topic for more information on the contents of
this file.
3 – DIRECTORY_SERVICE
This specifies the directory service that contains the node registration.
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.
4 – PHASEIV_PREFIX
This specifies the AFI, IDI, and preDSP to use when constructing an
NET from a Phase IV address. This is used only when a Phase IV address
is specified for the node id.
PHASEIV_PREFIX addr-prefix
An alternate form is to add the Phase IV prefix to the Phase IV address
specification.
For example:
NODE 1.5 PHASEIV_PREFIX 39:840:800AB738
NODE 1.5+39:840:800AB738
would both result in the following NET being used to represent the
DECnet Phase IV address:
39:840:800AB738-0001:AA-00-04-00-05-04:00
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.
5 – REVERSE_DIRECTORY
This specifies the base directory or name entry to use when exporting
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.
See the NAMES_AND_DIRECTORIES topic for more information on directories.
6 – SYNONYM_DIRECTORY
This specifies the base directory or name entry to use when exporting
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.
See the NAMES_AND_DIRECTORIES topic for more information on directories.
7 – NSAP_FORMAT
This specified the format to use when converting NSAP addresses to their
text representation in the export text file.
NSAP_FORMAT DNA
NSAP_FORMAT OSI
This causes the appropriate format to be used:
DNA format: <afi>:<idi>:<predsp>-<locarea>:<nodeid>:<nsel>
OSI format: <afi><idi>+<predsp><locarea><nodeid><nsel>
If not specified, the default NSAP format is used. This default can be
displayed or changed using the SHOW or SET DEFAULT commands.