OpenVMS System Management Utilities Reference Manual

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.

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.

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:

enable-option

ENABLE
DISABLE (default)

Specify ENABLE or DISABLE to indicate that MOP downline load service should be enabled or disabled for the device.
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).
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 DEFINE NODE and SET NODE for details.
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.

/UPDATE

Adds LAN devices that are not currently in the LAN permanent device database to that database. The initial entry for the device uses default values for all parameters. To update the permanent database with current information from the volatile database, use the DEFINE DEVICE command with the /VOLATILE_DATABASE qualifier. You can combine the /UPDATE and /VOLATILE_DATABASE qualifiers in a single DEFINE DEVICE command.

/VOLATILE_DATABASE

Updates the device entries in the LAN permanent device 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

```
LANCP> DEFINE DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE) 
```
This command defines LAN device EXA0 to enable LANACP MOP downline load service in exclusive mode. The setting 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 are 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> DEFINE DEVICE/ALL/UPDATE/VOLATILE_DATABASE 
```
This command enters all Ethernet devices into the LAN permanent device database and updates the entry to include the current parameter values.

DEFINE NODE

Enters a node into the LAN permanent node database or modifies an existing entry. Requires SYSPRV privilege.

Format

DEFINE NODE node-name

PARAMETER

node-name
Supplies the name of a node to be added to the LAN permanent 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 permanent 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---an OpenVMS Cluster VAX satellite boot
ALPHA_SATELLITE---an OpenVMS Cluster Alpha satellite boot
OTHER---the specified image; a noncluster satellite load that does 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.
/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, with 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.
/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 that have a problem with MOP Version 4 booting to load. 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
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

```
LANCP> DEFINE NODE GALAXY/ADDRESS=08-00-2B-11-22-33 - 
                  /FILE=NISCS_LOAD.EXE - 
                  /ROOT=$64$DIA14:<SYS10.> - 
                  /BOOT_TYPE=VAX_SATELLITE 
```
This command sets up node GALAXY in the LAN permanent node database for booting as a VAX satellite into an 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.
```
LANCP> DEFINE NODE ZAPNOT/ADDRESS=08-00-2B-11-22-33 - 
                  /FILE=APB.EXE - 
                  /ROOT=$64$DIA14:<SYS10.> - 
                  /BOOT_TYPE=ALPHA_SATELLITE 
```
This command sets up node ZAPNOT for booting as an Alpha satellite into an OpenVMS 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.
```
LANCP> DEFINE 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 a 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.
Note that specifying the file name explicitly in the boot command overrides the file name specified in the node database entry.

EXIT

Stops execution of LANCP and returns control to the DCL command level. You can also enter Ctrl/Z at any time to exit.

Format

EXIT

PARAMETERS

None.

QUALIFIERS

None.

Example

LANCP> EXIT
$

This command stops execution of LANCP and returns control to the DCL command level.

HELP

Provides online help information about the LANCP utility.

Format

HELP [topic]

PARAMETER

topic
Specifies a subject for which you want information---a LANCP command or LANCP command and command keyword. If you enter the HELP command with a command name only, such as HELP SET, LANCP displays a list of all of the command keywords used with the SET command.

QUALIFIERS

None.

Example

LANCP> HELP DEFINE DEVICE
DEFINE 
 
  DEVICE 
 
 
        DEVICE device-name/qualifiers 
        DEVICE/ALL/qualifiers 
 
      Sets device specific parameters for the specified LAN devices. 
 
      Requires SYSPRV privilege. 
 
 
 
    Additional information available: 
 
    Parameters Qualifiers 
    /ALL  /ATMADDRESS /DLL /ELAN /MOPDLL    /VOLATILE_DATABASE    /UPDATE 
    Examples 
 
DEFINE DEVICE Subtopic?

This command provides online help for the LANCP command DEFINE DEVICE.

LIST DEVICE

Displays information in the LAN permanent device database.

Format

LIST DEVICE device-name

PARAMETER

device-name
Supplies the LAN controller device name. 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.
For example, you can specify a DEMNA controller as EXA, EXA0, or EXA0:. This refers to the LAN template device, for which is maintained most of the device parameters and counters. Also, the device name can refer to a device unit representing an actual user or protocol. For example, the cluster protocol can be started on a device as EWA1. You can specify a device unit to view unit-specific parameter information.
If you do not specify a device name, all devices are displayed.
If you specify a device name, all matching LAN devices are displayed, for example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet PCI Tulip devices.

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

QUALIFIERS

/ALL
On Alpha systems, lists all devices in the LAN permanent device database.
/CHARACTERISTICS
On Alpha systems, lists status and related information about the device. It is the same as /PARAMETERS qualifier.
/DLL
Same as /MOPDLL qualifier. It shows downline load characteristics.
/MAP
Lists the current configuration of the functional address mapping table.
/MOPDLL
Displays MOP downline load information.
Devices: Token Ring devices
/PARAMETERS
On Alpha systems, lists status and related information about the device.
/SR_ENTRY
On Alpha systems, lists the contents of the current source routing cache table.

Examples

LANCP> LIST DEVICE/MOPDLL 
 
Device Listing, permanent  database: 
              --- MOP Downline Load Service Characteristics --- 
   Device     State   Access Mode      Clients           Data Size 
   ------     -----   -----------      -------           --------- 
   EXA0      Enabled  Exclusive    KnownClientsOnly      1400 bytes 
   FXA0      Disabled NoExclusive  NoKnownClientsOnly     246 bytes

This command displays MOP downline load information in the LAN permanent device database for all known devices.

LANCP> LIST DEVICE/MOPDLL EXA0 
 
Device Listing, permanent database: 
              --- MOP Downline Load Service Characteristics --- 
   Device     State   Access Mode      Clients           Data Size 
   ------     -----   -----------      -------           --------- 
   EXA0      Enabled  Exclusive    KnownClientsOnly      1400 bytes

This command displays MOP downline load information in the LAN permanent device database for device EXA0.

LIST NODE

Displays information in the LAN permanent node database, especially MOP downline load information.

Format

LIST NODE node-name

PARAMETER

node-name
Specifies the node name. The name can include up to 63 characters associated with the node address. If no node name is given, all nodes are displayed.

QUALIFIERS

/ALL
Displays data for all nodes in the LAN permanent node database. If you specify a node name, all matching nodes are selected; for example, A/ALL selects all nodes beginning with A.
/OUTPUT=command-file-name
Creates the specified file and directs output there in the form of a list of DEFINE NODE or SET NODE commands. The resulting command file can be used to create the LAN node databases.

Example

LANCP> LIST NODE
Node Listing: 
 
GALAXY (08-00-2B-2C-51-28): 
  MOP DLL: Load file:   APB.EXE 
           Load root:   $64$DIA24:<SYS11.> 
           Boot type:   Alpha satellite 
 
ZAPNOT (08-00-2B-18-7E-33): 
  MOP DLL: Load file:   NISCS_LOAD.EXE 
           Load root:   LAVC$SYSDEVICE:<SYS10.> 
           Boot type:   VAX satellite 
 
CALPAL (08-00-2B-08-9F-4C): 
  MOP DLL: Load file:   READ_ADDR.SYS 
           Last file:   LAN$DLL:APB_X5WN.SYS 
           Boot type:   Other 
           2 loads requested, 1 volunteered 
           1 succeeded, 0 failed 
           Last request was for a system image, in MOP V4 format 
           Last load initiated 10-JUN-1996 09:11:17 on EXA0 for 00:00:06.65 
           527665 bytes, 4161 packets, 0 transmit failures 
        
Unnamed (00-00-00-00-00-00): 
 
Totals: 
  Requests received    2 
  Requests volunteered 1 
  Successful loads     1 
  Failed loads         0 
  Packets sent         2080 
  Packets received     2081 
  Bytes sent           523481 
  Bytes received       4184 
  Last load            CALPAL at 10-JUN-1996 09:11:17.29

This example shows output from a LIST NODE command issued on a local node on which there are three nodes defined (GALAXY, ZAPNOT, and CALPAL). CALPAL has issued two load requests:

The first request is the multicast request from CALPAL that the local node volunteered to accept.
The second request is the load request sent directly to the local node by CALPAL for the actual load data. The elapsed time from the second load request to completion of the load was 6.65 seconds.

PURGE DEVICE

Deletes a device from the LAN permanent device database. Requires SYSPRV privilege.

Format

PURGE DEVICE device-name

PARAMETER

device-name
Supplies the LAN controller device name. 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.
For example, you can specify a DEMNA controller as EXA, EXA0, or EXA0:. To select all LAN devices, omit the device name and include the /ALL qualifier.

QUALIFIER

/ALL
Deletes all LAN devices in the LAN permanent device database. 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.

Example

LANCP> PURGE DEVICE/ALL

This command deletes all devices from the LAN permanent device database.

PURGE NODE

Deletes a node from the LAN permanent node database. Requires SYSPRV privilege.

Format

PURGE NODE node-name

PARAMETER

node-name
Supplies the name of a node in the LAN permanent node database.

QUALIFIER

/ALL
Deletes all LAN nodes in the LAN permanent node database. If you specify a node name, all matching nodes are selected; for example, A/ALL deletes all nodes whose name begins with A.

Example

LANCP> PURGE NODE/ALL

This command deletes all nodes from the LAN permanent node database.

SET ACP

Modifies the operation of the LANACP LAN Server process. Requires SYSPRV privilege.

Format

SET ACP

PARAMETERS

None.

QUALIFIERS

/ECHO

/NOECHO (default)
Enables partial tracing of received and transmitted downline load messages (the first 32 bytes of the data portion of each message). Note that the last one or two MOP messages are displayed in full: the memory load message with cluster parameters, and the parameter load with transfer address message, where present in the load.
The data is written to a log file SYS$MANAGER:LAN$node-name.LOG.
To obtain the entire contents of each message, use the /FULL qualifier as follows:
SET ACP/ECHO/FULL 
/FULL

/NOFULL (default)
When /ECHO is enabled, displays the entire contents of received and transmitted downline load messages.
/OPCOM (default)

/NOOPCOM
Enables OPCOM messages from LANACP LAN Server process.
Messages are generated by the LANACP LAN Server process when a device status changes, load requests are received, and loads complete. These messages are displayed on the operator's console and included in the log file written by LANACP, SYS$MANAGER:LAN$ACP.LOG.
/STOP
Stops the LANACP process. It can be restarted by reexecuting the SYS$STARTUP:LAN$STARTUP command file.

Example

LANCP> SET ACP/ECHO/FULL

This command enables tracing of received and transmitted downline load messages. The /FULL qualifier displays the entire contents of received and transmitted downline load messages.

SET DEVICE (parameters) (Alpha only)

On Alpha systems, sets or modifies LAN device parameters. Requires PHY_IO privilege.

Format

SET DEVICE device-name

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.

QUALIFIERS

/AGING_TIMER=value
Sets the amount of time in seconds to age 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.
Devices: Token Ring devices
/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.
/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. The default value is 200 entries.
If your system directly communicates to a large number of systems, you may want to increase this number.
Devices: Token Ring devices
/CLIP
On Alpha systems, the classical internet protocol (CLIP) qualifier sets a device with the TCP/IP protocol enabling 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 the system to join the logical IP subnet when LANCP initializes. The /CLIP = DISABLE command causes the client to leave the logical IP subnet.
Note that a logical IP subnet 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 
                     mode = client|server) 
The meanings for the syntax for /CLIP are as follows:

Keyword/Sub-Keyword Meaning

Create Loads the classical IP driver but does not start it.

Enable Joins 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.

mode=client Starts up a classical IP only. This is the default.

mode=server Starts up a classical IP server and client. Allows only one node for each LIS when specified.

/CONTENDER

/NOCONTENDER (default)
Specifies that the 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.
Devices: Token Ring devices
/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. 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.
Devices: Token Ring devices
/DLL
On Alpha systems, same as /MOPDLL qualifier. They set downline load characteristics.
/EARLY (default)

/NOEARLY
Enables Early Token Release on the device. The /NOEARLY qualifier, disables Early Token Release.
Devices: Token Ring devices operating on 16-megabit rings
/ELAN
On Alpha systems, the /ELAN qualifier has two values: enable and disable. With /ELAN=ENABLE along with the keyword STARTUP, the LAN emulation is loaded when LANCP starts. With /ELAN=DISABLE, the same parameters used with ENABLE can be invoked.
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,"]) 
 
Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
  6048P024.HTM
  OSSG Documentation
  26-NOV-1996 12:42:54.12
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal

Keyword/Sub-Keyword	Meaning
Create	Loads the classical IP driver but does not start it.
Enable	Joins 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.
mode=client	Starts up a classical IP only. This is the default.
mode=server	Starts up a classical IP server and client. Allows only one node for each LIS when specified.

OpenVMS System Management Utilities Reference Manual

/MOPDLL=(enable-option, exclusive-option, size-option, knownclientsonly-option)

/UPDATE

/VOLATILE_DATABASE

DEFINE NODE

Format

DEFINE NODE node-name

PARAMETER

node-name

QUALIFIERS

/ADDRESS=node-address

/NOADDRESS (default)

/ALL

/BOOT_TYPE=boot-option

/NOBOOT_TYPE

/FILE=file-spec

/NOFILE

/ROOT=directory-specification

/NOROOT

/SIZE=value

/NOSIZE

/V3

/NOV3

/VOLATILE_DATABASE

EXIT

Format

EXIT

PARAMETERS

QUALIFIERS

Example

HELP

Format

HELP [topic]

PARAMETER

topic

QUALIFIERS

Example

LIST DEVICE

Format

LIST DEVICE device-name

PARAMETER

device-name

QUALIFIERS

/ALL

/CHARACTERISTICS

/DLL

/MAP

/MOPDLL

/PARAMETERS

/SR_ENTRY

LIST NODE

Format

LIST NODE node-name

PARAMETER

node-name

QUALIFIERS

/ALL

/OUTPUT=command-file-name

Example

PURGE DEVICE

Format

PURGE DEVICE device-name

PARAMETER

device-name

QUALIFIER

/ALL

Example

PURGE NODE

Format

PURGE NODE node-name

PARAMETER

node-name

QUALIFIER

/ALL

Example

SET ACP

Format

SET ACP

PARAMETERS

QUALIFIERS