LANCP Volatile Device Database

From VSI OpenVMS Wiki
Jump to: navigation, search

The volatile device database is a database that contains information about LAN devices that exist on the system. The database contains a single entry for each LAN device that exists on the system; each entry contains device information and MOP downline load counters information.

The LANCP volatile device database is populated with information from the permanent device database when the LANACP LAN server process is started. Therefore modifications to the volatile database are only valid until the LAN server process is restarted. To make sure the modifications survive a restart of the server, modify the permanent device database.

Viewing the Database

To view the volatile device database, use the LANCP SHOW DEVICE command. (To view the permanent database, use the LANCP LIST DEVICE command; these commands share the same qualifiers).

Command Function Example
SHOW DEVICE/CHARACTERISTICS Displays status and related information about the device
Show

Example of LANCP SHOW DEVICE/CHARACTERISTICS

SHOW DEVICE/COUNTERS Displays device counters.
Show

Example of LANCP SHOW DEVICE/COUNTERS

SHOW DEVICE/CLEAR_COUNTERS Clears device counters and internal driver counters after a SHOW DEVICE/COUNTERS or SHOW DEVICE/INTERNAL_COUNTERS command. Subsequent SHOW commands show the counter values accumulated since the clear was done. This affects counters displayed by LANCP only.
SHOW DEVICE/RESTORE_COUNTERS Restores device counters and internal driver counters prior to a SHOW DEVICE/COUNTERS or SHOW DEVICE/INTERNAL_COUNTERS command.
SHOW DEVICE/DLL or SHOW DEVICE/MOPDLL Displays LAN volatile device database information related to MOP downline load for the device.
Show

Example of LANCP SHOW DEVICE/DLL

SHOW DEVICE/INTERNAL_COUNTERS Displays internal counters. By default, it does not display zero counters. To see all counters, including zero, use the addition qualifier /ZERO. To see the debug counters, use the additional qualifier /DEBUG.
Show

Example of LANCP SHOW DEVICE/INTERNAL_COUNTERS

SHOW DEVICE/MESSAGES Displays the console messages displayed by the LAN driver as part of the LAN driver internal counters. This qualifier is included for convenience, to avoid scanning the internal counters to get to the message data.
Show

Example of LANCP SHOW DEVICE/MESSAGES

SHOW DEVICE/REVISION Displays the current LAN driver and device revision information if available or applicable. Not all LAN drivers maintain revision information.
Show

Example of LANCP SHOW DEVICE/REVISION

SHOW DEVICE/TRACE Displays LAN driver trace data.
Show

Example of LANCP SHOW DEVICE/TRACE

SHOW DEVICE/VLAN Displays a list of IEEE 802.1Q tags that are configured on the switch port connected to the specified physical LAN device. LANCP listens for the GVRP packets that contain the configuration information and displays the configured tags. The switch periodically sends GVRP (GARP VLAN Registration Protocol) (GARP = Generic Attribute Registration Protocol) packets to provide VLAN configuration information in compliance with the IEEE 802.1Q specification. If GVRP is not configured on the switch, or if the LAN device is not connected to a switch, this command displays only the list of tags that the VLAN drive has configured.
Show

Example of LANCP SHOW DEVICE/VLAN

Changing the Database

To add a device to the volatile device database or modify an entry for a device there, use the SET DEVICE command (for the permanent database, use the DEFINE DEVICE command; these commands share the same qualifiers).

Command Function Example
General
SET DEVICE/ALL Sets data for all LAN devices. If you specify a device name, all matching LAN devices are selected.
SET DEVICE/DEVICE_SPECIFIC=(FUNCTION="xxxx",VALUE=(n1,n2,n3...n16))

/NODEVICE_SPECIFIC

Allows some device-specific parameters to be adjusted. These are useful for debug purposes or for experiments while doing performance measurements. Like other LANCP commands which affect devices, this command requires SYSPRV privilege. Specify the negated qualifer to clear all device-specific parameter data. These functions are described in a text file on the system, SYS$HELP:LAN_COUNTERS_AND_FUNCTIONS.TXT.
SET DEVICE/DLL or SET DEVICE/MOPDLL=(enable-option, exclusive-option, size-option, knownclientsonly-option)
Show

/DLL and /MOPDLL values

Provides the MOP downline load service settings for the device. Note that defaults apply to creation of an entry in the device database. If an existing entry is being modified, fields not specified remain unchanged.
SET DEVICE/MAX_BUFFERS=value Sets the maximum number of receive buffers to be allocated and used by the LAN driver for the LAN device.
SET DEVICE/MIN_BUFFERS=value Sets the minimum number of receive buffers to be allocated and used by the LAN driver for the LAN device.
SET DEVICE/PERMANENT Updates the device entries in the LAN volatile device database with any data currently set in the permanent database. This allows you to update the volatile database after changing data in the permanent database, rather than repeating the commands for each updated entry to apply the changes to the volatile database.
SET DEVICE/TAG=value Specifies the IEEE 802.1Q tag for the VLAN device. value is the IEEE 802.IQ tag number.
SET DEVICE/TRACE=size-option,mask-option,stop-option

/NOTRACE

Show

/TRACE values

Provides the LAN driver trace settings for the device. By default, most LAN drivers do tracing of error conditions and state changes. Tracing is controlled by an event mask that selects the events to trace, a stop mask that specifies when to stop tracing, and the size of the trace buffer.

You can change tracing settings at any time. The LAN driver allocates the trace buffer from non-paged pool. You can calculate the amount of pool needed by multiplying the number of entries by the size of each entry, 32-bytes. The impact of tracing on the system is negligible for error and state change events, more significant when all events are selected, and very significant when full packet tracing is enabled. The command SHOW DEVICE/TRACE displays trace results as well as the trace mask.

SET DEVICE/UPDATE Adds LAN devices that are not currently in the LAN volatile device database to that database. The initial entry for the device uses default values for all parameters. To update the volatile database with current information from the permanent database, use the SET DEVICE command with the /PERMANENT

qualifier. You can combine the /UPDATE and /PERMANENT qualifiers in a single SET DEVICE command.

SET DEVICE/VLAN_DEVICE

/NOVLAN_DEVICE

Specifies the physical LAN device that is to host the VLAN device. The /NOVLAN_DEVICE qualifier requests deactivation of the VLAN device. When deactivating the VLAN device, the device-name is not required because the VLAN driver knows which device is hosting the VLAN device. Note that a VLAN device cannot be deactivated if any applications continue to use the device.
Ethernet Devices
SET DEVICE/AUTONEGOTIATE (default)

/NOAUTONEGOTIATE

Enables or disables the use of auto-negotiation to determine the link settings. You may need to disable link auto-negotiation when connected to a switch or device that does support auto negotiation.
SET DEVICE/FLOW_CONTROL (default)

/NOFLOW_CONTROL

Enables flow control on a LAN device.
SET DEVICE/FULL_DUPLEX (default)

/NOFULL_DUPLEX

Enables full-duplex operation of a LAN device. Before full-duplex operation results from the use of this qualifier, additional device or network hardware setup may be required. Some devices may be enabled for full-duplex operation by default. Some devices may not allow the setting to be changed.

The /NOFULL_DUPLEX qualifier disables full-duplex operation.

SET DEVICE/JUMBO (default)

/NOJUMBO

Enables the use of jumbo frames on a LAN device. Only Gigabit Ethernet NICs support jumbo frames.
SET DEVICE/MEDIA=value

Acceptable values are AUI (10Base2, 10Base5), TWISTEDPAIR (10BaseT), and AUTOSENSE (reperform the limited autosense algorithm). The default value is AUTOSENSE.

Selects the cable connection. Normally, the selection is made during device initialization using a limited autosensing algorithm that selects twisted pair, but fails over to AUI (Attachment Unit Interface) if twisted pair does not appear to be functional. Thereafter, a cabling change would require a reboot of the system to take effect. This command allows you to change the selection without rebooting.

Some devices, such as the DE435, require a jumper change on the Ethernet card to switch between 10Base2 and 10Base5 (thinwire and thickwire). Other devices, such as the DE434, DE436, and DE500, have only twisted pair connections.

SET DEVICE/SPEED=value

Valid values are 10, 100, 1000, 10000, or autonegotiate; the last choice, autonegotiate, selects the 10 Mb/s for Ethernet, 100 Mb/s for Fast Ethernet, 1000 Mb/s for Gigabit Ethernet, and 10000 Mb/s for 10-Gigabit Ethernet. If you select autonegotiate, the LAN driver repeats autonegotiation.

Sets the speed of the LAN.
LAN Failover Devices
SET DEVICE/DISABLE Disables the devices in a LAN Failover set. When disabled, LAN devices can be added to or deleted from the Failover set.
SET DEVICE/ENABLE Enables a Failover set, which activates the Logical LAN device. The LAN Failover driver selects a LAN device from the LAN Failover set as the active device and then allows I/O to the Logical LAN device.
SET DEVICE//FAILOVER_SET=(device-name[,...])

/[NO]FAILOVER_SET=(device-name[,...])

Specifies the members of a LAN Failover set.
SET DEVICE/PRIORITY=value Sets the failover priority of a LAN device. Priority is given to the LAN failover device with the highest priority when choosing the active LAN device. When a LAN device with a higher priority becomes available, a failover transition to the newly available device is performed. This allows a system manager to set a preferred device by setting one LAN device to a higher priority than others. The LAN failover driver uses the preferred device when it is available.
JUMBO)

STANDARD is the Ethernet maximum packet size of 1519 bytes. JUMBO is the oversize packet size available with the Gigabit Ethernet devices. It is allowed only if all the LAN devices in the LAN failover set are Gigabit devices.

Sets the packet size of the LAN failover device. Note that the size specified for the LAN failover device overrides the size set on

the members of the LAN failover set; that is, the JUMBO frame setting of a LAN device is of no consequence when the size is determined for the LAN failover device.

SET DEVICE/SWITCH Forces a LAN failover to another member of the LAN failover set. You can test LAN failover operation by using this command to switch from one device to another.
FDDI Devices
SET DEVICE/RING_PURGER Enables the ring purger process of the FDDI device.
SET DEVICE/TOKEN_ROTATOR Sets the requested token rotation time for the FDDI ring.
SET DEVICE/TOKEN_TIMEOUT Sets the restricted token timeout time for the FDDI ring.
SET DEVICE/TRANSMIT_TIMEOUT Sets the valid transmission time for the FDDI device.
Token Ring Devices
SET DEVICE/AGING_TIMER=value Sets the amount of time in seconds to age Token Ring source routing cache entries before marking them stale. This timer expires when no traffic is sent to or received from the remote node in this amount of time. The default value is 60 seconds.

Increase this value when idle connections bounce between the stale and known states. Setting this value too low may cause unnecessary explorer traffic to traverse the LAN.

SET DEVICE/CACHE_ENTRIES Sets the number of entries to reserve for caching Token Ring source routing address entries. The default value is 200 entries. If your system directly communicates to a large number of systems, you may want to increase this number.
SET DEVICE/CONTENDER

/NOCONTENDER (default)

Specifies that the Token Ring device is to participate in the Monitor Contention process when it joins the ring. The /NOCONTENDER qualifier, directs the device not to challenge the current ring server.
SET DEVICE/DISCOVERY_TIMER=value Sets the number of seconds to wait for a reply from a remote node when performing the source Token Ring routing route discovery process. The default value is 2 seconds.

If you have nodes that respond slowly on your extended LAN, you may need to increase this number to reduce the amount of explorer traffic that traverses your LAN.

SET DEVICE/EARLY (default)

/NOEARLY

Enables Early Token Release on the device. The /NOEARLY qualifier, disables Early Token Release.
SET DEVICE/MAP=(MULTICAST_ADDRESS=address, FUNCTIONAL_ADDRESS=address)

/NOMAP=(MULTICAST_ADDRESS=address)

Maps a standard multicast address to a functional address. Token ring devices do not support IEEE 802 standard globally defined group addresses. They do support functional addresses. A functional address is a locally administered group address that has 31 possible values. Each functional address sets one bit in the third through sixth byte of the address and bytes 1 and 2 are 03-00 (C0:00

in bit reversed format). The /NOMAP=(MULTICAST_ADDRESS=address) qualifier, clears the mapping established for the specified address.

SET DEVICE/MEDIA=value Selects the type of cable media used to connect the adapter to the Token Ring Media Access Unit (MAU) for devices that do not automatically detect this. Acceptable values for this are either unshielded twisted pair (UTP) or shielded twisted pair (STP). The default value is STP.
SET DEVICE/SOURCE_ROUTING (default) /NOSOURCE_ROUTING Enables source routing on the Token Ring device. If you only have one ring in your LAN or you use transparent bridging, use the /NOSOURCE_ROUTING qualifier to turn off source routing.
SET DEVICE/SPEED=value Sets the speed of the Token Ring LAN. Valid values are either 4 or 16, indicating 4 megabits per second or 16 megabits per second. The default value for Token Ring is 16, unless the LAN adapter supports a nonvolatile mechanism for setting this parameter.
SET DEVICE/SR_ENTRY=(LAN_ADDRESS=address, RI=routing-information)

/NOSR_ENTRY=(LAN_ADDRESS=address)

Statically defines a specific source-routed route for a specific node. The default value is no routes specified. This caching remains valid while used or until the aging timer expires.

Use this qualifier only as a last resort when isolating communication failures on extended LAN topologies. The /NOSR_ENTRY=(LAN_ADDRESS=address) qualifier, clears the previously defined static source routed route. The address is a standard 6-byte LAN address (given as hexadecimal byte characters separated by hyphens), which specifies the canonical form of the address. Using a colon as the separator character indicates the bit-reversed form of the address. The routing-information is the source routing field, specified as a series of two-byte hexadecimal characters (each byte separated by a hyphen). The field consists of a two-byte routing control field followed by up to 14 two-byte segment identifiers, each containing the ring number and the bridge number used in the hop. See Default Functional Address Mapping for Token Ring Devices.

ATM Devices
SET DEVICE/ATMADDRESS=LES=([NO]LES=the ATM server) 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.
SET DEVICE/ARP=(ARP=atm_arp_server) Sets the address resolution protocol (ARP) server address for Classical IP over ATM. This qualifier is required before a LIS is enabled if the local host is not the ARP server.
SET DEVICE/CLIP Sets the Classical Internet Protocol (CLIP) over ATM (RFC1577). The CLIP qualifier implements a data-link level device as a client and/or a server in a logical IP subnet (LIS). This allows the IP protocol to transmit Ethernet frames over the ATM network. The /CLIP = ENABLE command causes the system to join the LIS. 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. There can only be one client for each ATM adapter. The syntax is as follows: 
SET DEVICE/CLIP =(ip_subnet=a.b.c.d,             ! IP address of the CLIP client
                  ip_address=a.b.c.d,            ! the subnet mask of the CLIP client
                  parent=devnam,                 ! the parent device name
                  name="ip subnet name",         ! name for the LIS tp aid in operations and 
                                                 ! diagnostics
                  enable, disable                ! joins or leaves the subnet
                  type = client|server)          ! starts up a classical IP server and client
SET DEVICE/ELAN The /ELAN qualifier has two values: enable and disable. With /ELAN=ENABLE along with the keyword STARTUP, the LAN emulation is loaded when LANACP starts. With /ELAN=DISABLE, the same parameters used with ENABLE can be invoked. 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,
                     description = "string")
SET DEVICE/PVC Sets the permanent virtual circuit (PVC) to be used by a Classical IP over ATM client. This is an optional qualifier. The list of PVCs is defined for use by CLIP clients. This command should be used before enabling the CLIP client. The PVC has to be set up manually in the ATM switch. 
LANCP> SET DEVICE/CONTENDER/MEDIA=UTP/NOEARLY/SOURCE ICA0

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

LANCP> SET DEVICE/MEDIA=TWI EWB0

Sets the media type to twisted pair for the second Tulip Ethernet device, EWB0. 

LANCP> SET DEVICE EXA0/MOPDLL=ENABLE

Enables MOP downline load service for device EXA0, leaving the remaining MOPDLL parameters unchanged. 

LANCP> SET DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE,SIZE=1482)

Enables MOP downline load service for device EXA0, in exclusive mode with the data transfer size of 1482 bytes, leaving the remaining MOPDLL parameters unchanged. 

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 FXB0 in exclusive mode for only known clients
Retrieved from "https://wiki.vmssoftware.com/index.php?title=LANCP_Volatile_Device_Database&oldid=362"