A fix is available
APAR status
Closed as program error.
Error description
You upgrade the CPSM MAS agent code in your CICS region, but do not properly follow the requirement in the instructions to COLD start your region after the upgrade. When the region initializes next, you receive EYUNX0013E and EYUNX0014E messages, and the MAS agent code shuts down. The description of the EYUNX0013E message indicates that CPSM would attempt to correctly redefine the transactions, but that does not appear to have happened. Additional Symptom(s) Search Keyword(s): KIXREVxxx
Local fix
COLD (or INITIAL) start your region as required and documented in the InfoCenter.
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V5R1M0 Users * **************************************************************** * PROBLEM DESCRIPTION: You upgrade the CPSM MAS agent code * * in your CICS region, but do not follow * * the requirement in the documentation * * to COLD start your region after the * * upgrade. When the region initializes * * next, you receive messages: * * . * * EYUNX0013E TRANSACTION CONL * * has invalid value: EYU9XLEV * * for option: PROGRAM * * and * * EYUNX0014E The definition for * * TRANSACTION CONL is * * invalid. MAS initialization * * is terminating * * . * * and the MAS agent code shuts down. * * The description of message EYUNX0013E * * indicates that CPSM attempts to rede- * * fine the transactions correctly, but * * that does not happen. * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all MASes 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. * **************************************************************** CICSPlex SM uses some CICS interfaces which are version specific. Programs and methods which use these interfaces have names which identify the version of CICS to which they apply. When required resources are created during CPSM initialization, module EYU9NXLM (NXLM - Local MAS Bootstrap Program) verifies that the proper version programs are installed, and that trans- actions which execute version specific programs identify the proper program names. Transaction CONL, the MAS Agent Long-Running Task, executes program xxx9XLEV, where xxx is the version-specific prefix. If a MAS which was executing the same CICS and CPSM versions is upgraded to a new CPSM version without upgrading the version of CICS, and the region is not started COLD or INITIAL, the defi- nition of COLM in the catalog will identify the wrong version of xxx9XLEV. A logic error in EYU9NXLM prevents CPSM from trying to correct the installed definition if the transaction ID begins with the letter "C".
Problem conclusion
Program EYU9NXLM was modified to invoke EXEC CICS CREATE for any transaction whose installed attributes are not correct. If the CREATE is successful, message EYUNX0013E will be followed by EYUNX0011W, and the MAS will initialize properly. If the CREATE fails, message EYUNX0038E will be issued to expose the RESP and RESP2 values returned by CICS, an exception trace will be gen- erated, and MAS Agent initialization will then be terminated.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM86938
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
80M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / CST
Submitted date
2013-04-12
Closed date
2013-05-09
Last modified date
2015-03-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK94163
Modules/Macros
EYU9NXLM EYUTVTHE
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
R80M PSY UK94163
UP13/05/10 P F305
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:
04 March 2015