IBM Support

PH12370: DFHSJ0001 AN ABEND (CODE 0C4/AKEA) HAS OCCURRED AT X'4EF2' IN MODULE DFHSJJS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • After an upgrade to CICS 5.4, customer is getting abends related
    to their Liberty JVM.
    
    They deploy the applications by disabling the application
    bundle, discarding it and reinstalling it again.
    
    There, they get following error message:
    DFHSJ0001 An abend (code 0C4/AKEA) has occurred at
    offset
    X'4EF2' in module DFHSJJS.
    
    In the trace, we can see that we fail on :
    SJ    T800D XM 1102 XMAT  EXIT  TERMINATE_TRANSACTION/OK
    RET-AB64B4A0 14:58:23.2923232763 00.0000002998 =0327785
    
    SJ    T800D SJ 0B02 SJJS  EXIT  TERMINATE_TRANSACTION/OK
    RET-640FE763 14:58:23.2923234233 00.0000001469 =0327786
    
    SJ    T800D SJ 0B01 SJJS  ENTRY SWITCH_PTHREAD_CONTEXT
    NEW_USERID()
    RET-640FE763 14:58:42.9728876308 19.6805642075*=0342967
    
    SJ    T800D SJ 0B05 SJJS  *EXC* RECOVERY_ENTERED
    FUNCTION(SWITCH_PTHREAD_CONTEXT) NEW_USERID()
    

Local fix

  • NA
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: ABEND0C4 in DFHSJJS when processing a   *
    *                      SWITCH_PTHREAD_CONTEXT call outside of  *
    *                      a CICS task.                            *
    *                                                              *
    *                      ABEND AKEA in DFHSJIN during task       *
    *                      termination of a Liberty task.          *
    ****************************************************************
    CICS has a Liberty JVM server with the cicsts:link-1.0 feature
    active.  At least one Link to Liberty application is installed.
    
    It is possible for Liberty to call the CICSThreadIdentityService
    outside of a CICS task.  If this happens on a thread that
    previously ran a Link to Liberty request, then an abend 0C4 can
    occur in DFHSJJS FUNCTION(SWITCH_PTHREAD_CONTEXT).
    
    If a Link to Liberty task runs on a thread that was previously
    used for an internal Liberty function (e.g. config refresh) and
    the task uses DB2 then the following error is seen at task
    termination;
    
    "T2zos®T2zosCicsApi.checkApiStatus: Thread is not CICS-DB2
    compatible: CICS_REGION_BUT_API_DISALLOWED"
    
    When the next Liberty task uses this thread an abend AKEA will
    occur in DFHSJIN when attempting to clean up the task state at
    the end of the task.
    

Problem conclusion

  • The CICS Link to Liberty code has been updated to correctly
    manage the state of the thread in these problem scenarios.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH12370

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-05-22

  • Closed date

    2019-07-08

  • Last modified date

    2019-08-01

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

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

    UI64102 UI64103

Modules/Macros

  • DFJ@H356 DFJ@H417 DFJ@H467
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R10D PSY UI64102

       UP19/07/10 P F907

  • R200 PSY UI64103

       UP19/08/01 P F907

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":"5.4","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":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 August 2019