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 ] )
1 – Restrictions
The /SYSTEM qualifier requires the the SYSPRV or BYPASS and
SYSNAM privileges. The /INITIALIZE qualifier requires the BYPASS,
READALL, or SYSPRV privileges.
2 – Qualifiers
2.1 /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.
2.2 /DISABLE
Optional.
Disables the BIND resolver. All name and address lookups are now
directed to the local hosts database. Use with /SYSTEM.
2.3 /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.
2.4 /ENABLE
Optional. Default: Not enabled.
Enables the BIND resolver. Must be used with /SYSTEM.
2.5 /INITIALIZE
Optional. Default: No reloading.
Reloads all BIND server databases and the BIND configuration
file. Either TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be
set up to allow for secure communication between the user and
the BIND server. For more information, refer to the HP TCP/IP
Services for OpenVMS Management manual.
2.6 /PATH
/PATH=domain
/NOPATH=domain
Optional. Requires the SYSNAM privilege.
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.
2.7 /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.
2.8 /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.
2.9 /SYSTEM
Optional. Default: Changes are process specific.
Makes your settings systemwide.
2.10 /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:
If Retries=4
Current settings: and Timeout=4
Retry Timeout interval is:
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
2.11 /TRANSPORT
/TRANSPORT=protocol
Optional. Default: UDP.
Protocol used for communicating with a BIND server. Specify one
of the following:
o UDP
o TCP
o SCTP
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.