IBM Support

PH53568: RLA=Y CONNECTION POOLING ENHANCEMENT

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • Improve performance in a connection pooling environment by
    expanding the reuse of ACEEs in external subsystem (ESS) code.
    This builds on the RLA=Y enhancement that we delivered in
    PH33024 by expanding its scope to two exit routines within ESS.
    The RLA is the Region Level ACEE.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All IMS 15 customers using DB2 connection pooling and the    *
    * External Subsystem Attach Facility (ESAF) to send calls to   *
    * Db2.                                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * Expand the scope of the RLA=Y option in a connection pooling *
    * environment to reduce overhead related to ACEE creation and  *
    * deletion.                                                    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * INSTALL CORRECTIVE SERVICE FOR APAR/PTF.                     *
    ****************************************************************
    Improve performance in a connection pooling environment by
    expanding the use of ACEEs in external subsystem (ESS) code.
    This builds on the RLA=Y enhancement delivered in PH33024 by
    expanding its scope to two exit routines within ESS.  With
    PH33024, when RLA=Y is specified for an Db2 entry in SSM=
    proclib member, the region level ACEE is passed to Db2 at ESS
    Signon if there is no ESAF_SIGNON_ACEE present and no TCB level
    ACEE present.  With PH53568, the region level ACEE will be
    passed at ESS Associate Thread and ESS Create Thread in addition
    to ESS Signon.
    
    When the region level ACEE is used, there is reduced overhead in
    the creation and management of ACEEs because the ACEE is created
    only once and is then available for future use.
    

Problem conclusion

  • The ESS modules that set up the associate thread exit (DFSESAT0)
    and create thread exit (DFSESCT0) are modified to support the
    RLA=Y parameter.  If this parameter has been specified, then the
    setup module passes the Region Level ACEE to the exit.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH53568

  • Reported component name

    IMS V15

  • Reported component ID

    5635A0600

  • Reported release

    500

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-03-28

  • Closed date

    2023-08-22

  • Last modified date

    2023-09-01

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

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

    UI93281

Modules/Macros

  • DFSESAT0 DFSESCT0
    

Publications Referenced
GC19885102    

Fix information

  • Fixed component name

    IMS V15

  • Fixed component ID

    5635A0600

Applicable component levels

  • R500 PSY UI93281

       UP23/08/25 P F308

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":"SSEPH2","label":"IMS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"15","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
22 December 2023