Document revision date: 19 July 1999

Table 22-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.
UPDATE DEVICE++	Updates firmware image for a device.

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

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

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

Table 22-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++	ATMWORKS 350, ATMWORKS 351, ATMWORKS 750	The ATMWORKS 350 and 351 support PCI-based systems. The ATMWORKS 750 supports TURBOchannel systems.

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.

22.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 22-8 provides a brief description of the SHOW DEVICE command qualifiers.

Table 22-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.

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.

All LAN devices are characterized by a collection of parameters. The parameters define the operational characteristics of a LAN device on the medium to which the device is connected.

To set LAN device parameters directly, enter the SET DEVICE command at the LANCP> prompt. The LANCP utility issues this command to the LANACP server process, which then issues the appropriate QIOs to set the driver characteristics.

The syntax for the SET DEVICE command is:

SET DEVICE device-name [/qualifiers]

Table 22-9 provides a brief description of the SET DEVICE command qualifiers that apply directly to LAN devices.

Table 22-9 DEFINE DEVICE and SET DEVICE Command Qualifiers

Qualifier	Description
/AGING_TIMER= value	Sets the amount of time in seconds to age source routing cache entries before marking them stale.
/ALL	Sets data for all LAN devices.
/ATMADDRESS=LES++	On Alpha systems, sets the LAN emulation server (LES) address for asynchronous transfer mode (ATM). Usually the address is not user specified, and this qualifier is used only if you want a specific address. By default the address is determined by software from the configuration server for the LES. The /ATMADDRESS=LES qualifier's syntax is as follows: SET DEVICE/ATMADDRESS = ([NO]LES=the ATM server)
/ATMADDRESS=ARP++	On Alpha systems, sets the address resolution protocol (ARP) server address for ATM. This qualifier is required before a LIS is enabled if the local host is not the ARP server. The /ATMADDRESS=ARP qualifier's syntax is as follows: SET DEVICE/ATMADDRESS = (ARP=atm_arp_server)
/CACHE_ENTRIES= value	Sets the number of entries to reserve for caching source routing address entries.
/CLIP++	On Alpha systems, the Classical Internet Protocol (CLIP) qualifier sets a device with the TCP/IP protocol that enables it to see a network as being configured as one or more logical IP subnets (LIS), which allows it to transmit Ethernet frames over the ATM network. The /CLIP = ENABLE command causes the the system to join the LIS when LANCP initializes. The /CLIP = DISABLE command causes the client to leave the logical IP subnet. Note that a LIS requires a server, and there must be only one server for each subnet. Communication between subnets can only be performed by a router. Also, there can only be one client for each ATM adapter. The /CLIP qualifier's syntax with standard Internet dotted notation is as follows: SET DEVICE/CLIP =(ip_subnet=a.b.c.d, ip_address=a.b.c.d, parent=device, name="ip subnet name", enable, disable type = client|server) The meanings of the syntax for /CLIP are as follows: ip_address Specifies the IP address of the CLIP client. subnet_mask Specifies the subnet mask of the CLIP client. parent Parent device name. name Specifies a name for the LIS to aid in operations and diagnostics. type=client Starts up a classical IP only. This is the default. type=server Starts up a classical IP server. Only one server for each LIS is allowed, and the server needs to be started first. type=(server,client) Starts up a classical IP server and client. Keywords and their meanings for /CLIP are as follows: Keyword Meaning Create Loads the classical IP driver but does not start it. Enable Causes the node to join the logical IP subnet. Disable Causes the node to leave the logical IP subnet.
/CONTENDER	Specifies that the device is to participate in the monitor contention process when it joins the ring.
/DISCOVERY_TIMER= value	Sets the number of seconds to wait for a reply from a remote node when performing the source routing route discovery process.
/DLL=( enable-option, exclusive-option, size-option, knownclientsonly-option)	Provides the MOP downline load service settings for the device. In this qualifier, you can specify: enable-option Indicates that MOP downline load service should be enabled or disabled for the device. exclusive-option Indicates that no other provider of MOP downline load service is allowed on the specified LAN device at the same time as LANACP. knownclientsonly-option Indicates that MOP downline load requests should be serviced only for clients defined in the LAN volatile node database. size-option Specifies the size in bytes of the file data portion of each downline load message.
/EARLY	Enables Early Token Release on the device.
/ELAN++	On Alpha systems, sets LAN emulation. The /ELAN qualifier has two values: enable and disable. With /ELAN=ENABLE with the keyword STARTUP, the LAN emulation is loaded when LANCP starts. With /ELAN=DISABLE, the same parameters as ENABLE can be used. The /ELAN qualifier's syntax is as follows: SET DEVICE/ELAN =(parent=parent device, name="ELAN NAME to join", size=1516 type=CSMACD Enable, Disable, description = "description string,") The meaning of the syntax for /ELAN are as follows: parent The ATM adapter device name. An example of the parent device for ATMWORKS 350 is: HC n0, where n is the controller number. An example of the parent device for ATMWORKS 750 is: HW n0, where n is the controller number. name Optionally specified if you want to join a specific ELAN. The default is null. size Maximum frame size of the LAN you want to join. Valid sizes are 1516, 4544, or 9234. The default is 1516. type Support currently only for CSMACD, which is the default. description A method of describing the ELAN for display purposes only. Keywords and their meanings for /ELAN are as follows: Keyword Meaning Create Loads the emulation driver SYS$ELDRIVER.EXE, but does not start it. Enable Begins a join on a specified emulated LAN. It also loads the driver, if not already loaded. Disable Causes a client to leave the emulated LAN.
/FULL_DUPLEX	Enables full-duplex operation of a LAN device.
/MAP=(MULTICAST_ADDRESS=address, FUNCTIONAL_ADDRESS=address)	Defines a functional address mapping entry.
/MAX_BUFFERS= value	Sets the maximum number of receive buffers to be allocated and used by the LAN driver for the LAN device.
/MEDIA= value	For Token Ring devices: Selects the type of cable that is being used to connect the adapter to the Token Ring Media Access Unit (MAU) for devices that do not automatically detect this. For Ethernet devices: Selects the cable connection.
/MIN_BUFFERS= value	Sets the minimum number of receive buffers to be allocated and used by the LAN driver for the LAN device.
/PERMANENT_DATABASE (SET command only)	Updates the device entries in the LAN volatile device database with any data currently set in the permanent database.
/PVC=(vci[,...])++	On Alpha systems, defines the permanent virtual channel (PVC). This is an optional qualifier. A list of PVCs is defined for use by CLIP clients. This command should be used before enabling the CLIP client. PVC has to be setup manually in the switch to be used. The vci is the VCI (Virtual Channel ID) of the PVC (Permanent Virtual Connection) to be used.
/NOPVC=(vci[,...])++	On Alpha systems, does not set the permanent virtual channel (PVC).
/RING_PURGER++	Enables the ring purging process of the FDDI device.
/SOURCE_ROUTING++	Enables source routing on the Token Ring device.
/SPEED= value	Sets the speed of the LAN, if multiple speeds are supported.
/SR_ENTRY=(LAN_ADDRESS= address, RI= routing-information)	Statically defines a specific source-routed route for a specific node.
/TOKEN_ROTATION++	Sets the requested token rotation time for the FDDI ring.
/TOKEN_TIMEOUT++	Sets the restricted token timeout time for the FDDI ring.
/TRANSMIT_TIMEOUT++	Sets the valid transmission time for the FDDI device.
/UPDATE	Adds LAN devices that are not currently in one of the LAN device databases to that database. The DEFINE DEVICE command applies to the permanent database; the SET DEVICE command applies to the volatile database.
/VOLATILE_DATABASE (DEFINE command only)	Updates the device entries in the LAN permanent device database with any data currently set in the volatile database.

Examples

1. LANCP>SET DEV CLA/CLIP=CREATE LANCP>SET DEV CLA/CLIP=(TYPE=CLIENT,PARENT=HWA) LANCP>SET DEV CLA/CLIP=(IP_ADDR_132.1.1.20,IP_SUB=255.255.255.0) LANCP>SET DEV CLA/PVC=100 LANCP>SET DEV CLA/CLIP=ENABLE

   
   A CLIP client is created using PVC 100. Note that the ATM ARP server is not necessary for a client with a PVC.

2. LANCP> SET DEVICE/CONTENDER/MEDIA=UTP/NOEARLY/SOURCE ICA0

   
   This command enables monitor contention, UTP cable media, and source routing, and disables early token release for Token Ring device ICA0.

3. ---

   Previous

   Next

   Contents

   Index

   	privacy and legal statement
   6017PRO_092.HTML