IBM Support

PH57383: ROUTED TRANSACTION FAILS IN AOR WITH DFHSM0002 X'0C09' FOLLOWED BY AN ABENDAEXZ

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • A transaction that is routed to the AOR fails with
    a DFHSM0002 x'0C09' error followed by an abendAEXZ.
    
    x'0C09' is an 'invalid length for TP storage' error.
    
    The trace shows the failure happening on an attempt to GETMAIN
    x'FFF8' bytes of storage for a TIOA :
    
    97226 QR    SM 0C09 SMMG  *EXC*
    
    Invalid_length_on_getmain_for_TP_subpool_storage GETMAIN,FFF8,
    25865B70,YES,00,TERMINAL,SYST
    
    The maximum allowable TIOA length, max_tioa_length is x'FFEB'
    hence the error.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: A user transaction routed to an AOR     *
    *                      failed with a DFHSM0002 x'0C09' error   *
    *                      followed by an abend AEXZ.              *
    ****************************************************************
    A Web transaction using request streams is routed to an AOR
    passing a TIOA of maximum length to send the response back to
    the partner. The length of a Storage Accounting Area and TIOA
    prefix are added to the requested length of the TIOA in the
    process. After the transaction ends, the TIOA is left behind to
    be reused.
    
    Later on, a 3270 terminal transaction passing a CHANNEL enters
    the region on this session. It reuses the previously left behind
    TIOA and requests storage of length X'FFF8'in order to copy the
    TIOA contents from the current link TIOA into a new TIOA.
    The user transaction fails with the exception
    Invalid_length_on_getmain_for_TP_subpool_storage as the GETMAIN
    length is greater than the maximum TIOA length of X'FFEB'.
    
    A DFHSM0002 x'0C09' error is observed in the CICS AOR followed
    by an abend AEXZ.
    

Problem conclusion

  • CICS has been changed to use the correct length on the GETMAIN
    call.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH57383

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    300

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-10-06

  • Closed date

    2024-02-19

  • Last modified date

    2024-04-01

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

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

    PH58009 UI95734

Modules/Macros

  • DFHZTSP
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R300 PSY UI95734

       UP24/03/02 P F403

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":"BU048","label":"IBM Software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.6","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
04 April 2024