IBM Support

PI62627: TSSC CPSM ABEND AICA WHEN CMAS CYCLED AND MASES WERE ACTIVE

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You recently applied the fix for PI53745 (4.2), PI54032
    (5.1/5.2) or PI54799 (5.3). Now, if you cycle a CMAS while it
    has active MASes connected to it, transaction TSSC may AICA in
    the CMAS when it restarts and begins reconnecting the MASes.
    .
    In the CMAS job log, you may see
    .
    EYUXL0905E cmasname  AICA IN XQLK, OFFSET 00000136 PSW=078D4000
    95E2DA16
    EYUXL0905E INTC=0002 ILC=2 TXCP=0002D001 SCODE=S????
               TRAN=TSSC TASK=0012345
    EYUXL0905E Methods=XQLK,XQGQ,XCLL,TSRA,TSSC,XLOP
    .
    .
    The methods listed in the Methods= message may be anywhere in
    the process, and may only show up to XCLL, or XQGQ, depending
    upon where things were when CICS stepped in to AICA the task.
    .
    The MASes will fail to CONNECT, and you will
    .
       EYUTS0002E Topology Connect for <masname> Failed
    .
    messages.
    .
    .
    Additional Symptom(s) Search Keyword(s): KIXREVSVR
    

Local fix

  • Avoid cycling the CMAS while there are MASes active and
    CONNECTed directly to it. A USERMOD may also be available from
    the Change Team
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V5R1M0 and V5R2M0 Users      *
    ****************************************************************
    * PROBLEM DESCRIPTION: After applying PTF UI34592 (V5R1M0) or  *
    *                      UI34593 (V5R2M0) for APAR PI54032,      *
    *                      errors may occur if BAS has been used   *
    *                      to install TRNCLDEF records in a MAS,   *
    *                      and the CMAS that the MAS is connected  *
    *                      to is restarted while the MAS remains   *
    *                      active.                                 *
    *                                                              *
    *                      The most common error is an abend AICA  *
    *                      in the Topology connect task for the    *
    *                      MAS, running under transaction TSSC.    *
    *                      The abend will show as occurring in     *
    *                      method EYU0XCLL (XCLL), or in a method  *
    *                      called from XCLL.  The AICA will cause  *
    *                      the Topology connect to fail, resulting *
    *                      in message EYUTS0002E.                  *
    *                                                              *
    *                      If the AICA does not occur and the MAS  *
    *                      connects successfully, TRNCLDEF entries *
    *                      in the BAS installed resource list for  *
    *                      the MAS may be removed invalidly.  This *
    *                      can result in various errors with       *
    *                      subsequent installs of TRNCLDEFs in the *
    *                      MAS until it is restarted.              *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be restarted.  Note    *
    *                 that the restarts do not need to occur at    *
    *                 the same time.                               *
    ****************************************************************
    When a MAS connects to a CMAS, method EYU0TSRA (TSRA) is called
    in the CMAS to build Topology resource maps (CRESxxxx records)
    for most CICS resources in the MAS.  When the CMAS is restarted
    while the MAS remains active, TSRA also performs normalization
    of BAS TRNCLDEF resources installed in the MAS, checking to see
    if any have been discarded in the MAS while the CMAS was down.
    
    The changes made in PTF UI34592 and UI34593 did not properly
    update the routine that performs the normalization process.  If
    the MAS does not have any TRNCLDEFs installed through BAS, then
    this routine is not called and no errors will occur.  However,
    if TRNCLDEFs were installed through BAS for the MAS, then the
    normalization routine will get control, and the errors described
    above may occur.
    

Problem conclusion

  • The TRNCLDEF normalization process routine in TSRA has been
    updated to allow for the changes made for UI34592 and UI34593.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI62627

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    90M

  • Status

    CLOSED PER

  • PE

    YesPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-05-17

  • Closed date

    2016-05-24

  • Last modified date

    2016-06-02

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

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

    PI62636 PI62637 UI38109 UI38110

Modules/Macros

  • EYU0TSRA
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80M PSY UI38109

       UP16/05/26 P F605 ­

  • R90M PSY UI38110

       UP16/05/26 P F605 ­

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

Document Information

Modified date:
02 June 2016