IBM Support

PM48597: DFHSO0113 IP ADDRESS CANNOT BE RESOLVED BY GETHOSTBYNAME FUNCTION WHEN USING DD SYSTCPD.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After upgrading to CICSTS4.1 and zOS1.12 we get this:
    FUNCTION(VERIFY_IP_ADDRESS)
    GETADDRINFO_ERROR RETURN_VALUE(-1) RETURN_CODE(1)
    REASON_CODE(78AE1004)
    and during CICS startup message :
    14.13.23 +DFHSO0113 The IP address NN.NNN.NN.NNN cannot be
    resolved to a host name by Gethostbyname function.
    CICS is not using the TCP/IP stack specified in
    the SYSTCPD dataset but instead uses the default
    TCP/IP stack. This results in /etc/resolv.conf
    being used in preference to the SYSTCPD DD statement when
    locating the resolver configuration information.
    
    
    .
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: msgDFHSO0113 issued after upgrading to  *
    *                      CICS TS 4.2.                            *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    z/OS is configured with resolver configuration information in
    /etc/resolv.conf.  This configuration uses DNS servers that
    contain only internal (intranet) addresses.
    
    The CICS JCL contains a SYSTCPD DD statement which specifies
    a dataset member which is a resolver configuration file that
    uses DNS servers that contain external (internet) addresses.
    
    When an application in CICS attempts to connect to a server on
    the internet a DNS lookup is performed to obtain the IP
    address.  The resolver configuration that gets used is from
    /etc/resolv.conf so the name is unable to be resolved and
    message DFHSO0113 gets issued and the request to the remote
    system will fail.
    
    In releases of CICS before CICS TS 4.1 the resolver
    configuration from the SYSTCPD DD statement would have been
    used in this situation and the DNS lookup would have been
    successful.
    

Problem conclusion

  • DFHSOIS has been changed to inform the resolver that this is
    a CICS system and it should use the SYSTCPD DD dataset in
    preference to /etc/resolv.conf when locating the resolver
    configuration information.
    
    TCP/IP APAR PM46927 is required for this change to be effective.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM48597

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-09-26

  • Closed date

    2012-10-09

  • Last modified date

    2012-11-01

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

    PM41626

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

    UK82441

Modules/Macros

  •    DFHSOIS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R700 PSY UK82441

       UP12/10/12 P F210

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 November 2012