TCPIP$UCP_HELP.HLB  —  SET  INTERFACE
    Defines one of the following:

    o  An Internet interface

    o  A serial line IP (SLIP) or point-to-point (PPP) connection

    o  A pseudointerface (a data structure that extends subnet
       routing)

    Before you issue SET INTERFACE, do the following to identify the
    name of an interface:

    o  Issue the LIST COMMUNICATION_CONTROLLER command to find your
       system's controller.

    o  Use the first character of the associated interface name.

       Refer to the HP TCP/IP Services for OpenVMS Management manual
       for more information about specifying an interface name.

    SET NOINTERFACE deletes a record. No qualifiers are required.

    Related commands: SHOW INTERFACE, SET CONFIGURATION INTERFACE

    Format

      SET [NO]INTERFACE  interface

                         [ /[NO]ARP ]

                         [ /[NO]AUTO_START ]

                         [ /BROADCAST_MASK=IP_address ]

                         [ /C_BROADCAST_MASK=IP_address ]

                         [ /C_NETWORK=IP_address ]

                         [ /CLUSTER=host ]

                         [ /COMPRESS=options ]

                         [ /DESTINATION=IP_address ]

                         [ /DHCP ]

                         [ /FLOWCONTROL ]

                         [ /HOST=host ]

                         [ /[NO]LOOPBACK ]

                         [ /NETWORK_MASK=IP_address ]

                         [ /PRIMARY ]

                         [ /SERIAL_DEVICE=device ]

1  –  Restrictions

    Before you issue the SET INTERFACE command, disable the interface
    by using the SET NOINTERFACE command.

    This command requires:

    o  OPER privilege

    o  Read access to the hosts database

    o  Read access to the networks database

    o  Read, write, and delete access to the routes database

    Every host on the same network must have the same network mask.

2  –  Parameters

 interface

    Required.

    Specifies an interface name for the communication controller,
    such as RF1, RT1, ZE0, XE0, SL0, SL1, SL2, PP0, PP1, PP2.

3  –  Qualifiers

3.1    /ARP

       /ARP
       /NOARP

    Optional. Default: /ARP.

    Enables IP address-to-hardware address (Ethernet or FDDI)
    mapping.

    /ARP is valid when you create an interface but not when you
    modify an existing interface.

3.2    /AUTO_START

       /AUTO_START
       /NOAUTO_START

    Optional. Default: /AUTO_START.

    Valid for a SLIP or PPP interface. Automatically creates the
    interface when TCP/IP Services starts.

3.3    /BROADCAST_MASK

       /BROADCAST_MASK=IP_address

    Optional.

    Sets the Internet interface to receive all broadcast messages.

    TCP/IP Services calculates the default by:

    o  Using the network number from the network mask

    o  Setting all bits in the host number field to 1

3.4    /C_BROADCAST_MASK

       /C_BROADCAST_MASK=IP_address

    Optional.

    Sets the cluster broadcast mask to receive all broadcast
    messages.

    The software calculates the default by:

    o  Using the network number from the network mask

    o  Setting all bits in the host number field to 1

3.5    /C_NETWORK

       /C_NETWORK=IP_address

    Optional.

    Sets the network mask of the cluster network. This mask is
    specific to the cluster host network.

    The software calculates the default by:

    o  Setting the bits representing the network fields to 1

    o  Setting the bits representing the host field to 0

3.6    /CLUSTER

       /CLUSTER=host

    Optional. Default: None.

    Specifies the cluster host name (alias host identifier) to be
    associated with each interface in a cluster.

    Before using this qualifier, first define the same name in the
    hosts database.

3.7    /COMPRESS

       /COMPRESS= {ON | OFF | AUTOMATIC}

    Optional. Default: For PPP interface: /COMPRESS=ON; for SLIP
    interface: /COMPRESS=OFF

    Valid for SLIP and PPP interfaces.

    Enables or disables TCP header compression.

    /COMPRESS=AUTOMATIC turns off compression unless the remote end
    begins to use it.

3.8    /DESTINATION

       /DESTINATION=IP_address

    Optional.

    Valid for a PPP interface.

    Used on the local host to provide dialup access to remote
    systems. The value specified is the IP address to be given to
    remote clients for use while PPP connection is active. If you use
    /DESTINATION, you must provide the address of the local host with
    the /HOST qualifier.

3.9    /DHCP

    Optional.

    Designates the interface as a DHCP-controlled interface in the
    volatile database. This qualifier affects only the currently
    running interface.

    Before you enter the SET INTERFACE command, be sure to enter the
    SET NOINTERFACE command first and specify the interface you are
    changing.

3.10    /FLOWCONTROL

    Optional. Default: No flow control.

    Valid for a SLIP interface. Enables the handling of XON and
    XOFF characters to properly interoperate with modems that are
    configured to interpret these characters locally.

    Specify /FLOWCONTROL only if the host at the other end of the
    line is another host running TCP/IP Services.

3.11    /HOST

       /HOST=host

    Required when first setting the interface; optional if the
    interface is already defined. Always required for a SLIP
    interface. Optional for a PPP interface unless you are setting
    up the local host as a dialup provider by using the /DESTINATION
    qualifier.

    Local host name or IP address using the interface. If this
    information is not specified for a PPP interface, PPP obtains
    the correct address from the remote host.

    If your host is multihomed, specify an address.

3.12    /LOOPBACK

       /LOOPBACK
       /NOLOOPBACK

    Optional. Default: /NOLOOPBACK.

    Sets loopback mode.

3.13    /NETWORK_MASK

       /NETWORK_MASK=IP_address

    Required if you use subnets.

    The part of the host field of the IP address identified as the
    subnet.

    The software calculates the default by:

    o  Setting the bits representing the network fields to 1

    o  Setting the bits representing the host field to 0

    An IP address consists of a network number and a host number. You
    can also divide the host field into a site-specific subnetwork
    and host field.

3.14    /PRIMARY

    Optional.

    For DHCP-controlled interfaces, designates the interface from
    which system-wide configuration options (such as the IP address
    of the BIND server) are used.

3.15    /SERIAL_DEVICE

       /SERIAL_DEVICE=device

    Required for SLIP and PPP interfaces; otherwise not used.

    Identifies the OpenVMS terminal device used as a serial device.
    Specify an arbitrary terminal device name. (Unlike Ethernet,
    FDDI, and Token Ring interface names, a serial interface name is
    not related to the OpenVMS device name.)

4  –  Examples

    1.TCPIP> SET INTERFACE SL5 /HOST=LARK /NETWORK_MASK=255.255.255.0 -
      _TCPIP> /SERIAL_DEVICE=TTA3: /COMPRESS=ON /FLOWCONTROL

      Configures SLIP interface SL5, using the local IP address
      assigned to host LARK, with a subnet mask of 255.255.255.0.

      The interface uses the terminal device TTA3:.

      The /COMPRESS qualifier enables TCP header compression (CSLIP).

      The /FLOWCONTROL qualifier enables special handling of XON and
      XOFF characters, to ensure proper interoperation with modems
      that are configured to interpret these characters locally.

    2.TCPIP> SET INTERFACE FF0 /HOST=KESTREL /NETWORK_MASK=255.255.0.0 -
      _TCPIP> /BROADCAST_MASK=128.30.255.255 /ARP

      For new interface FF0 on host KESTREL, sets the network mask
      to 255.255.0.0, sets the broadcast mask to 128.30.0.0, enables
      ARP, and activates the interface.

    3.TCPIP> SET INTERFACE PP0 /SERIAL_DEVICE=TTA0: -
      _TCPIP> /HOST=10.10.1.2 /DESTINATION=10.10.1.3

      Configures the interface as a PPP serial device. This command
      specifies that the local host is a dialup provider. The address
      specified with the /DESTINATION qualifier (10.10.1.3) is the
      address assigned to the client system requesting an address.

      Refer to HP TCP/IP Services for OpenVMS Management manual for
      more information on setting up interfaces for SLIP and PPP
      communication.

    4.TCPIP> SET NOINTERFACE DE2
      TCPIP> SET INTERFACE DE2 /LOOPBACK
      .
      .
      .
      TCPIP> SET INTERFACE DE2

      Deletes interface DE2, sets loopback mode for testing this
      interface, and, after testing, reactivates it.
Close Help