PK38480: MSGDFHSO0001 CICQC01R AN ABEND (CODE 0C4/AKEA) HAS OCCURRED AT OFFSET X'1AA2' IN MODULE DFHSOIS ON A TCPIP IMMEDIATE SHUTDOWN.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• MSG DFHSO0001 CICQC01R An abend (code 0C4/AKEA) has occurred at
  offset X'1AA2' in module DFHSOIS when doing a TCPIP IMMEDIATE
  SHUTDOWN.
     During an immediate an ECI over TCPIP request is received.
  A CIEP transaction is attached. This task is then doing a
  PROCESS_ECI_FLOW which results is a SOIS INQUIRE. To perform the
  INQUIRE it needs Shared access to the SOLOCK which is currently
  held exclusively by CSOL.
  While the CIEP task is waiting for the lock, CSOL frees the STE
  associated with the task because of the CEMT TCPIPS IMMCLOSE.
  A new task now gets control, and attempts to access the
  user_token which should be in the socket addressed by the STE,
  and because the STE pointer is now zero due to being freed,
  the ABEND0C4 occurs.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend 0C4 in DFHSOIS when issuing a     *
  *                      CEMT SET TCPIPSERVICE IMMCLOSE.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An ECI request is received during the processing of a CEMT SET
  TCPIPSErvice IMMCLOSE. The resultant CIEP task issues a
  SOIS_INQUIRE to request a user_token and is suspended due to
  SOLOCK being held by CSOL whilst it processes the IMMCLOSE. When
  CIEP is resumed CSOL has deleted the STE associated with the
  task and set the address to zeros. The checking routine,
  sois_check_tokens, called by the inquire, does not check that
  the STE address is valid for a user token, before using it. This
  results in the 0C4 abend.
  Additional keywords: ABEND0C4 S0C4 abendS0C4 0C63 AKEA
  EUNATCH DFHSO0102 msgDFHSO0102 DFHIE1104 msgDFHIE1104
  

Problem conclusion

• Routine sois_check_tokens has been changed to check the validity
  of the STE pointer when sois_user_token has been supplied.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  PK39270 UK22814

Modules/Macros

•    DESSOIS  DFHSOIS
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK22814

     UP07/03/13 P F703

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.