OA69340: MESSAGE GZD5317W TCP TRANSPORT FAILED WHEN SERVER_IPADDR IS DEFAULTED ZDMF/K

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The zDMF TCP/IP server task fails to start, printing the
  following messages:
  
  GZD5310W TCP/IP GETNAMEINFO failed: retcode = -1, errno = 1
  GZD5409W TCP/IP errno 1 indicates eDom - Argument too large
  GZD5307I SERVER_IPADDR set to ::
  GZD5308I MULTICAST_IPADDR set to FF08::4:2024
  GZD5317W TCP/IP transport failed
  
  The text of message GZD5409W is misleading; the real cause is
  that no IPv6 address is available.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM z/OS Data Set Mobility      *
  *                 Facility (zDMF) with IPv6 enabled and no     *
  *                 addresses in the IPv6 HOME list.             *
  ****************************************************************
  * PROBLEM DESCRIPTION: In some cases, zDMF fails to initialize *
  *                      TCP/IP connections correctly.           *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  ****************************************************************
  When SERVER_IPADDR is not specified in the Configuration file,
  GZDTC01 determines the default local IP address at start-up. If
  IPv6 is enabled, GZDTC01 calls EZASMI IOCTL SIOCGHOMEIF6 to get
  the IPv6 HOME list. This call can succeed with zero entries when
  the HOME list is empty. GZDTC01 does not check for this
  condition, and saves an all-zero IP address. A later GETNAMEINFO
  call with this address fails with errno 1 (EAI_NONAME). GZDTCP1
  always decodes errno 1 as "eDom - Argument too large", so the
  message does not match the real GETNAMEINFO failure.
  

Problem conclusion

• GZDTC01 has been updated to detect an empty IPv6 HOME list and
  retry initialization using IPv4 instead of an all-zero address.
  
  GZDTCP1 has been updated to correctly decode errno 1 as
  "eAI_NoName - NODE or HOST cannot be found" for a GETNAMEINFO or
  GETADDRINFO failure.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ10017

Modules/Macros

• GZDTC01
  

Fix information

• Fixed component name

  ZDMF

• Fixed component ID

  ZDMF00001

Applicable component levels

• R341 PSY UJ10017

     UP26/07/21 I 1000

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.