LANCP, SET, DEVICE parameters
*Conan The Librarian (sorry for the slow response - running on an old VAX)
|
VMS Help LANCP, SET, DEVICE parameters *Conan The Librarian (sorry for the slow response - running on an old VAX) |
|
Alpha only.
On Alpha systems, sets or modifies LAN device parameters.
Requires PHY_IO privilege.
Format
SET DEVICE device-name
| 1 - Parameter |
device-name
Specifies a device to be entered in the LAN volatile device
database, or whose parameters are to be modified. The device
name has the form ddcu where dd is the device code, c is the
controller designation, and u is the unit number. LAN devices are
specified as the name of the template device which is unit 0. For
example, the first DE435 Ethernet device is specified as EWA0,
the second as EWB0.
| 2 - Qualifiers |
2.1 - /AGING_TIMER
/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.
2.2 - /ALL
Sets data for all LAN devices. If you specify a device name, all
matching LAN devices are selected, for example: E to select all
Ethernet devices, F for FDDI, I for Token Ring, EW to select all
Ethernet PCI Tulip devices.
2.3 - /ATMADDRESS
On Alpha systems, /ATMADDRESS=LES 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)
On Alpha systems, /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 /ATMADDRESS=ARP qualifier's syntax is as follows:
SET DEVICE/ATMADDRESS = (ARP=atm_arp_server)
2.4 - /CACHE_ENTRIES
/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 to a large number of
systems, you may want to increase this number.
2.5 - /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 /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=devnam,
name="ip subnet name",
enable, disable
type = client|server)
The meanings for the syntax for /CLIP are as follows:
Option Meaning
ip_address Specifies the IP address of the CLIP client.
ip_subnet Specifies the subnet mask of the CLIP client.
parent=devnamSpecifies the parent device name.
name Specifies a name for the LIS to aid in operations
and diagnostics.
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 each LIS is allowed, and the server needs to be
started first.
type=(server,Starts)up a classical IP server and client.
Keywords and their meaning for /CLIP are as follows:
Keyword Meaning
Enable Joins the logical IP subnet.
Disable Causes a client to leave the logical IP subnet.
2.6 - /CONTENDER
/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.
2.7 - /DISCOVERY_TIMER
/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.
2.8 - /DLL
/DLL=(enable-option, exclusive-option, size-option,
knownclientsonly-option)
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.
You can specify the following keywords with this qualifier:
o enable-option
ENABLE
DISABLE (default)
Specify ENABLE or DISABLE to indicate that MOP downline load
service should be enabled or disabled for the device.
o exclusive-option
EXCLUSIVE
NOEXCLUSIVE (default)
Specify EXCLUSIVE to indicate that no other provider of MOP
downline load service is allowed on the specified LAN device
at the same time as LANACP. Specify NOEXCLUSIVE to indicate
that the LAN MOP downline load service can coexist with
other implementations (in particular, the DECnet Phase IV
implementation that operates the MOP protocol in shared mode).
o size-option
SIZE=value
Use SIZE=value to specify the size in bytes of the file data
portion of each downline load message. The permitted range
is 246 to 1482 bytes. The default value is 246 bytes, which
should allow any client to load properly. Note that some
clients may not support the larger size.
The recommended size for better load performance and less
server overhead is the largest size that results in successful
loads of all clients. The 1482 value is derived from the
maximum packet size for CSMA/CD (Ethernet) of 1518 bytes less
the 802e header and CRC (26 bytes) and MOP protocol overhead
(10 bytes).
You can override the size on a per-node basis. See the DEFINE
NODE and SET NODE commands for details.
o knownclientsonly-option
KNOWNCLIENTSONLY
NOKNOWNCLIENTSONLY (default)
Specify KNOWNCLIENTSONLY to indicate that MOP downline load
requests should be serviced only for clients defined in
the LAN permanent node database. When NOKNOWNCLIENTSONLY is
selected, LANACP searches the LAN$DLL directory for any images
requested by clients that are not defined in the LAN permanent
node database.
2.9 - /EARLY
/EARLY (default)
/NOEARLY
Enables Early Token Release on the device. The /NOEARLY
qualifier, disables Early Token Release.
2.10 - /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 = "description string,")
The meaning of the syntax for /ELAN is as follows:
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.
descriptionA 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.
2.11 - /FULL_DUPLEX
/FULL_DUPLEX
/NOFULL_DUPLEX (default)
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.
2.12 - /MAP
/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.
Specify the functional address as follows:
o The MULTICAST_ADDRESS argument requires a standard 6-byte
multicast address.
o The FUNCTIONAL_ADDRESS argument requires only the last 4
bytes of the functional address (the preceding 03-00 bytes
are automatically prefixed).
o 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, see the following table or issue
the command SHOW DEVICE/MAP device-name.
Functional
Multicast Address Address Description
09-00-2B-00-00-04 03-00-00-00-02-00 ISO ALL ES
09-00-2B-00-00-05 03-00-00-00-01-00 ISO ALL IS
CF-00-00-00-00-00 03-00-00-08-00-00 Loopback Assistant
AB-00-00-01-00-00 03-00-02-00-00-00 DNA MOP Dump/Load
AB-00-00-02-00-00 03-00-04-00-00-00 DNA MOP Remote Console
AB-00-00-03-00-00 03-00-08-00-00-00 DNA L1 Routers
09-00-2B-02-00-00 03-00-08-00-00-00 DNA L2 Routers
09-00-2B-02-01-0A 03-00-08-00-00-00 DNA Phase IV Primary Router
AB-00-00-04-00-00 03-00-10-00-00-00 DNA Endnodes
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
2.13 - /MAX_BUFFERS
/MAX_BUFFERS=value
Sets the maximum number of receive buffers to be allocated and
used by the LAN driver for the LAN device.
2.14 - /MEDIA
/MEDIA=value
o For Token Ring devices:
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.
o For Ethernet devices:
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.
Acceptable values are AUI (10Base2, 10Base5), TWISTEDPAIR
(10BaseT), and AUTOSENSE (reperform the limited autosense
algorithm). The default value is AUTOSENSE.
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.
2.15 - /MIN_BUFFERS
/MIN_BUFFERS=value
Sets the minimum number of receive buffers to be allocated and
used by the LAN driver for the LAN device.
2.16 - /PERMANENT
Reads the permanent database and creates device entries in the
volatile database.
2.17 - /PERMANENT_DATABASE
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.
2.18 - /PVC
/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.
2.19 - /RING_PURGER
Enables the ring purger process of the FDDI device.
2.20 - /SOURCE_ROUTING
/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.
2.21 - /SPEED
/SPEED=value
Sets the speed of the LAN.
For Token Ring, 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 (as does the DEC
Token Ring Controller 700).
For Ethernet, valid values are either 10 or 100, which selects
the 10 megabits per second Ethernet port or the 100 megabits per
second Fast Ethernet port. The default for Ethernet is to sense
automatically which type of port is connected and select the
appropriate speed.
2.22 - /SR_ENTRY
/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.
2.23 - /TOKEN_ROTATION
Sets the requested token rotation time for the FDDI ring.
2.24 - /TOKEN_TIMEOUT
Sets the restricted token timeout time for the FDDI ring.
2.25 - /TRANSMIT_TIMEOUT
Sets the valid transmission time for the FDDI device.
2.26 - /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_DATABASE
qualifier. You can combine the /UPDATE and /PERMANENT_DATABASE
qualifiers in a single SET DEVICE command.
Examples
1. 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.
2. LANCP> SET DEVICE/MEDIA=TWI EWB0
Sets the media type to twisted pair for the second Tulip Ethernet
device, EWB0.
3. LANCP> SET DEVICE EXA0/MOPDLL=ENABLE
Enables MOP downline load service for device EXA0, leaving the
remaining MOPDLL parameters unchanged.
4. 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.
5. LANCP> SET DEVICE EXA0/MOPDLL=(ENABLE,NOEXCLUSIVE)
LANCP> SET DEVICE FXA0/MOPDLL=(ENABLE,EXCL,KNOWN)
These commands enable LANACP MOP downline load service for:
o LAN device EXA0 in nonexclusive mode
o LAN device FXB0 in exclusive mode for only known clients
|
|
