Enters information into the configuration database, which defines
one of the following when TCP/IP Services starts up:
o An Internet interface (hardware connection to the network)
o A serial line Internet interface (a form of hardware
connection to the network)
o A pseudointerface (a data structure that extends subnet
routing so that, on the same physical network, an interface
acts as a gateway between multiple subnets)
Related commands: SHOW INTERFACE, SET INTERFACE
Applies to: Routing
Format
SET CONFIGURATION [NO]INTERFACE interface
[/[NO]ARP ]
[/[NO]AUTO_START ]
[/BROADCAST_MASK=IP_address ]
[/C_BROADCAST_MASK=IP_address]
[/C_NETWORK=IP_address ]
[/[NO]CLUSTER=host ]
[/COMPRESS=options ]
[/DESTINATION=IP_address ]
[/[NO]DHCP ]
[/FLOWCONTROL ]
[/HOST=host ]
[/[NO]LOOPBACK ]
[/NETWORK_MASK=IP_address ]
[/[NO]PRIMARY ]
[/SERIAL_DEVICE=device ]
1 – Restrictions
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. Refer
to the chapter on configuring network interfaces in the HP TCP/IP
Services for OpenVMS Management manual for more information.
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 the following methods:
o Using the network number
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 the following methods:
o Using the network number
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 using the following
methods:
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
/NOCLUSTER
Optional. Default: None.
Specifies the cluster host name (alias host identifier).
Before using this qualifier, first define the same name in the
hosts database.
/CLUSTER=host associates the alias host identifier with each
interface in a cluster.
/NOCLUSTER disables Internet cluster processing on the specified
interface.
CAUTION
When you specify /NOCLUSTER, active communication is aborted
for applications bound to the cluster alias name.
3.7 /COMPRESS
/COMPRESS= {ON | OFF | AUTOMATIC}
Optional. Defaults: 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 the PPP connection is active. If
using /DESTINATION, you must provide the address of the local
host by using the /HOST qualifier.
3.9 /DHCP
/DHCP
/NODHCP
Optional.
Designates the interface as a DHCP-controlled interface in the
permanent database.
3.10 /FLOWCONTROL
Optional. Default: No flow control.
Valid for a SLIP interface. Enables the handling of XON and
XOFF characters to interoperate properly with modems that are
configured to interpret these characters locally.
Specify /FLOWCONTROL only if the host at the other end of the
line is 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 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 the following methods:
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
/PRIMARY
/NOPRIMARY
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 CONFIGURATION INTERFACE SL5 /HOST=LARK -
_TCPIP> /NETWORK_MASK=255.255.255.0 /SERIAL_DEVICE=TTA3: -
_TCPIP> /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 for proper interoperation with modems that are
configured to interpret these characters locally.
2.TCPIP> SET CONFIGURATION INTERFACE FF0 /HOST=KESTREL -
_TCPIP> /NETWORK_MASK=255.255.0.0 -
_TCPIP> /BROADCAST_MASK=128.30.0.0 /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 CONFIGURATION 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 the HP TCP/IP Services for OpenVMS Management manual
for more information about setting up interfaces for SLIP and
PPP communication.