IBM Support

PH32792: ABEND X'030F' IN MODULE DFHSMGF AFTER LIBERTY JVMSERVER ENABLED

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A Liberty JVMSERVER is abnormally terminated whilst processing
    JTA transactions.  When restarted JTA recovery is triggered for
    the inflight transactions.  Multiple CJLR tasks run successfully
    as system tasks under the region user ID.
    
    However a further CJLR task is incorrectly attached as user task
    under the default user ID.  If the default user ID is not
    permitted to run CJLR then the task fails.  The JVMERR file
    shows a BUILD_TRANSACTION call failed with reason MSG_ISSUED.
    
    The problem is that CICS failed to classify a JTA related
    Runnable as being a system task.
    
    Following the failure the error handling code attempts two
    freemains of the SJLRB control block.  The second fails with
    code X'030F' in module DFHSMGF.
    

Local fix

  • Alternatively, the customer can circumvent the problem by
    temporarily allowing their default user ID to run CJLR
    transactions.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: On restart of a JVMSERVER with in-doubt *
    *                      JTA transactions, abend X'030F' occurs  *
    *                      in module DFHSMGF.                      *
    ****************************************************************
    During start of a Liberty JVMSERVER, previous 'in-doubt' JTA
    transactions are identified and recovered appropriately. For
    CICS resources, this results in CICS supplied transaction CJLR
    being run. This runs as a system task to locate the xid's
    related to the JTA transaction. However to complete the recovery
    process, CJLR is issued again, incorrectly running under the
    regions default user id. If the default user id used is not
    authorised to run CJLR, the recovery will fail and authorisation
    errors may be seen :
     - CWWKE0700W in the server message log, including 'user ID
        not authorised'
     - RACF authorisation failure ICH408I for default user id, and
        transaction CJLR
    
    As a result of the failure, due to authorized error, the request
    block for this action, SJLRB, is freed in  DFHSJXM. However, due
    to the error DFHSJJS later attempts to free the SJLRB again.
    This uses DFHSMGF. Due to the block previously being freed, the
    freemain fails, with abend X'030F' in DFHSMGF with message
    DFHSM0002 :
      +DFHSM0002 A severe error (code X'030F') has occurred in
       module DFHSMGF.
    

Problem conclusion

  • CICS has been changed to ensure that the CJLR task is attached
    as a system task.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH32792

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    200

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-12-17

  • Closed date

    2021-05-04

  • Last modified date

    2021-06-01

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

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

    UI75209 UI75210

Modules/Macros

  • DFJ@H387
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R200 PSY UI75210

       UP21/05/06 P F105

  • R300 PSY UI75209

       UP21/05/05 P F105

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.

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.5"}]

Document Information

Modified date:
03 June 2021