APAR status

• Closed as program error.

Error description

• An AMODE64 application issues a resolver call when the RESOLVER
  address space has been shut down.  The call should fail with
  retval -1 and retcode 2 ( TRY_AGAIN / EAI_AGAIN ). Instead, the
  call is failing with retval 0. If the application tries to use
  the addrinfo that is passed back, it could cause the application
  to take an abend0c4.
  .
  KEYWORDS: getaddrinfo getnameinfo AMODE 64
  .
  VERIFICATION STEPS:
  Check the log to see if the resolver address space has been
  shut down.  And, an application issuing resolver calls is not
  getting the expected error retcode back on the resolver calls.
  

Local fix

• Do not shut down the resolver address space while the
  application is still making resolver calls.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release(s) 9, 10, and     *
  *                 11 IP: Resolver                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A 64-bit resolver API call while the    *
  *                      resolver address space is not active    *
  *                      does not complete with an error         *
  *                      return code. This could lead to an      *
  *                      application incorrectly using what      *
  *                      it thinks is returned data.             *
  *                      Referencing the data could cause a      *
  *                      S0C4 ABEND.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The resolver's nucleus module was not updating its Return
  Value parameter with a -1 when the resolver address space was
  not active. Without the failure indication 64-bit API users
  would not receive an error return code (TRY_AGAIN or EAI_AGAIN)
  This error was only for 64-bit API users.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

• The resolver is amended to correctly return a failure return
  value when the resolver address space is not active.
  
  ****************************************************************
  * FUNCTION AFFECTED: Communications Server TCP/IP (PM00362)    *
  *                     Resolver                                 *
  ****************************************************************
  * DESCRIPTION      : IPL                                       *
  ****************************************************************
  * TIMING           : Post-APPLY                                *
  ****************************************************************
  The nucleus resident module, EZBRECST, is changed by this fix.
  To pickup its fix an IPL must be done after the SMP/E APPLY of
  this PTF.
  
  
  * Cross Reference between External and Internal Names
  

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:

  UK52203 UK52204 UK52205

Modules/Macros

•    EZBRECST
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1A0 PSY

     UP

• R1B0 PSY

     UP

• R190 PSY

     UP

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Product categories:

Software

Networking

Enterprise Connectivity

z/OS Communications Server

All

Operating system(s):

z/OS

Software version:

1B0

Reference #:

PM00362

IBM Group:

IBM Server Group

Modified date:

2009-11-23