VMS Help LANCP, DEFINE, DEVICE  *Conan The Librarian (sorry for the slow response - running on an old VAX)

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

    Format

      DEFINE DEVICE  device-name

1 - Parameter

 device-name

    Supplies the name of a device to be added to the LAN permanent
    device database or an entry 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 PCI Ethernet device is specified as EWA0, the second as
    EWB0.

2 - Qualifiers

 2.1 - /ALL

    Defines data for 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
    devices.

 2.2 - /ATMADDRESS

    On Alpha systems, /ATMADDRESS=LES defines the LAN emulation
    server (LES) address for asynchronous transfer mode (ATM).
    Usually the address is not user specified; 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:

    DEFINE DEVICE/ATMADDRESS = ([NO]LES=the ATM server)

    On Alpha systems, /ATMADDRESS=ARP defines the LAN address
    resolution protocol (ARP) server address for Clasical IP over
    ATM. This qualifier is required before a logical IP subnet (LIS)
    is enabled if the local host is not the ARP server.

    The /ATMADDRESS=ARP qualifier's syntax is as follows:

    DEFINE DEVICE/ATMADDRESS = (ARP=atm_arp_server)

 2.3 - /CLIP

    On Alpha systems, defines 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:

    DEFINE 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.4 - /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.5 - /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 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.6 - /PVC

       /PVC=(vci[,...])
       /[NO]PVC=(vci[,...])

    On Alpha systems, defines 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.7 - /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.

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

3 - Examples

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

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

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