1 SET
2 ARP
Maps between an IP address and either an Ethernet or a FDDI
address. SET NOARP removes an address-mapping pair.
Related command: SHOW ARP
Formats
SET ARP mac_address
[ host_name | IP_address ]
[ [/[NO]PERMANENT ]
[ /[NO]PUBLIC ]
SET NOARP [ host_name|IP_address]
3 Restrictions
Requires OPER privilege.
3 Parameters
mac_address
Required.
Specifies the physical Ethernet or FFDI network address to be
mapped to an IP address. Not valid with SET NOARP.
host_name
Optional.
Specifies the host on which the targeted interface resides. If
you do not supply a host name, you must supply its IP address.
IP_address
Optional.
Specifies the 32-bit address that identifies the network and
host. If you do not specify the host's IP address, you must
specify its host name.
You cannot use wildcards.
3 Qualifiers
/PERMANENT
/PERMANENT
/NOPERMANENT
Optional. Default: /PERMANENT.
Specifies whether the mapping information is cached.
/NOPERMANENT removes ARP mapping after the caching interval.
Not valid with SET NOARP.
/PUBLIC
/PUBLIC
/NOPUBLIC
Optional. Default: /PUBLIC.
Specifies whether the local ARP responds to ARP requests from
other hosts to the specified host.
/NOPUBLIC maps only for the local host.
Not valid with SET NOARP.
3 Examples
1.TCPIP> SET ARP AA-BB-04-05-06-07 CONDOR
Permanently maps CONDOR's host name to FDDI address
AA-BB-04-05-06-07.
2 BOOTP
Creates client entries in the BOOTP database.
SET NOBOOTP does not require any qualifiers.
Related commands: CONVERT/VMS BOOTP, SHOW BOOTP
Format
SET [NO]BOOTP host
[ /FILE=file]
/HARDWARE=ADDRESS=hex_address
[ /GATEWAYS=hosts ]
[ /NETWORK_MASK=IP_address ]
[ /SERVERS=type=host ]
[ /TIME_OFFSET=seconds ]
3 Restrictions
Requires read, write, and delete access to the BOOTP database.
3 Parameters
host
Required.
Specifies the client to which your system will download files
upon request. Enter a host name or IP address.
3 Qualifiers
/FILE
/FILE=file
Optional.
Specifies the name of the client's system image or other file to
download upon request.
o By default, upon receiving a request, BOOTP looks for this
file in TCPIP$TFTP_ROOT:[host], where host is the client's
host name, excluding the domain.
o If this directory does not exist, BOOTP uses:
TCPIP$TFTP_ROOT:[000000].
o When the TCP/IP Services software receives a boot request,
BOOTP verifies the existence and size of this file.
/GATEWAYS
/GATEWAYS=hosts
/NOGATEWAYS=hosts
Optional. Default: None.
Specifies the gateways used for routing.
/HARDWARE
/HARDWARE=ADDRESS=hex_addr
Required.
Specifies the client's hardware address. For hex_addr, specify:
hh-hh-hh-hh-hh-hh.
/NETWORK_MASK
/NETWORK_MASK=IP_address
Required if you use subnets; otherwise optional.
Specifies the part of the host field of an IP address identified
as the subnet.
The software calculates the default by setting the following:
o The bits representing the network field to 1
o The bits representing the host field to 0
You can divide the host field into a site-specific subnetwork
and a host field. If you use subnets, you must specify a subnet
field.
/SERVERS
/SERVERS=type=host
Optional.
Specifies other servers whose names BOOTP can supply to clients.
Here, host specifies a host name or IP address and type can be
one or more of the following:
[NO]COOKIE Cookie server
[NO]IEN_NAME IEN-116 name server
[NO]IMPRESS Impress network image server (IMAGEN)
[NO]LPR Berkeley 4BSD print server
[NO]LOG MIT-LCS UDP logging server
[NO]NAME BIND name server
[NO]RESOURCE Resource Location Protocol
(RLP) server (RFC-887)
[NO]TIME Internet time server (RFC-868)
/TIME_OFFSET
/TIME_OFFSET=seconds
Optional. Default: 0 seconds.
Specifies the time difference, in seconds, between the client's
time zone and Universal Coordinated Time (UTC) expressed in
seconds. This value is zero (0) in the British Isles and parts
of Europe, a positive number for locations east of the zero
meridian, and a negative number for locations west of the zero
meridian.
3 Examples
1.TCPIP> SET BOOTP PLOVER /HARDWARE=ADDRESS=08-00-2D-20-23-21 -
_TCPIP> /FILE=PLOVER.SYS
Adds client host PLOVER, with hardware address 08-00-2D-20-23-
21 to the BOOTP database. BOOTP can respond to a remote boot
request from client PLOVER with a reply packet containing the
name of the file to down load and its IP address.
2.TCPIP> SET BOOTP ERN /HARDWARE=ADDRESS=98-00-2D-20-23-21 -
_TCPIP> /SERVERS=COOKIE=(PLOVER,GULL)
Adds client host ERN to the BOOTP database and specifies that
ERN will use PLOVER AND GULL as cookie servers.
3.TCPIP> SET BOOTP PLOVER /HARDWARE=ADDRESS=08-00-2D-20-23-21 -
_TCPIP> /SERVERS=(COOKIE=GULL,NAME=BIRDS)
Adds client host PLOVER to the BOOTP database and specifies
that PLOVER will use GULL as a COOKIE server and BIRDS as its
name server.
2 COMMUNICATION
Modifies the IP, TCP, UDP, and INET_ACP software on the running
system.
Related commands: SET CONFIGURATION COMMUNICATION, SHOW
COMMUNICATION
Format
SET COMMUNICATION [ /ACCEPT=options ]
[ /CLUSTER_TIMER=minutes ]
[ /DOMAIN=domain ]
[ /LOCAL_HOST=host ]
[ /PROXIES=n ]
[ /REJECT=options ]
3 Restrictions
Requires OPER privilege.
3 Qualifiers
/ACCEPT
/ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) }
Optional. Default: All hosts and all networks.
Accepts communication from the hosts and networks specified.
Do not specify the same hosts or networks for both /ACCEPT and
/REJECT.
To delete an /ACCEPT entry, specify it again using the NOHOSTS or
NONETWORKS option.
Specify one of the following:
o [NO]HOSTS=hosts
Hosts that can access TCP/IP Services. Maximum is 32. For
example:
/ACCEPT=HOSTS=(host1_name,host2_name, host3_address)
o [NO]NETWORKS=networks
Networks that can access TCP/IP Services. Maximum is 16.
Use the following syntax:
NETWORKS=(net1[:net1mask],net2[:net2mask],...)
For each network, specify: network:[network_mask]. The network
mask is optional. (Default: class number of your network.
For example, the default for 11.200.0.0. is 255.0.0.0.). For
example:
/ACCEPT=NETWORKS=(net1_name,net2_addr,net3_addr:net3_mask)
/CLUSTER_TIMER
/CLUSTER_TIMER=n
Optional. Default: 5 minutes. (If set to 0, the host holds the
cluster host name until you either stop TCP/IP Services or delete
the interface.)
Specifies the maximum time given for a node to respond to the
cluster name.
/DOMAIN
/DOMAIN=domain
Optional.
Specifies your system's local domain. This qualifier requires
either SYSPRV or BYPASS privilege.
/LOCAL_HOST
/LOCAL_HOST=host
Optional.
Defines the following logical names for the local host:
o TCPIP$INET_HOST=host-name
This logical is always set with the primary host name even if
the alias name was specified as host.
o TCPIP$INET_HOSTADDR=host-IP-address
If the local host has multiple IP addresses, this logical
name is set with a name for each address, called TCPIP$INET_
HOSTADDRn, where n is a number starting at 2.
This qualifier requires either SYSPRV or BYPASS privilege.
/PROXIES
/PROXIES=n
Optional. Default: Number of communication proxies plus 10, with
a minimum of 20.
Specifies the maximum size of the proxy cache. If you plan to add
entries to the proxy database after you start the TCP/IP Services
software, set /PROXIES to a value higher than the default.
You cannot change this value if the TCP/IP Services software is
running.
/REJECT
/REJECT =
{ [NO]HOSTS=(hosts)
[NO]NETWORKS=(networks)
[NO]MESSAGE=(message) }
Optional. Default: No rejections.
Specifies the hosts or networks that cannot access the TCP/IP
Services software, including the rejection message that TCP/IP
might return.
(For remote login, remote shell, and remote executive, the
rejection message is preceded by a byte with a value of 1 and
terminated by a byte with a value of zero.)
Do not specify the same hosts or networks for both /ACCEPT and
/REJECT.
To delete a /REJECT entry, specify it again using the NOHOSTS or
NONETWORKS option.
Specify one of the following:
o [NO]HOSTS=hosts to list hosts that cannot access TCP/IP
Services. Maximum is 32. The syntax is:
/REJECT=HOSTS=(host1_name,host2_name,host3_address)
o [NO]NETWORKS=networks to list networks that cannot access
TCP/IP Services Maximum is 16. The syntax is:
NETWORKS=(net1[:net1mask],net2[:net2mask],... )
For each network, specify network:network_mask. The network
mask is optional. Default: Class number of your network. For
example, the default for 11.200.0.0. is 255.0.0.0. The syntax
is:
/REJECT=NETWORKS=(net1_name,net2_address,net3_addr:net3_mask)
3 Examples
1.TCPIP> SET COMMUNICATION -
_TCPIP /REJECT=NETWORK=(16.30.0.0:255.255.0.0,16.40.0.0:255.255.0.0)
Sets all the services to inaccessible to the two specified
networks.
2 CONFIGURATION
For some components, the TCP/IP Services management program
includes two kinds of configuration commands, those that
modify volatile memory, and those that modify the permanent
database files. Commands that modify volatile memory take effect
immediately, but may be overwritten when the TCP/IP Services
software is restarted. Commands that modify the permanent
database take effect after the TCP/IP Services software has been
restarted.
Those commands are listed in the following table.
Commands that modify Commands that modify the permanent
volatile memory database files
Not applicable SET CONFIGURATION [NO]BIND
SET COMMUNICATION SET CONFIGURATION COMMUNICATION
ENABLE [NO]SERVICE SET CONFIGURATION ENABLE [NO]SERVICE
SET [NO]INTERFACE SET CONFIGURATION [NO]INTERFACE
SET NAME_SERVICE SET CONFIGURATION [NO]NAME_SERVICE
UNMAP SET CONFIGURATION NOMAP
SET PROTOCOL SET CONFIGURATION PROTOCOL
Not applicable SET CONFIGURATION SMTP
Not applicable SET CONFIGURATION SNMP
START ROUTING SET CONFIGURATION START ROUTING
Whether permanent or volatile, the configuration information for
each pair of SET and SET CONFIGURATION commands is the same.
3 BIND
Configures the BIND name server. Creates the BIND server
configuration file, which holds the following information:
o Cluster alias or aliases
o Server type (primary, secondary, or forwarding)
o Domains to be served
o Location from which the BIND server gets initial information
for lookups
You can configure the BIND server as follows:
o For one or more internet domains
o As one kind of BIND server (primary, secondary, or forwarding)
o As multiple kinds of BIND servers
o On TCP/IP clusters for cluster load balancing
This command does not create a BIND 8.1 configuration. If you
want to take full advantage of the new features available
with the BIND 8.1 implementation, you should set up your BIND
environment by editing the TCPIP$BIND.CONF configuration file.
See the Compaq TCP/IP Services for OpenVMS Management manual for
detailed instructions.
If you choose to configure your BIND environment with the
SET CONFIGURATION BIND command, you must enter the command
CONVERT/CONFIGURATION BIND before running BIND.
Related commands: SHOW CONFIGURATION BIND,
CONVERT /CONFIGURATION BIND
Format
SET CONFIGURATION [NO]BIND [ /CACHE=options ]
[ /[NO]CLUSTER=names ]
[ /FORWARDERS=options ]
[ /PRIMARY=options ]
[ /SECONDARY=options ]
4 Restrictions
Requires SYSPRV or BYPASS privilege.
4 Qualifiers
/CACHE
/CACHE=([NO]DOMAIN:do,[NO]FILE:file)
Optional. Default: None.
Specifies the cache server for the specified domain. Do not use
with /FORWARDERS. Use with /PRIMARY and /SECONDARY.
The cache tells the primary or secondary server how to use hints
to find the file. These hints let a server find a root name
server. With this ability, the server can answer requests even
if it does not have the information. You can use the following
options:
o DOMAIN keys to a particular record within a type.
NODOMAIN deletes the entry.
o FILE specifies the name of the hints file.
If you use /CACHE with no options:
o DOMAIN defaults to "." ("root").
o FILE defaults to NAMED.CA.
/CLUSTER
/CLUSTER=name
/NOCLUSTER=name
Required to configure cluster load balancing.
Identifies the name of a TCP/IP cluster as the first step to
setting up cluster load balancing.
For information about the remaining procedure, see the Compaq
TCP/IP Services for OpenVMS Management manual.
/NOCLUSTER=name deletes the specified name as a cluster load-
balancing host.
/FORWARDERS
/FORWARDERS=([NO]HOST:host)
Optional.
Specifies the forwarding server.
NOHOST deletes hosts.
/PRIMARY
/PRIMARY=([NO]DOMAIN:do,[NO]FILE:file)
Optional. Default: None.
Specifies the primary server for the specified zone. Multiple
primary servers are allowed if each is associated with a
different domain.
o DOMAIN keys to a particular domain.
NODOMAIN deletes the entry.
o FILE specifies the domain to be served.
If you do not specify a file, the default file name is created
from the value that you supply with the DOMAIN option.
NOFILE specifies that no file is created.
/SECONDARY
/SECONDARY=([NO]DOMAIN:do,[NO]FILE:file,[NO]HOST:host)
Optional. Default: None.
Specifies the secondary server for the specified zone. Multiple
secondary servers are allowed if each is associated with a
different domain.
o DOMAIN keys to a particular record within a type.
NODOMAIN deletes the entry.
o FILE specifies the name of the boot file.
If you do not specify a file, the default file name is created
from the value that you supply with the DOMAIN option.
NOFILE specifies that no file is created.
o HOST is a list of hosts from which the secondary server copies
the database file.
NOHOST deletes hosts from the host list.
4 Examples
1.TCPIP> SET CONFIGURATION BIND -
_TCPIP> /PRIMARY=(DOMAIN:RHEA.LAB.UBIRD.EDU)
Configures the host as the primary server for domain
RHEA.LAB.UBIRD.EDU.
2.TCPIP> SET CONFIGURATION BIND -
_TCPIP> /SECONDARY=(DOMAIN:JACANA.LAB.UBIRD.EDU) -
_TCPIP> /SECONDARY=(FILE:JACANA.DB,HOST=MARSHY)
Configures the host as a secondary server for domain
JACANA.LAB.UBIRD.EDU and names the boot file JACANA.DB.
Omitting the file name would default to file JACANA_LAB_UBIRD_
EDU.DB.
3.TCPIP> SET CONFIGURATION BIND -
_TCPIP> /SECONDARY=(DOMAIN:0.192.IN-ADDR.ARPA,HOST:WEBBED)
Configures the host as a secondary server for the reverse
lookup domain for addresses that have the form 192.0.*.*.
The boot file name defaults to 0_192_IN-ADDR_ARPA.DB and the
host copies this file from the host WEBBED.
4.TCPIP> SET CONFIGURATION BIND /CACHE
Points the server to the cache file (NAMED.CA), which contains
hints about the root name servers.
3 COMMUNICATION
Enters information into the configuration database to start the
IP, TCP, UDP, and INET_ACP software when the system starts up.
When TCP/IP Services starts up, this configuration overrides the
default settings.
Related commands: SHOW CONFIGURATION COMMUNICATION,
SET COMMUNICATION
Format
SET CONFIGURATION COMMUNICATION [ /ACCEPT=options ]
[ /CLUSTER_TIMER=minutes ]
[ /DOMAIN=domain ]
[ /LOCAL_HOST=host ]
[ /PROXIES=n ]
[ /REJECT=options ]
4 Restrictions
Requires OPER privilege.
4 Qualifiers
/ACCEPT
/ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) }
Optional. Default: All hosts and all networks.
Accepts communication from the hosts and networks specified.
Do not specify the same hosts or networks for both /ACCEPT and
/REJECT.
To delete an /ACCEPT entry, specify it again using the NOHOSTS or
NONETWORKS option.
Specify one of the following:
o [NO]HOSTS=hosts
Hosts that can access TCP/IP Services. Maximum is 32. For
example:
/ACCEPT=HOSTS=(host1_name,host2_name,host3_address)
o [NO]NETWORKS=networks
Networks that can access TCP/IP Services. Maximum is 16.
The syntax is:
NETWORKS=(net1[:net1mask],net2[:net2mask],...)
For each network, specify: network:[network_mask]. The network
mask is optional. (Default: class number of your network.
For example, the default for 11.200.0.0. is 255.0.0.0.). For
example:
/ACCEPT=NETWORKS=(net1_name,net2_addr,net3_addr:net3_mask)
/CLUSTER_TIMER
/CLUSTER_TIMER=n
Optional. Default: 5 minutes. (If set to 0, the host holds the
cluster host name until you either stop TCP/IP Services or delete
the interface.)
Specifies the maximum time given for a node to respond to the
cluster name.
/DOMAIN
/DOMAIN=domain
Optional.
Specifies your system's local domain. This qualifier requires
either SYSPRV or BYPASS privilege.
/LOCAL_HOST
/LOCAL_HOST=host
Optional.
Defines the following logical names for the local host:
o TCPIP$INET_HOST=host-name
This logical is always set with the primary host name, even if
the alias name was specified as host.
o TCPIP$INET_HOSTADDR=host-IP-address
If the local host has multiple IP addresses, this logical
name is set with a name for each address, called TCPIP$INET_
HOSTADDRn, where n is a number starting at 2.
This qualifier requires either SYSPRV or BYPASS privilege.
/PROXIES
/PROXIES=n
Optional. Default: Number of communication proxies plus 10, with
a minimum of 20.
Specifies the maximum size of the proxy cache. If you plan to add
entries to the proxy database after you start the TCP/IP Services
software, set /PROXIES to a value higher than the default.
You cannot change this value if the TCP/IP Services software is
running.
/REJECT
/REJECT =
{ [NO]HOSTS=(hosts)
[NO]NETWORKS=(networks)
[NO]MESSAGE=(message) }
Optional. Default: No rejections.
Specifies the hosts or networks that cannot access the TCP/IP
Services software, including the rejection message that TCP/IP
might return.
(For remote login, remote shell, and remote executive, the
rejection message is preceded by a byte with a value of 1 and
terminated by a byte with a value of 0.)
Do not specify the same hosts or networks for both /ACCEPT and
/REJECT.
To delete a /REJECT entry, specify it again using the NOHOSTS or
NONETWORKS option.
Specify one of the following:
o [NO]HOSTS=hosts to list hosts that cannot access TCP/IP
Services. Maximum is 32. The syntax is:
/REJECT=HOSTS=(host1_name,host2_name, host3_address)
o [NO]NETWORKS=networks to list networks that cannot access
TCP/IP Services Maximum is 16. The syntax is:
NETWORKS=(net1[:net1mask],net2[:net2mask],... )
For each network, specify network:network_mask. The network
mask is optional. Default: Class number of your network. For
example, the default for 11.200.0.0. is 255.0.0.0. The syntax
is:
/REJECT=NETWORKS=(net1_name,net2_address,net3_addr:net3_mask)
4 Examples
1.TCPIP> SET CONFIGURATION COMMUNICATION -
_TCPIP /REJECT=NETWORK=(16.30.0.0:255.255.0.0,16.40.0.0:255.255.0.0)
In the configuration database, sets all the services to
inaccessible to the two specified networks.
3 ENABLE_SERVICE
Note: Specify SET CONFIGURATION ENABLE SERVICE without an
underscore when entering this command. Starts specified services
when TCP/IP Services starts up. This command modifies the
permanent configuration database.
SET CONFIGURATION ENABLE NOSERVICE removes the entry for the
service from the list of enabled services in the configuration
database.
Related commands: SHOW CONFIGURATION ENABLE SERVICE,
ENABLE SERVICE
Format
SET CONFIGURATION ENABLE [NO]SERVICE [ service ]
4 Parameters
service
Required.
Specifies the service to configure to start up.
4 Qualifiers
/COMMON
Optional. Default: Node specific.
Enters information in the configuration database for the
clusterwide enabling or disabling of services.
4 Examples
1.TCPIP> SET CONFIGURATION ENABLE SERVICE TELNET
In the configuration database, initializes TELNET
communications.
2.TCPIP> SET CONFIGURATION ENABLE SERVICE RLOGIN
In the configuration database, starts the Remote Login service.
3.TCPIP> SET CONFIGURATION ENABLE SERVICE SMTP
In the configuration database, enables the SMTP receiver.
For more information about starting SMTP, see the Compaq TCP/IP
Services for OpenVMS Management guide.
3 INTERFACE
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 ]
4 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.
4 Parameters
interface
Required.
Specifies an interface name for the communication controller,
such as RF1, RT1, ZE0, XE0, SL0, SL1, SL2, PP0, PP1, PP2. See the
chapter on configuring network interfaces in the Compaq TCP/IP
Services for OpenVMS Management manual for more information.
4 Qualifiers
/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.
/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.
/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
/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
/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
/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.
/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.
/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.
/DHCP
/DHCP
/NODHCP
Optional.
Designates the interface as a DHCP-controlled interface in the
permanent database.
/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.
/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.
/LOOPBACK
/LOOPBACK
/NOLOOPBACK
Optional. Default: /NOLOOPBACK.
Sets loopback mode.
/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.
/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.
/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.
See the Compaq TCP/IP Services for OpenVMS Management manual
for more information about setting up interfaces for SLIP and
PPP communication.
3 MAP
Adds information to the configuration database that maps
(logically links) one of the following to the NFS server:
o OpenVMS disk - Requires one execution of SET CONFIGURATION MAP
to map the disk to a UNIX path name (logical file system).
o Container file system - Requires two executions of SET
CONFIGURATION MAP. The first maps the disk, and the second
maps the file system.
Mapping creates a logical file system, also called an NFS file
system.
When the NFS server starts up, it issues a GENERATE MAP command,
which creates the mappings for disks and container file systems;
these mappings are viewable with the SHOW MAP command.
Related commands: ADD EXPORT, SHOW EXPORT, REMOVE EXPORT, MAP,
UNMAP, SET CONFIGURATION NOMAP, SHOW MAP, SHOW CONFIGURATION MAP
Format
SET CONFIGURATION MAP "file system name" logical_file_system
4 Restrictions
Requires SYSPRV and BYPASS privilege.
4 Parameters
"file system name"
Required.
Specifies the name for the file system or disk. When mapping
a disk, the "/path" can be only one level from the root. This
parameter specifies the name by which users access the file
system.
logical_file_system
Required.
Specifies the file system to make known to the NFS server.
To map an OpenVMS file system, specify its disk as follows:
$ SET CONFIGURATION MAP "/disk" disk:
To map a container file system, specify the disk and the
directory name as follows:
TCPIP> SET CONFIGURATION MAP "/container_name"
disk:[vms.directory.name] )
4 Examples
1.TCPIP> SET CONFIGURATION MAP "/usr" CANARY$DUA2:
Maps local disk CANARY$DUA2: to /usr. This disk can be exported
to users on remote NFS clients as /usr.
2.TCPIP> SET CONFIGURATION MAP "/remote" VERDIN$DUA3: -
_TCPIP> SET CONFIGURATION MAP "/flyers" VERDIN$DUA3:[UNIX_BIRD_FILES]
Maps [UNIX_BIRD_FILES], a container file system on disk
VERDIN$DUA3:, to /flyers. This file system can be exported
to NFS server users as /flyers. (The first MAP command maps the
underlying OpenVMS file system.)
3 NAME_SERVICE
When TCP/IP Services starts up, configures the BIND resolver and
designates a BIND server. All settings are systemwide.
Related commands: SET NAME_SERVICE,
SHOW CONFIGURATION NAME_SERVICE
Format
SET CONFIG [NO]NAME_SERVICE [/[NO]SERVER=host]
[ /[NO]DOMAIN=domain ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ]
4 Qualifiers
/CLUSTER
/CLUSTER=dev:[directory]
Optional.
Specifies the common BIND directory. By default, the clusterwide
common database common-disk:[TCPIP$BIND_common] is used. This
qualifier reloads the BIND database on every master BIND server
running the OpenVMS cluster.
/DOMAIN
/DOMAIN=domain
/NODOMAIN
Optional. Default: The local domain.
Defines the default domain.
/NODOMAIN deletes the definition of the domain.
/PATH
/PATH=domain
/NOPATH=domain
Optional. SYSNAM privilege is required for this command.
Defines the BIND resolver domain search list. The /NOPATH
qualifier removes domains from the list.
To specify multiple domains, list them by search preference. The
resolver starts with the first domain on the list, and continues
to search each domain until the name is found (or until all
domains have been exhausted and the lookup fails).
If you define a domain list and then issue another SET
CONFIGURATION NAME_SERVICE /PATH command, TCP/IP Services appends
the new domains to the end of the list.
If a search list is not defined, the default behavior of the BIND
resolver is to do a lookup on the name as you typed it. If that
lookup fails, then the default domain is appended and the lookup
is attempted again.
/RETRY
/RETRY=number of retries
Optional. Default: Four retries.
Number of times that the BIND resolver attempts to contact a BIND
server if previous tries failed.
/SERVER
/SERVER=host
/NOSERVER=host
Optional.
Host name or address of the BIND server or servers that the BIND
resolver will query.
To specify multiple hosts, list them by request preference. The
resolver sends the first lookup request to the first host on the
list.
/NOSERVER removes hosts from the list.
If you define a server list and then issue another
SET CONFIGURATION NAME_SERVICE /SERVER command, TCP/IP Services
appends the new servers to the end of the list.
/TIMEOUT
/TIMEOUT=seconds
Optional. Default: 4 seconds.
Timeout interval for the BIND resolver's requests to a BIND
server. Represents the length of time to wait for a reply after
each retry attempt.
The total timeout period will be:
timeout_value * retry_value * number_servers
/TRANSPORT
/TRANSPORT=protocol
Optional. Default: UDP.
Protocol used for communicating with a BIND server. Specify one:
o UDP
o TCP
4 Examples
1.TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=(PARROT,SORA,JACANA)
When TCP/IP Services starts, defines hosts PARROT, SORA, and
JACANA as BIND servers.
2.TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=OSPREY -
_TCPIP> /PATH=(abc.dec.com,xyz.dec.com)
When TCP/IP Services starts, defines host OSPREY as the BIND
server. The BIND resolver searches the abc.dec.com domain
first, and then searches the xyz.dec.com domain.
3 NOMAP
Removes map records from the configuration database that were
previously added with SET CONFIGURATION MAP. When the NFS server
starts up, it issues a GENERATE MAP command that creates the
mappings for disks and container file systems.
Related commands: SET CONFIGURATION MAP,
SHOW CONFIGURATION MAP, ADD EXPORT, SHOW EXPORT, REMOVE EXPORT,
MAP, UNMAP, SHOW MAP
Format
SET CONFIGURATION NOMAP "/path/name" [ /[NO]CONFIRM ]
4 Restrictions
Requires SYSPRV and BYPASS privilege.
4 Parameters
"/path/name"
Required.
UNIX name of the file system to unmap.
You can use wildcards.
4 Qualifiers
/CONFIRM
/CONFIRM
/NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
Requests confirmation before unmapping each file system.
4 Examples
1.TCPIP> SET CONFIGURATION NOMAP "/disk_host"
Unmaps the NFS file system /remote, making it unavailable to
client users when TCP/IP Services starts.
3 PROTOCOL
Enters information into the configuration database that sets the
parameters for ICMP, IP, TCP, and UDP when TCP/IP Services starts
up.
Related commands: SET PROTOCOL, SHOW CONFIGURATION PROTOCOL
Format
SET CONFIGURATION PROTOCOL ICMP
[ /[NO]REDIRECT ]
SET CONFIGURATION PROTOCOL IP
[ /[NO]FORWARD ]
[ /REASSEMBLY_TIMER=seconds ]
SET CONFIGURATION PROTOCOL TCP
[ /[NO]MTU_SEGMENT_SIZE ]
[ /[NO]DELAY_ACK ]
[ /DROP_COUNT=seconds ]
[ /PROBE_TIMER=seconds ]
[ /QUOTA=[
SEND=bytes,RECEIVE=bytes
] ]
[ /[NO]WINDOW_SCALE ]
SET CONFIGURATION PROTOCOL UDP
[ /[NO]BROADCAST ]
[ /[NO]FORWARD ]
[ /QUOTA=options ]
4 Restrictions
Requires OPER privilege.
4 Parameters
{ICMP | IP | TCP | UDP}
Required.
Specifies the protocol software to configure.
4 ICMP_Qualifiers
/REDIRECT
/REDIRECT
/NOREDIRECT
Optional. Default: /NOREDIRECT.
Sends ICMP_REDIRECT messages.
4 IP_Qualifiers
/FORWARD
/FORWARD
/NOFORWARD
Optional. Default: /NOFORWARD.
Forwards IP messages to other hosts.
/REASSEMBLY_TIMER
/REASSEMBLY_TIMER=n
Optional. Default: 7 seconds. Valid range: 1 to 126.
Sets the maximum time for trying to reassemble a received
datagram.
4 TCP_Qualifiers
/MTU_SEGMENT_SIZE
/MTU_SEGMENT_SIZE
/NOMTU_SEGMENT_SIZE
Optional. Default: /NOMTU_SEGMENT_SIZE.
If a connection is more than one hop away, sets the segment size.
Specify one of the following:
/MTU_SEGMENT_SIZE Sets the segment size as close as possible to
the maximum transfer unit (MTU) size.
/NOMTU_SEGMENT_ Sets the segment size as close as possible to
SIZE the standard 512 bytes.
/DELAY_ACK
/DELAY_ACK
/NODELAY_ACK
Optional. Default: /DELAY_ACK.
Enables or disables a delay before sending acknowledgments:
/DELAY_ACK ACKs are generated with a delay.
/NODELAY_ACK ACKs are generated without any delay.
/DROP_COUNT
/DROP_COUNT=n
Optional. Default: 10 minutes.
Specifies the maximum number of seconds to probe for idle TCP
connections before a TCP connection close times out.
/PROBE_TIMER
/PROBE_TIMER=n
Optional. Default: 75 seconds.
Specifies the number of seconds between probes for idle TCP
connections. Also indicates the maximum number of seconds before
a TCP connection request times out.
/QUOTA
/QUOTA=[SEND=bytes,RECEIVE=bytes]
Optional.
Specifies the queue size (in bytes) for messages.
The options for setting TCP message queue size are:
o RECEIVE:n - Receive queue size. Default: 4096 bytes.
o SEND:n - Send queue size. Default: 4096 bytes.
/WINDOW_SCALE
/WINDOW_SCALE
/NOWINDOW_SCALE
Optional.
Turns TCP window scaling on and off. Default is on.
Scaling allows windows larger than 64 KB to be represented in the
normal 16-bit TCP window field. Large windows allow improved
throughput. Turning this option off may help troubleshoot
communication problems with another TCP/IP implementation.
4 UDP_Qualifiers
/BROADCAST
/BROADCAST
/NOBROADCAST
Optional. Default: /NOBROADCAST.
Enables privilege checking for broadcast messages.
o /BROADCAST - Nonprivileged users can send broadcast messages.
o /NOBROADCAST - To send broadcast messages, users need a
privileged UIC or SYSPRV, BYPASS, or OPER privilege.
Sun RPC applications use broadcast messages and need privilege
checking disabled.
/FORWARD
/FORWARD
/NOFORWARD
Optional. Default: /NOFORWARD.
Forwards IP messages.
/QUOTA
/QUOTA=options
Optional.
Specifies the queue size (in bytes) for messages.
The options for setting UDP message queue size are:
o RECEIVE:n - Receive queue size. Default: 9000 bytes.
o SEND:n - Send queue size. Default: 9000 bytes.
4 Examples
1.TCPIP> SET CONFIGURATION PROTOCOL IP /FORWARD
Sets IP to forward messages to other hosts, including other
Internet cluster nodes.
2.TCPIP> SET CONFIGURATION PROTOCOL TCP /PROBE_TIMER=50
Sets the TCP protocol probe timer parameter to 50 seconds.
3 SMTP
Modifies the SMTP configuration in the configuration database.
SET CONFIGURATION NOSMTP with no qualifiers deletes all SMTP
records.
Related commands: SHOW CONFIGURATION SMTP
Format
SET CONFIGURATION [NO]SMTP [ /ADDRESS_RETRIES=n ]
[ /GATEWAY=option=host ]
[ /HOP_COUNT_MAXIMUM=n ]
[ /INTERVAL=options ]
[ /[NO]LOG=[file] ]
[ /OPTIONS=options ]
[ /QUEUES=n ]
[ /RECEIVE_TIMEOUT=minutes ]
[ /SEND_TIMEOUT=minutes ]
[ /SUBSTITUTE_DOMAIN=options ]
[ /[NO]ZONE[=domain] ]
4 Restrictions
For clusters, issue this command only on the nodes where the SMTP
queues reside - that is, on nodes that are not using clusterwide
queues and are not managing clusterwide queues for other nodes.
Requires SYSPRV or BYPASS privilege.
4 Qualifiers
/ADDRESS_RETRIES
/ADDRESS_RETRIES=n
Optional. Default: 16.
Maximum number of different addresses to which SMTP will send
as it tries to deliver mail. Beyond this number of attempts, the
message is undeliverable.
A message is also undeliverable if SMTP fails to deliver after it
attempts all the possible addresses from an MX lookup.
/GATEWAY
/GATEWAY=option=host
Optional. Default: None.
An alternate route through which SMTP sends mail if delivery
fails.
o [NO]ALTERNATE=host
- Alternate host or domain to which delivery is attempted.
- Used by ZONE, if a zone is defined, as the last chance for
delivery (see the /ZONE qualifier).
- NOALTERNATE deletes an existing alternate destination.
o [NO]GENERAL_PURPOSE=host
- Gateway to handle non-SMTP mail, for example, UUCP
addresses.
- NOGENERAL_PURPOSE deletes the specified destination for
protocols other than SMTP.
/HOP_COUNT_MAXIMUM
/HOP_COUNT_MAXIMUM=n
Optional. Default: 16.
Maximum number of relays (hops) between routers until SMTP
considers the mail undeliverable.
/INTERVAL
/INTERVAL=
{ INITIAL="OpenVMS_delta_time"
RETRY="OpenVMS_delta_time"
MAXIMUM="OpenVMS_delta_time" }
Optional. Defaults: INITIAL=30 minutes, RETRY=60 minutes,
MAXIMUM=3 days.
Time intervals related to repeated attempts before delivery
fails. Specify the value within quotation marks as follows: "dddd
hh:mm:ss:cc." For example:
dddd = days (0-9999)
h = hours (0-24)
m = minutes
s = seconds
cc = milliseconds
You can modify the following options:
o INITIAL="OpenVMS_delta_time" is the amount of time that SMTP
waits before making a second attempt to deliver.
o RETRY="OpenVMS_delta_time" is the time SMTP waits between
retries, starting with the second attempt. (Recommended time:
twice the initial interval.)
o MAXIMUM="OpenVMS_delta_time" is the maximum elapsed time that
SMTP retries delivery.
/LOG
/LOG=[file]
/NOLOG=[file]
Optional. Default: SYS$SPECIFIC:[TCPIP_SMTP]TCPIP$SMTP_
LOGFILE.LOG.
File to which SMTP queue activity is logged.
/OPTIONS
/OPTIONS=options
Optional. Defaults: NOEIGHT_BIT, HEADERS, NORELAY.
The following SMTP options are available:
o [NO]EIGHT_BIT
All characters must have the eighth bit clear. Allows the
transmission of 8-bit characters.
o Header control. Specify one of the following:
HEADERS Headers are printed at bottom of messages.
NOHEADERS Headers are omitted.
TOP_HEADERS Headers are printed at top of messages.
NOTOP_ Resets TOP_HEADERS to the default.
HEADERS
o [NO]RELAY
Relays mail to other hosts by functioning as an end node.
/QUEUES
/QUEUES=n
Optional. Default: 1.
Number of execution queues for the specified nodes.
Use this qualifier only on nodes that own the SMTP queues, -
that is, nodes not using clusterwide SMTP queues or managing SMTP
clusterwide queues for other nodes.
/RECEIVE_TIMEOUT
/RECEIVE_TIMEOUT=minutes
Optional. Default: 5 minutes.
Maximum time between socket receipts of a message for a
particular dialog.
If a message is not received within this interval, the connection
is broken and the mail control file is deleted.
/SEND_TIMEOUT
/SEND_TIMEOUT=minutes
Optional. Defaults:
DATA - 3 minutes
INITIAL - 5 minutes
MAIL - 5 minutes
RECEIPT - 5 minutes
TERMINATION - 10 minutes
Maximum time between remote host acknowledgments of a particular
SMTP command.
If an acknowledgment is not received within the specified time,
it is assumed that there are communication problems with the
remote host. If the next delivery attempt takes place before the
mail's delivery date, the mail is rescheduled for later delivery.
/SUBSTITUTE_DOMAIN
/SUBSTITUTE_DOMAIN=([NO]NAME=fully_qualified_domain
|[NO]HIDDEN)
Optional.
o /SUBSTITUTE_DOMAIN=NOHIDDEN
In the From: and Return-Path fields, displays the sender's
name and fully qualified domain.
o /SUBSTITUTE_DOMAIN=HIDDEN
In the From and Return-Path fields, substitutes the value
given in name for the host name. The following example shows
how this qualifier can be used.
For this example, the sender's host is configured with
/SUBSTITUTE_DOMAIN=HIDDEN,NAME=eagle. User magpie on host
condor.hawk.eagle.org sends mail to daw on another host. When
it arrives, it appears to be from magpie@eagle, rather than
magpie@condor.hawk.eagle.org.
This is what daw sees:
#707 18-NOV-2000 14:02:02.71 MAIL
From: SMTP%"magpie@eagle"
To: SMTP%"daw@crow.ravin.rook.org"
CC:
Subj: Big sale today!
/ZONE
/ZONE[=domain]
/NOZONE[=domain]
Optional. Default: /NOZONE (no gateway searching).
Domain for your environment (probably a superset of your local
domain).
Mail sent to another network must be sent to this gateway.
With no value, /ZONE defaults to one level higher than your local
domain.
For example, if your local domain is a.b.com, the default value
of /ZONE is b.com because TCP/IP Services has been started; this
assumes that the domain is known.
Mail for delivery outside of your zone is sent to its destination
by the alternate gateway (see the /GATEWAY qualifier).
4 Examples
1.TCPIP> SET CONFIGURATION SMTP /INTERVAL=(INIT="0 00:10:00.00")
The system waits 10 minutes before making its first attempt to
deliver the message.
2.TCPIP> SET CONFIGURATION SMTP /INTERVAL=(RETRY="0 00:20:00.00")
Specifies the wait time between retries.
3.TCPIP> SET CONFIGURATION SMTP /INTERVAL=(MAX="3 00:20:00.00")
Specifies the maximum amount of time to retry before an error
message is issued.
4.TCPIP> SET CONFIGURATION SMTP /GATEWAY=(ALTERNATE:route_gateway)
Specifies the alternate host or domain to which delivery
is attempted if mail cannot be delivered to the primary
destination.
5.TCPIP> SET CONFIGURATION SMTP /GATEWAY=(GENERAL:uucp_gateway)
Specifies a general-purpose gateway to handle non-SMTP mail.
6.TCPIP> SET CONFIGURATION SMTP /ZONE=rsch.opt.com
Specifies that rsch is a domain that can be used to divert
messages to nodes outside the local domain.
3 SNMP
Configures SNMP on an individual host.
SET CONFIGURATION NOSNMP does not require any qualifiers.
After making changes to the SNMP configuration, shut down and
restart the master agent and any subagents. Issue the following
commands:
$ @SYS$STARTUP:TCPIP$SNMP_SHUTDOWN
$ @SYS$STARTUP:TCPIP$SNMP_STARTUP
Related command: SHOW CONFIGURATION SNMP
Format
SET CONFIGURATION [NO]SNMP [ /[NO]ADDRESS=host ]
[ /[NO]COMMUNITY="name" ]
[ /[NO]CONFIRM ]
[ /CONTACT=name ]
[ /FLAGS=options]
[ /LOCATION=options ]
[ /TYPE=options ]
4 Restrictions
Requires SYSPRV or BYPASS privilege.
If you add a new community and do not specify the /TYPE
qualifier, the value of /TYPE defaults to read only.
If you add a new community and do not specify the /ADDRESS
qualifier, the default address is 0.0.0.0.
4 Qualifiers
/ADDRESS
/ADDRESS=(IP_address)
/NOADDRESS=(IP_address)
Optional. Default: 0.0.0.0
Specifies hosts that belong to a particular community. You can
specify multiple addresses.
This qualifier is meaningful only if you include the /COMMUNITY
qualifier. A remote host cannot access information from this
host unless its address appears in one or more communities
of type READ or WRITE. For communities of type TRAP, the
addresses specify the hosts that receive trap messages. For more
information, see the /TYPE qualifier.
If you add a new community and do not specify this qualifier, the
new entry's address is 0.0.0.0.
If you use the /ADDRESS qualifier with a community that already
exists, these addresses are added to the existing address list.
/NOADDRESS deletes addresses from an existing list. If the
deleted address is the only address listed for the community
name, this qualifier also deletes the community.
/COMMUNITY
/COMMUNITY="name"
/NOCOMMUNITY="name"
Optional. Default: To enable the standard "public" community, you
can run the TCPIP$CONFIG procedure.
Used with the /ADDRESS qualifier. Name of the community that the
SNMP agent recognizes. Optionally, specify a type of access and
a list of host addresses. Enclose the name in quotation marks
to preserve lowercase characters. See the /TYPE and /ADDRESS
qualifiers for more information.
[NO]COMMUNITY=name removes a community name.
/CONFIRM
/CONFIRM
/NOCONFIRM
Optional. Default: /CONFIRM with wildcards; otherwise, /NOCONFIRM
When you delete communities (with the /NOCOMMUNITY qualifier),
first asks for your confirmation.
/CONTACT
/CONTACT=name
Optional. Default: None.
Name of the system administrator (or other contact person) of the
host on which the SNMP agent runs. The name field has a maximum
length of 235.
/FLAGS
/FLAGS=options
Optional.
The options include:
o SETS
Lets the master agent process SET commands from SNMP clients.
o AUTHEN_TRAPS
Lets the master agent send trap messages in response to
unauthorized community strings from SNMP clients.
/LOCATION
/LOCATION=options
Optional. Default: None.
Location of the system on which the SNMP agent runs. Maximum
total length is 215 characters.
The options include:
o [NO]FIRST=text
Specifies the first part of the location. Maximum length of
text is 200 characters.
o [NO]SECOND=text
Specifies the last part of the location. Maximum length of
text is 200 characters.
If you specify two options, they are appended when sent to a
client in response to an SNMP request for syslocation. For
example, if FIRST is abc and SECOND is def, the value of the
location is abcdef with no spaces. The total number of characters
must not exceed 215.
/TYPE
/TYPE= {[NO]READ | [NO]TRAP | [NO]WRITE}
Optional. Default: READ.
Sets the type of access (to your local MIB data) to allow for a
specified community.
o Type READ allows the master agent to accept GET, GETNEXT, and
GETBULK commands from clients (management stations).
o Type TRAP allows the local master agent to issue traps
to members of a specified community. Members of a trap
community receive SNMP Trap-PDUs for significant events,
including coldStart traps when the agent is initialized, and
authenticationFailure traps when the agent receives an SNMP
request that specifies an unauthorized community string.
o Type WRITE allows the master agent to accept SET commands from
clients (management stations).
READ access is present by default when specifying TRAP or WRITE.
Also, you can remove the read access without affecting the way
the agent responds to a read request. For example:
$ SET CONFIGURATION SNMP /COMMUNITY="name" /TYPE=NOREAD
4 Examples
1.TCPIP> SET CONFIGURATION SNMP /COMMUNITY="public" -
_TCPIP> /CONTACT="Sam Spade" -
_TCPIP> /LOCATION=(FIRST="Falcon Building",SECOND="Los Angeles,
California")
Configures SNMP with the standard public community, taking the
default type (READ) and address (0.0.0.0) for that community.
Both contact and location are specified.
The first and second parts of the location text are
concatenated when displayed by an SNMP client. For example:
Falcon BuildingLos Angeles, California
If no update to the location text is done by an SNMP client,
the display produced by SHOW CONFIGURATION SNMP is as follows:
Location
First: Falcon Building
Second: Los Angeles, California
If the text is updated by an SNMP client (for example, to
change "Falcon" to "Falconi"), the original formatting is not
preserved and the display produced by SHOW CONFIGURATION SNMP
is as follows:
Location
First: Falconi BuildingLos Angeles, California
2.TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw" /TYPE=WRITE -
_TCPIP /ADDRESS=136.20.100.10 /FLAGS=SETS
Configures a community with only read/write access to the host
with the address specified. Other hosts still have read access
through the public community. Also sets the SETS flag to enable
the SNMP agents to process write requests from SNMP clients on
host 136.20.100.10.
3.TCPIP> SET CONFIGURATION SNMP /NOCOMMUNITY="rw"
Removes the rw (read/write) community (set in example 2.)
4.TCPIP> SET CONFIGURATION SNMP /COMMUNITY="trapit" /TYPE=TRAP -
_TCPIP> /ADDRESS=136.20.0.10
Configures SNMP so that agents can send trap messages to the
well-known UDP port 162 on the host identified with the address
136.20.0.10.
5.TCPIP> SET CONFIGURATION SNMP /FLAGS=AUTHEN_TRAPS -
_TCPIP> /COMMUNITY="trapit2" /TYPE=TRAP -
_TCPIP> /ADDRESS=(136.20.0.12,136.20.0.15)
Configures SNMP with the AUTHEN_TRAPS flag so that the
master agent sends trap messages when it detects a client
request containing an invalid community name. Also configures
an additional trap community. Trap messages, including
authentication traps, go to all three addresses specified in
the trap communities configured in this example and in example
4.
6.TCPIP> SET CONFIGURATION SNMP /COMMUNITY="rw2" /TYPE=WRITE -
_TCPIP> /ADDRESS=(136.20.0.15,136.20.0.100)
Configures community rw2, which gives read/write access to
two hosts. Note that one address can appear for more than one
community, although a given address cannot be specified more
than once for a single community.
3 START_ROUTING
Note: Specify START ROUTING without an underscore when entering
this command. Enters information into the configuration database
to start dynamic routing when TCP/IP Services starts.
Related commands: SHOW CONFIGURATION START ROUTING, START ROUTING
Format
SET CONFIGURATION START [NO]ROUTING [/GATED ]
[ /LOG ]
[ /SUPPLY[=DEFAULT] ]
4 Qualifiers
/GATED
Optional.
Enables the gateway routing daemon (GATED).
If you enable dynamic GATED routing, you will be able to
configure this host to use any combination of the following
routing protocols to exchange dynamic routing information with
other hosts on the network:
o RIP (Routing Information Protocol), Versions 1 and 2
o RDISC (Router Discovery Protocol)
o OSPF (Open Shortest Path First)
o EGP (Exterior Gateway Protocol)
o BGP (Border Gateway Protocol), BGP-4
o Static routes
/LOG
Optional. Default: No logging.
Applies to ROUTED. Do not use with /GATED.
Logs routing activity to
SYS$SYSDEVICE:[TCPIP$ROUTED]TCPIP$ROUTED.LOG.
/SUPPLY
/SUPPLY[=DEFAULT]
Optional. Applies only to ROUTED. Do not use with /GATED.
Broadcasts routing information to other hosts in 30-second
intervals.
If you specify /SUPPLY=DEFAULT, the local host supplies the
default network route.
4 Examples
1.TCPIP> SET CONFIGURATION START ROUTING /SUPPLY
Starts ROUTED dynamic routing when TCP/IP Services is started.
The local host both broadcasts and receives network routing
information.
2 GATED
Configures the Gateway Routing Daemon (GATED). GATED obtains
information from several routing protocols and selects the best
routes based on that information. These protocols are configured
in the file TCPIP$GATED.CONF.
Related commands: START ROUTING /GATED, STOP ROUTING /GATED
Format
SET GATED [ /CHECK_INTERFACES ]
[ /FILE=file ]
[ /SAVE_STATE ]
[ /TOGGLE_TRACE ]
3 Qualifiers
/CHECK_INTERFACES
Optional.
Instructs GATED to scan the kernel interface list for changes.
/FILE
/FILE=file
Optional.
Specifies the name of the GATED configuration file. Use with the
/SAVE_STATE qualifier.
/SAVE_STATE
Optional.
Causes GATED to save the current state of all
tasks, timers, protocols, and tables to the file
SYS$SYSDEVICE:[TCPIP$GATED]TCPIP$GATED.DMP (default).
Use the /FILE qualifier to specify a file name other than the
default.
/TOGGLE_TRACE
Optional.
Use to close the trace file. A subsequent set GATED /TOGGLE_TRACE
command reopens the trace file. This allows the file to be copied
regularly. Valid only when a trace file is specified in the GATED
configuration file.
3 Examples
1.TCPIP> SET GATED /SAVE_STATE
This example causes GATED to save its current state to the file
SYS$SYSDEVICE:[TCPIP$GATED]TCPIP$GATED.DMP.
2.TCPIP> SET GATED /SAVE_STATE /FILE=STATE.DMP
This example causes GATED to save its current state to the file
named STATE.DMP.
2 HOST
Defines or deletes an entry in the hosts database.
Equivalent to maintaining the /etc/hosts file on UNIX hosts.
Related command: SHOW HOST, CONVERT/VMS HOST
Format
SET [NO]HOST host /ADDRESS=IP_address
[ [/[NO]ALIAS=alias ]
[ /[NO]CONFIRM ]
3 Restrictions
Requires read, write, and delete access to the hosts database.
3 Parameters
host
Required.
Name of a host that is a source or destination of internet
communications.
NOTE
To define a name in lowercase or mixedcase, enclose it in
quotation marks.
If you define a mixed-case name, also define an alias in
either all uppercase or all lowercase characters.
You cannot delete a host by specifying its alias.
3 Qualifiers
/ADDRESS
/ADDRESS=IP_address
Required for SET HOST.
Host's IP address.
/ALIAS
/ALIAS=alias
/NOALIAS=alias
Optional.
Add or remove an alternate name for a host.
Do not use with SET NOHOST.
/CONFIRM
/CONFIRM
NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
Used with the SET NOHOST command, prompts you to confirm the
delete request. For example:
TCPIP> SET NOHOST MOA /ADDRESS=11.33.33.8 /CONFIRM
LOCAL database
Host address Host name
11.33.33.8 MOA
Remove? [N]:
3 Examples
1.TCPIP> SET HOST MOA /ADDRESS=11.33.33.8 -
_TCPIP> /ALIAS=("moa","bigbrd","nofly")
Sets the IP address of host MOA to 11.33.33.8 and establishes
moa, bigbrd, and nofly as aliases for host MOA.
2.TCPIP> SET HOST MOA /ALIAS="MOA_2"
Establishes MOA_2 as an alias for host MOA.
3.TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9
Establishes a second IP address for host MOA.
4.TCPIP> SET HOST MOA /ADDRESS = 128.33.33.9 /ALIAS="MOA_3"
Establishes MOA_3 as an alias for host MOA's second IP address
128.33.33.9.
5.TCPIP> SET HOST MOA /NOALIAS="MOA_2"
Deletes MOA_2 as an alias for host MOA.
6.TCPIP> SET NOHOST MOA /NOCONFIRM
Deletes MOA and all of its associated aliases.
2 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.
See the Compaq 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 ]
[ /[NO]CLUSTER=host ]
[ /COMPRESS=options ]
[ /DESTINATION=IP_address ]
[ /DHCP ]
[ /FLOWCONTROL ]
[ /HOST=host ]
[ /[NO]LOOPBACK ]
[ /NETWORK_MASK=IP_address ]
[ /PRIMARY ]
[ /SERIAL_DEVICE=device ]
3 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.
3 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
/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.
/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.
/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
/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
/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
/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.
/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.
/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.
/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.
/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.
/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.
/LOOPBACK
/LOOPBACK
/NOLOOPBACK
Optional. Default: /NOLOOPBACK.
Sets loopback mode.
/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.
/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.
/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.)
3 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.
See Compaq 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.
2 MX_RECORD
For routing mail, adds routing information to the local Mail
Exchanger (MX) database.
Each entry contains a list of hosts that can accept mail for
the specified destination. The list is in order of routing
preference.
The local MX information is stored in the routes database.
The MX entry is one of the record types in the BIND database. In
addition, a BIND server might provide an MX record.
SMTP is designed to determine where the sending system should try
to relay mail. It is also designed to identify where the sending
system actually tries to relay mail. To find a destination
address, the MX routing lookup process follows this sequence:
1. Local MX database
2. Remote MX database
3. BIND database
4. Local hosts database
Related command: SHOW MX_RECORD
Formats
SET MX_RECORD destination /GATEWAY=host /PREFERENCE=n
SET NOMX_RECORD [ destination ]
[ /GATEWAY=host ]
3 Restrictions
Requires read and write access to the routes database.
3 Parameters
destination
Required for SET MX_RECORD.
Optional for SET NOMX_RECORD.
Host name or domain name to which mail will be sent.
3 Qualifiers
/GATEWAY
/GATEWAY=host
Required with SET MX_RECORD. Do not use with SET NOMX_RECORD.
Gateway through which mail will be relayed. Must have an address
in either the local hosts database or the BIND database.
A destination can have multiple gateways, each with an associated
preference value.
/PREFERENCE
/PREFERENCE=n
Required.
Arbitrary number for ranking multiple gateways for a destination.
The smaller the number, the higher the preference in sending mail
by way of that gateway.
Do not use with SET NOMX_RECORD.
3 Examples
1.TCPIP> SET MX_RECORD JUNO /GATEWAY=MARS /PREFERENCE=100
Assigns MARS as the gateway for host JUNO with a preference of
100.
2.TCPIP> SET MX_RECORD JUNO /GATEWAY=VENUS /PREFERENCE=200
Assigns VENUS as the gateway for host JUNO with a preference of
200.
2 NAME_SERVICE
Configures the BIND resolver and designates a BIND server. By
default, all settings are process specific.
o To make modifications that are systemwide, use the /SYSTEM
qualifier.
o The local host's domain is used as the default domain unless
you also specify /DOMAIN.
o To reload the BIND server databases, use the /INITIALIZE
qualifier.
o /NOSERVER does not require any options.
Related commands: SHOW NAME_SERVICE,
SET CONFIGURATION NAME_SERVICE
Format
SET NAME_SERVICE [ /CLUSTER=dev:[directory] ]
[ /DISABLE ]
[ /[NO]DOMAIN=domain ]
[ /ENABLE ]
[ /INITIALIZE ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /[NO]SERVER=host ]
[ /SYSTEM ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ] )
3 Restrictions
The /SYSTEM qualifier requires SYSPRV or BYPASS and SYSNAM
privileges.
3 Qualifiers
/CLUSTER
/CLUSTER=dev:[directory]
Optional.
Specifies the common BIND directory. By default, the clusterwide
common directory is common-disk:[TCPIP$BIND_COMMON]. This
qualifier reloads the BIND database on every master BIND server
running in the OpenVMS Cluster.
This qualifier must be used with the /INITIALIZE qualifier.
/DISABLE
Optional.
Disables the BIND resolver. All name and address lookups are now
directed to the local hosts database. Use with /SYSTEM.
/DOMAIN
/DOMAIN=domain
/NODOMAIN=domain
Optional.
Defines the default domain. The default domain is appended to
host name references made from the local process.
/NODOMAIN deletes the process-specific definition of the domain.
Do not use with /SYSTEM.
/ENABLE
Optional. Default: Not enabled.
Enables the BIND resolver. Must be used with /SYSTEM.
/INITIALIZE
Optional. Default: No reloading.
Reloads the BIND server databases.
/PATH
/PATH=domain
/NOPATH=domain
Optional.
Defines the BIND resolver's domain search list.
To specify multiple domains, list them by search preference.
The resolver starts with the first domain on the list, and
continues to search each domain until the name is found or until
all domains have been exhausted and the lookup fails.
/NOPATH removes domains from the list.
If you define a domain list and then issue another SET NAME_
SERVICE /PATH command, TCP/IP Services appends the new domains to
the end of the list.
If no search list is defined, the default behavior of the BIND
resolver is to do a lookup on the name as you typed it. If that
lookup fails, then the default domain is appended and the lookup
is attempted again.
/RETRY
/RETRY=number of retries
Optional. Default: four retries.
Specifies the number of times that the BIND resolver attempts to
contact a BIND server if previous tries fail.
/SERVER
/SERVER=host
/NOSERVER=host
Optional.
Specifies the host name or address of the BIND server or servers
that the resolver will query.
To specify multiple hosts, list them by request preference. The
resolver sends the first lookup request to the first host on the
list.
/NOSERVER removes hosts from the list.
If you define a server list and then issue another
SET NAME_SERVICE /SERVER command, TCP/IP Services appends the
new servers to the end of the list.
Do not use /NOSERVER with /SYSTEM.
/SYSTEM
Optional. Default: Changes are process specific.
Makes your settings systemwide.
/TIMEOUT
/TIMEOUT=seconds
Optional. Default: 4 seconds.
Specifies the timeout interval for the BIND resolver's requests
to a server.
When the BIND resolver is used by the auxiliary server, the
following conditions are true:
o The number of retries is one.
o The timeout interval is 1 second.
o The timeout interval increases by the power of two for each
retry, as shown in the following table:
For example:
Retries=4
Current settings: Timeout=4
Retry Times out in...
First 4 seconds
Second 8 seconds
Third 16 seconds
Last 32 seconds
Total = 1 minute for one server
If a second BIND server exists and both
servers time out, total = 2 minutes
/TRANSPORT
/TRANSPORT=protocol
Optional. Default: UDP.
Protocol used for communicating with a BIND server. Specify one
of the following:
o UDP
o TCP
3 Examples
1.TCPIP> SET NAME_SERVICE /SERVER=(PARROT,SORA,JACANA) /SYSTEM /ENABLE
Defines hosts PARROT, SORA, and JACANA as systemwide BIND
servers. Also enables the BIND resolver.
2.TCPIP> SET NAME_SERVICE /SERVER=OSPREY
For your process, defines host OSPREY as the BIND server. The
servers that are defined systemwide will not be queried.
2 NETWORK
Defines or deletes an entry in the networks database.
Equivalent to maintaining the /etc/networks file on UNIX hosts.
Related commands: SHOW NETWORK, CONVERT/VMS NETWORK
Format
SET [NO]NETWORK network
[ /ADDRESS=IP_address ]
[ /[NO]ALIAS=alias ]
[ /[NO]CONFIRM ]
3 Restrictions
Requires read, write, and delete access to the networks database.
3 Parameters
network
Required.
Name of the network.
You cannot delete a network by specifying an alias name.
3 Qualifiers
/ADDRESS
/ADDRESS=IP_address
Required for a new entry.
IP address of the network.
/ALIAS
/ALIAS=alias
/NOALIAS=alias
Optional.
Alternate name for the network.
o Do not use with SET NONETWORK.
o /NOALIAS=alias deletes an alias.
o /NOALIAS=* deletes all aliases.
/CONFIRM
/CONFIRM
NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
When used with SET NONETWORK, prompts you to confirm the delete
request.
3 Examples
1.TCPIP> SET NETWORK MYNA /ADDRESS=128.30.30.10 /ALIAS=MYNA_1
Creates an entry for network MYNA at IP address 128.30.30.10,
and its alias MYNA_1, to the networks database.
2.TCPIP> SET NETWORK MYNA /ALIAS=MYNA_2
Adds a second alias for network MYNA.
3.TCPIP> SET NETWORK MYNA /NOALIAS=MYNA_2
Deletes the alias MYNA_2 from the network MYNA entry in the
networks database.
4.TCPIP> SET NETWORK "jungle" /ALIAS=("parrot","canary","motmot")
For network jungle, creates the aliases parrot, canary, and
motmot.
2 NFS_SERVER
Modifies the parameters of the NFS server software.
You can dynamically modify some characteristics, but other
values are static. Modifications take effect by shutting down
and restarting the NFS server software:
o Dynamically modifiable qualifiers:
- /GID_DEFAULT
- /INACTIVITY_TIMER
- /UID_DEFAULT
o Static qualifiers:
- /THREADS
To make your changes permanent, modify the
SYS$STARTUP:TCPIP$NFS_SERVER_STARTUP.COM file.
To shut down the NFS server, issue the following command:
$ @SYS$STARTUP:TCPIP$NFS_SHUTDOWN.COM
To enable the server to restart, issue the following command:
$ @SYSSTARTUP:TCPIP$NFS_SERVER_STARTUP.COM
The auxiliary server automatically restarts the NFS server upon
an incoming client request.
Related commands: SHOW NFS_SERVER, ZERO NFS_SERVER
Format
SET NFS_SERVER
[ /GID_DEFAULT=n ]
[ /INACTIVITY_TIMER=n ]
[ /THREADS=n ]
[ /UID_DEFAULT=n ]
3 Restrictions
Requires the following privileges:
o SYSNAM
o WORLD
o SYSPRV or BYPASS
3 Qualifiers
/GID_DEFAULT
/GID_DEFAULT=n
Optional. Default: -2.
Default GID associated with files not created by the NFS server.
/INACTIVITY_TIMER
/INACTIVITY_TIMER=n
Optional. Default: 02:00.
Maximum length of time that unaccessed NFS files remain open.
Specify mm:ss, where mm is the number of minutes and ss is the
number of seconds.
/THREADS
/THREADS=n
Optional. Default: 20.
Maximum number of simultaneous requests that the NFS server
processes.
/UID_DEFAULT
/UID_DEFAULT=n
Optional. Default: -2.
Default UID associated with files not created by the NFS server.
3 Examples
1.TCPIP> SET NFS_SERVER /INACTIVITY_TIMER=03:00
Sets the length of time that unaccessed NFS files remain open.
2 PROTOCOL
Sets parameters for ICMP, IP, TCP, and UDP.
Related commands: SET CONFIGURATION PROTOCOL, SHOW PROTOCOL
Format
SET PROTOCOL ICMP [ /[NO]REDIRECT ]
SET PROTOCOL IP [ /[NO]FORWARD ]
[ /REASSEMBLY_TIMER=seconds ]
SET PROTOCOL TCP [ /[NO]MTU_SEGMENT_SIZE ]
[ /[NO]DELAY_ACK ]
[ /DROP_COUNT=seconds ]
[ /PROBE_TIMER=seconds ]
[ /QUOTA=[ SEND=bytes,RECEIVE=bytes ]
[ /[NO]WINDOW_SCALE ] )
SET PROTOCOL UDP [ /[NO]BROADCAST ]
[ /[NO]FORWARD ]
[ /QUOTA=options ]
3 Restrictions
Requires OPER privilege.
3 Parameters
{ICMP | IP | TCP | UDP}
Required.
Specifies the protocol software to configure.
3 Qualifiers_for_ICMP
/REDIRECT
/REDIRECT
/NOREDIRECT
Optional. Default: /NOREDIRECT.
Sends ICMP_REDIRECT messages.
3 Qualifiers_for_IP
/FORWARD
/FORWARD
/NOFORWARD
Optional. Default: /NOFORWARD.
Forwards IP messages to other hosts.
/REASSEMBLY_TIMER
/REASSEMBLY_TIMER=n
Optional. Default: 7 seconds. Valid range: 1 to 126.
Maximum time for trying to reassemble a received datagram.
3 Qualifiers_for_TCP
/MTU_SEGMENT_SIZE
/MTU_SEGMENT_SIZE
/NOMTU_SEGMENT_SIZE
Optional. Default: /NOMTU_SEGMENT_SIZE.
If a connection is more than one hop away, sets the segment size.
Specify one of the following:
/MTU_SEGMENT_SIZE Sets the segment size as close as possible to
the maximum transmission unit (MTU) size
.
/NOMTU_SEGMENT_ Sets the segment size as close as possible to
SIZE the standard 512 bytes.
/DELAY_ACK
/DELAY_ACK
/NODELAY_ACK
Optional. Default: /DELAY_ACK.
Enables or disables a delay before sending the following
acknowledgments:
/DELAY_ACK ACKs are generated with a delay.
/NODELAY_ACK ACKs are generated without any delay.
/DROP_COUNT
/DROP_COUNT=n
Optional. Default: 10 minutes.
Maximum number of seconds to probe for idle TCP connections
before a TCP connection close times out.
/PROBE_TIMER
/PROBE_TIMER=n
Optional. Default: 75 seconds.
Number of seconds between probes for idle TCP connections. Also
indicates the maximum number of seconds before a TCP connection
request times out.
/QUOTA
/QUOTA=[SEND=bytes,RECEIVE=bytes]
Optional.
Queue size (in bytes) for messages.
The options for setting TCP message queue size are:
o RECEIVE:n - Receive queue size. Default: 4096 bytes.
o SEND:n - Send queue size. Default: 4096 bytes.
/WINDOW_SCALE
/WINDOW_SCALE
/NOWINDOW_SCALE
Optional.
Turns TCP window scaling on and off. Default is on.
Scaling allows windows larger than 64KB to be represented in
the normal 16-bit TCP window field. Large windows allow improved
throughput. Turning this option off may help you to troubleshoot
communication problems with another TCP/IP implementation.
3 Qualifiers_for_UDP
/
/[NO]BROADCAST
Optional. Default: /NOBROADCAST.
Enables privilege checking for broadcast messages.
o /BROADCAST - Nonprivileged users can send broadcast messages.
o /NOBROADCAST - To send broadcast messages, users need a
privileged UIC or the SYSPRV, BYPASS, or OPER privilege.
ONC RPC applications use broadcast messages and need privilege
checking disabled.
/FORWARD
/FORWARD
/[NO]FORWARD
Optional. Default: /NOFORWARD.
Forwards IP messages.
/QUOTA
/QUOTA=options
Optional.
Specifies the queue size (in bytes) for messages.
The options for setting UDP message queue size are:
o RECEIVE:n - Receive queue size. Default: 9000 bytes.
o SEND:n - Send queue size. Default: 9000 bytes.
3 Examples
1.TCPIP> SET PROTOCOL IP /FORWARD
Sets IP to forward messages to other hosts, including other
Internet cluster nodes.
2.TCPIP> SET PROTOCOL TCP /PROBE_TIMER=50
Sets the TCP probe timer parameter to 50 seconds.
2 ROUTE
Defines a routing path in either the permanent or volatile routes
database.
Routes in the permanent, on-disk routes database are static.
Static routes can be supplemented by routes that the dynamic
routing server receives. Defaults are as follows:
o If the network is not active, the command affects the
permanent database.
o If the network is active, the command affects the volatile
database. (To modify the permanent database, use the
/PERMANENT qualifier.)
Note the following restrictions:
o You can add routes.
o You cannot use SET NOROUTE to remove a route that is
maintained by the route daemon.
o To have full manual control over your routing table, first
issue STOP ROUTING and then use SET NOROUTE.
o SET NOROUTE does not require any qualifiers.
Related commands: SHOW ROUTE, STOP ROUTING
NOTE
Compaq strongly recommends that you do not specify
alias names with the destination parameter or with the
/GATEWAY=host qualifier.
Format
SET [NO]ROUTE destination
[ /[NO]CONFIRM ]
[ /DEFAULT_ROUTE ]
[ /GATEWAY=host ]
[ /MASK=mask_length ]
[ /NETWORK ]
[ /PERMANENT ]
3 Restrictions
Requires OPER privilege if:
o The TCP/IP Services product is running.
o The routes database requires read and write access.
3 Parameters
destination
Required unless you specify the /DEFAULT_ROUTE qualifier.
Host or network through which to route packets. Specify one of
the following:
o A host, as it is defined in the hosts database
o A network, as it is defined in the networks database
Not valid with /DEFAULT_ROUTE.
3 Qualifiers
/CONFIRM
/CONFIRM
NOCONFIRM
Optional. Default: /CONFIRM if you use a wildcard.
Prompts you to confirm the change.
/DEFAULT_ROUTE
Optional. Default: 0.0.0.0.
Defines a second route to use if the first try to route a packet
fails.
You must also specify a value for /GATEWAY.
Not valid with the destination parameter.
/GATEWAY
/GATEWAY=host
Optional. Default: None.
Gateway for the route. Necessary to send packets to a host on
another network.
/MASK
/MASK=mask_length
Optional. Default: None.
Defines the Classless Inter-Domain Routing (CIDR) mask length.
(The mask length is sometimes referred to as the prefix length.)
CIDR is a method of associating blocks of Internet addresses
through the use of a mask. With CIDR, a route is a combination of
the IP address and a value describing the length of the leftmost
contiguous set of bits.
/NETWORK
Optional. Defaults:
o Destination is classified based on its Internet network class
(A, B, or C).
o If the address is clearly a network number, SET ROUTE
interprets the number correctly.
Defines the route as a network route.
Use this qualifier if the network number could be misinterpreted
as an IP host address, for example, if a network mask is
nonstandard, or if the IP address is abbreviated.
/PERMANENT
Optional. Defaults:
If the network is not active, the permanent routes database is
changed. If the network is active, the volatile routes database
is changed.
Changes only the permanent routes database.
3 Examples
1.TCPIP> SET ROUTE DODO /GATEWAY=RHEA
Defines a route for local host DODO to send packets.
2.TCPIP> SET ROUTE 101.81 /GATEWAY=100.42
Defines a gateway for routing packets for the host with IP
address 101.81.
3.TCPIP> SET ROUTE 100.45.0 /GATEWAY=REMOTE /NETWORK
Sets a route through the network whose IP address is 100.45.0.
4.TCPIP> SET ROUTE /DEFAULT /GATEWAY=DEFGATE /PERMANENT
Sets a default route with host DEFGATE as the default gateway.
Adds the definition to the permanent routes database.
2 SERVICE
Defines a new entry in the services database or modifies an
existing entry.
Related command: SHOW SERVICE
Format
SET [NO]SERVICE service
{ /FILE=startup_file*
/PORT=n*
/PROCESS_NAME=process*
/USER_NAME=vms_user_account* }
[ /ACCEPT=options ]
[ /ADDRESS=IP_address ]
[ /FLAGS=options ]
[ /LIMIT=n ]
[ /LOG_OPTIONS=options ]
[ /PROTOCOL=protocol=options ]
[ /REJECT=options ]
[ /RPC=values ]
[ /SEPARATOR=option ]
[ /SOCKET_OPTIONS=options ]
3 Restrictions
You cannot modify the following fields in an existing entry:
o service
o /ADDRESS
o /PORT
o /PROCESS_NAME
o /PROTOCOL (except for the optional settings)
To make changes to these fields, use SET NOSERVICE to delete the
entry and then re-create the entry.
NOTE
There is no RCP service. RCP uses the RSH server process.
Compaq strongly suggests that, for the services provided by
TCP/IP Services, you do not use this command to reset the
following:
o The required qualifiers
o The /FLAGS qualifier, except for the APPLICATION_PROXY and
CASE_INSENSITIVE options.
Using SET NOSERVICE without either a specified service or
specified qualifiers deletes all entries for all services.
Requires write access to the directory with the services
database.
3 Parameters
service
Required for SET SERVICE; optional for SET NOSERVICE.
Service you want to enter into the services database. Specify a
string of up to 10 characters.
3 Qualifiers
/ACCEPT
/ACCEPT {=[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks)}
Optional. Default: Offers the service to all hosts on all
networks.
o /ACCEPT=HOST=(host)
- Grants host or hosts access to the service.
- Denies access to all other hosts.
o /ACCEPT=NOHOST=host removes access to the service for a host
that previously gained access with /ACCEPT=HOST.
The following options are available:
Option Meaning
HOSTS=hosts Makes the service available to the specified
hosts.
Denies all other hosts access to the service.
Maximum is 32.
NOHOSTS=hosts Removes the specified hosts from the accept
list so they cannot gain access to the
service. You can specify a wildcard character
(*) in place of the hosts list to remove all
hosts from the accept list.
Maximum is 32.
NETWORKS=networks Makes the service available to the specified
networks. Denies access to the service to all
other networks.
Maximum is 16.
For each network, you can optionally specify
the network mask. The default network mask
equals network's class number. For example,
for the network 11.200.0.0., the default mask
is 255.0.0.0.
NONETWORKS[=networks]moves the specified networks from the
accept list so they cannot gain access to the
service. You can specify a wildcard character
(*) in place of the networks list to remove
all networks from the accept list.
Maximum is 16.
For each network, you can optionally specify
the network mask. The default net mask equals
network's class number. For example, for
network 11.200.0.0., the default mask is
255.0.0.0.
/ACCEPT=NONETWORKS=(net1_name,net2_address,net3:net3mask)
/ADDRESS
/ADDRESS=IP_address
Optional. Default: 0.0.0.0 (all local interfaces receive incoming
requests for the service).
If you have multiple Internet interfaces and, therefore, more
than one IP address, /ADDRESS specifies the particular address on
which incoming requests are received.
To define a service name more than once, use /ADDRESS with
different values for each instance. A reason to duplicate a
service name, for example, is that your local host has three
interfaces and you want to make a service available on two of
them. Each service/interface pair must be unique.
/FILE
/FILE=startup_file
Required.
Name of the service's startup command file.
/FLAGS
/FLAGS= {[NO]APPLICATION_PROXY | [NO]MULTITHREAD | [NO]PROXY |
[NO]CASE_INSENSITIVE}
Optional.
The flag options are:
o [NO]APPLICATION_PROXY. Default: NOAPPLICATION_PROXY.
The service does its own proxy checking. This allows
connections based on defined proxies.
Applies to: remote shell (RSH) and line printer daemon (LPD).
NOTE
The ROOT account does not require a communication proxy
in the proxy database. The setting of /FLAGS=APPLICATION_
PROXY flag is not relevant.
o [NO]MULTITHREAD. Default: NOMULTITHREAD.
While connecting a socket to a remote host and passing the
socket to the requested server, the auxiliary server continues
to listen for incoming requests.
o [NO]PROXY. Default: NOPROXY.
User account information is from the proxy database.
o [NO]CASE_INSENSITIVE. Default: CASE_INSENSITIVE.
Case sensitivity of the remote user name in the proxy
database.
Use with /PROXY.
/LIMIT
/LIMIT=n
Optional.
Maximum number of copies of the requested service allowed to run
on the system. If the maximum number is reached, any additional
requests for the service are rejected.
/LOG_OPTIONS
/LOG_OPTIONS=
[ [NO]ACCEPT ]
[ [NO]ACTIVATE ]
[ [NO]ADDRESS ]
[ [NO]ALL ]
[ [NO]CONNECT ]
[ [NO]DEACTIVATE ]
[ [NO]ERROR ]
[ [NO]EXIT_CLEANUP ]
[ [NO]LOGIN ]
[ [NO]LOGOUT ]
[ [NO]MODIFY ]
[ [NO]REJECT ]
Sets the specified logging options for the service you are
configuring.
The logging options have the following meanings:
Option Meaning
[NO]ACCEPT Message is logged when a request is accepted.
[NO]ACTIVATE Message is logged when the service is activated.
[NO]ADDRESS For auxiliary server messages and OpenVMS
security events, the message displays the IP
address as a host name. If host names are not
relevant, Compaq recommends that you specify
[NO]ADDRESS.
[NO]ALL Messages are logged for all events.
[NO]CONNECT Message is logged when the auxiliary server
issues a connect request back to the client.
The services that usually make this request (on
a second socket) are remote shell and remote
execute.
[NO]DEACTIVATE Message is logged when the service is being
deactivated.
[NO]ERROR Message is logged when an error is detected while
processing a request to the service.
[NO]EXIT_ Message is logged when the service fails to
CLEANUP complete startup (that is, the server did not
assign the BG device, with logical name SYS$NET,
or did not issue a C socket before exiting).
[NO]LOGIN Message is logged when a connected terminal
server accepts a remote login request.
[NO]LOGOUT Message is logged when a connected terminal
server terminates a connection.
[NO]MODIFY Message is logged when the active service is
being modified.
[NO]REJECT Message is logged when a request is rejected.
/PORT
/PORT=n
Required.
Port number that the service will use. Specify a number from 1 to
65535.
/PROCESS_NAME
/PROCESS_NAME=process
Required.
Name of the service's process.
Specify a character string up to 15 characters long, truncated to
15 bytes if necessary.
/PROTOCOL
/PROTOCOL=protocol [=options]
Optional. Default: TCP.
Protocol, and its parameters, that the service will use. To set
these parameters, use the following options:
Protocol Option Meaning
IP TYPE_OF_SERVICE=n Type of service, expressed as a
value between 0 and 255.
TIME_TO_LIVE=n Maximum number of hops that packets
can traverse before being dropped.
TCP [NO]DELAY_ACK Delays the sending of acknowledge
(Stream (ACK) packets.
socket Default: DELAY.
type)
DROP_ TCP connection-request timeout
COUNT=seconds interval for the service.
Maximum number of seconds to probe
for idle TCP connections before
such a connection times out and
closes.
PROBE_ Number of seconds between probes
TIMER=seconds for idle connections.
UDP None Datagram socket type
/REJECT
/REJECT =
{[NO]HOSTS=(hosts )
[NO]NETWORKS=(networks ) }
[[NO]MESSAGE="text"]
Optional. Default: No rejections if /ACCEPT is set to its default
(service all hosts).
o /REJECT=HOST=host denies host access to the service.
o /REJECT=NOHOST=host regrants host access to the service.
The following options are available.
Option Meaning
HOSTS=hosts Makes the service unavailable to the specified
hosts.
Maximum is 32.
Examples:
/REJECT=HOSTS=(host1_name,host2_name, host3_
address)
/REJECT=HOSTS=*
NOHOSTS=hosts Removes the specified hosts from the reject
list. You can use the wildcard character (*)
in place of the hosts list to remove all hosts
from the reject list.
Maximum is 32.
Examples:
/REJECT=NOHOSTS=(host1_name,host2_name,host3_
address)
/REJECT=NOHOSTS=*
NETWORKS=networks Makes the service unavailable to the hosts on
the specified networks.
Maximum is 16.
For each network, you can optionally specify
the network mask. The default net mask equals
network's class number. For example, for
network 11.200.0.0., the default mask is
255.0.0.0.
Example:
/REJECT=NETWORKS=(net1_name,net2_address,
net3:net3mask)
NONETWORKS[=networks]moves the specified networks from the reject
list. You can use the wildcard character (*)
in place of the networks list to remove all
networks from the reject list.
Maximum is 16.
For each network, you can optionally specify
the network mask. The default net mask equals
network's class number. For example, for
network 11.200.0.0., the default mask is
255.0.0.0.
Example:
/REJECT=NONETWORKS=(net1_name,net2_address,
net3:net3mask)
[NO]MESSAGE=text Message sent to "reject-list" clients when
NOMESSAGE TCP/IP Services rejects their request for the
service.
Optional.
Specify a character string up to 63
characters.
Enclose the string in quotation marks.
Use this option only for a service whose
clients require and support reject messages.
Messages are sent with a carriage return/line
feed at the end.
For RLOGIN, RSH, and REXEC, this message is
preceded by a byte with a value of 1 and is
terminated with a byte with a value of 0.
/REJECT=NOMESSAGE deletes the stored message
text.
/RPC
/RPC=(PROGRAM_NUMBER=n, VERSION_NUMBER=(LOW=n, HIGH=n))
Required for services that use the Portmapper; otherwise, not
valid. Defaults:
Program Highest
Service Number Version Lowest Version
MOUNT 100005 1 1
NFS server 100003 2 2
PCNFS 150001 1 2
PORTMAPPER 100000 1 1
Information that identifies the service to the Portmapper. Use
this qualifier for all applications that use RPCs.
/SEPARATOR
/SEPARATOR=option=character
Optional. Default: 0 (null).
Character that separates the following fields in received
packets:
o PORT=character
o USER_NAME=character
o PASSWORD=character
o COMMAND=character
/SOCKET_OPTIONS
/SOCKET_OPTIONS=(options)
Optional.
The following socket options are available.
Option Description Default
BROADCAST Sockets Null character (hexadecimal 00)
are UDP
NOBROADCAST broadcast.
Sockets
are not UDP
broadcast.
KEEPALIVE Sockets Null character (hexadecimal 00)
are TCP
NOKEEPALIVE keepalive.
Sockets
are not TCP
keepalive.
RECEIVE Receive Null character (hexadecimal 00)
socket quota.
SEND Send socket Null character (hexadecimal 00)
quota.
/USER_NAME
/USER_NAME=vms_user_account
Required.
OpenVMS account information for users working on client systems.
Required for a user to access the service.
The user must also be defined in the system user authorization
file (SYSUAF.DAT).
3 Examples
1.TCPIP> SET SERVICE TOE /USER_NAME=LITTLE_PIGGY -
_TCPIP /PROCESS_NAME=TOEd /PORT=1050 /PROTOCOL=UDP -
_TCPIP /FILE=SYS$COMMON:[SYSMGR]TOE_STARTUP.COM
Defines the service TOE, which implements UDP on port
1050. This service has the OpenVMS process context of user
LITTLE_PIGGY.
After you issue a SET SERVICE TOE command, the auxiliary server
executes TOE_STARTUP.COM when a request arrives for service
TOE.
2.TCPIP> SET SERVICE LPD -
_TCPIP> /REJECT=NETWORK=(11.30.0.0:255.255.0.0,11.40.0.0)
Sets the LPD service to be inaccessible to the two specified
networks.
3.TCPIP> SET SERVICE RSH /FLAGS=(PROXY,CASE_INSENSITIVE)
Sets the proxy and case-sensitivity flags for the RSH service.