IBM Support

PM44114: EYUCL0117E MESSAGE FLOOD IF CMAS STAYS IN SOS SITUATION AND CPSM UNABLE TO EXTEND LINK BUFFER POOL

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Your CPSM CMAS is under stress and goes Short On Storage. During
    that SOS episode, If CPSM needs to extend the Link Buffer Pool
    and can not do so due to the SOS situation, a flood of
    EYUCL0117E messages may occur until the SOS condition is
    relieved.
    .
    Additional Keywords and Symptoms
    DFHSM0133 EYUCL0117E Insufficient ECDSA SMSHRC31
    KIXREVNDB
    

Local fix

  • Take an SVC dump of the CMAS, ESSS, ESSS Dataspaces, and then
    cycle the CMAS.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V4R1M0 and V4R2M0 Users      *
    ****************************************************************
    * PROBLEM DESCRIPTION:    Your CPSM CMAS is under stress and   *
    *                      goes Short On Storage.  During that     *
    *                      SOS episode, if CPSM needs to expand    *
    *                      the Link Buffer Pool and can not do so  *
    *                      because of the SOS situation, message   *
    *                                                            . *
    *                         EYUCL0117E Insufficient ECDSA        *
    *                           storage to expand link buffer      *
    *                           pool                               *
    *                                                            . *
    *                      might be issued repeatedly, flooding    *
    *                      the system console until the SOS con-   *
    *                      dition is relieved.                     *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be recycled to pick    *
    *                 up the new code.  Note that the restarts     *
    *                 do not need to be done at the same time.     *
    ****************************************************************
       When an indirect connection exists between two CMASes by
    way of a third, intermediate, CMAS, and one of the endpoint
    CMASes is unable to receive communications for a period of
    time, messages from the other endpoint are queued in the inter-
    mediate CMAS until they can be delivered.  This might cause a
    communications buffer shortage in the intermediate CMAS which
    is normally resolved by GETMAINing a block of CICS storage to
    expand the buffer pool.  If CICS is not able to service the
    GETMAIN because a Short On Storage condition exists, message
    EYUCL0117E is issued.  If the Short On Storage condition is
    not resolved, the CMAS joblog and system console might receive
    a flood of messages.
    

Problem conclusion

  •    Modules EYU0CLBE (CLBE) and EYU0CLBL (CLBL), called to expand
    the COM Link Buffer Pool, were modified to set a flag in the COM
    Major Object Environment Block (MOEB) when message EYUCL0117E is
    issued, and to test the flag to insure that the message will not
    be sent if it has been sent previously.  A counter was added to
    the LPROT segment of the COM MOEB to track the number of times
    a buffer pool expand request failed.  Module EYU0CSGT (CSGT -
    COM Garbage Collection Long Running Task) was modified to clear
    the flag when a Short On Storage condition is relieved.  The net
    effect of these changes is to cause message EYUCL0117E to be
    issued only once for each occurrence of a Short On Storage con-
    dition in the CMAS.  CLBE and CLBL will also request a CPSM dump
    the first time that message EYUCL0117E is issued during each
    execution of a CMAS.  The dump title will begin "EYU0XZPT Dump".
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM44114

  • Reported component name

    CICS TS Z/OS V4

  • Reported component ID

    5655S9700

  • Reported release

    60M

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / CST

  • Submitted date

    2011-07-20

  • Closed date

    2011-09-08

  • Last modified date

    2011-10-11

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

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

    UK71736 UK71737

Modules/Macros

  •    EYURCOEB EYU0CLBE EYU0CLBL EYU0CSGT
    

Fix information

  • Fixed component name

    CICS TS Z/OS V4

  • Fixed component ID

    5655S9700

Applicable component levels

  • R60M PSY UK71736

       UP11/09/15 P F109

  • R70M PSY UK71737

       UP11/09/15 P F109

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

Document Information

Modified date:
11 October 2011