Name resolver configuration file

Rules: The resolver configuration file must follow these rules:

• Each line in the configuration file has a maximum length of 255 characters and consists of a keyword and a value that is separated by one or more white space characters.
• Comment lines begin with # or ;.
• Blank lines are ignored.
• The configuration file must be in the IBM-1047 code page.
• The keywords and their values are not case-sensitive.
• The NSINTERADDR and NAMESERVER keywords can be specified on multiple lines and the name server list includes all the specified addresses.
• The SEARCH keyword can be specified on multiple lines and the domain list includes all the specified names.
• Keywords other than NSINTERADDR, NAMESERVER, and SEARCH should be specified once. If the resolver configuration file specifies one of these other keywords more than once, the LDAP name resolver uses the last occurrence.

The LDAP name resolver uses the following keywords in the resolver configuration file and ignores any other values:

DOMAIN

Specifies the default DNS domain name. The DOMAIN and DOMAINORIGIN keywords are the same and can be used interchangeably. The DOMAIN, DOMAINORIGIN, and SEARCH keywords are mutually exclusive. The search list specified by the SEARCH keyword is deleted if the DOMAIN keyword follows the SEARCH keyword. This keyword is ignored if the LOCALDOMAIN environment variable is defined.

DOMAINORIGIN

Specifies the default DNS domain name. The DOMAIN and DOMAINORIGIN keywords are the same and can be used interchangeably. The DOMAIN, DOMAINORIGIN, and SEARCH keywords are mutually exclusive. The search list specified by the SEARCH keyword is deleted if the DOMAINORIGIN keyword follows the SEARCH keyword. This keyword is ignored if the LOCALDOMAIN environment variable is defined.

NAMESERVER

Specifies the network address of a DNS name server. An IPv4 address is specified in dotted decimal format. An IPv6 address is specified in colon-hexadecimal format. The NSINTERADDR and NAMESERVER keywords are the same and can be used interchangeably.

NSINTERADDR

Specifies the network address of a DNS name server. An IPv4 address is specified in dotted decimal format. An IPv6 address is specified in colon-hexadecimal format. The NSINTERADDR and NAMESERVER keywords are the same and can be used interchangeably.

NSPORTADDR

Specifies the well-known port for the DNS name servers. This is a decimal number and defaults to 53.

RESOLVERTIMEOUT

Specifies the number of seconds to wait for an answer. This is a decimal number and defaults to 5 seconds.

RESOLVERUDPRETRIES

Specifies the number of retries when using UDP (User Datagram Protocol). This is a decimal number and defaults to 1.

SEARCH

Specifies one or more DNS domain names. (Multiple domain names are separated by white space characters.) These domains are searched in order when looking for an LDAP resource name. The DOMAIN, DOMAINORIGIN, and SEARCH keywords are mutually exclusive. The default domain is set to the first domain specified by the SEARCH keyword and replaces a value specified by the DOMAIN or DOMAINORIGIN keyword. This keyword is ignored if the LOCALDOMAIN environment variable is defined.

Example: The following is a sample name resolver configuration file:

    ####################################################################
    #  Sample name resolver configuration file                         #
    ####################################################################
    TCPIPJobname CS390IP     
    DatasetPrefix SHR.CS390IP
    ResolveVIA UDP           
    ResolverTimeout 5        
    NameServer 9.130.77.115  
    NameServer 9.130.40.252  
    NameServer 9.130.40.242  
    Domain endicott.ibm.com