DSNL513I csect TCP/IP GETHOSTBYNAME FAILED WITH ERRNO=errno FOR DOMAIN domain

Explanation

Db2 encountered a TCP/IP gethostbyname socket call error when attempting to convert a TCP/IP domain name into an IP address.
Variable
Description
csect
The CSECT name of the Db2 module that issued the message.
errno
The error condition reported by TCP/IP.
domain
The TCP/IP domain name that Db2 wants to convert into an IP address. Db2 obtains the domain value from the IPADDR column of the SYSIBM.IPNAMES communications database table or from the trusted context ADDRESS attribute defined in the SYSIBM.SYSCTXTTRUSTATTRS catalog table.

System action

If the row in SYSIBM.IPNAMES containing the specified domain in the IPADDR column is invalid, then

  • If the error occurs during DDF startup, the row in SYSIBM.IPNAMES is ignored.
  • If the error occurs during an SQL statement, the SQL statement fails and the location associated with the SYSIBM.IPNAMES row is not available for TCP/IP communication.
If the trusted context ADDRESS attribute containing the specified domain defined in the SYSIBM.SYSCTXTTRUSTATTRS is invalid, then
  • If the error occurs during implicit trusted connection processing, then the error is ignored and the connection is established without any additional privileges.
  • If the error occurs during explicit trusted connection processing, then the connection processing fails.

Operator response

Notify the system programmer.

System programmer response

Correct the IPADDR column value in SYSIBM.IPNAMES or register the domain with TCP/IP. Correct the trusted context ADDRESS attribute value using the SQL ALTER TRUSTED CONTEXT statement. register the domain with TCP/IP.

User response

Notify the system programmer.

Problem determination

See System Programmer Response.