PI88972: DFHSO0113 ISSUED MANY TIMES WHEN IT SHOULD BE ISSUED ONLY ONCE PER SITUATION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You find multiple (hundreds or thousands) of DFHSO0113 messages
  issued. DFHSO0113 is issued when CICS gets a bad response to
  its BPX1GNI call.     The message should not be issued again
  until after a successful BPX1GNI
  call had been made, but your CICS region log shows many more.
  .
  Further, message DFHSO0118 was removed at CICS 4.1, but should
  be reinstated and issued again.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVGJT
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message text of DFHSO0113 is incorrect  *
  *                      and no message is issued if TCPIP       *
  *                      BPX1GNI call is slow to respond when    *
  *                      handling EXEC CICS EXTRACT TCPIP        *
  *                      CLIENTNAME command.                     *
  ****************************************************************
  An HTTP request is being processed by a CICS web application.
  The application issues an EXTRACT TCPIP CLIENTNAME command. To
  process this command, DFHSOIS makes a BPX1GNI call to obtain the
  client name from the name server. If BPX1GNI call gets a bad
  response, other than the name not being found, then message
  DFHSO0113 will be issued to report the failure.
  
  The function mentioned in message DFHSO0113 is Gethostbyname
  which is incorrect and should be BPX1GNI.
  
  Additionally, message DFHSO0118 should be issued if the call to
  the name server takes over 3 seconds.  This message is not being
  issued.
  

Problem conclusion

• DFHSOIS has been changed to make sure the message DFHSO0118 is
  issued if BPX1GNI call took over 3 seconds to complete.
  
  DFHMESOE has been changed to make sure the message text of
  DFHSO0113 and DFHSO0118 is correct.
  
  The CICS Transaction Server Version 5 Release 1 Knowledge
  Center will be updated to change the description of message
  DFHSO0113 and DFHSO0118.
  
  Message DFHSO0113 should be changed as following:
  "DFHSO0113  applid The IP address ip_address cannot be resolved
  to a host name by the BPX1GNI function. UNIX System Services
  return code X'retcode', reason code X'rc'.
  
  Explanation: CICS has issued the Unix System Services function
  BPX1GNI to resolve the IP address ip_address to a host name,
  but the call failed.
  
  System action: An exception trace entry is made. CICS will
  continue to attempt to access the name server for subsequent
  requests.
  
  User response: The BPX1GNI function will usually perform a name
  server reverse lookup to resolve the IP address into a host
  name. This can fail if CICS is unable to contact a name server.
  
  If a SYSTCPD DD name has been defined in the CICS job, check
  that the file it references correctly defines the name server.
  If SYSTCPD is not used, then check that the name server defined
  to TCP/IP in the /etc/resolv.conf file is valid and responding
  correctly. You can issue the TSO NSLOOKUP command to query the
  name server. If the name server is defined correctly to CICS,
  then contact the administrator to determine why the IP address
  lookup failed.
  
  The TCP/IP RESOLVERTIMEOUT parameter can be used to control the
  duration of a BPX1GNI call.
  
  Module: DFHSOIS
  Message inserts:
  1. applid
  2. ip_address
  3. X'retcode'
  4. X'rc'
  Destination: Console"
  
  Message DFHSO0118 should be changed as following:
  "DFHSO0118  applid The BPX1GNI call to resolve IP address
  ip_address to a host name took over 3 seconds to complete.
  
  Explanation: CICS has issued the Unix System Services function
  BPX1GNI to resolve the IP address ip_address to a host name.
  This call took more than three seconds. During this time,
  the sockets TCB was blocked, and no socket IO was possible.
  
  System action: CICS continues.
  
  User response: The BPX1GNI function will usually perform a name
  server reverse lookup to resolve the IP address into a host
  name. This call took over three seconds to complete. The
  BPX1GNI function is most commonly driven by EXEC CICS EXTRACT
  TCPIP CLIENTNAME.
  
  If a SYSTCPD DD name has been defined in the CICS job, check
  that the file it references correctly defines the name server.
  If SYSTCPD is not used, then check that the name server defined
  to TCP/IP in the /etc/resolv.conf file is valid and responding
  correctly. You can issue the TSO NSLOOKUP command to query the
  name server. If the name server is defined correctly to CICS,
  then contact the administrator to determine why the IP address
  lookup has not completed within 3 seconds.
  
  The TCP/IP RESOLVERTIMEOUT parameter can be used to control the
  duration of a BPX1GNI call.
  
  Module: DFHSOIS
  Message inserts:
  1. applid
  2. ip_address
  Destination: Console"
  
  Same changes should be made to the CICS Transaction Server
  Version 5 Release 2 Knowledge Center.
  
  Same changes should be made to the CICS Transaction Server
  Version 5 Release 3 Knowledge Center.
  
  Same changes should be made to the CICS Transaction Server
  Version 5 Release 4 Knowledge Center.
  

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:

  UI54476 UI54477 UI54478 UI54479

Modules/Macros

• DFHMESOC DFHMESOE DFHMESOK DFHSOIS
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI54478

     UP18/03/16 P F803

• R100 PSY UI54479

     UP18/03/16 P F803

• R800 PSY UI54476

     UP18/03/16 P F803

• R900 PSY UI54477

     UP18/03/16 P F803

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.