This command enters your router in the DECnet database of one of its load hosts.
DEFINE affects the permanent DECnet database and SET affects the volatile database.
The load host is the local node. This command executes at the local node and does not affect the running router's operational database. Some privileges are usually required to execute this command. See the load host system manager for the appropriate privileges.
A DECnet system must have an entry for your router in three databases (see Section 4.1.1) before it can function as a load host. However, Digital strongly suggests that you do not use the DEFINE NODE and SET NODE commands to manually man-age a load host's DECnet databases for the router. Instead, use the automated proce-dure called ROUCONFIG (see Chapter 4).
Format
NOTE
The ROUCONFIG procedure automatically keeps the load host's data-bases synchronized. If you issue individual NCP DEFINE NODE and SET NODE commands, the three databases can become unsyn-chronized. Use DEFINE NODE and SET NODE only to make temporary changes, perhaps for testing, or to load the router from a load host that does not have the automated procedure.
{DEFINE} NODE rtr-node-id SET
ADDRESS DECnet-node-address DUMP FILE [uic]:RTRnode-name.DMP HARDWARE ADDRESS E-address LOAD FILE [uic]:RTRnode-name.SYS NAME DECnet-node-name
SERVICE CIRCUIT circuit-id SERVICE PASSWORD hex-password
where
ADDRESS DECnet-node-address
identifies the DECnet node address of the router. Specify the address as area. node-number.
NCP Command Descriptions 9-17
DEFINE/SET NODE
DVMP FILE [uic):RTRnode-name.DMP
identifies the name of the dump file into which the router up-line dumps data if . it experiences an unexpected failure.
[uic) is the VIC where the file resides. For the name of this VIC, see the DECrouter 200 SOftware Installation Guide for the operating system of the load host. For example, on VAX/VMS load hosts, DECrouter 200 files reside in SYSSSYSROOT:[J?ECSERVER).
Specify node-name as the router's DECnet node name.
HARDWARE ADDRESS E-address
is the Ethernet hardware address of the DECrouter 200 unit.
LOAD FILE [uic):RTRnode-name.SYS
identifies the name of the router's software image file, known to the load host as the load file.
[uicJ is the UIC where the file resides. For the name of this DIC, see the DECrouter 200 Software Installation Guide for the operating system of the load host. For example, on VAX/VMS load hosts, DECrouter 200 files reside in SYSSSYSROOT:[DECSERVER).
Specify node-name as the router's DECnet node name.
NAME DECnet-node-name
identifies the DECnet node name of the router. Specify the unique node name with a string of from 1 to 6 alphanumeric characters. At least one character must be a letter.
rtr-node-id
identifies the DEC net node name or DEC net node address of the DECrouter 200 node.
If you already defined a name for the router node on this load host, you can enter either the node-name or the node-address as the node-id. If you did not define a name, you must specify the router's DECnet node address.
Specify the address as area. node-number. Specify the unique node name with a string of from 1 to 6 alphanumeric characters. At least one character must be a letter.
SERVICE CIRCUIT circuit-id
is the load host's Ethernet circuit to be used for down-line loading and up-line dumping.
9-18 DECrouter 200 Management Guide, Vok I
DEFINE/SET NODe
SERVICE PASSWORD hex-password
specifies the router's DEC net service p~ssword. Specify hex-password with 1 to 16 hexadecimal digits (the characters 0 to 9 and A to F).
Example
WARNING
For effective security, Digital strongly suggests that you do not store your router's DECnet service password in the load host's DECnet databases.
The following command on a VAX/VMS load host defines DEC router 200 node 55.44 in the operational DECnet database of this load host. Line continuators (-) are used for continuing the long command line.
NCP>SET NODE 55.44 NAME JUNCO - ~
- DUMP FILE SYS$SYSROOT:[DECSERVERJRTRJUNCO.DMP - CB&JJ - LOAD FILE SYS$SYSROOT:[DECSERVERJRTRJUNCO.SYS - (RET)
- HARDWARE ADDRESS 08-00-2B-OO-OO-86 SERVICE CIRCUIT UNA-O (RET) NCP>
NCP Command Descriptions 9-19
HELP
This command provides on-line information about using NCP. HELP first displays a list of the NCP commands and you can then specify a command for which you want information.
NOTE
This command and how you use it may vary depending on the oper-ating system of the management host/load host.
Format
HELP [command]
Format Notes
1. Typing HELP displays the commands and topics for which information is available.
2. Typing HELP plus a specific command displays information about that command.
t;'YAmnIA 1 ---.---
CIRCUIT EXECUTOR LINE LOGGING MODULE NODE OBJECT SET Subtopic?
9-20 DECrouter 200 Management Guide, Vol. I
LOAD
This command initiates a down-line load of the router's software image from a load host to the DECrouter 200 unit. The load host from which you issue the command performs the down-line load.
The load host is the local node. This command executes at the local node but it does affect the router's operational database.
Use one of three command formats:
• Format 1
If you or the software installer ran the ROUCONFIG configuration procedure as Digital strongly suggests (see Chapter 4 of this manual or the DECrouter 200 Software Installation Guide), use Format 1.
• Formats 2 and 3
If, instead of running ROUCONFIG, you or the software installer manually defined the router in the appropriate DECnet databases (see the DEFINE/SET NODE com-mand description), use Format 2 or 3.
• Formats 2 and 3
If you wish to override the router's node parameters in the DECnet databases, use Format 2 or 3.
See Section 5.2.2 for more details about down-line loading with the LOAD command.
Format 1
LOAD NODE rtr-node-id [SERVICE PASSWORD hex-password]
Format 2
LOAD NODE rtr-node-id [FROM rtr-image ]
HOST host-id
SERVICE PASSWORD hex-password Format 3
LOAD VIA circuit-id PHYSICAL ADDRESS E-address [FROM rtr-image ] HOST host-id
SERVICE PASSWORD hex-password
NCP Command Descriptions 9-21
LOAD
where circuit-id
is the Ethernet circuit over which the router's software image is to be loaded.
FROM rtr-image
Identifies the unique name of the router's software image file on the load host.
Specify rtr-image as RTRnode-name.SYS, where node-name is the DECnet node name of your router.
HOST host-id
is the assigned load host. This load host will receive up-line dumps and event mes-sages (unless you specified another logging host). Specify host-id as the host's DECnet node name or DECnet node address.
PHYSICAL ADDRESS E-address
is the Ethernet hardware address of the DECrouter 200 unit.
rtr-node-id
is the DECnet node name or node address of the router you want to reload.
SERVICE PASSWORD hex-password
is the router's DECnet service password. This password must match the service password defined in the router's database.
Required if you defined a DECnet service password for the router, as Digital strongly recommends, and you do not also store this password in the load host's DEC net database, as Digital also strongly suggests.
Example
This command, executed at one of router ROBIN's assigned load hosts, initiates a down-line load of ROBIN's software image from that load host to the DEC router 200 unit.
The router checks the service password FF44 to see if it matches the service password defined in its database.
NCP> LOAD NODE ROBIN SERVICE PASSWORD FF44 ~
9-22 DECrouter 200 Management Guide, Vol. I