A fix is available
APAR status
Closed as program error.
Error description
You start your MASes and find the AUX trace datasets in MAS and the connected CMASes immediately fill up. Upon formatting them using the CPSM trace formatter EYU9XZUT, you find the following two entries repeated over and over for routed transactions: . TASK MTD PREV TRAN OBJ LEVL PT-ID DEBUG UOW CMAS/USR ENVR 12345 WDIN WDTR ABCD WLM EXCP 9 CICSINIT CPSM masname LMAS 12345 WDTR XLOP ABCD WLM EXCP 6 WDININIT CPSM masname LMAS . In the WDIN CICSINIT trace entry, we see a return code traced as: . RETCODE LEN:000004 0 - 00000004 . You also see the WTDA traced as part of the DYRCOMM. That shows the actual problem: . *....MAS001 .........0>eYUWMEYUR* *WTDA........0670........ * . Notice the lower case 'e' in the 'eYUWMEYURWTDA' string. . Additional Symptom(s) Search Keyword(s): KIXREVSVR
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V4R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: Your CICSplex manages a workload * * routing incoming web services (Request * * Streams). You notice that the auxil- * * liary trace data sets for target CICS * * regions supporting this workload, and * * CMASes to which the target regions * * connect, fill rapidly when the workload * * is active. When you format the trace * * data using the CPSM trace formatter * * EYU9XZUT, you find the following two * * entries repeated for each routed trans- * * action: * * . * * TASK MTD PREV TRAN OBJ LEVL PT-ID * * DEBUG UOW CMAS/USR ENVR * * 12345 WDIN WDTR ABCD WLM EXCP 9 * * CICSINIT CPSM masname LMAS * * 12345 WDTR XLOP ABCD WLM EXCP 6 * * WDININIT CPSM masname LMAS * * . * * Examining the CICSINIT trace generated * * by method WDIN (EYU0WDIN - WLM Routine * * Initialization and Termination) you * * find the DYRCOMM area contains the fol- * * lowing string: ">eYUWMEYURWTDA". * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all MASes defined as routing regions * * in a CPSM workload 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. * **************************************************************** CPSM imbeds the Transaction Data Area (TDA) in the DTR Comm- area DYRUSER field so that it flows to the target region during routing. For routing requests initiated by the Request Streams (RZ) or Scheduler Services (SH) domains, CPSM's Distributed Routing Program (DSRTPGM) is called for Route Completion in the Routing Region to allow resources to be cleaned up when CICS has finished all processing. CPSM marks the Transaction Data Area by setting the initial "E" of the eyecatcher to lower case to show that the TDA might no longer be valid. When routing a Web Services request, a timing error in Request Streams domain might result in CPSM's DSRTPGM being called for Route Completion before CICS has sent the transaction to the target region. If this happens, when CPSM's DSRTPGM is called for Route Initiate in the target region, module EYU0WDIN detects the invalidated TDA and returns an exception. This does not prevent the trans- action from running, but might result in incorrect updating of transaction load factors by CPSM WLM.
Problem conclusion
Module EYU0WDIN was modified to refrain from marking the TDA invalid if called for Route Completion from the Request Streams domain.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
**** PE15/02/24 FIX IN ERROR. SEE APAR PI35674 FOR DESCRIPTION
APAR Information
APAR number
PI17662
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
2014-05-09
Closed date
2014-06-11
Last modified date
2015-04-07
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI17717 UI18752
Modules/Macros
EYU0WDIN
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R70M PSY UI18752
UP14/06/14 P F406
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:
07 April 2015