A fix is available
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