IBM Support

PH37147: MAS REGION IS NOT REGISTERED TO A CMAS WORKLOAD AFTER CHANGE IT FROM LPAR. MESSAGES EYUNL0160I & EYUWI0020I ARE NOT ISSUED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • MAS region that is not registered to a CMAS workload after
    change it from an LPAR to another. The registration only happens
    when customer use COSH/COLM transaction.
    
    MAS log the following messages are issued when it is connected
    to CMAS:
    
     EYUCL0012I Connection of XXXXXXX to YYYYYYYY complete.
     EYUTS0003I Topology Connect for XXXXXXXX Complete - APPLID
                (XXXXXXXX) CICSplex(ZZZZZZZZ).
    
    But messages:
    
     EYUNL0160I Workload registration complete.
     EYUWI0020I WLM Routing initiated for workload(WWWWWWWWW) in
                Routing Region(XXXXXXXX)
    
    are not issued until you use COSH/COLM transaction. It is not
    the expected behaviour.
    

Local fix

  • Use COSH/COLM transaction to complete the Workload registration.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS CPSM users                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: A MAS is shut down, and restarted.      *
    *                      During the restart the MAS connects     *
    *                      to a different CMAS from where it       *
    *                      was previously connected.               *
    *                      The MAS does not connect to             *
    *                      workload manager as a routing region.   *
    ****************************************************************
    * RECOMMENDATION: Apply the fix and recycle CMASes in any      *
    *                 order when convenient to implement.          *
    ****************************************************************
    When a CMAS performs a CPSM CMAS warm restart, it sets all the
    MASes it knows were previously attached to other CMASes to
    lost connection status. It does not note if these MASes were
    stopped prior to the point where the CMAS was shut down.
    If one of these MASes then restarts and connects directly
    to this CMAS then WLM restart is not performed, and the
    MAS does not rejoin the workload.
    Messages EYUNL0160 and EYUWI0020 are not issued by the MAS:
    +EYUNL0160I applid Workload registration complete.
    +EYUWI0020I applid WLM Routing initiated for Workload(workname)
     in Routing Region(sysname).
    

Problem conclusion

  • The CMAS Topology warm restart code in method EYU0TIWS has
    been modified to test the last known state of MAS systems.
    This allows the CMAS to detect when a MAS has connected
    locally having previously been connected to a different
    CMAS. This allows for WLM restart to function as expected.
    

Temporary fix

Comments

  • ×**** PE22/02/22 FIX IN ERROR. SEE APAR PH44348  FOR DESCRIPTION
    ×**** PE22/12/07 FIX IN ERROR. SEE APAR PH51351  FOR DESCRIPTION
    

APAR Information

  • APAR number

    PH37147

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-05-12

  • Closed date

    2021-06-28

  • Last modified date

    2023-01-09

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

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

    UI76097 UI76098 UI76099

Modules/Macros

  • EYU0TIWS
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R10M PSY UI76099

       UP21/06/30 P F106

  • R20M PSY UI76098

       UP21/06/30 P F106

  • R30M PSY UI76097

       UP21/06/30 P F106

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

Document Information

Modified date:
09 January 2023