HP OpenVMS Systems Documentation

HP TCP/IP Services for OpenVMS

HP TCP/IP Services for OpenVMS
Management Command Reference

SET 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 ]
[ /DOMAIN=domain ]
[ /LOCAL_HOST=host ]
[ /PROXIES=n ]
[ /REJECT=options ]

restrictions

Requires OPER privilege.

Qualifiers

/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:

[NO]HOSTS=hosts
Hosts that can access TCP/IP Services. Maximum is 32. For example:
/ACCEPT=HOSTS=(host1_name,host2_name, host3_address)
[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_add r:net3_mask)

/DOMAIN=domain
Optional.
Specifies your system's local domain. This qualifier requires either SYSPRV or BYPASS privilege.
/LOCAL_HOST=host
Optional.
Defines the following logical names for the local host:

TCPIP$INET_HOST=host-name
This logical is always set with the primary host name even if the alias name was specified as host.
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=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 {=[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:

[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_add ress)
[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)

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 be inaccessible to the two specified networks.

SET CONFIGURATION BIND

Configures the BIND name server. Creates the BIND server configuration file, which holds the following information:

Cluster alias or aliases
Server type (primary, secondary, or forwarding)
Domains to be served
Location from which the BIND server gets initial information for lookups

You can configure the BIND server as follows:

For one or more Internet domains
As one kind of BIND server (primary, secondary, or forwarding)
As multiple kinds of BIND servers
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. Refer to the HP 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 ]

restrictions

Requires SYSPRV or BYPASS privilege.

Qualifiers

/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:

DOMAIN keys to a particular record within a type.
NODOMAIN deletes the entry.
FILE specifies the name of the hints file.

If you use /CACHE with no options:

DOMAIN defaults to "." ( "root" ).
FILE defaults to NAMED.CA.

/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, refer to the HP TCP/IP Services for OpenVMS Management manual.
/NOCLUSTER=name deletes the specified name as a cluster load-balancing host.
/FORWARDERS=([NO]HOST:host)
Optional.
Specifies the forwarding server.
NOHOST deletes hosts.
/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.

DOMAIN keys to a particular domain.
NODOMAIN deletes the entry.
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=([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.

DOMAIN keys to a particular record within a type.
NODOMAIN deletes the entry.
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.
HOST is a list of hosts from which the secondary server copies the database file.
NOHOST deletes hosts from the host list.

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.

SET CONFIGURATION 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 ]
[ /DOMAIN=domain ]
[ /LOCAL_HOST=host ]
[ /PROXIES=n ]
[ /REJECT=options ]

restrictions

Requires OPER privilege.

Qualifiers

/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:

[NO]HOSTS=hosts
Hosts that can access TCP/IP Services. Maximum is 32. For example:
/ACCEPT=HOSTS=(host1_name,host2_name,host3_add ress)
[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_add r:net3_mask)

/DOMAIN=domain
Optional.
Specifies your system's local domain. This qualifier requires either SYSPRV or BYPASS privilege.
/LOCAL_HOST=host
Optional.
Defines the following logical names for the local host:

TCPIP$INET_HOST=host-name
This logical is always set with the primary host name, even if the alias name was specified as host.
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=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 { =[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:

[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)
[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)

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 be inaccessible to the two specified networks.

SET CONFIGURATION ENABLE SERVICE

Modifies service-related information in the permanent configuration database that enables (or disables) services for startup. Allows you to specify that the service be enabled or disabled for startup on the current node only or on all nodes in the cluster. To specify clusterwide enabling or disabling of services, use the /COMMON qualifier.
SET CONFIGURATION ENABLE SERVICE adds an entry for a service to the list of enabled services in the configuration database.
SET CONFIGURATION ENABLE NOSERVICE removes an entry for a 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
[ /COMMON ]
[ /[NO]CONFIRM ]

Parameters

service
Required.
Specifies the service to add or delete from the configuration database.

Qualifiers

/COMMON
Optional. Default (when /COMMON is not specified): node-specific enabling or disabling of services.
Modifies service-related information in the configuration database for the clusterwide enabling or disabling of services.
/CONFIRM

/NOCONFIRM
Optional. Default: /CONFIRM if you use wildcards; otherwise, /NOCONFIRM.
Use only with SET CONFIGURATION ENABLE NOSERVICE. Controls whether the software requests you to confirm before it deletes an entry. With /CONFIRM enabled, the software requests confirmation. At the CONFIRM: prompt, enter one of the following:

Y to delete the entry
N to retain the entry

The /NOCONFIRM qualifier eliminates all user confirmation when deleting service entries.

Examples

#1
TCPIP> SET CONFIGURATION ENABLE SERVICE TELNET

In the configuration database, enables the TELNET service for startup on this node.

#2
TCPIP> SET CONFIGURATION ENABLE SERVICE FTP /COMMON

In the configuration database, enables the FTP service for startup on every node in the cluster.

#3
TCPIP> SET CONFIGURATION ENABLE NOSERVICE * Enable service TELNET Remove? [N]: Y

In the configuration database, disables any service enabled for startup on this node, if confirmed by the user.

SET CONFIGURATION INTERFACE

Enters information into the configuration database, which defines one of the following when TCP/IP Services starts up:

An Internet interface (hardware connection to the network)
A serial line Internet interface (a form of hardware connection to the network)
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 ]

restrictions

This command requires:

OPER privilege
Read access to the hosts database
Read access to the networks database
Read, write, and delete access to the routes database

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

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.

Qualifiers

/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

/NOAUTO_START
Optional. Default: /AUTO_START.
Valid for a SLIP or PPP interface. Automatically creates the interface when TCP/IP Services starts.
/BROADCAST_MASK=IP_address
Optional.
Sets the Internet interface to receive all broadcast messages.
TCP/IP Services calculates the default by the following methods:

Using the network number
Setting all bits in the host number field to 1

/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:

Using the network number
Setting all bits in the host number field to 1

/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:

Setting the bits representing the network fields to 1
Setting the bits representing the host field to 0

/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= {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.
/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

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

/NOLOOPBACK
Optional. Default: /NOLOOPBACK.
Sets loopback mode.
/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:

Setting the bits representing the network fields to 1
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

/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=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.)

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

Previous Next Contents Index

HP OpenVMS Systems Documentation

HP TCP/IP Services for OpenVMSManagement Command Reference

SET COMMUNICATION

Format

restrictions

Qualifiers

/ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) }

/DOMAIN=domain

/LOCAL_HOST=host

/PROXIES=n

/REJECT {=[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) | =[NO]MESSAGE=(message) }

Examples

SET CONFIGURATION BIND

Format

restrictions

Qualifiers

/CACHE=([NO]DOMAIN:do,[NO]FILE:file)

/CLUSTER=name

/NOCLUSTER=name

/FORWARDERS=([NO]HOST:host)

/PRIMARY=([NO]DOMAIN:do,[NO]FILE:file)

/SECONDARY=([NO]DOMAIN:do,[NO]FILE:file,[NO]HOST:host)

Examples

SET CONFIGURATION COMMUNICATION

Format

restrictions

Qualifiers

/ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) }

/DOMAIN=domain

/LOCAL_HOST=host

/PROXIES=n

/REJECT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) | =[NO]MESSAGE=(message) }

Examples

SET CONFIGURATION ENABLE SERVICE

Format

Parameters

service

Qualifiers

/COMMON

/CONFIRM

/NOCONFIRM

Examples

SET CONFIGURATION INTERFACE

Format

restrictions

Parameters

interface

Qualifiers

/ARP

/NOARP

/AUTO_START

/NOAUTO_START

/BROADCAST_MASK=IP_address

/C_BROADCAST_MASK=IP_address

/C_NETWORK=IP_address

/CLUSTER=host

/NOCLUSTER

/COMPRESS= {ON | OFF | AUTOMATIC}

/DESTINATION=IP_address

/DHCP

/NODHCP

/FLOWCONTROL

/HOST=host

/LOOPBACK

/NOLOOPBACK

/NETWORK_MASK=IP_address

/PRIMARY

/NOPRIMARY

/SERIAL_DEVICE=device

Examples

HP TCP/IP Services for OpenVMS
Management Command Reference