 |
HP OpenVMS System Management Utilities Reference
Manual
The /NOFULL_DUPLEX qualifier disables full-duplex operation.
/JUMBO
/NOJUMBO (default)
Enables the use of jumbo frames on a LAN device. Only Gigabit Ethernet
NICs support jumbo frames.
/MEDIA=value
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.
/SPEED=value
Sets the speed of the LAN.
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.
Qualifiers (LAN Failover Devices)
/DISABLE
Disables the devices in 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.
/FAILOVER_SET=(device-name[,...])
/[NO]FAILOVER_SET=(device-name[,...])
Specifies the members of a LAN Failover set.
/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.
/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.
Qualifiers (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.
Qualifiers (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
known states. Setting this value too low may 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 to a large number of systems, you
may 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 may
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 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:
- 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, see Table 13-1 or issue the command
SHOW DEVICE/MAP device-name.
Table 13-1 Default Functional Address Mapping for Token Ring Devices
| Multicast Address |
Functional 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
|
/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.
/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.
/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.
/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.
Qualifiers (ATM Devices)
/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)
|
/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)
|
/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=devnam
|
Specifies 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,client)
|
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.
|
/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: HW
n0, where
n is the controller number. An example of the parent device
for DGLTA is: HC
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 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.
|
/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
|
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:
- LAN device EXA0 in nonexclusive mode
- LAN device FXB0 in exclusive mode for only known clients
SET NODE
Enters a node into the LAN volatile node database or modifies an
existing entry. Requires SYSPRV privilege.
Format
SET NODE node-name
Parameter
node-name
Supplies the name of a node to be added to the LAN volatile node
database or an entry to be modified. Typically, the node name is the
same as that given in the system parameter SCSNODE, but it does not
need to be. The node name is limited to 63 characters in length.
Qualifiers
/ADDRESS=node-address
/NOADDRESS (default)
Associates a LAN address with the node name. Specify the address as 6
bytes in hexadecimal notation, separated by hyphens. The address does
not have to be unique (as might be the case when the address is not
known, so a nonexistent address is specified).
If multiple node addresses are to be associated with a node name, each
combination may be given as a node name with an extension, for example,
VAXSYS.EXA for the EXA device on node VAXSYS, or VAXSYS_1 for the first
LAN device on node VAXSYS.
If you do not specify the /ADDRESS qualifier, the setting remains
unchanged. The /NOADDRESS qualifier clears the field.
/ALL
Defines data for all nodes in the LAN volatile node database. If you
specify a node name, all matching nodes are selected; for example,
A/ALL selects all nodes beginning with A.
/BOOT_TYPE=boot-option
/NOBOOT_TYPE
Indicates the type of processing required for downline load requests.
You can specify one of the following keywords with this qualifier:
- VAX_SATELLITE---a VAX satellite cluster boot
- ALPHA_SATELLITE---an Alpha satellite cluster boot
- I64_SATELLITE---an OpenVMS Cluster Integrity servers satellite boot
- OTHER---the specified image; noncluster satellite loads that do not
require additional data
The distinction is necessary, because OpenVMS Cluster satellite loads
require additional cluster-related data be appended to the load image
given by the /FILE qualifier. The default value is OTHER.
If you do not specify the /BOOT_TYPE qualifier, the setting remains
unchanged. The /NOBOOT_TYPE qualifier clears the field.
Note that Integrity server satellites boot using TFTP rather than MOP
services. This boot type is included so that the information in the
node database can be maintained, not because it is needed for booting
purposes.
/DECNET_ADDRESS=value
/NODECNET_ADDRESS
Associates a DECnet address with the node name. Specify the address in
DECnet notation, xx.xxxx.
If you do not specify the /DECNET_ADDRESS=value qualifier,
then the setting remains unchanged. The /NODECNET_ADDRESS qualifier
clears the field.
/FILE=file-spec
/NOFILE
Supplies the file name of a boot file to be used when the downline load
request does not include a file name (for example, OpenVMS Cluster
satellite booting). The file specification is limited to 127 characters.
If no file name is specified, OpenVMS Cluster satellite loads default
to APB.EXE where the boot type is set to ALPHA and NISCS_LOAD.EXE where
the boot type is set to VAX.
If you do not specify the /FILE qualifier, the setting remains
unchanged. The /NOFILE qualifier clears the field.
/IP_ADDRESS=value
/NOIP_ADDRESS
Associates an IP address with the node name. Specify the address in the
standard dotted notation, xxx.xxx.xxx.xxx.
If you do not specify the /IP_ADDRESS=value qualifier, the
setting remains unchanged. The /NOIP_ADDRESS qualifier clears the filed.
/PERMANENT_DATABASE (SET NODE only)
Updates the node entries in the LAN volatile node 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.
/ROOT=directory-specification
/NOROOT
Supplies the directory specification to be associated with the file
name. For cluster satellite service, the /ROOT qualifier specifies the
satellite root directory. For noncluster service, this qualifier
specifies the location of the file. If the file specification or the
file name given in the boot request includes the directory name, this
qualifier is ignored. The directory specification is limited to 127
characters.
If you do not specify the /ROOT qualifier, the setting remains
unchanged. The /NOROOT qualifier clears the field.
/SIZE=value
/NOSIZE
Specifies the size in bytes of the file data portion of each downline
load message. The default is the load data size specified for the
device. The permitted range is 246 to 1482 bytes. Use a larger size for
better load performance and less server overhead.
If you do not specify the /SIZE qualifier, the setting remains
unchanged. The /NOSIZE qualifier clears the setting.
/V3
/NOV3
Indicates that only MOP Version 3 formatted messages are to be used for
downline load purposes, regardless of the requested format. This allows
systems to load that have a problem with MOP Version 4 booting. This
qualifier causes the requesting node to fail over from MOP Version 4 to
MOP Version 3 when no response has been made to a MOP Version 4 load
request.
If you do not specify the /V3 qualifier, the setting remains unchanged.
The /NOV3 qualifier clears the setting.
/VOLATILE_DATABASE (DEFINE NODE only)
Updates the node entries in the LAN permanent node database with any
data currently set in the volatile database. This allows you to update
the permanent database after changing data in the volatile database,
rather than repeating the commands for each updated entry to apply the
changes to the permanent database.
Examples
| #1 |
LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-11-22-33 -
/FILE=APB.EXE -
/ROOT=$64$DIA14:<SYS10.> -
/BOOT_TYPE=ALPHA_SATELLITE
|
This command sets up node VAXSYS for booting as an Alpha satellite into
the cluster.
The APB.EXE file is actually located on $64$DIA14:
<SYS10.SYSCOMMON.SYSEXE>. Note that the <SYSCOMMON.SYSEXE>
is supplied by the LANACP LAN Server process and is not included in the
root definition.
| #2 |
LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-11-22-33 -
/FILE=NISCS_LOAD.EXE -
/ROOT=$64$DIA14:<SYS10.> -
/BOOT_TYPE=VAX_SATELLITE
|
This command sets up node VAXSYS for booting as a VAX satellite into
the OpenVMS Cluster.
The NISCS_LOAD.EXE file is actually located on $64$DIA14:
<SYS10.SYSCOMMON.SYSLIB>. The <SYSCOMMON.SYSLIB> is
supplied by the LANACP LAN Server process and is not included in the
root definition.
| #3 |
LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-11-22-33/NOROOT
|
This command changes the LAN address associated with node VAXSYS and
clears the current root specification.
| #4 |
SET NODE CALPAL/ADDRESS=08-00-2B-11-22-33/FILE=APB_061.EXE
|
This command sets up node CALPAL for booting an InfoServer image. It
defines the file that should be loaded when a load request without file
name is received from node CALPAL.
Because the file does not include a directory specification, the
logical name LAN$DLL defines where to locate the file. You could give
directory specification using the file name or by using the /ROOT
qualifier.
|
