IBM Support

PI13846: REINSTALL OF A CHANGED TRANGRP REMOVES THE TRANSACTIONS LINKED TO THIS TRANGRP

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Customer modified a TRANGRP attribute and tries to install the
    corresponding WLMDEF while the WLMDEF and the TRANGRP where
    active.
    This is not allowed and the install fails with the messages:
    EYUVC1231E 'Install' (INSTALL) request failed. Request complete
                for 1 records. (Tableerror, Dataerror)
    EYUVC1272I Action (INSTALL) failed. Parameters ignored (25).
    ...
    In the CMAS Log:
    EYUWM0426I IV3A68CM Transaction Group (LOOPPC) already
      installed in Workload (CICSTEAM) - parameter ignored.
    ...
    This is works as designed and described in the Info Center.
    But the installation of the WLMDEF with the modified TRANGRP
    causes as well that the transactions linked to this TRANGRP
    are discarded.
    The following message appears for each transaction in
    the CMAS log:
    EYUWM0443I IV3A68CM Dynamic transaction (LOO1) discarded from
               transaction group (LOOPPC) in CICSplex (PLX51VS6)
               for workload (CICSTEAM).
    

Local fix

  • *
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICSPlex SM V5R1M0 Users                 *
    ****************************************************************
    * PROBLEM DESCRIPTION:    You modify attributes of a TRANGRP   *
    *                      which is currently active, and try to   *
    *                      reinstall the corresponding WLMDEF.     *
    *                      This is not allowed and the install     *
    *                      fails with the messages:                *
    *                                                              *
    *                           EYUVC1231E 'Install' (INSTALL)     *
    *                                request failed. Request       *
    *                                complete for 1 records.       *
    *                                (Tableerror, Dataerror)       *
    *                           EYUVC1272I Action (INSTALL)        *
    *                                failed. Parameters ignored    *
    *                                (25).                         *
    *                                                              *
    *                      The following message appears in the    *
    *                      CMAS joblog:                            *
    *                                                              *
    *                           EYUWM0426I  Transaction Group      *
    *                                (trangrp) already installed   *
    *                                in Workload (workload) -      *
    *                                parameter ignored.            *
    *                                                              *
    *                      This is working as designed.  However   *
    *                      the installation of the WLMDEF with the *
    *                      modified TRANGRP causes all active      *
    *                      transactions (WLMATRANs) linked to this *
    *                      TRANGRP to be discarded.  The following *
    *                      message appears in the CMAS joblog for  *
    *                      each active transaction:                *
    *                                                              *
    *                           EYUWM0443I  Dynamic transaction    *
    *                                (tran) discarded from trans-  *
    *                                action group (trangrp) in     *
    *                                CICSplex (cicsplex) for       *
    *                                workload (workload).          *
    ****************************************************************
    * RECOMMENDATION: After applying the PTF that resolves this    *
    *                 APAR, all CMASes must be recycled to pick    *
    *                 up the new code.  Note that regions do not   *
    *                 need to be brought down and restarted at     *
    *                 the same time.                               *
    ****************************************************************
       When module EYU0WMWI (WMWI - Install WLMDEFs in Active Work-
    load) is called to reinstall a WLMDEF it is passed a list con-
    taining the WLMDEF resource, a list containing the TRANGRP named
    in the WLMDEF, and a list of all DTRINGRPs for the TRANGRP.
    First we look at the WLMDEF to see if it is already active, and
    if any of the attributes which cannot be changed in an active
    workload, have been changed.  If it is not already active then
    we install it.
       Next we rescan the WLMDEF list, retrieve the element from the
    TRANGRP list for the TRANGRP named in the WLMDEF, and see if it
    is already active.  If it is active, we make sure that no attri-
    bute that cannot be changed has changed.  If one or more of the
    invariant attributes has been changed, we reject the install and
    remove DTRINGRP resources associated with this TRANGRP from the
    input DTRINGRP list, to prevent them from being processed.
       Finally, we rescan the list of WLMDEFs again, and retrieve
    all the WLMATRANs (Transaction in an active workload) for the
    TRANGRP named in the WLMDEF.  We check to see if each active
    transaction is in the incoming DTRINGRP list.  If it is, we
    remove it from the incoming list so it won't be reinstalled.
    If it is not in the DTRINGRP list, we assume that the DTRINGRP
    was removed, so we discard the WLMATRAN.  When we are finished,
    any DTRINGRPs remaining in the input list are new, and we in-
    stall them, removing each DTRINGRP resource from the list as it
    is processed.
       When a TRANGRP install was rejected because the value of one
    or more attributes changed, we removed all associated DTRINGRPs
    from the DTRINGRP list.  When we have retrieved the WLMATRANs
    for this TRANGRP, we then look in the DTRINGRP list for each
    one, and because we removed each element from the input DTRINGRP
    list when we rejected the TRANGRP reinstall, we assume that the
    DTRINGRPs were removed and we DISCARD each of the active trans-
    actions.
    

Problem conclusion

  • Module EYU0WMWI was modified to add each TRANGRP whose re-
    install was rejected because one or more attributes changed, to
    the list of TRANGRPs to be bypassed in the following DTRINGRP
    scan.
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PI13846

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-03-18

  • Closed date

    2014-04-08

  • Last modified date

    2015-03-05

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

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

    PI13977 UI16841

Modules/Macros

  • EYU0WMWI
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R80M PSY UI16841

       UP14/04/11 P F404 ½

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

Document Information

Modified date:
05 March 2015