Document revision date: 30 March 2001

## OpenVMS System Manager's Manual

Previous | 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.

### 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

### 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.

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.

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.

++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.

++Alpha only

Examples

1.     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.

2.     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.

3.     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.

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

   This command displays revision information for FDDI device FXA0.

5.     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.

Previous | Next | Contents | Index

| privacy and legal statement |
6017PRO_094.HTML