A fix is available
APAR status
Closed as program error.
Error description
The WLM default algorithm type is not modifiable dynamically. The updated workload specification cannot take effect immediately unless you also stop and then restart both the routing region with which the workload specification is associated and the target regions to which the routing region routes transactions at the same time.
Local fix
*
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: The WLM default algorithm type is * * not dynamically modifiable. In order * * to update the default algorithm for an * * active workload, to take advantage of * * the new Link Neutral algorithms LNGOAL * * and LNQUEUE, you must bring down all * * routing and target regions in the work- * * load at the same time, insuring that * * the active workload is terminated. * * Then the algorithm must be updated in * * the WLMSPEC definition. When the first * * target region belonging to the workload * * is restarted, the new default algorithm * * will be used. * * * * If an action on a resource which is * * part of an active workload is entered * * through an API program or a WUI server * * connected to a CMAS which does not take * * part in managing the workload, the re- * * quest will fail. The API program will * * receive one of the following response * * and reason pairs: * * TABLEERROR / DATAERROR * * or * * FAILED / EXCEPTION * * A WUI user could receive one of the * * following messages: * * EYUVC1287W The workload to which the * * request is directed is not * * available. * * or * * EYUVC1231E 'Action' (APIact) request * * failed. Request was for nn * * records (Failed, Exception) * * * * If an action on a resource which is * * part of an active workload is entered * * through an API program or a WUI server * * connected to a CMAS which takes part * * in managing more than one workload, the * * action might be applied to the wrong * * workload. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all CMASes and MASes configured as WUI * * servers must be recycled to pick up the new * * code. * * * * The restarts need not be performed at the * * same time, however if systems are not re- * * started at the same time, the following * * rules apply: * * * * - Maintenance Point (MP) CMASes must be re- * * started with updated libraries before any * * non-MP CMASes which connect directly or * * indirectly to them. * * * * - If you have more than one MP CMAS and any * * of those MP CMASes are connected directly * * or indirectly, then those MP CMASes must * * be restarted at the same time. * * * * - A CMAS must be restarted with updated * * libraries before any MASes which connect * * to it. * * * * If a CMAS executing from a library to * * which the PTF resolving this APAR is applied * * connects, directly or indirectly, to a CMAS * * executing CICSPlex SM for CICS Transaction * * Server V3.1, CICSPlex SM for CICS Trans- * * action Server V3.2, or CICSPlex SM for CICS * * Transaction Server V4.1, the PTFs which re- * * solve the following APARs must be applied to * * the appropriate target libraries, and the * * lower level CMASes must be restarted before * * attempting to set the algorithm type for any * * active workloads. * * * * - CTS 3.1 - CICSPlex SM 3.1.0 - APAR PM58230 * * - CTS 3.2 - CICSPlex SM 3.2.0 - APAR PM58225 * * - CTS 4.1 - CICSPlex SM 4.1.0 - APAR PM58219 * * * * Once a MAS which is configured as a WUI * * server has been restarted, then users of the * * CICSPlex SM supplied starter set viewsets * * and menus must reimport the updated starter * * set EYUSTARTWLMAWORK viewset into the WUI * * server's repository in order to pick up the * * changes. * * * * The viewset can be reimported either via * * the AUTOIMPORTDSN and AUTOIMPORTMEM WUI * * server initialization parameters or the * * IMPORT (from a dataset) function of the COVC * * WUI control transaction. * * * * If COVC is used to reimport the viewset, * * insure that the TYPE operand is set to ALL * * or VIEWSET, and that the Import option is * * set to OVERWRITE. * * * * Users who have copied the IBM supplied * * starter set viewsets and menus to another * * name will have to manually apply the changes * * made by the PTF that resolves this APAR to * * those copies. * * * * For details on the AUTOIMPORTDSN and * * AUTOIMPORTMEM WUI server initialization * * parameters see 'Specify the Web User Inter- * * face server initialization parameters' in * * the "CICS Transaction Server for z/OS * * Version 4 Release 2 Installation Guide" * * (GC34-7171). * * * * For details on the COVC IMPORT function * * see 'The CICSPlex SM Web User Interface * * Transaction (COVC)' in the "CICS Transaction * * Server for z/OS Version 4 Release 2 CICSPlex * * SM Web User Interface Guide" (SC34-7214). * * * * The Updated starter set viewset name * * which needs to be imported is: * * * * EYUSTARTWLMAWORK ViewSet : EYUxA1WZ * * * * Replace x with the required language version * * to be imported: * * E - English, K - Japanese, S - Chinese. * * * * Insure that the import references the * * SEYUVIEW dataset that was updated by the PTF * * that resolves this APAR. * **************************************************************** The WLMAWORK (Active Workloads) resource table does not support dynamic updating of the default routing algorithm. Module EYU0XDW1 (XDW1 - API SET Command Processor) executes requests for resources associated with an active workload in the local CMAS. If the local CMAS manages the target workload, the request will complete. If the workload is not managed by the local CMAS, the request will fail. Modules EYU0XDW1 and EYU0XDP4 (XDP4 - API PERFORM Command Processor) build a namelist identifying the resources to be processed by the action method. The namelist is sorted by tar- get CMAS and resource key, and module EYU0MOMS (MOMS - MOS MAL Services) is called to deliver the request to the appropriate CMASes. Action methods which execute actions against resources in an active workload expect to be called to process requests for a single active workload. If the incoming namelist contains resources in more than one workload, all actions will be applied to the first active workload in the namelist. That is, the active workload with the lowest alphanumeric name. If resources with the same name exist in more than one active workload, the action may be performed against the wrong resource instance.
Problem conclusion
The WLMAWORK resource table was updated to support the SET action for attribute ALGTYPE. Modules EYU0WAUT (WAUT - Set Active TRANGRP Attributes) and EYU0WMUT (WMUT - Modify Attri- butes for Active TRANGRP) were modified to support SET directed at the WLMAWORK resource. The EYUSTARTWLMAWORK WUI viewset was modified to support SET for the default routing algorithm. Module EYU0XDW1 was modified to send SET requests against resource associated with an active workload to the closest CMAS which manages the target workload. Modules EYU0XDW1 and EYU0XDP4 were modified to call EYU0MOMS separately for each active workload in an action namelist, so the action method in the target CMAS will be called for each active workload.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM57525
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
70M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2012-02-07
Closed date
2012-05-22
Last modified date
2012-06-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK78963
Modules/Macros
EYUA2483 EYUC2483 EYUEA1WZ EYUE2483 EYUKA1WZ EYUK2483 EYUL2483 EYUP2483 EYUSA1WZ EYUS2483 EYUT2483 EYUY2483 EYU0WAUT EYU0WMUT EYU0XDP4 EYU0XDQA EYU0XDW1 EYU9WMPU EYU9WMP3 EYU9WMP4 EYU9WMRU EYU9WMR3 EYU9WMR4
| SC34720501 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R70M PSY UK78963
UP12/05/24 P F205
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.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":"4.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
03 June 2012