IBM Support

PH58009: 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

  •  1) Create a LPA project in ELM.
    

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

    PH58009

  • Reported component name

    CICS TS Z/OS V6

  • Reported component ID

    5655YA100

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-11-06

  • Closed date

    2024-02-19

  • Last modified date

    2024-04-01

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

    PH57383

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

    UI95735

Modules/Macros

  • DFHZTSP
    

Fix information

  • Fixed component name

    CICS TS Z/OS V6

  • Fixed component ID

    5655YA100

Applicable component levels

  • R400 PSY UI95735

       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":"6.1","Line of Business":{"code":"LOB70","label":"Z TPS"}}]

Document Information

Modified date:
04 April 2024