HP OpenVMS System Manager's Manual, Volume 2:...

Managing the Local Area Network (LAN) Software

Understanding the LANCP Utility

Managing the LAN Device Databases

Managing LAN Devices  

Table 7   LAN Devices

LAN	Description
Ethernet	Allow the selection of media type (type of cable connected) and the speed of connection (Ethernet, FastEthernet, or Gigabit Ethernet). Allow full-duplex operation (point-to-point operation between a similar device or between the device and a switch).
FDDI	Allow full-duplex operation. Allow selection of FDDI ring parameters.
Token Ring	Allow the setting of Token Ring parameters and the definition of source routing and functional address mapping.
All	Allow the setting of generic parameters such as the number of receive buffers.
ATM	Allow the setting of Emulated LAN (ELAN) parameters.

Displaying System Devices  

To display the LAN devices on the system, enter the SHOW CONFIGURATION command using the following syntax:SHOW CONFIGURATION

Example

LANCP>SHOW CONFIGURATION/USERS

LAN Configuration:
Device Parent Medium/User Version Speed  Duplex Size MAC Address         Current Address   Type          EWA0        CSMA/CD    X-37   1000  Full 1500 00-30-6E-F4-D0-E1 00-30-6E-F4-D0-E1 BCM5701
EIC0        CSMA/CD    X-43    100  Full 1500 00-50-8B-69-A5-E2 AA-00-04-00-CF-4C 82559
EIC2   60-03  DNA Routing                1498
EWB0        CSMA/CD    X-37    100  Full 1500 00-30-6E-F2-18-2D 00-30-6E-F2-18-2D BCM5703
EWC0        CSMA/CD    X-7   10000  Full 9000 00-0C-FC-00-02-7C 00-0C-FC-00-02-7C XFRAME
EWD0        CSMA/CD    X-37   1000  Full 1500 00-30-6E-4A-C5-B9 00-30-6E-4A-C5-B9 BCM5701

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]

SHOW DEVICE Command Qualifiers provides a brief description of the SHOW DEVICE command qualifiers.

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

Table 8   SHOW DEVICE Command Qualifiers

Qualifier	Description
/ALL	Shows all devices which match device name.
/CHARACTERISTICS or /PARAMETERS	Displays status and related information about the device.
/COUNTERS	Displays device counters.
/DLL or MOPDLL	Shows downline load characteristics.
/INTERNAL_COUNTERS	Displays internal counters. By default, it does not display zero counters. To see all counters, including zero, use the additional qualifer /ZERO. To see debug counters, use the additional qualifier /DEBUG.
/MAP	Displays the current configuration of the functional Token Ring address mapping table.
/MESSAGES	Displays console messages from the LAN driver as part of the LAN driver internal counters.
/OUTPUT=file-name	Directs output to the specified filename.
/REVISION	Displays current LAN driver and device revision information, if available or applicable.
/SR_ENTRY	Displays the contents of the current Token Ring source routing cache table.
/TRACE	Displays LAN driver trace data.

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 EWFO
Device Revisions EWF0: Value Component 02000041 Device hardware revision
08020110 00000004 Port driver revision
08020172 00000001 LAN common routines revision
This SHOW DEVICE command displays revision information for Ethernet device EWF0.

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.

Setting Device Characteristics  

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 device characteristics.

The syntax for the SET DEVICE command is: SET DEVICE device-name [/qualifiers]

The following sections provide descriptions of SET DEVICE command qualifiers that apply directly to general and particular LAN devices. The command qualfiers are divided into the following categories:

• General



• Ethernet devices



• LAN failover devices



• FDDI devices



• Token ring devices



• ATM devices

DEFINE DEVICE and SET DEVICE Command Qualifiers for Ethernet Devices 

The qualifiers in this section are ones that you can use with Ethernet devices.

• /[NO]AUTONEGOTIATE
  
  Enables or disables the use of auto-negotiation to determine the link settings. It might be necessasry to disable link auto-negotiation when connected to a switch or device that does support auto-negotiation.



• /[NO]FLOW_CONTROL
  
  Enables or disables flow control on a LAN device.



• /[NO]FULL_DUPLEX
  
  Enables or disables full -duplex operatoin of a LAN device. Before full-duplex operation results from the use of this qualifier, additional device or network hardware setup might be required. Some devices can be enabled for full-duplex operation. Other devices might not allow the setting to be changed. The /NOFULL_DUPLEX qualifer disables full-duplex operation.



• /[NO]JUMBO
  
  Enables the use of jumbo frames on a LAN device. Only Gigabit Ethernet NIDs support jumbo frames.



• /MEDIA=value
  
  Selects the cable connection. Normally, the selection is made during the device initializaion using a limited autosensing algorigthm that selects twisted pair, but fails over to Attachment Unit Interface (AUI) if twisted pair does not appear to be functional. Thereafter, a cabling change requires a reboot of the system to take effect. This command allows you to change the selection withour rebooting.
  
  Acceptable values are AUI (10Base2, 10Base5), TWISTEDPAIR (10BaseT), and AUTOSENSE (perform the limited autosense algorithm again). The default value is AUTOSENSE.
  
  Some devices, such as the DE435, requirea 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.



• /SPEED=value
  
  Sets the speed of the LAN. Valid values are 10, 100, 1000, or autonegotiate, which selects 10 megabits per second for Ethernet, 100 for fast ethernet, and 1000 for Gigabit ethernet. If you select autonegotiate, the LAN driver redoes auto-negotiate.

DEFINE DEVICE and SET DEVICE Command Qualifiers for LAN Failover Devices 

The qualifiers in this section are ones that you can use with LAN Failover devices. Except for /PRIORITY, the qualifiers apply to the Logical LAN device (LL), not the LAN device in the failover set.

• /DISABLE
  
  Disables a LAN Failover set. When disabled, LAN devices can be added to or deleted from the Failover set.



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



• [NO]/FAILOVER_SET=(device-name[,...])
  
  Specifies the members of a LAN Failover set to be added or removed.



• /PRIORITY=value
  
  Sets the Failover priority of a LAN device. Priority is given to the LAN Failover device with the highest priority when selecting the active LAN device.



• /SIZE=value
  
  Sets the packet size of the LAN failover device. Valid values are STANDARD (the default) or JUMBO:

  STANDARD is the Ethernet maximum packet size of 1518 bytes.

  JUMBO is the oversize packet size available with Gigabit Ethernet devices. JUMBO is allowed only if all the LAN devices in the LAN failover set are Gigabit Devices.

  
  
  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.



• /SWITCH (SET DEVICE only)
  
  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.
  

DEFINE DEVICE and SET DEVICE Command Qualifiers for FDDI Devices 

The qualifiers in this section are ones that you can use with FDDI devices.

• /RING_PURGER
  
  Enables the ring purger process of the FDDI device.
  



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

DEFINE DEVICE and SET DEVICE Command Qualifiers for Token Ring Devices 

The qualifiers in this section are ones that you can use with Token Ring devices.

• /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 knownstates. Setting this value too low might cause unnecessary explorer traffic to traverse the LAN.
  



• /CACHE_ENTRIES=value
  
  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 with a large number of systems, you might want to increase this number.
  



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



• /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 might need to increase this number to reduce the amount of explorer traffic that traverses your LAN.



• /EARLY (default)
  /NOEARLY
  
  Enables Early Token Release on the device. The /NOEARLY qualifier disables Early Token Release.
  



• /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 global 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 bitin 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. Specify the functional address as follows:
  

  The MULTICAST_ADDRESS argument requires a standard 6-byte multicast address.

  The FUNCTIONAL_ADDRESS argument requires only the last 4 bytes of the functional address. (The preceding 03-00 bytes are automatically prefixed.)

  The address variable, given as hexadecimal byte characters separated by hyphens, specifies the canonical form of the address. Use a colon as the separator character to indicate the bit-reversed form of the address. For example, to map the multicast address CB-00-01-02-03-04 to the functional address 03-00-00-80-00-00 on the Token Ring device IRA0, enter the following command: $SET DEVICE IRA0/MAP=(MULTI=CB-00-01-02-03-04,FUNCT=00:01:00:00)

  For the default address mapping, refer to the following table or enter the command SHOW DEVICE/MAP device-name.

  Table 9  Default Functional Addressing for Token Ring Devices

  Multicast Address	Functional Address	Description
  09-00-2B-02-01-0B	03-00-10-00-00-00	DNA Phase IV Prime Unknown Destination
  09-00-2B-00-00-07	03-00-20-00-00-00	PCSA NETBIOS Emulation
  09-00-2B-00-00-0F	03-00-40-00-00-00	LAT Service Advertisement
  09-00-2B-02-01-04	03-00-80-00-00-00	LAT Service Solicit
  09-00-2B-02-01-07	03-00-00-02-00-00	LAT Xwindown Service Solicit
  09-00-2B-04-00-00	03-00-00-04-00-00	LAST
  09-00-2B-02-01-00	03-00-00-00-08-00	DNA Name Service Advertisement
  09-00-2B-02-01-01	03-00-00-00-10-00	DNA Name Service Solicit
  09-00-2B-02-01-02	03-00-00-00-20-00	DNA Time Service
  03-00-00-00-00-01	03-00-00-00-00-01	NETBUI Emulation
  03-00-02-00-00-00	03-00-02-00-00-00	RIPL

  
  




• /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 are either unshielded twisted pair (UTP) or shielded twisted pair (STP).
  
  The default value is STP.
  



• /SOURCE_ROUTING (default)
  /NOSOURCE_ROUTING
  
  Enables source routing on the Token Ring device. If you have only one ring in your LAN or you use transparent bridging, use the /NOSOURCE_ROUTING qualifier to turn off source routing.
  



• /SPEED=value
  
  Sets the speed of the Token Ring LAN. Valid values are either 4 or 16, indicating 4 megabits per second or 16 megabit per second. The default value for Token Ring is16, unless the LAN adapter supports a nonvolatile mechanism for setting this parameter.
  



• /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 route specified. This caching remains valid while in use 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.

Qualifiers (ATM Devices) 

The qualifiers in this section are ones that you can use with ATM (Asychronous Transfer Mode) devices.

• /ATMADDRESS=LES
  
  Sets the LAN emulation server (LES) address for ATM. The address is usually 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 syntax of the /ATMADDRESS=LES qualifier is as follows:SET DEVICE.ATMADDRESS=([NO]LES=the ATM server)



• /ATMADDRESS=ARP
  
  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.
  
  The syntax of the /ATMADDRESS =ARP qualifier is as follows:SET DEVICE/ATMADDRESS=(ARP=atm_arp_server)



• /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 be performed only by a router. There can only be one client for each ATM adapter.
  
  
  The syntax of the /CLIP qualifier with standard Internet dotted notation is as follows:
  SET DEVICE/CLIP=(ip_subnet-a.b.c.d,ip_address=a.b.c.c, parent=devnam, name="ipsubnet name", enable,disable, type=client | server)The meanings for /CLIP syntax are in /CLIP Syntax.

  Table 10   /CLIP Syntax

  Option	Meaning
  ip_address	Specifies the IP address of the CLIP client.
  ip_subnet	Specifies the subnet mask of the CLIP client.
  parent=devnam	Specifies the parent device name.
  name	Specifies a name for the LIS to aid in operations anddiagnostics.
  type=client	Starts up a classical IP client only. This is the default.
  type=server	Starts up a classical IP server. Only one server for eachLIS 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 in /CLIP Keywords.

  Table 11   /CLIP Keywords

  Keyword	Meaning
  Enable	Joins the logical IP subnet.
  Disable	Causes a client to leave the logical IP subnet.

  
  




• /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 syntax of the /ELAN qualifier is as follows:DEFINE DEVICE/ELAN=(parent=parent device, name="ELAN NAME to join", size=1516 type=CSMACD Enable,Disable, description= "description string,")
  
  The meanings of the syntax for /ELAN are in /ELAN Syntax.

  Table 12   /ELAN Syntax

  Option	Meaning
  parent	The ATM adapter device name. An example of the parent device for DAPCA is: HWn0, where n is the controller number. An example of the parent device for DGLTA is: HCn0, 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 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 in /ELAN Keywords.
  

  Table 13   /ELAN Keywords

  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.

  
  




• /PVC=(vci[,...])
  /[NO]PVC=(vci[,...])
  
  Sets the permanent virtual circuit (PVC) to be used by a Classical IP over ATM client. 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. The PVC has to be set up manually in the ATM switch.
  
  The vci is the VCI (Virtual Circuit ID) of the PVC to be used.

Examples

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

2. LANCP> SET DEVICE/MEDIA=TWIST EWB0

   This command sets the media type to twisted pair for the second Tulip Ethernet device.

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

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

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

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

Understanding the LANCP Utility

Managing the LAN Device Databases