DIGITAL TCP/IP Services for OpenVMS
Management Command Reference


Previous Contents Index

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.


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:

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

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

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:


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:

You can configure the BIND server:

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:

If you use /CACHE with no options:

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

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


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:

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:

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


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.

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

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

/POSTMASTER=account

Optional. Default: The SMTP process's account.


Previous Next Contents Index