DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

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)

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

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

restrictions

Requires OPER privileges.

Qualifiers

/ACCEPT { =[NO]HOSTS=(hosts) | =[NO]NETWORKS=(networks) }
Optional. Default: All hosts and all networks.
Accept communication from the hosts and/or 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 DIGITAL TCP/IP Services for OpenVMS. Maximum is 32. For example:
/ACCEPT=HOSTS=(host1_name,host2_name,host3_add ress)
[NO]NETWORKS=networks
Networks that can access DIGITAL TCP/IP Services for OpenVMS. Maximum is 16.
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)

/ALLOW_LOG_OPTIONS=options
Optional. Default: No logging.
Event logging options for all the services. (However, to specify a name for a service's log file, use the SET SERVICE command.)
If you set an option with this qualifier, but an individual service has a different setting for the same option (that was set with SET SERVICE), that setting overrides the setting with /ALLOW_LOG_OPTIONS (see the /FORCE_LOG_OPTIONS qualifier).
The available options are:

[NO]ACCEPT
Logs a message when a request is accepted.
[NO]ACTIVATE
Logs a message when the auxiliary server activates a service.
[NO]ADDRESS
Translates the IP address to a host name when logging auxiliary server messages and OpenVMS security events. This translation might involve lookup in the BIND resolver.
If host names are not relevant for these messages, Compaq recommends that you specify this option.
[NO]ALL
Logs messages for all events.
[NO]CONNECT
Logs a message when the auxiliary server issues a connect request back to the client.
(Typically, the remote shell and remote execute servers request such a connection on a second socket.)
[NO]DEACTIVATE
Logs a message when a server of a particular service is deactivated.
[NO]ERROR
Logs a message when an error is detected while processing a request to a server.
[NO]EXIT_CLEANUP
Logs a message when, during server termination, it is detected that the server did not go through all the steps required for startup.
For servers not marked as LISTEN, the server did not accept the connection request (issue a TCP accept or a UDP receive).
For servers marked as LISTEN, the server did not ASSIGN the BG device (SYS$NET logical name) or issue a VAX C socket before exiting.
[NO]LOGIN
Logs a message when a connected terminal server accepts a remote login request.
[NO]LOGOUT
Logs a message when a service connected to a terminal server breaks the connection.
[NO]MODIFY
Logs a message when an active server is modified.
[NO]REJECT
Logs a message when a request is rejected.
A service can be rejected because:

Maximum number of services has been reached for the requested service
Maximum number of services has been reached for all services
Requesting host is marked for rejection

[NO]TIMEOUT
Logs a message when a server not marked as LISTEN is timing out.

/CLUSTER_TIMER=n
Optional. Default: 5 minutes (the host holds the cluster host name until you either stop DIGITAL TCP/IP Services for OpenVMS or delete the interface).
Maximum time given for a node to respond to the cluster name.
/DOMAIN=domain
Optional.
Your system's local domain. This qualifier requires either SYSPRV or BYPASS privileges.
/LOCAL_HOST=host
Required.
Defines the following logical names for the local host:

TCPIP$INET_HOST = host name
If you previously set the host's name by specifying its alias, this logical name is set with the host name.
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
Here, n = a number starting at 2.

This qualifier requires either SYSPRV or BYPASS privileges.
/PROXIES=n
Optional. Default: Number of communication proxies plus 10, with a minimum of 20.
Maximum size of the proxy cache. If you plan to add entries to the proxy database after you start DIGITAL TCP/IP Services for OpenVMS software, set /PROXIES to a value higher than the default.
You cannot change this value if DIGITAL TCP/IP Services for OpenVMS software is running.
/REJECT =
{ [NO]HOSTS=(hosts) [NO]NETWORKS=(networks) [NO]MESSAGE=(message) }
Optional. Default: No rejections.
Hosts or networks that cannot access DIGITAL TCP/IP Services for OpenVMS 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
Hosts that cannot access DIGITAL TCP/IP Services for OpenVMS. Maximum is 32. The syntax is:
/REJECT=HOSTS=(host1_name,host2_name,host3_add ress)
[NO]NETWORKS=networks
Networks that cannot access DIGITAL TCP/IP Services for OpenVMS. 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 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 it will get initial information for lookups

You can configure the BIND server:

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. See the DIGITAL TCP/IP Services for OpenVMS Management manual for further instructions.
If you choose to configure your BIND environment with the SET CONFIGURATION BIND command, you must enter the command CONVERT/CONFIGURATON 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 privileges.

Qualifiers

/CACHE=([NO]DOMAIN:do,[NO]FILE:file)
Optional. Default: None.
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 find the file with hints. 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, see the DIGITAL TCP/IP Services for OpenVMS Management manual.
/NOCLUSTER=name deletes the specified name as a cluster load balancing host.
/FORWARDERS=([NO]HOST:host)
Optional.
Forwarding server.
NOHOST deletes hosts.
/PRIMARY=([NO]DOMAIN:do,[NO]FILE:file)
Optional. Default: None.
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.
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.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 of 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 DIGITAL TCP/IP Services for OpenVMS starts up, this configuration overrides the default settings.
Related commands: SHOW CONFIGURATION COMMUNICATION, SET COMMUNICATION
See the SET COMMUNICATION command for a description of valid parameters and qualifiers.

SET CONFIGURATION ENABLE SERVICE

Enables specified services when the DIGITAL TCP/IP Services for OpenVMS product starts up. This command modifies the permanent configuration database.
Related commands: SHOW CONFIGURATION ENABLE SERVICE, ENABLE SERVICE
See the ENABLE SERVICE command for a description of valid parameters and qualifiers.

SET CONFIGURATION INTERFACE

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

An internet interface (hardware connection to the network)
A serial line internet interface (a form of hardware connection to the network)
A pseudo-interface (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 CONFIGURATION INTERFACE, SET INTERFACE
Applies to: Routing
See the SET INTERFACE command for a description of valid parameters and qualifiers.

SET CONFIGURATION MAP

Adds information to the configuration database that maps (logically links) one of the following to the NFS server:

OpenVMS disk --- Requires one execution of SET CONFIGURATION MAP to map the disk to a UNIX style path name (logical file system).
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 GENERATE MAP, which enables file system mapping.
See the MAP command for a description of valid parameters and qualifiers.

SET CONFIGURATION NAME_SERVICE

Upon DIGITAL TCP/IP Services for OpenVMS startup, configures the BIND resolver and designates a BIND server. All settings are systemwide.
Related commands: SET NAME_SERVICE, SHOW CONFIGURATION NAME_SERVICE

Format

SET CONFIGURATION [NO]NAME_SERVICE/[NO]SERVER=host [ /[NO]DOMAIN=domain ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ]

Qualifiers

/DOMAIN=domain

/NODOMAIN
Optional. Default: The local domain.
Defines the default domain.
/NODOMAIN deletes the process-specific definition of the domain.
/PATH=domain

/NOPATH=domain
Required. SYSNAM privilege is required for this command.
Defines the BIND resolver domain search list. /NOPATH removes domains from the list.
To specify multiple domains, list them by search preference. The resolver will start with the first domain on the list, and continue 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 NAME_SERVICE /PATH command, DIGITAL TCP/IP Services for OpenVMS 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=number of retries
Optional. Default: 4 retries
Number of times that the BIND resolver attempts to contact a BIND server if previous tries fail. Do not use with the /SYSTEM qualifier.
/SERVER=host

/NOSERVER=host
Required.
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 NAME_SERVICE /SERVER command, DIGITAL TCP/IP Services for OpenVMS appends the new servers to the end of the list.
/TIMEOUT=seconds
Optional. Default: 4.
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 number of retries is one.
The timeout interval is 1 second.

The total timeout period will be:
timeout_value * retry_value * number_servers

/TRANSPORT=protocol
Optional. Default: UDP.
Protocol used for communicating with a BIND server. Specify one:

UDP
TCP

Examples

#1
PARROT> TCPIP TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=(PARROT,SORA,JACANA)

Upon the next DIGITAL TCP/IP Services for OpenVMS startup, defines hosts PARROT, SORA, and JACANA as BIND servers. Also enables the BIND resolver.

#2
TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=OSPREY

Upon DIGITAL TCP/IP Services for OpenVMS startup, defines host OSPREY as the BIND server. The servers that are defined systemwide will not be queried.

SET CONFIGURATION PROTOCOL

Enters information into the configuration database which sets the parameters for IP, TCP, UDP, ICMP, RAW_IP, and ARP when DIGITAL TCP/IP Services for OpenVMS starts up.
Related commands: SET PROTOCOL, SHOW CONFIGURATION PROTOCOL
Applies to: IP, TCP, UDP, ICMP, ARP
See the SET PROTOCOL command for a description of valid parameters and qualifiers.

SET CONFIGURATION 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 ]
[ /POSTMASTER=account ]
[ /QUEUES=n ]
[ /RECEIVE_TIMEOUT=minutes ]
[ /SEND_TIMEOUT=minutes ]
[ /SUBSTITUTE_DOMAIN=options ]
[ /[NO]ZONE[=domain] ]

restrictions

For clusters, issue this command only on the nodes where the SMTP queues reside --- nodes that are not using clusterwide queues and are not managing clusterwide queues for other nodes.
Requires SYSPRV or BYPASS privileges.

Qualifiers

/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=option=host
Optional. Default: None.
An alternate route through which SMTP sends mail if delivery fails.

[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 /ZONE).
NOALTERNATE deletes an existing alternate destination.

[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=n
Optional. Default: 16.
Maximum number of relays (hops) between routers until SMTP considers the mail undeliverable.
/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 when 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:

INITIAL="OpenVMS_delta_time" is the amount of time that SMTP waits before making a second attempt to deliver.
RETRY="OpenVMS_delta_time" is the time SMTP waits between retries, starting with the second attempt. (Recommended time: twice the initial interval.)
MAXIMUM="OpenVMS_delta_time" is the maximum elapsed time that SMTP retries delivery.

/LOG=[file]

/NOLOG=[file]
Optional. Default: SYS$SPECIFIC:[TCPIP_SMTP]TCPIP$SMTP_LOGFILE.LOG.
File to which SMTP queue activity is logged.
/OPTIONS=options
Optional. Defaults: NOEIGHT_BIT, HEADERS, NORELAY.
The following are SMTP options:

EIGHT_BIT, NOEIGHT_BIT
All characters must have the 8th bit clear. Allows the transmission of 8-bit characters.
Header control. Specify one:

HEADERS Headers printed at bottom of messages

NOHEADERS Headers omitted

TOP_HEADERS Headers printed at top of messages

NOTOP_HEADERS Resets TOP_HEADERS to the default

RELAY, NORELAY
Relays mail to other hosts by functioning as an end node.

/POSTMASTER=account
Optional. Default: The SMTP process's account.

Previous Next Contents Index

dddd	= days (0--9999)
h	= hours (0--24)
m	= minutes
s	= seconds
cc	= milliseconds

HEADERS	Headers printed at bottom of messages
NOHEADERS	Headers omitted
TOP_HEADERS	Headers printed at top of messages
NOTOP_HEADERS	Resets TOP_HEADERS to the default

DIGITAL TCP/IP Services for OpenVMSManagement Command Reference

SET COMMUNICATION

Format

SET COMMUNICATION [/ACCEPT=options [ /ALLOW_LOG_OPTIONS=options ] [ /CLUSTER_TIMER=n ] [ /DOMAIN=domain ] [ /FORCE_LOG_OPTIONS=options ] [ /LOCAL_HOST=host ] [ /PROXIES=n ] [ /REJECT=options ] [ /SERVICES=n ]

restrictions

Qualifiers

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

/ALLOW_LOG_OPTIONS=options

/CLUSTER_TIMER=n

/DOMAIN=domain

/LOCAL_HOST=host

/PROXIES=n

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

Examples

SET CONFIGURATION BIND

Format

SET CONFIGURATION [NO]BIND { /CACHE=options /[NO]CLUSTER=names /FORWARDERS=options /PRIMARY=options /SECONDARY=options }

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

SET CONFIGURATION ENABLE SERVICE

SET CONFIGURATION INTERFACE

SET CONFIGURATION MAP

SET CONFIGURATION NAME_SERVICE

Format

SET CONFIGURATION [NO]NAME_SERVICE/[NO]SERVER=host [ /[NO]DOMAIN=domain ] [ /[NO]PATH=domain ] [ /RETRY=number of retries ] [ /TIMEOUT=seconds ] [ /TRANSPORT=protocol ]

Qualifiers

/DOMAIN=domain

/NODOMAIN

/PATH=domain

/NOPATH=domain

/RETRY=number of retries

/SERVER=host

/NOSERVER=host

/TIMEOUT=seconds

/TRANSPORT=protocol

Examples

SET CONFIGURATION PROTOCOL

SET CONFIGURATION SMTP

Format

restrictions

Qualifiers

/ADDRESS_RETRIES=n

/GATEWAY=option=host

/HOP_COUNT_MAXIMUM=n

/INTERVAL= { INITIAL="OpenVMS_delta_time" RETRY="OpenVMS_delta_time" MAXIMUM="OpenVMS_delta_time" }

/LOG=[file]

/NOLOG=[file]

/OPTIONS=options

/POSTMASTER=account

DIGITAL TCP/IP Services for OpenVMS
Management Command Reference

SET COMMUNICATION [/ACCEPT=options
[ /ALLOW_LOG_OPTIONS=options ]
[ /CLUSTER_TIMER=n ]
[ /DOMAIN=domain ]
[ /FORCE_LOG_OPTIONS=options ]
[ /LOCAL_HOST=host ]
[ /PROXIES=n ]
[ /REJECT=options ]
[ /SERVICES=n ]

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

SET CONFIGURATION [NO]BIND { /CACHE=options
/[NO]CLUSTER=names
/FORWARDERS=options
/PRIMARY=options
/SECONDARY=options }

SET CONFIGURATION [NO]NAME_SERVICE/[NO]SERVER=host [ /[NO]DOMAIN=domain ]
[ /[NO]PATH=domain ]
[ /RETRY=number of retries ]
[ /TIMEOUT=seconds ]
[ /TRANSPORT=protocol ]

/INTERVAL=
{ INITIAL="OpenVMS_delta_time" RETRY="OpenVMS_delta_time" MAXIMUM="OpenVMS_delta_time" }