OpenVMS System Manager's Manual

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 Parameters

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.

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

Table 22-8 SHOW DEVICE Command Qualifiers
Qualifier Description

/ALL++ Shows all devices which match device name.

/CHARACTERISTICS++ Same as the /PARAMETERS qualifier.

/DLL++ Same as the /MOPDLL qualifier. They show downline load characteristics.

/COUNTERS Displays device counters.

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

/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 22-8 SHOW DEVICE Command Qualifiers**
Qualifier	Description
/ALL++	Shows all devices which match device name.
/CHARACTERISTICS++	Same as the /PARAMETERS qualifier.
/DLL++	Same as the /MOPDLL qualifier. They show downline load characteristics.
/COUNTERS	Displays device counters.
/MAP	Displays the current configuration of the functional address mapping table.
/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.

22.5.3 Setting Device Parameters

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 directly to the specified device (without interaction with the LANACP server process).

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 SET DEVICE (Parameters) 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_addr=a.b.c.d,
parent=devnam,
name="ip subnet name",
enable, disable
type = client|server)

The meanings for the syntax of keywords and sub-keywords for /CLIP are as follows:

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.
ip_address=
Specifies the IP address of the CLIP client.
subnet_mask=
Specifies the subnet mask of the CLIP client.
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 and client. Allows only one node for each LIS when specified.

/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++ Same as /MOPDLL qualifier. They set downline load characteristics.

/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,]...[Enable=startup,]
...[Disable=startup,]...
[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, 9234, or 18,190 bytes. 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++ Reads the permanent database and creates device entries in the volatile database.

/RING_PURGER++ Enables ring purging on Token Ring devices.

/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 token rotation time.

/TOKEN_TIMEOUT++ Sets the token ring timeout.

/TRANSMIT_TIMEOUT++ Sets the timeout on the Token Ring adapter.

/UPDATE++ Sets volatile device parameter according to permanent device database parameters.

++Alpha only

Examples

```
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.
```
LANCP> SET DEVICE/MEDIA=TWIST EWB0
```
This command sets the media type to twisted pair for the second Tulip Ethernet device.
```
LANCP> SET DEVICE/ALL/MIN_BUFFERS=12
```
This command sets the number of receive buffers for all LAN devices to be no less than 12.

22.5.4 Updating Device Firmware

LAN devices contain firmware images in EEPROM or FLASH ROM that you can update using the LANCP utility. You can update devices such as the DEMNA, DEMFA, DEFAA, DEFTA, DEFEA, and DEFPA.

Note
You can also use methods other than the LANCP utility to update firmware. For example, you can use the LFU utility on DEC 7000 and DEC 10000 systems to update DEMNA and DEMFA devices.

On Alpha systems to update the firmware on a device, enter the UPDATE DEVICE command using the following syntax:

UPDATE DEVICE device-name [/qualifiers]

Table 22-10 provides a brief description of the UPDATE DEVICE command qualifiers.

Table 22-10 UPDATE DEVICE Command Qualifiers
Qualifier Description

/FILE= filename Provides the file specification of the file to be loaded into the device.

/RESET Specifies whether the device will begin using the new image when the firmware update completes.

**Table 22-10 UPDATE DEVICE Command Qualifiers**
Qualifier	Description
/FILE= filename	Provides the file specification of the file to be loaded into the device.
/RESET	Specifies whether the device will begin using the new image when the firmware update completes.

Example

LANCP> UPDATE DEVICE FAA0/FILE=DKA0:[FW]FBUS_MAIN.SYS

This command updates FDDI device FAA0 with the firmware image FBUS_MAIN.SYS located on DKA0:[FW]. The device begins using the new image after the firmware update has completed and a device reset has been done.

22.6 Managing the LAN Device Databases

The LAN volatile and 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, as follows:

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.

The following sections describe how to enter and remove devices from the LAN permanent and volatile device databases, and how to enable and disable MOP downline load services.

22.6.1 Displaying Devices in the LAN Device Databases

To display information in the LAN permanent device database, enter the LIST DEVICE command using the following syntax:

LIST DEVICE device-name [/qualifiers]

To display information in the LAN volatile device database, enter the SHOW DEVICE command using the following syntax:

SHOW DEVICE device-name [/qualifiers]

Table 22-11 provides a brief description of the LIST DEVICE and SHOW DEVICE qualifiers.

Table 22-11 LIST DEVICE and SHOW DEVICE Command Qualifiers
Qualifier Description

/ALL++ Lists, or shows all devices which match device names.

/CHARACTERISTICS++ Same as the /PARAMETER qualifier.

/COUNTERS+ Displays device counters.

/DLL++ Same as the /MOPDLL qualifier. Lists or shows downline load characteristics.

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

/MOPDLL Displays MOP downline load information.

/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 22-11 LIST DEVICE and SHOW DEVICE Command Qualifiers**
Qualifier	Description
/ALL++	Lists, or shows all devices which match device names.
/CHARACTERISTICS++	Same as the /PARAMETER qualifier.
/COUNTERS+	Displays device counters.
/DLL++	Same as the /MOPDLL qualifier. Lists or shows downline load characteristics.
/MAP	Displays the current configuration of the functional address mapping table.
/MOPDLL	Displays MOP downline load information.
/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.

+SHOW DEVICE only
++Alpha only

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

22.6.2 Entering Devices into the LAN Device Databases

To enter a device into the LAN permanent device database or to modify an existing entry, enter the DEFINE DEVICE command using the following syntax:

DEFINE DEVICE device-name [/qualifiers]

To enter a device into the LAN volatile device database or to modify an existing entry, enter the SET DEVICE command using the following syntax:

SET DEVICE device-name [/qualifiers]

Table 22-12 provides a brief description of the DEFINE DEVICE and SET DEVICE command qualifiers.

Note
Defaults apply to creation of an entry in the device database. If an existing entry is being modified, fields not specified are not changed.

Table 22-12 DEFINE DEVICE and SET DEVICE Command Qualifiers
Qualifier Description

/ALL Defines data for all LAN devices in the LAN permanent or volatile device database.

/ATMADDRESS=LES++ On Alpha systems, defines or sets the LAN emulation server (LES) address for ATM, or LIS address for 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:
DEFINE DEVICE/ATMADDRESS = ([NO]LES=the ATM server)
SET DEVICE/ATMADDRESS = ([NO]LES=the ATM server)

/ATMADDRESS=ARP++ On Alpha systems, defines or sets the LAN address resolution protocol (ARP) server address for ATM. This qualifier is required before a logical IP subnet (LIS) is enabled if the local host is not the AFP server. The /ATMADDRESS=ARP qualifier's syntax is as follows:
DEFINE DEVICE/ATMADDRESS = (ARP=atm_arp_server)
SET DEVICE/ATMADDRESS = (ARP=atm_arp_server)

/CLIP++ On Alpha systems, the CLIP qualifier defines 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 (802.3) frames over the ATM network. The /CLIP = ENABLE command causes 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:
DEFINE DEVICE/CLIP =(ip_subnet=a.b.c.d,
ip_addr=a.b.c.d,
parent=devnam,
name="ip subnet name",
enable, disable
type = client|server)

The meanings for the syntax of keywords and sub-keywords for /CLIP are as follows:

Enable
Causes a client to join the logical IP subnet.
Disable
Causes a client to leave the logical IP subnet.
ip_address=
Specifies the IP address of the CLIP client.
subnet_mask=
Specifies the subnet mask of the CLIP client.
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 and client. Allows only one node for each LIS when specified.

/DLL++ Same as the /MOPDLL qualifier.

/ELAN++
(DEFINE command only) 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:
DEFINE DEVICE/ELAN =([parent=parent device,]..
[name="ELAN NAME to join",]...
[size=1516]...[type=CSMACD]...[Enable,]
...[Disable,]...[Enable=startup,]
...[Disable=startup,]...
[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, 9234, or 18,190 bytes. 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

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.

/MOPDLL=( 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.

/PERMANENT_DATABASE (SET command only) Updates the device entries in the LAN volatile device database with any data currently set in the permanent database.

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

++Alpha only

Examples

```
LANCP> DEFINE DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE)
```
This command defines LAN device EXA0 to enable LANACP MOP downline load service in exclusive mode. The settings 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 will be set to the defaults.
```
LANCP> DEFINE DEVICE/ALL/MOPDLL=NOEXCLUSIVE
```
This command sets all LAN devices defined in the LAN permanent device database to nonexclusive mode for LANACP MOP downline load service.
```
LANCP> SET DEVICE EXA0/MOPDLL=(ENABLE,NOEXCLUSIVE)
LANCP> SET DEVICE FXA0/MOPDLL=(ENABLE,EXCL,KNOWN)
```
These commands enable LANACP MOP downline load service for:
- LAN device EXA0 in nonexclusive mode
- LAN device FXA0 in exclusive mode for only known clients
22.6.3 Deleting Devices from the LAN Device Databases

To delete a device from the LAN permanent device database, enter the PURGE DEVICE command using the following syntax:
```
PURGE DEVICE device-name [/ALL] 
```
Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
```
  6017P067.HTM
  OSSG Documentation
  22-NOV-1996 14:22:55.57
```
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal

OpenVMS System Manager's Manual

22.5.2 Displaying Device Parameters

22.5.3 Setting Device Parameters

22.5.4 Updating Device Firmware

22.6 Managing the LAN Device Databases

22.6.1 Displaying Devices in the LAN Device Databases

22.6.2 Entering Devices into the LAN Device Databases

22.6.3 Deleting Devices from the LAN Device Databases