A fix is available
APAR status
Closed as program error.
Error description
If CPSM resource definitions are not successful in EYU9NXLM, control may return to CICS with incorrect data in the restored registers. This may lead to an S0C7 abend in another resource manager module later during CICS initialization. . Additional Keywords/Symptoms: DFHAP0001 DFHAP0707 EYUNX0102E EYUNX0103E EIBTASKN overlay EIB R14 NXLM_RETURN_TO_CICS KIXREVRJL
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All CICSPlex SM V3R2M0 Users * **************************************************************** * PROBLEM DESCRIPTION: If CPSM resource definitions are not * * successfully created at MAS agent * * initialization by program EYU9NXLM, * * control may return to CICS with * * incorrect data in the restored * * registers. This may lead to an S0C7 * * abend in another resource manager * * program later during CICS * * initialization. * * * * When this occurs, any combination of * * the following messages can occur: * * * * EYUNX0014E * * EYUNX0022E * **************************************************************** * RECOMMENDATION: After applying the PTF that resolves this * * APAR, all MASes and WUI servers must be * * restarted. Note that the restarts do not * * need to occur at the same time. * **************************************************************** When MAS agent initialization starts in a MAS or WUI server, EYU9NXLM (NXLM) is called to build the CICS definitions required for the system to run as a MAS. If NXLM correctly builds the CICS definitions, it calls program EYU9NXSM (NXSM) to continue initialization. Prior to calling NXSM, it saves general registers 12 (R12 - CICS EIB address) and 13 (R13 - CICS EIS address). Upon return from NXSM, it branches to a common exit routine, which restores the registers and then returns to CICS. If a problem occurs during the build of the CICS definitions, instead of calling NXSM, NXLM issues a combination of the messages listed above, and then branches to the common exit routine, where it restores R12 and R13, and returns to CICS. However, since NXSM was never called, the contents of R12 and R13 were never saved into the area they are restored from. This results in R12 and R13 not containing the CICS EIB and EIS addresses upon return to CICS, which can result in the documented error.
Problem conclusion
NXLM has been updated to only restore R12 and R13 if it calls NXSM.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM82026
Reported component name
CICSTS V3 Z/OS
Reported component ID
5655M1500
Reported release
50M
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2013-02-04
Closed date
2013-02-14
Last modified date
2013-03-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK91669
Modules/Macros
EYU9NXLM
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
R50M PSY UK91669
UP13/02/20 P F302
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":"3.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":"3.2","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 March 2013