HP OpenVMS Systems Documentation
HP OpenVMS System Management Utilities Reference Manual
Replaces a known image entry with another version of the image, or with modified attributes of the image.
The REPLACE command updates a known file to the latest, or to a specified version found in the specified directory, or in another directory if the file-spec parameter uses a search list.
$ RUN SYS$SYSTEM:LANCP
The LANCP utility responds by displaying the LANCP> prompt, at which you can enter any LANCP command described in this chapter.
To define LANCP as a foreign command, either at the DCL prompt or in a startup or login command file, enter:
$ LANCP :== $SYS$SYSTEM:LANCP
Then you can enter the LANCP command at the DCL prompt to invoke the utility and enter LANCP commands.
When you enter the LANCP command:
Some LANCP commands require special privileges.
For information about the LANCP utility, enter the HELP command at the LANCP prompt.
This section describes and provides examples of the LANCP commands. The following table summarizes the LANCP commands:
|@ (Execute Procedure)||Executes a command procedure.|
|CLEAR DEVICE||Deletes device data from the LAN volatile device database.|
|CLEAR DLL or CLEAR MOPDLL||Clears MOP downline load counters for all nodes and devices.|
|CLEAR NODE||Deletes a node from the LAN volatile node database.|
|CONNECT NODE||Connects to a LAN device, such as a terminal server, that implements a management interface using the MOP console carrier protocol.|
|CONVERT DEVICE_DATABASE||Converts the device database to the format required by the current version of LANCP.|
|CONVERT NODE_DATABASE||Converts the node database to the format required by the current version of LANCP.|
|DEFINE DEVICE||Enters a device into the LAN permanent device database or modifies an existing entry.|
|DEFINE NODE||Enters a node into the LAN permanent node database or modifies an existing entry.|
|EXIT||Stops execution of LANCP and returns control to the DCL command level.|
|HELP||Provides online help information about the LANCP utility.|
|LIST DEVICE||Displays information in the LAN permanent device database.|
|LIST NODE||Displays information in the LAN permanent node database.|
|PURGE DEVICE||Deletes device data from the LAN permanent device database.|
|PURGE NODE||Deletes a node from the LAN permanent node database.|
|SET ACP||Modifies the operation of the LANACP LAN Server process.|
|SET DEVICE||Enters a device into the LAN volatile device database or modifies an existing entry and sets device parameters.|
|SET NODE||Enters a node into the LAN volatile node database or modifies an existing entry.|
|SHOW ACP||Displays currently set LANCP and LANACP options.|
|SHOW CONFIGURATION||Displays a list of LAN devices on the system.|
|SHOW DEVICE||Displays information in the LAN volatile device database and displays device data.|
|SHOW DLL or SHOW MOPDLL||Displays the current state of MOP downline load services.|
|SHOW LOG||Displays recent downline load activity.|
|SHOW NODE||Displays information in the LAN volatile node database.|
|SPAWN||Creates a subprocess of the current process.|
|TRIGGER NODE||Issues a request to reboot to a remote node.|
|UPDATE DEVICE||Updates a device, primarily to issue a reset to it.|
Executes a command procedure or requests the command interpreter to read subsequent command input from a specific file or device.
file-specSpecifies either the input device or the file for the preceding command, or the command procedure to be executed.
$ CREATE COUNT.COM SHOW DEVICE/COUNTERS EIA SPAWN WAIT 00:01:00 @COUNT [Ctrl/Z] $ RUN SYS$SYSTEM:LANCP LANCP> @COUNT Device Counters EIA0: Value Counter ----- ------- 62030 Seconds since last zeroed 19910982 Bytes received 239192 Bytes sent 155812 Packets received 4348 Packets sent 19910982 Multicast bytes received 239140 Multicast bytes sent 155812 Multicast packets received 4346 Multicast packets sent 0 Unrecognized unicast destination packets 134311 Unrecognized multicast destination packets 0 Unavailable station buffers 0 Unavailable user buffers 0 Alignment errors 0 Frame check errors 0 Frame size errors 0 Frame status errors 0 Frame length errors 0 Frame too long errors 0 Data overruns 0 Send data length errors 0 Receive data length errors 0 Transmit underrun errors 0 Transmit failures 0 Carrier check failures 0 Station failures 0 Initially deferred packets sent 0 Single collision packets sent 0 Multiple collision packets sent 0 Excessive collisions 0 Late collisions 0 Collision detect check failures 1 Link up transitions (19-OCT-2004 13:47:50.86) 0 Link down transitions None Time of last generic transmit error None Time of last generic receive error
This example creates and runs a command procedure, COUNT.COM, that displays device counters once every minute.
Deletes device data from the LAN volatile device database. Requires SYSPRV privilege.
CLEAR DEVICE device-name
device-nameSupplies the LAN controller device name. The device name has the form ddcu where dd is the device code, c is the controller designation, and u is the unit number.
LAN devices are specified as the name of the template device, which is unit 0. For example, the first PCI Ethernet device is specified as EWA0, the second as EWB0., and so on. You can, for example, specify a DEMNA controller as EXA, EXA0, or EXA0:.
/ALLDeletes data for all LAN devices in the LAN volatile device database. If you specify a device name, all matching LAN devices are selected. For example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all PCI Ethernet PCI devices.
/CHARACTERISTICS or /PARAMETERSDeletes device characteristics settings for the LAN device, such as speed, duplex mode, and other device parameters.
/DLL or /MOPDLLDeletes MOP downline load settings for the LAN device.
/TRACEDeletes driver tracing settings for the LAN device.
If no qualifier is present to select the type of data to delete, the entire device entry is deleted.
LANCP> CLEAR DEVICE EXA0
This command deletes device EXA0 from the LAN volatile device database.
This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices. This command requires SYSPRV privilege.
LANCP> CLEAR DLL
This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices.
Deletes a node from the LAN volatile node database. Requires SYSPRV privilege.
CLEAR NODE node-name
node-nameSupplies the name of a node in the LAN volatile node database.
/ALLDeletes all LAN nodes in the LAN volatile node database. If you specify a node name, all matching nodes are selected; for example, A/ALL deletes all nodes whose name begins with A.
LANCP> CLEAR NODE VAXSYS
This command deletes the node VAXSYS from the LAN volatile node database.
Opens a MOP console carrier connection to the specified node. This allows a local terminal to act as the console for a remote system.
CONNECT NODE node-specification
node-specificationSupplies either the node name or the node address of the target node. If you supply the node name, the node address is obtained by looking up the node name in the LAN volatile node database. If you supply the node address, the corresponding node need not be defined in the LAN volatile node database. The canonical form of the address consists of 6 hexadecimal byte characters separated by hyphens. Use a colon as the separator character to indicate the bit-reversed form of the address.
/DEVICE=device-nameSpecifies the LAN controller device name to be used for the connection. For example, you can specify a DEMNA controller as EXA, EXA0, or EXA0:.
/DISCONNECT=disconnect-characterSpecifies a character that you can use to terminate the connection to the remote node. To terminate a connection, press Ctrl/disconnect-character. You can select any ASCII character from @ through Z, except C, M, Q, S, Y; the default disconnect character is D.
/INPUT=filenameSupplies command input from the specified input file. Input is taken up to end-of-file or a disconnect character. If no disconnect character is encountered, the command input continues from the local terminal. If a local terminal does not exist---that is, if the command is executing in batch mode---end-of-file disconnects the console carrier connection.
/PASSWORD=16hexdigitsSupplies the password to be used when the connection is initiated, in hexadecimal (for example, /PASSWORD=0123456789ABCDEF). The default password is zero. You can omit leading zeros.
/V3 or /V4Indicates that MOP Version 3 or Version 4 formatted messages, respectively, are to be used to make the connection. By default, LANCP determines the format by sending MOP Request ID messages to the remote node first in MOP Version 4 format, then in Version 3 format, repeating this process until a response is received or timeout occurs.
You can specify the format:
- To allow connection to nodes that do not support Request ID messages
- As a means of getting around implementation problems with one of the formats
LANCP> CONNECT NODE GALAXY/DEVICE=EWA0
This command attempts a console-carrier connection to node GALAXY using the Ethernet device EWA0.
LANCP> CONNECT NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789AB
This command attempts a console-carrier connection to the given node address using the Ethernet device EWA0, with the specified password.
LANCP> CONNECT NODE TERM_SERVER/DEVICE=EWA0/INPUT=LOGOUT_PORT_3.COM
This command attempts a console-carrier connection to node TERM_SERVER to send the contents of the command file LOGOUT_PORT_3.COM.