OpenVMS System Manager's Manual

Document revision date: 30 March 2001

OpenVMS System Manager's Manual

Contents

Index

24.2 Managing Local Area Networks

The local area network (LAN) software includes two system management tools that work in conjunction with the OpenVMS LAN driver system software:

Local Area Network Control Program (LANCP)
LAN Auxiliary Control Program (LANACP) LAN server process

The LAN system management tools:

Allow you to set LAN parameters to customize your LAN environment.
Display LAN settings and counters.
Provide Maintenance Operations Protocol (MOP) downline load support for devices such as terminal servers, x-terminals, and LAN-based printers, and for booting satellites in an OpenVMS Cluster environment. This MOP support provides an alternative to the traditional method of using either DECnet for OpenVMS or DECnet/OSI software.

Table 24-2 describes the LAN management software and the functionality supported on systems running OpenVMS Alpha and OpenVMS VAX.

Table 24-2 LAN System Management Enhancements
Utility Description OpenVMS Support

LAN Auxiliary Control Program (LANACP) Runs as a server process whose primary function is to provide MOP downline load service. Other services include maintenance of a LAN volatile device database and a LAN volatile node database. The LANACP utility provides identical functionality on VAX and Alpha systems running OpenVMS Version 7.0 and later.

LAN Control Program (LANCP) Allows you to control LAN software parameters and obtain information from the LAN software. You can use the LANCP utility to:

Obtain LAN device counters, revision, and configuration information
Change the operational parameters of LAN devices on the system
Maintain the permanent and volatile LAN device and node databases
Control the LANACP LAN server process (including MOP downline load server related functions)
Initiate MOP console carrier connections
Send MOP trigger boot requests to other nodes
OpenVMS Alpha Version 6.1 contained the initial implementation of LANCP, which did not include MOP-related functions.
OpenVMS Version 6.2 (VAX and Alpha) added MOP-related functions and extended some of this capability to VAX systems. The following table shows how the LAN utility functions are currently supported on VAX and Alpha systems:

Function OpenVMS Alpha Version 7.3 OpenVMS VAX Version 7.3

Change operational parameters of LAN devices? Yes No

Display LAN device information? Yes Limited

Support MOP functions? Yes Yes

24.3 Understanding the LANACP LAN Server Process

You can run the LANACP LAN server process to provide the following services:

Maintenance of the LAN volatile node database
Maintenance of the LAN volatile device database
MOP downline load

The LANCP utility allows you to issue instructions to the LANACP process.

Three principal files are connected with LANACP:

SYS$SYSTEM:LANACP.EXE
This file is the LANACP utility program.
SYS$STARTUP:LAN$STARTUP.COM
This file starts the LANACP server process.
SYS$STARTUP:VMS$DEVICE_STARTUP.COM
This file contains an entry that is used to start LANACP automatically at system startup.

In addition, four system logical names, described in Table 24-3, are associated with the LANACP LAN server process.

Table 24-3 LANACP System Logical Names
Component Description

LAN$DLL Defines the location of downline load files, where the location of the file is not provided in the load request or explicitly defined in the LAN volatile node database. By default, this is defined as SYS$SYSROOT:[MOM$SYSTEM].

LAN$NODE_DATABASE Defines the location of the LAN permanent node database. By default, this is defined as SYS$COMMON:[SYSEXE]LAN$NODE_DATABASE.DAT.

LAN$DEVICE_DATABASE Defines the location of the LAN permanent device database. By default, this is defined as SYS$SPECIFIC:[SYSEXE]LAN$DEVICE_DATABASE.DAT.

LAN$ACP Defines the location of the LANACP LAN server process log file, containing entries describing changes to the LAN permanent device and node databases, and load request and load status information. By default, this is defined as SYS$MANAGER:LAN$ACP.LOG.

**Table 24-3 LANACP System Logical Names**
Component	Description
LAN$DLL	Defines the location of downline load files, where the location of the file is not provided in the load request or explicitly defined in the LAN volatile node database. By default, this is defined as SYS$SYSROOT:[MOM$SYSTEM].
LAN$NODE_DATABASE	Defines the location of the LAN permanent node database. By default, this is defined as SYS$COMMON:[SYSEXE]LAN$NODE_DATABASE.DAT.
LAN$DEVICE_DATABASE	Defines the location of the LAN permanent device database. By default, this is defined as SYS$SPECIFIC:[SYSEXE]LAN$DEVICE_DATABASE.DAT.
LAN$ACP	Defines the location of the LANACP LAN server process log file, containing entries describing changes to the LAN permanent device and node databases, and load request and load status information. By default, this is defined as SYS$MANAGER:LAN$ACP.LOG.

24.3.1 Running the LANACP LAN Server Process

To start the LANACP LAN server process, type @SYS$STARTUP:LAN$STARTUP at the DCL prompt.

24.3.2 Stopping the LANACP LAN Server Process

To stop the LANACP LAN server process, enter the SET ACP/STOP command at the LANCP utility prompt.

24.4 Understanding the LANCP Utility

The LANCP utility allows you to set and show LAN parameters. Section 24.4.1 describes how to invoke the LANCP utility. Table 24-4 describes LAN functions and provides section references to the LANCP commands that help you perform these functions.

Table 24-4 Functions of the LANCP Utility
Task Section

Managing LAN devices Section 24.5

Managing LAN device databases Section 24.6

Managing LAN node databases Section 24.7

Managing the MOP downline load service Section 24.9

Initiating a MOP console carrier connection Section 24.9.8

Sending MOP trigger boot requests Section 24.9.9

**Table 24-4 Functions of the LANCP Utility**
Task	Section
Managing LAN devices	Section 24.5
Managing LAN device databases	Section 24.6
Managing LAN node databases	Section 24.7
Managing the MOP downline load service	Section 24.9
Initiating a MOP console carrier connection	Section 24.9.8
Sending MOP trigger boot requests	Section 24.9.9

24.4.1 Invoking and Running LANCP

Table 24-5 describes the ways you can invoke and run the LANCP utility (SYS$SYSTEM:LANCP.EXE).

Table 24-5 Invoking the LANCP Utility
Command Example

Use the RUN command At the DCL command prompt, enter:
$ RUN SYS$SYSTEM:LANCP

The LANCP utility displays the LANCP prompt at which you can enter LANCP commands.

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 command LANCP at the DCL prompt to invoke the utility and enter LANCP commands.
When you enter the LANCP command:

Without specifying any command qualifiers, the LANCP utility displays the LANCP prompt at which you can enter commands.
With command qualifiers, the LANCP utility terminates after it executes the command and returns you to the DCL prompt.

Use the MCR command At the DCL command prompt, enter:
$ MCR LANCP

When you enter the MCR LANCP command:

Without specifying any command qualifiers, the LANCP utility displays the LANCP prompt at which you can enter commands.
With command qualifiers, the LANCP utility terminates after it executes the command and returns you to the DCL prompt.

**Table 24-5 Invoking the LANCP Utility**
Command	Example
Use the RUN command	At the DCL command prompt, enter: $ RUN SYS$SYSTEM:LANCP The LANCP utility displays the LANCP prompt at which you can enter LANCP commands.
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 command LANCP at the DCL prompt to invoke the utility and enter LANCP commands. When you enter the LANCP command: Without specifying any command qualifiers, the LANCP utility displays the LANCP prompt at which you can enter commands. With command qualifiers, the LANCP utility terminates after it executes the command and returns you to the DCL prompt.
Use the MCR command	At the DCL command prompt, enter: $ MCR LANCP When you enter the MCR LANCP command: Without specifying any command qualifiers, the LANCP utility displays the LANCP prompt at which you can enter commands. With command qualifiers, the LANCP utility terminates after it executes the command and returns you to the DCL prompt.

At the LANCP> prompt, you can enter LANCP commands.

For information about the LANCP utility, enter the HELP command at the LANCP> prompt.

To exit from the LANCP utility, enter the EXIT command or press Ctrl/Z at the LANCP> prompt.

24.4.2 LANCP Commands

Table 24-6 summarizes the LANCP commands.

Table 24-6 LANCP Commands
Command Function

@ (Execute Procedure) Executes a command procedure.

CLEAR DEVICE Deletes a device from the LAN volatile device database.

CLEAR DLL Clears MOP downline load counters for all nodes and devices.

CLEAR MOPDLL Same as the CLEAR DLL command.

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 a device database to the current format required by LANCP.

CONVERT NODE_DATABASE Converts a node database to the current format required by 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 a device 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 Modifies device characteristics in the LAN volatile device database and in the device itself.

SET NODE Enters a node into the LAN volatile node database or modifies an existing entry.

SHOW CONFIGURATION Displays a list of LAN devices on the system.

SHOW DEVICE Displays information in the LAN volatile device database.

SHOW DLL Displays the current state of MOP downline load services.

SHOW LOG Displays recent downline load activity.

SHOW MOPDLL Same as the SHOW DLL command.

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.

**Table 24-6 LANCP Commands**
Command	Function
@ (Execute Procedure)	Executes a command procedure.
CLEAR DEVICE	Deletes a device from the LAN volatile device database.
CLEAR DLL	Clears MOP downline load counters for all nodes and devices.
CLEAR MOPDLL	Same as the CLEAR DLL command.
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 a device database to the current format required by LANCP.
CONVERT NODE_DATABASE	Converts a node database to the current format required by 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 a device 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	Modifies device characteristics in the LAN volatile device database and in the device itself.
SET NODE	Enters a node into the LAN volatile node database or modifies an existing entry.
SHOW CONFIGURATION	Displays a list of LAN devices on the system.
SHOW DEVICE	Displays information in the LAN volatile device database.
SHOW DLL	Displays the current state of MOP downline load services.
SHOW LOG	Displays recent downline load activity.
SHOW MOPDLL	Same as the SHOW DLL command.
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.

For detailed information about LANCP commands and qualifiers, refer to the OpenVMS System Management Utilities Reference Manual: A--L.

24.4.3 LANCP Miscellaneous Functions

Use the SPAWN command to create a subprocess of the current process. The SPAWN command copies the context of the subprocess from the current process. This allows you to exit temporarily from LANCP without having to restart LANCP when you resume.

The syntax for the SPAWN command is as follows:

SPAWN [command-string]

You can set up the LANCP utility to execute commands from a command file from within LANCP. The LANCP utility recognizes the command file as the file name preceded by the at sign (@). The default file name extension is .COM.

24.5 Managing LAN Devices

LAN device management consists of displaying device characteristics and setting device parameters. You can use the LANCP utility to set parameters for the types of LAN devices shown in Table 24-7.

Table 24-7 LAN Devices
LAN Device Examples Description

Ethernet DE425, DE434, DE435, DE436, DE500, DECchip 21040, DEMNA Allow the selection of media type (type of cable connected) and the speed of connection (Ethernet or FastEthernet).
Allow full-duplex operation (point-to-point operation between a similar device or between the device and a switch).

FDDI DEFTA, DEFPA, DEFAA, DEFEA, DEMFA Allow full-duplex operation.

Token Ring++ DETRA, DW300, DW110, TC4048 Allow the setting of Token Ring parameters and the definition of source routing and functional address mapping.

All Any Allow the setting of generic parameters such as the number of receive buffers.

ATM++ DGLTA, DGLPA, DGLPB, DAPBA, DAPCA Allow the setting of Emulated LAN (ELAN) parameters.

**Table 24-7 LAN Devices**
LAN	Device Examples	Description
Ethernet	DE425, DE434, DE435, DE436, DE500, DECchip 21040, DEMNA	Allow the selection of media type (type of cable connected) and the speed of connection (Ethernet or FastEthernet). Allow full-duplex operation (point-to-point operation between a similar device or between the device and a switch).
FDDI	DEFTA, DEFPA, DEFAA, DEFEA, DEMFA	Allow full-duplex operation.
Token Ring++	DETRA, DW300, DW110, TC4048	Allow the setting of Token Ring parameters and the definition of source routing and functional address mapping.
All	Any	Allow the setting of generic parameters such as the number of receive buffers.
ATM++	DGLTA, DGLPA, DGLPB, DAPBA, DAPCA	Allow the setting of Emulated LAN (ELAN) parameters.

++Alpha only

24.5.1 Displaying System Devices

To display the LAN devices on the system, enter the SHOW CONFIGURATION command using the following syntax:

SHOW CONFIGURATION

Example

LANCP> SHOW CONFIGURATION LAN Configuration: Device Medium Default LAN Address Version ------ ------ ------------------- ------- EWA0 CSMA/CD 08-00-2B-E4-00-BF 02000023 EWB0 CSMA/CD 08-00-2B-92-A4-0D 02000023 IRA0 Token Ring 00-00-93-58-5D-32 20000223

This command displays the output from a SHOW CONFIGURATION command that was entered on a node that has three LAN devices: two DE435s, and a DETRA:

The version is the device-specific representation of the actual version. In this example, for two devices on the PCI bus, the actual version is in the low byte (2.3 for the DE435 adapters). A device that does not have a readable version is shown as version zero.

Consult your device-specific documentation to correlate the version returned with a particular hardware or firmware implementation of the device.

24.5.2 Displaying Device Characteristics

To display information about a LAN device (in the volatile device database), enter the LANCP command SHOW DEVICE using the following syntax:

SHOW DEVICE device-name [/qualifiers]

Table 24-8 provides a brief description of the SHOW DEVICE command qualifiers.

Note

If you do not specify a qualifier, the utility displays the matching devices without additional information.

Table 24-8 SHOW DEVICE Command Qualifiers
Qualifier Description

/ALL Shows all devices which match device name.

/CHARACTERISTICS Same as the /PARAMETERS qualifier.

/DLL It shows downline load characteristics.

/COUNTERS Displays device counters.

/MAP Displays the current configuration of the functional address mapping table.

/MOPDLL Same as the /DLL qualifier.

/OUTPUT++ Directs output to the specified filename.

/PARAMETERS Displays status and related information about the device.

/REVISION Displays the current firmware revision of the adapter, if available or applicable.

/SR_ENTRY Displays the contents of the current source routing cache table.

**Table 24-8 SHOW DEVICE Command Qualifiers**
Qualifier	Description
/ALL	Shows all devices which match device name.
/CHARACTERISTICS	Same as the /PARAMETERS qualifier.
/DLL	It shows downline load characteristics.
/COUNTERS	Displays device counters.
/MAP	Displays the current configuration of the functional address mapping table.
/MOPDLL	Same as the /DLL qualifier.
/OUTPUT++	Directs output to the specified filename.
/PARAMETERS	Displays status and related information about the device.
/REVISION	Displays the current firmware revision of the adapter, if available or applicable.
/SR_ENTRY	Displays the contents of the current source routing cache table.

++Alpha only

Examples

LANCP> SHOW DEVICE/COUNTERS EXA0 Device Counters EXA0: Value Counter ----- ------- 259225 Seconds since last zeroed 5890496 Data blocks received 4801439 Multicast blocks received 131074 Receive failure 764348985 Bytes received 543019961 Multicast bytes received 3 Data overrun 1533610 Data blocks sent 115568 Multicast packets transmitted 122578 Blocks sent, multiple collisions 86000 Blocks sent, single collision 189039 Blocks sent, initially deferred 198120720 Bytes sent 13232578 Multicast bytes transmitted 7274529 Send failure 0 Collision detect check failure 0 Unrecognized frame destination 0 System buffer unavailable 0 User buffer unavailable

This SHOW DEVICE command displays counters for Ethernet device EXA0.

LANCP> SHOW DEVICE/MAP ICA0 Multicast to Functional Address Mapping ICA0: Multicast address Functional Address Bit-Reversed ----------------- ------------------ ------------ 09-00-2B-00-00-04 03-00-00-00-02-00 C0:00:00:00:40:00 09-00-2B-00-00-05 03-00-00-00-01-00 C0:00:00:00:80:00 CF-00-00-00-00-00 03-00-00-08-00-00 C0:00:00:10:00:00 AB-00-00-01-00-00 03-00-02-00-00-00 C0:00:40:00:00:00 AB-00-00-02-00-00 03-00-04-00-00-00 C0:00:20:00:00:00 AB-00-00-03-00-00 03-00-08-00-00-00 C0:00:10:00:00:00 09-00-2B-02-00-00 03-00-08-00-00-00 C0:00:10:00:00:00 09-00-2B-02-01-0A 03-00-08-00-00-00 C0:00:10:00:00:00 AB-00-00-04-00-00 03-00-10-00-00-00 C0:00:08:00:00:00 09-00-2B-02-01-0B 03-00-10-00-00-00 C0:00:08:00:00:00 09-00-2B-00-00-07 03-00-20-00-00-00 C0:00:04:00:00:00 09-00-2B-00-00-0F 03-00-40-00-00-00 C0:00:02:00:00:00 09-00-2B-02-01-04 03-00-80-00-00-00 C0:00:01:00:00:00 09-00-2B-02-01-07 03-00-00-02-00-00 C0:00:00:40:00:00 09-00-2B-04-00-00 03-00-00-04-00-00 C0:00:00:20:00:00 09-00-2B-02-01-00 03-00-00-00-08-00 C0:00:00:00:10:00 09-00-2B-02-01-01 03-00-00-00-10-00 C0:00:00:00:08:00 09-00-2B-02-01-02 03-00-00-00-20-00 C0:00:00:00:04:00 03-00-00-00-00-01 03-00-00-00-00-01 C0:00:00:00:00:80 03-00-02-00-00-00 03-00-02-00-00-00 C0:00:40:00:00:00

This SHOW DEVICE command displays mapping information for Token Ring device ICA0.

LANCP> SHOW DEVICE/PARAM IRA0 Device Parameters IRA0: Value Parameter ----- --------- Normal Controller mode External Internal loopback mode 00-00-93-58-5D-32 Hardware LAN address Token Ring Communication medium Enabled Functional address mode No Full duplex enable No Full duplex operational 16 Line speed (megabits/second) 16 Mbps Ring speed STP Line media Enabled Early token release Disabled Monitor contender 200 SR cache entries 2 SR discovery timer 60 SR Aging Timer Enabled Source routing 3 Authorized access priority AA-00-04-00-92-FF Upstream neighbor 0 Ring number

This SHOW DEVICE command displays status and parameter information for Token Ring device IRA0.

LANCP> SHOW DEVICE/REVISION FXA0 Device revision FXA0: 05140823

This command displays revision information for FDDI device FXA0.

LANCP> SHOW DEVICE/SR_ENTRY ICA0 Source Routing Cache Table ICA0: LAN address State XmtTmo RcvTmo StaleTmo DiscvTmo ----------------- ----- -------- -------- -------- -------- AA-00-04-00-92-FF LOCAL 00000028 00000028 00000245 00000000

This SHOW DEVICE command displays source routing entry information for Token Ring device ICA0.

Contents

Index

privacy and legal statement

6017PRO_094.HTML