IPRESOLV


   .-IPRESOLV--=--(0)-----.   
>>-+----------------------+------------------------------------><
   '-IPRESOLV--=--(0-255)-'

statements:

PORT

dependencies:

MEDIUM=HPRIP

range:

0–255

Specifies the number of seconds VTAM® waits for name-to-address resolution requests to complete before canceling the request. The default is 0 seconds, meaning VTAM will wait indefinitely for resolution to be performed. Any value from 0 to 255 seconds can be specified.

If a nonzero value is specified for IPRESOLV, the value should be chosen after giving consideration to the values defined for resolver timeouts on the TCP/IP stack (RESOLVERTIMEOUT directive in the TCPIP.DATA configuration file), the number of retries attempted (RESOLVERUDPRETRIES directive in the TCPIP.DATA configuration file), and the number of domain names that can be appended to the host name while performing name-to-address resolution (SEARCH or DOMAINORIGIN directive in the TCPIP.DATA configuration file). If a large timeout is specified for RESOLVERTIMEOUT, a number of retries is specified for RESOLVERUDPRETRIES, and/or a large number of domains is specified on SEARCH or DOMAINORIGIN, the resolver might take some time to complete the name-to-address resolution attempt, so IPRESOLV should be set to value large enough to allow the resolver to complete its processing. See z/OS Communications Server: IP Configuration Reference for details on the resolver directives.

Alternatively, you might want to ensure that the hostname being resolved (the HOSTNAME operand on the GROUP statement, or the HOSTNAME start option value) is defined in the local hosts files on this system, and then specify LOOKUP LOCAL DNS in the TCPIP.DATA configuration file to ensure that local hosts files are searched first (see z/OS Communications Server: IP Configuration Reference for details about the LOOKUP resolver directive). Coding LOOKUP LOCAL DNS affects all resolver searches, not just Enterprise Extender searches initiated by VTAM, so this option should be chosen with caution.

Note:

The IPRESOLV keyword has been set to a default value of zero because in most cases it is desirable to establish the amount of time allowed before hostname resolution timeout by using the value in the TCP/IP configuration statements. Reset this value only when a VTAM hostname resolution time limit is required.
The RESOLVERUDPENTRIES option is applicable only when the resolver is communicating with the name server using the UDP protocol. (This is the default communication method and is specified with the RESOLVEVIA TCPIP.DATA statement.)