View source for LANCP

'''LANCP''', or the LAN Control Program, is the utility that allows you to configure and control the LAN software and hardware on OpenVMS systems. It is part of OpenVMS and invoked by running SYS$SYSTEM:LANCP.EXE (via either [[RUN]] or [[MCR]]).

=Use=
LANCP can be used to:
* set LAN parameters to customize the LAN environment
* display LAN settings and counters
* provide MOP downline load support for devices such as terminal servers, x-terminals, and LAN printers, and for booting [[Satellite Node|satellites]] in an [[OpenVMS Cluster]] environment

=Supported 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 the table below:

{| class="wikitable"
! colspan='col' | LAN
! colspan='col' | Device Examples
! colspan='col' | Description
|-
| [[Ethernet]]
| DE425, DE434, DE435, DE436, DE500, DECchip 21040
| 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,DEMNA
| Allow full-duplex operation.
|-
| [[Token Ring]] ([[Alpha]] only)
| DETRA, DW300, DW110
| 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 (Alpha only)
| ATMworks 350, ATMworks 750
| The ATMworks 350 supports PCI-based systems. The ATMworks 750 supports TURBOchannel systems
|}

=Device Databases=
The LAN [[LANCP Volatile Device Database|volatile]] and [[LANCP Permanent Device Database|permanent]] device databases contain a single entry for each LAN device that exists on the system. Each entry in the LAN volatile device database contains device information and MOP downline load counters information. Each entry in the LAN permanent device database contains device information that is used to populate the volatile database when the LANACP LAN server process is started.

Typically, each database contains the same devices. However, the permanent database may contain entries for devices that have not yet been configured or installed in the system. The LANACP LAN server process maintains the volatile device database. The LANCP utility maintains the permanent device database. You can manipulate either database using the LANCP utility commands depending on your user privileges. Privileged users can add or delete device entries from each database, enable or disable MOP downline load service, and clear MOP downline load counters information for LAN devices. Unprivileged users can view the MOP downline load status and counters information.

Commands to view and modify the LAN device databases include:

{| class="wikitable"
! colspan='col' | Action
! colspan='col' | [[LANCP Permanent Device Database|Permanent database]]
! colspan='col' | [[LANCP Volatile Device Database|Volatile database]]
|-
| View
| LIST DEVICE
| SHOW DEVICE
|-
| Modify
| DEFINE DEVICE
| SET DEVICE
|}

=Commands=
{| class="wikitable"
! colspan='col' | Command
! colspan='col' style="width:350px;" | Function
! colspan='col' | Example
|-
| @
| Execute a command procedure containing LANCP commands. The default file extension is .COM.
| 
 <nowiki>
 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
<...>
 </nowiki>
|-
| CLEAR DDL ([[Alpha]] only)
| Same as the CLEAR MOPDLL command. Clears MOP downline load counters for all nodes and devices.
|  
<nowiki>
LANCP> CLEAR DLL
 </nowiki>
This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices.
|-
| CLEAR DEVICE
| Deletes a device from the LAN volatile device database.
| 
 <nowiki>
LANCP> CLEAR DEVICE EXA0
 </nowiki>
This command deletes device EXA0 from the LAN volatile device database
|-
| CLEAR MOPDLL
| Clears MOP downline load counters for all nodes and devices.
|-
| CLEAR NODE
| Deletes a node from the LAN volatile node database.
| 
 <nowiki>
LANCP> CLEAR NODE VAXSYS
 <nowiki>
This command deletes the node VAXSYS 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.
|
 <nowiki>
LANCP> CONNECT NODE GALAXY/DEVICE=EWA0
 </nowiki>
This command attempts a console-carrier connection to node GALAXY using the Ethernet device EWA0.
 <nowiki>
LANCP> CONNECT NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789AB
 </nowiki>
This command attempts a console-carrier connection to the given node address using the Ethernet device EWA0, with the specified password. 
 <nowiki>
LANCP> CONNECT NODE TERM_SERVER/DEVICE=EWA0/INPUT=LOGOUT_PORT_3.COM
 </nowiki>
This command attempts a console-carrier connection to node TERM_SERVER to send the contents of the command file LOGOUT_PORT_3.COM.
|-
| CONVERT DEVICE_DATABASE
| Converts an OpenVMS Version 6.2 format device database to an OpenVMS Version 7.1 format device database.
|-
| CONVERT NODE_DATABASE
| Converts an OpenVMS Version 6.2 format node database to an OpenVMS Version 7.1 format node database.
|-
| DEFINE DEVICE
| Enters a device into the LAN permanent device database or modifies an existing entry. (To access the volatile device database, use SET DEVICE; see [[LANCP Permanent Device Database]] for qualifiers that can be used with the DEFINE DEVICE command).
|
 <nowiki>
LANCP> DEFINE DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE)
 </nowiki>
This command defines LAN device EXA0 to enable LANACP MOP downline load service in exclusive mode. The setting of the KNOWNCLIENTSONLY and SIZE characteristics are not changed. If the device entry does not currently exist in the LAN permanent device database, these settings are set to the defaults.
 <nowiki>
LANCP> DEFINE DEVICE/ALL/MOPDLL=NOEXCLUSIVE
 <nowiki>
This command sets all LAN devices defined in the LAN permanent device database to nonexclusive mode for LANACP MOP downline load service.
 <nowiki>
LANCP> DEFINE DEVICE/ALL/UPDATE/VOLATILE_DATABASE
 </nowiki>
This command enters all Ethernet devices into the LAN permanent device database and updates the entry to include the current parameter values.
|-
| DEFINE NODE
| Enters a node into the LAN permanent node database or modifies an existing entry.
|
 <nowiki>
LANCP> DEFINE NODE GALAXY/ADDRESS=08-00-2B-11-22-33 -
/FILE=NISCS_LOAD.EXE -
/ROOT=$64$DIA14:<SYS10.> -
/BOOT_TYPE=VAX_SATELLITE
 </nowiki>
This command sets up node GALAXY in the LAN permanent node database for booting as a VAX satellite into an OpenVMS Cluster.
The NISCS_LOAD.EXE file is actually located on $64$DIA14:<SYS10.SYSCOMMON.SYSLIB>. The <SYSCOMMON.SYSLIB> is supplied by the LANACP LAN Server process and is not included in the root definition.
 <nowiki>
LANCP> DEFINE NODE ZAPNOT/ADDRESS=08-00-2B-11-22-33 -
/FILE=APB.EXE -
/ROOT=$64$DIA14:<SYS10.> -
/BOOT_TYPE=ALPHA_SATELLITE
 </nowiki>
This command sets up node ZAPNOT for booting as an Alpha satellite into an OpenVMS Cluster.
The APB.EXE file is actually located on $64$DIA14:<SYS10.SYSCOMMON.SYSEXE>. Note that the <SYSCOMMON.SYSEXE> is supplied by the LANACP LAN Server process and is not included in the root definition.
 <nowiki>
LANCP> DEFINE NODE CALPAL/ADDRESS=08-00-2B-11-22-33 -
/FILE=APB_061.EXE
 </nowiki>
This command sets up node CALPAL for booting an InfoServer image. It defines the file that should be loaded when a load request without a file name is received from node CALPAL. Because the file does not include a directory specification, the logical name LAN$DLL defines where to locate the file. You could give directory specification using the file name or by using the /ROOT qualifier. Note that specifying the file name explicitly in the boot command overrides the file name specified in the node database entry.
|-
| EXIT
| Stops execution of LANCP and returns control to the DCL command level.
| 
 <nowiki>
LANCP> exit
$
 </nowiki>
|-
| HELP
| Provides online help information about the LANCP utility.
| 
 <nowiki>
LANCP> help

  Information available:

  @          CLEAR      Commands   CONNECT    CONVERT    DEFINE     EXIT
  HELP       LIST       PURGE      SET        SHOW       SPAWN      TRIGGER
  UPDATE     Usage_Summary

Topic?
 </nowiki>
|-
| LIST DEVICE
| Displays information in the LAN permanent device database. (To display devices in the volatile device database, use the SHOW DEVICE command. Also see [[LANCP Permanent Device Database]] for qualifiers that can be used with the LIST DEVICE command).
| 
 <nowiki>
LANCP> LIST DEVICE/MOPDLL
Device Listing, permanent database:
--- MOP Downline Load Service Characteristics ---
Device State Access Mode Clients Data Size
------ ----- ----------- ------- ---------
EXA0 Enabled Exclusive KnownClientsOnly 1400 bytes
FXA0 Disabled NoExclusive NoKnownClientsOnly 246 bytes
 </nowiki>
|-
| LIST NODE
| Displays information in the LAN permanent node database.
|
 <nowiki>
LANCP> LIST NODE
Node Listing:
GALAXY (08-00-2B-2C-51-28):
MOP DLL: Load file: APB.EXE
Load root: $64$DIA24:<SYS11.>
Boot type: Alpha satellite
ZAPNOT (08-00-2B-18-7E-33):
MOP DLL: Load file: NISCS_LOAD.EXE
Load root: LAVC$SYSDEVICE:<SYS10.>
Boot type: VAX satellite
CALPAL (08-00-2B-08-9F-4C):
MOP DLL: Load file: READ_ADDR.SYS
Last file: LAN$DLL:APB_X5WN.SYS
Boot type: Other
2 loads requested, 1 volunteered
1 succeeded, 0 failed
Last request was for a system image, in MOP V4 format
Last load initiated 10-JUN-1998 09:11:17 on EXA0 for 00:00:06.65
527665 bytes, 4161 packets, 0 transmit failures
Unnamed (00-00-00-00-00-00):
Totals:
Requests received 2
Requests volunteered 1
Successful loads 1
Failed loads 0
Packets sent 2080
Packets received 2081
Bytes sent 523481
Bytes received 4184
Last load CALPAL at 10-JUN-1998 09:11:17.29
 </nowiki>
|-
| PURGE DEVICE
| Deletes a device from the LAN permanent device database.
|
 <nowiki>
LANCP> PURGE DEVICE/ALL
 </nowiki>
This command deletes all devices from the LAN permanent device database.
|-
| PURGE NODE
| Deletes a node from the LAN permanent node database.
|  
 <nowiki>
LANCP> PURGE NODE/ALL
 </nowiki>
This command deletes all nodes from the LAN permanent node database.
|-
| SET ACP
| Modifies the operation of the LANACP LAN server process.
|
 <nowiki>
LANCP> SET ACP/ECHO/FULL
 </nowiki>
This command enables tracing of received and transmitted downline load messages. The /FULL qualifier displays the entire contents of received and transmitted downline load messages.
|-
| SET DEVICE (volatile device database)
| Enters a device into the LAN volatile device database or modifies an existing entry. For accessing the LAN permanent device database, use DEFINE DEVICE. See [[LANCP Volatile Device Database]] for the qualifiers to SET DEVICE.
| 
|-
| 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.
| 
 <nowiki>
LANCP> show config

SMAN43 LAN Configuration (13-MAR-2019 08:51:29.73):
         Parent or
  Device  PrefCPU  Medium/User Version  Link  Speed  Duplex Auto BufSize   MAC Address          Type      Description
  ------  -------  ----------- -------  ----  -----  ------ ---- ------- ----------------   ------------  -----------
   EWA0      0      Ethernet   (nopriv)  Up    1000   Full   Yes   1500  00-22-64-94-BC-6F  UTP BCM5704
   EWB0      1      Ethernet   (nopriv)  Up    1000   Full   Yes   1500  00-22-64-94-BC-6E  UTP BCM5704

 </nowiki>
|-
| SHOW DEVICE
| Displays information in the LAN volatile device database. If no qualifiers are specified, the utility displays all matching devices without additional information. See [[LANCP Volatile Device Database]] for qualifiers that can be used with the SHOW DEVICE command.
|
 <nowiki>
LANCP> show dev ewa0

SMAN43 Device Listing, volatile database (13-MAR-2019 09:03:18.11):
  Device
  ------
  EWA0

 </nowiki>
|-
| SHOW DLL (Alpha only)
| Displays the current state of MOP downline load services.
|-
| SHOW LOG
| Displays recent downline load activity.
| 
 <nowiki>
LANCP> show log

SMAN43 SYS$MANAGER:LAN$ACP.LOG latest contents (13-MAR-2019 09:36:46.97):
 6-MAR-2019 14:10:29.35  Defined LAN$DLL to be SYS$SYSROOT:[MOM$SYSTEM]
 6-MAR-2019 14:10:29.43  Found LAN device EWA0, hardware address 00-22-64-94-BC-6F
 6-MAR-2019 14:10:29.45  Found LAN device EWB0, hardware address 00-22-64-94-BC-6E
 6-MAR-2019 14:10:29.49  %EWA0, Auto-negotiation mode assumed set by console
 6-MAR-2019 14:10:29.49  %EWA0, Merl5704 located in 64-bit, 66-mhz PCI-X slot
 6-MAR-2019 14:10:29.50  %EWA0, Device type is BCM5704C (UTP) Rev B0 (21000000)
 6-MAR-2019 14:10:29.50  %EWB0, Auto-negotiation mode assumed set by console
 6-MAR-2019 14:10:29.51  %EWB0, Merl5704 located in 64-bit, 66-mhz PCI-X slot
 6-MAR-2019 14:10:29.53  %EWB0, Device type is BCM5704C (UTP) Rev B0 (21000000)
 6-MAR-2019 14:10:29.54  %EWA0, Link up: 1000 mbit, full duplex, flow control (txrx)
 6-MAR-2019 14:10:29.54  %EWB0, Link up: 1000 mbit, full duplex, flow control (txrx)
 6-MAR-2019 14:10:29.55  Node database file, LAN$NODE_DATABASE, not found
 6-MAR-2019 14:10:29.65  LANACP initialization complete
 </nowiki>
|-
| SHOW MOPDLL
| Displays the current state of MOP downline load services.
|
|-
| 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 (Alpha only)
| Updates firmware image for a device.
| 
|}


=See also=
* {{Template:UtilitiesI}}