 |
OpenVMS System Manager's Manual
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.
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:
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:
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
-
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.
|
