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.